dsh-plugin-diagnoselisted
Install: claude install-skill taxueseek/plugin-fast-adapt
# 环境与启动故障车道
症状是「插件明明装了却不起作用」或「宿主根本起不来」时走这里。代码本身踩没踩破坏性变更不走这条车道,那是 `../adapt/SKILL.md` 的事;先确认环境干净,适配结论才可信。以下命令都相对工具根目录执行,工具根即本文件真实路径往上两级、含 `scripts/` 的那一层。脚本用自身文件的绝对路径定位,不必先 cd,从任何目录直接 `node <工具根>/scripts/<脚本>.mjs` 同样可行。本目录常以软链别名加载,shell 的 `cd ../..` 会按软链走错地方,确实要 cd 时用 `cd "$(realpath <本文件所在目录>)/../.."`。
## 第一步:看宿主日志怎么说
```sh
node scripts/log-doctor.mjs [--logs <目录>] [--limit 5] [--pattern '^startup-']
```
宿主启动失败(`StartupError`、端口占用、未声明 inject、客户端入口死链)此前要人工逐个 grep `~/.dsh/logs/startup-*.log`,再从 300 多行的 JS 字面量里抠 `failedPlugins` 与 `waitingForServices`。本脚本把这条排障路径固化:解析每份 startup 日志的头部元信息与多行 error 块、消息数组(容忍宿主的 `[length]: N` 伪数组标记),抽取预置信号,汇总成按根因分组的诊断并给可执行动作。
输出:`runs`(每份日志的 meta、failedPlugins、waitingForServices、inactiveEntries、signals)、`crashReports`(桌面 APP 崩溃报告)、`signalSummary`(按出现次数排序的信号加动作)、`verdict`(`clean`/`warnings`/`host-failure`)。非 startup 日志(dsh-web、maintain、env-sweeper、web-restart)全文扫信号,并抽出 `inactiveEntries`:宿主「N entries did not activate」警告下的每一条,带条目 id、包名和错误原文。错误是「already owned by process」一类时另报 `resource-locked`,那是 web 与 APP 同时开在抢同一份资源,不是插件代码缺陷。
**桌面 APP 的日志不在 `~/.dsh/logs/`。** APP 主进程的 stdout/stderr 接 `/dev/null`,宿主 stderr 只在内存留 64KB,唯一落盘的是致命错误时写的崩溃报告 `~/Library/Logs/DeepSeek Harness/crash-<时间>-<host|web-boot|renderer|main>.log`(只留最近 10 份)。log-doctor 默认一并读取(`--crash-dir` 可改),解析出来源、阶段、宿主诊断里的失败插件,以及渲染进程的报错尾巴。客户端半卡 loading 的证据主要在渲染进程那一段。APP 没崩就不会有报告,也就没有要追溯的故障。
**边界**:日志是宿主写的 JS 字面量而非 JSON,只做行级启发式解析,解析不到的字段留 `null` 不猜;信号是文本命中,动作是「怎么确认、怎么修」的第一步,不替用户拍板。
日志说插件装载失败时,先用运行日