修好一次性戳記恆擋：InkStoneCo 專案版 hooks 與 plugin 雙掛載

inkstone/ISEP#122：leo 三次要部署被 prod-write-guard.sh 恆擋，蓋了戳記
也放不了行。根因不在 prod-write-guard.sh 本身，而在
InkStoneCo/.claude/settings.json 還登記著一份 2026-08-20 立 ISEP plugin
之前的舊 hook，跟 plugin 自己的 hooks.json 同時掛在同一個事件上——每個
PreToolUse 都跑了兩次，一次性戳記被第一份消耗掉，第二份永遠看到空戳記。

實查（在這台機器的樹上實數）：InkStoneCo 專案版登記著 38 支 hook，
34 支跟 plugin 完全同名同用途（純殘骸）、3 支是已退役機制
（claim-verify-police.sh／subagent-claim-worksheet.sh／sdd-guard.sh，
ISEP#60／#91 早已裁定退役但專案版沒跟著退）、1 支（kv-write-guard.sh）
是專案版有、plugin 當時沒有的真閘。

這次：
- kv-write-guard.sh 原樣搬進本 repo（B 組，PreToolUse Write|Edit|MultiEdit），
  補齊那個真的缺口，附 8 條迴歸測試
- 新增 duplicate-hook-registration-guard.sh（E 組，SessionStart）：
  往後任何專案的 settings.json 又跟 plugin 長出同名登記，開場就點名，
  不必再靠「戳記莫名其妙失效」才發現，附 8 條迴歸測試
- 兩支新閘：61→63 支、84→86 條註冊（在自己的樹上實數，不是加減推）

InkStoneCo 那邊的清理（37 支殘骸從 settings.json 與 .claude/hooks/ 移除，
kv-write-guard.sh 保留至本次升版並 /plugin update 之後）另外commit，
不在本 repo 範圍內。

驗證：重演過修好前的雙掛載（蓋一次戳記→專案版先吃掉→plugin 版恆擋，
EXIT=2），也驗過修好後單次執行放行（EXIT=0）與不蓋戳記仍被擋（EXIT=2）。

待總管定版。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

.claude-plugin/plugin.json

