JxaMe/dsh-condense

README 摘要

✂️ dsh-condense 浓缩上下文，留住精华。 Condense your context. Keep the essence. 面向 DeepSeek Harness 的 token 优化插件 — 自动削减 agent 循环中的低价值内容，同时 保持 prompt 缓存命中 。 中文 · English 🧐 为什么需要它 LLM 编程 agent 在很少有帮助的内容上烧 token： 浪费场景 说明 📚 整文件读取 node modules 、lock 文件、vendor 代码灌满上下文 🐘 超大输出 工具输出在整个会话期间留在历史里 🔁 重复读取 同一文件被连续读两遍 🎯 盲目检索 候选 20 个文件时只读 5 个就够 📝 啰嗦回复 一句话能说清时模型写一大段 dsh-condense 在每一个点上动手。 💡 核心考量：省 token，同时不破坏缓存命中 💰 API 侧的 prompt 缓存按 前缀匹配 计费：命中部分大幅折扣（约全价的 1/10），未命中的新增内容才是全价。 两种"省 token"的思路，结果截然不同： 思路 缓存影响 结论 ❌ 事后削减 （摘掉/重写已进历史的内容） 历史前缀一变，后续请求从变化点起全部 cache miss 省下的 token 被全价重算抵消， 可能比不省更贵 ✅ 入历史前削减 （本插件的做法） 历史从创建起就是浓缩形态，前缀 字节级稳定 缓存命中率不受影响 🎯 省的是 未命中的全价 token （每次新增的大块输出），保留的是 已命中的折扣 token —— 这正是经济收益最大的位置。 ⚙️ 功能一览 能力 机制 时机 🚫 屏蔽低信号读取 tools/pre-execute 拒绝读取 node modules/ 、 .git/ 、 dist/ 、lock 文件、 .min.js 自动 🧭 read → smart read 引导 模型全量 read 源码文件时拒绝并提示改用骨架读取；局部读不受影响（Config smartReadRedirect ，默认开） 自动 🗜️ 压缩超大输出 tools/post-execute 对 8 KB 输出做头尾截断 自动 ♻️ 重复调用去重 相同调用且 输出哈希一致 即返回占位符（无时间窗口，输出一变就返回新内容，绝不误导）。覆盖只读工具 + bash 自动 🤫 conciseness 指令 系统提示注入"直接回答、不说废话" 自动 🧠 smart read tree-sitter 语法级骨架提取 — TS/JS/TSX/JSX/Python/Rust/Go 按需 🔍 trim context BM25 候选文件排序（支持 中英文 ） 按需 📊 condense stats 统一节省量统计 + 真实用量计量 + 持久化 按需 📈 实测效果…

分类