manualcompact-billion

让 dsh 的原生手动压缩 /compact 回来，同时不动 billion-context 的自动压缩。

它解决什么

装了 billion-context 之后，dsh 里的 /compact 会消失。原因不是 bug：billion 带了一个 bili-compaction-gate 插件，它在配置解析阶段把两个包改成 disabled: true：

• @deepseek-ai/dsh-compaction-basic（压缩后端）
• @deepseek-ai/dsh-command-compact（/compact 命令）

于是 dsh 既没有自动压缩，也没有手动压缩——而 billion 自己的压缩方案在部分场景（非标准线路、拦截没生效）下并不工作，你就落到「两边都没有」的境地。

这个插件把这两条重新打开，并且把后端钉成 auto: false：只手动，不自动。billion 继续管它的自动压缩，两边互不抢。

原理

dsh 的配置解析是一条 waterfall（洋葱模型）：每个监听者调用 next() 拿到下游结果，还能再改。billion 的 gate 挂在链上做禁用。

本插件用 { global: true, prepend: true } 注册在最外层：

我们的钩子（最外层）
  └─ billion 的 gate（禁用两个包）
       └─ 基础配置（两个包原本是启用的）
  ← gate 返回「已禁用」
← 我们收到「已禁用」，改回「启用 + auto:false」

因为最外层的返回值才是最终结果，所以我们的修改生效，而 gate 自己完全不知道。

它只改三种值：两个 disabled: true → false，一个 config.auto = false。不碰 billion 的包、代理、gate，也不注册任何服务。

一个刻意的限制：只在被禁用时才动手

如果配置里没有任何被 gate 禁用的行（比如你哪天卸了 billion），插件直接原样返回，连 auto 都不碰。这样它不会在你卸掉 billion 之后，悄悄把你的自动压缩关掉。

安装

方式一：从 GitHub 一键安装（推荐）

dsh plugin --profile web add github:k-ying/manualcompact-billion

web 是 dsh 的默认 profile，绝大多数人用的就是它。dsh 会把 github:owner/repo 转成真实 Git 地址拉取安装，cordis.patch.yml 随包自动挂载，不用手改配置。

先确认你该装到哪个 profile

dsh 的插件按 profile 隔离，装错 profile 等于没装。三个办法确认：

# 1) 看这台机器上有哪些 profile
ls ~/.dsh/profiles

# 2) 看某个 profile 里已经装了什么
dsh plugin --profile web list

# 3) 看这个 profile 的插件配置文件在哪（装完就写在这里）
ls ~/.dsh/profiles/web/cordis.patch.yml

对照着选：

你的情况	profile 名	配置文件
命令行 dsh，或浏览器打开的 Web UI	web（默认）	~/.dsh/profiles/web/cordis.patch.yml
桌面版应用（Tauri 打包的那个）	一般是 tauri	~/.dsh/profiles/tauri/cordis.patch.yml
自己建过别的	你起的名字	~/.dsh/profiles/<名字>/cordis.patch.yml

不确定的话先跑 ls ~/.dsh/profiles：里面没有 tauri 目录，就说明你用的是 web。桌面版对应：

dsh plugin --profile tauri add github:k-ying/manualcompact-billion

想锁定版本可以带 tag：

dsh plugin --profile web add github:k-ying/manualcompact-billion#v0.1.0

方式二：本地目录安装

dsh plugin --profile web add ~/Documents/AI/manualcompact-billion

（把 web 换成你自己的 profile 名即可。）

方式三：手写 patch 条目

不想走插件管理器，也可以在 profile 的 cordis.patch.yml 里手写一条：

- id: manualcompact-billion
  name: 'file:///path/to/manualcompact-billion/index.js'

装完都要做的一步

完全退出 dsh 再打开（不是关窗口）。配置是启动时算出来的，热改不会重新走一遍 waterfall。

验证

重启后，随便开一个会话：

• 敲 /compact，应该能压（或回「没有可压缩的历史」——那也说明命令活着）。
• 失败的样子：命令面板里没有 /compact，或报「没有压缩后端」。

日志里搜 manualcompact-billion: 会看到一行自检：

manualcompact-billion: native compaction restored (command×1, basic×1, groups×2, auto=off)

没这行，说明插件没加载，或者配置里根本没有被禁用的行。

开关

环境变量	作用
MANUALCOMPACT_OFF=1	插件完全让位，什么都不改
MANUALCOMPACT_ALLOW_AUTO=1	不钉 auto: false，保留你原来的自动压缩设置（会和 billion 抢历史，不建议）

卸载

dsh plugin --profile tauri remove manualcompact-billion

重启即可。没有任何持久副作用：配置是每次启动时算出来的，插件不在就恢复原样。

风险与限制

• 它逆着上游的假设走。 billion 的设计是「我接管了就不许宿主压」，没有「接管失败时放行」这一档。本插件补的正是这个缺口，但上游不保证兼容。
• billion 真有压缩动作时，你手动 /compact 会让会话历史变化，billion 下一次请求发现增量对不上，会触发一次全量 resync：多一个冷请求、缓存命中掉一格。是费用和速度的损失，不是数据损坏。
• 它不解决「billion 能不能压某个供应商」的问题。Command Code 那类非标准线路该不压还是不压。
• 上游改包名或事件名时插件会静默失效（/compact 又消失），但不会弄坏 dsh。失效时把 BASIC_PACKAGE / COMMAND_PACKAGE 改一下即可。

开发

npm test

14 条用例，覆盖：配置转换、嵌套 group、幂等、不改原对象、以及用假 ctx 模拟 waterfall 验证「prepend 确实压在 gate 外层」。