诊断信息与日志
排查问题通常不需要完整数据库或完整对话。先在本地记录最小信息,只保留确认与问题有关的材料。
建议收集
- Captain Who 版本与安装包来源;
- 操作系统版本和 CPU 架构;
- 问题发生时间及所在时区;
- 功能入口,例如模型、MCP、Skill、浏览器或 Scheduled;
- 是否涉及账户登录、软件许可校验或应用内更新;
- 从应用启动开始的最短复现步骤;
- 预期结果与实际结果;
- 首次错误的原文、错误码和界面状态;
- 是否能在新对话、另一个项目或低风险输入中复现;
- 对第三方调用,目标服务的非敏感请求 ID 或时间范围。
截图前关闭或遮盖其他项目、文件路径、对话内容、账户和通知。
当前日志边界
当前应用没有面向用户的一键“导出诊断包”功能,也没有在公开界面承诺固定的日志文件位置。不要为了寻找日志而上传整个应用数据目录。
应用数据目录包含数据库、附件、已安装 Skill、生成文件及其他受管数据;未签名 macOS 开发构建的私有凭据文件也位于其中。当前版本的 storage.sqlite 只保存凭据引用与状态,不含当前模型/搜索 secret,但旧版本数据库或备份仍可能含明文;数据库也包含私密业务内容,绝不是普通日志,不应上传到公开问题。已保存的账户会话同样不应作为诊断材料分享。
必须删除或遮盖
- API Token、Tavily Key、Cookie、Authorization header 和凭据引用;
- MCP 参数中的秘密、Server stderr 和原始 Tool 参数/结果;
- 对话全文、系统 Prompt、Provider 私有推理数据;
- 用户名、邮箱、电话号码和其他个人信息;
- 账户标识、登录/会话信息、软件许可状态和网站个人资料;
- 客户代码、未公开项目名、绝对路径和内部 URL;
- 通知正文、附件和生成制品中的敏感内容。
不要仅替换一部分 Token;如果无法确认内容是否安全,应不分享该字段。
最小复现建议
- 新建不含真实客户数据的测试项目或文件。
- 使用相同功能但更短的请求重现。
- 对 MCP 或命令,替换为无副作用的本地 fixture。
- 记录首次失败,避免反复执行未知结果的动作。
- 确认最小复现仍有效,并再次检查材料中没有凭据、私有内容或无关个人信息。
不要把可利用细节、真实 Token、他人数据或完整应用数据目录发布到公开讨论中。怀疑凭据暴露时,应立即到相应第三方服务撤销或轮换凭据。需要联系项目方时,按自助排查中的邮箱与脱敏要求操作。