preflower/deepseek-harness-compaction-ui

README 摘要

deepseek-harness-compaction-ui DeepSeek Harness 官方上下文压缩的可视化配置插件。 它在 Web 设置页中提供与 Harness 原生插件一致的配置卡片，可使用百分比或绝对 Tokens 调整自动压缩阈值和近期内容保留量。摘要、消息重放、checkpoint 与会话持久化仍由官方 @deepseek-ai/dsh-compaction-basic 负责。 功能 - 在 设置 → 插件 → 插件配置 中管理上下文压缩。 - 触发阈值支持百分比和绝对 Tokens。 - 近期内容保留量支持百分比和绝对 Tokens。 - 切换单位时自动换算等效值。 - 保存后热更新，不需要重新创建会话。 - 在输入框旁显示压缩阈值进度圆环。 - 支持按 provider/model 设置独立策略。 界面预览 插件配置 压缩阈值圆环 悬停圆环可查看当前上下文用量、自动压缩阈值和占用比例。达到阈值时圆环会变红；旁边的浅色圆环是 Harness 自带的上下文窗口占用率。 安装 发布到 npm 后，可安装到 DSH 的 Web profile： 该命令只安装插件并退出，不会启动 DSH。 从本地源码安装： 如果 DSH 已经运行，请在安装后重启现有服务。 使用 安装后打开： 设置 → 插件 → 插件配置 → 上下文压缩 设置 Tokens 模式 百分比模式 触发阈值 达到固定 Token 数后压缩 按模型上下文窗口的比例触发 保留近期对话 固定保留最近的 Token 数 按模型上下文窗口的比例保留 百分比模式会同时显示按当前上下文窗口换算的近似 Token 数。保留量必须小于触发阈值，否则无法保存。 默认策略： 设置 默认值 : 自动压缩 开启 触发阈值 256,000 Tokens 保留近期对话 64,000 Tokens 上下文窗口 1,000,000 Tokens 实现边界 本插件不是另一套压缩引擎。它只负责： 1. 展示和保存可视化设置。 2. 将绝对触发值换算为官方引擎使用的 thresholdRatio 。 3. 将百分比策略直接传给官方 thresholdRatio 和 retainRatio 。 4. 校验配置并在运行时热更新策略。 压缩范围选择、工具调用配对、摘要生成、消息替换、持久化事件、取消和上下文溢出恢复均由 DeepSeek Harness 官方组件处理。 高级配置 通常不需要手动编辑 YAML。需要为自定义模型设置独立窗口或策略时，可在 profile 的 cordis.patch.yml 中覆盖插件配置： thresholdMode 和 retainMode 可分别设为 tokens 或 ratio 。YAML 中的比例使用 0 到 1，例如 0.8 表示 80%。 绝对触发模式依赖 contextWindow…

分类