@@ -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.17.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.21.0",
   "keywords": [
     "inkstone",
     "guardrails",

README.md

@@ -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 的驗收介面，多報就是假綠）：

docs/TESTING.md

@@ -564,6 +564,96 @@ 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 出貨 ＋ Arcrun 出貨線的實例 namespace）。**全程只印變數名字與值的長度，一個字元的值都不印。**
+A 段用假的 `.env` 隔離跑（不碰真金鑰、不碰 `~/.claude/cloud-env`）；
+B 段拿這台機器真正的 `.env` 對帳——**`.env` 不在的機器（雲端就是）會印 `⏭️ SKIP`**，
+不算失敗，但也不算驗過。
+
+**它在守什麼**（inkstone/ISEP#115，2026-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=1（B8 此時仍綠，因為值不出自 mira）
+> ```
+> ⇒ 第二條正是黑名單會放過去的形狀。
+
+### A27 — 一次性戳記真的能放行一次：重複掛載清乾淨了，也不會靜靜復發（`inkstone/ISEP#122`）
+```
+bash hooks/tests/duplicate-hook-registration-guard.test.sh
+bash hooks/tests/kv-write-guard.test.sh
+```
+**該看到**：兩支各自 `8 通過 / 0 失敗`。全程用假的 plugin root／專案目錄，
+不碰真正的 `InkStoneCo/.claude/` 或這台機器裝著的 ISEP plugin。
+
+**它們在守什麼**（2026-09-01 實撞）：總管三次要部署 uncle6.me，三次被
+`prod-write-guard.sh` 恆擋——蓋了戳記、確認戳記還在，執行動作時照樣被擋，
+再看戳記已經不見。根因：`InkStoneCo/.claude/settings.json` 還登記著一份
+2026-08-20 立 ISEP plugin 之前的舊 hook（那時 `.claude/hooks/` 是唯一的家），
+跟 plugin 自己的 `hooks.json` 同時掛在同一個 `PreToolUse` 事件上——每個動作
+都跑了**兩次**，一次由專案版、一次由 plugin。多數閘只是白跑一次沒感覺，
+但一次性戳記（蓋了就消耗掉）被第一份吃光，第二份永遠看到空戳記，於是恆擋。
+
+**實查結果**（在這台機器的樹上實數，不是推算）：`InkStoneCo/.claude/settings.json`
+登記著 38 支專案版 hook——**34 支跟 plugin 完全同名同用途**（純殘骸）、
+**3 支是已經退役的機制**（`claim-verify-police.sh`／`subagent-claim-worksheet.sh`／
+`sdd-guard.sh`，`inkstone/ISEP#60`／`#91` 早已裁定退役，但專案版沒有跟著退），
+**1 支（`kv-write-guard.sh`）是專案版有、plugin 當時沒有的真閘**（2026-08-25
+立，長效資料不准寫進 KV）。前 37 支已從 `InkStoneCo/.claude/settings.json`
+與 `.claude/hooks/` 刪除；第 38 支原樣搬進本 repo（同一輪 commit，見 B 組）。
+
+**失敗**：
+- `kv-write-guard.test.sh` 任一「該擋」紅 ⇒ 搬過來時邏輯改壞了，
+  KV 寫入的偵測失靈
+- `kv-write-guard.test.sh` 任一「不該擋」紅 ⇒ 誤攔，這比漏擋嚴重——
+  正常的 `.get`／退休戰的刪除／`kv-ok` 豁免都要放得過
+- `duplicate-hook-registration-guard.test.sh` 的「該吵」任一紅 ⇒
+  重複掛載又會靜靜發生，**下一次會是另一支帶戳記語意的閘恆擋，
+  而且要等 leo 自己撞到才會被發現**
+- `duplicate-hook-registration-guard.test.sh` 的「不該吵」任一紅 ⇒
+  誤攔，每個 session 開場都吵一次沒問題的環境，最後被學會忽略
+
+### A28 — 收工前的實測：蓋一次戳記真的只用得掉一次（手動，這台機器）
+這一格驗的是**行為**，不是**檔案**——上面兩支測試證明「新機制自己邏輯對」，
+這格證明「舊的重複掛載真的被拆掉了」。在**新開**的 session 裡跑（PreToolUse hook
+是 session 啟動時載入的常駐清單，同一支閘改完不會讓已經在跑的 session 重新讀）：
+```
+bash "$CLAUDE_PLUGIN_ROOT/scripts/gate-ok" prod-write   # 蓋一次戳記
+# 執行一個會被 prod-write-guard.sh 擋的動作（例如 wrangler pages deploy 打非白名單目標）
+```
+**該看到**：蓋戳記那個會被擋的動作**這次放行**（① 蓋一次戳記 → ② 動作通過）；
+不蓋戳記重跑同一個動作 → **仍然被擋**（證明沒有把閘弄鬆，只是不再被自己的複本吃掉）。
+**失敗**：蓋了戳記仍被擋 ⇒ 還有第三份複本沒清乾淨，去跑
+`bash "$CLAUDE_PLUGIN_ROOT/hooks/duplicate-hook-registration-guard.sh"`
+（或直接開一個新 session 看它開場有沒有吵）先定位是哪一份。
+
 ### A5 — 開票前的搜尋是跨 repo 的
 ```
 python3 scripts/ticket where 標籤 模組化
@@ -732,9 +822,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 +924,7 @@ B2（信標那行）／B3（setup 輸出）／B4（閘的訊息）三個畫面
 | **A12 留言身份欄（兩道門）** | 總管 | ✅ 11/11（2026-08-27） |
 | **A23 同時跑的線有上限** | isep-guard | ✅ 33/33（2026-08-29，inkstone/ISEP#109） |
 | **A24 一條線要有自己的工作目錄** | isep-guard | ✅ 35/35（2026-08-29，inkstone/ISEP#109→5391） |
+| **A26 雲端憑證清單這台拿得到** | isep-hand | ✅ 11/11（2026-09-01，inkstone/ISEP#115→5526／5541／5542／5577）＋兩條「該紅」方向實跑 |
 | **A16 放行的門真的打得開** | 總管 | ✅ 17/17（2026-08-28，inkstone/ISEP#90） |
 | **A17 未推警察不誤攔雲端分支** | 總管 | ✅ 10/10（2026-08-28，inkstone/ISEP#90） |
 | **A18 信標會報雲端接線缺陷** | 總管 | ✅ 14/14（2026-08-28，inkstone/ISEP#90） |

docs/hooks-inventory.md

@@ -1,4 +1,4 @@
-# 61 支閘，白話盤點表
+# 63 支閘，白話盤點表
 
 > 回應 `inkstone/InkStoneCo#40`：「如果加入了，我應該可以白話文看到 hooks 的內容？」
 > 這份表就是那個「白話文」——不用點開任何 `.sh` 檔，一行看懂一支閘在管什麼。
@@ -7,10 +7,27 @@
 
 ## 一句話結論
 
-`hooks/` 底下有 **61 個 `.sh` 檔**，`hooks.json` 實際掛上 **84 條註冊**（同一支閘常被多種情境同時掛上）；
+`hooks/` 底下有 **63 個 `.sh` 檔**，`hooks.json` 實際掛上 **86 條註冊**（同一支閘常被多種情境同時掛上）；
 其中 **3 支檔案存在但沒被掛上**（2 支是待人填的空範本、1 支是刻意留著沒開的止血帶，見下面「未生效」表）。
 下面按「你會在什麼時候撞到它」分組，一支一行。
 
+> 📌 **`inkstone/ISEP#122`（2026-09-02）進來兩支、＋2 條**：`kv-write-guard.sh`（B 組，
+> 2026-08-25 立於 InkStoneCo 專案版，原樣搬進來）與 `duplicate-hook-registration-guard.sh`
+> （E 組，這次新寫）。61→**63** 支、84→**86** 條，兩個數字都是加完之後**在自己的樹上當場數出來的**
+> （`ls hooks/*.sh | wc -l`／`grep -c '"command":' hooks/hooks.json`），不是拿上一版加二。
+>
+> 這張票查的是「總管三次要部署被 `prod-write-guard.sh` 恆擋、蓋了戳記也放不了行」，
+> 根因不在 `prod-write-guard.sh` 本身，而在 `InkStoneCo/.claude/settings.json`
+> 還登記著一份跟 ISEP plugin 同名的舊 hook——每個 `PreToolUse` 事件都跑了**兩次**，
+> 一次性戳記被第一份消耗掉，第二份永遠看到空戳記、恆擋。實查：專案版登記著 38 支，
+> **34 支跟 plugin 完全同名同用途**（純殘骸，已從 `InkStoneCo/.claude/settings.json`
+> 刪除登記）、**3 支是已經退役的機制**（`claim-verify-police.sh`／
+> `subagent-claim-worksheet.sh`／`sdd-guard.sh`，同樣刪除）、
+> **1 支（`kv-write-guard.sh`）是專案版有、plugin 當時沒有的真閘**——原樣搬進本 repo，
+> 這就是這次 B 組新增的那一支。`duplicate-hook-registration-guard.sh` 是防復發的機械閘：
+> 下次任何專案的 `settings.json` 又長出跟 plugin 同名的登記，SessionStart 就會點名，
+> 不必再靠「戳記莫名其妙失效」這種事後除錯才發現。
+>
 > 🔴 **這兩個數字上一版是錯的（2026-08-26 實際數過才發現）**：本頁原本寫「43 個檔、53 條註冊」，
 > 而當時真實是 **45 個檔、55 條註冊**——中間有兩支閘進來時沒有回頭改這裡。
 > 現在的寫法是實際數出來的：
@@ -145,6 +162,7 @@
 | `mistake-needs-ticket-guard.sh` | AI 想往 `mistakes.md`（教訓紀錄）新增一條「機制可以防止」的教訓，卻沒附對應票號就擋下——沒有票號的教訓沒有人會回頭處理。 | 🛑 擋 |
 | `wiki-size-guard.sh` | AI 想**一口氣砍掉 wiki 檔一大半內容**（淨縮水超過 800 字且超過原本 45%）就擋一次——那不是一次編輯，那是一次壓縮，而**壓縮會弄丟東西，弄丟的當下沒有人會發現**。出路是走 `scripts/wiki-compress`：它逼你附票號、把壓掉了什麼寫進 `.compress-log.md`，並用內文雜湊**逐條對帳**證明沒弄丟。只是改字、加字、小修一律不碰；真要手改就在內容裡放 `wiki-compress-ok` 留痕。 | 🛑 擋（至多攔一次） |
 | `pending-changes-retired.sh` | AI 想寫東西進已經廢除的 `pending-changes.md` 檔案就擋下——這個檔案已停用，規格變更一律改開 Gitea 票。 | 🛑 擋 |
+| `kv-write-guard.sh` | AI 想新增一行「往 KV 綁定寫入」的程式碼（`大寫識別字.put(`／`.delete(`）就擋下——長效資料一律要走 KBDB API，KV 只是暫存。判準是形狀（全大寫識別字 ＋ `.put`／`.delete`），不是列名字清單；只讀（`.get`／`.list`）放行，刪除既有 KV 寫入（退休戰）也放行。真的是短命資料（session／nonce／有 TTL 的快取）在那一行尾端加 `kv-ok: <為什麼>` 留痕放行。2026-08-25 立於 InkStoneCo 專案版，`inkstone/ISEP#122` 原樣搬進本 repo。 | 🛑 擋 |
 
 > 🔴 **`sdd-guard.sh` 已於 `inkstone/ISEP#91` 退役**（原本掛在這一組）。
 > 它擋的是「動 code 檔時，`status: active` 的 SDD 不是恰好一份」。
@@ -209,6 +227,7 @@
 | `overdue-nag-guard.sh` | 對話一開始就去 Gitea 撈**沒有人會叫的事**：逾期的 milestone、掛著等你的票（標「等了幾天」）、標著「有人在做」卻好幾天沒動的票；撈完用白話講出來，**有事就發 Telegram 給你**。沒東西可報時它會說「查過了，沒有」——**安靜跟壞掉長得一模一樣**。發不出去時不會靜默：它會先問這個 session 的 `prod-write-guard` 會不會擋（舊版把「發通知」誤認成「部署」），擋就改貼回票上並把原文印在眼前。只在開 session 時跑一次，**不輪詢、不掛排程**。 | 📝 記錄（context 注入 ＋ Telegram） |
 | `wiki-size-guard.sh` | 對話一開始講出「哪幾個 wiki 檔已經沒有人讀得完了」（預設超過 1200 行就點名）。**讀不完的必讀檔，跟沒有那個檔的差別只在於它讓人以為有。** 另一半掛在寫檔上，見 B 組。 | 📝 記錄（context 注入） |
 | `skill-deploy-drift-guard.sh` | 如果「全機真正在用的 skill」跟「repo 裡版控的正本」內容對不上，就在開場講出來——避免用著一份沒人知道已經跟正本分家的舊拷貝。 | 📝 記錄 |
+| `duplicate-hook-registration-guard.sh` | 如果這個專案自己的 `.claude/settings.json` 還登記著跟 ISEP plugin 同名的舊 hook，就在開場點名是哪幾支——**同一個動作跑兩次**，多數閘只是白跑，但帶「蓋一次戳記只放行一次」語意的閘會被第一份吃光，第二份永遠看到空戳記、恆擋（`inkstone/ISEP#122` 就是這樣，2026-09-01 撞了三次才被抓到）。判準是「有沒有真的註冊」，不是「檔案存不存在」。 | 📝 記錄（context 注入） |
 
 ## F. AI 想結束這一輪、要收工的時候（Stop）
 

hooks/duplicate-hook-registration-guard.sh

@@ -0,0 +1,68 @@
+#!/usr/bin/env bash
+# duplicate-hook-registration-guard.sh — SessionStart：這個專案自己的 .claude/settings.json
+# 是不是還在登記一支跟 ISEP plugin 同名的舊 hook（inkstone/ISEP#122）
+#
+# 為什麼存在（2026-09-01 實撞）：
+#   總管三次要部署 uncle6.me，三次被 prod-write-guard.sh 擋。leo 問「你沒有權限？」
+#   ——不是沒權限，是 InkStoneCo/.claude/settings.json 裡還留著 ISEP 立 plugin 之前
+#   的舊登記，跟 plugin 自己的 hooks.json 同時掛在同一個事件上，於是每個 PreToolUse
+#   都跑了**兩次**：一次由專案版、一次由 plugin。多數閘只是白跑一次沒感覺，
+#   但**帶「蓋一次戳記只放行一次」語意的閘會被第一份吃光**——第二份永遠看到空的戳記，
+#   於是恆擋。查證見 ISEP#122：37 支專案版登記裡，34 支跟 plugin 完全同名同用途、
+#   3 支是已經退役的機制（`claim-verify-police.sh`／`subagent-claim-worksheet.sh`／
+#   `sdd-guard.sh`），全部清掉；剩下 1 支（`kv-write-guard.sh`）是專案版有、plugin
+#   當時沒有的真閘，已原樣搬進本 repo（同一輪 commit）。
+#
+# 🔑 這支 hook 的用途不是清除，是**讓「又長出重複掛載」這件事有人立刻知道**。
+#    上一次它能存活 13 天沒被發現，就是因為除了「戳記莫名其妙失效」以外沒有任何
+#    訊號會指出來——一支天天在跑的閘，跟一支不存在的閘，行為長得一模一樣。
+#
+# 三條設計約束（跟 skill-deploy-drift-guard.sh 同一個形狀）：
+#   1. 沒事不出聲——乾淨時完全靜音。
+#   2. 從不擋人——SessionStart 一律 exit 0，這是通知，不是閘。
+#   3. 判準是「登記在不在」，不是關鍵字——比對的是 hooks.json／settings.json
+#      裡實際出現的檔名，不是靠猜或列黑名單（isep-hand 紅線：不准用關鍵字黑名單）。
+
+set -uo pipefail
+
+ROOT="${CLAUDE_PLUGIN_ROOT:-}"
+[ -n "$ROOT" ] || exit 0
+[ -f "$ROOT/hooks/hooks.json" ] || exit 0
+
+PROJ="${CLAUDE_PROJECT_DIR:-}"
+[ -n "$PROJ" ] || exit 0
+SETTINGS="$PROJ/.claude/settings.json"
+[ -f "$SETTINGS" ] || exit 0
+
+# ISEP plugin 自己「真的註冊了」的 hook 檔名（不是目錄列表——目錄裡可能有沒掛的樣板）
+PLUGIN_NAMES="$(grep -oE 'hooks/[a-zA-Z0-9._-]+\.sh' "$ROOT/hooks/hooks.json" 2>/dev/null \
+  | sed 's|.*/||' | sort -u)"
+[ -n "$PLUGIN_NAMES" ] || exit 0
+
+# 這個專案自己的 settings.json 裡，指向 .claude/hooks/ 底下的登記
+PROJECT_NAMES="$(grep -oE '\.claude/hooks/[a-zA-Z0-9_.-]+\.sh' "$SETTINGS" 2>/dev/null \
+  | sed 's|.*/||' | sort -u)"
+[ -n "$PROJECT_NAMES" ] || exit 0
+
+DUPES="$(comm -12 <(printf '%s\n' "$PLUGIN_NAMES") <(printf '%s\n' "$PROJECT_NAMES") 2>/dev/null || true)"
+[ -n "$DUPES" ] || exit 0
+
+N=$(printf '%s\n' "$DUPES" | grep -c .)
+LIST="$(printf '%s\n' "$DUPES" | sed 's/^/   • /')"
+
+cat <<EOF
+🔁 重複掛載警報：\`$SETTINGS\` 還登記著 ${N} 支跟 ISEP plugin 同名的舊 hook。
+
+$LIST
+
+⇒ 每個對應的動作都會**跑兩次**——一次由這份專案版複本、一次由 plugin。
+   多數閘只是白跑一次；**帶「蓋一次戳記只放行一次」語意的閘會被第一份吃光**，
+   第二份永遠看到空戳記，於是恆擋——這正是 inkstone/ISEP#122 那次的形狀。
+
+出路（二選一，不是「留著沒關係」）：
+  ① 這幾支 plugin 已經覆蓋 → 從 \`$SETTINGS\` 的 hooks 區段刪掉這幾條登記。
+  ② 專案版身上還有 plugin 沒有的邏輯 → 先把那段邏輯併進 ISEP（開票、比照
+     kv-write-guard.sh 那次的搬法），plugin 升版裝上之後再刪專案版登記。
+  **不要讓兩份同時掛著**——那正是這支閘存在的理由。
+EOF
+exit 0

hooks/hooks.json

@@ -126,6 +126,10 @@
           {
             "type": "command",
             "command": "${CLAUDE_PLUGIN_ROOT}/hooks/wiki-size-guard.sh"
+          },
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/kv-write-guard.sh"
           }
         ]
       },
@@ -288,6 +292,10 @@
           {
             "type": "command",
             "command": "${CLAUDE_PLUGIN_ROOT}/hooks/wiki-size-guard.sh"
+          },
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/duplicate-hook-registration-guard.sh"
           }
         ]
       }

hooks/kv-write-guard.sh

@@ -0,0 +1,115 @@
+#!/bin/bash
+# PreToolUse hook（Write|Edit|MultiEdit）— 長效資料不准寫進 KV，一律走 KBDB API
+#
+# 【portage 記錄，inkstone/ISEP#122】本檔 2026-08-25 立於
+# `InkStoneCo/.claude/hooks/kv-write-guard.sh`（那時 ISEP 還沒吸收它），
+# 2026-09-02 原樣搬進 ISEP——它是那次盤點揪出來的**唯一一支**「專案版有、
+# plugin 沒有」的真閘（另外 3 支同名殘骸是已退役機制，直接刪掉，不搬）。
+# 搬完之後 `InkStoneCo/.claude/hooks/kv-write-guard.sh` 就是廢棄複本，
+# 待這裡升版、`/plugin update` 裝上之後即可從專案版與 settings.json 一併移除。
+#
+# 【leo 2026-08-25 立】原話（三句，一句比一句尖）：
+#   「已經禁止寫入 KV 了，這是太貴的資源，應該都去寫入 KBDB，到底寫入 KV 做什麼？」
+#   「上次刪掉一堆東西，現在又寫入，**你沒有規範嗎**」
+#   「**我強制禁止寫 SQL，要用 KBDB API，你就讓它繞過寫 KV 代替？**」
+#
+# ── 為什麼存在（2026-08-25 實查，這是本閘的正身）─────────────────────────
+# 規則早就在：`system-dev/wiki/decisions-summary.md:133`
+#     「**KV ＝暫存（cache / transient），不是長期真相源。**」
+# 而且打過一場「KV 退休戰」（同檔 254 行，SUBMISSIONS_KV 併入那一役）。
+#
+# 🔴 **但 `.claude/hooks/` 底下跟 KV 有關的閘：0 支。**
+#    ⇒ 規則被讀到了，卻沒有任何機制驗證有沒有照做——與 2026-08-25 一整天挖出來的
+#      四層 migration 缺陷、以及 08-10 抓到的 history-first／KBDB-first／stage-first
+#      **完全同一個形狀**。
+#
+# 🔴 **更糟的是 leo 指出的因果**（總管用 git 查證屬實）：
+#      禁 SQL 的牆        2026-08-07
+#      app-system.ts 誕生 2026-08-24  ← 17 天之後，**從第一行就在寫 KV**
+#    而 `kbdbFetch()` 裡的 KV 字樣是 **0** ⇒ 走 KBDB API 根本不碰 KV
+#    ⇒ 那些 KV 寫入**每一處都是繞過**，沒有一處經過知識庫。
+#    **牆立起來了，水從旁邊流走了。**
+#
+# ── 判準（封動作，不封措辭）──────────────────────────────────────────
+#   新增一行「往 KV 寫入」的程式碼  ⇒ 擋一次，要求說明它為什麼不是長效資料
+#   只是讀（.get／.list）           ⇒ 放行
+#   刪除既有的 KV 寫入（退休戰）    ⇒ 放行（那正是我們要的方向）
+#
+# ── 豁免（留痕，不是後門）────────────────────────────────────────────
+#   那一行尾端加 `kv-ok: <理由>`。
+#   合法的理由只有一種形狀：**這筆資料本來就是短命的**（session、一次性 nonce、
+#   有 TTL 的快取）。寫「暫時先這樣」「之後再搬」都不算——
+#   那是把債留給下一個人，而 2026-08-25 證明了沒人會回來還。
+set -uo pipefail
+
+payload=$(cat)
+read -r tool content file <<<"$(printf '%s' "$payload" | python3 -c "
+import json,sys
+try:
+    d=json.load(sys.stdin); ti=d.get('tool_input') or {}
+    # Write 用 content；Edit 用 new_string；MultiEdit 把每筆 new_string 串起來
+    parts=[ti.get('content') or '', ti.get('new_string') or '']
+    for e in (ti.get('edits') or []): parts.append(e.get('new_string') or '')
+    body='\n'.join(p for p in parts if p)
+    print(d.get('tool_name','') or 'x', len(body), ti.get('file_path','') or 'x')
+    sys.stderr.write(body)
+except Exception:
+    print('x 0 x')
+" 2>/tmp/.kv-guard-body)" || exit 0
+
+body=$(cat /tmp/.kv-guard-body 2>/dev/null)
+rm -f /tmp/.kv-guard-body
+[ -z "$body" ] && exit 0
+
+# 只管程式碼檔；文件、設定、測試裡提到 KV 不算違規
+case "$file" in
+  *.ts|*.js|*.mjs|*.tsx|*.jsx) ;;
+  *) exit 0 ;;
+esac
+# 閘自己、與退休戰的測試檔放行（否則永遠改不動它）
+case "$file" in
+  *kv-write-guard*|*.test.*|*/tests/*) exit 0 ;;
+esac
+
+# 命中的行：往 KV 綁定寫入，且**該行沒有 kv-ok 豁免**
+# 判準是形狀不是名字：**全大寫的 binding 後面接 .put(／.delete(**。
+# 為什麼不列名字清單（第一版就是這樣寫壞的）：名字會長出新的（下一個 KV 綁定叫什麼沒人知道），
+# 而清單只認得已知的那幾個 ⇒ 新的 KV 從清單的縫隙走過去，本閘就變成裝飾。
+# 全大寫識別字 ＋ .put/.delete 這個形狀，在 Workers 裡就是 KV（D1 沒有 .put，JS 物件用 .set）。
+hits=$(printf '%s' "$body" | grep -nE '\b[A-Z][A-Z0-9_]{1,}\.(put|delete)\(' \
+        | grep -v 'kv-ok' || true)
+[ -z "$hits" ] && exit 0
+
+cat >&2 <<EOF
+🚫 長效資料不准寫進 KV——一律走 KBDB API（leo 2026-08-25 立）
+
+leo 原話：
+「**我強制禁止寫 SQL，要用 KBDB API，你就讓它繞過寫 KV 代替？**」
+「上次刪掉一堆東西，現在又寫入，**你沒有規範嗎**」
+
+━━ 你這次要寫的 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+$(printf '%s' "$hits" | head -6 | sed 's/^/   /')
+
+━━ 為什麼擋 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+規則早就在（\`system-dev/wiki/decisions-summary.md:133\`）：
+   **KV ＝暫存（cache / transient），不是長期真相源。**
+而 2026-08-25 實查：\`.claude/hooks/\` 底下跟 KV 有關的閘 **0 支**
+⇒ 規則被讀到了，卻沒有機制驗證有沒有照做。本閘就是補那一格。
+
+🔴 **並且**：\`kbdbFetch()\` 裡的 KV 字樣是 **0**——走 KBDB API 根本不碰 KV。
+   所以「寫 KV」在這個系統裡**必定意味著繞過知識庫**，不是一種實作選擇。
+   禁 SQL 的牆 2026-08-07 立，而 app-system 2026-08-24 誕生就在寫 KV
+   ——**牆立起來了，水從旁邊流走了。**
+
+━━ 怎麼過 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  ① **本來就該走 KBDB**（絕大多數）→ 改成 KBDB API。
+     新資料類型＝seed 一列 template，資料展開成完整 record，
+     **不准打包進 metadata_json**（D91／D93）。讀 \`arcrun-kbdb-guardrails\` skill。
+  ② **這筆資料真的是短命的**（session／一次性 nonce／有 TTL 的快取）
+     → 那一行尾端加 \`kv-ok: <為什麼它是短命的>\`，留痕放行。
+  ③ **你在做的是退休戰（刪掉 KV 寫入）** → 本閘不擋刪除，只擋新增。
+
+🔴 \`kv-ok: 暫時先這樣\` / \`之後再搬\` **不算理由**——那是把債留給下一個人，
+   而 2026-08-25 已經證明了沒人會回來還。
+EOF
+exit 2

hooks/tests/duplicate-hook-registration-guard.test.sh

@@ -0,0 +1,111 @@
+#!/usr/bin/env bash
+# duplicate-hook-registration-guard.sh 的迴歸測試（inkstone/ISEP#122）
+#
+# 這支閘的價值是「不吵的時候真的不吵，該吵的時候真的吵得出正確清單」——
+# 兩邊都要驗，而且全程用假的 plugin root／專案目錄，不碰真正的
+# InkStoneCo/.claude/ 或這台機器裝著的 ISEP plugin。
+set -u
+HOOK="${1:-$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)/duplicate-hook-registration-guard.sh}"
+PASS=0; FAIL=0; N=0
+
+check() { # check <說明> <輸出> <exit碼> <該出現|!不該出現>...
+  desc="$1"; out="$2"; code="$3"; shift 3; N=$((N+1)); ok=1; why=""
+  if [ "$code" != "0" ]; then ok=0; why="exit 應該是 0（這支從不擋人），實際是 $code"; fi
+  for w in "$@"; do
+    case "$w" in
+      "!"*) if printf '%s' "$out" | grep -qF -- "${w#!}"; then ok=0; why="不該出現卻出現了：${w#!}"; fi ;;
+      *)    if ! printf '%s' "$out" | grep -qF -- "$w"; then ok=0; why="少了：$w"; fi ;;
+    esac
+  done
+  if [ "$ok" = 1 ]; then printf '  ✅ %s\n' "$desc"; PASS=$((PASS+1))
+  else printf '  ❌ %s —— %s\n' "$desc" "$why"; printf '%s\n' "$out" | sed 's/^/     /'; FAIL=$((FAIL+1)); fi
+}
+
+# mkroot <名字...> → 造一份假 plugin root，hooks.json 裡真的註冊這些檔名
+mkroot() {
+  d="$TMP/root-$RANDOM"; mkdir -p "$d/hooks"
+  {
+    printf '{"hooks":{"PreToolUse":[{"matcher":"Bash","hooks":['
+    first=1
+    for n in "$@"; do
+      [ "$first" = 1 ] || printf ','
+      printf '{"type":"command","command":"${CLAUDE_PLUGIN_ROOT}/hooks/%s"}' "$n"
+      first=0
+    done
+    printf ']}]}}\n'
+  } > "$d/hooks/hooks.json"
+  printf '%s\n' "$d"
+}
+
+# mkproj <名字...> → 造一份假專案目錄，settings.json 裡登記這些檔名
+mkproj() {
+  d="$TMP/proj-$RANDOM"; mkdir -p "$d/.claude"
+  {
+    printf '{"hooks":{"PreToolUse":[{"matcher":"Bash","hooks":['
+    first=1
+    for n in "$@"; do
+      [ "$first" = 1 ] || printf ','
+      printf '{"type":"command","command":"$CLAUDE_PROJECT_DIR/.claude/hooks/%s"}' "$n"
+      first=0
+    done
+    printf ']}]}}\n'
+  } > "$d/.claude/settings.json"
+  printf '%s\n' "$d"
+}
+
+run() { # run <root> <proj>
+  out=$(CLAUDE_PLUGIN_ROOT="$1" CLAUDE_PROJECT_DIR="$2" bash "$HOOK" 2>&1)
+  code=$?
+  printf '%s\x1e%s' "$out" "$code"
+}
+
+TMP=$(mktemp -d); trap 'rm -rf "$TMP"' EXIT
+
+echo "── 該吵 ──────────────────────────────────────────────────────"
+
+R=$(mkroot prod-write-guard.sh github-contact-guard.sh)
+P=$(mkproj prod-write-guard.sh other-thing.sh)
+o=$(run "$R" "$P"); out="${o%$'\x1e'*}"; code="${o##*$'\x1e'}"
+check "① 專案版跟 plugin 同名一支 → 點名那一支" "$out" "$code" \
+  "重複掛載警報" "1 支" "prod-write-guard.sh" "!github-contact-guard.sh" "!other-thing.sh"
+
+R=$(mkroot a.sh b.sh c.sh)
+P=$(mkproj a.sh b.sh c.sh)
+o=$(run "$R" "$P"); out="${o%$'\x1e'*}"; code="${o##*$'\x1e'}"
+check "② 全部同名 → 三支都點名" "$out" "$code" "3 支" "a.sh" "b.sh" "c.sh"
+
+echo "── 不該吵（誤攔比漏擋嚴重）───────────────────────────────────"
+
+R=$(mkroot a.sh)
+P=$(mkproj z.sh)
+o=$(run "$R" "$P"); out="${o%$'\x1e'*}"; code="${o##*$'\x1e'}"
+check "③ 完全不重疊 → 靜音" "$out" "$code" "!重複掛載"
+
+R=$(mkroot a.sh)
+d="$TMP/proj-empty-$RANDOM"; mkdir -p "$d/.claude"; echo '{"hooks":{}}' > "$d/.claude/settings.json"
+o=$(run "$R" "$d"); out="${o%$'\x1e'*}"; code="${o##*$'\x1e'}"
+check "④ 專案沒登記任何 .claude/hooks/*.sh → 靜音" "$out" "$code" "!重複掛載"
+
+d="$TMP/proj-nosettings-$RANDOM"; mkdir -p "$d/.claude"
+o=$(run "$R" "$d"); out="${o%$'\x1e'*}"; code="${o##*$'\x1e'}"
+check "⑤ 專案根本沒有 settings.json → 靜音" "$out" "$code" "!重複掛載"
+
+o=$(CLAUDE_PROJECT_DIR="$(mkproj a.sh)" bash "$HOOK" 2>&1); code=$?
+check "⑥ 沒有 CLAUDE_PLUGIN_ROOT（不是 plugin 環境）→ 靜音" "$o" "$code" "!重複掛載"
+
+d="$TMP/root-nohooksjson-$RANDOM"; mkdir -p "$d/hooks"
+o=$(CLAUDE_PLUGIN_ROOT="$d" CLAUDE_PROJECT_DIR="$(mkproj a.sh)" bash "$HOOK" 2>&1); code=$?
+check "⑦ plugin root 沒有 hooks.json（環境不完整）→ 靜音" "$o" "$code" "!重複掛載"
+
+echo "── 判準是「登記」不是「檔案存在」──────────────────────────────"
+
+R=$(mkroot pre-write-guard.template.sh)  # 有這個檔但 hooks.json 沒收（樣板慣例）
+d="$TMP/root-unreg-$RANDOM"; mkdir -p "$d/hooks"; echo '{"hooks":{}}' > "$d/hooks/hooks.json"
+touch "$d/hooks/pre-write-guard.template.sh"
+P=$(mkproj pre-write-guard.template.sh)
+o=$(run "$d" "$P"); out="${o%$'\x1e'*}"; code="${o##*$'\x1e'}"
+check "⑧ plugin 有這個檔但沒真的註冊 → 不算重複，靜音" "$out" "$code" "!重複掛載"
+
+echo ""
+echo "── 結果：$PASS 通過 / $FAIL 失敗（共 $N）──"
+[ "$FAIL" -eq 0 ]

hooks/tests/kv-write-guard.test.sh

@@ -0,0 +1,62 @@
+#!/usr/bin/env bash
+# kv-write-guard.sh 的迴歸測試（inkstone/ISEP#122 搬進 ISEP 時補上——
+# 原檔 2026-08-25 立於 InkStoneCo 專案版，搬過來之前沒有自動化測試）。
+set -u
+HOOK="${1:-$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)/kv-write-guard.sh}"
+PASS=0; FAIL=0; N=0
+
+# run <tool> <file_path> <content>  → 送一個 Write 事件的 payload
+run() {
+  python3 -c '
+import json,sys
+tool, fp, content = sys.argv[1], sys.argv[2], sys.argv[3]
+print(json.dumps({"tool_name": tool, "tool_input": {"file_path": fp, "content": content}}))
+' "$1" "$2" "$3" | bash "$HOOK" 2>&1
+  echo "EXIT:$?"
+}
+
+check() { # check <說明> <輸出+EXIT行> <該擋(2)|該放行(0)> <該出現|!不該出現>...
+  desc="$1"; out="$2"; want="$3"; shift 3
+  code="$(printf '%s\n' "$out" | grep -oE 'EXIT:[0-9]+' | tail -1 | cut -d: -f2)"
+  N=$((N+1)); ok=1; why=""
+  if [ "$code" != "$want" ]; then ok=0; why="要 exit $want，實際 $code"; fi
+  for w in "$@"; do
+    case "$w" in
+      "!"*) if printf '%s' "$out" | grep -qF -- "${w#!}"; then ok=0; why="$why 不該出現卻出現：${w#!}"; fi ;;
+      *)    if ! printf '%s' "$out" | grep -qF -- "$w"; then ok=0; why="$why 少了：$w"; fi ;;
+    esac
+  done
+  if [ "$ok" = 1 ]; then printf '  ✅ %s\n' "$desc"; PASS=$((PASS+1))
+  else printf '  ❌ %s ——%s\n' "$desc" "$why"; printf '%s\n' "$out" | sed 's/^/     /'; FAIL=$((FAIL+1)); fi
+}
+
+echo "── 該擋：往 KV binding 寫入 ──────────────────────────────────"
+out=$(run "Write" "src/app-system.ts" $'export async function save() {\n  await MY_KV.put("k", "v");\n}')
+check "① 全大寫 binding.put( → 擋" "$out" 2 "長效資料不准寫進 KV" "MY_KV"
+
+out=$(run "Edit" "src/app-system.ts" $'const x = 1;\nSESSION_KV.delete(id);')
+check "② .delete( 一樣擋" "$out" 2 "長效資料不准寫進 KV"
+
+echo "── 不該擋（誤攔比漏擋嚴重）───────────────────────────────────"
+
+out=$(run "Write" "src/app-system.ts" 'const v = await MY_KV.get("k");')
+check "③ 只是讀（.get）→ 放行" "$out" 0 "!長效資料不准寫進 KV"
+
+out=$(run "Write" "src/app-system.ts" 'MY_KV.put("k", v); // kv-ok: session nonce，有 TTL')
+check "④ 加了 kv-ok 豁免留痕的那行 → 放行" "$out" 0 "!長效資料不准寫進 KV"
+
+out=$(run "Write" "README.md" 'MY_KV.put("k", "v")')
+check "⑤ 非程式碼檔（.md）→ 放行" "$out" 0 "!長效資料不准寫進 KV"
+
+out=$(run "Write" "src/kv-write-guard.test.ts" 'MY_KV.put("k", "v")')
+check "⑥ 閘自己的測試檔 → 放行" "$out" 0 "!長效資料不准寫進 KV"
+
+out=$(run "Write" "src/app-system.ts" 'const config = { retries: 3 };')
+check "⑦ 完全不提 KV 的一般程式碼 → 放行" "$out" 0 "!長效資料不准寫進 KV"
+
+out=$(run "Write" "src/app-system.ts" 'this.myKv.put("k", "v"); // 小寫 binding，不是本閘要的形狀')
+check "⑧ 小寫變數名（不是「全大寫識別字」形狀）→ 放行" "$out" 0 "!長效資料不准寫進 KV"
+
+echo ""
+echo "── 結果：$PASS 通過 / $FAIL 失敗（共 $N）──"
+[ "$FAIL" -eq 0 ]

hooks/tests/sdd-guard-retired.test.sh

@@ -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
 

scripts/make-cloud-env.sh

@@ -10,9 +10,63 @@
 set -euo pipefail
 
 # ── 雲端需要哪些變數（只有名字。要加就加在這裡）──────────────────
+#
+# 範圍＝**youlin（stage）與 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
+#      ＝真的部署得動」**沒驗**（驗它必須寫入，那是紅線）。缺這格會在部署當下才知道。
 NEEDED=(
-  GITEA_TOKEN_CLAUDE_CODE      # 機器帳號 claude-code 的 Gitea token；bootstrap 與 plugin 安裝都靠它
+  # ── 機器帳號 ──
+  GITEA_TOKEN_CLAUDE_CODE                # claude-code 的 Gitea token；bootstrap 與 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                  # ⚠️ 密碼類，見下面那條限制
+
+  # ── geek6688 ＝ 測試 prod ＆ 出貨機 ──
+  CLOUDFLARE_API_TOKEN_CC_SHIPPING_CORE  # 出貨線寫入用
+  CLOUDFLARE_ACCOUNT_ID_GEEK6688         # 上面那把的配對 account id
+
+  # ── uncle6 ＝ 出貨三站真正部署到的帳號（installer／docsSite／mailRelay，stage 與 prod 都是）──
+  UNCLE6_CF_API_KEY                      # 住在 products/arcrun-rag/.env；本機是靠 ~/.wrangler 的 OAuth 登入態出貨，那個檔不隨 clone 走
+
+  # ── Arcrun 出貨線的實例座標（inkstone/Arcrun#195 起）──
+  #    網址隨 repo 走（Arcrun 的 shared/instance-coordinates/instances.json），
+  #    只有 namespace 是機敏 ⇒ 走環境變數。原本只住在 ~/.arcrun/config.yaml 的 api_key，
+  #    那個檔在家目錄、不隨 clone 走 ⇒ 雲端永遠拿不到。
+  ARCRUN_NS_YOULIN                       # youlin 實例的 namespace（X-Arcrun-API-Key）
 )
+#
+# 🔴 這份清單的邊界——加一把之前先問「這把打得到哪個實例」，不是「這把方便嗎」
+#
+#    可以進來的：**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}"

scripts/test-make-cloud-env.sh

@@ -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 "$3：want=$1 got=$2"; }
+
+# 清單與搜尋路徑都從腳本本身讀出來——測試不另養一份，養了就會漂。
+# 註：macOS 內建的是 bash 3.2，沒有 mapfile／readarray，一律用 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/.env（leo21c 正式環境）"
+
+  # 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 ]

system-dev/wiki/mistakes.md

@@ -199,3 +199,33 @@ leo 當場：「**這些為什麼不寫到票裡？**」
 📌 推廣：**一支閘的價值是「擋下來 ＋ 給一條走得通的路」。**
 出路走不通時它不是幫你，是擋你——而被擋的人不會停下來修閘，
 他會去找繞過去的方法。所以「出路能不能跑」要跟「判準準不準」一樣被測。
+## ⚠️ MISTAKE: 「雲端該有哪些憑證」的清單是唯一真相源，卻沒有任何東西在跟機器對帳
+
+票: `inkstone/ISEP#115`（→ comment `5522`／`5526`）
+日期: 2026-09-01
+
+症狀: 雲端 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 裡任何「這台機器該有什麼」的清單，都要有一支東西定期拿它去問機器。
+   清單自己不會知道它漏了什麼。