@whyshu/argent-engine 0.7.2 → 0.7.4

package/engine/scripts/drill-clean-machine.sh

@@ -1,315 +0,0 @@
-#!/usr/bin/env bash
-# drill-clean-machine.sh —— **干净机器一条命令**的隔离演练（D1/D2 的可复现证据；2026-10-05）
-#
-# 用途：把 `scripts/install-one-shot.mjs` 放进一个**与真实机器无关的夹具**里真跑一遍，
-#       并按"真实目录零变化"哨兵自证**没有**碰过 `~/.dsh/**`、`~/.argent-dsh/**`。
-#
-# 隔离构造（三条，缺一不可）：
-#   ① `HOME` 指向 `$FIX/home`（全新空目录）⇒ `~/.dsh`、`~/.argent-dsh`、`~/.pnpm` 全落在夹具里；
-#   ② 子进程一律 `env -i`（**极简环境**：只给 HOME/PATH，清掉 DSH_HOME/ARGENT_DATA_DIR/密钥等实例级开关）；
-#   ③ PATH 只含**夹具 bin**（node/git/dsh 的软链）+ 系统目录 ⇒ 包管理器**不在** PATH 上
-#      （演练刻意不跑 pnpm —— 装配走安装器的 `--from-packs` 离线面）。
-#   能力来源 = **离线包目录**（`capability_pack.py --build` 现场构建），不依赖 `~/.argent-dsh` 克隆。
-#
-# 演练内容（六跑）：
-#   A. dry-run             ⇒ 退出码 0，且夹具**零写入**（dry-run 语义）
-#   B. --apply（无许可）   ⇒ 退出码 0，装配 + 技能同步真跑；许可段 skipped（"未装许可"不算失败）
-#   C. 重跑 B              ⇒ 退出码 0，逐段结论与 B 一致（**幂等**）
-#   D. --only license --apply（夹具许可）⇒ 退出码 0，许可真落到夹具数据目录
-#   F. 在线装配面（本地镜像克隆 file://<仓库>、零网络、无包管理器 ⇒ 安装器既有"直拷"回退）
-#   E. 多包一起装（full,invoice）⇒ **预期退出码 0**（2026-10-09 起）：注册表投影在计划阶段与落盘阶段
-#      用**同一个**判据豁免（`isRegistryProjection()`），落盘后盘上注册表 = 两份投影的并集。
-#   收尾：哨兵比对（真实目录零变化）+ 夹具树/清单快照
-#
-# 用法：
-#   bash scripts/drill-clean-machine.sh [--keep] [--dir <夹具根>] [--caps <单个能力>] [--timeout <秒>]
-#   `--caps` 可给**多个**（逗号分隔）：同批发布的包本就该一起装（跨包共用引擎文件必须同版）；
-#   E 步仍单独用全新树演示一次"两个包一起装"的完整判据（退出码 + 装机清单 + 注册表并集）。
-# 退出码：0 四跑与哨兵均符合预期 ｜ 1 有不符合预期项（逐条点名）｜ 2 用法/环境错误
-set -uo pipefail
-
-REPO="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd -P)"
-KEEP=0
-FIX=""
-CAPS="full"
-GUARD_CAPS="full,invoice"   # E 步：多包一起装（回归判据，见文档 §E）
-TIMEOUT=1800
-while [ $# -gt 0 ]; do
-  case "$1" in
-    --keep) KEEP=1; shift ;;
-    --dir) FIX="$2"; shift 2 ;;
-    --caps) CAPS="$2"; shift 2 ;;
-    --timeout) TIMEOUT="$2"; shift 2 ;;
-    -h|--help) sed -n '2,26p' "$0"; exit 0 ;;
-    *) echo "✗ 未知参数：$1" >&2; exit 2 ;;
-  esac
-done
-case "$CAPS" in
-  *,*) : ;;   # 多能力（逗号分隔）自 2026-10-09 起支持：一起装是**推荐**路径
-  '') echo "✗ --caps 不能为空" >&2; exit 2 ;;
-esac
-[ -n "$FIX" ] || FIX="$(mktemp -d "${TMPDIR:-/tmp}/argent-drill.XXXXXX")"
-FIX="$(cd "$FIX" && pwd -P)"
-mkdir -p "$FIX/bin" "$FIX/home" "$FIX/packs"
-
-ONE="$REPO/scripts/install-one-shot.mjs"
-[ -f "$ONE" ] || { echo "✗ 缺 $ONE" >&2; exit 2; }
-
-FAIL=0
-note() { printf '%s\n' "$*"; }
-ok()   { printf '  ✅ %s\n' "$*"; }
-bad()  { printf '  ✗ %s\n' "$*"; FAIL=1; }
-warn() { printf '  ⚠️  %s\n' "$*"; }
-hdr()  { printf '\n── %s\n' "$*"; }
-
-# ── 夹具 bin：只放 node / git / dsh（**不放** pnpm/npm/corepack）──────────────
-for t in node git dsh; do
-  p="$(command -v "$t" 2>/dev/null || true)"
-  [ -n "$p" ] && ln -sf "$p" "$FIX/bin/$t"
-done
-MINPATH="$FIX/bin:/usr/bin:/bin:/usr/sbin:/sbin"
-RUN=(env -i "HOME=$FIX/home" "PATH=$MINPATH" "TMPDIR=$FIX/tmp" \
-     "ARGENT_REPO_URL=file://$REPO"      # 在线面用**本地镜像**克隆（不是 whyshu 私服）：零网络
-     "ARGENT_SKIP_MODEL_PROBE=1")        # 联网凭证探针在夹具里没有 Key ⇒ 用安装器既有逃逸阀（它会打警告）
-mkdir -p "$FIX/tmp"
-
-note "═══════════════════════════════════════════════════"
-note "  干净机器演练夹具：$FIX"
-note "  HOME=$FIX/home（隔离）｜ PATH=$MINPATH"
-note "  node=$(node --version 2>/dev/null)｜git=$(git --version 2>/dev/null | awk '{print $3}')｜dsh=$(command -v dsh || echo 无)"
-note "  ⛔ 包管理器不在 PATH（演练刻意不跑 pnpm）"
-note "═══════════════════════════════════════════════════"
-
-# ── 哨兵（真实目录）────────────────────────────────────────────────────────
-# 立场：演练**只读**真实目录。哨兵盯"本次演练最可能误写的面"，逐条 sha 比对。
-# 刻意**不**盯会话/日志（常驻 dsh web 在写，盘它必然恒红，属噪声不属判据）。
-# 真实数据目录：**只调内核的唯一判据**（`core/lib/argent-datadir.mjs#resolveDataDir()`），
-# 本脚本里**不写第二份**（`ARGENT_DATA_DIR`/`DSH_HOME` 一律清掉 ⇒ 解析出的就是"本机默认位置"）。
-# 为什么哨兵也必须这样：门禁 scripts/tests/argent-datadir-parity.test.mjs【4】对 .sh 里的
-# `$HOME/.dsh/argent` 式硬编码判据**判红**（2026-10-01 桌面端事故形态）。
-# 用 `env -i` 清掉整份环境（**不点名任何**实例级开关变量 —— 点名它本身就是"第二份三级链"，
-# 会被同一条门禁的 `ARGENT_DATA_DIR` 规则判红）。
-REAL_DATA_DIR="$(env -i "HOME=$HOME" "PATH=$PATH" node -e \
-  'import(process.argv[1]).then(m=>process.stdout.write(m.resolveDataDir().dir))' \
-  "$REPO/core/lib/argent-datadir.mjs" 2>/dev/null)"
-[ -n "$REAL_DATA_DIR" ] || { echo "✗ 解析不出真实数据目录（缺 core/lib/argent-datadir.mjs？）—— 哨兵无法自证，演练中止" >&2; exit 2; }
-
-sentinel() {
-  local out="$1"
-  {
-    echo "# $(date -u +%FT%TZ) 真实目录哨兵（演练前后必须逐字节一致）｜数据目录=${REAL_DATA_DIR}"
-    for f in "$REAL_DATA_DIR/install.json" "$REAL_DATA_DIR/license.json" \
-             "$REAL_DATA_DIR/license.secret" "$REAL_DATA_DIR/skin.json" \
-             "$REAL_DATA_DIR/gateway.json" "$REAL_DATA_DIR/roles.json" \
-             "$HOME/.dsh/settings.yaml" "$HOME/.dsh/.credentials.yaml" \
-             "$HOME/.dsh/profiles/web/package.json" "$HOME/.dsh/profiles/web/cordis.patch.yml"; do
-      if [ -f "$f" ]; then printf '%s  %s\n' "$(shasum -a 256 "$f" | cut -c1-16)" "${f/#$HOME/~}"; else printf 'MISSING           %s\n' "${f/#$HOME/~}"; fi
-    done
-    for d in "$HOME/.dsh/skills" "$HOME/.dsh/.agent-presets"; do
-      if [ -d "$d" ]; then
-        printf 'DIR %s files=%s hash=%s\n' "${d/#$HOME/~}" \
-          "$(find "$d" -type f | wc -l | tr -d ' ')" \
-          "$(find "$d" -type f | LC_ALL=C sort | xargs shasum -a 256 2>/dev/null | shasum -a 256 | cut -c1-16)"
-      else printf 'DIR-MISSING       %s\n' "${d/#$HOME/~}"; fi
-    done
-    if [ -d "$HOME/.argent-dsh" ]; then
-      printf 'ARGENT-DSH head=%s dirty=%s files=%s\n' \
-        "$(git -C "$HOME/.argent-dsh" rev-parse --short HEAD 2>/dev/null || echo 非git)" \
-        "$(git -C "$HOME/.argent-dsh" status --porcelain 2>/dev/null | wc -l | tr -d ' ')" \
-        "$(find "$HOME/.argent-dsh" -type f -not -path '*/.git/*' | wc -l | tr -d ' ')"
-    else printf 'ARGENT-DSH MISSING\n'; fi
-  } > "$out" 2>/dev/null
-}
-sentinel "$FIX/sentinel-before.txt"
-node "$REPO/scripts/check-test-env-safety.mjs" --snapshot "$FIX/sentinel-datadir-before.json" >/dev/null 2>&1 || true
-note ""
-note "哨兵已拍：$FIX/sentinel-before.txt（+ 真实数据目录三层快照）"
-
-# ── 离线包（能力来源；不依赖克隆）───────────────────────────────────────────
-# 演练主线可多包（`--caps a,b`）：自 2026-10-09 起"一起装"是支持路径（E 步另有显式判据）。
-BUILD_CAPS="$CAPS,$GUARD_CAPS"   # 去重后逐个构建（重复目录会撞 --force 守卫）
-hdr "构建离线能力包（主线 --caps ${CAPS}；E 步多包 ${GUARD_CAPS}）"
-PACKARGS=""
-GUARDPACKARGS=""
-OLDIFS="$IFS"; IFS=','
-BUILT=","
-for cap in $BUILD_CAPS; do
-  IFS="$OLDIFS"
-  case "$BUILT" in *",$cap,"*) IFS=','; continue ;; esac
-  if [ -n "$cap" ]; then
-    if python3 "$REPO/scripts/capability_pack.py" --build "$cap" --out-dir "$FIX/packs/$cap" >"$FIX/packs/$cap.build.log" 2>&1; then
-      ok "$cap → $FIX/packs/${cap}（$(tail -1 "$FIX/packs/$cap.build.log" | sed 's/^ *//')）"
-      BUILT="$BUILT$cap,"
-    else
-      bad "$cap 打包失败，见 $FIX/packs/$cap.build.log"; tail -5 "$FIX/packs/$cap.build.log"
-    fi
-  fi
-  IFS=','
-done
-IFS="$OLDIFS"
-IFS=','
-for cap in $CAPS; do
-  IFS="$OLDIFS"; [ -n "$cap" ] || { IFS=','; continue; }
-  if [ -z "$PACKARGS" ]; then PACKARGS="$FIX/packs/$cap"; else PACKARGS="$PACKARGS,$FIX/packs/$cap"; fi
-  IFS=','
-done
-for cap in $GUARD_CAPS; do
-  IFS="$OLDIFS"; [ -n "$cap" ] || { IFS=','; continue; }
-  if [ -z "$GUARDPACKARGS" ]; then GUARDPACKARGS="$FIX/packs/$cap"; else GUARDPACKARGS="$GUARDPACKARGS,$FIX/packs/$cap"; fi
-  IFS=','
-done
-IFS="$OLDIFS"
-[ "$FAIL" = 0 ] || { echo "✗ 打包失败，演练中止"; exit 1; }
-
-one() {  # one <标签> <期望退出码> <参数…>
-  local label="$1" want="$2"; shift 2
-  local t0 t1
-  t0=$(date +%s)
-  "${RUN[@]}" node "$ONE" "$@" >"$FIX/run-$label.out" 2>&1
-  local rc=$?
-  t1=$(date +%s)
-  if [ "$rc" = "$want" ]; then ok "$label 退出码 ${rc}（期望 ${want}，耗时 $((t1-t0))s）"
-  else bad "$label 退出码 ${rc}（期望 ${want}）—— 见 $FIX/run-$label.out"; tail -25 "$FIX/run-$label.out"; fi
-  return 0
-}
-
-BASE=(--tree "$FIX/home/.argent-dsh" --dsh-home "$FIX/home/.dsh" --from-packs "$PACKARGS" --timeout "$TIMEOUT")
-
-# ── A. dry-run ─────────────────────────────────────────────────────────────
-hdr "A. dry-run（默认；必须零写入）"
-one A 0 "${BASE[@]}" --report "$FIX/report-A.json"
-if [ -e "$FIX/home/.dsh" ] || [ -e "$FIX/home/.argent-dsh" ]; then
-  bad "dry-run 竟然写了夹具（$FIX/home 下出现 .dsh/.argent-dsh）"
-else ok "dry-run 零写入（夹具 home 下没有 .dsh / .argent-dsh）"; fi
-
-# ── B. --apply（无许可）────────────────────────────────────────────────────
-hdr "B. --apply（无 --license-file ⇒ 许可段 skipped，不算失败）"
-one B 0 "${BASE[@]}" --apply --report "$FIX/report-B.json"
-[ -f "$FIX/home/.dsh/argent/install.json" ] && ok "装机清单在位：$FIX/home/.dsh/argent/install.json" \
-  || bad "装机清单不在位（--from-packs 装配判据）"
-[ -d "$FIX/home/.dsh/skills" ] && ok "技能已同步到夹具：$FIX/home/.dsh/skills（$(find "$FIX/home/.dsh/skills" -maxdepth 1 -mindepth 1 | wc -l | tr -d ' ') 项）" \
-  || bad "技能目录没生成（技能同步段判据）"
-TREE_HASH_B="$( { [ -d "$FIX/home/.argent-dsh" ] && find "$FIX/home/.argent-dsh" -type f; }  | LC_ALL=C sort | xargs shasum -a 256 2>/dev/null | shasum -a 256 | cut -c1-16)"
-
-# ── C. 重跑（幂等）─────────────────────────────────────────────────────────
-hdr "C. 重跑 --apply（幂等：逐段结论必须与 B 一致）"
-one C 0 "${BASE[@]}" --apply --report "$FIX/report-C.json"
-python3 - "$FIX/report-B.json" "$FIX/report-C.json" <<'PY' && ok "B/C 逐段状态一致（幂等）" || bad "B/C 逐段状态不一致（幂等被破）"
-import json,sys
-b=json.load(open(sys.argv[1])); c=json.load(open(sys.argv[2]))
-sb={s['id']:s['status'] for s in b['steps']}; sc={s['id']:s['status'] for s in c['steps']}
-if sb==sc: print('   B/C 状态：',sb)
-else:
-    print('   B:',sb); print('   C:',sc); sys.exit(1)
-PY
-TREE_HASH_C="$( { [ -d "$FIX/home/.argent-dsh" ] && find "$FIX/home/.argent-dsh" -type f; }  | LC_ALL=C sort | xargs shasum -a 256 2>/dev/null | shasum -a 256 | cut -c1-16)"
-[ "$TREE_HASH_B" = "$TREE_HASH_C" ] && ok "重跑后目标树逐字节不变（${TREE_HASH_C}）" \
-  || warn "重跑后目标树有变化（$TREE_HASH_B → ${TREE_HASH_C}）—— 逐条比对是 churn 还是缺陷"
-
-# ── D. 只跑许可段（夹具许可）───────────────────────────────────────────────
-hdr "D. --only license --apply（夹具密钥自签的许可；验的是「许可段能不能真装」）"
-SECRET="$FIX/fixture-license-secret"
-printf '%s' 'drill-fixture-secret-not-a-real-key' > "$SECRET"; chmod 600 "$SECRET"
-if "${RUN[@]}" node "$REPO/scripts/self-sign-license.mjs" --user drill-fixture --secret-file "$SECRET" \
-      --out "$FIX/fixture-license.json" --sign-v2 --device-from-local --cap full --seats 1 --days 30 \
-      >"$FIX/selfsign.out" 2>&1; then
-  ok "夹具许可已自签：$FIX/fixture-license.json（夹具密钥，⛔ 不是任何真实环境的密钥）"
-else bad "夹具许可自签失败，见 $FIX/selfsign.out"; tail -5 "$FIX/selfsign.out"; fi
-one D 0 --tree "$FIX/home/.argent-dsh" --dsh-home "$FIX/home/.dsh" \
-        --license-file "$FIX/fixture-license.json" --license-secret-file "$SECRET" \
-        --only license --apply --report "$FIX/report-D.json"
-[ -f "$FIX/home/.dsh/argent/license.json" ] && ok "许可已落到夹具数据目录（真实数据目录不动）" \
-  || bad "许可没落盘（许可段判据）"
-
-# ── F. 在线装配面（本地镜像克隆；零网络；无包管理器 ⇒ 走安装器既有"直拷"回退）──────
-hdr "F. 在线装配面（ARGENT_REPO_URL=file://<仓库>，零网络；无包管理器 ⇒ 直拷回退）"
-note "  ⛔ 全程不跑 pnpm：夹具 PATH 里没有 pnpm/npm/corepack ⇒ 安装器走它自己的回退分支。"
-note "  ⚠️ 该回退曾**不可达**（ensurePnpm 的 \`npm install -g pnpm\` 不在 try 里 ⇒ spawn npm ENOENT 未捕获崩），"
-note "     2026-10-05 已修（install-argent.mjs，见文档「失败与修法」）。"
-one F 0 --tree "$FIX/home-f/.argent-dsh" --dsh-home "$FIX/home-f/.dsh" --profile web \
-       --skip-provider --no-venv --apply --report "$FIX/report-F.json"
-[ -f "$FIX/home-f/.dsh/profiles/web/cordis.patch.yml" ] && ok "在线面产物：profile patch 在位（profiles/web/cordis.patch.yml）" \
-  || bad "在线面产物缺失：profiles/web/cordis.patch.yml"
-[ -d "$FIX/home-f/.dsh/.agent-presets" ] && ok "在线面产物：角色已落位（.agent-presets/$(ls "$FIX/home-f/.dsh/.agent-presets" | head -3 | tr '\n' ' ')）" \
-  || warn "在线面没落 preset（机制可能不是目录式；见 report-F.json）"
-[ -d "$FIX/home-f/.argent-dsh/plugins" ] && ok "在线面克隆到夹具树：$FIX/home-f/.argent-dsh（$(find "$FIX/home-f/.argent-dsh" -maxdepth 1 -mindepth 1 | wc -l | tr -d ' ') 个顶层条目）" \
-  || bad "在线面没克隆出树"
-
-# ── E. 多包一起装（2026-10-09 起**支持**，本步验证它真能装成）────────────────
-hdr "E. 多包一起装 --from-packs ${GUARD_CAPS}（期望退出码 0；注册表 = 两份投影的并集）"
-# ⚠ 必须用**全新**的树/home：B 已把主线能力铺好，复用会让安装器走"升级"路径，测不到"首次多包装"。
-one E 0 --tree "$FIX/home-e/.argent-dsh" --dsh-home "$FIX/home-e/.dsh" --profile web \
-       --from-packs "$GUARDPACKARGS" --apply --report "$FIX/report-E.json"
-# 判据三条：① 不再报"多包校验失败"；② 装机清单里两个能力都在且 integrity=verified；③ 盘上注册表是并集
-if grep -q "多包校验失败" "$FIX/run-E.out"; then
-  bad "多包一起装仍被拦下（见 $FIX/run-E.out）；拦下原因：$(grep -m1 '多包校验失败' "$FIX/run-E.out" | sed 's/^ *· *//')"
-else
-  ok "不再报「多包校验失败」（注册表投影已被判据豁免：计划阶段与落盘阶段同一个 isRegistryProjection()）"
-fi
-python3 - "$FIX/home-e/.dsh/argent/install.json" "$FIX/home-e/.argent-dsh/scripts/flow-requirements.json" <<'PY'
-import json, os, sys
-ij, reg = sys.argv[1], sys.argv[2]
-if not os.path.exists(ij):
-    print(f'  ✗ 装机清单不在位：{ij}'); sys.exit(1)
-doc = json.load(open(ij))
-caps = {c['id']: c.get('integrity') for c in doc.get('capabilities', [])}
-want = {'full', 'invoice'}
-if want <= set(caps):
-    print(f"  ✅ 装机清单两个能力都在（{', '.join(f'{k}={v}' for k, v in sorted(caps.items()))}）")
-else:
-    print(f"  ✗ 装机清单缺能力：{sorted(want - set(caps))}（实际 {sorted(caps)}）"); sys.exit(1)
-if all(caps[k] == 'verified' for k in want):
-    print('  ✅ 两个能力的 integrity 都是 verified')
-else:
-    print(f"  ✗ integrity 不是全 verified：{caps}"); sys.exit(1)
-if not os.path.exists(reg):
-    print(f'  ✗ 盘上注册表不在位：{reg}'); sys.exit(1)
-d = json.load(open(reg))
-c = sorted(d.get('capabilities') or {})
-if {'full', 'invoice'} <= set(c):
-    print(f"  ✅ 盘上注册表 = 两份投影的并集（capabilities：{', '.join(c)}）")
-else:
-    print(f"  ✗ 注册表缺能力条目（实际 {c}）—— 并集没写成"); sys.exit(1)
-PY
-[ "$?" = 0 ] || bad "E 步判据未过（装机清单 / 注册表并集，见上）"
-
-# ── 哨兵比对 ───────────────────────────────────────────────────────────────
-hdr "哨兵：真实目录零变化"
-sentinel "$FIX/sentinel-after.txt"
-tail -n +2 "$FIX/sentinel-before.txt" > "$FIX/sentinel-before.body"
-tail -n +2 "$FIX/sentinel-after.txt"  > "$FIX/sentinel-after.body"
-if diff -u "$FIX/sentinel-before.body" "$FIX/sentinel-after.body" > "$FIX/sentinel.diff" 2>&1; then
-  ok "真实目录哨兵逐字节一致（$FIX/sentinel-before.txt）"
-else
-  bad "真实目录哨兵有变化（本次演练本应零写入）："; cat "$FIX/sentinel.diff"
-fi
-if node "$REPO/scripts/check-test-env-safety.mjs" --verify "$FIX/sentinel-datadir-before.json" >"$FIX/sentinel-datadir.out" 2>&1; then
-  ok "真实数据目录三层判据（关键文件/新增文件/配置内容）无本次演练引起的改动"
-else
-  warn "真实数据目录有变化（可能是常驻服务的正常写入；逐条判断）："; tail -12 "$FIX/sentinel-datadir.out"
-fi
-
-# ── 汇总 ───────────────────────────────────────────────────────────────────
-hdr "汇总"
-python3 - "$FIX" <<'PY'
-import json,os,sys
-fix=sys.argv[1]
-for tag in ('A','B','C','D','E','F'):
-    p=os.path.join(fix,f'report-{tag}.json')
-    if not os.path.exists(p): print(f'  {tag}: （无报告）'); continue
-    d=json.load(open(p))
-    st={s['id']:s['status'] for s in d['steps']}
-    print(f"  {tag}: ok={d['ok']} mode={d['mode']} 耗时={d['elapsedSeconds']}s 逐段={st}")
-    print(f"      装配={d['segments']['install']}")
-    print(f"      技能={d['segments']['skills']}")
-    print(f"      许可={d['segments']['license']}")
-    print(f"      自检={d['selfCheck']}")
-PY
-note ""
-if [ "$FAIL" = 0 ]; then
-  note "✅ 演练全部符合预期（夹具：${FIX}）"
-else
-  note "✗ 演练有不符合预期项（夹具：${FIX}）—— 逐条见上"
-fi
-if [ "$KEEP" = 0 ] && [ "$FAIL" = 0 ]; then rm -rf "$FIX"; note "（夹具已清理；要留证据加 --keep）"; else note "（夹具保留：${FIX}）"; fi
-exit "$FAIL"

