From 03d9782f227a1900f98ad06ee6f419e4cc805076 Mon Sep 17 00:00:00 2001 From: richblack Date: Fri, 21 Aug 2026 00:39:48 +0800 Subject: [PATCH] =?UTF-8?q?=E6=9F=A5=E4=BA=86=E5=AE=98=E6=96=B9=E6=96=87?= =?UTF-8?q?=E4=BB=B6=E6=89=8D=E7=99=BC=E7=8F=BE=EF=BC=9Asetup=20script=20?= =?UTF-8?q?=E6=A0=B9=E6=9C=AC=E8=AE=80=E4=B8=8D=E5=88=B0=E7=92=B0=E5=A2=83?= =?UTF-8?q?=E8=AE=8A=E6=95=B8=EF=BC=8C=E8=80=8C=20exit=201=20=E6=9C=83?= =?UTF-8?q?=E9=8E=96=E6=AD=BB=20session?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit leo 問「寫以前為什麼不查」——沒有藉口，我假設了兩件事都沒查，兩件都是錯的。 ① setup script 讀不到 Environment variables 官方原文：Each session copies the environment's values once, at startup, into ordinary environment variables 而 setup script 是 before Claude Code launches 跑的 ⇒ 注入在它之後。 ⇒ 把 token 放進 Environment variables 再要 setup script 讀，永遠讀不到。 證據吻合：leo 的變數設對了、值也跟本機同一把（長度 40、頭尾一致）， 而腳本回報找不到。 ② exit 非零會讓整個 session 開不起來 官方原文：Exit zero: if the script exits non-zero, the session fails to start. 前一版為了大聲失敗用 exit 1 ⇒ 直接造成 Session initialization failed。 ⇒ 現在一律 exit 0，失敗寫進 /tmp/.isep-setup-report。 本機三向實測： 無變數（雲端真實情況）→ exit 0，印出說明，不擋 session 有變數（未來平台若改行為）→ 設 git 認證並驗證 ls-remote 加 timeout 45（本機曾掛住近 4 分鐘） Co-Authored-By: Claude Opus 5 --- docs/cloud-setup-script.sh | 88 ++++++++++++-------------------------- 1 file changed, 28 insertions(+), 60 deletions(-) diff --git a/docs/cloud-setup-script.sh b/docs/cloud-setup-script.sh index 2f147c6..2491473 100644 --- a/docs/cloud-setup-script.sh +++ b/docs/cloud-setup-script.sh @@ -1,75 +1,43 @@ #!/usr/bin/env bash -# 貼進 code-on-web「Cloud environments → 你的環境 → Setup script」欄位的內容。 -# 不是 ISEP 的一部分（不會被 Claude Code 當 hook/command/skill 掃描）， -# 純粹是給 leo 複製貼上的參考檔，見 docs/cloud-session-bootstrap.md。 +# 貼進 claude.ai → Cloud environments → 你的環境 → Setup script 欄位。 # -# 前提（要先在同一個 Cloud environment 的 Environment variables 欄位加好）： -# GITEA_TOKEN_CLAUDE_CODE ← 既有機器帳號 token，名字沿用 InkStoneCo#14 已建立的那把， -# 不要新造一把。值本身不寫在這支腳本或任何檔案裡。 +# 🔴 2026-08-21 查官方文件後的兩個更正（前一版兩處都錯，代價是 leo 一整天）： # -# 這支腳本做兩件事： -# 1. 設定 git URL 重寫，讓任何對 git.uncle6.me 的 clone 都能用 GITEA_TOKEN_CLAUDE_CODE 認證 -# （官方文件對「CI/CD 裝私有 marketplace」建議的寫法，見 references 段）。 -# 2. 直接把 ISEP 裝成 user-scope plugin ——不是「複製一份」，是跟本機一樣走 -# `claude plugin marketplace add` + `claude plugin install`，裝的東西 -# 100% 來自 inkstone/ISEP 這個 repo 本身，沒有第二份內容。 +# ① **setup script 讀不到 Environment variables。** +# 官方原文：「Each session copies the environment's values once, **at startup**, +# into ordinary environment variables」——而 setup script 是 +# 「**before Claude Code launches**」跑的 ⇒ 注入發生在它之後。 +# ⇒ 把 token 放在 Environment variables 再要 setup script 去讀，永遠讀不到。 # -# 何時跑：只在「這個 Cloud environment 第一次開 session」時跑一次， -# 跑完 Anthropic 會把整個檔案系統拍成快照，之後的 session 直接沿用快照 -# （不重跑，除非改了這支腳本本身、改了 allowed network hosts、或快照滿 7 天過期）。 -# ⇒ 這是唯一會讓「ISEP 改了但雲端還是舊的」重新出現的地方， -# 緩解法見 docs/cloud-session-bootstrap.md「已知限制」段。 +# ② **非零結束會讓整個 session 開不起來。** +# 官方原文：「**Exit zero**: if the script exits non-zero, the session fails to start.」 +# 前一版為了「大聲失敗」用 exit 1 ⇒ 直接把 leo 鎖在門外（Session initialization failed）。 +# ⇒ 現在一律 exit 0，把失敗寫進 /tmp/.isep-setup-report，由 session 內的閘喊出來。 -set -euo pipefail +set -uo pipefail +REPORT=/tmp/.isep-setup-report +: > "$REPORT" + +say() { echo "$1"; echo "$1" >> "$REPORT"; } if [ -z "${GITEA_TOKEN_CLAUDE_CODE:-}" ]; then - echo "❌ 找不到 GITEA_TOKEN_CLAUDE_CODE —— 去 Cloud environment 的 Environment variables 加這個名字" >&2 - exit 1 + say "⚠️ setup 階段讀不到 GITEA_TOKEN_CLAUDE_CODE——這是預期的（見檔頭①）。" + say " ISEP 改由薄殼 repo 的 .claude/settings.json 在 session 啟動時安裝，" + say " 那時環境變數才存在。本腳本不再嘗試在這裡裝 plugin。" + exit 0 fi -# ── git 認證：三個機制都設，因為它們失效的方式不同 ──────────────── -# ① URL 重寫（global） ② 憑證存檔（global） ③ 系統層（HOME 無關，best effort） -# 2026-08-20 雲端實測：session 裡 git 是「匿名」的 ⇒ setup 設的東西沒生效到 session。 -# 原因未定（沒跑到／HOME 不同／快照沒帶），所以三條都設，並在下面自我驗證。 +# 走到這裡表示未來平台改了行為（真的注入了）——那就順手把 git 認證設好，有益無害。 git config --global url."https://claude-code:${GITEA_TOKEN_CLAUDE_CODE}@git.uncle6.me/".insteadOf \ - "https://git.uncle6.me/" -git config --global credential.helper store -printf 'https://claude-code:%s@git.uncle6.me\n' "$GITEA_TOKEN_CLAUDE_CODE" > "$HOME/.git-credentials" -chmod 600 "$HOME/.git-credentials" -git config --system url."https://claude-code:${GITEA_TOKEN_CLAUDE_CODE}@git.uncle6.me/".insteadOf \ - "https://git.uncle6.me/" 2>/dev/null || echo "（system 層設不了，只靠 global——非致命）" + "https://git.uncle6.me/" 2>/dev/null || true +git config --global credential.helper store 2>/dev/null || true +printf 'https://claude-code:%s@git.uncle6.me\n' "$GITEA_TOKEN_CLAUDE_CODE" > "$HOME/.git-credentials" 2>/dev/null || true +chmod 600 "$HOME/.git-credentials" 2>/dev/null || true -# ── 🔴 自我驗證一：認證真的通了嗎 ────────────────────────── -# 這一步是 2026-08-20 事故的直接產物：舊版設完就結束，token 沒生效也不出聲， -# 於是雲端 session 開起來才發現 marketplace 拉不下來，而 setup log 一片綠。 -echo "── 驗證 git 認證 ──" -# 加 timeout：2026-08-21 本機隔離測試時 ls-remote 掛住近 4 分鐘不回， -# 而「掛住」比「失敗」更糟——setup 會卡在那裡，看起來像還在跑。 if command -v timeout >/dev/null 2>&1; then TO="timeout 45"; else TO=""; fi if GIT_TERMINAL_PROMPT=0 $TO git ls-remote https://git.uncle6.me/inkstone/ISEP.git >/dev/null 2>&1; then - echo "✅ git 認證通：拉得到 inkstone/ISEP" + say "✅ git 認證通：拉得到 inkstone/ISEP" else - echo "❌ git 認證不通——marketplace 一定裝不起來，後面不用往下做了。" >&2 - echo " 檢查：GITEA_TOKEN_CLAUDE_CODE 的值對不對、那把 token 有沒有被撤銷。" >&2 - exit 1 + say "❌ git 認證不通——檢查 token 值或它是否被撤銷。（不擋 session，繼續啟動）" fi - -# ── 安裝（user scope 只是備援）───────────────────────────── -# 🔴 官方文件（cloud-environments 的 what-carries-over 表）明文： -# 「Plugins enabled only in your user settings」→ **不會**帶到雲端 session。 -# 真正生效的是薄殼 repo 的 .claude/settings.json 裡的 enabledPlugins ＋ extraKnownMarketplaces。 -# 這兩行留著當本地備援，不是主要路徑——不要以為裝完就等於雲端有了。 -claude plugin marketplace add https://git.uncle6.me/inkstone/ISEP.git --scope user 2>/dev/null || true -claude plugin install isep@inkstone --scope user 2>/dev/null || true - -# ── 🔴 自我驗證二：marketplace 真的拉下來了嗎 ──────────────── -echo "── 驗證 marketplace ──" -if claude plugin marketplace list 2>/dev/null | grep -q "inkstone"; then - echo "✅ marketplace inkstone 已就位" -else - echo "❌ marketplace 沒就位——session 啟動時 enabledPlugins 會是一張跳票的支票。" >&2 - exit 1 -fi - -echo "✅ setup 完成。session 啟動後請用「有鑑別力的探針」驗閘，" -echo " 不要用 git tag（它在三支閘的白名單裡，閘死了也會過）。" +exit 0