在 DeepSeek Harness (DSH) 的开发流程中，理解 AI 是如何一步步执行并生成结果的，是调试提示词和优化模型行为的关键。DSH 内置的“轨迹”标签虽然记录了事件，但以纯文本列表为主，难以直观地把握整体时间流向，也难以快速定位某次请求的具体上下文。dsh-trajectory-traceview 插件将这一数据源渲染为可视化的横向时间轴，让每一步操作、每次发给大模型的原始载荷都清晰可见。
功能特性¶
插件在 DSH Web GUI 的“轨迹”标签旁新增了一个“轨迹视图”标签。它渲染了一个横向时间轴，顶部附带 minimap 总览，底部包含步骤详情和原始请求面板。
- 时间轴与总览：时间轴按真实时钟时间排列，顶部 minimap 使用颜色区分站点类型（用户=蓝、步骤=绿、工具=橙、压缩=紫、错误=红、重试=黄、命令=青）。点击 minimap 上的色块即可跳转到对应站点。
- KPI 统计：顶部显示轮次、步骤数、工具调用次数、错误数、总工具耗时、请求与生成 token 数，以及当前模型名称。
- 搜索与回放：按
/聚焦搜索框，输入工具名、参数、正文或错误名进行过滤，命中项会有金色描边。支持键盘快捷键（◀/▶）和播放按钮进行逐站浏览或自动回放（支持 1x/2x/4x 速度）。 - 步骤详情：点击任意站点，底部面板展示思考内容、工具参数、结果、子调用链、耗时和 token 用量。
- 原始请求分析：按
r切换到底部“原始请求”标签，查看当次发给大模型的完整上下文，包括系统提示、工具目录和重建的消息列表。面板还显示提示词变更（新增/移除的工具）和 token 用量明细。 - 导出：使用头部工具栏中的 Markdown 图标，将整个轨迹导出为 Markdown 文件。
安装与启用¶
使用以下命令安装插件：
dsh plugin --profile web add github:AFAP/dsh-trajectory-traceview
安装后，重启 dsh web 即可生效。
典型用法¶
- 打开任意包含 AI 执行轨迹的会话。
- 点击新增的“轨迹视图”标签。
- 浏览时间轴，点击站点查看思考与工具调用详情。
- 使用
/搜索特定工具名或错误信息。 - 按
r查看当次请求的详细上下文，用于提示词学习。 - 使用头部 📋 按钮导出整个轨迹为 Markdown。
注意事项¶
本插件为只读工具，仅读取 DSH Web 会话中已生成的 TrajectorySnapshot 快照进行渲染。它不会修改任何文件、访问网络或写入本地存储。所有数据处理均在浏览器本地完成，无持久化存储。
更多信息请参阅项目仓库：https://github.com/AFAP/dsh-trajectory-traceview
