dsh-ssh-tunnel 1.0.0 → 1.0.2

package/scripts/install.sh

@@ -1,226 +1,278 @@
-#!/usr/bin/env bash
-# =============================================================================
-# dsh-ssh-tunnel 一键安装（官方 CLI + bundle 自动挂载）
-#
-#   dsh plugin --profile web add <spec>
-#
-# 包内 dsh.bundle.patch（cordis.patch.yml）会由 CLI 写入
-# dsh.profile.bundles，无需手写 profile cordis.patch.yml。
-#
-# 用法：
-#   bash scripts/install.sh [版本] [--restart] [--dry-run] [--from github|npm]
-#
-#   版本         npm/git 版本；github 源可省略（默认 HEAD）或传 branch/tag/commit
-#   --from       github（默认，仓库尚未上 npm 时）| npm
-#   --restart    尝试 pm2 restart dsh-web
-#   --dry-run    只打印步骤
-#
-# 环境：DSH_HOME（默认 ~/.dsh）、REGISTRY、DSH_CMD、GITHUB_REPO
-# =============================================================================
-set -euo pipefail
-
-for arg in "$@"; do
-  if [ "$arg" = "-h" ] || [ "$arg" = "--help" ]; then
-    cat <<'EOF'
-dsh-ssh-tunnel 一键安装
-
-用法：bash scripts/install.sh [版本] [--restart] [--dry-run] [--from github|npm]
-
-  版本         缺省：github 用默认分支；npm 用 latest
-  --from       github（默认）| npm
-  --restart    装完尝试 pm2 restart dsh-web
-  --dry-run    只打印操作
-
-前置：已安装并运行过 dsh web；建议已装 dsh-better-sidebar（侧栏 Tab 依赖）。
-EOF
-    exit 0
-  fi
-done
-
-PKG="dsh-ssh-tunnel"
-PLUGIN_ID="ssh-tunnel"
-GITHUB_REPO="${GITHUB_REPO:-OMSociety/dsh-ssh-tunnel}"
-DSH_HOME="${DSH_HOME:-${HOME:-${USERPROFILE:-}}/.dsh}"
-PROFILE_DIR="$DSH_HOME/profiles/web"
-WS_YML="$PROFILE_DIR/pnpm-workspace.yaml"
-PATCH_YML="$PROFILE_DIR/cordis.patch.yml"
-REGISTRY="${REGISTRY:-https://registry.npmjs.org}"
-DSH_CMD="${DSH_CMD:-dsh}"
-
-RESTART=false
-DRY_RUN=false
-FROM="github"
-VERSION_SPEC=""
-while [ $# -gt 0 ]; do
-  case "$1" in
-    --restart) RESTART=true; shift ;;
-    --dry-run) DRY_RUN=true; shift ;;
-    --from)
-      [ $# -ge 2 ] || { echo "--from 需要 github|npm" >&2; exit 2; }
-      FROM="$2"; shift 2
-      ;;
-    --from=github) FROM="github"; shift ;;
-    --from=npm) FROM="npm"; shift ;;
-    -h|--help) shift ;;
-    -*)
-      echo "未知参数: ${1}（用 -h 查看用法）" >&2
-      exit 2
-      ;;
-    *) VERSION_SPEC="$1"; shift ;;
-  esac
-done
-case "$FROM" in github|npm) ;; *) echo "--from 只能是 github 或 npm" >&2; exit 2 ;; esac
-
-say()  { printf '\033[32m[install]\033[0m %s\n' "$*"; }
-warn() { printf '\033[33m[warn]\033[0m %s\n' "$*" >&2; }
-die()  { printf '\033[31m[error]\033[0m %s\n' "$*" >&2; exit 1; }
-
-dsh_cli() {
-  if command -v "$DSH_CMD" >/dev/null 2>&1; then
-    printf '%s' "$DSH_CMD"
-  elif command -v npx >/dev/null 2>&1; then
-    printf 'npx -y --package @deepseek-ai/dsh dsh'
-  else
-    die "未找到 dsh 或 npx。请先安装 DSH，或用 DSH_CMD 指定。"
-  fi
-}
-
-resolve_add_spec() {
-  if [ "$FROM" = "npm" ]; then
-    local given="${VERSION_SPEC:-latest}"
-    if [ "$given" = "latest" ]; then
-      local v=""
-      if command -v npm >/dev/null 2>&1; then
-        v="$(npm view "$PKG" version --registry="$REGISTRY" 2>/dev/null)" || v=""
-      fi
-      if [ -z "$v" ] && command -v pnpm >/dev/null 2>&1; then
-        v="$(pnpm view "$PKG" version --registry="$REGISTRY" 2>/dev/null)" || v=""
-      fi
-      if [ -n "$v" ]; then printf '%s@%s' "$PKG" "$v"
-      else printf '%s@latest' "$PKG"
-      fi
-    else
-      printf '%s@%s' "$PKG" "$given"
-    fi
-  else
-    local ref="${VERSION_SPEC:-}"
-    if [ -n "$ref" ]; then
-      printf '%s@github:%s#%s' "$PKG" "$GITHUB_REPO" "$ref"
-    else
-      printf '%s@github:%s' "$PKG" "$GITHUB_REPO"
-    fi
-  fi
-}
-
-command -v node >/dev/null 2>&1 || die "未找到 node（需要 Node.js ≥ 20）。"
-NODE_MAJOR="$(node -p 'process.versions.node.split(".")[0]' 2>/dev/null)" || NODE_MAJOR=0
-[ "${NODE_MAJOR:-0}" -ge 20 ] || die "Node.js $(node -v) 过旧（需要 ≥ 20）。"
-[ -d "$PROFILE_DIR" ] || die "找不到 profile 目录：${PROFILE_DIR}（请先运行过 dsh web）"
-[ -f "$WS_YML" ] || die "找不到 ${WS_YML}（请先初始化 web profile）"
-
-ADD_SPEC="$(resolve_add_spec)"
-CLI="$(dsh_cli)"
-say "目标：$CLI plugin --profile web add ${ADD_SPEC}（profile: ${PROFILE_DIR}）"
-say "来源：${FROM}（仓库 ${GITHUB_REPO}）"
-
-if [ "$DRY_RUN" = true ]; then
-  say "[dry-run] 1) minimumReleaseAgeExclude += ${PKG}"
-  say "[dry-run] 2) $CLI plugin --profile web add ${ADD_SPEC}"
-  say "[dry-run] 3) 校验 dsh.profile.bundles 含 ${PKG}"
-  say "[dry-run] 4) 移除 profile cordis.patch.yml 中 id: ${PLUGIN_ID} 的旧手动挂载"
-  if [ "$RESTART" = true ]; then say "[dry-run] 5) pm2 restart dsh-web"; else say "[dry-run] 5) 提示手动重启"; fi
-  exit 0
-fi
-
-WS_RESULT="$(node -e '
-const fs = require("fs");
-const p = process.argv[1];
-const pkg = process.argv[2];
-let t = fs.readFileSync(p, "utf8");
-const before = t;
-if (!new RegExp("^\\s*-\\s+" + pkg.replace(/[.*+?^${}()|[\\]\\\\]/g, "\\\\$&") + "\\s*$", "m").test(t)) {
-  if (/^\\s*minimumReleaseAgeExclude:\\s*$/m.test(t)) {
-    t = t.replace(/^(\\s*minimumReleaseAgeExclude:\\s*)$/m, "$1\\n  - " + pkg);
-  } else {
-    t += "\\nminimumReleaseAgeExclude:\\n  - " + pkg + "\\n";
-  }
-}
-if (t !== before) fs.writeFileSync(p, t);
-console.log(t === before ? "unchanged" : "updated");
-' "$WS_YML" "$PKG")"
-[ "$WS_RESULT" = "updated" ] \
-  && say "已写入 ${WS_YML}：minimumReleaseAgeExclude（${PKG}）" \
-  || say "workspace 设置已就绪，跳过"
-
-say "执行 $CLI plugin --profile web add $ADD_SPEC ..."
-if ! $CLI plugin --profile web add "$ADD_SPEC" 2>&1 | tail -n +1; then
-  warn "dsh plugin add 失败。可检查网络、registry，或手动："
-  warn "  cd $PROFILE_DIR && pnpm install"
-  warn "前置建议：dsh plugin --profile web add dsh-better-sidebar"
-  exit 1
-fi
-
-if ! node -e '
-  const fs = require("fs");
-  const p = JSON.parse(fs.readFileSync(process.argv[1], "utf8"));
-  const bundles = p.dsh?.profile?.bundles ?? [];
-  process.exit(bundles.includes(process.argv[2]) ? 0 : 1);
-' "$PROFILE_DIR/package.json" "$PKG"; then
-  warn "${PKG} 未出现在 dsh.profile.bundles——挂载未注册。"
-  exit 1
-fi
-say "bundle 已注册：dsh.profile.bundles 包含 ${PKG}"
-
-if [ -f "$PATCH_YML" ]; then
-  MOUNT_RESULT="$(node -e '
-const fs = require("fs");
-const p = process.argv[1];
-const id = process.argv[2];
-const lines = fs.readFileSync(p, "utf8").split("\\n");
-const out = [];
-let i = 0;
-let removed = false;
-const idRe = new RegExp("id:\\\\s*" + id.replace(/[.*+?^${}()|[\\]\\\\]/g, "\\\\$&") + "\\\\b");
-while (i < lines.length) {
-  const line = lines[i];
-  if (/^[ \\t]*- insert:\\s*$/.test(line)) {
-    const block = [line];
-    let j = i + 1;
-    while (j < lines.length && lines[j].trim() !== "" && !/^-\\s/.test(lines[j])) {
-      block.push(lines[j]);
-      j++;
-    }
-    if (block.some((l) => idRe.test(l))) {
-      while (out.length && /^[ \\t]*#/.test(out[out.length - 1])) out.pop();
-      i = j;
-      removed = true;
-      continue;
-    }
-  }
-  out.push(line);
-  i++;
-}
-if (!removed) console.log("none");
-else {
-  fs.writeFileSync(p, out.join("\\n").replace(/\\n{3,}/g, "\\n\\n"));
-  console.log("removed");
-}
-' "$PATCH_YML" "$PLUGIN_ID")"
-  [ "$MOUNT_RESULT" = "removed" ] \
-    && say "已从 $PATCH_YML 移除旧的 ${PLUGIN_ID} 手动挂载行" \
-    || say "无旧手动挂载行，跳过"
-fi
-
-say "安装完成：${ADD_SPEC}"
-say "验证：dsh --profile web --dump-config | grep -n '${PLUGIN_ID}\\|${PKG}'"
-
-if [ "$RESTART" = true ]; then
-  if command -v pm2 >/dev/null 2>&1; then
-    say "重启 dsh-web（pm2）..."
-    pm2 restart dsh-web || warn "pm2 restart 失败，请手动重启 DSH"
-  else
-    warn "未找到 pm2，请手动重启 DSH（docker compose restart / pm2 / 进程管理器）"
-  fi
-else
-  say "下一步：重启 DSH web，并硬刷新浏览器（Cmd/Ctrl+Shift+R）。"
-fi
+#!/usr/bin/env bash
+# =============================================================================
+# dsh-ssh-tunnel 一键安装（官方 CLI + bundle 自动挂载）
+#
+#   dsh plugin --profile <名称> add <spec>
+#
+# 包内 dsh.bundle.patch（cordis.patch.yml）会由 CLI 写入
+# dsh.profile.bundles，无需手写 profile cordis.patch.yml。
+#
+# 用法：
+#   bash scripts/install.sh [版本] [--profile <名称>] [--fix-profile] [--from github|npm] [--restart] [--dry-run] [-h|--help]
+#
+#   版本            npm 版本或 github 的 branch/tag/commit；github 源可省略（默认 HEAD）
+#   --profile       目标 profile 名称（必填，无默认值；缺失或不存在时列出实存 profile 并退出 2）
+#   --fix-profile   可选维护动作：向 pnpm-workspace.yaml 的 minimumReleaseAgeExclude
+#                   追加本包（幂等），并清理 cordis.patch.yml 里 id: ssh-tunnel 的
+#                   旧手动挂载块（幂等）。两者均写后回读断言，失败回滚并以非零码退出。
+#                   不带本参数时绝不改写这两个文件，只在缺条目时打 warn 提示。
+#   --from          github（默认，仓库尚未上 npm 时）| npm
+#   --restart       尝试 pm2 restart dsh-web
+#   --dry-run       只打印步骤，不写任何文件
+#
+# 环境：DSH_HOME（默认 ~/.dsh）、DSH_CMD（默认 dsh）、REGISTRY、GITHUB_REPO、
+#       DSH_INSTALL_YES=1（跳过 npx 兜底的交互确认）
+# =============================================================================
+set -euo pipefail
+
+PKG="dsh-ssh-tunnel"
+PLUGIN_ID="ssh-tunnel"
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+LIB_DIR="$SCRIPT_DIR/lib"
+GITHUB_REPO="${GITHUB_REPO:-OMSociety/dsh-ssh-tunnel}"
+REGISTRY="${REGISTRY:-https://registry.npmjs.org}"
+DSH_CMD="${DSH_CMD:-dsh}"
+DSH_HOME="${DSH_HOME:-${HOME:-${USERPROFILE:-}}/.dsh}"
+
+usage() {
+  cat <<'EOF'
+dsh-ssh-tunnel 一键安装
+
+用法：bash scripts/install.sh [版本] [--profile <名称>] [--fix-profile] [--from github|npm] [--restart] [--dry-run] [-h|--help]
+
+  版本            npm 版本或 github 的 branch/tag/commit；github 源可省略（默认 HEAD）
+  --profile <名>  目标 profile 名称（必填，无默认值）
+  --fix-profile   可选：补写 minimumReleaseAgeExclude 并清理旧手动挂载（幂等、带回读断言）
+  --from          github（默认）| npm
+  --restart       装完尝试 pm2 restart dsh-web
+  --dry-run       只打印操作，不写任何文件
+  -h|--help       显示本帮助
+
+环境：DSH_HOME（默认 ~/.dsh）、DSH_CMD（默认 dsh）、REGISTRY、GITHUB_REPO、
+      DSH_INSTALL_YES=1（跳过 npx 兜底确认）
+
+前置：目标 profile 已初始化（含 package.json 与 pnpm-workspace.yaml）；
+      建议已装 dsh-better-sidebar（侧栏 Tab 依赖）。
+EOF
+}
+
+say()  { printf '\033[32m[install]\033[0m %s\n' "$*"; }
+warn() { printf '\033[33m[warn]\033[0m %s\n' "$*" >&2; }
+die()  { printf '\033[31m[error]\033[0m %s\n' "$*" >&2; exit 1; }
+
+list_profiles() {
+  if [ ! -d "$DSH_HOME/profiles" ]; then
+    echo "  （未找到 $DSH_HOME/profiles）"
+    return 0
+  fi
+  local any="" d
+  for d in "$DSH_HOME"/profiles/*/; do
+    [ -d "$d" ] || continue
+    any=1
+    echo "  - $(basename "$d")"
+  done
+  [ -n "$any" ] || echo "  （$DSH_HOME/profiles 下没有 profile）"
+}
+
+# ---------- 参数解析 ----------
+PROFILE_NAME=""
+FROM="github"
+VERSION_SPEC=""
+FIX_PROFILE=false
+RESTART=false
+DRY_RUN=false
+SHOW_HELP=false
+
+while [ $# -gt 0 ]; do
+  case "$1" in
+    -h|--help) SHOW_HELP=true; shift ;;
+    --profile)
+      [ $# -ge 2 ] || { echo "[error] --profile 需要一个名称（用 -h 查看用法）" >&2; exit 2; }
+      PROFILE_NAME="$2"; shift 2 ;;
+    --profile=*) PROFILE_NAME="${1#*=}"; shift ;;
+    --fix-profile) FIX_PROFILE=true; shift ;;
+    --from)
+      [ $# -ge 2 ] || { echo "[error] --from 需要 github|npm（用 -h 查看用法）" >&2; exit 2; }
+      FROM="$2"; shift 2 ;;
+    --from=*) FROM="${1#*=}"; shift ;;
+    --restart) RESTART=true; shift ;;
+    --dry-run) DRY_RUN=true; shift ;;
+    -*) echo "[error] 未知参数: $1（用 -h 查看用法）" >&2; exit 2 ;;
+    *)
+      if [ -n "$VERSION_SPEC" ]; then
+        echo "[error] 多余的位置参数: $1（版本只能传一个，用 -h 查看用法）" >&2
+        exit 2
+      fi
+      VERSION_SPEC="$1"; shift ;;
+  esac
+done
+
+if [ "$SHOW_HELP" = true ]; then usage; exit 0; fi
+
+case "$FROM" in
+  github|npm) ;;
+  *) echo "[error] --from 只能是 github 或 npm（当前: $FROM）" >&2; exit 2 ;;
+esac
+
+if [ -z "$PROFILE_NAME" ]; then
+  echo "[error] 缺少 --profile 参数。$DSH_HOME/profiles/ 下实存 profile：" >&2
+  list_profiles >&2
+  exit 2
+fi
+
+PROFILE_DIR="$DSH_HOME/profiles/$PROFILE_NAME"
+WS_YML="$PROFILE_DIR/pnpm-workspace.yaml"
+PATCH_YML="$PROFILE_DIR/cordis.patch.yml"
+PKG_JSON="$PROFILE_DIR/package.json"
+
+if [ ! -d "$PROFILE_DIR" ]; then
+  echo "[error] profile 不存在: $PROFILE_NAME（$PROFILE_DIR）。$DSH_HOME/profiles/ 下实存 profile：" >&2
+  list_profiles >&2
+  exit 2
+fi
+
+# ---------- 前置检查 ----------
+command -v node >/dev/null 2>&1 || die "未找到 node（需要 Node.js ≥ 20）。"
+NODE_MAJOR="$(node -p 'process.versions.node.split(".")[0]' 2>/dev/null)" || NODE_MAJOR=0
+[ "${NODE_MAJOR:-0}" -ge 20 ] || die "Node.js $(node -v 2>/dev/null) 过旧（需要 ≥ 20）。"
+
+resolve_add_spec() {
+  if [ "$FROM" = "npm" ]; then
+    local given="${VERSION_SPEC:-latest}"
+    if [ "$given" = "latest" ]; then
+      local v=""
+      if command -v npm >/dev/null 2>&1; then
+        v="$(npm view "$PKG" version --registry="$REGISTRY" 2>/dev/null)" || v=""
+      fi
+      if [ -z "$v" ] && command -v pnpm >/dev/null 2>&1; then
+        v="$(pnpm view "$PKG" version --registry="$REGISTRY" 2>/dev/null)" || v=""
+      fi
+      if [ -n "$v" ]; then printf '%s@%s' "$PKG" "$v"
+      else printf '%s@latest' "$PKG"
+      fi
+    else
+      printf '%s@%s' "$PKG" "$given"
+    fi
+  else
+    local ref="${VERSION_SPEC:-}"
+    if [ -n "$ref" ]; then
+      printf '%s@github:%s#%s' "$PKG" "$GITHUB_REPO" "$ref"
+    else
+      printf '%s@github:%s' "$PKG" "$GITHUB_REPO"
+    fi
+  fi
+}
+ADD_SPEC="$(resolve_add_spec)"
+
+# ---------- dsh CLI 解析（npx 兜底需交互确认） ----------
+DSH_CLI_CMD=""
+NPX_FALLBACK=false
+if command -v "$DSH_CMD" >/dev/null 2>&1; then
+  DSH_CLI_CMD="$DSH_CMD"
+elif command -v npx >/dev/null 2>&1; then
+  DSH_CLI_CMD="npx -y --package @deepseek-ai/dsh dsh"
+  NPX_FALLBACK=true
+else
+  die "未找到 dsh 或 npx。请先安装 DSH，或用 DSH_CMD 指定。"
+fi
+
+say "目标：$DSH_CLI_CMD plugin --profile $PROFILE_NAME add $ADD_SPEC（profile 目录: $PROFILE_DIR）"
+say "来源：$FROM（仓库 $GITHUB_REPO）"
+
+if [ "$DRY_RUN" = true ]; then
+  say "[dry-run] 1) minimumReleaseAgeExclude 处理（--fix-profile 时写入，否则仅检查+warn）：$WS_YML"
+  say "[dry-run] 2) $DSH_CLI_CMD plugin --profile $PROFILE_NAME add $ADD_SPEC"
+  say "[dry-run] 3) 校验 dsh.profile.bundles 含 $PKG：$PKG_JSON"
+  say "[dry-run] 4) allowBuilds 预检（advisory）：$PROFILE_DIR/node_modules/.modules.yaml"
+  say "[dry-run] 5) 旧手动挂载清理（仅 --fix-profile）：$PATCH_YML"
+  if [ "$RESTART" = true ]; then
+    say "[dry-run] 6) pm2 restart dsh-web"
+  else
+    say "[dry-run] 6) 提示重启 DSH web 并硬刷新浏览器"
+  fi
+  exit 0
+fi
+
+# npx 兜底：任何写操作发生前先交互确认
+if [ "$NPX_FALLBACK" = true ]; then
+  say "未找到 dsh，将用 npx 兜底执行：$DSH_CLI_CMD plugin --profile $PROFILE_NAME add $ADD_SPEC"
+  if [ "${DSH_INSTALL_YES:-0}" != "1" ]; then
+    printf '继续执行将联网下载并运行 @deepseek-ai/dsh，确认? [y/N] '
+    REPLY=""
+    read -r REPLY || { echo; die "读取确认失败，中止。"; }
+    case "$REPLY" in
+      y|Y|yes|YES|Yes) ;;
+      *) die "已中止（未执行任何安装步骤）。" ;;
+    esac
+  fi
+fi
+
+[ -f "$PKG_JSON" ] || die "找不到 $PKG_JSON（profile 未初始化？）"
+if [ "$FIX_PROFILE" = true ] && [ ! -f "$WS_YML" ]; then
+  die "找不到 $WS_YML（--fix-profile 需要它来补写 minimumReleaseAgeExclude）"
+fi
+
+# ---------- 1) minimumReleaseAgeExclude ----------
+if [ "$FIX_PROFILE" = true ]; then
+  WS_RESULT="$(node "$LIB_DIR/ws-exclude.cjs" "$WS_YML" "$PKG")" \
+    || die "--fix-profile：补写 minimumReleaseAgeExclude 失败（文件已保持原样）。"
+  case "$WS_RESULT" in
+    updated)   say "已补写 $WS_YML：minimumReleaseAgeExclude += $PKG" ;;
+    unchanged) say "minimumReleaseAgeExclude 已含 $PKG，跳过" ;;
+    *)         say "workspace exclude 状态: $WS_RESULT" ;;
+  esac
+else
+  if [ -f "$WS_YML" ]; then
+    if ! node "$LIB_DIR/ws-exclude.cjs" --check "$WS_YML" "$PKG" >/dev/null 2>&1; then
+      warn "minimumReleaseAgeExclude 未包含 ${PKG}——pnpm minimumReleaseAge 可能拒绝安装；可加 --fix-profile 自动补写。"
+    fi
+  else
+    warn "未找到 $WS_YML，跳过 minimumReleaseAgeExclude 检查。"
+  fi
+fi
+
+# ---------- 2) plugin add ----------
+say "执行 $DSH_CLI_CMD plugin --profile $PROFILE_NAME add $ADD_SPEC ..."
+read -r -a CLI_ARR <<< "$DSH_CLI_CMD"
+if ! "${CLI_ARR[@]}" plugin --profile "$PROFILE_NAME" add "$ADD_SPEC"; then
+  warn "dsh plugin add 失败。可检查网络、registry，或手动执行："
+  warn "  $DSH_CLI_CMD plugin --profile $PROFILE_NAME add \"$ADD_SPEC\""
+  warn "前置建议：dsh plugin --profile $PROFILE_NAME add dsh-better-sidebar"
+  exit 1
+fi
+
+# ---------- 3) bundle 校验 ----------
+if ! node "$LIB_DIR/bundle-check.cjs" "$PKG_JSON" "$PKG"; then
+  warn "$PKG 未出现在 dsh.profile.bundles——挂载未注册。"
+  exit 1
+fi
+say "bundle 已注册：dsh.profile.bundles 包含 $PKG"
+
+# ---------- 4) allowBuilds 预检（advisory） ----------
+if ! node "$LIB_DIR/bundle-check.cjs" --ignored-builds "$PROFILE_DIR"; then
+  warn "allowBuilds 预检异常（不影响安装结果）。"
+fi
+
+# ---------- 5) 旧手动挂载清理（仅 --fix-profile） ----------
+if [ "$FIX_PROFILE" = true ] && [ -f "$PATCH_YML" ]; then
+  STRIP_RESULT="$(node "$LIB_DIR/strip-mount.cjs" "$PATCH_YML" "$PLUGIN_ID")" \
+    || die "清理旧手动挂载失败（$PATCH_YML 已回滚为原内容；插件本体安装不受影响）。"
+  case "$STRIP_RESULT" in
+    removed) say "已从 $PATCH_YML 移除旧的 $PLUGIN_ID 手动挂载块" ;;
+    none)    say "无旧手动挂载块，跳过" ;;
+  esac
+fi
+
+say "安装完成：$ADD_SPEC（profile: $PROFILE_NAME）"
+say "验证：dsh --profile $PROFILE_NAME --dump-config | grep -n '${PLUGIN_ID}\\|${PKG}'"
+
+if [ "$RESTART" = true ]; then
+  if command -v pm2 >/dev/null 2>&1; then
+    say "重启 dsh-web（pm2）..."
+    pm2 restart dsh-web || warn "pm2 restart 失败，请手动重启 DSH"
+  else
+    warn "未找到 pm2，请手动重启 DSH（docker compose restart / pm2 / 进程管理器）"
+  fi
+else
+  say "下一步：重启 DSH web，并硬刷新浏览器（Cmd/Ctrl+Shift+R）。"
+fi

package/scripts/lib/bundle-check.cjs

@@ -0,0 +1,108 @@
+#!/usr/bin/env node
+'use strict';
+/*
+ * 安装后的两类检查（install.sh / install.ps1 共用）。
+ *
+ *   1) node bundle-check.cjs <profile/package.json> <pkg>
+ *      校验 dsh.profile.bundles 是否包含 pkg：包含退出 0（打印 ok），否则退出 1。
+ *
+ *   2) node bundle-check.cjs --ignored-builds <profileDir>
+ *      读取 <profileDir>/node_modules/.modules.yaml 的 ignoredBuilds 段，
+ *      打印 allowBuilds 可复制豁免指引。advisory 性质：恒退出 0；
+ *      .modules.yaml 不存在时跳过不报错。
+ */
+const fs = require('fs');
+const path = require('path');
+
+function err2(msg) {
+  process.stderr.write('[bundle-check] ' + msg + '\n');
+}
+
+const argv = process.argv.slice(2);
+
+if (argv[0] === '--ignored-builds') {
+  const profileDir = argv[1];
+  if (!profileDir || argv.length !== 2) {
+    process.stderr.write('用法: node bundle-check.cjs --ignored-builds <profileDir>\n');
+    process.exit(2);
+  }
+  const modulesYaml = path.join(profileDir, 'node_modules', '.modules.yaml');
+  let text;
+  try {
+    text = fs.readFileSync(modulesYaml, 'utf8');
+  } catch (e) {
+    console.log('[allowBuilds] 未找到 ' + modulesYaml + '，跳过 allowBuilds 预检。');
+    process.exit(0);
+  }
+  const lines = text.split('\n');
+  let start = -1;
+  let inlineRest = '';
+  for (let i = 0; i < lines.length; i++) {
+    const m = lines[i].match(/^ignoredBuilds:(.*)$/);
+    if (m) {
+      start = i;
+      inlineRest = m[1].trim();
+      break;
+    }
+  }
+  const entries = [];
+  if (start !== -1) {
+    if (inlineRest && inlineRest !== '[]') {
+      // 内联形式（如 ignoredBuilds: [a, b]）
+      const inner = inlineRest.replace(/^\[/, '').replace(/\]$/, '');
+      for (const part of inner.split(',')) {
+        const v = part.trim().replace(/^['"]|['"]$/g, '');
+        if (v) entries.push(v);
+      }
+    } else if (!inlineRest) {
+      for (let j = start + 1; j < lines.length; j++) {
+        if (lines[j].trim() === '') continue;
+        const im = lines[j].match(/^[ \t]+-[ \t]*(.+)$/);
+        if (!im) break;
+        const v = im[1].trim().replace(/^['"]|['"]$/g, '');
+        if (v) entries.push(v);
+      }
+    }
+  }
+  if (entries.length === 0) {
+    console.log('[allowBuilds] ignoredBuilds 为空或不存在，无需处理。');
+    process.exit(0);
+  }
+  const wsPath = path.join(profileDir, 'pnpm-workspace.yaml');
+  const out = [];
+  out.push('[allowBuilds] pnpm 跳过了以下依赖的构建脚本（node_modules/.modules.yaml: ignoredBuilds）:');
+  for (const e of entries) out.push('  - ' + e);
+  out.push('这些包的 install 脚本没有执行，相关功能可能不完整。如需豁免，把下面内容并入 ' + wsPath + '（已有 allowBuilds 段则合并键值）:');
+  out.push('');
+  out.push('allowBuilds:');
+  for (const e of entries) out.push('  "' + e + '": true');
+  out.push('');
+  out.push('注意: 键必须是上面 ignoredBuilds 行的原文（与 lockfile 中的 spec 逐字一致）；纯包名（如 ssh2）不生效。');
+  console.log(out.join('\n'));
+  process.exit(0);
+}
+
+// 模式 1：bundle 校验
+const pkgJsonPath = argv[0];
+const pkg = argv[1];
+if (!pkgJsonPath || !pkg || argv.length !== 2) {
+  process.stderr.write('用法: node bundle-check.cjs <profile/package.json> <pkg>\n');
+  process.exit(2);
+}
+let parsed;
+try {
+  parsed = JSON.parse(fs.readFileSync(pkgJsonPath, 'utf8'));
+} catch (e) {
+  err2('读取/解析失败: ' + pkgJsonPath + ' (' + e.message + ')');
+  process.exit(2);
+}
+const bundles =
+  parsed && parsed.dsh && parsed.dsh.profile && Array.isArray(parsed.dsh.profile.bundles)
+    ? parsed.dsh.profile.bundles
+    : null;
+if (bundles && bundles.indexOf(pkg) !== -1) {
+  console.log('ok: dsh.profile.bundles contains ' + pkg);
+  process.exit(0);
+}
+err2('dsh.profile.bundles 不含 ' + pkg + '（当前: ' + JSON.stringify(bundles) + '）');
+process.exit(1);