「问题反馈中心」是一套统一的、所有接入项目共用的反馈调度中心。接入非常简单——子项目零代码:只要在页面上放一个指向 /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 审核状态筛选与搜索。每个项目还有一个「公开区」——只展示游客提交且已通过审查的反馈(不展示任何附件与提交者身份),供访客搜索是否已经有人提过同样的问题;管理员可随时把某条从公开区撤下。