反馈排查工具功能说明与实施规划

给出一条用户反馈，或者一组 VOC 反馈，Agent 按业务方向整理现象、选择平台、追查变更与代码机制，最终输出可以复核的结论、证据和下一步。反馈排查工具希望减少的，是人工在反馈、实验、配置、日志和代码之间反复搬运上下文的工作。

本文介绍的已生成实现名为 feedback-investigation。它是供 Agent 加载的独立 Skill，复用 bytedcli、lark-cli、已授权平台页面和本地源码能力。它已经生成，并完成协议测试、平台只读探查及首轮真实案例使用；仍需补齐目标现场取证与常用业务映射，验证实际定位效果。

用户反馈通常只描述结果：短剧播放卡顿、横屏显示不全、登录后本地书消失。定位时却要回答一连串不同的问题：发生在什么系统和版本？影响一人还是一批人？有没有实验、配置或发布变化？哪个请求、对象或代码分支能解释现象？目标用户是否真的经过了这条路径？

这些信息分散在不同平台，平台中的 AppID、空间、时间口径和权限也不统一。直接把平台结果交给模型，容易得到看似合理却缺少现场依据的解释。历史上查过类似问题，也只能告诉我们去哪里查，不能证明新反馈有相同根因。

工具围绕三个场景组织能力：

• 单条深查：还原一个用户的完整操作过程，沿日志、请求、对象状态和目标版本源码寻找原因。
• 批量归因：先按症状、系统、版本和时间分类，再选择代表反馈深查，说明结论能覆盖哪些条目。
• 异常趋势分析：核对反馈基线、版本规模和线上变化，判断哪些解释值得继续取证。

历史分析已经产出可读报告。打开 历史反馈统计与平台链接报告（本地资料），可以按票号、平台、域名、参数和上下文检索。它覆盖固定的 2026 年 3—8 月研究名单，不是实时反馈库。

9 月 7 日的内容报告复用了 301 条既有材料并补读其他记录；没有重新读取所有旧材料和附件。9 月 15 日的链接报告中，2,907 条仍是同群候选，10 条已标记属于其他票，链接未逐个在线验证。因此，链接存在、人工使用平台和实际取到结果应分别判断。

两套数量描述不同成果：625 条是后续统计范围，315 条是当前 Skill 声明的历史知识来源。现有 Skill 尚未发现对 9 月 7 日内容报告及 9 月 15 日链接索引的明确接入引用，后续应提取其中新增的方法与平台知识；无需把原有 Skill 重新生成一遍。

内容补读口径：复用 301 条既有材料，补读 324 条；625 条中 616 条有实质内容，9 条没有实质内容。历史统计不作为正式测评答案。

业务判断由调查 Agent 负责，脚本负责记录和检查执行事实。脚本通过不意味着归因正确，仍需审查来源是否支持结论。

14 个方向包括 UG、商业化、多元变现、番茄社区、小说内容分发、其他/新体裁、账号、书架、听书、客户端与其他、阅读器，以及短剧分发、消费和社区。方向卡已具备导航内容；不能据此宣称 14 个方向都已完成真实根因定位验证。

平台路径与使用边界

下表描述已收录的路径。平台实测记录主要来自 2026-09-02，权限与接口状态应在使用时重新检查。

这些平台按问题按需调用。28 项能力定义不是 28 个平台全部可用，也不意味着所有查询都已有权限。

还原反馈和范围

从完整反馈中提取操作、受影响对象、时间、产品、系统、客户端版本和实际结果。Android、iOS、HarmonyOS 分别绑定源码、日志、发布和配置；系统未知或来源冲突时保留缺口，不根据产品名称推断系统。

批量输入需要核对筛选条件、分页、总量和时间范围。看到页面总数或少量可见条目，只能说明批次规模和初步画像，不能算全量分类完成。

建立假设，选择下一步

围绕四类问题展开调查：

Agent 优先执行能确认、反驳或明显改变假设排序的有限查询。失败后区分认证、权限、映射、数据保留期与返回契约问题，再决定是否有可用的下一条路径。

版本峰值、相近时间或同名实验只提供线索。真正的归因需要把线上条件、源码消费和用户可见结果接起来。

记录证据，判断是否定位

每个工具尝试记录“要回答什么、实际返回什么、如何改变判断”。中断或仍在等待的操作不能被写成已经取得的证据。历史报告、平台提及和直接读取结果分别标记。查询保留平台用途、安全的关键输入、时间范围、结果引用及其对判断的影响。历史链接中的参数名可帮助理解接口，具体 UID/DID、内容、实验或 LogID 应绑定到当前授权反馈；令牌、签名和 Cookie 不进入普通报告。

