DeepSeek Harness Plugin Hub

发布与管理完整 Harness Profiles,发现适合你的插件。

探索

插件目录环境预设文档中心动态

社区

发布插件联系我们报告问题

相关链接

Plugin Hub GitHubDeepSeek Harness 官方项目系统状态隐私说明
© 2026 DeepSeek Harness Plugin HubPowered byPaxTech

独立、非官方社区项目,与 DeepSeek 官方无隶属、授权或背书关系。

DeepSeek Harness Plugin Hub
ProfilesPlugins分类动态文档登录管理 Profiles
ProfilesPlugins分类动态文档登录
← Plugins
C

dsh-compaction-threshold

Compaction Threshold

DSH 会话压缩阈值设置:在「插件」页本插件的配置卡里调自动压缩触发点与保留比例,保存即时写进 agent preset 隔离的压缩引擎

插件会安装到这里;不确定时保持 web。

npx -y @deepseek-ai/dsh plugin --profile web add github:SunlitCrack/dsh-compaction-threshold#14147db523b06dba17a83a1e98ee31cf912d94dd
README兼容性版本

兼容性与来源证明

Compaction Threshold 以 dsh-compaction-threshold 发布,当前版本为 0.1.0。Plugin Hub 会校验它的 manifest,并保存精确安装来源,便于复现安装结果。

DSH 兼容范围
*
运行环境
web
发布来源
github
Registry 更新时间
2026/10/16

版本

0.1.0stable
2026/10/16

相关插件

正在加载相关插件…

最新版
0.1.0
DSH
*
HMR
重启进程
Tree shaking
未声明可安全裁剪
解包体积
未提供
文件数
未提供
Surface
web
许可证
MIT
发布源
github
GitHub
★ 0
周下载
0
最近提交
2026/10/28
查看源码 ↗
README Badge

点击下方 Badge 复制 Markdown,粘贴到 README 即可。

这是你的 Plugin?认领权益 · 优先安全扫描

验证 package.json 声明的 GitHub 仓库,即可管理这个公开页面。认领后,Hub 会优先安排当前版本的安全扫描,并在通过后公开展示结果。

认领这个 Plugin →
报告问题

相关插件

继续浏览 memory-context 分类下经过校验的插件。

Experimental Session Search@deepseek-ai/dsh-experimental-session-search为 Agents 提供搜索和读取当前工作区早期会话的工具。Hindsight Coding Agents@vectorize-io/hindsight-coding-agents面向编程代理的仅反思式 Hindsight 长期记忆(可插拔支持多种运行框架:opencode、……),自动在后台导入(无需设置 CLI)。Mnemondsh-mnemon面向 DeepSeek Harness 的可组合、基于视图的上下文。开箱即用的可插拔来源与策略、分层记忆和自我演进技能。Ab Memorydsh-ab-memory--- description: "dsh-ab-memory 包:一种跨会话、基于文件的智能体记忆,提供五个工具(remember / recall / forget / load_skill / distill)以及始终启用的轻量注入。" kind: "package-reference" ---

README

dsh-compaction-threshold

在 插件 → dsh-compaction-threshold 的配置卡里调 DSH 的会话压缩阈值,保存后即时生效,不需要重启。

设置项默认范围说明
触发阈值80%17–90自动压缩在已路由模型上下文窗口的百分之多少处触发
保留近期对话16%1–89压缩时逐字保留的最近对话比例,必须小于触发阈值
自动压缩开—关闭后不再自动压缩,手动 /compact 仍可用

例:窗口 1,000,000 的模型,触发阈值 80% → 800,000 tokens 处压缩,逐字保留 160,000 tokens。

为什么不能只改 profile 配置

DSH 内核本来就带压缩(@deepseek-ai/dsh-compaction-basic,默认 thresholdRatio = 0.8 / retainRatio = 0.16),但在 web / desktop 装配下改不到:

  • 组合里进程级那一行 compaction-basic 是被禁用的;
  • 每个 agent preset 在自己的隔离 realm 里各挂一个 BasicCompactionEngine (presets/cordis/agent.cordis.yml 的 compaction 组,isolate: { compaction: true });
  • 往 ~/.dsh/profiles/<name>/cordis.patch.yml 写同 id 行不落到会话实际用的那个引擎。

