zixin947/dsh-compact

README 摘要

dsh-compact dsh-compact 是面向 DeepSeek Harness 的上下文压缩插件，用于在对话接近模型上下文上限时自动生成检查点摘要，并在发生上下文溢出时进行有界恢复。 该插件最初随 Deepseek Harness EAC 开发，独立仓库用于单独维护和分发插件本体。 功能 - 根据上下文占用比例，在普通请求开始前自动压缩历史内容。 - 提供 /compact 命令和设置页中的手动压缩入口。 - 保留最近一段上下文，将较早内容替换成持久化摘要。 - 上下文溢出时最多按配置进行有限次数的压缩恢复和请求重试。 - 裁剪过长的工具结果，降低工具输出持续占用上下文的概率。 - 支持按模型配置不同的触发比例、保留比例和恢复策略。 - 压缩失败时不中断用户当前请求。 - 单次压力检查最多生成一个摘要，避免同一回合连续压缩。 - 当摘要模型返回空文本时，会移除 Agent system prompt 和工具定义后降级重试一次。 安装 Deepseek Harness EAC 当包含该插件的 EAC 版本正式发布后，插件会作为内置组件安装，不需要重复添加。 从 GitHub 安装 完全退出正在运行的 DSH 服务，然后执行： 安装完成后重新启动 DSH Web 服务。 默认挂载配置由 cordis.patch.yml 提供： 如果目标 Agent preset 需要独立的 Agent 级压缩入口，可以在对应组合中挂载： dsh-compact/agent 会在同一个 Agent 局部作用域中组合压缩引擎、 /compact 命令和工具结果裁剪器。 默认配置 配置项 默认值 说明 : enabled true 是否启用自动压缩和溢出恢复 thresholdRatio 0.75 上下文达到模型窗口的 75% 时触发自动压缩 retainRatio 0.20 压缩后保留最近约 20% 的上下文 recoverOnOverflow true 上下文溢出时是否尝试压缩恢复 maxOverflowRetries 1 原请求发生溢出后允许的最大恢复重试次数 modelPolicies [] 按 provider 和 model 精确覆盖默认策略 示例： 约束： - thresholdRatio 允许范围为 0.50 到 0.95 。 - retainRatio 允许范围为 0.05 到 0.50 。 - retainRatio 必须小于对应的 thresholdRatio 。 - 模型策略使用 provider + model 精确匹配。 工作机制 自动压缩 每次 Agent 请求开始前，插件读取当前模型的上下文窗口和会话 Token 估算值。达到触发阈值时： 1. 选择可以压缩的较早会话区间。 2. 使用当前会话的模型生成结构化检查点摘要。 3. 将原区间替换为…

分类