磁带录制回放 Glaz-j/dsh-Tape

dsh-tool-tape

DeepSeek Harness 工具的确定性录制/回放中间件。Tape 用工具名加上规范化 JSON 参数，为显式允许的调用生成键，记录规范化后的分发结果，之后直接回放，不再进入真实工具主体。

回放是严格的：选中的调用如果在 cassette 里不存在，就返回 TAPE_MISS，绝不会落到网络或另一个服务商。Tape 始终放行 run_code，而选中的 Code Mode 子调用仍会各自独立经过同一中间件。

配置

| 键 | 类型 | 含义 |
| mode | record \| replay | 执行并持久化调用，或严格从 cassette 提供结果。 |
| path | string | JSON cassette 路径。相对路径从进程 cwd 解析。 |
| include | string[] | 必需的工具名允许列表； 是唯一的通配符。 |

只添加只读工具，且其完整环境输入都由参数表示。DSH 没有通用的纯函数标记，所以 Tape 刻意不提供自动的「安全工具」模式。

可安装 bundle 会贡献一行休眠的 tape。在配置档的 cordis.patch.yml 或 --patch 覆盖层里启用它：

- id: tape
disabled: false
config:
mode: record
path: !!js dshHomePath('tapes', 'demo.json')
include: [web_search, web_fetch, 'mcp_']

离线运行时只把 mode 改成 replay。配置档补丁会替换完整配置，所以三个键都要保留。

Cassette 行为

版本一的 JSON 文档存储 { tool, arguments, result } 条目。对象键顺序不影响匹配。加载会拒绝格式错误的数据、外来版本和重复调用；回放还会在插件启动时拒绝缺失的文件。录制写入是串行的，并以原子方式替换属主私有文件。用同一个键和同一个结果重新录制是空操作；结果不同则返回 TAPE_RECORD_CONFLICT，并保留第一条条目。

成功的录制会刻意省略 additionalContexts 和 concludesTurn。回放时，DSH 会用当前注册的工具输出 schema 校验存储的规范化值，用当前工具定义渲染它，然后运行当前的 post-execute 策略。

开发

开发链接目前指向 DeepSeek Harness 0.1.0-rc.7 源码树。安装依赖前，先检出并构建本仓库旁边的 deepseek-harness：

parent/
├── deepseek-harness/
└── dsh-Tape/

cd ..\deepseek-harness
pnpm install
pnpm build

cd ..\dsh-Tape
pnpm install
pnpm test

pnpm run build 把可发布的 JavaScript、source map 和声明文件写入 lib/。这些生成文件是刻意纳入版本管理的。pnpm pack 通过 prepack 自动运行构建。

已知限制

- 调用可能依赖环境 cwd、工作区、凭据、时间或租户状态，而这些都不在参数里；只允许列表中的工具，且其名称和参数构成完整的回放键。
- 重放会改变状态的工具时，会跳过它的副作用。Tape 无法推断某个工具是只读的。
- 一个 cassette 只由一个进程持有。同一插件实例内的写入会串行化，但不同进程之间可能发生竞争。
- 原子替换能防止读取方看到不完整的文档，但当前 helper 并不保证在每个平台上都具备崩溃级别的 fsync 持久性。
- 每新增一条记录都会重写整个 JSON 文档，且在这个初版中没有配置大小上限。
- 工具主体的延迟上下文在 tools/execute 瀑布之后才附加，因此不在记录的外部结果之内。