Skip to content

feat: add standalone ChatCut MCP Doctor / 独立诊断入口与反馈闭环 - #27

Draft
IanYet wants to merge 5 commits into
mainfrom
codex/standalone-mcp-doctor-20261023
Draft

IanYet wants to merge 5 commits into
mainfrom
codex/standalone-mcp-doctor-20261023

Conversation

@IanYet

@IanYet IanYet commented Oct 24, 2026 •

Copy link
Copy Markdown
Contributor

用户输入 /doctor 时找不到 ChatCut 排障入口,连接失败又不能依赖待修 MCP 读取说明。本 PR 将 Doctor 打包为 Codex/Claude 可独立发现的 Skill,使仍在工作的宿主能保留失败现场、运行本地诊断并提供后续动作。

  • 明确各宿主入口:Git Codex $chatcut:chatcut-mcp-doctor、既有商店身份 $chatcut-desktop:chatcut-mcp-doctor、Claude /chatcut:chatcut-mcp-doctor;不覆盖宿主自己的 doctor。采集实现移入独立 Skill,basics 旧路径保留兼容转发。
  • 根据证据区分注册查询失败与明确缺失、认证/启动/工具调用失败、后来直连 wire 检查及待关联的原生错误;正常匿名 401、缺失时间/ID和截断日志保持原有边界,不推断根因或恢复。补齐历史报告的 tool_call、tool_discovery、oauth、browser_render 阶段名称;精确识别原生 Codex 缺 issuer 的授权 WARN,保留日志时间及未关联状态,先检查当前状态再指导原宿主授权。
  • 提供缺失手工注册的基础修复、同 scope 复验及回滚指引;生成本地 JSON、摘要与问题单草稿。离线模式不发请求,补交复用原诊断 ID,并校验回执归属。增强会话凭据脱敏及工具内容回显过滤。
  • 发布版本:Codex 1.10.22、Claude 1.10.24及对应静态版本头;collector 1.3.0 区分已发 1.2.3,report2/snapshot1/fragment 协议保持兼容。
  • 修复指南分别给出明确会话占用拒绝、300秒原调用超时、浏览器任务等待和不支持协议版本的只读下一步;保留最终 OAuth 校验分支,不清锁、不并发重放、不自动修改协议头或全局降级。服务端孤立记录不填进本地报告阶段。

验证:最终HEAD 0b16d97,Windows相关86/86、本地Ubuntu24.04 Node24完整163/163通过。8份已校验报告离线重放通过,源文件哈希和缺口保持不变;来源尚未独立确认,报告数不代表人数或自然故障率,未将独立服务端记录关联到报告。此前两端原生宿主隔离验证覆盖独立发现/调用、启动503、连接后工具失败、缺失注册修复与回滚,另由协调者实测无效chunked及隔离SQLite ERROR。原生宿主模型响应使用确定性loopback fixture,只证明发现/展开/执行链路,不代表真实模型自主诊断质量。历史Windows全仓4项媒体fixture因文件名含问号失败,相关代码未改,Linux完整检查通过。

最终HEAD的5项CI均成功。完整既有身份商店包包含65文件/19个Skill,通过108项本地预检,包括真实ZIP解包、源码字节核对、隔离原生安装与全部Skill发现;上一冻结包已标记为被替代。

边界:未新增服务端改动/部署;没有真实OAuth、macOS原生验收、新的生产上报或自然busy/超时根因与修复结论。商店仍需正常审核与发布,本地预检及Git PR不等于商店已上线。公开Issue承接仓库未选定,当前只生成待审阅草稿。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant