chore(release): v1.7.2 —— Cline / Kilo Code 适配 + 检测落空建议 + marketplace 文档

版本号：7 份声明文件全部 1.7.1 -> 1.7.2（按 .version-bump.json 逐一核对一致）。注：本机没装 jq，scripts/bump-version.sh 跑不了，改用等价的逐字面量替换，只动 "version" 那一行，未重排任何 JSON（已 diff 确认）。新增 scripts/verify-release.sh —— 发版前深度验证，82 项断言。补 audit.sh 的盲区：audit 只看 installer 退出码，装完有没有东西落盘、卸载有没有留垃圾它都不查。本脚本断言实际结果： A. 22 款工具：装 -> 断言 20 个 skill 落盘 -> 二次装幂等 -> 卸载零残留 + 无嵌套 B. 19 个检测标记逐一验证只触发预期工具（防新增工具误触发既有工具） C. --global 7 款成功 / 14 款明确拒绝且退出码 1 D. --global 拒绝信息引用的 8 份 docs 真实存在（防死链） E. rules 型工具索引断言：表 20 行、无空 description、Cline 无 frontmatter F. PATH 探测在 PATH 为空 / 畸形 / 未定义三种退化情形下的健壮性文档 - RELEASE-NOTES.zh.md 加 v1.7.2 条目，含设计取舍与完整验证清单 - 简繁 README 更新亮点：v1.7.0 -> v1.7.2（1.7.1 时漏更新，一并修正） - marketplace 示例里的 "Version: 1.7.1" 改为「<当前版本>」—— 写死版本号每次发版都会过期发版前验证结果 - scripts/audit.sh: 130 pass / 0 fail（2 warn 为既有上游漂移，见 #19） - scripts/verify-release.sh: 82 pass / 0 fail - npm 包端到端：npm pack -> 包内 version 1.7.2 -> 从 tarball 安装 -> 用打包后的二进制真实跑 Kilo Code 自动检测 -> 20 skills + 索引生成 -> 卸载零残留 - engines >=20 与实际语法一致（仅用到 padEnd/ES2017，无 ?? 与 ?.） - 包体 444K / 106 文件，docs/README.cline.md 与 README.kilocode.md 均已入包
2026-09-02 22:54:06 +08:00 · 2026-08-07 20:00:51 +08:00
parent 6cb1cd89bc
commit da6c6b082d
11 changed files with 224 additions and 17 deletions
--- a/.claude-plugin/marketplace.json
+++ b/.claude-plugin/marketplace.json
@@ -9,7 +9,7 @@
    {
      "name": "superpowers-zh",
      "description": "AI 编程超能力中文增强版：20 个 skills（14 翻译 + 4 中国原创 + 2 上游历史保留），支持 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 22 款工具",
-      "version": "1.7.1",
+      "version": "1.7.2",
      "source": "./",
      "author": {
        "name": "jnMetaCode",
--- a/.claude-plugin/plugin.json
+++ b/.claude-plugin/plugin.json
@@ -1,7 +1,7 @@
 {
  "name": "superpowers-zh",
  "description": "AI 编程超能力中文增强版：20 个 skills（14 翻译 + 4 中国原创 + 2 上游历史保留），支持 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 22 款工具",
-  "version": "1.7.1",
+  "version": "1.7.2",
  "author": {
    "name": "jnMetaCode",
    "url": "https://github.com/jnMetaCode"
--- a/.codex-plugin/plugin.json
+++ b/.codex-plugin/plugin.json
@@ -1,6 +1,6 @@
 {
  "name": "superpowers-zh",
-  "version": "1.7.1",
+  "version": "1.7.2",
  "description": "AI 编程超能力中文增强版：头脑风暴、subagent 驱动开发、规划、TDD、调试、代码审查、收尾工作流，附 4 个中文 skills 沉淀。",
  "author": {
    "name": "jnMetaCode",
--- a/.cursor-plugin/plugin.json
+++ b/.cursor-plugin/plugin.json
@@ -2,7 +2,7 @@
  "name": "superpowers-zh",
  "displayName": "Superpowers 中文版",
  "description": "AI 编程超能力中文增强版：20 个 skills（14 翻译 + 4 中国原创 + 2 上游历史保留），支持 Cursor / Claude Code / Hermes Agent / Claw Code / Qoder 等 22 款工具",
-  "version": "1.7.1",
+  "version": "1.7.2",
  "author": {
    "name": "jnMetaCode",
    "url": "https://github.com/jnMetaCode"
--- a/.kimi-plugin/plugin.json
+++ b/.kimi-plugin/plugin.json
@@ -1,6 +1,6 @@
 {
  "name": "superpowers-zh",
-  "version": "1.7.1",
+  "version": "1.7.2",
  "description": "AI 编程超能力中文增强版：头脑风暴、subagent 驱动开发、规划、TDD、调试、代码审查、收尾工作流，附 4 个中文 skills 沉淀。",
  "author": {
    "name": "jnMetaCode",
--- a/README.md
+++ b/README.md
@@ -16,10 +16,10 @@ Chinese community edition of [superpowers](https://github.com/obra/superpowers)
 >
 > 🌍 Also available in [English](https://aiolaola.com/en?utm_source=github&utm_campaign=superpowers) · [日本語](https://aiolaola.com/ja?utm_source=github&utm_campaign=superpowers) · [Español](https://aiolaola.com/es?utm_source=github&utm_campaign=superpowers) · [한국어](https://aiolaola.com/ko?utm_source=github&utm_campaign=superpowers) · [繁體中文](https://aiolaola.com/zh-Hant?utm_source=github&utm_campaign=superpowers)

-> 🆕 **v1.7.0 更新亮点**（[完整 Release Notes →](RELEASE-NOTES.zh.md)）
-> - 🌍 **全局安装** `npx superpowers-zh --global` —— 一次安装、所有项目共享，多项目党告别逐个重装
-> - 🧩 新增 **腾讯 CodeBuddy** 与 **华为云码道 CodeArts** 两款国产 IDE（工具数 18 → 20）
-> - 🌐 官网 [sp.aiolaola.com](https://sp.aiolaola.com) + README 新增**繁体中文**（简 / 繁 / EN 三语）
+> 🆕 **v1.7.2 更新亮点**（[完整 Release Notes →](RELEASE-NOTES.zh.md)）
+> - 🧩 新增 **Cline** 与 **Kilo Code** 两款 VS Code 扩展（工具数 20 → 22）—— 按 rules 常驻开销做了专门设计，索引仅 4.5 KB
+> - 🔧 检测落空时会扫 PATH 给出**可直接复制的 `--tool` 命令**，不再只报「未检测到」
+> - 📦 README 补上 **Plugin Marketplace 安装方式**（`claude plugin marketplace add`，升级只需一条命令）

 ### 📊 项目规模

@@ -227,7 +227,7 @@ claude plugin install superpowers-zh@superpowers-zh

 ```
  ❯ superpowers-zh@superpowers-zh
-    Version: 1.7.1
+    Version: <当前版本>
    Scope: user
    Status: ✔ enabled
 ```
--- a/README.zh-Hant.md
+++ b/README.zh-Hant.md
@@ -16,10 +16,10 @@ Chinese community edition of [superpowers](https://github.com/obra/superpowers)

 > 📖 **免費配套學習** → [從零學會 AI 編程](https://aiolaola.com/?utm_source=github&utm_campaign=superpowers)：180 節免費實操課 + 《AI 編程實戰三卷書》線上閱讀 + 實戰社群 · superpowers 裝好後配上方法論效率翻倍 · 永久免費

-> 🆕 **v1.7.0 更新亮點**（[完整 Release Notes →](RELEASE-NOTES.zh.md)）
-> - 🌍 **全域安裝** `npx superpowers-zh --global` —— 一次安裝、所有專案共享，多專案使用者告別逐個重裝
-> - 🧩 新增 **騰訊 CodeBuddy** 與 **華為雲碼道 CodeArts** 兩款國產 IDE（工具數 18 → 20）
-> - 🌐 官網 [sp.aiolaola.com](https://sp.aiolaola.com) + README 新增**繁體中文**（簡 / 繁 / EN 三語）
+> 🆕 **v1.7.2 更新亮點**（[完整 Release Notes →](RELEASE-NOTES.zh.md)）
+> - 🧩 新增 **Cline** 與 **Kilo Code** 兩款 VS Code 外掛（工具數 20 → 22）—— 針對 rules 常駐開銷做了專門設計，索引僅 4.5 KB
+> - 🔧 偵測落空時會掃 PATH 給出**可直接複製的 `--tool` 命令**，不再只報「未偵測到」
+> - 📦 README 補上 **Plugin Marketplace 安裝方式**（`claude plugin marketplace add`，升級只需一條命令）

 ### 📊 專案規模

@@ -227,7 +227,7 @@ claude plugin install superpowers-zh@superpowers-zh

 ```
  ❯ superpowers-zh@superpowers-zh
-    Version: 1.7.1
+    Version: <当前版本>
    Scope: user
    Status: ✔ enabled
 ```
--- a/RELEASE-NOTES.zh.md
+++ b/RELEASE-NOTES.zh.md
@@ -6,6 +6,49 @@

 ---

+## v1.7.2 (2026-08-07)
+
+### 🆕 新增 Cline 与 Kilo Code 适配（工具数 20 → 22，关 #112、#88）
+
+两款都是 VS Code 扩展，加载的是 **rules 而非懒加载的 skills** —— rules 会并入**每一轮** system prompt。照搬「把 20 个 SKILL.md 复制进规则目录」会让每轮对话背着 **182 KB** 常驻开销（Cline 官方也提示规则超约 300 行后遵守度下降）。
+
+改用仓库既有的 **Trae 模式**：规则目录只放一份索引（核心规则 + 20 个 skill 的名称/触发条件表，实测 **4.5 KB**，比全量塞入小 40 倍），skills 本体放各自 `skills/` 目录由 agent 按需读取。
+
+- **Cline**：skills → `.cline/skills/`，索引 → `.clinerules/superpowers-zh.md`。不写 YAML frontmatter —— Cline 目前只支持 `paths` 一个条件字段，无 frontmatter 即始终生效。索引保持在 `.clinerules/` 根层单文件（子目录是否递归扫描官方未说明）。
+- **Kilo Code**：skills → `.kilocode/skills/`，索引 → `.kilocode/rules/superpowers-zh.md`。**有意不走 v7 推荐的 `.kilo/rules/` + `kilo.jsonc`** —— 后者需把路径登记进用户的 `kilo.jsonc`（带注释的 JSONC，安装器安全合并容易改坏用户配置）。官方明确 `.kilocode/rules/` 向后兼容且零配置生效，故选它；docs 里写明了想迁到 v7 该改哪一行，以及万一没生效如何反馈。
+- 两者均**无 `--global`**：Cline 全局 rules 路径随 OS 变（`~/Documents/Cline/Rules`，Linux/WSL 还有 `~/Cline/Rules` 回退），Kilo 全局同样要走 `kilo.jsonc` 登记 —— 不是通用复制机制能可靠命中的，`--global` 明确拒绝并指向 docs，绝不写无效路径。
+- 路径依据：[docs.cline.bot](https://docs.cline.bot/customization/cline-rules)、[kilo.ai](https://kilo.ai/docs/customize/custom-rules)。
+
+### 🔧 检测落空时给出针对性建议（关 #48）
+
+装了 opencode / codex 但项目里没留下标记目录时，原先只报「未检测到任何已知 AI 编程工具」，用户无从判断下一步。
+
+- 新增 PATH 探测：检测落空时扫 PATH 找已安装的 CLI，直接打印可复制的 `--tool` 命令。
+- **只提示、不自动安装** —— 自动装错工具正是 #33 修掉的问题：PATH 上装了不代表这个项目要用它。
+- `isOnPath()` 只查文件是否存在，**不 spawn 进程**（不在用户机器上执行探测命令）；Windows 下遍历 `PATHEXT`。
+- `--global` 模式只建议支持全局的工具，不推荐装不了的。
+- 健壮性已测：`PATH` 为空 / 含空段 / 未定义三种退化情形均优雅退出 1，无未捕获异常。
+
+### 📄 文档
+
+- **补充 plugin marketplace 安装方式（关 #39）**：`.claude-plugin/marketplace.json` 从 v1.7.x 起就存在且可用，但 README 从未写过怎么用。已实测 `plugin validate` / `marketplace add jnMetaCode/superpowers-zh`（GitHub 直连克隆）/ `plugin install` 全链路通过，安装缓存内含全部 20 个 SKILL.md。简繁 README 新增「方式二」，原手动安装与配置文件引用顺延为方式三 / 四。
+- **修正 Copilot CLI 在 Windows 的工具面（关 #93）**：`copilot-tools.md` 原先只记 `bash` + `async:true` 一套，但 Windows 实测（Copilot CLI 1.0.69-1）注册的是 `powershell` + `detach`，没有 `bash`/`async` 家族。现拆成两张表并注明「两套不会同时出现」，补充两个坑：`.sh` 需显式走 Git Bash；`stop_powershell` 停不掉 `detach:true` 的进程，需按真实 Windows PID（非 MSYS PID）`Stop-Process`。
+- 新增 `docs/README.cline.md`、`docs/README.kilocode.md`。
+- 修正 installer 报错文案里失效的章节锚点（改为指向父级 `#快速开始`，不再依赖会变的章节编号）。
+- 计数 20 → 22 同步：简繁 README、`package.json`、`CLAUDE.md`、3 份 plugin manifest。
+
+### ✅ 验证
+
+- `scripts/audit.sh`：**130 pass / 0 fail**（2 项 warn 为既有上游漂移，见 #19）
+- 发版前深度验证（比 audit 严，断言实际落盘而非只看退出码）：**82 项全通过**
+  - 22 款工具：装 → 断言 20 个 skill 落盘 → 二次装幂等 → 卸载后零残留；无 `skills/skills` 嵌套
+  - 19 个检测标记逐一验证只触发预期工具，既有 20 款检测结果与改动前一致
+  - `--global`：7 款成功、14 款明确拒绝且退出码 1；拒绝信息引用的 8 份 docs 均存在
+  - bootstrap 索引断言：表行数 = 20、无空 description、Cline 无 frontmatter、路径指向正确
+- **npm 包端到端**：`npm pack` → 从 tarball 装 → 用打包后的二进制真实跑 Cline 自动检测 → 20 skills + 索引生成 → 卸载零残留
+
+---
+
 ## v1.7.0 (2026-07-13)

 ### 🆕 新增两款国产 IDE 工具支持（工具数 18 → 20）
--- a/gemini-extension.json
+++ b/gemini-extension.json
@@ -1,6 +1,6 @@
 {
  "name": "superpowers-zh",
  "description": "AI 编程超能力中文版 — TDD、调试、代码审查等经过实战验证的工作方法论",
-  "version": "1.7.1",
+  "version": "1.7.2",
  "contextFileName": "GEMINI.md"
 }
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
  "name": "superpowers-zh",
-  "version": "1.7.1",
+  "version": "1.7.2",
  "engines": {
    "node": ">=20.0.0"
  },
--- a/scripts/verify-release.sh
+++ b/scripts/verify-release.sh
@@ -0,0 +1,164 @@
+#!/usr/bin/env bash
+#
+# verify-release.sh — 发版前深度验证。
+#
+# 与 audit.sh 的分工：audit.sh 只看 installer 的退出码，装完到底有没有东西落盘、
+# 卸载有没有留垃圾它都不查。本脚本补上这些断言，发 npm 之前跑一次。
+#
+#   bash scripts/verify-release.sh
+#
+# 覆盖：
+#   A. 22 款工具：装 -> 断言 skill 数落盘 -> 二次装幂等 -> 卸载零残留 + 无嵌套
+#   B. 每个检测标记只触发预期工具（防新增工具时误触发既有工具）
+#   C. --global 白名单成功 / 其余明确拒绝且退出码 1
+#   D. --global 拒绝信息引用的 docs 文件真实存在（防死链）
+#   E. rules 型工具（Cline / Kilo Code）的 bootstrap 索引内容断言
+#   F. PATH 探测在 PATH 为空 / 畸形 / 未定义时的健壮性
+set -uo pipefail
+REPO="$(cd "$(dirname "$0")/.." && pwd)"
+INS="$REPO/bin/superpowers-zh.js"
+NODE=$(command -v node)   # 绝对路径：F 段要清空 PATH，用裸 node 会 127
+EXPECT_SKILLS=$(ls -d "$REPO"/skills/*/ | wc -l | tr -d ' ')
+
+PASS=0; FAIL=0
+declare -a FAILURES=()
+ok()   { PASS=$((PASS+1)); }
+bad()  { FAIL=$((FAIL+1)); FAILURES+=("$1"); printf '  ❌ %s\n' "$1"; }
+
+# 工具别名 -> 期望的 skills 目录（相对项目根）
+declare -a SPEC=(
+  "claude:.claude/skills"          "cursor:.cursor/skills"        "codex:.codex/skills"
+  "kiro:.kiro/steering"            "deerflow:skills/custom"       "trae:.trae/skills"
+  "antigravity:.agents/skills"     "vscode:.github/superpowers"   "openclaw:skills"
+  "windsurf:.windsurf/skills"      "gemini:.gemini/skills"        "aider:.aider/skills"
+  "opencode:.opencode/skills"      "qwen:.qwen/skills"            "hermes:.hermes/skills"
+  "claw:.claw/skills"              "copilot:.claude/skills"       "qoder:.qoder/skills"
+  "codebuddy:.codebuddy/skills"    "codearts:.codeartsdoer/skills"
+  "cline:.cline/skills"            "kilocode:.kilocode/skills"
+)
+
+echo "═══ 期望每款装入 $EXPECT_SKILLS 个 skill ═══"
+echo ""
+echo "─── A. 项目级：装 / 落盘断言 / 幂等 / 卸载无残留（22 款）───"
+for entry in "${SPEC[@]}"; do
+  tool="${entry%%:*}"; sdir="${entry#*:}"
+  T=$(mktemp -d); cd "$T"
+
+  if ! node "$INS" --tool "$tool" >/dev/null 2>&1; then
+    bad "$tool: 安装退出码非 0"; rm -rf "$T"; continue
+  fi
+  n=$(ls -d "$T/$sdir"/*/ 2>/dev/null | wc -l | tr -d ' ')
+  if [ "$n" != "$EXPECT_SKILLS" ]; then
+    bad "$tool: $sdir 里是 $n 个 skill，期望 $EXPECT_SKILLS"; rm -rf "$T"; continue
+  fi
+  # 嵌套 bug 检查：不应出现 skills/skills 之类
+  if find "$T" -type d -path "*/skills/skills" 2>/dev/null | grep -q .; then
+    bad "$tool: 出现嵌套 skills/skills 目录"
+  fi
+
+  node "$INS" --tool "$tool" >/dev/null 2>&1
+  n2=$(ls -d "$T/$sdir"/*/ 2>/dev/null | wc -l | tr -d ' ')
+  if [ "$n2" != "$EXPECT_SKILLS" ]; then
+    bad "$tool: 二次安装后变成 $n2 个（幂等性破坏）"; rm -rf "$T"; continue
+  fi
+
+  if ! node "$INS" --uninstall >/dev/null 2>&1; then
+    bad "$tool: 卸载退出码非 0"; rm -rf "$T"; continue
+  fi
+  left=$(find "$T" -type f 2>/dev/null | wc -l | tr -d ' ')
+  if [ "$left" != "0" ]; then
+    bad "$tool: 卸载后残留 $left 个文件: $(find "$T" -type f | head -3 | tr '\n' ' ')"
+  else
+    ok
+  fi
+  cd /; rm -rf "$T"
+done
+
+echo ""
+echo "─── B. 自动检测：每个标记只触发预期工具 ───"
+declare -a DETECT=(
+  ".claude:Claude Code"      ".cursor:Cursor"        ".codex:Codex CLI"
+  ".kiro:Kiro"               ".trae:Trae"            ".agents:Antigravity"
+  ".openclaw:OpenClaw"       ".windsurf:Windsurf"    ".aider:Aider"
+  ".opencode:OpenCode"       ".qwen:Qwen Code"       ".hermes:Hermes Agent"
+  ".claw:Claw Code"          ".qoder:Qoder"          ".codebuddy:CodeBuddy"
+  ".codeartsdoer:CodeArts"   ".clinerules:Cline"     ".kilocode:Kilo Code"
+  ".kilo:Kilo Code"
+)
+for entry in "${DETECT[@]}"; do
+  marker="${entry%%:*}"; want="${entry#*:}"
+  T=$(mktemp -d); cd "$T"; mkdir -p "$marker"
+  got=$(node "$INS" 2>&1 | grep -oE '✅ [A-Za-z][A-Za-z ]*(\[|:)' | sed 's/✅ //; s/ *[:[]$//' | sort -u | tr '\n' ',' | sed 's/,$//')
+  if [ "$got" != "$want" ]; then
+    bad "检测 $marker/ -> 得到「$got」，期望「$want」"
+  else
+    ok
+  fi
+  cd /; rm -rf "$T"
+done
+
+echo ""
+echo "─── C. --global：7 款应成功，其余应明确拒绝且退出码 1 ───"
+declare -a GLOBAL_OK=(claude codex openclaw windsurf opencode qwen qoder)
+declare -a GLOBAL_NO=(cursor kiro trae aider deerflow vscode hermes claw gemini antigravity codebuddy codearts cline kilocode)
+for tool in "${GLOBAL_OK[@]}"; do
+  H=$(mktemp -d)
+  if HOME="$H" node "$INS" --global --tool "$tool" >/dev/null 2>&1; then ok; else bad "--global $tool 应成功但失败"; fi
+  rm -rf "$H"
+done
+for tool in "${GLOBAL_NO[@]}"; do
+  H=$(mktemp -d)
+  out=$(HOME="$H" node "$INS" --global --tool "$tool" 2>&1); rc=$?
+  if [ $rc -eq 0 ]; then bad "--global $tool 应拒绝但成功了"
+  elif ! echo "$out" | grep -q "不支持通用全局安装"; then bad "--global $tool 拒绝信息缺失"
+  else ok; fi
+  rm -rf "$H"
+done
+
+echo ""
+echo "─── D. --global 拒绝信息里引用的 docs 文件必须存在 ───"
+for slug in gemini-cli antigravity trae aider hermes kiro cline kilocode; do
+  if [ -f "$REPO/docs/README.$slug.md" ]; then ok; else bad "docs/README.$slug.md 不存在（拒绝信息会指向死链）"; fi
+done
+
+echo ""
+echo "─── E. 新工具 bootstrap 索引内容断言 ───"
+T=$(mktemp -d); cd "$T"; node "$INS" --tool cline >/dev/null 2>&1
+R="$T/.clinerules/superpowers-zh.md"
+[ -f "$R" ] && ok || bad "Cline 索引文件未生成"
+head -1 "$R" | grep -q '^---' && bad "Cline 索引不该有 YAML frontmatter（Cline 只支持 paths 字段）" || ok
+rows=$(grep -cE '^\| [a-z][a-z0-9-]+ \|' "$R")
+[ "$rows" = "$EXPECT_SKILLS" ] && ok || bad "Cline 索引表 $rows 行，期望 $EXPECT_SKILLS"
+grep -qE '^\| [a-z0-9-]+ \|\s*\|$' "$R" && bad "Cline 索引有空 description 的行" || ok
+grep -q '\.cline/skills/' "$R" && ok || bad "Cline 索引未指向 .cline/skills/"
+cd /; rm -rf "$T"
+
+T=$(mktemp -d); cd "$T"; node "$INS" --tool kilocode >/dev/null 2>&1
+R="$T/.kilocode/rules/superpowers-zh.md"
+[ -f "$R" ] && ok || bad "Kilo 索引文件未生成"
+rows=$(grep -cE '^\| [a-z][a-z0-9-]+ \|' "$R")
+[ "$rows" = "$EXPECT_SKILLS" ] && ok || bad "Kilo 索引表 $rows 行，期望 $EXPECT_SKILLS"
+grep -q '\.kilocode/skills/' "$R" && ok || bad "Kilo 索引未指向 .kilocode/skills/"
+cd /; rm -rf "$T"
+
+echo ""
+echo "─── F. PATH 探测健壮性（issue #48 新代码）───"
+T=$(mktemp -d); cd "$T"
+out=$(PATH="" "$NODE" "$INS" 2>&1); rc=$?
+[ $rc -eq 1 ] && ok || bad "PATH 为空时应退出码 1，得到 $rc"
+echo "$out" | grep -q "未在当前目录检测到" && ok || bad "PATH 为空时缺少检测落空提示"
+out=$(PATH="/nonexistent:::/also/missing" "$NODE" "$INS" 2>&1); rc=$?
+[ $rc -eq 1 ] && ok || bad "PATH 含空段/不存在目录时应优雅退出 1，得到 $rc"
+echo "$out" | grep -qi "error\|Traceback\|ENOENT" && bad "PATH 异常时输出了未捕获错误" || ok
+cd /; rm -rf "$T"
+
+echo ""
+echo "═══════════════════════════════════"
+echo "✅ PASS: $PASS    ❌ FAIL: $FAIL"
+if [ $FAIL -gt 0 ]; then
+  echo ""
+  echo "失败项："
+  for f in "${FAILURES[@]}"; do echo "  - $f"; done
+  exit 1
+fi
+echo "✅ 深度验证全部通过"