auto-compact

v1.3.0 · 3 天前发布

会话级自动上下文压缩插件：回合中每步前 + 回合结束检测上下文用量，超过会话阈值自动 compact，摘要注入上下文后自然继续（DeepSeek Harness / DSH）

dshdsh-plugindeepseek-harnesscompactioncontextauto-compactplugin

README

auto-compact

会话级自动上下文压缩插件（DeepSeek Harness / DSH）

在输入区右侧显示一个阈值圆环：当前会话上下文用量实时显示，拖动滑杆设置该会话的压缩阈值（1%–90%，默认 50%）。每当用量超过阈值，插件自动触发上下文压缩（compact）——回合中每走一步之前检查一次，回合结束时再检查一次——压缩摘要注入上下文后会话自然继续，全程无需手动干预，也不发送任何「继续」消息。

特性

🔴 会话级阈值：每个会话独立设置，互不影响（按 sessionId 持久化）

📊 实时用量：与自带 ContextMeter 同源（useProjection("contextPressure")），面板打开即实时刷新，无需轮询

🎚️ 1%–90% 细腻调节：步进 1%，适合精细控制（未设置时默认 50%）

🤖 全自动：回合中每步前 + 回合结束自动检测 → 超阈值自动 compact → 摘要注入后自然继续

🛡️ 零崩溃风险：所有检查都在 agent/pre-step（waterfall 中间件）与 agent/turn-stopping（串行事件）里做，全程 try/catch，绝不抛出

💾 持久化：阈值存于 settings.yaml 的 auto-compact 命名空间，重启不丢

🧊 与内置安全网并存：DSH 自带的 compaction-basic（默认 80% 压力阈值）保留为兜底，互不干扰

安装

前置：已装好 DSH（dsh web 能正常运行），Node.js ≥ 20、pnpm ≥ 10。

一键安装（推荐，复制粘贴即可）

**macOS / Li

查看完整 README →

版本兼容矩阵

DSH 版本	状态	说明
`dsh@0.1.0-rc.6`	✅ 兼容	cordis patch ✅
`dsh@0.1.0`	✅ 兼容	标准 patch ✅
`dsh@0.2.0`	⚠️ 待验证	待实测（API 可能在变）
`dsh@0.3.0+`	❓ 未知	尚未发布

💡 兼容矩阵每周末自动跑实测，欢迎 PR 修正

元数据

License: MIT
npm: auto-compact
Repo: git+https://github.com/JohnathonYe/auto-compact.git
Engines: {}
Weekly DL: 0
Monthly DL: 0
dsh.bundle: {"bundle":{"patch":"./cordis.patch.yml"},"client":{"inject":["@deepseek-ai/dsh-client-runtime","@deepseek-ai/dsh-client-connection","@deepseek-ai/dsh-client-locale","@deepseek-ai/dsh-client-ui-conversation","@deepseek-ai/dsh-api-remotes"],"platform":"web"}}