jonah791/dsh-agent-context-pruner

README 摘要

dsh-agent-context-pruner 上下文剪枝插件（爱丽丝判断为核心）——开发会话中大部分上下文是一次性消费的残留，剪掉它们省 token 且保护注意力。 安装 设计定调（2026-08-16 主人） - 「是否无用由爱丽丝自己判断」 ：插件只提供 候选检测（含缓存代价）+ 执行原语 + 统计；剪不剪、剪哪些、何时剪——决策归爱丽丝（自主性铁律：机制给原语不给剧本） - 「不能破坏缓存命中」 ：候选按位置标注剪后缓存代价（其后内容重新 prefill 的一次性成本）。tail（最后 3 节点内）= 零缓存破坏；near-tail 小代价；middle 大代价——middle 仅在「节省 × 剩余轮数 缓存代价」时剪 - replay-safe ：头+标记+尾替换（官方 dsh-compaction-tool-result-pruner 同款 surfaceOp replace），仅追加事件日志保留完整原始事件（可回放恢复）；替换前写 compaction/prune 定价事件（tokenMeter 定价） - 白名单 ：只剪 tool/result 节点；系统注入/主人消息/当前任务轮永不入候选 - 注意力保护（爱丽丝侧判断纪律） ：结论已落盘 + 可低成本重取 + 不在当前任务链，三条全满足才剪；剪前自问「主人下一句就问这个，我能答上来吗？」 工具 工具 说明 prune candidates 候选检测（只读）：扫描当前会话表层 tool/result，列出 seq/轮次/大小/估算 token/超预算/剪后缓存代价/位置提示（tail/near-tail/middle） prune apply 执行剪枝（可写）：按 seq 剪指定节点（头+标记+尾），幂等（已剪/预算内自动跳过），返回替换明细与累计统计 prune stats 统计（只读）：本会话累计剪枝次数/节省字符/节省 token/最近剪枝时间（进程内累计，重启清零） 配置 配置键 缺省 含义 thresholdChars 8192 合并文本超过此码点数才算超预算（缺省阈值） headChars 4096 保留开头码点数 tailChars 1024 保留末尾码点数 用法 1. 上下文压力高时（或主动巡检）： prune candidates 查看候选 2. 按判断纪律挑选：tail 放心剪；middle 权衡缓存代价 3. prune apply({ seqs: [...] }) 执行 4. prune stats 查看节省 每轮缓存命中率（v0.1.2+） prune stats 输出每轮每次模型请求的 provider 实测命中率（usage 透传）： hitRate = cacheRead / (input + cacheRead + cacheWrite) （DeepSee…

分类