HomeAgent/scripts/migrate-plugins-to-org.sh

#!/usr/bin/env bash
# 把 SDK 仓 example/ 下的示例插件迁移到 GitHub 组织下成为**独立仓库**。
#
# 用法：
#   scripts/migrate-plugins-to-org.sh [--dry-run] [--only name1,name2]
#
# 环境：
#   GH_ORG_TOKEN  fine-grained PAT，Resource owner = 目标组织，
#                 带 Repository permissions: Administration(Write) 或
#                 Repository creation(Write) + Contents(Write)
#   GH_ORG       目标组织名（默认 HologramAgent）
#
# 为什么这么做：
#   插件散落在 SDK 仓 example/ 下有三个问题：
#     ① 插件版本与 SDK 版本绑死（一次 SDK 发版把所有插件都带上）
#     ② 插件作者不能单独为自己的插件开发/发版（都在别人的仓里）
#     ③ plugin_update 需要「仓库地址 → 拉源码 → 编译」，而
#        example/ 是别人的仓库，不是插件自己的仓库
#
# 纪律：
#   1. 默认 --dry-run：只打印会做什么，不碰 GitHub。
#   2. 产物不入库：dist/ build/ rawfile/ node_modules/ *.hmap 全部排除
#      （实测源码 3MB，产物 1.9G —— 后者进了仓库就再也删不干净）
#   3. 测试与 go.sum 保留：它们是仓库的一部分，不是产物。
set -euo pipefail

DRY=0
ONLY=""
for arg in "$@"; do
	case "$arg" in
	--dry-run) DRY=1 ;;
	--only)
		shift
		ONLY="${1:-}"
		;;
	*)
		echo "未知参数: $arg" >&2
		exit 2
		;;
	esac
	shift || true
done

ROOT="$(cd "$(dirname "$0")/.." && pwd)"
EXAMPLES="$ROOT/third_party/hologramagentsdk/example"
GH_ORG="${GH_ORG:-HologramAgent}"
TOKEN="${GH_ORG_TOKEN:-}"

if [ "$DRY" -eq 0 ] && [ -z "$TOKEN" ]; then
	echo "ERROR: 非 dry-run 需要 GH_ORG_TOKEN" >&2
	exit 2
fi

api() {
	# $1=method $2=path $3=payload(optional)
	local method="$1" path="$2" payload="${3:-}"
	if [ -n "$payload" ]; then
		curl -sS -X "$method" \
			-H "Authorization: Bearer $TOKEN" \
			-H "Accept: application/vnd.github+json" \
			"https://api.github.com${path}" -d "$payload"
	else
		curl -sS -X "$method" \
			-H "Authorization: Bearer $TOKEN" \
			-H "Accept: application/vnd.github+json" \
			"https://api.github.com${path}"
	fi
}

created=0
pushed=0
skipped=0

for dir in "$EXAMPLES"/*/; do
	name="$(basename "$dir")"
	if [ -n "$ONLY" ]; then
		case ",$ONLY," in *",$name,"*) ;; *) continue ;; esac
	fi

	# 入口判据：Go 插件是 plugin.go，Lua 插件是 main.lua（与 build-examples.sh 同）
	if [ ! -f "$dir/plugin.go" ] && [ ! -f "$dir/main.lua" ]; then
		continue
	fi
	desc=$(python3 -c "import json,sys;print(json.load(open('$dir/plg.json')).get('description',''))" 2>/dev/null || echo "")
	ver=$(python3 -c "import json,sys;print(json.load(open('$dir/plg.json')).get('version',''))" 2>/dev/null || echo "")

	echo ""
	echo "── $name (v$ver) ──"
	echo "   desc: ${desc:0:60}"

	if [ "$DRY" -eq 1 ]; then
		echo "   [dry-run] 将创建仓库 $GH_ORG/$name 并推送源码（排除 dist/build/rawfile/node_modules）"
		continue
	fi

	# ① 创建仓库（已存在则跳过 —— 幂等，重跑安全）
	code=$(curl -s -o /tmp/ghresp -w "%{http_code}" -X POST \
		-H "Authorization: Bearer $TOKEN" -H "Accept: application/vnd.github+json" \
		https://api.github.com/orgs/$GH_ORG/repos \
		-d "{\"name\":\"$name\",\"private\":false,\"description\":\"$desc\",\"has_issues\":true}")
	if [ "$code" = "201" ]; then
		echo "   ✓ 仓库已创建"
		created=$((created + 1))
	elif [ "$code" = "422" ]; then
		echo "   · 仓库已存在（跳过创建）"
		skipped=$((skipped + 1))
	else
		echo "   ✗ 创建失败 HTTP=$code: $(head -c 200 /tmp/ghresp)"
		continue
	fi

	# ② 准备干净的源码副本
	#
	# 用 tar 管道而不是 rsync/cp -r：rsync 在最小化系统里常常没有
	# （本机实测就是），而 cp -r 无法精确排除多类产物。
	# --exclude 用**不带前导斜杠**的形态，匹配任意层级同名目录。
	work=$(mktemp -d)
	mkdir -p "$work/$name"
	(cd "$dir" && tar -cf - \
		--exclude='dist' --exclude='build' --exclude='rawfile' \
		--exclude='node_modules' --exclude='*.hmap' --exclude='.git' \
		.) | (cd "$work/$name" && tar -xf -)

	# plg.json 里补 repository 字段，让装好的插件能反过来找到自己的仓库
	# （plugin_update 靠它拉源码；不填的话插件永远无法自动更新）
	python3 - "$work/$name/plg.json" "https://github.com/$GH_ORG/$name" <<'PY'
import json, sys
path, repo = sys.argv[1], sys.argv[2]
d = json.load(open(path))
d["repo"] = repo
json.dump(d, open(path, "w"), indent=2, ensure_ascii=False)
open(path, "a").write("\n")
PY

	# 每个独立仓库都要有自己的 README 与 LICENSE 指引
	cat >"$work/$name/README.md" <<EOF
# $name

$desc

HologramAgent 插件，随 SDK \`${ver:-?}\` 的示例插件拆分而来。

## 构建

\`\`\`bash
hmapdev build
\`\`\`

产物 \`dist/${name}_bundle.hmap\` 经 \`plugin_install\` 安装。

## 自动更新

本仓库地址登记在 \`plg.json\` 的 \`repo\` 字段，安装后随产物写入
\`plugin.json\` 的 \`repository\` 字段 —— 内核的 \`plugin_update\` 靠它
从本仓库拉最新源码并重编安装。
EOF

	# ③ 推送
	(
		cd "$work/$name"
		git init -q
		git checkout -q -b main
		git add -A
		git -c user.name="$GH_ORG" -c user.email="$GH_ORG@users.noreply.github.com" \
			commit -q -m "feat: 从 SDK example/ 迁移为独立仓库

保留全部源码与测试（dist/build/rawfile/node_modules 等产物不入库）。
plg.json 补 repo 字段，使 plugin_update 能定位本仓库。"
		git remote add origin "https://x-access-token:$TOKEN@github.com/$GH_ORG/$name.git"
		git push -q origin main 2>&1 | tail -1 || echo "   ✗ 推送失败（见上）"
	)
	echo "   ✓ 已推送"
	pushed=$((pushed + 1))
	rm -rf "$work"
done

echo ""
echo "=== 完成 ==="
echo "  创建仓库: $created / 已存在: $skipped / 推送成功: $pushed"