dsh-plugin-manager-companion
官方 DSH 插件管理器的配套工具：安装前质量检查、深度环境诊断、插件市场，以及技能/预设管理。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-plugin-manager-companion@0.1.4Plugin Manager Companion 以 dsh-plugin-manager-companion 发布，当前版本为 0.1.4。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
DSH 官方插件管理器的补充：安装前质量门、五层环境诊断、多环境管理与插件市场。
前身是 dsh-web-plugin-manager（0.6.3，已停止维护）。 DSH 0.1.6-alpha.2 起官方自带插件管理页，旧仓库遮蔽官方页面并自建写权的做法不再适用，本仓库为重写。
| 环境控制台 · 体检 五层诊断：分组折叠，每条带严重度与证据；未查到的层显示「未查」 | 环境控制台 · 环境 多环境启停、复制与备份恢复 |
| 插件市场 卡片标出风险、分类与主题；详情展示索引原文 | 官方插件页 注册进官方插件页，点开自己的条目就是配置表单 |
官方插件管理器的 README 列明了自己不做的事。本插件只补这些缺口。
| 能力 | 官方 | 本插件 |
|---|---|---|
| 组合包与插件行的启停 | 已有 | 不做 |
| 组合包安装与卸载 | 已有 | 不做（安装前插质量门） |
| 插件配置页托管 | 提供插槽 | 作为注册方接入 |
| 安装前静态检查 | 无 | 质量门 |
| 环境诊断 | 无 | 环境控制台 · 体检 |
| 修改另一个 profile | 明确不做 | 环境控制台 · 环境 |
| 普通插件模块的加载 | 声明为文件操作 | 技能与预设安装 |
| 版本列表与更新检测 | 明确不做 | 插件市场 |
写操作一律走官方通道：当前环境用官方 pluginManager 服务，跨环境用官方 runPluginCommand。
本插件不写 cordis.patch.yml，不直接调用 pnpm。
官方四处「明确不做」的原文引用、对应的本插件功能，以及官方补上后的退出方式，见 docs/OFFICIAL-DEPENDENCIES.md §1-F。
dsh plugin --profile <name> add dsh-plugin-manager-companion@latest
要求 DSH >= 0.1.6-alpha.2。装好后在插件管理页启用，重启该 profile。
接在官方 installBundle 的「装但不激活」开关上：
inspect(spec)：官方确认这个 spec 指向什么；installBundle(spec, { enabled: false })：官方装进环境，不激活；dependencies（会在 profile 里装出第二份副本，让官方 loader 行解析到它）、入口解析不到；removeBundle 回滚，合格则 setBundleEnabled 激活。试装默认关闭。开启后，候选包会先装进 <环境名>-dpmc 测试环境并启动一次，通过后才装进真实环境。测试环境不设数量上限，默认保留 14 天。试装会在本机真实安装候选包并执行它自带的安装脚本。
一个设置页入口，三个子页：
市场页展示社区索引，支持按名称、仓库、主题与描述搜索，按星数、更新时间与近期热度排序。卡片标出风险等级与可装性（社区精选、需手动安装、非插件条目）。安装走质量门与官方通道。详情展示索引中的校验结论与风险明细，并给出原始报告链接。
技能与预设页管理通过本插件安装的 SKILL.md 与 agent 预设，可查看安装记录、重新拉取与卸载。
设置页「关于」列出官方运行时、官方实验包与本插件自身的版本状态。检查更新按需触发，也可手动检查；版本选择列出全部 dist-tags，默认选中与当前同线的最新版本。升级走官方通道，并在测试环境中先验证一遍；未通过验证的版本不会装进真实环境。新版本在下次启动时加载。
dshpmc 提供与界面等价的能力，用于脚本与 CI、终端操作，以及界面打不开时的备用入口。
dshpmc analyze --profile <name> # 五层体检；有问题退出码 1
dshpmc list --profile <name> # 组合层、依赖、本插件装过的技能与预设
dshpmc install | remove | update | mount | uninstall-kind
update <name> 把依赖声明重写为 @latest 后重装。不带版本号的 dsh plugin add 不会升级已声明的范围，pnpm update 也只在已声明范围内重解析，跨版本升级必须重写声明。整个升级过程与界面操作走同一条链路。
analyze 不依赖运行中的实例，只读磁盘，配置文件写坏或启动失败的环境同样能给出根因与文件行号。关键层未查完时，它说明结论不完整，不报健康。
宿主进程内的 agent 不能通过命令行做插件写操作：守卫拒绝裸的 dsh plugin 与 pnpm 变更命令，并指向官方 plugin_manager 工具。dshpmc 走与官方工具相同的 pnpm 通道，不在拦截范围内。
全部检查在 Linux 上运行。
Linux：已实机验证，含单元测试与两条端到端检查。
Windows x64：宿主官方支持 Windows。与平台相关的安全修复（内置环境名大小写、进程树终止、带引号命令行识别、.cmd 入口、终端降级、跨平台测试入口）已在真实 win32 Node 上逐条独立复验。以下各项未在真机验证或已知不成立：
wt）；没有 wt 的机器降级为后台启动，结果中写明原因。taskkill /T /F 强制结束进程树，不是优雅停止；被强制结束的实例不执行退出清理。pnpm test。macOS：未验证。文件系统默认大小写不敏感；与 Windows 同类的大小写检查已覆盖。
cordis.patch.yml 结构的修复（删除重复行、删除孤儿行）只给出步骤，由用户手工完成。本插件不写这个文件。--port 时可知；以默认端口启动的宿主显示「端口未知」。开发环境、检查项、代码结构与提交前清单见 docs/DEVELOPMENT.md。 设计见 docs/DESIGN.md，工程纪律见 docs/CODE-POLICY.md， 宿主与客户端契约见 docs/REST-CONTRACT.md，依赖的官方事实见 docs/OFFICIAL-DEPENDENCIES.md。
MIT