dsh-tool-cassette

Agent 工作流的测试长期被两类不稳定因素困扰：模型输出难以复现，外部工具又依赖真实网络、第三方服务或一台随时可能宕机的本地进程。官方 dsh-llm-replay 已经能回放模型流，但 HTTP、MCP、数据库、Python/Go/Java sidecar 等工具正文仍然会真实发请求、改数据、依赖一台恰好没开机的服务。dsh-tool-cassette 把镜头对准了工具正文边界：选中的叶子工具第一次真跑，之后拔掉网线也能把同一段戏完整演完。

核心能力围绕三件事展开。第一，录制——Record 模式让工具正文只执行一次，DSH 规范化后的 value、error 和 additionalContexts 被逐帧写入带 SHA-256 哈希链的版本化 NDJSON 制品；第二，回放——Replay 模式以结构路径、无损 JSON 参数和 admission ordinal 精确命中同一场调用，工具正文调用严格为零，而旧结果仍要重新通过当前的输出 schema、renderer 和后置策略；第三，失败关闭——任何轨迹偏差立刻让回放器进入 poisoned 状态，阻止一半读录像、一半碰生产服务的混合场面，进程以非零退出码结束。

适合这样一群人：需要给 Agent 工作流做离线回归测试的团队；希望在 CI 中稳定复现一次昂贵或偶发工具响应的工程师；验证插件升级后旧结果仍能被当前契约正确处理的维护者；以及想调试多语言 sidecar 工具又不想反复触碰真实服务的开发者。与官方 dsh-llm-replay 组合，可以搭建模型流与工具流都可回放的无密钥测试管线。