DSH 插件：Trajectory Debug Workbench（trajectory-debug）

English | 中文

目标宿主：DeepSeek Harness（@deepseek-ai/dsh v0.1.0-rc.x，开发者预览） 设计文档见仓库外 Doc/（产品/架构/技术/使用指南）。

把 DSH 的事件溯源会话变成可调试的资产：瀑布流轨迹、单步回放（零 Token）、断点暂停/继续、改参重跑（沙箱内）、分叉对比、性能分析，外加 OTel GenAI trace 导出与 trajectory_* 模型工具。

工作区结构

packages/
├── trajectory-debug/              # Service Definition + wire 类型（纯类型包，无插件入口）
├── trajectory-debug-host/         # Host Provider：回放/性能/对比引擎、断点、投影、命令、RPC 传输
│   ├── src/adapt.ts               # DSH SessionEvent → DebugEvent（唯一接触 DSH 词汇的边界）
│   ├── src/replay-engine.ts       # 确定性回放（纯函数，零模型/工具调用）
│   ├── src/perf-analyzer.ts       # 性能折叠（口径对齐 dsh-session-stats）
│   ├── src/diff-engine.ts         # 分叉对比 + JSON diff
│   ├── src/breakpoint-manager.ts  # agent/pre-step waterfall 断点拦截
│   ├── src/projections.ts         # trajectory/perf 投影单元
│   ├── src/commands.ts            # /trajectory /perf
│   ├── src/sidecar.ts             # 侧车（memory/file 原子 JSON）
│   ├── src/transport.ts           # webserver 自定义路由 RPC（浏览器通道）
│   └── src/index.ts               # apply()：装配 + 卸载撤销
├── trajectory-debug-remotes/      # 双面 typert 骨架（浏览器 RPC 实际走 host transport）
├── client-ui-trajectory-debug/    # 浏览器 "Debug" Tab：瀑布流/性能 + 回放/断点/改参/对比面板
└── trajectory-debug-bundle/       # 组合包：dsh.bundle + cordis.patch.yml

命令

corepack pnpm install       # 需要 corepack；Node ≥ 22.19
corepack pnpm -r build      # 产出 lib/（lib-first 清单）
corepack pnpm -r typecheck  # 全部包类型检查
corepack pnpm test          # vitest 单元测试（56 个用例）
corepack pnpm check         # build + typecheck + test 组合门禁
corepack pnpm check:publish # 发布前清单校验
node scripts/smoke.mjs      # 真实 dsh 进程加载冒烟（自动重建 td-smoke profile）

状态

能力	说明
瀑布流数据（引擎）	buildTrajectoryPage：turn/step/tool 行、状态、耗时、Token、错误码、过滤、分页
单步回放（引擎）	stepContextAt：模型视角 + 行动视角；ReplayCursor 步进/seek
性能分析（引擎）	analyzePerf：成功率/分位数、失败归类、Token 分布、TTFT/解码、轮次统计（可配价格表估算成本）
分叉对比（引擎）