package/engine/scripts/install-internal-role.sh

@@ -1,190 +0,0 @@
-#!/usr/bin/env bash
-# ══════════════════════════════════════════════════════════════════════════════
-# install-internal-role.sh — 协作者内置角色一键装配（KB-078 短期路径）
-#
-# 用途：在同事 PC 上执行后，获得「内置角色」完整开发环境（preset + skill +
-#       默认 preset 配置），让协作者本周即可开工官网/项目开发。
-#
-# 使用方式（需先安装 Argent，安装器见 https://whyshu.com/dl/install-argent.mjs）：
-#   bash install-internal-role.sh --role whyshu-web-dev     # 装配官网开发者角色
-#   bash install-internal-role.sh --role pet-dev             # 预留：云宠乐园开发者
-#   bash install-internal-role.sh --role argent-dev          # 预留：Argent 开发者
-#   bash install-internal-role.sh --role whyshu-web-dev --dry-run   # 只打印计划，不执行
-#   bash install-internal-role.sh --role whyshu-web-dev --repo /path/to/argent-dsh  # 指定仓库源
-#
-# 本脚本做什么：
-#   1. 从 argent-dsh 仓库复制角色 preset → ~/.dsh/.agent-presets/argent-<role>/
-#      （agent.cordis.yml + preset.yml + format-version.txt）
-#   2. 复制角色 skill → ~/.dsh/skills/<role>/（SKILL.md，若仓库存在该角色技能）
-#   3. 写入/更新 ~/.dsh/settings.yaml 的 agent-presets.default = argent-<role>
-#      （新会话默认挂载该角色 preset）
-#   4. 幂等：重复执行不重复拷贝、不破坏已有配置；输出成功清单
-#
-# 说明（决策㉛㉜㉝）：
-#   - 不注册飞书 Bot（真人驱动模式：人 @ 使用，不配独立 Bot/事件订阅）
-#   - 部署走 GitHub Actions（协作者无服务器权限，push main 自动部署官网）
-#   - 源仓库定位顺序：--repo 参数 > ${ARGENT_REPO} > ~/.argent-dsh（git clone）>
-#     ~/Code/argent-dsh > 脚本自身所在目录的上级
-# ══════════════════════════════════════════════════════════════════════════════
-set -euo pipefail
-
-# ── 参数 ──────────────────────────────────────────────────────────────────────
-ROLE=""
-DRY_RUN=0
-SOURCE=""
-
-usage() {
-  sed -n '2,20p' "$0" | sed 's/^# \{0,1\}//'
-  exit 0
-}
-
-while [[ $# -gt 0 ]]; do
-  case "$1" in
-    --role) ROLE="${2:-}"; shift 2 ;;
-    --dry-run) DRY_RUN=1; shift ;;
-    --repo) SOURCE="${2:-}"; shift 2 ;;
-    -h|--help) usage ;;
-    *) echo "✗ 未知参数: $1"; usage ;;
-  esac
-done
-
-if [[ -z "${ROLE}" ]]; then
-  echo "✗ 缺少 --role 参数（如 --role whyshu-web-dev）"
-  usage
-fi
-
-# ── 路径 ──────────────────────────────────────────────────────────────────────
-DSH_HOME="${DSH_HOME:-${HOME}/.dsh}"
-PRESET_TARGET="${DSH_HOME}/.agent-presets/argent-${ROLE}"
-SKILL_TARGET="${DSH_HOME}/skills/${ROLE}"
-SETTINGS="${DSH_HOME}/settings.yaml"
-
-# 源仓库定位
-if [[ -z "${SOURCE}" ]]; then
-  for cand in "${ARGENT_REPO:-}" "${HOME}/.argent-dsh" "${HOME}/Code/argent-dsh" "$(cd "$(dirname "$0")/.." && pwd)"; do
-    if [[ -n "$cand" && -d "$cand/presets" && -d "$cand/scripts" ]]; then
-      SOURCE="$cand"
-      break
-    fi
-  done
-fi
-if [[ -z "${SOURCE}" || ! -d "${SOURCE}/presets" ]]; then
-  echo "✗ 未找到 argent-dsh 仓库源（可用 --repo <路径> 指定）"
-  exit 1
-fi
-echo "· 源仓库: ${SOURCE}"
-
-PRESET_SRC="${SOURCE}/presets/argent-${ROLE}"
-if [[ ! -d "${PRESET_SRC}" ]]; then
-  echo "✗ 仓库中不存在角色 preset: presets/argent-${ROLE}（可用 --role whyshu-web-dev / pet-dev / argent-dev 等）"
-  exit 1
-fi
-SKILL_SRC="${SOURCE}/skills/${ROLE}"
-
-# ── 计划 ──────────────────────────────────────────────────────────────────────
-plan_preset="复制 preset → ${PRESET_TARGET}"
-plan_skill="无 skill 可复制"
-if [[ -d "${SKILL_SRC}" && -f "${SKILL_SRC}/SKILL.md" ]]; then
-  plan_skill="复制 skill → ${SKILL_TARGET}"
-fi
-plan_settings="设置 agent-presets.default = argent-${ROLE}（${SETTINGS}）"
-
-echo
-echo "装配计划（角色 ${ROLE}）："
-echo "  1. $plan_preset"
-echo "  2. $plan_skill"
-echo "  3. $plan_settings"
-echo
-
-# ── 执行 ──────────────────────────────────────────────────────────────────────
-done_list=()
-skip_list=()
-
-copy_dir() { # src dst label —— 幂等：已存在且内容一致则跳过
-  local src="$1" dst="$2" label="$3"
-  if [[ -d "$dst" ]] && diff -rq "$src" "$dst" >/dev/null 2>&1; then
-    skip_list+=("$label 已存在且一致（幂等跳过）")
-  else
-    mkdir -p "$(dirname "$dst")"
-    if [[ -d "$dst" ]]; then rm -rf "$dst"; fi
-    cp -R "$src" "$dst"
-    if diff -rq "$src" "$dst" >/dev/null 2>&1; then
-      done_list+=("$label → $dst")
-    else
-      echo "✗ $label 复制后校验不一致: $dst"
-      exit 1
-    fi
-  fi
-}
-
-# 1) preset
-echo "① preset"
-if [[ ${DRY_RUN} -eq 1 ]]; then
-  echo "   [dry-run] $plan_preset"
-else
-  copy_dir "${PRESET_SRC}" "${PRESET_TARGET}" "preset argent-${ROLE}"
-fi
-
-# 2) skill
-echo "② skill"
-if [[ -d "${SKILL_SRC}" && -f "${SKILL_SRC}/SKILL.md" ]]; then
-  if [[ ${DRY_RUN} -eq 1 ]]; then
-    echo "   [dry-run] $plan_skill"
-  else
-    copy_dir "${SKILL_SRC}" "${SKILL_TARGET}" "skill ${ROLE}"
-  fi
-else
-  echo "   · 仓库无 ${ROLE} 技能目录（跳过；preset 内已含能力定义）"
-fi
-
-# 3) settings.yaml（node 处理：幂等 + 备份）
-echo "③ settings.yaml"
-if [[ ${DRY_RUN} -eq 1 ]]; then
-  echo "   [dry-run] $plan_settings"
-else
-  if command -v node >/dev/null 2>&1; then
-    if [[ -f "${SETTINGS}" ]]; then
-      cp "${SETTINGS}" "${SETTINGS}.bak-$(date +%Y%m%d%H%M%S)" 2>/dev/null || true
-    fi
-    out=$(node -e '
-      const fs = require("fs");
-      const path = process.argv[1], want = "argent-" + process.argv[2];
-      let t = ""; try { t = fs.readFileSync(path, "utf8"); } catch {}
-      if (!/agent-presets:/.test(t)) {
-        t = t.trimEnd() + "\n\nagent-presets:\n  default: " + want + "\n";
-        fs.writeFileSync(path, t);
-        console.log("新增 agent-presets.default = " + want);
-      } else if (new RegExp("^\\s*default:\\s*" + want + "\\s*$", "m").test(t)) {
-        console.log("已是目标值（幂等跳过）");
-      } else {
-        const before = t;
-        t = t.replace(/^(\s*default:)(\s*)(\S*)(\s*)$/m, "$1$2" + want + "$4");
-        if (t === before) { console.log("agent-presets 段无 default 行，追加"); t = t.trimEnd() + "\n  default: " + want + "\n"; }
-        fs.writeFileSync(path, t);
-        console.log("更新 agent-presets.default = " + want);
-      }
-    ' "${SETTINGS}" "${ROLE}")
-    echo "   · $out"
-    if [[ "$out" == *"幂等跳过"* ]]; then
-      skip_list+=("settings.yaml 已是目标值（幂等跳过）")
-    else
-      done_list+=("settings.yaml agent-presets.default = argent-${ROLE}")
-    fi
-  else
-    echo "   ✗ 未找到 node（Argent 环境需 Node.js，请先安装）"
-    exit 1
-  fi
-fi
-
-# ── 成功清单 ──────────────────────────────────────────────────────────────────
-echo
-if [[ ${DRY_RUN} -eq 1 ]]; then
-  echo "✅ [dry-run] 计划完成（未做任何改动）。去掉 --dry-run 执行装配。"
-  exit 0
-fi
-echo "✅ 装配完成（角色 ${ROLE}）"
-for s in "${done_list[@]}"; do echo "  ✔ $s"; done
-for s in "${skip_list[@]}"; do echo "  · $s"; done
-echo
-echo "下一步：重新打开 Argent 会话（新会话默认挂载 argent-${ROLE} preset），即可开始开发。"
-echo "说明：未注册飞书 Bot（真人驱动模式）；部署走 GitHub Actions，无需服务器权限。"