dsh-compact-manager：DeepSeek Harness 分层压缩阈值管理器

DeepSeek Harness (DSH) 默认使用 @deepseek-ai/dsh-compaction-basic 来管理上下文压缩的触发阈值，公式为 floor(min(W × 0.8, W − O − 65536))。其中 W 是上下文窗口，O 是输出预留。当模型配置的输出上限较高时，W − O − 65536 项会将阈值压得很低。例如 K3-256K 配合 128K 输出预留时，触发阈值仅为窗口的 25%。dsh-compact-manager 旨在解决这一问题，让你可以自定义「何时压缩」的触发点。

插件简介¶

dsh-compact-manager 是一个面向 DeepSeek Harness 的分层压缩阈值管理器。它允许用户按全局 → 上下文长度档位 → 模型三级覆盖自动压缩的触发点，并通过侧边栏实时查看每个模型当前生效的阈值与策略。

维护者：frankshi2024
协议：MIT
分类：模型推理

核心功能¶

三级策略与优先级¶

策略优先级从低到高，高层会覆盖低层：

全局：所有路由生效。
上下文长度档位：窗口长度落在档位值 ±5% 内即算同一档（多档重叠时取最近的一档）。
模型：精确的 provider/model 路由。

每一层都是完整选择：四个策略项各自只有「启用 / 停用」，没有「继承」。高层一旦存在就整体覆盖低层。

策略公式¶

每个策略项支持以下公式（需配合数值使用）：

ratio：W × v（上下文比例）
outputAware：W − O − v（扣掉输出预留和固定值）
fixed：W − v（只扣固定值）
absolute：v（硬编码阈值，只在档位层和模型层可用，v < W 时直接覆盖其他项；v ≥ W 时永不触发）

侧边栏编辑器¶

安装后，侧边栏会出现「压缩策略」页面：
- 实时查看：选择任意已知路由，查看 W、O、当前生效阈值、官方内置阈值。
- 预设套用：一键套用常见策略（如 256K 档：80% 或上下文−32K）。
- 自动刷新：页面每 5 秒自动刷新，窗口获得焦点时也会刷新。

安装与启用¶

使用官方 CLI 安装插件：

dsh plugin --profile <profile> add dsh-compact-manager

安装后侧边栏会出现「压缩策略」页面。若未出现，请刷新浏览器页面。本地 link: 安装时，需确保插件仓库已执行 pnpm install（依赖 zod）。

典型用法¶

打开侧边栏的「压缩策略」页。
在模型下拉列表中选择目标模型，查看其 W（上下文窗口）、O（输出预留）以及当前生效的阈值。
在「预设」区域选择一个策略（例如 256K 档：80% 或上下文−32K）。
保存策略以持久化配置。

适用场景与注意¶

适用场景：需要精细控制上下文压缩触发时机，避免在窗口使用量尚大时就触发压缩导致历史丢失的用户。
权限说明：插件以当前 DSH 进程权限运行，安装前应检查源码与许可证。
已知限制：
- 只覆盖压力触发；上下文溢出恢复（context-overflow）仍走官方路径。
- 只改变触发阈值，不改变一次压缩的保留比例（仍由内置后端决定最近 16% × (W − O)）。
- 模型下拉列表依赖 ctx.llm.listProviders()，未登录的 provider 不可用，也就无法为它新增覆盖（已存在的条目会保留显示）。

生态背景¶

DeepSeek Harness 的理念是「一切皆插件」。本插件属于社区插件，目录与 GitHub 链接如下：