KumarZX/kur-compact-trigger

kur-compact-trigger

DSH Plugin
DeepSeek Harness
License: MIT

Category / 分类： dsh-plugin · DeepSeek Harness 第三方插件

会话级压缩，适用于 DeepSeek Harness。官方自动压缩只能全局设置。本插件让每个聊天都能从标题栏选择自己的阈值——无需一直开着设置窗口。

会话级压缩：官方自动压缩只能调全局。本插件在标题栏给每个会话单独设阈值，不必一直开着设置窗。

English

为什么需要这个插件

官方的 @deepseek-ai/dsh-compaction-basic auto 是单一全局策略（通常是模型窗口的 80%）。每个会话都共用它。

一旦 token 价格上涨（DeepSeek 及其他），这就很别扭：一个长时间的研究线程可能需要大窗口，而一个短任务聊天应该尽早压缩。每次切换都打开设置，并不是人们实际工作的方式。

本插件增加了会话级控制：聊天标题栏上的压缩按钮、sessions. 中的可选覆盖，以及仅作为兜底的全局默认值。

它不替代官方摘要器。它决定何时以及哪个范围进行压缩，然后调用 compaction.compactRegion()。

| 设置 | 默认值 | 含义 |
|---|---|---|
| thresholdTokens | 200000 | 当此会话达到这么多 token 时压缩 |
| retainTokens | 32000 | 大致保留这么多近期 token 原文 |
| maxAttempts | 3 | 单轮中最大压缩循环次数 |
| sessions. | — | 会话级覆盖；留空 = 跟随全局 |

压缩切点会移动到工具调用 / 工具结果配对边界，这样工具结果不会与其调用被拆开。

宿主平面，被每个预设共享。不要注入 compaction（该服务位于预设领域）。在 agent/pre-step 时，它使用 ctx.agentPresets.serviceFor(agent, 'compaction')。

截图

标题栏——无需离开聊天即可更改此会话：

标题栏压缩按钮

会话覆盖——字段留空以跟随全局默认值：

会话压缩阈值

设置 → Auto Compact——仅全局兜底；滑块最大值跟随模型上下文窗口：

全局自动压缩设置

安装

1. 将此包复制到 ~/.dsh/profiles/node_modules/kur-compact-trigger/（或 clone / npm pack 到该路径）。
2. 将 examples/cordis.patch.yml 合并到每个配置文件的 cordis.patch.yml（desktop、web、feishu 等）。
3. 在 ~/.dsh/settings.yaml 的 kur-compact-trigger: 下添加 examples/settings.yaml。
4. 重启 DSH Desktop / 配置文件进程。
在 设置 → 自动压缩 中调整全局默认值。在标题栏的 压缩 控件中调整单个会话。

官方自动压缩 vs 本插件

| | 官方 compaction-basic auto | 本插件 |
|---|---|---|
| 范围 | 全局（所有会话共用一个比例） | 按会话，外加一个全局默认值 |
| 典型触发 | 模型上下文窗口的 80% | 绝对 token 阈值（默认 200k） |
| 界面 | 仅设置页 | 标题栏 + 设置页 |

两者可以同时运行。如果你只想要会话级策略，关掉官方 auto，改用本插件。

许可证

MIT

中文

为什么做这个

官方 @deepseek-ai/dsh-compaction-basic 的 auto 只能控制全局（通常是模型窗口的 80%）。所有会话共用同一套。

模型（尤其 DeepSeek）涨价之后，长上下文很贵：有的会话需要大窗口慢慢做，有的短任务根本不该带着几十万 token 往下跑。每次去设置页改全局、改完再改回来，也不方便——设置窗不能一直开着。

所以才有会话级压缩：标题栏给当前对话单独设阈值；sessions. 可覆盖；全局默认只当没覆盖时的兜底。

本插件不实现摘要模型，只决定何时、压哪一段，再调用官方 compaction.compactRegion()。

| 配置 | 默认 | 含义 |
|---|---|---|
| thresholdTokens | 200000 | 本会话总 token 达到此值时压缩 |
| retainTokens | 32000 | 尽量保留尾部最近约这么多原文 token |
| maxAttempts | 3 | 同一轮最多连压几次 |
| sessions. | — | 按会话覆盖；留空跟随全局 |

切分点会挪到工具调用 / 工具结果配对平衡处。挂在 host 平面；不要 inject compaction。在 agent/pre-step 里用 ctx.agentPresets.serviceFor(agent, 'compaction') 取当前 preset。

截图

标题栏入口：不离开对话、也不用开设置窗，改这一路的阈值：

标题栏压缩阈值

本会话覆盖；留空则跟随全局：

本会话压缩阈值

设置 → 自动压缩：只是全局兜底；滑条上限跟随模型窗口：

全局自动压缩设置

安装

1. 把本包放到 ~/.dsh/profiles/node_modules/kur-compact-trigger/（或 clone / npm pack）。
2. 将 examples/cordis.patch.yml 合并进各 profile 的 cordis.patch.yml。
3. 在 ~/.dsh/settings.yaml 写入 examples/settings.yaml 的 kur-compact-trigger: 段。
4. 重启 DSH Desktop 或对应 profile。

全局默认在 设置 → 自动压缩；单个会话用标题栏 压缩阈值。

官方自动压缩 vs 本插件

| | 官方 compaction-basic auto | 本插件 |
|---|---|---|
| 范围 | 只能全局（所有会话同一比例） | 会话级 + 全局兜底 |
| 典型触发 | 模型窗口的 80% | 绝对 token 阈值（默认 20 万） |
| 界面 | 只有设置页 | 标题栏 + 设置页 |

两条线可以同时开。若只想按会话控成本，关掉官方 auto，只用本插件。

许可证

MIT