Skip to content

About

Disable DSH basic compaction without copying official preset configurations.

Resources

Stars

3 stars

Watchers

0 watching

Forks

Latest commit

 

History

3 Commits

Folders and files

Repository files navigation

dsh-compaction-basic-disable

独立的 DSH 插件:禁用 @deepseek-ai/dsh-compaction-basic,而不复制或覆盖整份官方预设。插件自身不写回配置;安装时由 DSH 更新目标 profile 的依赖和 bundle 声明。

禁用范围

  • 当前官方 base 配置中的宿主后端条目 compaction-basic。
  • 官方 Web 的 standard、ptc、minimal、cordis 四个预设内,按包名匹配到的 basic compaction 后端,包括嵌套 Cordis 分组。
  • 后端不被实例化,因此其手动压缩、上下文阈值自动压缩、模型报上下文超限后的压缩重试恢复都不可用。
  • 同时禁用依赖该后端的 /compact 命令,避免预设因缺少 compaction 服务而加载失败。
  • 禁用压缩不会扩大模型的上下文窗口。超限后可能直接报错,需要新开会话或减少上下文。

机制与升级边界

插件源码在 Cordis 的 internal/config 中间件阶段,读取当次解析出的预设配置,给目标后端及其 /compact 命令添加 disabled: true。不原地修改输入,不写回配置,不复制预设快照,因此官方以后新增的工具和配置字段会继续保留。

Bundle 声明只插入策略插件、禁用宿主条目,并为当前四个预设条目设置 inject: [localBasicCompactionPolicy]。策略先注册中间件,再提供该服务;即使动态导入顺序颠倒,预设也必须等策略就绪后才能注册。策略加载失败时,受保护的预设会保持等待,而不是无保护启动。

注意:

  1. 依赖名称含 internal 的框架配置钩子,并非 DSH 官方的全局排除开关。升级后必须复测,不能保证跨版本永远兼容。
  2. 当前四个预设原本没有条目级 inject。Cordis 补丁会替换该列表,不会合并;若这些条目已有或未来新增依赖,需手动合并依赖,集成测试会检查官方声明的变化。
  3. 新增或自定义预设若使用相同的 agent-preset 声明插件,也会被中间件处理,但还需为其条目添加上述依赖门闩,不能只依靠声明顺序。其他声明机制不在保障范围内。
  4. 只递归处理标准的 group/config 条目树,不扫描任意插件自己的配置。
  5. 这是加载期策略,不承诺卸载或热重载时立刻改写已运行的预设修订。首次安装或卸载后建议完整重启 DSH,并检查新挂载的预设。

开发与验证

Node.js >= 22.16,使用 pnpm。插件自身没有运行时依赖,也无需编译;官方开发依赖固定到已验证的 DSH/Cordis 版本,锁文件保证安装可复现。

pnpm install --frozen-lockfile
pnpm run check
# 仅运行无需开发依赖的纯逻辑测试:
node --test test/policy.test.js

集成测试读取开发依赖内的真实官方预设,使用真实 Cordis Loader、AgentPreset、BasicCompactionEngine 和手动命令模块。验证:

  • 不启用策略时四个压缩后端均正常实例化并注册自动处理逻辑;
  • 策略导入故意延迟时,后端仍被禁用且没有实例,自动压缩注册方法不会被调用;
  • 真实预设就绪检查没有失败或等待服务的条目;
  • 新增官方字段、工具和原有预设禁用状态不会丢失;
  • 策略缺失时预设不会绕过门闩启动;
  • 移除策略后可恢复基线,配置持久化写入数为 0。

**测试边界:**预设注册服务、模型/会话/命令等宿主服务和无关插件使用替身;不发送模型请求,不实际压缩历史,也不是对运行中的真实 Web 会话作端到端验证。测试不读取或改写用户 profile。

当前验证目标:DSH 0.2.1-alpha.3、Cordis 4.0.5-alpha.2、Cordis Loader 1.0.6-alpha.2。

安装到 Web profile

dsh plugin --profile web add github:deshark42/dsh-compaction-basic-disable

安装会修改目标 profile,操作前请先备份。本插件 bundle 应位于官方 base/Web bundles 之后。插件没有构建步骤和运行时依赖,无需预先安装仓库的开发依赖。

这条命令从默认分支解析版本,profile 锁文件会记录对应的 Git 提交;不会随远端分支变化自动更新已安装的副本。需要固定版本时,可在 GitHub 地址后追加 #完整提交SHA。包中的 private: true 只防止误发布到 npm,不影响 GitHub 安装。

本地开发安装(可选)

只有需要修改插件源码时,才需要克隆并使用本地 link:

git clone https://github.com/deshark42/dsh-compaction-basic-disable.git
cd dsh-compaction-basic-disable
dsh plugin --profile web add "link:$PWD"

使用 link 安装后请保留此克隆目录;不要在仍启用插件时移动或删除它。

然后核对 profile 的依赖包含 @local/dsh-compaction-basic-disable,且 dsh.profile.bundles 中将它排在官方 bundles 后面。不要再手动复制整份预设,不要另加隐藏 /compact 的补丁。

完整重启 DSH 后,对新挂载预设检查 basic 后端条目为禁用且没有实例,同时确认其自动监听器未注册。仅看 /compact 消失或配置文件中的文字不够。此仓库测试通过也不等于当前运行会话已经禁用压缩。

卸载时移除本插件的 profile 依赖和 bundle 项,再重启;无需还原任何官方预设快照。若手动给自定义预设添加过门闩,也需一并移除。

仓库结构

许可证

MIT © 2026 deshark42。

About

Disable DSH basic compaction without copying official preset configurations.

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages