兼容性判决官 STRAYLIGHT66/dsh-plugin-compat-guard

dsh-plugin-compat-guard

最大的兼容性保护 · The Biggest Compatibility Protection

⚠️ 别把它装在你要干活的机器上。⚠️ 这是个整活插件，唯一的功能就是故意弄死 DeepSeek Harness。
见 LICENSE：附加条款第 1 条禁止用于生产环境，「破大防」概不负责。

泰拉瑞亚玩家都懂：装个灾厄，游戏就没了。

这个插件把那股劲儿搬到了 DeepSeek Harness。挂上它的 profile，就不再是允许第三方插件共存的 profile。
只认官方插件。 没有例外、没有商量、没有兼容层——兼容层就是判决本身。

它做什么

1. 挂载后等 Loader 把这轮启动的插件装完（最多 90 秒，通常一两秒）。
2. 把每一行插件判成「官方 / 第三方」。
3. 命中第一个第三方插件，就把判决书写进 stderr、落两份取证文件，然后 process.exit(1)。
4. 进程一死，Electron 壳检测到宿主断开，窗口随之消失。

整个插件就这些，没有第二个功能。

长什么样

DSH-PLUGIN-COMPAT-GUARD :: COMPATIBILITY VERDICT :: FATAL
time : 2026-10-11T00:58:12.401Z
profile : C:\Users\<你>\.dsh\profiles\desktop installation : ...\app.asar\dsh\node_modules\@deepseek-ai\dsh\package.json boot : idle pid : 24680 exit code : 1

官方插件 : 96 第三方插件 : 1

-- 判决名单 ---------------------------------------------------- [x] dsh-plugin-memory entry id : dsh-memory resolved : C:\Users\<你>\.dsh\profiles\desktop\node_modules\dsh-plugin-memory fiber : active enabled: true reason : resolved from the profile directory

-- 遗言 -------------------------------------------------------- 「我把所有的依赖都读了一遍，只有它们是我没写过的。」
「兼容性不是谈判，是判决。」
...

「第三方」怎么判

两条正面证据，都对齐 Plugin Manager 自己的口径：

1. 包解析后落在 profile 目录之内（解析顺序：安装锚点优先、profile 其次，与 @deepseek-ai/dsh-app-boot 完全一致）；或
2. 包名被写进了 profile package.json 的 dependencies。

两条都不成立 → 判官方。连 profile 目录都定位不到时，它放弃判决、不杀进程——宁可漏杀不误杀，这是整个插件里它比你谨慎的唯一一处。

它也永不判自己：守卫豁免于自己的守卫。

安装

走 Harness 界面：设置 → 插件 → 添加插件，填这个包目录。
或者在这个 profile 允许 CLI 管理时：

dsh plugin --profile <名字> add dsh-plugin-compat-guard

本地 checkout 也行——「添加插件」接受一个声明了 dsh.bundle 的包目录的绝对路径。

然后重启。那次重启就是演示本身。

卸载（GUI 已经进不去了怎么救）

装完之后 GUI 是打不开的——它在启动中途自己死。恢复只能在文件/命令行层面做，而它留下的取证文件里写着同样的步骤：

1) 若该 profile 归 CLI 管
dsh plugin --profile <名字> remove dsh-plugin-compat-guard

2) 手改 profile 清单：删掉依赖项，以及 dsh.profile.bundles 里的同名项 -> profiles/<名字>/package.json

3) 最粗暴：把包挪走，bundle 会因解析失败被跳过
mv ~/.dsh/profiles/<名字>/node_modules/dsh-plugin-compat-guard /tmp/

它留下的两份取证：

| 路径 | 内容 |
| <profile>/.plugin-manager/logs/compat-guard-<时间戳>.log | 完整判决报告 |
| <profile>/DONT_LOOK_HERE.txt | 同一份报告 + 十句遗言 |

配置

在 profile 的 cordis.patch.yml 里按行 id dsh-compat-guard 覆盖（覆盖是整份替换，想保留的字段要一起写上）：

- id: dsh-compat-guard
name: dsh-plugin-compat-guard
config:
enabled: false # true = 上膛（默认） dryRun: true # true = 只打印判决，不杀进程 exitCode: 1 # 随你发挥
ignore: [] # 赦免名单：包名 / entry id，例如 ['dshmarket']
writeForensics: true
lastWordsPath: null # profile 相对路径或绝对路径 trace: false # 往 stderr 打解析过程

dryRun: true 是安全体验的姿势——看得到全部机制，丢不掉会话。
enabled: false 则让它彻底安静。

自测（不会死任何东西）

node test/harness.mjs # 12 场景 41 断言，子进程里真跑真退出
node test/probe-real-profile.mjs # 只读地拿本机真实 profile 验证分类

harness.mjs 在子进程里真跑插件，所以「应该死」的场景是真死，父进程只收退出码和输出。
probe-real-profile.mjs 只复算分类并打印，一个进程都不会死。

为什么不就用个普通插件？

| | 普通插件 | 本插件 |
| 能装几个插件 | 想装多少装多少 | 只许官方 |
| 冲突时 | 打条警告 | 结束进程 |
| 兼容层 | 负责协商 | 就是判决 |
| 用户体验 | 正常 | 没了 |

兼容性边界

- 官方 = 从安装包来的，不是名字里带 @deepseek-ai/。 谁把一个带 scope 的包装进 profile，一样判第三方。
- 它依赖 Loader 内部结构（ctx.loader.entries()、getTasks()、Fiber.state === 2、 entry.options.name/id/group/disabled），在 DSH 11.7.0 的 @deepseek-ai/cordis-plugin-loader 上核对过。
将来的 Loader 可能让它静默失效——那时它就不杀人了。
- 它不 import 任何东西，配置校验自带（实现 ~standard.validate），所以不存在「守卫自己没装上」这种丢人死法。一个不可能加载失败的守卫，才是躲不掉的守卫。
- 它只判定 profile 层的 Loader 树。agent preset 组装出来的行在另一棵树上，不在范围内。

许可证

MIT，外加一段戏谑附加条款：禁止用于生产环境，且对无视本 README 第一行的人概不负责。
现在你已经被警告两次了。