mirror of
https://github.com/kiddin9/op-packages.git
synced 2026-11-21 07:53:09 +08:00
168 lines
8.3 KiB
Bash
Executable File
168 lines
8.3 KiB
Bash
Executable File
#!/bin/sh
|
|
# 发布通道与版本锁定的选择逻辑。
|
|
#
|
|
# 两层都要校验:
|
|
# - Shell: openclaw-env 的 resolve_target_version 把 OC_VERSION / OC_CHANNEL / UCI pin_version /
|
|
# 上游 dist-tag 组合后交给 openclaw-package-contract.js resolve-target
|
|
# - Lua: controller 的 parse_version_selection 对前端参数做白名单校验,之后才拼入 shell
|
|
# 约束: 默认只安装已验证版本;上游更新只提示;未验证版本必须显式允许;
|
|
# registry 不可达时不影响安装已验证版本;非法输入失败关闭。
|
|
set -eu
|
|
|
|
SCRIPT_DIR=$(CDPATH= cd -- "$(dirname "$0")" && pwd)
|
|
REPO_ROOT=$(CDPATH= cd -- "$SCRIPT_DIR/.." && pwd)
|
|
ENV_SCRIPT="$REPO_ROOT/root/usr/bin/openclaw-env"
|
|
CONTRACT_JS="$REPO_ROOT/root/usr/share/openclaw/openclaw-package-contract.js"
|
|
REAL_COMPAT="$REPO_ROOT/root/usr/share/openclaw/openclaw-compat.json"
|
|
CONTROLLER="$REPO_ROOT/luasrc/controller/openclaw.lua"
|
|
|
|
fail() {
|
|
echo "FAIL: $1" >&2
|
|
exit 1
|
|
}
|
|
|
|
# ── 静态: 前端参数必须先过白名单 ──
|
|
grep -Fq 'local function parse_version_selection' "$CONTROLLER" || fail "controller must validate version selection"
|
|
grep -Fq 'pin:match("^%d+%.%d+%.%d+$")' "$CONTROLLER" || fail "controller must whitelist pinned versions"
|
|
grep -Fq 'channel ~= "extended-stable" and channel ~= "latest"' "$CONTROLLER" || fail "controller must whitelist channels"
|
|
grep -Fq 'OC_CHANNEL=" .. shellquote(sel.channel)' "$CONTROLLER" || fail "controller must shell-quote the channel"
|
|
grep -Fq 'OC_VERSION=" .. shellquote(sel.pin)' "$CONTROLLER" || fail "controller must shell-quote the pinned version"
|
|
|
|
NODE_BIN=$(command -v node 2>/dev/null || true)
|
|
[ -n "$NODE_BIN" ] || { echo "ok (static only: no node interpreter available)"; exit 0; }
|
|
|
|
WORK=$(mktemp -d)
|
|
trap 'rm -rf "$WORK"' EXIT INT TERM
|
|
mkdir -p "$WORK/bin"
|
|
|
|
# fixture 矩阵,与真实版本号解耦
|
|
COMPAT="$WORK/compat.json"
|
|
"$NODE_BIN" -e '
|
|
const fs = require("fs");
|
|
const base = JSON.parse(fs.readFileSync(process.argv[1], "utf8"));
|
|
const v = (channel) => ({ channel, engines: ">=24.22.1 <25", integrity: "sha512-x", unpackedSize: 1, sqliteVec: "0.1.9", verification: {} });
|
|
fs.writeFileSync(process.argv[2], JSON.stringify({
|
|
schema: 1, node: base.node, lifecycle: base.lifecycle, defaultChannel: "extended-stable",
|
|
channels: { "extended-stable": { verified: "2030.1.5" }, latest: { verified: "2030.2.3" } },
|
|
versions: { "2030.1.5": v("extended-stable"), "2030.2.3": v("latest"), "2029.12.1": v("legacy") }
|
|
}));' "$REAL_COMPAT" "$COMPAT"
|
|
|
|
# uci / npm 替身
|
|
cat > "$WORK/bin/uci" <<'EOF'
|
|
#!/bin/sh
|
|
[ -n "${MOCK_UCI_PIN:-}" ] && { echo "$MOCK_UCI_PIN"; exit 0; }
|
|
exit 1
|
|
EOF
|
|
cat > "$WORK/bin/npm" <<'EOF'
|
|
#!/bin/sh
|
|
[ -n "${MOCK_DISTTAGS:-}" ] && { echo "$MOCK_DISTTAGS"; exit 0; }
|
|
echo "npm ERR! network" >&2
|
|
exit 1
|
|
EOF
|
|
chmod +x "$WORK/bin/uci" "$WORK/bin/npm"
|
|
|
|
HARNESS="$WORK/harness.sh"
|
|
{
|
|
echo 'log_info() { :; }; log_warn() { echo "WARN: $*" >&2; }; log_error() { echo "ERROR: $*" >&2; }'
|
|
for fn in fetch_upstream_disttags upstream_disttag compat_default_channel resolve_target_version; do
|
|
awk -v fn="$fn" '$0 ~ "^"fn"\\(\\) \\{" { grab = 1 } grab { print } grab && /^}/ { exit }' "$ENV_SCRIPT"
|
|
done
|
|
cat <<'EOF'
|
|
resolve_target_version || exit $?
|
|
echo "$OC_TARGET_VER $OC_TARGET_CHANNEL $OC_TARGET_VERIFIED $OC_TARGET_NEWER ${OC_TARGET_UPSTREAM:--}"
|
|
EOF
|
|
} > "$HARNESS"
|
|
for fn in fetch_upstream_disttags upstream_disttag compat_default_channel resolve_target_version; do
|
|
grep -q "^${fn}() {" "$HARNESS" || fail "cannot extract $fn from openclaw-env"
|
|
done
|
|
|
|
# 用法: resolve 环境赋值... (每次独立子进程,变量不会泄漏到后续用例)
|
|
resolve() {
|
|
env PATH="$WORK/bin:$PATH" NODE_BIN="$NODE_BIN" NPM_BIN="$WORK/bin/npm" OC_PACKAGE_CONTRACT="$CONTRACT_JS" \
|
|
OC_COMPAT_FILE="$COMPAT" OC_CHANNEL="" OC_VERSION="" OC_ALLOW_UNVERIFIED=0 "$@" sh "$HARNESS" 2>"$WORK/err"
|
|
}
|
|
expect() {
|
|
_want="$1"; shift
|
|
_got=$(resolve "$@") || { cat "$WORK/err" >&2; fail "resolve [$*] should succeed"; }
|
|
[ "$_got" = "$_want" ] || fail "resolve [$*]: expected '$_want', got '$_got'"
|
|
}
|
|
expect_reject() {
|
|
if resolve "$@" >/dev/null; then fail "resolve [$*] must be rejected"; fi
|
|
}
|
|
TAGS='MOCK_DISTTAGS={"latest":"2030.2.9","extended-stable":"2030.1.5"}'
|
|
|
|
# 默认: 长期稳定通道的已验证版本
|
|
expect "2030.1.5 extended-stable verified same 2030.1.5" "$TAGS"
|
|
# 通道来源: OC_CHANNEL (UCI 保存值由前端传入) 与 OC_VERSION 别名
|
|
expect "2030.2.3 latest verified newer 2030.2.9" "$TAGS" OC_CHANNEL=latest
|
|
expect "2030.2.3 latest verified newer 2030.2.9" "$TAGS" OC_VERSION=latest
|
|
expect "2030.1.5 extended-stable verified same 2030.1.5" "$TAGS" OC_VERSION=stable
|
|
# 显式允许才安装未验证的上游新版
|
|
expect "2030.2.9 latest unverified newer 2030.2.9" "$TAGS" OC_CHANNEL=latest OC_ALLOW_UNVERIFIED=1
|
|
# registry 不可达: 仍可安装已验证版本,并提示
|
|
expect "2030.1.5 extended-stable verified same -"
|
|
grep -q '无法查询上游' "$WORK/err" || fail "unreachable registry must be reported"
|
|
expect "2030.2.3 latest verified same -" OC_CHANNEL=latest OC_ALLOW_UNVERIFIED=1
|
|
# 锁定版本: OC_VERSION 优先于 UCI,UCI 优先于通道,锁定时不查询上游
|
|
expect "2029.12.1 legacy verified same -" OC_VERSION=2029.12.1
|
|
expect "2029.12.1 legacy verified same -" MOCK_UCI_PIN=2029.12.1 OC_CHANNEL=latest
|
|
expect "2030.1.5 extended-stable verified same -" MOCK_UCI_PIN=2029.12.1 OC_VERSION=2030.1.5
|
|
expect_reject OC_VERSION=2030.3.1
|
|
expect "2030.3.1 pinned unverified same -" OC_VERSION=2030.3.1 OC_ALLOW_UNVERIFIED=1
|
|
# 非法输入失败关闭
|
|
expect_reject OC_VERSION=not-a-version
|
|
expect_reject 'OC_VERSION=1.2.3;id'
|
|
expect_reject OC_CHANNEL=nightly
|
|
expect_reject OC_COMPAT_FILE="$WORK/missing.json"
|
|
# 畸形 dist-tag 不得被当作版本使用
|
|
expect "2030.2.3 latest verified same -" 'MOCK_DISTTAGS={"latest":"$(id)"}' OC_CHANNEL=latest OC_ALLOW_UNVERIFIED=1
|
|
|
|
# ── Lua: parse_version_selection (CI 安装了 lua5.1;本机无解释器时跳过) ──
|
|
lua_bin=""
|
|
for cand in lua5.1 lua luajit; do
|
|
command -v "$cand" >/dev/null 2>&1 && { lua_bin="$cand"; break; }
|
|
done
|
|
if [ -z "$lua_bin" ]; then
|
|
echo "ok (Lua checks skipped: interpreter unavailable)"
|
|
exit 0
|
|
fi
|
|
{
|
|
cat <<'EOF'
|
|
local function shellquote(s) return "'" .. tostring(s):gsub("'", "'\\''") .. "'" end
|
|
EOF
|
|
awk '/^local function parse_version_selection/,/^end$/' "$CONTROLLER"
|
|
awk '/^local function version_env_prefix/,/^end$/' "$CONTROLLER"
|
|
cat <<'EOF'
|
|
local saved = ""
|
|
package.loaded["luci.model.uci"] = { cursor = function() return { get = function() return saved end } end }
|
|
local function check(cond, msg) if not cond then io.stderr:write("FAIL: " .. msg .. "\n"); os.exit(1) end end
|
|
local s = parse_version_selection("", "", "", "")
|
|
check(s.channel == "extended-stable" and s.pin == "" and s.allow == false, "default channel")
|
|
s = parse_version_selection("latest", "", "", "1")
|
|
check(s.channel == "latest" and s.allow == true, "explicit channel and allow")
|
|
s = parse_version_selection("", "", "stable", "")
|
|
check(s.channel == "extended-stable", "legacy stable alias")
|
|
s = parse_version_selection("", "", "latest", "")
|
|
check(s.channel == "latest", "legacy latest alias")
|
|
s = parse_version_selection("", "", "v2026.9.1", "")
|
|
check(s.pin == "2026.9.1", "legacy exact version becomes pin")
|
|
s = parse_version_selection("", "v2026.9.36", "", "")
|
|
check(s.pin == "2026.9.36", "pin strips v prefix")
|
|
saved = "latest"
|
|
s = parse_version_selection("", "", "", "")
|
|
check(s.channel == "latest", "falls back to the saved UCI channel")
|
|
saved = ""
|
|
check(parse_version_selection("nightly", "", "", "") == nil, "unknown channel rejected")
|
|
check(parse_version_selection("", "1.2.3;id", "", "") == nil, "shell metacharacters in pin rejected")
|
|
check(parse_version_selection("$(id)", "", "", "") == nil, "shell metacharacters in channel rejected")
|
|
check(parse_version_selection("", "2026.9", "", "") == nil, "incomplete pin rejected")
|
|
local p = version_env_prefix({ channel = "latest", pin = "2026.9.1", allow = true })
|
|
check(p:find("OC_CHANNEL='latest'", 1, true) and p:find("OC_VERSION='2026.9.1'", 1, true) and p:find("OC_ALLOW_UNVERIFIED=1", 1, true), "env prefix")
|
|
p = version_env_prefix({ channel = "latest", pin = "", allow = false })
|
|
check(not p:find("OC_VERSION", 1, true) and not p:find("OC_ALLOW_UNVERIFIED", 1, true), "env prefix omits unset values")
|
|
EOF
|
|
} > "$WORK/sel.lua"
|
|
"$lua_bin" "$WORK/sel.lua" || fail "parse_version_selection behavior checks failed"
|
|
|
|
echo "ok"
|