TraceScope 升级：MCP 服务器内嵌可视化工作台，Cursor / Claude Code / Codex 等Agent直接打开完整三模式界面

/* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */
#content_views .toc,
/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */
#content_views.markdown_views > p:empty:has(+ .toc),
#content_views.markdown_views > .toc + p:empty,
/* 富文本旧版目录标记 */
#content_views.htmledit_views #main-toc,
#content_views.htmledit_views #hr-toc,
#content_views.htmledit_views p[id*=\”-toc\”] {
display: none !important;
}
/* 目录去掉后，紧跟的首个标题不再多出一块上边距 */
#content_views.markdown_views > .toc + h1,
#content_views.markdown_views > .toc + h2,
#content_views.markdown_views > .toc + h3,
#content_views.markdown_views > .toc + h4,
#content_views.markdown_views > .toc + p:empty + h1,
#content_views.markdown_views > .toc + p:empty + h2,
#content_views.markdown_views > .toc + p:empty + h3,
#content_views.markdown_views > .toc + p:empty + h4 {
margin-top: 0 !important;
}

TraceScope（dsh-tracescope，MIT 开源）是把 AI 分析接入应用质量流程的插件：功能影响分析、设计差异分析、崩溃分析三条主线。之前它的可视化界面只存在于 DeepSeek Harness 侧栏，在 Cursor、Claude Code 等 MCP 客户端里只能纯文本对话。这次升级把整个工作台搬进了 MCP 服务器——任何支持 MCP 的 Agent 都能打开它。 GitHub：rebornace/dsh-tracescope ｜ Gitee 镜像：RebornAce/dsh-tracescope ｜ npm：@rebornace/dsh-tracescope、@rebornace/tracescope-mcp

一、之前的形态：工具全，但界面只有一边有

三条主能力的 MCP 工具面早就齐了——影响清单、设计走查、崩溃 triage 都能通过 tracescope_* 工具被 Agent 调用。但实际用起来有个割裂：

• DSH 侧栏：有完整可视化界面——可勾选的验证清单、设计稿对照图高亮、崩溃列表与详情页、筛选区，鼠标点几下就能走完全流程；
• 其他 MCP 客户端（Cursor、Claude Code、Codex 等）：工具能调，但没有界面。清单只能以 JSON 形式吐在对话里，设计差异看不了对照图，崩溃列表没有筛选交互。

也就是说，同一个分析引擎，在不同客户端里体验差了一截。这次升级解决的就是这件事。

二、升级一：独立工作台，与侧栏完全等价

MCP 服务器现在自己挂载了整套 /tracescope/v1/* 路由和一个本地 SPA。连上 MCP 后，让 Agent 调用新工具 tracescope_open_panel，会在浏览器打开 http://127.0.0.1:3927/——这就是与 DSH 右侧栏完全等价的三模式工作台：功能影响、设计差异、崩溃分析。

典型用法是人机分工：

工作台全程跑在本机回环地址，崩溃 / 设计稿凭证仍然只存在 ~/.tracescope，和侧栏共用同一份配置。DSH 插件的额外价值只剩一点：它还能把提示词直接填进会话输入框；除此之外界面能力两边一致。

服务端同时提供两种入口：本地客户端走 stdio（下面的 npx 方式），也可以用 Streamable HTTP 模式（start:http）起一个独立服务，适合托管型 MCP 接入场景。

三、升级二：Agent playbook，教 Agent 什么时候调哪条流程

光有工具还不够——Agent 经常不知道「用户说『帮我测一下这个 PR』时该先建 handtest job 还是先拉 diff」。这次随仓库新增了 skills/tracescope-agent-playbook/，一个编排手册 Skill：

手册同时写死了几条硬规则，避免 Agent 乱用：

• 清单 / 差异 / 崩溃的分析结果必须调用对应的 publish_* 工具写回，否则工作台不会刷新；
• 凭证（设计稿 Token、数据源 Cookie 等）只能来自用户输入或本机已存配置，不能编造；
• 设计对比是静态对比（设计树 vs 代码静态树），不是真机截图走查；
• 拉 diff 分页取（offset / limit），不要一次把整棵代码树读进上下文。

这个 Skill 本身可以打包单独上架，Agent 装上后就知道 TraceScope 怎么用；不装也不影响 MCP 工具本身。

四、顺带：崩溃 AI 结论本机缓存

崩溃分析还有一个实用优化：AI 结论按「仓库 + incidentId」落盘缓存。同一条崩溃再次点「本地分析」时自动恢复上次结论，不用重复调模型；想强制重新分析，侧栏一键清除缓存即可。

五、快速上手

Cursor 等 stdio MCP 客户端，在配置里加一段：

{
"mcpServers": {
"tracescope": {
"command": "npx",
"args": ["-y", "@rebornace/tracescope-mcp"]
}
}
}

重启客户端后确认出现 tracescope_* 工具，让 Agent 调 tracescope_open_panel 即可打开工作台。环境要求 Node.js ≥ 20。已经在 DSH 桌面端用过的用户，更新插件后侧栏无需任何迁移。

六、平台适配现状

三条能力都按横向扩展设计，不绑死单一厂商：

如实说，现在适配的平台还比较有限，后续会逐步增加常用的各平台。如果你工作中很需要某一个，欢迎到仓库提 GitHub Issue，写清平台名、是否有公开 API、典型使用场景——需求明确会优先适配。完整路线图见仓库文档。

七、最后

这次升级之后，TraceScope 的定位更清楚了：一个 MIT 协议的本地分析引擎，外加两种使用形态——在 DSH 里是内嵌侧栏，在任何 MCP 客户端里是「工具 + 本机工作台」。它做的事情始终是同一件：把取数、解析、定位这些材料整理工作自动化，降低把 AI 分析应用到应用质量上的门槛。

欢迎试用、提 Issue、发 PR。

相关链接

• GitHub：rebornace/dsh-tracescope
• Gitee 镜像：RebornAce/dsh-tracescope
• MCP 包：@rebornace/tracescope-mcp
• 功能说明：docs/GUIDE.md
• 更新日志：CHANGELOG.md