Lem0nTea2002/dsh-tool-cassette

README 摘要

dsh-tool-cassette 给 Agent 的工具调用装一台录像机。 第一次让 HTTP、MCP、数据库和本地程序真跑；以后拔掉网线，也能把同一段戏完整演完。 当外部 API 在 CI 里闹脾气、测试数据突然变脸、第三方服务又一次返回 429 ，按下 Replay：被选工具的真实正文不再执行，录好的规范结果会精确回到 DeepSeek Harness 的工具链中。 非官方社区插件。 本项目由社区成员独立开发和维护，与 DeepSeek 官方无隶属关系，也未获得官方审核或背书。 当前版本为 0.1.0 ，兼容边界固定在 DeepSeek Harness 0.1.0-rc.8 。 先看它表演 演示过程很朴素： 1. 启动一个纯本地 HTTP 天气工具； 2. Record 一次，工具正文与网络请求各发生 1 次； 3. 关闭 HTTP 服务； 4. Replay 同一条调用，工具正文与网络请求都变成 0 ； 5. 返回结果保持一致，cassette 中的记录全部消费。 整个演示不调用模型，也不产生付费 API 请求。服务器已经下班，测试仍然准时上班。 阶段 工具正文 该工具产生的网络请求 结果 : : Record 1 1 武汉天气结果 Replay 0 0 同一份武汉天气结果 它解决什么问题 Agent 测试经常同时依赖两类不稳定因素：模型输出和外部工具。 官方 dsh-llm-replay 已经能回放模型流；HTTP、MCP、数据库、Python、Go、Java 等工具仍可能真的访问网络、修改数据或依赖一台刚好没开机的服务。 dsh-tool-cassette 接管工具正文边界，把一次真实执行变成可验证、可离线复用的测试制品。 它适合这些场景： - 给 Agent 工作流做离线回归测试； - 在 CI 中复现一次昂贵或偶发的工具响应； - 验证插件升级后，当前 schema、renderer 和后置策略仍能处理旧结果； - 调试 HTTP、MCP、数据库或多语言 sidecar 工具，又不想反复触碰真实服务； - 与 dsh-llm-replay 组合，搭建模型流与工具流都可回放的无密钥测试。 快速开始 前置条件：已安装 pnpm。本插件固定兼容 DeepSeek Harness 0.1.0-rc.8 ；该版本当前位于 npm next 标签。安装插件与运行 profile 时请持续使用同一 rc.8 CLI。 安装包会通过 cordis.patch.yml 注入一个默认禁用的 tool-cassette 条目。在 profile 的 cordis.patch.yml 中覆盖它，明确填写模式、文件和叶子工具范围： 跑完一次真实调用后，把 mode 改成 replay ，其余轨迹保持一致： 此时再调用 weather lookup ，cassette …

分类