实现要点(内核 0.1.5-rc.2 实测)

  1. 取得引擎:ctx.get('agentPresets').serviceFor(agent, 'compaction') → 返回该会话所在 preset 隔离 realm 内的 BasicCompactionEngine。
  2. 改值的正确姿势是「替换整个 config 对象」,不能原位赋值:
    • Object.isFrozen(engine.config) === true,而 config 属性本身 writable: true;
    • 原位赋值在 ESM 严格模式下抛 TypeError: Cannot assign to read only property 'thresholdRatio', 被 try/catch 吞掉就等于静默什么都没做(这点极易踩坑);
    • 引擎每次决策都重新读 this.config,所以整体替换即热更新。实测替换后 45 秒回读仍是新值。
  3. 枚举存活会话用 ctx.get('agents').list(): sessionPersistence.list() 的条目形状是 { header, revision, sizeBytes }, 会话 id 在 entry.header.id 里、顶层没有 id;照顶层取会永远扫到 0 个会话。
  4. 两条落地路径:
    • 保存设置时立即扫描存活会话写入(实测 1.5 秒内引擎即为新值);
    • 每个 step 边界 ctx.on('agent/pre-step', …, { prepend: true }) 再兜底同步一次。

不改压缩算法、不碰会话日志:摘要生成、消息替换、checkpoint、持久化、溢出恢复 全部仍是官方 compaction-basic 负责。设置值持久化在设置存储(命名空间 dsh-compaction-threshold),进程重启后由 step 边界重新应用。

安装(本机 DSH Desktop)

Desktop 独占 profile 装配,dsh plugin add 在本机不可用。走本地热装配:

npm pack                                  # → dsh-compaction-threshold-0.1.0.tgz
# 解包到 D:\dsh-plugins\dsh-compaction-threshold
# dev_install_package(dir, profile='desktop')

本插件宿主半边只 import @deepseek-ai/schemastery(0.2.0 起 @deepseek-ai/dsh-settings 的 installSettingsSection / settingsNamespace 已删除,导入它们会让宿主起不来)。 link 安装的插件目录没有自己的 node_modules,因此目录内建立一个指回内核同一份的 junction(不是拷贝,避免版本偏移):

node_modules/@deepseek-ai/schemastery → <app>/dsh/node_modules/@deepseek-ai/schemastery

(<app> = 官方 Harness 安装目录,例如 D:\DeepSeek Harness\resources\app。 注意不要指向社区 Desktop 或其它副本:目标一旦被卸载/移动,悬空链接会让插件 failed to import、宿主启动报错。)

装完硬刷新页面(Ctrl+Shift+R),在 插件 → dsh-compaction-threshold 的配置卡里 即可看到本行(0.2.0 起第三方插件的配置卡在插件页,不在「设置 → 通用」)。

⚠️ 改本插件的代码后需要重启 DSH Desktop 才生效:本机 super-injector 的 dev_reload_package 拿不到 loader.internal,只会"重新装配"旧模块; 且 dev_install_package 见到已存在的 loader entry 会跳过 create。重启后由 profile 的 bundles 列表正常装配。

验证

宿主日志(%APPDATA%\DSH Desktop\logs\host\dsh-<日期>.log)里会有:

[dsh-compaction-threshold] audit-><写入路径> {"event":"applied","thresholdRatio":0.62,…}

同时会往下列第一个可写目录追加一行 JSONL 审计(dsh-compaction-threshold.jsonl): $DSH_HOME → ~/.dsh → 本插件目录。

限制

  • 只调阈值类策略;压缩范围选择、摘要质量、按模型覆盖(modelPolicies)、 摘要模型选择不在本插件范围内。
  • 只支持百分比;按绝对 Token 设阈值需要知道每个模型窗口,未做。
  • 若别处设过 retainTokens,本插件会清掉它(与 retainRatio 互斥)。
  • 某个 preset 若没有压缩组(不压缩的 preset),serviceFor 拿不到引擎,本插件对它无效。

许可

MIT。