Trajectory Tree · 轨迹树
从对话日志,看见 Agent 怎样工作。
执行路径 · 上下文变化 · 工具证据 · 可视化诊断报告
English · 快速开始 · 宿主接入 · MIT License
DSH Pi Codex Claude Code
开发与审查:PR 关系诊断与原生回归。

从全程主线进入某一轮,查看工具参数、返回、文件变化和反馈。长对话先显示实际主线,再逐步补齐详情。
以下图片和动图使用示例数据,由项目现有视图与报告组件渲染。
追踪上下文怎样变化
点选一种或多种来源,追踪它们的保留量和增减。路径页只显示每轮的增量。

看见上下文逐轮装配
保留的材料留在原位,新内容逐轮接入,历史改写时定位发生变化的片段。组件可嵌入报告,按已有结构记录回放。

把诊断变成一篇可读的报告
把关键判断、证据和下一次行动放在一起,配合数值、分布、趋势及原文位置阅读。报告由 AI 撰写,Markdown 与图表组件装配为可交互 HTML。

快速开始
从仓库根目录操作。插件包自身声明 Node.js 18+,但 DSH 0.2.2 起的宿主需要 Node.js 24.9+;其他宿主的工具与独立视图需要 Node.js 20+。
DSH · 原生插件与分析面板npm pack ./plugin/trajectory-tools
npm pack ./plugin/analysis-view
dsh plugin --profile web add ./dsh-trajectory-tools-0.6.4.tgz ./dsh-analysis-view-0.10.142.tgz
重启 dsh web,在「分析」中查看统计,或用 /trajectory 打开当前会话路径。已运行的实例先退出,避免端口冲突。插件面向 DSH 0.2.2 系列,逐包核对见兼容与语言说明。
可另装 对话搜索,在右侧栏搜索并跳转到消息。DSH 的按需解读会调用当前模型;压缩后对账默认开启,可设 config.reconcile: false 关闭。
npm ci --prefix plugin/portable-tools --ignore-scripts
pi -e ./plugin/portable-tools
使用 /trajectory 打开当前选中分支。trace-analysis 分析会话过程,context-profile 查看当前上下文与工具配置。
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、$trace-analysis 或 $context-profile。
也可以直接生成当前会话视图;读取本机会话需要官方 codex app-server:
node scripts/trajectory-view.mjs --host codex --serve
Claude Code · 原生插件与 transcriptnpm 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:trace-analysis 或 /trajectory-tree:context-profile。插件在会话启动、恢复等时机提供当前 transcript 路径。
离线生成视图
node scripts/trajectory-view.mjs --host pi --file /absolute/session.jsonl --open
node scripts/trajectory-view.mjs --host claude --file /absolute/transcript.jsonl --open
生成过程不调用模型。命令返回独立 HTML 文件和本地预览地址;页面包含字体,可离线保存。
界面默认自动跟随宿主或浏览器语言,可在“自动 / 中文 / English”中选择,也可加 --lang en 或 --lang zh-CN 固定语言。报告正文跟随用户的沟通语言,日志原文、路径和参数保持原样。各宿主的功能与证据边界见兼容与语言说明。
同一组取证工具
| 工具 | 用途 |
|---|---|
trajectory_inspect |
查看过程、耗时、用量、反复尝试、工具文件和上下文统计 |
trajectory_search |
定位会话、字面记录与统计范围 |
trajectory_read |
查看原文、关联动作与反馈,分段追读完整参数和结果 |
trajectory_graph |
查看记录关系与会话谱系 |
查询只读。各宿主按已有记录提供证据,不把未记录的内容补成事实。
| 宿主 | 主要数据来源 |
|---|---|
| DSH | 原生事件与官方统计投影、上下文构成、文件、Skill 和子代理记录 |
| Pi | 选中分支、当前 SDK 配置及采集到的工具执行时间 |
| Codex | 官方会话读取接口,以及对应线程的本地记录补充 |
| Claude Code | 明确选定的 transcript、原生工具参数与结果、已记录的消息用量 |
文档
- 仓库索引——目录、文档导航与常用命令
- 宿主接入与命令
- 工具配置、查询与正文续读
- 分析方法 · 上下文与配置剖面
- HTML 报告组件用法
node scripts/sync-host-skills.mjs --check
node scripts/sync-view-assets.mjs --check
npm test --prefix plugin/trajectory-tools
npm test --prefix plugin/portable-tools
node plugin/analysis-view/presentation-test.mjs
node plugin/analysis-view/perf-test.mjs
plugin/ 提供宿主接入,analyzers/ 处理原生记录,view/ 与 report/ 提供视图和报告组件。公开展示素材可由 node scripts/build-readme-media.mjs --serve 3099 重现。
许可证
MIT © 2026 goatliamia
No comments yet. Be the first to write one.