Token 修剪 songrui111/dsh-readprune

dsh-readprune（Token 修剪）

为 DeepSeek Harness 会话节省 token：让内容一开始就不进入上下文。

Host 插件，在源头修剪输入而不是事后压缩：按行号或符号定位读取文件而非整份读，并对过大的工具结果在边界处设上限，同时保留取回路径。

与压缩类插件的区别

大多数省 token 插件处理的是已经进入上下文的内容：摘要它、折叠它、事后裁剪它。
这个插件试图让昂贵的内容一开始就不进来：

- 问一个函数在哪，不再要付一整个文件
- 一个 17.7 万字符的文档页，不再要付一整页

不做模型改写，也不丢信息：每个被修剪的原文都已存档，可以按偏移读回来。

三个延迟加载工具

| 工具 | 作用 |
| read_range | 只读需要的行：行号窗口、按符号找出所有出现位置并带上下文、或只列结构大纲。输出有硬上限。 |
| tool_catalog | 一行一个列出本会话可调用的工具，让延迟后的工具集仍可被发现。 |
| fetch_recall | 按字符偏移读回任意被修剪结果的片段。 |

两道结果整形

通过 tools/post-execute，按工具名限定范围：

- 网页 —— 有界正文头部（页面标了内容地标时从其开始）＋ 章节摘要。
- shell 输出 —— 头 + 尾。诊断信息在尾部，宿主自带的字节上限否则会把它丢掉。

实测

会话级（真正要紧的数字）

工具结果进入上下文后，每一步都会重发一遍，所以它的真实成本是 大小 × 剩余步数。以一个 30 步、读 4 个文件的会话建模：

| | prompt tokens |
| 整份读 | 667,776 |
| 修剪后 | 374,512 |
| 节省 | 293,264（43.9%） |

节省比例随会话变长而上升：10 步 33.6%，30 步 43.9%，100 步 47.8%。
上限低于 50%，因为固定的 prompt 基线（开场消息、系统提示、工具 schema）每一步都要付，而本插件不碰它。

你可以自己复现：

npm run measure:session

单次操作

同一个问题，只换读法：

| 文件 | 行数 | 整份读 | read_range | 节省 |
| index.js | 464 | 4,661 tok | 188 tok | 96.0% |
| client.js | 710 | 9,389 tok | 274 tok | 97.1% |
| bench/index.js | 875 | 8,999 tok | 513 tok | 94.3% |

过大的结果：

| 对象 | 原始 | 修剪后 | 节省 |
| 文档页（真实抓取） | 46,582 tok | 583 tok | 98.7% |
| shell 输出（287 万字符，宿主截断后） | 16,842 tok | 1,515 tok | 91.0% |

单次数字之所以大，是因为一次操作可以替掉一整个文件。它们不是会话级节省，需要会话级数字请用上面的表。

token 数为对 Harness 计费规则的确定性近似（中文约 1.7 字/token，代码约 3.8 字符/token），用于横向比较，不等于账单。

安装

dsh plugin install dsh-readprune

行 id 保持 token-diet 不随改名变化，因此你在自己 cordis.patch.yml 里的 config 覆盖会继续生效。

配置

| 键 | 默认 | 含义 |
| guide | true | 注入「优先用 read_range」的系统提示词段落。没有它，工具存在但模型仍会整份读。每轮约 162 token。 |
| exposeCatalog | true | 是否注册 tool_catalog。 |
| slim | true | 通过 tools/post-execute 修剪过大的结果。 |
| slimWebTools | ["web_fetch"] | 网页类结果：正文头部 + 章节摘要。 |
| slimShellTools | ["pwsh","bash","wsl","tty_run"] | shell 类结果：头 + 尾。post-execute 是全局 waterfall，只处理列出的工具。 |
| maxInlineChars | 8000 | 超过此字符数才修剪。 |
| headChars | 1500 | 网页模式保留的头部字符数。 |
| shellHeadLines / shellTailLines | 60 / 60 | shell 模式两侧各保留的行数。 |
| durableArchive | true | 把修剪后的原文存到 ~/.dsh/token-diet/archive，定位符可跨重启。磁盘不可用时回退内存。 |
| maxArchiveFiles | 200 | 超过后修剪最旧的存档。 |

测试

npm test # 五套测试，不联网
npm run measure:reads # 单次操作对照表
npm run measure:page # 网页修剪数字（会抓取 docs.python.org）
npm run measure:session # 会话级对照表

npm test 覆盖：工具端到端调用、离线夹具上的修剪、post-execute 接线（含 read/grep/edit 不被触碰的证明）、以及持久化存档。

诚实的边界

- 它不能压缩其他插件的工具 schema。 没有服务或事件能把别的插件的 ToolSchema 标记为 deferLoading，只有本插件自己的工具会被延迟。插件很多的 profile 上，每轮固定的 schema 开销依然存在。
- symbol 模式是文本匹配，不是语义匹配。 搜 save 也会命中 savesSelection；不确定标识符时先用 mode: outline。
- 原版 read 未被改动。 上游文件工具照常可用，所以模型总能回退——这意味着只有它真的选用 read_range 时才省。
- 存档是用户目录下的明文文件，任何以你身份运行的程序都能读。抓取内容可能敏感，共享机器上请慎用。
- 没有使用 spillStore：其运行时可用性无法确认，硬依赖会在其缺失时让修剪整体失效。

许可

MIT。图标为本插件原创。