“源码中存在相关分支”通常只证明机制可能存在。还需要证据说明目标用户、设备、请求或对象在问题时间确实经过该机制，才达到定位标准。

批量共因外推必须基于已经定位的代表案例，记录被外推条目及适用条件。代表案例证据不足时，仍可报告共同症状和候选解释，不能给整批反馈确认根因。

在支持 Skill 发现的宿主中，使用 feedback-investigation 描述排查意图；实际命令入口以宿主加载结果为准。当前文件位于项目的 skills/custom/，文件存在不代表已经全局安装或接入线上 Runner。

单条示例：

使用 feedback-investigation 排查这条反馈：<反馈链接>。
关注用户的完整操作过程、系统和客户端版本；
在现有授权范围内只读调查，输出最强结论、证据和剩余缺口。

批量示例：

使用 feedback-investigation 分析这组反馈：<VOC 分享或明确筛选>。
先核对范围并按症状、系统、版本分类，再选择代表问题深查。
最终说明逐条查到了什么，哪些条目仍未取证。

如果宿主未发现该 Skill，可以明确要求读取并遵循本地 SKILL.md（本地资料）。

Agent 先整理输入、业务方向、反馈范围、证据来源和竞争假设。范围与授权已明确时复用既有约定；信息会影响排查方向或访问范围时，再集中补齐。执行时根据证据调整下一步，最终提供单条报告或批量汇总及代表案例报告。

身份、时间或日志不足时仍能返回有依据的部分结果，但不会保证每条反馈都能定位，也没有固定耗时或成功率承诺。

状态核对日期：2026-09-16。平台在线状态以 2026-09-02 的实施记录为主，未在这次文档整理中重新请求全部平台。

历史手册已经在当前目录的“调研”子目录找到。原 /private/tmp/feedback-research-phase2 交接位置和 /private/tmp/feedback-investigation-live-20260902 报告位置已失效。当前可核对 Skill 文件、历史交接副本和仓库实施记录；不把缺失的旧轨迹标成今天可重放。

首轮试查带来的改进

已试查三组反馈，选取两条 Android 和一条 iOS 代表反馈。发现的问题已回写 Skill：

• VOC 分析分享可能是批次；分享解析为空与缺少扩展字段需要分别处理，浏览器重写 ID 只作导航。
• NVQoS 空间可见不代表数据集可读；权限阻塞不能解释成没有异常。
• Libra 同 key 可能跨产品，严格版本边界及实验审计时间会改变判断。
• Codebase 查询需限制仓库、路径和语言；当前源码不能代替目标 build 对应 revision。

六条历史轨迹均未完成现场因果闭环。当前记录没有证明对 2,733、38、37 条反馈做过完整逐条分型，也没有 HarmonyOS 代表案例。因此，本阶段只能认定为首轮试查完成，完整效果验证仍在后续。

当前 Skill 在本地项目中存在，目录受 Git 忽略规则管理；尚不能由此推断已经提交、全局安装或发布给团队。默认轨迹存储已有持久路径，后续调查需要实际使用，并把正式报告移出临时目录。

这是逻辑依赖顺序，不是对历史执行先后的重写：骨架与记录协议先完成，随后接入获授权的历史材料；平台验证也曾提前开展。步骤五至九是后续安排，不代表已实施。

合并来源：反馈排查工具介绍与功能说明、反馈排查工具执行步骤与后续规划。保留原文状态日期与证据边界；本地资料以名称列出，不生成在其他设备上失效的本机路径链接。

• 参考文档：安卓自动化测试修复验证：借鉴介绍顺序，不继承其真机操作、自动修复或耗时承诺。
• 历史数据交接（本地资料）：已接入的 315 条历史投影与知识使用边界。
• 9 月 7 日内容统计说明（本地资料）、9 月 15 日平台链接说明（本地资料）：后续 625 条轻量统计及链接整理口径。
• Skill 入口（本地资料）、平台能力矩阵（本地资料）。
• 实施记录（本地资料）、设计文档（本地资料）。
• 方向配置契约：feedback-investigation/references/direction-config.md（本地资料）。
• 补充核对：含链接逐票简表、链接索引与来源覆盖文件，均来自 2026-09-15 平台链接整理成果（本地资料）。

进度根据可核对产物和实际执行记录更新。平台动态权限与接口在使用时复验；新增目标、生产接入、外部写入与公开分享分别确认。网页中的“不索引”标记不是访问控制。