docs(cloud): 官方文件核實後修正 Plan A 假設+補完整環境變數盤點(InkStoneCo#14)

查官方文件(code.claude.com/docs/en/cloud-environments 的「What carries
over」表)發現:今天裝好的 --scope user 機制很可能不會被雲端 session 讀到
(user-scope enabledPlugins 明文寫「不會帶到雲端」);先前引用的
「Pre-populate plugins for containers」是另一個機制(CLAUDE_CODE_PLUGIN_
SEED_DIR,給自架容器用),不是 claude.ai Cloud environments 產品。

新增 docs/cloud-environment-audit-20260820.md:
- Plan A 風險(本機隔離環境重跑一次,貼新鮮輸出佐證腳本本身沒問題)
- Plan B(官方文件證實可行:把 ISEP 宣告進連線 repo 自己的 settings.json)
- Plan C(今天新查到:claude --cloud 直接從本機 checkout 打包,完全不經
  過 GitHub 薄殼,官方文件證實可行)
- 舊雲端環境變數逐一比對 credentials-map.md:八個名字(CLOUDFLARE_ACCOUNT_ID
  等)確認來自 polaris/mira/.env(leo21c 現役),與 cloud 總管工作無關,
  建議排除
- 薄殼/ISEP 共存風險分析(不會打架,除非 bootstrap.sh 重新把 InkStoneCo/
  clone 進薄殼workspace)

scripts/make-cloud-env.sh:NEEDED 從 1 個擴到 8 個,排除 leo21c 來源的
憑證,加註每個變數的出處依據。

docs/TESTING.md、docs/cloud-setup-script.sh、docs/cloud-session-bootstrap.md:
補上指向審計文件的警示與 Plan B/C 的 fallback 指引。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
2026-08-20 22:04:25 +08:00
parent c48495d911
commit e255e23f01
5 changed files with 333 additions and 1 deletions
+9
View File
@@ -1,5 +1,14 @@
# 雲端 session 怎麼載到 ISEP —— inkstone/ISEP#5
> 🔴 **2026-08-20 更新,讀這份之前先讀 `docs/cloud-environment-audit-20260820.md`**
> 查官方文件(`code.claude.com/docs/en/cloud-environments` 的「What carries over」表)
> 核實後發現,本檔下面描述的 `--scope user` 裝法,**很可能在真正的雲端 session 裡不會生效**
> ——官方文件白紙黑字寫「user-scope 的 `enabledPlugins` 不會帶到雲端 session」。
> 本檔原本引用的「Pre-populate plugins for containers」章節是另一個機制
> `CLAUDE_CODE_PLUGIN_SEED_DIR`,給 CI/自架容器用),**跟 claude.ai 的 Cloud
> environments 產品不是同一回事**——這是先前引用錯章節。
> 正解+替代路(Plan B/Plan C)在審計文件裡,**明天先看那份**。
對照 `docs/governance/sdd-gitea-governance.md` §11.3「載入契約」三條硬規則
L11.3.1L11.3.2L11.3.3)與其驗收標準(L11.3.4:能貼出雲端實際載到的清單,
逐條對上 ISEP 的註冊條數)。本檔記錄機制、實測結果、還缺什麼。