用途:用户遇到问题或想提改进建议时,agent 当场把经过写成完整反馈,包含复现步骤、原始错误文本、实际与期望结果,用户过目全文后提交给维护者。
触发方式:用户自然抱怨时,agent 可一句话提议记一笔反馈,用户不回应则继续原任务,同一问题同一会话不重复提;用户直接点名(如「报个 bug」「给作者提个反馈」)则直接进入流程。绝不自动发送,发送必须发生在用户看过全文并明确同意之后。
主要流程:先判定 bug、friction 或 idea 三类之一,读 references/report-protocol.md 按对应分支自查成文,并做真实性拦截,细节须对应本次会话真实发生的工具调用,观察与推测分开,报告存为临时 markdown 文件。随后用脚本拼载荷:python3 scripts/submit_feedback.py prepare --category bug --report feedback-report.md --out feedback-payload.json --agent claude-code --command "1:node reconcile.mjs --dry-run"。机器事实仅按白名单采集,不采集凭证、密钥、账号信息与用户正文。脚本会对全部待发送内容做凭证与高熵检测,命中则处理后重新 prepare。
确认与发送:把 prepare 打印的全文原样呈现给用户并询问是否确认提交;用户明确同意后执行 python3 scripts/submit_feedback.py send --payload feedback-payload.json --user-consented。拒绝或未回应则不发送,可用 keep 仅落本地,或删除载荷与报告文件。
结果处理:成功则告知已提交并给出 requestId,有 notice 字段则原样转达;端点不通或失败时脚本把反馈落成本地 markdown(退出码 2),告知用户绝对路径与手动送达方式(GitHub 仓库 zizhanovo/doubaoya-community 开 issue)。本机无 python3 时直接留存报告并说明手动送达方式。
安装标识:随反馈发送本地随机生成的安装标识,不含用户身份信息,可用 python3 scripts/submit_feedback.py reset-id 重置。
限制:不自动发送;不采集白名单外信息;不引用用户正文与资料;端点长期不通时如实告知只能手动送达,不反复重试。