Harris-Logic/dsh-web-rescue

dsh-web-rescue

当 dsh web 被某个插件搞挂（webui 打不开、重启终端也没用）时，用一条命令装好
「webui-rescue」救援 skill + guardian 救援脚本，让存活的 agent 面（dsh-tui /
headless）按手册诊断并修复 web profile。

Rescue skill plugin for a broken DSH web UI: one-command install of the
webui-rescue skill plus the guardian recovery script, so a surviving agent
surface (dsh-tui / headless) can diagnose and repair the web profile.

为什么装在 dsh-tui 而不是 web

dsh web 一次性挂载整棵插件树，任一插件导入/激活失败都会让整个进程退出——
包括装在 web profile 里的救援 skill 自己。本插件因此设计为：

- 装进「幸存面」：主安装目标是独立的 dsh-tui profile（web 挂时它活着，
且不加载 web 的任何用户插件）；headless 可选。
- 惰性插件行：一行 row、零运行时依赖、只 inject: ["skills"]；即使它坏了，
dsh plugin --profile  remove dsh-web-rescue 一条命令摘除，且波及不到 web。
- 人读手册兜底：当 web 与 tui 两个面都挂（home 层 cordis.patch.yml /
settings.yaml 损坏）时没有任何 agent 能读 skill，只有人能读本 README 并直接跑
guardian——所以本仓库把三样东西放一起：SKILL.md（agent 用）、README（人用）、
guardian（工具用）。

安装

1) 主安装：备用面 dsh-tui（webui 挂掉时 skill 还能被读到）
dsh plugin --profile dsh-tui add github:Harris-Logic/dsh-web-rescue

2) 可选：headless 面也装上（一次性 CLI 也能执行救援）
dsh plugin --profile headless add github:Harris-Logic/dsh-web-rescue

3) 可选：web 面（web 健康时也能用，但 web 挂时读不到它——那正是备用面的用武之地）
dsh plugin --profile web add github:Harris-Logic/dsh-web-rescue

4) 安装随包附带的 guardian 救援脚本（skill 与 README 都会用到它）
curl -fsSL https://raw.githubusercontent.com/Harris-Logic/dsh-web-rescue/main/guardian/guardian \
-o ~/.local/bin/guardian && chmod +x ~/.local/bin/guardian

使用

在任意存活的 agent 面（推荐 dsh --profile dsh-tui）里直接说：

webui 挂了，帮我诊断并修复

agent 会加载 webui-rescue skill，按「组合期/挂载期」分级诊断：--dump-config
定位 → dsh plugin remove / disabled 禁用 → 有 guardian 则 guardian boot 自动
降级或 guardian rollback 回滚 → 验证后让你重启 dsh web。

纯手工兜底（没有 agent 可用时，人直接执行）：

dsh --profile web --dump-config                       # 组合期诊断
dsh --profile web --dump-default-config               # 跳过用户层
dsh plugin --profile web remove                # 摘除（永远可用）
或在 profiles/web/cordis.patch.yml 加：- { id: , disabled: true }
dsh web --patch ./recovery.yml                        # 临时禁用后启动

guardian 脚本

guardian/guardian 是零依赖 bash 工具箱：snapshot / rollback（装插件前快照、
出事后回滚）、install / remove（自动快照的插件管理）、boot（安全启动：组合
预检 → 禁用用户插件的 overlay 降级 → 自动回滚）、status。尊重 $DSH_HOME 与
--profile，状态目录 ~/.dsh-guardian/。

边界与信任

- 本插件（含 guardian）不修改 DSH 本体；只读/写 $DSH_HOME 下的配置文件与
~/.dsh-guardian/ 状态目录。
- 快照只含 package.json、cordis.patch.yml、pnpm-workspace.yaml、
settings.yaml 四个文本文件；不含凭据、会话、附件。
- 第三方插件以完整 harness 权限运行——本项目开源（MIT），仅一个惰性 skill
provider 行，建议只从本仓库正式版本安装。