dsh-visual-trace

English

DeepSeek Harness 的跨运行方式自然语言轨迹可视化与审查插件。它不再只依赖 Web 的 trajectory 快照，而是以官方持久化的 session/event 日志为通用数据源，让 Web、headless、命令入口、ACP、SDK、自定义 UI 和 Hooks 插件共享同一套轨迹解释规则。

支持范围

运行方式	使用方式	输出
Web	对话中的“轨迹可视化”页签	可筛选时间线、详情面板、待审查确认、引用到对话
支持 Harness Commands 的界面	/visual-trace、/visual-trace markdown、/visual-trace json	文本、Markdown 或 JSON
Headless	安装到 headless profile 后正常运行任务	自然语言轨迹写入 stderr，最终模型回答仍保持在 stdout
ACP / JSON-RPC SDK	Host 适配器调用 ctx.visualTrace	标准节点或文本、Markdown、JSON
自定义 UI / TUI	读取 session/event，或直接调用通用服务	与 Web 相同的节点语义和审查规则
Hooks / 审计插件	在 Cordis 插件中调用 ctx.visualTrace.render()	可保存、上传或二次处理的轨迹报告

Headless、ACP 和 SDK 本身没有浏览器画布，因此不会强行模拟 Web 侧边栏；它们输出的是同一套节点、顺序、自然语言说明和审查信号。

flowchart LR
  A["官方 session/event 日志"] --> B["通用轨迹适配器"]
  B --> C["统一自然语言节点"]
  C --> D["Web 时间线"]
  C --> E["/visual-trace 命令"]
  C --> F["Headless stderr"]
  C --> G["ACP / SDK / Hooks"]

Web 功能

• 摘要语言跟随系统语言，支持中文和英文，不额外发起模型请求。
• 用 👤、✨、🧩、⚙️ 区分用户、模型、工具和系统节点，👀 标记待审查节点。
• 按轮次、节点类型、待审查状态或关键词筛选完整流程。
• 展开官方 tool/code-dispatch-* 子调用，web_search 等真实工具不会被外层 bash / run_code 隐藏。
• 点击节点后查看通俗说明、审查原因、原始输入、原始输出和原始 JSON。
• 在待审查卡片上直接确认，筛选结果和统计数量同步更新。
• 右键节点可“引用关键信息”或“引用完整记录”；详情面板中选中文字可添加到对话草稿。
• 引用后自动回到“对话”页签，保留用户已有草稿且不会自动发送。

安装

需要 DeepSeek Harness 0.1.0-rc.6 和 Node.js ^22.19.0 || >=24.0.0。

git clone https://github.com/wikiiizhao/dsh-visual-trace.git
cd dsh-visual-trace
npm install
npm run check

安装到需要使用的 profile：