trajectory-tree
Discovered★ 4Visualize agent traces, explore Eval metrics and evidence-linked reports for DSH, Pi, Codex and Claude Code, plus an Antigravity context sidebar.
从对话日志,看见 Agent 怎样工作。
轨迹树 · Eval · 点选诊断 · 可视化报告
English · 快速开始 · 宿主接入 · MIT License
DSH Pi Codex Claude Code
开发与审查:PR 关系诊断与原生回归。
截图使用独立的 DSH 示例配置和公开合成对话。图中的模型名称、用量和速度用于演示。素材与复现
轨迹树
把会话主线展开成工具和行动的枝条。从任意一轮查看参数、返回、文件变化、子代理关系和上下文增量,沿关联记录还原任务怎样推进。
- 单步计量与报错代码帧:写入/替换自动计算增删行数(
measure),报错调用直接定位原脚本或源码行列并内嵌前后代码摘录(codeFrames)。 - 审批与策略控制标记:在主干与调用详情统一标识审批拒绝、文件先读/版本保护(
FS_NOT_OBSERVED/FS_STALE_VERSION)、工作树隔离边界(HOST_WORKTREE_GUARD)、执行超时与同参重试(controls)。 - 当前上下文侧栏(DSH):右侧栏按七类构成连续缩放查看当前保留内容,压缩后以实际保留面为准,正文按需分段懒读。

Eval 与配置管理
Eval 从日常任务的记录中提取指标,与轨迹树共用数据和切点,不需要另外跑 benchmark。单会话对照轮次耗时、输出量、工具延迟和错误分布;项目总览进一步汇集预设配置、Skill 使用、任务进展、模型行为和跨会话信号。
- 连续缩放矩阵(Zoomable Treemap):直观对比当前预设下系统提示、项目指令、工具定义、Skill 目录与正文的体积占比与实际读取频次,支持鼠标锚点缩放、双击聚焦与原位详情抽屉。
- 加载项管理与上下文重合(Context Overlap):按预设独立停用或恢复 Skill(提供可撤回覆盖与缓存影响说明);跨系统提示、
AGENTS.md、工具说明与 Skill 自动做 64 字符 winnowing 精确重合检测,并排展示共同原句、覆盖比例与L1 ↔ L2行号对照。 - 窗口占用与统一处置矩阵:按
5%窗口占用刻度拖选或点选区间,将反馈频次、窗口分布、调用耗时与请求等待直接编码进四类处置方向,筛选与选区跨刷新保留。

窗口占用的交叉对照与单会话指标



从失败信号追到具体执行
「代码执行」把 PowerShell、Bash、子程序与 PTC 的代码、宿主结果和反馈放在一起。按执行器和失败信号筛选,查看脚本位置、错误证据、父子调用和后续返回。支持 PowerShell AST 与 Bash noexec 静态语法定位,区分宿主策略拦截、外层执行器错误与内层子程序异常。

| 案例 | 可以查看的证据 |
|---|---|
| PowerShell / Bash 语法或参数出错 | 原始脚本、静态/运行时解析位置、外层退出码与具体反馈 |
| 修改被文件保护或工作树边界拦截 | 控制信号(controls)、目标文件、后续补读、同参修改返回及验证记录 |
| PTC 中的一次子调用失败 | 外层程序、内层工具和各自的运行结果与报错代码帧 |
| 高窗口占用时错误增多 | 相同模型、工具和占用区间的样本与报错分布 |
点选诊断与明确出口
在轨迹树上长按选中对象,按住后拖动可圈选,也可单选上下文增量柱。Eval 从统一处置矩阵、代码执行或上下文重合视图发起诊断。选好问题后,页面生成带会话、选区、重合摘录(含行号与占比)及取证入口的草稿,编辑确认后再发送。
诊断方法(trace-analysis 与 context-profile)去除空泛套话,直接将程序线索与取证结果收口到五类可执行出口:
| 诊断出口 | 判定条件与落地动作 |
|---|---|
| 无需处置 | 如 FS_NOT_OBSERVED 已在同轮补读并同参修改成功,或探测命令预期未命中且主任务已通过验收 |
| 修环境或实现 | 定位具体代码、脚本语法、参数契约、路径或配置缺陷,修改后在原执行链重跑验证 |
| 恢复观察与重跑 | 超时、用户中止、结果未落盘或版本冲突,先核对工作区与后台状态再安全续跑 |
| 能力启停与调整 | 先说明工具职责、主要场景与低频兜底用途并与用户确认需求,仅通过配置执行启停;绝不修改宿主官方内置工具的源码、参数 Schema 或内置描述 |
| 提炼知识与去重下沉 | 跨任务常驻约束写入 AGENTS.md / CLAUDE.md;特定流程与长说明下沉到按需 SKILL.md / references/,消除重复加载 |

行动路径上的选区与可编辑草稿

