利用卸载
让庞大的文件、长日志和仓库范围的搜索远离编码代理的上下文。
你已经付费的计划中的一个小模型会阅读它们，并将答案交给你，每一行参考都经过检查。
Claude Code·Codex·Gemini CLI·Copilot CLI·Cursor·OpenCode·Pi·Qwen Code·Crush·Kilo·Windsurf·任何MCP客户端
真实输出，重播：worker claude:haiku 克劳德的计划
安装
npx harness-offload@latest install
它询问你的哪个代理设置它(Claude Code, Codex, Cursor, Gemini CLI, Copilot CLI, Qwen Code， Crush, Pi, OpenCode, Kilo（它找到的是勾选的），无论是对你所有的项目还是只对这个项目， 准确显示将要更改的内容，只有在您同意后才安装。然后每个代理读取 它自己的小 以你已经支付的计划为模型： Claude Code→Haiku、Codex→gpt-6-luna、Gemini CLI→Flash-Lite…
只有克劳德代码？ claude plugin install harness-offload --marketplace levgiorg/harness-offload
它改变了什么，在哪里
| 代理 | 会发生什么 | 在 |
|---|---|---|
| 克劳德代码 | claude plugin install … --scope user (或 project） | 由Claude Code管理(~/.claude，或者项目的 .claude/settings.json） |
| Codex·副驾驶CLI·Qwen Code·Pi·Devin | 自己的插件/扩展命令 | 由每个代理管理 |
| 双子座CLI | 一个新的扩展文件夹 | ~/.gemini/extensions/harness-offload/ |
| 光标 | 插件的副本 | ~/.cursor/plugins/local/harness-offload/ |
| OpenCode·Kilo | 一个一行的插件文件 | ~/.config/opencode/plugins/， ~/.config/kilo/plugin/ |
| 粉碎 | 2个钩子和一个指南添加到你的设置中（保留备份） | ~/.config/crush/crush.json |
| 卸载本身 | 它自己的副本，所以代理不依赖于NPX缓存 | ~/.local/share/harness-offload/ |
什么也跑不掉。 npm install 时间;只有 install 改变任何东西。每个代理的详细信息： 文档/ hosts.md。
- 检查:
npx harness-offload doctor· 更新: 再次运行安装命令(它显示为updated 0.2.0 → …） - 改变阅读的人 （另一个模型，一个API密钥，一个本地模型）：
npx harness-offload model …（18家供应商+本地),或/harness-offload:setup克劳德法典 - 没有问题 （脚本，CI，或从代理内部）：
npx harness-offload@latest install --yes [--agents claude,codex] [--scope project] - 删除:
npx harness-offload uninstall（问；你的设置保持不变，除非你这么说）·克劳德代码单独：claude plugin uninstall harness-offload@harness-offload - 让你的经纪人去做： 粘贴 “快跑
npx harness-offload@latest install --dry-run，让我看看它会改变什么，然后运行它--yes --agents <this agent>”。
它节省了什么？
| 你的代理人要求 | 会读到 | 回来 | 事实发现 |
|---|---|---|---|
| 关于919线模块的问题 | 9666令牌 | 402 - 412 | 4 / 4 |
| 包含两个故障的2,323行CI日志 | 32771年 | 651 - 665 | 3 / 3 |
| 从Pytest文件编写的参考测试 | 759 | 52 | 30 / 30和24 / 26测试通过¹ |
测量2026-11-02，Haiku作为工人，在两个引擎上（范围=两个引擎）-
文档/ VALIDATION.md． ¹在生成的测试中，两个失败是错误的期望值：
回顾一下 write 产生。
如何使用它
你通常不会：钩子抓住昂贵的动作并引导代理。当您或代理商直接需要时：
offload read -q "how are late fees applied?" src/ledger.ts # answer + checked path:line citations
offload explore "where is the retry policy configured?" # read-only search across the repo
offload run -- npm test # long output → digest + verbatim errors
offload task review-sql src/db/ # your own task: your instructions, checked citations
offload dashboard --open # what stayed out of your context
您自己的任务是几行配置 文档/ commands.md。
它是如何工作的
- 一个钩子把大的读回来。 完整阅读超过600行(或一个
cat（一）得到一个大纲和更便宜的选择。 - 一个小模特读着它。
offload将文件发送给工作线程，并删除所有拒绝权限和秘密。 - 答案是正确的。 每一个
path:Lx-Ly必须引用确实存在的文本，否则会被标记。 - 嘈杂的输出变成了摘要。 逐字错误行和尾来自脚本；模型只添加一个摘要。
一切都无法打开：如果没有工作人员可用，代理的工具就会像以前一样工作。
文档
| 利用 | 每个集成做什么，安装注意事项 |
| 后端 | @host、OpenCode、Codex、Gemini、Copilot、Qwen、Crush、Pi、API密钥、本地模型、回退 |
| 命令 | 每个命令，出口密码，故障排除 |
| 配置 | 阈值，保护模式，每个项目设置，隐私 |
| 它是如何工作的 | 设计，注意事项，为什么这些数字只是估计值 |
| 相比 | 它与RTK、挤压、上下文模式、分流和模型路由器有何不同 |
| 表演 | 每个工具调用的挂钩成本，有和没有卸载（测量） |
| 安全 | 信任模式，员工锁定，已知极限 |
| 发展 | 测试，布局，发布 |
贡献
欢迎pr——CI运行两个引擎的一致性套件、路由表、三种操作系统上的TypeScript测试，并对每个pull请求进行检测。看到 CONTRIBUTING.md。
致谢
Harness Offload是麻省理工学院许可的原始代码。它的想法是由Spotify的“分流”插件形成的
(apache - 2.0 spotify/portal-ai-plugins)，它将大的读取路由到更便宜的模型
coding-agent挂钩;OpenCode无头的 opencode run;Claude Code的钩子和插件系统，
Codex, Cursor， Gemini CLI和Pi；Boris Cherny关于目标驱动和循环驱动的代理工作流的笔记；和
关于代币节省的社区研究（JetBrains对输出压缩器的研究，LogDx-CI基准）。
不包括第三方源代码。
统计报告嵌入了Archivo、Public Sans和Courier Prime字体的拉丁子集
(SIL开放字体许可证1.1 LICENSE-FONTS）.