@whyshu/argent-engine 0.0.0-stage → 0.6.1

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

@@ -0,0 +1,190 @@
+#!/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，无需服务器权限。"