preflower/deepseek-harness-compaction-ui0

deepseek-harness-compaction-ui

官方 DeepSeek Harness 上下文压缩功能的图形化百分比与 Token 设置插件。

AI 分析

核心用途是为 DSH 的上下文压缩功能提供直观的配置界面。适合需要精细调整模型上下文触发阈值和保留量的用户。支持 Token 固定数值模式和窗口比例百分比模式。

包名
deepseek-harness-compaction-ui
版本
0.2.0
许可证
MIT
最近更新
2026年8月17日

安装

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:preflower/deepseek-harness-compaction-ui

插件配置

上下文压缩插件配置

使用

安装后打开:

设置 → 插件 → 插件配置 → 上下文压缩

设置Tokens 模式百分比模式
触发阈值达到固定 Token 数后压缩按模型上下文窗口的比例触发
保留近期对话固定保留最近的 Token 数按模型上下文窗口的比例保留

百分比模式会同时显示按当前上下文窗口换算的近似 Token 数。保留量必须小于触发阈值,否则无法保存。

默认策略:

设置默认值
自动压缩开启
触发阈值256,000 Tokens
保留近期对话64,000 Tokens
上下文窗口1,000,000 Tokens

高级配置

通常不需要手动编辑 YAML。需要为自定义模型设置独立窗口或策略时,可在 profile 的 cordis.patch.yml 中覆盖插件配置:

- id: compaction-absolute-tokens
  config:
    thresholdMode: ratio
    thresholdRatio: 0.8
    retainMode: ratio
    retainRatio: 0.16
    thresholdTokens: 256000
    retainTokens: 64000
    contextWindowTokens: 1000000
    maxTokens: 8192
    compactionRetries: 1
    maxOverflowRetries: 1
    auto: true
    targets:
      - provider: deepseek-official
        model: deepseek-v4-flash
      - provider: deepseek-official
        model: deepseek-v4-pro

thresholdModeretainMode 可分别设为 tokensratio。YAML 中的比例使用 0 到 1,例如 0.8 表示 80%。

绝对触发模式依赖 contextWindowTokens 完成换算。自定义模型应填写与其适配器实际容量一致的上下文窗口。

DSH 会整体替换同一插件条目的 config,手动覆盖时应重述需要保留的字段。内部 ID compaction-absolute-tokens 为兼容已有 profile 而保留。