dsh-funnel

每次工具调用的结果都会追加到对话上下文中，并在后续每一轮模型请求里反复发送。一次五百行的测试输出、一次大文件读取、一次网页抓取，都会在余下整个会话里持续占用 token、挤占窗口、淹没模型真正需要的那一行报错。现有的截断与压缩机制要么只作用于 shell，要么只在预算超标后才补救，要么按头尾盲切而不保留错误行。

dsh-funnel 在每一次工具结果进入上下文的瞬间做筛选：保留头部、尾部和所有错误与警告行，将中间冗余内容溢出到本地磁盘并留下路径指针。在真实无头会话中，一次 2001 行的 bash 结果被压缩为模型可见的 370 字符，每一轮后续请求都在为此付费而非为 8893 字节付费。溢出文件并非删除，模型在测试中自行读取 spill 文件补回了遗漏的中间行——筛选是分页，不是丢失。

它适合长期跑 agent 工作流、频繁调用大输出工具（测试、构建、爬取、批量文件读取）的开发者。零配置即生效，低于阈值的结果原样通过，错误结果永远不触碰，与官方压缩机制互补而非替代。