调查之后,交付报告
报告采用 Vercel Geist 开放画布与 1px 极细分隔线版式,把调查结论、同切点的 11 张 Eval 数据表(含 findings 处置矩阵组与 code-execution 表)和原文证据装配为单文件离线 HTML。全宽结论导语配合双列紧凑图表(环形构成、水平条形对比)、全宽证据流程图(flow)与明细表,悬停或点选元素即可按需浮现读数与取证查询。

快速开始
从仓库根目录操作。插件包自身声明 Node.js 18+,但 DSH 0.2.2 起的宿主需要 Node.js 24.9+;其他宿主的工具与独立视图需要 Node.js 20+。
| 宿主 | 会话 Eval | 项目总览 | 代码执行 |
|---|---|---|---|
| DSH | 会话中的评估面板 | 左侧栏 Eval 总览 | 评估 → 代码执行 |
| Pi | /trajectory --eval | /trajectory --overview | /trajectory --code |
| Codex | $trajectory-eval | $trajectory-eval --overview | $trajectory-eval --code |
| Claude Code | /trajectory-tree:trajectory-eval | /trajectory-tree:trajectory-eval --overview | /trajectory-tree:trajectory-eval --code |
Pi、Codex 和 Claude Code 的轨迹生成入口也接受 --eval、--overview 或 --code。DSH 直接使用常驻面板。完整宿主入口
Antigravity 的「上下文与用量」侧栏可查看最近一次请求,也能跨对话统计 Token、输出速度和首 Token 等待时间。侧栏与统计口径
DSH · 原生插件与分析面板
npm pack ./plugin/trajectory-tools
npm pack ./plugin/analysis-view
dsh plugin --profile web add ./dsh-trajectory-tools-0.6.9.tgz ./dsh-analysis-view-0.11.1.tgz
重启 dsh web,在会话里打开「评估」或用 /trajectory 打开轨迹树。选好诊断问题后,点「填入对话」把草稿追加到当前输入框。插件面向 DSH 0.2.2 系列,逐包核对见兼容与语言说明。
在本机 DSH Web 的左侧栏打开「Eval 总览」,按项目查看推进、模型行为和工具报错,也可以按窗口占用区间对照模型请求与工具调用。
在路径总览中,点击目标线可查看对应目标。点击事件点可查看那次变更,并从详情进入对应轮次的行动路径或对话。 轨迹树从 DSH 会话记录估算七类请求构成,按轮和按步展示上下文变化。Eval 和取证工具使用同一批样本,宿主上报的输入量单列。
在 DSH 插件管理中打开「轨迹树」,可配置右侧栏的「对话搜索」、轨迹图层和 Eval 工具排序。搜索默认开启,覆盖整段会话,可翻到更早的命中并跳回对应轮次。DSH 的按需解读会调用当前模型。压缩后对账默认开启,可设 config.reconcile: false 关闭。
Pi · 当前分支与原生命令
npm ci --prefix plugin/portable-tools --ignore-scripts
pi -e ./plugin/portable-tools
使用 /trajectory 查看当前分支,或用 /trajectory --eval 打开 Eval。可复制 Pi 装填指令回终端;如果输入框已有草稿,可以复制提示词正文并自行合并。trace-analysis 分析会话过程,context-profile 查看当前上下文与工具配置。
Codex · 插件、MCP 与独立视图
npm ci --prefix plugin/portable-tools --ignore-scripts
node scripts/sync-host-skills.mjs
node scripts/package-trajectory.mjs --host codex
从本地插件目录安装 dist/trajectory-tree-codex。使用 $trajectory-view 打开轨迹树,$trajectory-eval 打开 Eval,或用 $trace-analysis 和 $context-profile 分析。Eval 草稿可复制回 Codex 输入框。
也可以直接生成当前会话视图;读取本机会话需要官方 codex app-server:
node scripts/trajectory-view.mjs --host codex --serve
可以用 trajectory_command_diagnose 从同一切点细查命令归因。PowerShell 语法补查支持 Windows PowerShell 5.1 和 PowerShell 7。 命令诊断入口
从动作或文件历史打开「改动对比」,可以按文件查看记录中的增删行、原/新行号和原始补丁。
Claude Code · 原生插件与 transcript
npm ci --prefix plugin/portable-tools --ignore-scripts
node scripts/sync-host-skills.mjs
node scripts/package-trajectory.mjs --host claude
claude --plugin-dir ./dist/trajectory-tree-claude
使用 /trajectory-tree:trajectory-view 或 /trajectory-tree:trajectory-eval 打开视图,再把诊断草稿复制回 Claude Code。插件在会话启动、恢复等时机提供当前 transcript 路径。
Antigravity · 上下文与用量前端插件
将 ZIP 中的 trajectory-tree 目录解压到 ~/.gemini/config/plugins/,或从仓库根目录运行下方命令。下载 Antigravity 1.1.0 安装包
node scripts/install-antigravity.mjs
需要 Node.js 24+。刷新宿主插件或重启后,在会话顶部 + 菜单打开「上下文与用量」。矩阵支持滚轮缩放、拖动、搜索和正文懒读;趋势与对照使用已记录请求的输入、缓存和输出。页面隐藏后暂停轮询。

