dsh-repair
一个 DSH 插件，内容只有一份技能：安装时把包内的 skills/ 注册为一个技能根，于是这份技能随插件进入 agent 的技能目录。
dsh plugin --profile web add dsh-repair
技能覆盖什么
- 起不来怎么查：boot 崩在 readiness 之前（
ERR_MODULE_NOT_FOUND、cannot resolve profile bundle）、插件 node_modules 里 junction/symlink 穿透损坏、树外插件的依赖桥悬空
- 活着但残废：服务静默失效（模型页缺提供方、按钮死）、配置能解析但
apply 抛异常、适配器静默丢弃它目录里没有的模型 id、日志干净却功能死了
- 依赖桥：树外插件（
link:）拿不到宿主核心包时的桥机制，以及 bridge-doctor.js / bridge-rebuild.js 的体检与重建
- 升级 DSH：升级前停实例、备份、隔离预演；升级后的三层验证与
settings.yaml 复查
- Windows 远程作业：跨机经 SSH 收拾 Windows 上的 DSH 时的一整份坑清单（进程生命周期、引号转义、PowerShell、pnpm junction、路径漂移）
scripts/ 里六个脚本随技能一起发：bridge-doctor.js（只读体检）、bridge-rebuild.js（重建，dry-run 优先）、bridge-lib.js（共用探测逻辑）、dep-diff.js（两棵 node_modules 版本表 diff）、inspect-session.js（从会话文件取运行时证据）、link-doctor.js（审计/修复 symlink 与 junction）。路径一律从 --home 或 $DSH_HOME 解析，没有写死任何一台机器。
布局
package.json # dsh.bundle.patch → cordis.patch.yml
cordis.patch.yml # 插入一行 @deepseek-ai/dsh-skill-filesystem，customSkillDirs 指向 skills/
skills/
dsh-repair/
SKILL.md
references/
templates.md
windows-pitfalls.md
scripts/
package.json # {"type":"commonjs"} —— 本包是 ESM 包，这六个脚本是 CommonJS
bridge-doctor.js
bridge-lib.js
bridge-rebuild.js
dep-diff.js
inspect-session.js
link-doctor.js
cordis.patch.yml 用的机制和 DSH 自带 agent preset 装载自己的技能是同一套：!!js 里的 baseUrl 解析到本包，所以路径跟着安装位置走。
License
MIT
