2026 遠端 Mac CI：Mise（rtx）工具鏈釘扎、跨境插件與 lockfile 驗收決策矩陣

（一）開發機與遠端 Mac CI 工具來源混用，xcodebuild／fastlane 因 Node／Ruby 版不同失敗。（二）Mise 插件從 GitHub 跨境克隆，預設逾時與 MISE_JOBS 過高打滿頻寬。（三）.tool-versions 已改但 mise.lock 未提交，或 CI 快取鍵未含 lock 雜湊，造成本機過、CI 掛。維護者常同時維護 CocoaPods、Rust 與 Node 工具，更需要單一工具鏈釘扎入口。

# 倉庫根 .tool-versions（示例）
node 22.14.0
ruby 3.3.6
python 3.12.8

# mise.toml 片段
[settings]
jobs = 4
http_timeout = "120s"

# CI / 遠端 Mac shell
export MISE_DATA_DIR="/var/ci/mise"
export MISE_CACHE_DIR="/var/ci/mise/cache"
export MISE_JOBS=4
export MISE_HTTP_TIMEOUT=120
export MISE_NODE_VERIFY=false
eval "$(mise activate bash --shims)"
mise install --check
mise exec -- xcodebuild -version

生產 CI 禁止在 job 內執行 mise upgrade；版本變更僅能經 PR 更新 lock 後由維護者合併。

export GIT_TERMINAL_PROMPT=0
git config --global url."https://mirror.corp.example/".insteadOf "https://github.com/"
# 重試迴圈（插件安裝失敗時）
for i in 1 2 3; do mise install && break; sleep $((i*15)); done

# GitHub Actions（YAML 片段）
- uses: actions/cache@v4
  with:
    path: |
      /var/ci/mise
      ~/.local/share/mise
    key: mise-${{ runner.os }}-${{ hashFiles('.tool-versions', 'mise.lock', 'mise.toml') }}
    restore-keys: |
      mise-${{ runner.os }}-

# GitLab CI
cache:
  key:
    files:
      - .tool-versions
      - mise.lock
  paths:
    - /var/ci/mise/cache/

快取鍵必須含 mise.lock 與 .tool-versions 雜湊；勿把 RUNNER_OS 以外隨機 env 寫入 key。延伸 Git／npm CI 快取策略。

openclaw doctor --json > /tmp/oc-doctor.json
openclaw gateway status --json > /tmp/oc-gw.json
openclaw config validate
mise install --check || exit 17
# 合併摘要供 Webhook（勿含 token）
jq -n --slurpfile d /tmp/oc-doctor.json --slurpfile g /tmp/oc-gw.json \
  '{doctor:$d[0],gateway:$g[0],mise_check:"ok"}' > ci-summary.json
curl -fsS -X POST "$WEBHOOK_URL" -H "Content-Type: application/json" -d @ci-summary.json

詳見 OpenClaw lockfile 掃描、Webhook 預拉取。

（一）快取鍵：mise-{OS}_{lock前12位}_{mise版}。（二）跨境起點：MISE_JOBS=4、MISE_HTTP_TIMEOUT=120。（三）~/.local/share/mise 或 /var/ci/mise 可用空間 <20% 時降並發並清 cache。