离线生成视图
node scripts/trajectory-view.mjs --host pi --file /absolute/session.jsonl --open
node scripts/trajectory-view.mjs --host claude --file /absolute/transcript.jsonl --eval --lang zh-CN --open
生成过程不调用模型。命令返回独立 HTML 文件和本地预览地址;页面包含字体,可离线保存。
轨迹树、Eval 和诊断草稿默认跟随宿主或浏览器语言。可在轨迹树中切换“自动 / 中文 / English”,也可加 --lang en 或 --lang zh-CN 固定独立视图的语言。日志原文、路径和参数保持原样。各宿主的功能与证据边界见兼容与语言说明。
同一组取证工具
| 工具 | 用途 |
|---|---|
trajectory_inspect | 查看过程、耗时、用量、反复尝试、工具文件(逐次调用含 measure 计量、codeFrames 报错位置与 controls 控制状态)和上下文统计 |
trajectory_search | 定位会话、字面记录与统计范围 |
trajectory_read | 查看原文、关联动作与反馈,分段追读完整参数和结果 |
trajectory_graph | 查看记录关系与会话谱系 |
trajectory_inspect 可按结果筛选工具调用。下面按工具统计明确报错。将 outcome 改为 abnormal 也会纳入结果未确认的调用。
{"view":"io","groupBy":"tool","outcome":"error","sort":"count"}
查询只读。各宿主按已有记录提供证据,不把未记录的内容补成事实。
| 宿主 | 主要数据来源 |
|---|---|
| DSH | 原生事件与官方统计投影、上下文构成、文件、Skill 和子代理记录 |
| Pi | 选中分支、当前 SDK 配置及采集到的工具执行时间 |
| Codex | 官方会话读取接口,以及对应线程的本地记录补充 |
| Claude Code | 明确选定的 transcript、原生工具参数与结果、已记录的消息用量 |
文档
- 功能索引 · 代码语义地图 · 代码状态 · 历史归档
- 宿主接入与命令
- 工具配置、查询与正文续读
- 分析方法 · 上下文与配置剖面
- HTML 报告组件用法
开发与自检
node scripts/sync-host-skills.mjs --check
node scripts/sync-view-assets.mjs --check
node --test test/hygiene-test.mjs test/complexity/code-status-test.mjs
node report/smoke-test.mjs
npm test --prefix plugin/trajectory-tools
npm test --prefix plugin/portable-tools
node plugin/analysis-view/presentation-test.mjs
node plugin/analysis-view/chat-action-test.mjs
node plugin/analysis-view/perf-test.mjs
node docs/demo/layout-review/context-cost-test.mjs
plugin/ 提供宿主接入,analyzers/ 处理原生记录,view/ 与 report/ 提供视图和报告组件。公开展示素材可由 node scripts/build-readme-media.mjs --serve 3099 重现。
许可证
MIT © 2026 goatliamia
轨迹树和 Eval 随附由 Vercel 与 basement.studio 合作制作的 Geist Sans 和 Geist Mono,字体采用 SIL Open Font License 1.1。Geist 官网 · 随附的字体许可证
Comments
Loading…
Similar plugins
Trace Compare for DeepSeek Harness: upload session logs or follow the live session and visualize the agent's exploration maze — main path, detours, and backtracks on one timeline
★ 87
↓ 12/wk
MIT
HTML
Aug 25, 2026
dsh plugin --profile web add dsh-trace-compareby NOirBRight
External Agent control plane for Codex, Claude Code, Cursor Agent, and Antigravity adapters with settings and background job visibility.
★ 0
TypeScript
Sep 25, 2026
dsh plugin --profile web add dsh-external-agentsby lunarmoon26
One scaffold, five agent harnesses — portable coding-agent plugins for Claude Code, Codex, OpenCode, Antigravity, and DeepSeek Harness.
★ 0
MIT
Rust
Sep 27, 2026
dsh plugin --profile web add harness-alchemistby manny333
Session-scoped checklists for DeepSeek Harness — the agent tracks work as a tree, the model always sees a compact digest, and a read-only sidebar tab mirrors it.
★ 0
MIT
TypeScript
Oct 22, 2026
dsh plugin --profile web add dsh-checklistsby Liu-Bot24
DeepSeek Harness(DSH)只读执行轨迹复盘插件,支持规则分析、独立模型解读、证据定位、任务概览与运行对比。
★ 7
MIT
JavaScript
Oct 21, 2026
dsh plugin --profile web add dsh-plugin-trace-insightby MJorgin
⚡ DSH 指挥家 / Conductor for DeepSeek Harness — in-session dispatch to 11 external agent CLIs (Codex, Claude Code, TraeCode, OpenCode, Gemini, Cursor, Kimi, Qwen, Copilot, WorkBuddy, Grok). Zero-dep skil
★ 17
↓ 336/wk
MIT
JavaScript
Nov 17, 2026
dsh plugin --profile web add dsh-agent-conductor