前言¶
DeepSeek Harness (DSH) 的核心设计是“一切皆插件”。随着项目规模扩大，环境依赖复杂化、版本混乱以及安装前的静态检查缺失，往往会导致环境故障。官方插件管理器处理了基础的组合包与配置页托管，但在安装前质量门、深度环境诊断以及插件市场等环节存在缺口。
dsh-plugin-manager-companion 作为官方插件管理器的补充工具，旨在填补这些缺口，提供安装前的质量门控、五层环境诊断、插件市场与技能预设管理，以及安全可靠的升级流程。
插件简介¶
- 名称：
dsh-plugin-manager-companion - 维护者：LX2000WASD
- 核心价值：安装前质量门、环境诊断、插件市场与技能预设、升级
- 定位：官方插件管理器的补充工具，通过官方通道执行写操作，不直接调用 pnpm 或修改
cordis.patch.yml。
核心能力¶
安装前质量门¶
在官方 installBundle 流程中增加静态检查步骤：
1. 扫描候选包的 spec，确认指向。
2. 官方执行安装但不激活（enabled: false）。
3. 检测未声明的 import、声明了但未安装、把官方包声明为普通 dependencies 导致重复副本、入口解析失败等问题。
4. 合格则激活，不合格则回滚。
试装默认关闭。开启后，候选包会先装进 <环境名>-dpmc 测试环境并启动，通过后才装进真实环境。测试环境默认保留 14 天。
环境控制台¶
通过设置页入口提供三个子页：
- 体检：五层诊断（L1 依赖、L2 组合、L3 运行时、L4 一致性、L5 生态）。L5 生态层不联网、不判定，显示“未查”。每条发现带证据与处置建议。
- 环境：管理本机所有 profile（启动、停止、重命名、删除、跨环境复制、备份导出）。
- 设置：本插件自身的配置。
插件市场与技能预设¶
- 展示社区索引，支持按名称、仓库、主题与描述搜索，按星数、更新时间排序。
- 卡片标出风险等级与可装性。
- 详情展示校验结论与风险明细。
- 管理 SKILL.md 与 agent 预设，支持查看安装记录与重新拉取。
升级¶
- 在“关于”页查看官方运行时、实验包与本插件版本状态。
- 支持手动或按需检查更新。
- 升级前在测试环境验证，未通过验证的版本不会进入真实环境。
安装与启用¶
该插件要求 DSH 版本大于等于 0.1.6-alpha.2。
安装命令如下：
dsh plugin --profile <name> add dsh-plugin-manager-companion@latest
安装完成后，需在插件管理页启用该插件，并重启对应的 profile。
命令行操作¶
插件提供命令行工具 dshpmc，用于脚本、CI 流水线或界面不可用时执行操作。
- 五层体检：
dshpmc analyze --profile <name>
对环境进行全量体检，发现问题时退出码为 1。
- 列出组件：
dshpmc list --profile <name>
显示组合包、依赖、已安装的技能与预设。
- 常用操作：
dshpmc install | remove | update | mount | uninstall-kind
注意事项¶
- 权限与安全：插件以当前 DSH 进程的权限运行。安装前请务必检查源码与许可证，避免在不受信的环境下执行安装。
- 已知限制：
- 质量门回滚可能失败（例如官方拒绝移除被保护的组合包），需手工处理残留。
- 安装守卫仅拦截 agent 的工具调用，无法拦截终端中手动敲击的命令。
- 环境变量敏感键过滤按形态匹配，并非全集，敏感键仍可能传给子进程。
- L5 生态层不联网、不判定。
- L3 层的注册名冲突只覆盖 profile 本地包，不扫描官方 scope。
- 端口只在实例命令行带
--port时可知，默认端口显示“未知”。
总结¶
dsh-plugin-manager-companion 通过质量门与五层诊断，降低了 DSH 环境维护的故障率；通过插件市场与升级机制，规范了插件的获取与更新流程。适合需要严格环境管理或构建自动化 CI 流程的开发者使用。
