轨迹视图 · Trace View
把 DeepSeek Harness Web GUI 会话里 AI 的执行过程渲染成一条可回放的横向时间轴——每一步做了什么、每次发给大模型的原始请求都摊开在眼前。
专为「学习与调优提示词」设计：想弄清 AI 为什么这么回答？打开轨迹视图，看它思考了什么、调用了哪些工具、拿到了什么结果，以及它当时真正"看到"的消息载荷。
1. 它解决了什么问题
长会话里想还原「AI 当时是怎么执行的」，内置轨迹标签只能逐条翻事件列表；想看「某次请求到底把什么发给了大模型」（系统提示、工具目录、重建消息）更是无从下手——这些数据散落在会话内部状态里，没有画面。
本插件在「轨迹」标签右侧新增一个「轨迹视图」标签，把同一份会话状态渲染成可回放、可搜索、可导出的横向时间轴：
会话轨迹（views.get("trajectory") 快照，官方数据完全复用）
│
├─ 顶部 minimap：按时间序的站点色块，点击秒跳
├─ 横向时间轴：真实时钟时间标注，◀ ▶ 逐站回放
├─ 底部【步骤详情】：思考 / 工具参数 / 结果全文 / 子调用链 / 耗时
├─ 底部【原始请求】：该步骤当次发给大模型的完整上下文（提示词学习）
└─ 头部 KPI：轮次 / 步骤 / 工具 / 错误 / 耗时 / tokens + 📋 一键 Markdown
只读：只读取会话视图里已生成好的 TrajectorySnapshot 快照并重新渲染；不修改任何文件、不访问网络，宿主半部是无操作桩。
2. 功能特性
流向总览
- ✅ 横向时间轴 + 顶部 minimap：每个站点一个色块（用户=蓝 / 步骤=绿 / 工具=橙 / 压缩=紫 / 错误=红 / 重试=黄 / 命令=青），点击色块即跳转，回放时高亮当前站点。
- ✅ 完整事件流：用户消息、助手步骤、工具调用、上下文压缩、轮次失败、模型重试、输出超限、命令都按时间序上轴；压缩 / 命令事件按 seq 精确归位到所属轮次。
- ✅ KPI 条：轮次 / 步骤 / 工具次数 / 错误数 / 工具总耗时 / 请求与生成 tokens，实时「当前步骤」指示灯 + 当前模型名。
- ✅ 站点轴上标注真实时钟时间（不是事件序号）。
快速定位
- ✅ 🔍 搜索：按工具名 / 参数 / 正文 / 错误名过滤站点，命中站点金色描边 + minimap 高亮；
Enter / Shift+Enter 或 ↑ ↓ 逐个跳转；/ 或 f 聚焦搜索框，Esc 清空。
- ✅ ⇤ / ⇥ 轮次跳转（PageUp / PageDown）：在轮次起点之间跳跃。
- ✅ ⇣ 跟随模式：AI 正在工作时新站点自动滚入视野；任何手动导航自动暂停跟随，⏭「显示全部」恢复。
- ✅ 检查联动契约：实现了会话视图的
inspect 深链协议——本标签处于活动时若收到工具检查请求，自动定位到包含该调用的站点。
- ✅ ⬆ 加载更早历史：长会话窗口外的事件一键分页加载（复用会话的
hasMore / loadOlder）。
每一步做了什么（底部「步骤详情」）
- ✅ 助手输出文本与 💭 思考内容（可折叠）。
- ✅ 每个工具调用：参数（格式化 JSON）、工具结果全文、子调用链完整卡片（子调用自己的参数 / 结果 / 耗时 / 错误）、耗时条、错误码。
- ✅ 步骤级元信息：⏱ 步骤总耗时、首 token 延迟（TTFT）、⚡ 解码吞吐 tok/s、token 用量、「已停止」中断标记。
- ✅ 详情面板可 ⤢ 展开全高 / ⤡ 收起。
原始请求（底部「原始请求」标签，快捷键 r）
- ✅ 模型配置：provider / model / temperature / reasoningEffort / thinking / maxTokens / stop / 状态 / 耗时 / 重试信息。
- ✅ ⚡ 提示词变更：当次请求相对上次的差异摘要——系统提示字符数变化、
+ 新增 / - 移除 的工具名（initial 为首份系统提示）。
- ✅ 系统提示全文：字符数 + 一键复制（含工具目录 JSON）。
- ✅ 工具目录：当次请求携带的全部工具 schema，逐个展开，可一键复制。
- ✅ 消息列表：按会话日志近似重建的 model-visible 消息（用户 / 助手 / 工具结果，含压缩标记），逐条展开全文；可一键复制完整请求载荷 JSON。仅在打开本标签时才重建（懒加载，长会话不卡顿）。
- ✅ Token 用量：入站（含缓存读 / 写）与出站（含思考）明细。
- ✅ 上下文压缩站点也有自己的「原始请求」：压缩请求的模型 / 耗时 / usage 与压缩产出全文。
导出学习笔记
- ✅ 头部 📋 Markdown：一键把整段轨迹复制为 Markdown——每步的思考 / 正文 / 工具参数 / 结果、每步请求配置摘要，以及附录「首个请求的系统提示与工具目录」。
3. 效果预览
| 轨迹视图总览（时间轴 + minimap + 底部详情 / 原始请求面板） |
|---|
| 轨迹视图效果预览 |
4. 目录结构
dsh-trajectory-traceview/ # 仓库根 = npm 包根
├── package.json # dsh.bundle.patch + dsh.client（浏览器端声明）+ exports["./client"]
├── cordis.patch.yml # 组合行：仅插入一行插件记录（无路由、无配置）
├── LICENSE # MIT
├── screenshot/ # 效果截图（README「效果预览」用）
├── test/
│ └── smoke.test.cjs # 纯 helpers 单测（零依赖，node 直接跑）
└── lib/
├── index.js # 宿主半部：无操作桩（纯浏览器端插件）
└── client.js # 浏览器 bundle：轨迹视图（时间轴 / minimap / 详情 / 原始请求）
5. 快速开始
一键安装（GitHub）：
dsh plugin --profile web add github:AFAP/dsh-trajectory-traceview
然后重启 dsh web 生效。
安装后插件位于 $DSH_HOME\profiles\web\node_modules\dsh-trajectory-traceview（pnpm 从 GitHub 克隆），与源码仓库位置无关。
升级：
dsh plugin --profile web update dsh-trajectory-traceview
卸载：
dsh plugin --profile web remove dsh-trajectory-traceview
从源码目录手动安装（等价验证用）
dsh plugin --profile web add "G:\path\to\dsh-trajectory-traceview"
验证是否加载成功
打开任意有 AI 执行轨迹的会话 → 会话顶部「轨迹」标签旁出现「轨迹视图」标签 → 点击后能看到横向时间轴与 minimap，即加载成功。
6. 使用
- 打开任意会话（有 AI 执行轨迹即可）。
- 点击「轨迹视图」标签：顶部 minimap 是全部站点缩略图，下方时间轴按真实时钟时间排列。
- 浏览 / 回放：◀ ▶ 或键盘逐站浏览；▶ 自动回放（×1 / ×2 / ×4 三档速度）；空格 播放 / 暂停。
- 搜索：按
/ 聚焦搜索框，输入工具名 / 参数 / 正文 / 错误名，Enter 逐个跳转命中站点。
- 选中任意助手步骤：底部「步骤详情」展示思考、正文与每个工具调用的参数 / 结果 / 子调用 / 耗时；点「原始请求」标签（或按
r）查看当次发给大模型的完整上下文，用于提示词学习。
- 导出笔记：点头部 📋 把整段轨迹复制为 Markdown。
- 长会话：点 ⬆ 加载更早历史；AI 正在工作时开 ⇣ 跟随模式自动跟进。
7. 快捷键
| 按键 | 功能 |
|---|
← / → | 上一个 / 下一个站点 |
Home / End | 跳到开头 / 结尾 |
空格 | 播放 / 暂停回放 |
PageUp / PageDown | 上一个 / 下一个轮次起点 |
/ 或 f | 聚焦搜索框 |
↑ / ↓（搜索时） | 上一个 / 下一个搜索命中 |
Enter / Shift+Enter（搜索时） | 下一个 / 上一个命中 |
Esc | 清空搜索 / 取消 |
r | 切换「原始请求」面板 |
8. 实现要点（数据来源）
| 关注点 | 做法 |
|---|
| 数据来源 | 完全复用 DSH Web 会话状态里的 views.get("trajectory") 快照（TrajectorySnapshot）：eventNodes（含 timing / usage / provenance / interrupted）、requests（助手请求 + 压缩请求）、callSchemas（调用时刻的工具 schema）、partial / runningCalls（流式实时态），以及会话级 hasMore / loadOlder 历史分页。 |
| 原始请求 | 「消息列表」是按会话日志近似重建的载荷（原始 messages 数组不落快照），面板内已注明"近似"，用于提示词学习足够精确。 |
| 懒加载 | 消息列表仅在打开「原始请求」标签时才重建，长会话不卡顿。 |
| 挂载方式 | 通过 dsh.client.inject（dsh-client-runtime / dsh-client-locale / dsh-client-ui-conversation）在会话视图「轨迹」标签旁注册新标签。 |
| 检查联动 | 实现会话视图的 inspect 深链协议：收到工具检查请求时自动定位到包含该调用的站点。 |
9. 日志与排错
| 现象 | 排查方向 |
|---|
| 看不到「轨迹视图」标签 | 确认已重启 dsh web；F12 Console 搜 dsh-trajectory-traceview。 |
| 时间轴空白 / 无站点 | 会话需要已有 AI 执行轨迹（用户消息 → 助手步骤）；新会话无数据时面板显示空态提示。 |
| 搜索无命中 | 检查搜索词是否匹配 工具名 / 参数 / 正文 / 错误名。 |
| 消息列表与实际请求不符 | 「消息列表」是近似重建（原始 messages 不落快照），面板内已注明；以系统提示与工具目录为准。 |
| 打开较旧会话缓慢 | 只有打开「原始请求」标签才重建消息列表；正常浏览时间轴不受影响。 |
10. 安全与合规
- 只读：只读取会话视图已生成的
TrajectorySnapshot 快照并渲染；不修改 DOM 业务结构、不修改 / 删除任何文件、无宿主路由、不访问网络。
- 本地数据：所有数据均在浏览器内处理；原始请求只在主动打开面板时才重建，不写入任何存储。
- 无持久化：不写 localStorage / cookie；卸载即无痕。
11. 开发与自测
纯 JS 无构建步骤。lib/index.js（宿主半部）是无操作桩；lib/client.js 是经典脚本（window.__ModuleLoader__.load），由客户端模块系统直接服务。
node test/smoke.test.cjs
自测用 mock 快照覆盖：树构建 / 请求附加 / 压缩请求配对 / 子调用详情 / prompt diff / 步骤计时 / 搜索匹配 / Markdown 导出 / token 统计。
12. License
MIT © AFAP
免责声明：本插件为本地学习 / 调试工具，不对任何因使用轨迹数据（含近似重建的消息载荷）做出的决策负责；请勿在共享 / 多人环境展示含敏感内容的会话轨迹。
