DSH-X 环境自检

这个 skill 解决一个问题：DSH-X 出状况时，AI 往往先猜着改文件，而启动器自己的状态（管理页、数据目录、profile、实例、日志）散在四五个地方。这个脚本把它们收成一份只读诊断报告，让后续动作有依据。

它只读：不写设置、不改补丁层、不启停 dsh、不装插件。要修，等报告出来、和用户确认后再动手。

什么时候用

• 用户说「DSH 起不来 / 管理页打不开 / 启动就退 / 端口被占用」
• 用户说「插件没生效 / 技能不加载 / 页面功能少了」
• 用户让你先看看环境，或贴了一段看不懂的日志
• 你准备改 DSH-X 相关配置，动手前想确认当前事实（版本目录、DSH_HOME、profile、运行实例）

怎么跑

脚本在本文件同目录的 scripts/selfcheck.mjs，只用 Node 内置模块，无需安装依赖。先确定 skill 目录，然后：

node <skill目录>/scripts/selfcheck.mjs

它在 1 秒内跑完，默认输出中文人读报告。常用参数：

退出码：

先看 FAIL，再看 WARN，最后翻 --verbose 的细节。多数检查带分区名、证据（|）和处置建议（→）；正常项通常只有标题。

JSON 怎么读

--json 输出：

{
  tool: "dsh-x-selfcheck", schema: 1, version, at, elapsedMs, platform,
  target: { managerUrl, managerVersion, managerFound, installDir, dataDir,
            dataDirSource, dshHome, dshHomeSource, profile, logsSource },
  checks: [{ id, section, status, title, detail, evidence, hint }],
  summary: { ok, info, warn, fail, verdict, exitCode }
}

status 是 ok|info|warn|fail；target 是这次自检认定的环境事实——写修复建议时以它为准，不要另猜 dataDir/dshHome。JSON 里进报告的文本会过一遍脱敏（常见 token / 密钥 / Authorization / Cookie 形态，凭据只报存在、不读内容），但它不是发布级审查：贴整段日志到公开渠道前先自己扫一眼。

九类检查与常见处置

• 环境：平台/Node 版本、%APPDATA%\DSH（macOS 为 ~/Library/Application Support/DSH）里的 settings.json 是否合法、安装目录有没有自带 node/ 运行时。Node < 22.18 会提示。
• 管理页：端口上有没有 DSH-X 管理页（靠 /api/ping 的 {app:'dsh-x'} 辨认）、是否在安装/操作中、有没有自更新、钉住的实例端口是否互相冲突。端口被别的程序占了会直接报冲突者。
• 版本与数据：dataDir 可读可写、剩余磁盘、versions/<版本> 是否完整（managed 版本要有 node_modules/@deepseek-ai/dsh/lib/bin.js）、config.json 记录的版本与磁盘差异。系统全局装的 dsh 不算 managed，属正常。
• DSH_HOME / profile：~/.dsh（或设置的 dshHome）可写性、profiles/ 列表、所选 profile 的 package.json/node_modules、cordis.patch.yml 是否仍是顶层条目列表、disabled: true 行数、lock 文件属主是否还活着、补丁备份。.credentials.yaml 只报存在。
• 实例：运行中的「版本 × profile」、上次启动失败记录（failure.tail 是服务端脱敏后的报错尾部，脚本进报告前再截断/脱敏）、autoFix（启动器自动禁用过哪些插件）、页面自检 health。
• 插件：已装插件缺版本（node_modules 里没有）、被禁用、补丁层里的遗留 disable 行、autoFix、恢复档备份。
• 技能：frontmatter 坏掉、同名技能跨根遮蔽、本自检技能有没有注册、本地技能发现是否被关、技能根里的空目录与断链。
• 网络与同步：代理模式与下载源组合、云同步缺哪些项（只报缺项名，不报密钥）、--net 时的外网连通性。
• 日志：最后 3000 行按 10 类模式聚合（启动失败、插件 import 失败、插件版本不兼容、找不到模块/junction 异常、页面自检失败、自动禁用、安全启动、端口占用、子进程非零退出、依赖修复）。只有当前有实例在跑时，超过 3 天的旧警告才会降级为「历史事件」；没有实例在跑时旧警告照样会报。

典型对应关系：

边界

• 未指定 --port 时，管理页没在跑仍可检查本地文件（settings、版本目录、profile、manager.log），实时状态未知。指定 --port 后只使用该目标提供的来源证据，不回退当前终端的配置、日志、用户目录或技能目录；缺证报告未核实。目标 /api/settings 返回的是有效设置，原始设置文件的位置及语法未验证。
• 日志默认走管理页 /api/logs/export（服务端已脱敏）；仅未指定 --port 时，接口不可用才回退本地 manager.log.1 + manager.log。显式目标不可达或日志接口失败则报告缺少目标日志；进报告前脚本会再脱敏一遍。
• 不替代启动器自带的自检：页面自检、/api/proxy/test、启动自愈、恢复档各司其职，这个脚本只汇总事实。
• 不要为了自检去重启 dsh 或改 profile；报告只提示「哪里可能有问题」，改动前先征得用户同意。

安装/升级

• 管理页 → 技能 → 从 GitHub 导入，填仓库里的 skills/dsh-x-selfcheck 目录（tree URL），或
• 直接放进 ~/.dsh/skills/dsh-x-selfcheck/（Windows 可用 junction 链到仓库，改动即生效）。
• 升级就是替换这一个目录；脚本无依赖、无构建步骤。