「問題反饋中心」是一套統一的、所有接入項目共用的反饋調度中心。接入非常簡單——子項目零代碼:只要在頁面上放一個指向 /feedback/<你的 APPID>/ 的鏈接(或把它塞進 iframe)即可,反饋表單、附件上傳、AI 審核、公開區與開發者聯繫方式都由本服務託管,你不需要寫任何提交邏輯,也不需要保存任何反饋數據。
用戶側流程:選擇反饋類型(功能建議 / 功能升級 / 使用問題 / BUG 反饋 / 其他)→ 填寫內容(無需標題)→ 選填圖片與視頻(張數、大小上限由後臺統一配置)→ 提交。遊客可直接匿名提交(需先通過圖形驗證碼,並受同 IP 頻率限制);已登錄用戶提交會帶上用戶身份,登錄後可查看「我的反饋」並繼續追問。提交後狀態為「待審核」,AI 審核通過後進入「待處理」,管理員回復後變為「已回復」。
登錄態怎麼傳給反饋頁:子項目前端用用戶自己的 UAC Token 調 POST /api/feedback/ticket換一張一次性、5 分鐘過期的票據,把票據拼進反饋頁地址(?ticket=xxx)作為鏈接或 iframe 地址;反饋頁消費票據後建立會話,並 303 重定向到不帶票據的乾淨地址。這樣 UAC Token 不會落在 URL、瀏覽器歷史與服務器訪問日誌裡。遊客無需票據,直接打開反饋頁即可。
開發者聯繫方式的查看位置(三處):① 反饋頁底部(/feedback/<app_id>/ 的「開發者聯繫方式」卡片);② 公開區頁面同樣展示同一份聯繫方式;③ 子項目也可以在自己的頁面上調用本服務的 GET /api/feedback/contacts?app_id=<APPID>(免簽名)拿到這份數據,自行渲染。聯繫方式由超管在後臺「問題反饋 → 反饋中心設置 → 各項目開發者聯繫方式」按項目分別維護,展示平臺(QQ / QQ 郵箱 / 微信 / Telegram / WhatsApp / Discord 等)與具體值都可自定義,不同項目可以填不同的值。
AI 審核說明:開關與兩套提示詞都在後臺「反饋中心設置 → AI 審核」裡配置(留空則使用內置通用規則)。規則就是提示詞——後臺寫的規則會與反饋正文、提交者信息一起發給 AI,由 AI 判定是否駁回。提交內容的審核在後臺線程裡逐條慢慢審,不佔用你的接口調用;平臺沒有配置可用 AI 模型時自動跳過審核,提交直接進入「待處理」。管理員回復前 AI 也會審一遍語氣,但只提醒、不阻斷,管理員可以修改後重發,也可以強制發送(強制發送會記入審核留痕)。若某條反饋因故沒審到(例如審核調用失敗),後臺可以直接對它點「立即送審」優先補審。
數據隔離與公開區:反饋數據按接入項目隔離,後臺可按項目 / 狀態 / 類型 / AI 審核狀態篩選與搜索。每個項目還有一個「公開區」——只展示遊客提交且已通過審查的反饋(不展示任何附件與提交者身份),供訪客搜索是否已經有人提過同樣的問題;管理員可隨時把某條從公開區撤下。