diff --git a/system-dev/wiki/mistakes.md b/system-dev/wiki/mistakes.md index cf93c9b..0fb3b14 100644 --- a/system-dev/wiki/mistakes.md +++ b/system-dev/wiki/mistakes.md @@ -201,9 +201,20 @@ leo 當場:「**這些為什麼不寫到票裡?**」 他會去找繞過去的方法。所以「出路能不能跑」要跟「判準準不準」一樣被測。 ## ⚠️ MISTAKE: 「雲端該有哪些憑證」的清單是唯一真相源,卻沒有任何東西在跟機器對帳 -票: `inkstone/ISEP#115`(→ comment `5522`/`5526`) +票: `inkstone/ISEP#115`(→ comment `5522`/`5526`/`5541`/`5542`/`5577`/`5610`) 日期: 2026-09-01 +📍 repo:`inkstone/ISEP`(`scripts/make-cloud-env.sh`/`scripts/test-make-cloud-env.sh`) + +`InkStoneCo`(`.env`/`system-dev/wiki/credentials-map.md`——清單的值真身與那張索引) + +`products/arcrun-rag`(`.env` 的 `UNCLE6_CF_API_KEY`/`installer/ship.targets.json`) + +`inkstone/Arcrun`(`shared/instance-coordinates/`——`ARCRUN_NS_YOULIN` 的用處) + +三元組: +- `雲端該有哪些憑證 >> 唯一清單在 >> inkstone/ISEP:scripts/make-cloud-env.sh 的 NEEDED` +- `NEEDED >> 值真身在 >> InkStoneCo/.env 等六個 .env(只有名字進版控)` +- `這份清單 >> 被誰逼著跟機器對帳 >> scripts/test-make-cloud-env.sh 的 B7/B8/B9` +- `A 段 8 個 >> 從未併進 >> inkstone/ISEP:main(只活在 fix/cloud-env-parity-14/PR #43)` + 症狀: 雲端 session 要清空 youlin,`env | grep -ciE 'cloudflare|^CF_|wrangler'` → **0**。 而 `credentials-map.md` 明明寫著那把 token 在 `InkStoneCo/.env`。 @@ -229,3 +240,20 @@ leo 當場:「**這些為什麼不寫到票裡?**」 ⇒ **推廣**:repo 裡任何「這台機器該有什麼」的清單,都要有一支東西定期拿它去問機器。 清單自己不會知道它漏了什麼。 + +### 後續(同日 comment `5577`/`5610`):漏掉的那幾把有共同形狀 + +清單從 1 把補到 10 把的過程中,後面兩把不是「忘了寫」,是**同一族的病**: + +``` +uncle6 出貨 能力住在 ~/.wrangler/config/default.toml 的 OAuth 登入態 +ARCRUN_NS_YOULIN 能力住在 ~/.arcrun/config.yaml 的 api_key +``` + +⇒ **能力其實有,只是它住在「不會跟著 clone 走」的地方**(家目錄)。 + 本機因此永遠是綠的,而雲端永遠是紅的——**兩邊都不會有人發現**, + 直到某條線做到最後一步要用它。 + +📌 判準:看到「本機做得到、雲端做不到」時,先問 + **「這個能力的真身住在 repo 裡,還是住在家目錄裡?」** + 住在家目錄 ⇒ 它一定要有一個具名的環境變數,並且進這份清單。