先记录出问题的页面
反馈时,先说明“在哪个网站、用什么身份、做了什么、实际发生了什么”。同一后台可以对应多个前端网站,因此请提供具体网址,不要只写“前台有问题”。
先保存现场信息,再修改设置或重试。没有后台权限时,提供自己能看到的页面和提示即可;后台配置、版本和服务器日志可由管理员补充。
按这个顺序填写反馈
- 网站和页面:目标前端网址、出问题的页面链接,以及页面或按钮名称。若链接含下载签名、令牌等敏感参数,请先隐藏参数值。
- 页面语言:出错时使用的语言;如果与切换语言有关,同时写明切换前后的语言。
- 账号身份:游客、已登录用户、VIP 或后台管理账号。涉及 VIP 时补充具体等级。
- 相关对象:内容 ID、分类 ID 或订单号,按本次问题填写。
- 操作步骤:从哪个页面开始,依次点击了什么,填写或修改了哪些字段。
- 预期与实际结果:原本希望发生什么,实际看到什么;附完整公开报错和可见错误码。
- 发生时间:具体日期、时间和时区;超时问题补充大约等待了多久。
- 影响范围:是否只影响一篇内容、一个账号、一种语言或一个前端;是否每次都能重现。
- 版本:当前瓜奇 PHP 插件版本和 Node 前端版本。不知道的项目标注“待管理员确认”,不要猜测。
设置不生效时,补充入口和保存结果
写出后台实际进入的菜单、所选目标前端、字段名称,以及修改前后的非敏感值。如果不确定设置是全局生效还是只对某个前端生效,也请说明。
- 记录保存时是否出现成功或失败提示。
- 重新打开相同设置页面,检查字段值是否保留。
- 回到对应前端,用相同语言和账号再次查看,记录结果。
“提示保存成功”“重新打开后值还在”和“前端结果符合预期”是三项不同的检查,反馈时请分别说明。
复制和翻译问题,补充任务选项
说明使用的是单篇复制、单篇翻译还是“AI 批量处理”中的“批量翻译”。提供源文章 ID、源语言、目标语言,以及已生成的目标文章 ID;没有生成目标文章时直接注明。
批量翻译请抄下以下实际选项:
- 源语言和目标语言:本次从哪种语言翻译到哪些语言。
- 已有译文策略:选择“跳过已有译文”还是“覆盖已有译文”。覆盖会写入已有内容,不要为了排查随意切换。
- 译文状态:选择“草稿”“待审”“发布”“私密”还是“保持原状态”。生成了译文但前端看不到时,应先核对状态。
- 分类:源文章和目标文章所属分类;涉及多个前端时,说明目标网站是否使用这些分类。
- 任务结果:已处理数量、成功或翻译数量、跳过数量、失败数量,以及对应失败项的提示。
进度走完不等于全部成功。文章不存在等情况也可能计入跳过,应查看具体记录,并打开目标文章核对内容、语言和状态。
批量任务会检查请求有效性和操作权限,并关联发起任务的账号。遇到“权限不足”或找不到原任务时,补充是否更换过账号、登录是否过期,以及能否在原账号下查看任务。
权限、下载和支付问题,补充具体失败点
说明失败的是阅读、下载、播放还是商品购买。下载问题要区分“没有入口”“点击后报错”和“开始下载后中断”,并提供相关内容 ID;订单下载还应提供订单号和对应商品。
不要直接公开完整下载地址。数字商品下载请求包含订单、文件和签名等参数,检查这些参数不等于需要把签名发送到公开反馈区。
已付款问题请补充支付时间、支付方式、对应订单状态,以及付款后页面显示的结果。账号余额变化或跳回成功页,都不能单独证明订单已经完成交付。
发送前检查敏感信息
保留页面名称、时间、相关 ID、公开提示和错误码,隐藏 API 密钥、登录密码、私钥、完整签名、令牌及无关客户资料。API 密钥是调用服务的凭据,不是用于展示的普通文字。
需要服务端日志时,请管理员提取本次操作前后的相关片段并脱敏,不要直接发送整份日志或内部堆栈到公开知识库。
修复后用同样的步骤验证
使用原来的前端、语言、账号身份和相关内容,再按反馈中的步骤操作一次。记录是否恢复、实际内容或订单状态是否正确,以及是否仍有失败项。
如果问题暂时不能重现,请说明最后一次发生时间和出现频率。仅凭“无法下载”或一句通用报错,不能确定是额度、权限、配置还是服务异常;完整反馈用于缩小范围,必要时仍需维护人员检查服务端记录。