Headroom 的精简移植，在不影响模型上下文缓存以及 Agent 性能的情况下，压缩工具的输出，至多减少 20% 的上下文。

安装

# GitHub 源码（首次需按提示配置 allowBuilds 构建授权后重试）

dsh plugin --profile web add github:lifeodyssey/dsh-compressor

装任何插件都等于在你的机器上跑第三方代码，权限和你本人一样大——能读你的文件、用你的凭据、访问网络，工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本。请只安装可信来源，并尽量锁定 commit（github:owner/repo#sha）。

README

Headroom 的精简移植，在不影响模型上下文缓存以及 Agent 性能的情况下，压缩工具的输出，至多减少 20% 的上下文。

dsh plugin --profile web add dsh-compressor

模型跑工具会留下一大段日志 / JSON / diff，里面只有一小部分有用。插件把长输出压短再给模型，原文留在本机；已经发给模型的前缀不改，避免动到缓存，并提供工具让 Agent 取回完整上下文。

flowchart LR
  A[工具跑完] --> B{输出很长?}
  B -->|不| C[原文进对话]
  B -->|是| D[压短，原文存盘]
  D --> E[模型看到有用的那截]

压缩器代码来自 Headroom。现在接上的是 Log / Smart / Text / Search / Diff。还没接进来的压缩器就这两个：

cd plugins/dsh-compressor
pnpm install
pnpm test

PR 开到本仓库，不要开到 Headroom。

插件在 plugins/dsh-compressor（Node 22+、pnpm）：

cd plugins/dsh-compressor
pnpm install
pnpm test
pnpm typecheck

改压缩器在 crates/：

cargo test --workspace
make test-parity

一个 PR 只做一件事。改插件补测试，改压缩器过 cargo test。更细的步骤见 CONTRIBUTING.zh-CN.md。

本插件 MIT。crates/headroom-* 仍是 Apache-2.0。