Skip to content

dsh-readprune

Verified

dsh-readprune · v0.6.0 · MIT

Saves tokens in DeepSeek Harness sessions: read any file by line range or symbol mention instead of whole, and bound oversized tool results while keeping a recovery path. Pruning happens at the source, not after content reaches the context.

Install

dsh plugin add dsh-readprune

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Tags

Readme

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。图标为本插件原创。