dsh-trace-repeat

dsh-trace-repeat

任务 Trace 记录/回放插件（DSH Web）：原子、版本化地记录任意会话的执行 trace——每次推理完成（assistant 消息收齐所有 chunk 后的最终消息）或 tool 执行完成 就是一个不可变版本，含完整可复现元数据（provider/model/reasoningEffort/maxTokens/token 用量/输入输出）；支持回放（版本时间线 + 详情）与从历史版本恢复执行；与 task-control 暂停/恢复 衔接；多版本经 git commit + worktree 物化。

功能

限制

• 只记录收齐后的最终消息（不含流式增量）。
• 恢复执行只能在「推理完成」版本（无悬挂 tool 调用）进行；回合中间版本会报错并提示更早的平衡版本。
• 回放/恢复不修改原会话 trace；新会话产生独立 trace。
• git 物化只覆盖 trace 文件（不含该时刻工作区文件快照）。
• 暂停/恢复标记版本在「暂停/恢复后的下一个会话事件」时写入（状态来自 taskControl 服务对账）；纯暂停+恢复且中间无任何事件时不会产生标记版本。

安装

包内已含 dsh.bundle manifest，安装后自动激活（无需手动修改任何配置）：

# 从 GitHub 安装
dsh plugin --profile web add github:p2coder/dsh-trace-repeat
# 发布 npm 后亦可：dsh plugin --profile web add dsh-trace-repeat

安装后完整重启 dsh web（宿主插件不支持运行时热装），并在浏览器中刷新页面。

使用

• 任意会话运行即自动记录（无需开启）。
• 命令：/trace（列会话）、/trace show <session> [vN]（版本时间线/详情）、/trace resume <session> <vN>（从该版本恢复执行）。

结构

dsh-trace-repeat/
├── package.json          # dsh.bundle.patch 声明（纯宿主端，无浏览器半）
├── cordis.patch.yml      # 一行：- id: trace-repeat / name: dsh-trace-repeat
├── lib/
│   └── index.js          # 宿主端：记录器 + 原子存储 + git/worktree + /trace 命令 + 恢复执行（零外部 import）
└── test/
    └── host-smoke.mjs    # 宿主端逻辑冒烟测试（node test/host-smoke.mjs）