Compare commits

..

9 Commits

Author SHA1 Message Date
Leo 69e0adce1b wiki 那條帳補上牽涉哪些 repo,並記下漏掉的那幾把的共同形狀(inkstone/ISEP#115)
記憶警察(wiki-first-police)抓到的:那條 mistakes 落帳沒有 repo 欄位也沒有三元組
⇒ 下次查「這件事在哪」還是要從頭找。補 4 個 repo 位址 + 4 條三元組。

順帶把 5577/5610 的推廣寫進同一條,因為那兩把不是「忘了寫」而是同一族:
  uncle6 出貨       能力住在 ~/.wrangler 的 OAuth 登入態
  ARCRUN_NS_YOULIN  能力住在 ~/.arcrun 的 api_key
⇒ 能力其實有,只是住在「不會跟著 clone 走」的地方 ⇒ 本機永遠綠、雲端永遠紅,
  而兩邊都不會有人發現,直到某條線做到最後一步要用它。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-01 15:00:11 +08:00
Leo 47c73cdaa3 出貨線取座標那兩站也不會斷:ARCRUN_NS_YOULIN 進清單(inkstone/ISEP#115 → comment 5610)
inkstone/Arcrun#195 把實例座標拆成「網址隨 repo 走/namespace 走環境變數」之後,
一台乾淨機器只要有這一個環境變數就取得到座標。而它原本只住在
~/.arcrun/config.yaml 的 api_key——家目錄的東西不隨 repo clone 走,雲端拿不到。

- NEEDED 加 ARCRUN_NS_YOULIN(頂層 .env,長度 8)。清單 9 → 10 把。
- 在清單註解裡把這一族的共同形狀寫下來:**能力其實有,只是它住在
  「不會跟著 clone 走」的地方**——uncle6 是 ~/.wrangler 的 OAuth 登入態,
  這把是 ~/.arcrun。下一個遇到同款的人不必重新發現。
- docs/TESTING.md A26:9 把 → 10 把,狀態表補 5610。

只加這一把。
值全程沒有進版控、沒有進對話(只印名字與長度)。版本號待總管定。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-01 14:56:43 +08:00
Leo 92a008fd28 定版 v0.20.0(出貨那台帳號的鑰匙也在清單裡了)
leo 2026-09-01:「它出貨雲端部分還要什麼帳密也要給」「需要 uncle6?」
——需要,而且是硬需求。

實查(總管與工人各自打過一次,結果一致):
  installer/ship.targets.json 六處 accountId 去重 → 58309bb90fd93ad6d0fe0aae99170e9d
  用 products/arcrun-rag/.env 的 UNCLE6_CF_API_KEY 打 CF API:
    /user/tokens/verify → success: True, status: active
    /accounts           → 58309bb9… Uncle6.me@gmail.com's Account   一致
  本機 env 沒有 CLOUDFLARE_API_TOKEN;~/.wrangler/config/default.toml 有 oauth_token
  ⇒ 本機出貨靠家目錄的 OAuth 登入態,那個檔不隨 clone 走 ⇒ 雲端拿不到

清單 8 把 → 9 把。

🔴 未知的一格(刻意留在清單註解裡):這把有沒有 Workers Scripts:Edit 沒驗過
——驗它必須寫入。已確認至少有 Read(讀得回 uncle6 的 75 顆 worker)。

🔴 雲端出貨仍然不通,缺的不是憑證:
  · Leo/arcrun-rag-bundles-staging 對 claude-code 是 push:False(stage 釘的就是它)
  · ARCRUN_SHIP_BASE/ARCRUN_SHIP_NS 只住在 ~/.arcrun/config.yaml,不在任何 repo
  · .github-armed 只存在本機根目錄
  三件都是 leo 的裁決,不在本版範圍。

票:inkstone/ISEP#115

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-01 12:38:04 +08:00
Leo 1f05bc2134 Merge 'uncle6 那把進雲端清單'(inkstone/ISEP#115) 2026-09-01 12:38:04 +08:00
Leo cb310e9c72 出貨那三站的帳號也進清單:uncle6(inkstone/ISEP#115 → comment 5577)
出貨的 installer/docsSite/mailRelay 三站,stage 與 prod 全部部署到 uncle6
(ship.targets.json 六處 accountId 去重後只有 58309bb90fd93ad6d0fe0aae99170e9d),
而本機是靠家目錄的 ~/.wrangler OAuth 登入態出貨——那個檔不隨 repo clone 走,
所以雲端會在部署當下才斷。UNCLE6_CF_API_KEY 這條路本來就存在且 active,只是沒進清單。

- NEEDED 加 UNCLE6_CF_API_KEY(住在 products/arcrun-rag/.env)。清單 8 → 9 把。
- 清單開頭那段「範圍」跟著改,否則說明與清單本身打架;
  並把「這把有沒有 Workers Scripts:Edit 沒驗」這個未知寫在旁邊,
  下一個讀清單的人不必重新發現它。
- docs/TESTING.md A26:把「清單現在是 8 把」改成 9 把,狀態表補 5577。

只加這一把。stage bundle repo 寫入權與 ARCRUN_SHIP_BASE/ARCRUN_SHIP_NS 沒碰
(comment 5577 明寫那是 leo 的裁決,不在範圍)。
值全程沒有進版控、沒有進對話(只印名字與長度)。版本號待總管定。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-01 12:35:40 +08:00
Leo 6f37772a40 定版 v0.19.0(雲端拿得到兩台的帳密)
leo 2026-09-01:「youlin 和 geek6688 都全給,因為這兩個都是讓 CC 操作
一個 stage 一個 test prod,不給所有的就是受阻。」

make-cloud-env.sh 的清單從 1 把變 8 把(youlin 5 + geek6688 2 + Gitea 1)。
在併完的樹上實數:61 支閘/84 條註冊/7 command/7 agent/2 skill/49 腳本
——六個數字都是數出來的,與 description 一致。

🔴 這一筆是補的:766375c 併進 main 時版本沒跟著動(總管把 bump 寫在一個
被 main-push 閘擋下的複合指令裡,擋掉之後只有 merge 生效)。
版本號是 leo 唯一的驗收介面,功能進了 main 而版本沒動=等於沒交付。

票:inkstone/ISEP#115

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-01 12:11:29 +08:00
Leo 766375cd95 Merge '兩台全給:雲端拿得到 youlin+geek6688 的憑證'(inkstone/ISEP#115) 2026-09-01 12:08:29 +08:00
Leo 7aef9436c9 兩台全給(youlin+geek6688),清單守則從名字改成事實(inkstone/ISEP#115 → comment 5541/5542)
leo 2026-09-01:「youlin 和 geek6688 都全給,因為這兩個都是讓 CC 操作
一個 stage 一個 test prod,不給所有的就是受阻。」覆蓋 comment 5526 的 youlin-only。

- NEEDED 從 2 把變 8 把:youlin 五把(CF token/account id/MCP owner secret/
  stage 帳密兩把)+ geek6688 兩把(出貨 token/account id)+ 機器帳號 Gitea token。
  CLOUDFLARE_ACCOUNT_ID_YOULIN 是 comment 5542 才補進 .env 的,已實查在場。
  CLOUDFLARE_API_TOKEN_leo21c 沒加(leo 只點名那兩台)。
- 新增 B9:leo21c 那把住在頂層 .env,不在 polaris/mira/.env ⇒ B8 抓不到它。
  B9 比的是**值相等**不是名字——把它改名叫 CF_TOKEN_BACKUP 照樣紅,
  而黑名單會放它過去。兩條「該紅」方向都在拋棄式副本上實跑證過。
- 密碼類兩把進清單是給人拿的;credentials-map.md「密碼類憑證的用法限制」照舊:
  AI 不得把密碼打進登入欄位。這條寫在清單旁邊,下一個要加變數的人一定會看到。

順手修掉一個不是我造成的假綠:
- hooks/tests/sdd-guard-retired.test.sh 用了 mapfile,macOS 內建 bash 3.2 沒有這個內建,
  在乾淨的 origin/main 上就是離開碼 1(實驗證過),而 TESTING.md 標著「通過 8」。
  改成 while-read(同 scripts/gitea-labels-sync.sh:56 的前例)後:通過 8 / 失敗 0。

接基底與衝突:
- rebase 到 013a987,main 那 8 筆一筆沒掉。
- TESTING.md 兩邊都新增了 A25 ⇒ main 的 A25(sdd-guard 退役)保留原編號,
  本節改為 A26;狀態表那列跟著改。
- plugin.json 取 main 那邊(version 0.18.0 未動),六個數字在併完的樹上實數:
  61/84/7/7/2/49。
- mistakes.md 兩邊各自 append,兩條都留。

值全程沒有進版控、沒有進對話(只印名字與長度)。版本號待總管定。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-01 12:04:49 +08:00
Leo ca9ea9993b 雲端拿得到 youlin 那把 CF token,而且清單會自己跟機器對帳(inkstone/ISEP#115 → comment 5526)
scripts/make-cloud-env.sh 的 NEEDED 只有 1 個變數,裡面從來沒有任何 CF 憑證
——雲端 `env | grep -ciE 'cloudflare|^CF_|wrangler'` 回 0 是這麼來的,不是漏設。

- NEEDED 加 CLOUDFLARE_API_TOKEN_YOULIN_CC_USE(youlin = AI 的 stage)。
  leo21c 正式環境那 7 把(B 段)一把都沒動,理由寫在清單旁邊。
- 新增 scripts/test-make-cloud-env.sh(docs/TESTING.md A25,10 條):
  A 段用假 .env 隔離跑(證明缺值會被標紅、什麼都不寫進 repo);
  B 段拿真 .env 對帳,判準是「值出自哪個檔案」而不是名字裡有沒有某個字,
  並用一個已知住在 polaris/mira/.env 的變數自驗偵測真的會亮。
- TESTING.md B1 原本點名「加一個 GITEA_TOKEN_CLAUDE_CODE」已經過時,
  改成「① 區塊每一行都貼」。
- README/plugin.json 的 scripts 數字在自己的樹上實數:48 → 49。

值全程沒有進版控、沒有進對話(只印名字與長度)。
版本號待總管定。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-01 11:58:37 +08:00
7 changed files with 315 additions and 9 deletions
+2 -2
View File
@@ -1,7 +1,7 @@
{
"name": "isep",
"description": "InkStone Environment Plugin —— leo 的 Claude Code 環境唯一真相源:61 支機械閘(84 條註冊,白話盤點見 docs/hooks-inventory.md)、7 支 slash command、2 支 skill、7 位有名字的工人(agents/,見 docs/governance/worker-roster.md)、48 支腳本,外加治理規範與標籤真相源。本機與雲端裝同一份,沒有子集。",
"version": "0.18.0",
"description": "InkStone Environment Plugin —— leo 的 Claude Code 環境唯一真相源:61 支機械閘(84 條註冊,白話盤點見 docs/hooks-inventory.md)、7 支 slash command、2 支 skill、7 位有名字的工人(agents/,見 docs/governance/worker-roster.md)、49 支腳本,外加治理規範與標籤真相源。本機與雲端裝同一份,沒有子集。",
"version": "0.20.0",
"keywords": [
"inkstone",
"guardrails",
+1 -1
View File
@@ -27,7 +27,7 @@
| `agents/` | 7 位 | **工人名單**`inkstone/ISEP#86`)——派工時指名派給誰,規約見 `docs/governance/worker-roster.md` |
| `commands/` | 7 支 | `/wiki-recall` `/ship-check` `/cp-write` … |
| `skills/` | 2 支 | |
| `scripts/` | 48 支 | `ticket``roster``isep-nag``wiki-compress``github-arm.sh` …(頂層檔案,不含 `lib/` 等子目錄) |
| `scripts/` | 49 支 | `ticket``roster``isep-nag``wiki-compress``github-arm.sh` …(頂層檔案,不含 `lib/` 等子目錄) |
> 🔴 這五個數字**每次都要在自己的樹上實數**,不准沿用上一版、也不准用加減推
> `system-dev/wiki/mistakes.md`:那是 leo 的驗收介面,多報就是假綠):
+47 -3
View File
@@ -564,6 +564,47 @@ bash hooks/tests/sdd-guard-retired.test.sh
🔴 **順序不可顛倒**:要等這一版 ISEP 出去、兩邊 `/plugin update` 之後,
那半才動得——先拿掉 active SDD 就會鎖死。
### A26 — 雲端該有的憑證清單,這台機器真的拿得到:11 條
```
bash scripts/test-make-cloud-env.sh
```
**該看到**`11/11 通過,跳過 0 條`(清單現在是 10 把——兩台全給 + 機器帳號 + uncle6 出貨 + 出貨取座標)。**全程只印變數名字與值的長度,一個字元的值都不印。**
A 段用假的 `.env` 隔離跑(不碰真金鑰、不碰 `~/.claude/cloud-env`);
B 段拿這台機器真正的 `.env` 對帳——**`.env` 不在的機器(雲端就是)會印 `⏭️ SKIP`**
不算失敗,但也不算驗過。
**它在守什麼**inkstone/ISEP#1152026-09-01 實撞):
`make-cloud-env.sh``NEEDED` 是「雲端總管手上有哪些憑證」的**唯一**清單。
那天雲端要清空 youlin`env | grep -ciE 'cloudflare|^CF_|wrangler'`**0**——
不是雲端漏設,是**這份清單裡從來沒有任何 CF 憑證**。
🔴 更貴的是它**發生在流程末端**:工人已經把清空腳本與測試都寫完了,
到要真的跑的那一刻才知道跑不了。
**失敗**
- **B7 紅** ⇒ 清單上有一把這台機器根本拿不到值 ⇒ leo 貼出去的會是
`<🔴 找不到>`,而雲端要到**用到那一刻**才知道。這就是 ISEP#115 那一天的形狀
- **B8 紅** ⇒ 清單裡混進了值出自 `polaris/mira/.env` 的變數,那是 **leo21c 現役正式環境**
leo 2026-08-20 已把那 7 把分進 B 段並選擇不放(`inkstone/InkStoneCo#14` → comment `3890`
- **B9 紅** ⇒ 清單裡有一把的**值**就是 `CLOUDFLARE_API_TOKEN_leo21c`
leo 2026-09-01 的紅線是「那把不准加」,而 B9 比的是值不是名字 ⇒ **改個名字照樣紅**
- **B8x 紅或長期 SKIP** ⇒ B8 的偵測**不會亮**。全綠有兩種可能(真的沒有正式憑證/
偵測根本壞了),分不開就等於沒驗
- **A5a/A5b 紅** ⇒ 缺值時不會被標成 `<🔴 …>`、收尾也不點名 ⇒ **假綠**
而假綠正是這張票要解的病
- **A6 紅** ⇒ 有東西被寫進 repo。那支腳本的產物含金鑰真身,**刻意不在任何 repo 裡**
> 🔴 **B8 與 B9 的判準都不是名字,是機器算得出來的事實。**
> B8 看「值從哪個檔案拿到的」,B9 看「這個值是不是就是 leo21c 那把」。
> **兩條是分工不是重複**`CLOUDFLARE_API_TOKEN_leo21c` 住在**頂層** `.env`
> 不在 `polaris/mira/.env` ⇒ B8 抓不到它,那就是 B9 存在的理由。
>
> **兩條的「該紅」方向都實跑過**(2026-09-01,拋棄式副本,分支一個字沒動):
> ```
> 混進 mira 的 NAMESPACE → ❌ B8 …want=0 got=1,並指出「來自 polaris/mira/.env」
> 把 leo21c 那把改名 CF_TOKEN_BACKUP → ❌ B9 …want=0 got=1B8 此時仍綠,因為值不出自 mira)
> ```
> ⇒ 第二條正是黑名單會放過去的形狀。
### A5 — 開票前的搜尋是跨 repo 的
```
python3 scripts/ticket where 標籤 模組化
@@ -732,9 +773,11 @@ bash scripts/make-cloud-env.sh
打開上一步產生的檔,裡面兩塊分別貼進 claude.ai → **Cloud environments** → 你的環境:
1. **Environment variables** 加一個
- 名稱`GITEA_TOKEN_CLAUDE_CODE`
- 值:**既有的** claude-code 機器帳號 Gitea token(不要新造一把)
1. **Environment variables**:把 ① 區塊**每一行**都貼進去(一行一個,名字與值分開填)。
現在是 2 個`GITEA_TOKEN_CLAUDE_CODE`(機器帳號 Gitea token)與
`CLOUDFLARE_API_TOKEN_YOULIN_CC_USE`youlin AI 的 stage 實例)。
🔴 **不要照這裡的名字數**——以腳本產出的 ① 區塊為準,這份文件會落後。
值全部是**既有的**,一把都沒有新造。
2. **Setup script** 欄位:貼進 `docs/cloud-setup-script.sh` 的全文,一字不改。
**該看到**:儲存後沒有紅字。
@@ -832,6 +875,7 @@ B2(信標那行)/B3(setup 輸出)/B4(閘的訊息)三個畫面
| **A12 留言身份欄(兩道門)** | 總管 | ✅ 11/112026-08-27 |
| **A23 同時跑的線有上限** | isep-guard | ✅ 33/332026-08-29inkstone/ISEP#109 |
| **A24 一條線要有自己的工作目錄** | isep-guard | ✅ 35/352026-08-29inkstone/ISEP#109→5391 |
| **A26 雲端憑證清單這台拿得到** | isep-hand | ✅ 11/112026-09-01inkstone/ISEP#115→55265541554255775610)+兩條「該紅」方向實跑 |
| **A16 放行的門真的打得開** | 總管 | ✅ 17/172026-08-28inkstone/ISEP#90 |
| **A17 未推警察不誤攔雲端分支** | 總管 | ✅ 10/102026-08-28inkstone/ISEP#90 |
| **A18 信標會報雲端接線缺陷** | 總管 | ✅ 14/142026-08-28inkstone/ISEP#90 |
+6 -2
View File
@@ -76,7 +76,11 @@ printf -- '---\nstatus: active\n---\n# A\n' > "$REPO_MULTI/system-dev/docs/3-spe
printf -- '---\nstatus: active\n---\n# B\n' > "$REPO_MULTI/system-dev/docs/3-specs/b/design.md"
# 撈出所有掛在 Write|Edit|MultiEdit 上的 PreToolUse 閘(照 hooks.json 的實況,不寫死清單)
mapfile -t WRITE_HOOKS < <(python3 - "$HOOKS_DIR/hooks.json" <<'PY'
# macOS 內建 bash 是 3.2,沒有 mapfile/readarray——用相容寫法收陣列
# (同 scripts/gitea-labels-sync.sh:56 的前例;2026-09-01 inkstone/ISEP#115 實撞:
# 這支測試在 leo 的 mac 上一次都沒跑成功過,離開碼 1,而 TESTING.md 標著「通過 8」)
WRITE_HOOKS=()
while IFS= read -r _l; do WRITE_HOOKS+=("$_l"); done < <(python3 - "$HOOKS_DIR/hooks.json" <<'PY'
import json, sys
d = json.load(open(sys.argv[1]))
for g in d["hooks"].get("PreToolUse", []):
@@ -87,7 +91,7 @@ for g in d["hooks"].get("PreToolUse", []):
PY
)
if [ "${#WRITE_HOOKS[@]}" -eq 0 ]; then
if [ "${#WRITE_HOOKS[@]:-0}" -eq 0 ]; then
bad "撈不到任何 Write|Edit 的 PreToolUse 閘——測試本身失效了,先修這裡"
fi
+57 -1
View File
@@ -10,9 +10,65 @@
set -euo pipefail
# ── 雲端需要哪些變數(只有名字。要加就加在這裡)──────────────────
#
# 範圍=**youlinstage)與 geek6688(測試 prod & 出貨機)兩台全給**,
# **外加 uncle6**——出貨的三個站實際部署到的是那個帳號。
# leo 2026-09-01:「youlin 和 geek6688 都全給,因為這兩個都是讓 CC 操作
# 一個 stage 一個 test prod**不給所有的就是受阻**。」
# uncle6 是同一句話的延伸(inkstone/ISEP#115 → comment `5577`):
# `products/arcrun-rag/installer/ship.targets.json` 六處 accountId 去重後只有一個值
# `58309bb90fd93ad6d0fe0aae99170e9d`,而本機出貨靠的是家目錄裡的 OAuth 登入態
# `~/.wrangler/config/default.toml`)——**那個檔不隨 repo clone 走,雲端永遠拿不到**。
# ⚠️ 這把「是 uncle6 的、而且 active」是驗過的;「它有沒有 Workers Scripts:Edit
# =真的部署得動」**沒驗**(驗它必須寫入,那是紅線)。缺這格會在部署當下才知道。
#
# 📌 `ARCRUN_NS_YOULIN` 是同一族的病、不同的家(inkstone/ISEP#115 → comment `5610`):
# `inkstone/Arcrun#195` 把實例座標拆成「網址隨 repo 走/namespace 走環境變數」之後,
# 一台乾淨機器只要有這一個環境變數就取得到座標——而它原本只住在
# `~/.arcrun/config.yaml` 的 `api_key`**家目錄的東西不隨 repo clone 走**。
# 🔎 這一族的共同形狀:**能力其實有,只是它住在「不會跟著 clone 走」的地方**
# uncle6 是 `~/.wrangler` 的 OAuth 登入態,這把是 `~/.arcrun`)。
NEEDED=(
GITEA_TOKEN_CLAUDE_CODE # 機器帳號 claude-code 的 Gitea tokenbootstrap 與 plugin 安裝都靠它
# ── 機器帳號 ──
GITEA_TOKEN_CLAUDE_CODE # claude-code 的 Gitea tokenbootstrap 與 plugin 安裝都靠它
# ── youlin AI 的 stage(沒指定帳號時的預設,agent-memory.md §2)──
CLOUDFLARE_API_TOKEN_YOULIN_CC_USE # D37 起這把就是設計給 CC 用的
CLOUDFLARE_ACCOUNT_ID_YOULIN # 上面那把的配對 account id(帳號 id 不是機密)
YOULIN_MCP_OWNER_SECRETS # youlin 那台 MCP 的 owner secret
STAGE_USERNAME_YOULIN # ⚠️ 密碼類,見下面那條限制
STAGE_PASSWORD_YOULIN # ⚠️ 密碼類,見下面那條限制
ARCRUN_NS_YOULIN # 出貨線取座標那兩站要它;原本只住在 ~/.arcrun/config.yaml 的 api_key(家目錄,不隨 clone 走)
# ── geek6688 測試 prod 出貨機 ──
CLOUDFLARE_API_TOKEN_CC_SHIPPING_CORE # 出貨線寫入用
CLOUDFLARE_ACCOUNT_ID_GEEK6688 # 上面那把的配對 account id
# ── uncle6 = 出貨三站真正部署到的帳號(installerdocsSitemailRelaystage 與 prod 都是)──
UNCLE6_CF_API_KEY # 住在 products/arcrun-rag/.env;本機是靠 ~/.wrangler 的 OAuth 登入態出貨,那個檔不隨 clone 走
)
#
# 🔴 這份清單的邊界——加一把之前先問「這把打得到哪個實例」,不是「這把方便嗎」
#
# 可以進來的:**youlin 與 geek6688** 這兩台的全部,加上機器帳號自己的 token。
# 🔴 不准進來的:
# ① `CLOUDFLARE_API_TOKEN_leo21c`——leo 2026-09-01 只點名那兩台;
# leo21c 是現役正式環境,`inkstone/InkStoneCo#14` → comment `3890` 已分進 B 段不放。
# ② `polaris/mira/.env` 裡的任何東西——那整份都是 leo21c 現役正式環境。
# 其中 `CLOUDFLARE_API_TOKEN` / `CLOUDFLARE_ACCOUNT_ID` 這兩個**沒有名字**的最危險:
# 所有 CF 工具都把它們當預設 ⇒ 雲端一個沒指定帳號的指令就會打到正式環境。
# 2026-08-14 那輪審查把它列為「本輪最危險的發現」。
# 🔎 這一條不必靠人記得:`scripts/test-make-cloud-env.sh` 的 B8 會去看
# **每一把的值是從哪個檔案拿到的**,出自 `polaris/mira/.env` 就紅。
#
# 🔴 密碼類(`STAGE_PASSWORD_YOULIN` 等)進清單是為了讓**人**拿得到。
# `credentials-map.md`「密碼類憑證的用法限制」(2026-08-17 立)照舊有效:
# **AI 不得把密碼打進登入欄位**,這是 surface 層硬規則,leo 交代了也不解除。
# 機器要驗登入後的畫面走那節寫的兩條:帶 token/cookie 打 API,或接 leo 已登入的分頁。
#
# 📌 兩台的 account id 都有具名變數了(`…_YOULIN` 是 2026-09-01 才補進頂層 `.env` 的,
# inkstone/ISEP#115 → comment `5542`;帳號 id 不是機密,wiki 的帳號表本來就公開記著)。
# **所以永遠不需要去用那個沒有名字的 `CLOUDFLARE_ACCOUNT_ID`**——那是 leo21c。
# ── 去哪裡找值(credentials-map.md 記的六個 .env)────────────────
BASE="${INKSTONE_ROOT:-$HOME/Documents/tech_projects/InkStoneCo}"
+144
View File
@@ -0,0 +1,144 @@
#!/bin/bash
# make-cloud-env.sh 的測試(docs/TESTING.md A14
#
# 它守什麼: 那支腳本是「雲端總管手上有哪些憑證」的唯一清單。清單漏一把,
# 雲端會在**流程末端**才發現跑不了(inkstone/ISEP#115 內文:派了工人寫完
# 清空腳本、寫完測試,到要真的跑的那一刻才知道 CF token 根本不在)。
#
# 兩段:
# A 段 —— 用假的 .env 隔離跑,證明「產物長對、缺值不會假綠、什麼都不寫進 repo」。
# 全程不碰真金鑰、不碰 ~/.claude/cloud-env。
# B 段 —— 拿這台機器真正的 .env 對帳,證明清單上每一把**這台都拿得到值**,
# 而且**沒有一把的值來自 polaris/mira/.env**leo21c 現役正式環境)。
# .env 不在(例如雲端)⇒ 印 ⏭️ SKIP,不算通過也不算失敗。
#
# 🔴 B8/B9 的判準都不是名字,是機器算得出來的事實——**換什麼名字都躲不掉**。
# B8 看「這個值是從哪個檔案拿到的」(出自 polaris/mira/.env leo21c 現役正式環境)。
# B9 看「這個值是不是就是 leo21c 那把 token」(值相等就紅,改名叫什麼都一樣)。
# 🔴 兩條是分工不是重複:`CLOUDFLARE_API_TOKEN_leo21c` 住在**頂層** .env
# 不在 polaris/mira/.env ⇒ **B8 抓不到它**,這正是 B9 存在的理由。
# 關鍵字黑名單反過來只擋得住已經被列進去的那幾個名字,新名字一律漏掉
# leo 2026-08-17 已證偽文字層封路:當日 8 次誤攔、0 次正確攔截)。
#
# 🔴 全程只印變數**名字**與值的**長度**,一個字元的值都不印。
cd "$(dirname "$0")/.." || exit 1
S=scripts/make-cloud-env.sh
PASS=0; FAIL=0; SKIP=0
ok(){ PASS=$((PASS+1)); printf ' ✅ %s\n' "$1"; }
bad(){ FAIL=$((FAIL+1)); printf ' ❌ %s\n' "$1"; }
skip(){ SKIP=$((SKIP+1)); printf ' ⏭️ SKIP %s\n' "$1"; }
chk(){ [ "$1" = "$2" ] && ok "$3$2" || bad "$3want=$1 got=$2"; }
# 清單與搜尋路徑都從腳本本身讀出來——測試不另養一份,養了就會漂。
# 註:macOS 內建的是 bash 3.2,沒有 mapfilereadarray,一律用 while read 收陣列。
NEEDED=()
while IFS= read -r l; do NEEDED+=("$l"); done < <(
sed -n '/^NEEDED=(/,/^)/p' "$S" | sed -E '1d;$d; s/[[:space:]]*#.*$//; s/[[:space:]]//g' | grep -v '^$')
[ "${#NEEDED[@]}" -gt 0 ] || { echo "🔴 從 $S 讀不出 NEEDED,測試本身壞了"; exit 1; }
echo "清單(只有名字):${NEEDED[*]}"
echo
TMP=$(mktemp -d); trap 'rm -rf "$TMP"' EXIT
FAKE="$TMP/fakeroot"; OUTD="$TMP/out"; mkdir -p "$FAKE"
echo "── A. 隔離跑(假 .env,不碰真金鑰、不碰 ~/.claude/cloud-env)──"
: > "$FAKE/.env"
for n in "${NEEDED[@]}"; do echo "$n=FAKEVALUE-$n" >> "$FAKE/.env"; done
BEFORE=$(git status --porcelain)
OUT_LINE=$(INKSTONE_ROOT="$FAKE" OUT_DIR="$OUTD" bash "$S" 2>&1)
F=$(printf '%s\n' "$OUT_LINE" | sed -n 's/^✅ 產生完成://p')
[ -f "$F" ] && ok "A1 產物產出來了" || bad "A1 產物不存在(腳本輸出:$OUT_LINE"
chk 600 "$(stat -f '%OLp' "$F" 2>/dev/null || stat -c '%a' "$F" 2>/dev/null)" "A2 產物權限"
miss=0
for n in "${NEEDED[@]}"; do grep -qx "$n=FAKEVALUE-$n" "$F" || { miss=$((miss+1)); echo " ↑ 沒出現:$n"; }; done
chk 0 "$miss" "A3 每個名字都帶著值出現在 ① 區塊"
printf '%s\n' "$OUT_LINE" | grep -q "找不到值的 0 個" \
&& ok "A4 收尾那行說「找不到值的 0 個」" || bad "A4 收尾計數不對:$OUT_LINE"
# 缺值時不准假綠:拿掉第一個,它要變成 <🔴 …> 且計數變 1
grep -v "^${NEEDED[0]}=" "$FAKE/.env" > "$FAKE/.env.tmp" && mv "$FAKE/.env.tmp" "$FAKE/.env"
OUT2=$(INKSTONE_ROOT="$FAKE" OUT_DIR="$OUTD" bash "$S" 2>&1)
F2=$(printf '%s\n' "$OUT2" | sed -n 's/^✅ 產生完成://p')
grep -q "^${NEEDED[0]}=<🔴" "$F2" && ok "A5a 缺值那行標成 <🔴 …>" || bad "A5a 缺值沒被標出來"
printf '%s\n' "$OUT2" | grep -q "找不到值的 1 個 ${NEEDED[0]}" \
&& ok "A5b 收尾點名缺的是誰" || bad "A5b 收尾沒點名:$OUT2"
if [ "$BEFORE" = "$(git status --porcelain)" ]; then ok "A6 跑完沒有任何檔案被寫進 repo"
else bad "A6 repo 裡多了東西:$(diff <(printf '%s\n' "$BEFORE") <(git status --porcelain) | tr '\n' ' ')"; fi
echo
echo "── B. 拿這台機器真正的 .env 對帳(只印長度,不印值)──"
ENVF=()
while IFS= read -r l; do ENVF+=("$l"); done < <(
sed -n '/^ENV_FILES=(/,/^)/p' "$S" | sed -E '1d;$d; s/^[[:space:]]*"//; s/"[[:space:]]*$//' | grep -v '^$')
BASE="${INKSTONE_ROOT:-$HOME/Documents/tech_projects/InkStoneCo}"
real_src(){ # $1=名字 → 印出「值的長度 來源檔」;找不到回非 0
local name="$1" f p v
for p in "${ENVF[@]}"; do
f="${p/\$BASE/$BASE}"; f="${f/\$\{BASE\}/$BASE}"
[ -f "$f" ] || continue
v=$(grep -E "^[[:space:]]*(export[[:space:]]+)?${name}=" "$f" 2>/dev/null | tail -1 \
| sed -E "s/^[[:space:]]*(export[[:space:]]+)?${name}=//" | sed -E 's/^"(.*)"$/\1/; s/^'"'"'(.*)'"'"'$/\1/')
[ -n "$v" ] && { printf '%s %s' "${#v}" "$f"; return 0; }
done
return 1
}
# 只取值、不取來源,給 B9 比對用。值只活在變數裡,從不印出、也不寫檔。
_val(){ local r f; r=$(real_src "$1") || return 1; f="${r#* }"
grep -E "^[[:space:]]*(export[[:space:]]+)?$1=" "$f" | tail -1 \
| sed -E "s/^[[:space:]]*(export[[:space:]]+)?$1=//" | sed -E 's/^"(.*)"$/\1/; s/^'"'"'(.*)'"'"'$/\1/'; }
found=0
for p in "${ENVF[@]}"; do f="${p/\$BASE/$BASE}"; [ -f "$f" ] && found=1; done
if [ "$found" = 0 ]; then
skip "B7 這台機器一個 .env 都沒有(雲端就是這個狀態),對帳跳過"
skip "B8 同上"
else
gone=0; prod=0
for n in "${NEEDED[@]}"; do
if r=$(real_src "$n"); then
len="${r%% *}"; src="${r#* }"
printf ' %-38s → 找得到(長度 %s)來自 %s\n' "$n" "$len" "${src#$BASE/}"
case "$src" in */polaris/mira/.env) prod=$((prod+1)); echo " 🔴 ↑ 這是 leo21c 現役正式環境那份 .env";; esac
else
printf ' %-38s → 🔴 這台拿不到\n' "$n"; gone=$((gone+1))
fi
done
chk 0 "$gone" "B7 清單上每一把這台都拿得到值"
chk 0 "$prod" "B8 沒有一把的值來自 polaris/mira/.envleo21c 正式環境)"
# B9 —— leo 2026-09-01 的紅線:「CLOUDFLARE_API_TOKEN_leo21c 不准加」。
# 🔴 判準是**值**不是名字:拿 leo21c 那把的值,比對清單上每一把解出來的值。
# 有人把它改名叫 CF_TOKEN_BACKUP 照樣會紅,而黑名單會放它過去。
# B8 抓不到這一條(那把住在頂層 .env,不在 polaris/mira/.env)。
if leoval=$(_val CLOUDFLARE_API_TOKEN_leo21c); then
hit=0
for n in "${NEEDED[@]}"; do
v=$(_val "$n") || continue
[ "$v" = "$leoval" ] && { hit=$((hit+1)); echo " 🔴 $n 的值就是 leo21c 那把"; }
done
chk 0 "$hit" "B9 清單上沒有一把的值等於 CLOUDFLARE_API_TOKEN_leo21c"
else
skip "B9 這台找不到 CLOUDFLARE_API_TOKEN_leo21c,沒有比對基準"
fi
# B8 全綠有兩種可能:真的沒有正式憑證,或**偵測根本不會亮**。分得開才算驗過。
# 拿一個已知住在 polaris/mira/.env 的名字餵它,看它認不認得出來。
if r=$(real_src CLOUDFLARE_ACCOUNT_ID); then
case "${r#* }" in
*/polaris/mira/.env) ok "B8x 反例自驗:把 leo21c 那份 .env 的變數餵進去,偵測認得出來" ;;
*) skip "B8x 反例自驗:CLOUDFLARE_ACCOUNT_ID 這次解到 ${r#* },不是 mira 那份,這台沒得驗" ;;
esac
else
skip "B8x 反例自驗:這台找不到 CLOUDFLARE_ACCOUNT_ID,沒有現成的反例可餵"
fi
fi
echo
echo "$PASS/$((PASS+FAIL)) 通過,跳過 $SKIP"
[ "$FAIL" -eq 0 ]
+58
View File
@@ -199,3 +199,61 @@ leo 當場:「**這些為什麼不寫到票裡?**」
📌 推廣:**一支閘的價值是「擋下來 + 給一條走得通的路」。**
出路走不通時它不是幫你,是擋你——而被擋的人不會停下來修閘,
他會去找繞過去的方法。所以「出路能不能跑」要跟「判準準不準」一樣被測。
## ⚠️ MISTAKE: 「雲端該有哪些憑證」的清單是唯一真相源,卻沒有任何東西在跟機器對帳
票: `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 的 B7B8B9`
- `A 段 8 個 >> 從未併進 >> inkstone/ISEP:main(只活在 fix/cloud-env-parity-14PR #43`
症狀: 雲端 session 要清空 youlin`env | grep -ciE 'cloudflare|^CF_|wrangler'`**0**
`credentials-map.md` 明明寫著那把 token 在 `InkStoneCo/.env`
實查: 不是雲端漏設。`scripts/make-cloud-env.sh``NEEDED` 當時**只有 1 個變數**
裡面從來沒有任何 CF 憑證。而 `inkstone/InkStoneCo#14` comment `3890`
2026-08-20)盤點出的 A 段是 **8 個**——那一版三段輸出的腳本,
到今天為止只活在**沒併進 `main` 的分支 `fix/cloud-env-parity-14`PR #43**上。
原因: 盤點做在票上、實作做在分支上、`main` 上的清單是另一回事——**三份,互不對帳**。
🔴 而清單漏一項的代價**在流程末端才付**:工人已經把腳本與測試都寫完了,
到要真的跑的那一刻才知道跑不了。
正確做法: 清單要有測試逼它跟這台機器對帳(`scripts/test-make-cloud-env.sh`
`docs/TESTING.md` A26)——B 段逐一去 `.env` 找值,找不到就紅。
🔴 而「不准混進正式環境憑證」這一條,判準一律是**機器算得出來的事實**,
**不是名字裡有沒有某個字**——兩條分工:
B8 看**值從哪個檔案拿到的**(出自 `polaris/mira/.env` = leo21c 現役正式環境就紅);
B9 看**這個值是不是就是 `CLOUDFLARE_API_TOKEN_leo21c`**(那把住在頂層 `.env`
B8 抓不到,而改個名字黑名單就放它過去——實跑證過)。黑名單擋不住沒被列進去的新名字,
「這個值出自那份 `.env`」是 grep 得出來的事實,換什麼名字都躲不掉。
同時釘住反面(B8x):拿一個已知住在那份 `.env` 的變數餵它,證明偵測**真的會亮**——
否則「全綠」有兩種可能(真的乾淨/偵測壞了),而分不開就等於沒驗。
**推廣**:repo 裡任何「這台機器該有什麼」的清單,都要有一支東西定期拿它去問機器。
清單自己不會知道它漏了什麼。
### 後續(同日 comment `5577`/`5610`):漏掉的那幾把有共同形狀
清單從 1 把補到 10 把的過程中,後面兩把不是「忘了寫」,是**同一族的病**:
```
uncle6 出貨 能力住在 ~/.wrangler/config/default.toml 的 OAuth 登入態
ARCRUN_NS_YOULIN 能力住在 ~/.arcrun/config.yaml 的 api_key
```
**能力其實有,只是它住在「不會跟著 clone 走」的地方**(家目錄)。
本機因此永遠是綠的,而雲端永遠是紅的——**兩邊都不會有人發現**,
直到某條線做到最後一步要用它。
📌 判準:看到「本機做得到、雲端做不到」時,先問
**「這個能力的真身住在 repo 裡,還是住在家目錄裡?」**
住在家目錄 ⇒ 它一定要有一個具名的環境變數,並且進這份清單。