dsh-plugin-manager
DSH 网页插件管理：在 Web 设置页直接启用/停用已安装插件。npm 包名 @wsgsety/dsh-plugin-manager，运行时条目 id dsh-plugin-manager。
- 设置 → 插件 → 插件管理：搜索、按官方/第三方筛选，每个插件一行开关。切换立即生效（Cordis loader 热更新）并写入用户 patch 层（
~/.dsh/profiles/<profile>/cordis.patch.yml），重启后保持。
- 插件卡片带运行状态点（运行中/已停用/挂载失败…）、「官方」徽标（
@deepseek-ai/*）与「受保护」标记。
- 完全自研，不依赖 dshmarket。
安装
# npm registry（推荐）
dsh plugin --profile web add @wsgsety/dsh-plugin-manager
# 或从 GitHub 安装（pin 到具体 commit，保证可复现）
dsh plugin --profile web add github:WSGsety/dsh-plugin-manager#9cbbcdd59fdce3dd96879924b485ea3e8053d3c2
# 重启 dsh web（命令行或 DeepSeek Harness 桌面应用）后生效
- 运行时 loader 条目 id 带组前缀（
include:ssh），patch 层写入时自动去掉前缀（ssh），与 bundle 层 id 对齐。
- 桌面应用（deepseek-harness-desktop）用 app 内置 dsh 启动 web profile、随机端口，profile 仍是
~/.dsh/profiles/web；改动后重启应用即可。
Host 路由
| 路由 | 方法 | 说明 |
|---|
/dsh-plugin-manager/entries | GET | loader 条目投影 + patch 停用列表 |
/dsh-plugin-manager/set-enabled | POST | 实时启停 + 写 patch 持久化（可信请求栅栏） |
/dsh-plugin-manager/ping | GET | 健康检查 |
安全
- 所有路由走官方
dsh-client-connection 同款可信请求栅栏：Host 必须是回环权威（localhost / 127.0.0.0/8 / [::1]，DNS 重绑定无法伪造）、Sec-Fetch-Site: cross-site 拒绝、携带的 Origin 必须与 Host 完全一致。写接口（/set-enabled）额外要求 TCP 对端可见时为回环地址，把配置平面限制在回环（与官方 WebServer 配置平面语义一致）。
- 写请求体积受限（16 KiB）JSON body，entry id 经白名单校验，杜绝 YAML 注入。
- 保护列表（
lib/entries.js）禁止停用 web 外壳、插件自身与承载页面的核心条目：webserver、web-runtime、modules、connection、client-runtime、locale、ui-layout、ui-sidebar、ui-settings、ui-settings-plugins（本插件页面所在 slot 的所有者，防止 UI 自锁）、settings、typert*、api-remotes、dsh-plugin-manager。
设计要点
- patch 层语义对齐 DSH 层叠规则（Bundle → Profile Patch → Home Patch →
--patch，后层覆盖前层）：每次启停都写入显式 disabled: true|false，绝不删除字段——官方 bundle 自带 disabled: true 的条目（如 skill-badge）只有靠用户层显式 false 才能覆盖，删除字段会在重启后重新停用。启用已在运行中的条目不写 patch（无需覆盖）。
- patch 文件用
yaml 包做保注释无损往返（用户手写注释、!!js 表达式原样保留），写入为 tmp+rename 原子替换并继承原文件权限位（新文件默认 0600）；解析失败时拒绝写入并报错。
- 实时启停通过
loader 条目 entry.update({disabled}) 热更——启用传显式 false（传 null 会删除字段、让底层 bundle 的 true 重新生效），fiber 状态带回执校验重试（与 dshmarket 皮肤切换同机制）。
- profile 定位同时识别
--profile <name> 与 --profile=<name>；CLI 带 --profile 但无法解析时拒绝挂载，绝不猜测默认写错 profile。
开发
node scripts/gates/run.mjs # 门禁全量：语法 + manifest 契约 + 测试 + 非法样例自检
node scripts/gates/run.mjs --syntax # 只查语法（最窄证据）
node scripts/gates/run.mjs --manifest # 只查 package.json 契约
node scripts/gates/run.mjs --tests # 只跑测试
node scripts/gates/run.mjs --self-test # 只跑自检（证明门禁会拒绝坏包）
node test/patch.test.mjs # patch 读写（显式布尔 + 权限保留）
node test/routes.test.mjs # 路由（mock webServer/loader，含安全负向用例）
node test/util.test.mjs # profile 解析 + 可信请求栅栏
node test/client.test.mjs # client bundle 冒烟
# 或 npm test
非平凡改动的取舍记录在 decisions/implemented/（problem → decision →
alternatives → consequences）。
发布
npm login # npm 账号（发布需 2FA / bypass-2FA token）
npm publish # prepublishOnly 门禁自动把关，发布到官方源
