工具结果裁剪提示 MathieuPortmann/dsh-tool-result-pruner-plus

dsh-tool-result-pruner-plus

直接替换 DSH 的工具结果裁剪器（@deepseek-ai/dsh-compaction-tool-result-pruner）。长工具结果被截断以节省上下文时，结果现在会以一条提示开头，说明它不完整、缺了什么、以及具体怎么读回完整内容。

维护：尽力而为。 Issue 可能没人回；欢迎 fork。

为什么

原版裁剪器保留超大结果的前 4096 个字符和后 1024 个字符，中间塞一句 [... tool result middle pruned ...]。模型要先读完 4 KB 看起来正常的输出，才会碰到这个标记，而且没有大小、没有范围、也没有回读的办法。小模型于是断定某样东西不存在，重跑同一条命令（还是被同样截断），或者拿一个残缺的文件继续干活。见 deepseek-harness discussion 8153，本插件实现的就是其中提出的头部提示方案。

模型看到什么

[INCOMPLETE tool result (pruned): you see only part of it. The full result was 48970 chars over 851 lines. Shown: chars 1-4096 and chars 47947-48970. NOT shown: chars 4097-47946.
Source: read {"file_path":"/home/u/inventory.txt"} at 2026-10-25T17:26:10.802Z; it may have changed since.
File lines 71-829 are missing or partial: do not conclude that something is absent from the file before checking them. Looking for something specific: search for it first (grep -n), or read only the lines you need. To read all of them: read file_path="/home/u/inventory.txt" offset=71 limit=131, then continue from the next offset (6 reads in all). Do not run the same command or read again unchanged: it is cut the same way.]

然后是常规的头部、一个标明自身范围的中间标记（[... chars 4097-47946 not shown; see the notice at the top ...]），以及尾部。

- read 结果：缺失的文件行号来自切口两侧的 N: 前缀（尾部第一行忽略，因为它从行中间开始）。切片大小取自缺口自身的平均行长，并保持在阈值以下，所以回读不会被再次截断。如果某一行比一个结果能容纳的还长，提示会改为建议搜索。
- 其他工具：提示给出第一个缺失的输出行，并建议分段用 sed -n 'A,Bp'、grep，或把输出写到文件。
- 已经被截断过的结果会标注出来，但不给行号提示（它的计数是剩余部分的，不是原始的）。
- 预算：提示要能塞进头部和尾部之间；不够就缩短头部（绝不低于 1024 字符）。连这样都不够，或者结果有任何异常，该结果就走原版裁剪。一个格式错误的事件只跳过那一个结果。

实测效果

一次性 DSH 0.2.1-rc.2 配置档，Ollama 上的 qwen3.5:9b（32K 窗口），每次同一个提示词：读一个 845 行的文件（45 KB），说出是否有任何条目带 CODE= 值（有一个，在第 517 行，就在被裁掉的中间部分里）。
| 修剪器 | 正确回答数 |
| 原版 | 0 / 4（四个都回答「none」） |
| 本插件 | 4 / 4（每个都按提示操作：对文件执行一次 grep CODE=，然后给出正确答案；共 2 次工具调用） |

安装

dsh plugin --profile web add github:MathieuPortmann/dsh-tool-result-pruner-plus

修剪器位于每个智能体预设的 compaction 分组内，所以只安装包还不够：在你配置档的 cordis.patch.yml 里，凡是预设列出

- id: tool-result-pruner
name: '@deepseek-ai/dsh-compaction-tool-result-pruner'

的地方，把 name 改成 'dsh-tool-result-pruner-plus'（保留 config 块）。用 dsh --profile web --dump-config | grep -A1 'id: tool-result-pruner' 检查，然后重启。要回退，恢复原版名称即可。

配置

原版的键、默认值和校验都不变：thresholdChars（8192）、headChars（4096）、tailChars（1024）。

兼容性

| 组件 | 支持情况 |
| Node.js | ^22.19.0 \|\| >=24.0.0 |
| DSH | >=0.2.0-rc.2 <0.3.0；继承已安装的原版 ToolResultPruner 类，并导入 @deepseek-ai/dsh-llm（两者都声明为可选的 peerDependencies） |
| 平台 | 任意；纯 JavaScript |

已在 DSH 0.2.1-rc.2 上测试。

权限与外部服务

| 能力 | 用途 |
| 文件、网络、命令 | 无 |
| 动态模块加载 | 从运行插件的 DSH 安装中加载原版修剪器和 @deepseek-ai/dsh-llm；不下载任何内容 |
| 会话日志 | 与原版修剪器相同的 compaction/prune + tool/result 替换事件；提示中会引用工具调用参数（截断到 200 字符） |

开发

npm test # 9 standalone tests of lib/notice.js, no DSH needed

许可证

MIT