插件兼容卫士 Starsky16/dsh-compat

dsh-compat

让 DeepSeek Harness（dsh）的插件在 Termux / Linux 上「装得上、崩了不连坐、坏了看得见」的兼容层。

插件加载失败时，dsh 默认会整页白屏（应用完全起不来）；移动端弹层还可能整体透明。dsh-compat 解决这两个问题，外加一个装插件前的体检工具。

它解决什么问题

| 你遇到的症状 | 对应组件 | 效果 |
| 装了个坏插件，dsh 整页白屏起不来 | L2 加载器隔离补丁 | 只有坏插件被停用并给出原因，其它插件和页面照常 |
| 弹出菜单/下拉是透明或半透明的，看不清 | L3 客户端垫片 | 弹层改回实色（自动适配深浅色） |
| 手机上 UI 动画卡顿 | L3 客户端垫片 | 触屏设备自动关闭高开销的模糊与动画 |
| 不知道一个插件能不能装 | L4 doctor 体检 | 装前检查平台声明与依赖，装不了会告诉你为什么 |

安装

环境要求：dsh（官方版或 termux-dsh）；Node ≥ 24.2。

三种方式任选其一（装完即生效，无需手工改配置）：

① 一行命令直装（推荐，自动跟随 GitHub 仓库）
dsh plugin --profile <你的profile名> add https://github.com/Starsky16/dsh-compat.git

② 锁定版本：从 https://github.com/Starsky16/dsh-compat/releases 下载 .tgz 后
dsh plugin --profile <你的profile名> add ./dsh-compat-0.1.1.tgz

③ 本地开发：clone 后指向目录
git clone https://github.com/Starsky16/dsh-compat.git
dsh plugin --profile <你的profile名> add ./dsh-compat

体检工具（doctor）单独用，不用装进 profile：

git clone https://github.com/Starsky16/dsh-compat.git
node dsh-compat/bin/doctor.mjs # 逐个报告 profile 里插件的体检结果

各平台支持情况

| 平台 | 隔离补丁（L2） | 垫片（L3） | 体检（L4） |
| Termux（termux-dsh） | ✅ 全部 | ✅ | ✅ |
| Linux / macOS 桌面 | 自动探测，没找到相关组件就静默跳过 | ✅ | ✅ |
| Windows 桌面 | ❌ 不支持（官方 dsh 的核心文件打包在 app.asar 内，不可修改） | ✅ | ✅ |

装完重启 dsh 即生效。之后升级 dsh 后如果看到「L2 补丁未就绪」的提示，按提示重跑一次补丁命令即可（见进阶说明）。

常见问题

装完没有效果？ 重启 dsh（插件在启动时注入）。Termux 用户确认用的是 termux-dsh 的 dsh。

「L2 补丁未就绪」警告是什么？ 你刚升级过 dsh，隔离补丁被覆盖了。警告不影响启动，按提示重打即可恢复隔离能力。

想关掉某个功能？ 环境变量 DSH_COMPAT_DISABLE_L2_SELFCHECK=1 关闭补丁自检；L3 的弹层修复与性能开关随插件启停，卸载插件即全部还原（补丁用 bin/patch.mjs --revert 撤销）。

插件本身有 bug？ 本仓只管「装得上、崩了不连坐」，不修插件业务逻辑——那要找插件作者。

更多文档：

- CONTRIBUTING.md —— 补丁机制原理、doctor 判据、环境变量开关、仓库结构、参与开发
- docs/compat.md —— 各环境兼容性覆盖矩阵（已验证 / 未验证 / 不支持）
- docs/spike-loader-isolation.md —— 加载器机制勘察报告

AI 辅助声明

本仓库的代码与文档在 AI 辅助下编写，经人工审阅与测试。

License

MIT，见 LICENSE。上游与第三方归属见 NOTICE。