test-gitea-token：「不設 CLAUDE_PROJECT_DIR」的案例要真的 -u 掉（inkstone/ISEP#47）

在 Claude Code session 裡跑（CLAUDE_PROJECT_DIR 一定有值），③④⑤ 六條會繼承到 InkStoneCo，
解到真的 token ⇒ 10/16。改成空值時 env -u CLAUDE_PROJECT_DIR（-u 排在 NAME=VALUE 前面）。
驗：不設／設成 InkStoneCo／環境裡另有 token 三種都 16/16。

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

README.md

@@ -27,7 +27,7 @@
 | `agents/` | 8 位 | **工人名單**（`inkstone/ISEP#86`）——派工時指名派給誰，規約見 `docs/governance/worker-roster.md` |
 | `commands/` | 7 支 | `/wiki-recall` `/wiki-capture` `/cp-write` `/issue-handle` … |
 | `skills/` | 2 支 | `ship-check`（東西要出去之前）／`deep-recall`（把散落的枝葉還原成一棵樹）。🔴 **這兩支的內容不一定是在這裡寫的**——誰是真相源查 `docs/file-ownership.tsv` |
-| `scripts/` | 65 支 | `ticket`／`roster`／`isep-nag`／`wiki-compress`／`github-arm.sh` …（頂層檔案，不含 `lib/` 等子目錄） |
+| `scripts/` | 68 支 | `ticket`／`roster`／`isep-nag`／`wiki-compress`／`github-arm.sh` …（頂層檔案，不含 `lib/` 等子目錄） |
 
 > 🔴 這五個數字**每次都要在自己的樹上實數**，不准沿用上一版、也不准用加減推
 > （`system-dev/wiki/mistakes.md`：那是 leo 的驗收介面，多報就是假綠）：

docs/TESTING.md

@@ -1017,6 +1017,27 @@ bash hooks/tests/isep-presence-beacon.test.sh        # ㉗–㉝ 那七條
 **真實跑（2026-09-07）**：信標不帶 fixture 打真 Gitea（匿名）→ 安靜（v0.24.0 tag＋release 都在），
 留下 `.isep-chain-ok-v0.24.0` 快取；`release-check` 在本分支 → `v0.24.0 ✅✅✅ ←`、三個裁定不補的版本標 ⏭、exit 0。
 
+### A44 — Gitea token 只從 env／.env 來，絕不從 remote URL 抽：16 條
+```
+bash scripts/test-gitea-token.sh
+```
+**該看到**：`通過 16 條，失敗 0 條（共 16 條）`。全程離線（自己在 TMP 造 git repo 與 `.env`），
+**不打 Gitea、不碰 $HOME**。Python（`hooks/lib/gitea_token.py`）與 shell（`scripts/lib/gitea-token.sh`）
+兩份實作對同一組情境各測一次，順序必須一致。
+
+**它在守什麼**（`inkstone/ISEP#47` → comment 9128）：洩漏源是「token 明文嵌在 remote URL 裡」，
+任何印出 remote 的訊息（git-lfs 的 `locksverify` 那行）都會洩一次。前一輪只改了 6 支 shell、
+漏了 8 支 Python（`ticket`／`debt-worklist`／`milestone-account`／`pr-verdict`／`release-manifest`／
+`isep-nag`／`isep-notify`／`hooks/lib/release_chain.py`），且雲端有環境變數所以測不出本機（只有 `.env`）的壞法：
+remote 清乾淨後那 8 支會靜默拿到空字串 → 401，正是票上 2026-08-13「被讀成找不到／不存在」那種壞法。
+① env 在就用 env；②③ 沒 env 時退到 `$CLAUDE_PROJECT_DIR/.env`、再退 git 根的 `.env`（本機 Mac 的實況）；
+④ **token 只在髒 remote 的 URL 裡時，解析器必須解不出**（否則洩漏源還在）；八支腳本在「無 env＋乾淨 remote＋`.env` 有」下都要走得過 token 步。
+
+**失敗**：
+- ② 紅 ⇒ 本機（只有 `.env`）拿不到 token，八支會整支停擺或靜默失效——就是 c9128 攔下不可併的那個病
+- ④ 紅 ⇒ **洩漏源沒斷**：還在從 remote URL 抽 token，ISEP#47 等於沒修
+- 八支任一條「死在 token 步」⇒ 那支在乾淨 remote 的本機上用不了
+
 ### A39 — D20 閘判「push 到哪」看的是指令實際會推的那個 repo：26 條
 ```
 bash scripts/test-github-contact-guard.sh
@@ -1339,30 +1360,6 @@ bash hooks/tests/gitea-arm-to-github-armed.test.sh .
 - ④ 前兩條紅 ⇒ **沒拿到核准也寫了保險**——這是 D20 等級的洞，最嚴重
 - ④ ★ 紅 ⇒ 擋下之後教的指令又印回相對路徑（站在 InkStoneCo 會叫到舊複本，`inkstone/ISEP#112` 同病）
 
-### A43 — 前端驗證閘先看這台有沒有瀏覽器能力，再要求用它：14 條
-```
-bash hooks/tests/browser-verify-guard.test.sh
-```
-**該看到**：`通過 14 ／ 失敗 0`。**全程離線**：在 `mktemp` 裡造假 transcript，
-瀏覽器能力用環境變數（`CLOUDFLARE_API_TOKEN_YOULIN_CC_USE`／`CLOUDFLARE_ACCOUNT_ID_YOULIN`）
-在場與否來扮演，session 各自帶 id、跑完清掉 `/tmp/.browser-cap-warned-*`。**不打網路、不碰真 repo。**
-
-**它在守什麼**（`inkstone/ISEP#121`，2026-09-01 實撞）：舊版每回合都要求
-`mcp__Claude_Browser__*`，但那套工具在雲端這台**叫不出來**、容器內 chromium 也連不出去
-（`ERR_TUNNEL_CONNECTION_FAILED`）⇒ 它一整天每回合都在懲罰一個「這台辦不到」的要求。
-現在閘先判斷「這個 session 有哪種瀏覽器能力」（CF Browser Rendering 的兩個 env／
-transcript 出現過 `Claude_Browser__`），**有能力才要求用它，且教實際可用的那一種**；
-一種都沒有時訊息改成「缺什麼、怎麼補」，且**每個 session 只提醒一次**。
-
-**失敗**：
-- C 群「第二次（同 session）放行」紅 ⇒ 沒能力時仍每回合誤攔，ISEP#121 的主症狀沒解，
-  **這比漏擋嚴重**（一支天天誤擋的閘會被學會忽略）
-- B 群「有 CF 能力沒用它 ⇒ 教 CF 不是 MCP」紅 ⇒ 閘又去教這台叫不出來的那套工具
-- C 群「第一次提醒缺什麼怎麼補」紅 ⇒ 沒能力時的出路（找 leo 加 `Browser Rendering: Edit`／
-  明說「本次無前端」）沒印出來，撞到的人不知道怎麼走
-- A 群「用過某種瀏覽器能力就放行」任一紅 ⇒ 真的看了畫面卻還被擋，誤攔
-- fail-open 任一紅 ⇒ 壞輸入會亂擋
-
 ---
 
 ## B. 只有 leo 能跑的（雲端）

docs/hooks-inventory.md

@@ -286,7 +286,7 @@
 | `mainline-idle-guard.sh` | AI **連續 4 個回合一直在查、一直在讀，卻什麼都沒交出去**（沒派工、沒改檔、沒寫回票）就擋一次。補的是上面兩支中間那一格：「沒動作」空手警察管、「說了下一步卻沒派」稼動率警察管，**而「有動作、但就是不說下一步」以前兩支都放行**。這支**一個字都不讀**，只看有沒有派工／產出／工作區變動。響過一次門檻就加倍（4→8→16），不會變成一直在響的警報。 | 🛑 擋（響過就退讓） |
 | `pr-verdict-guard.sh` | 收工時清點「還有哪些 PR 沒有結論」——open、**沒有人被指派**、也沒有「要求修改」review 的 PR，就擋一次並**點名是哪幾個**（含開了幾天與網址）；已經 merge 但**分支還留著**的也一起點名（票上寫死「併完當場刪掉那條 branch」）。背景：2026-08-27 實查，最久的三個 open PR 躺了兩星期，而當時 46 支閘沒有一支在管 PR——票看起來「已交付」，東西卻沒進 main、沒進版本，**leo 手上永遠不會出現它**。🔴 **擋的是遺忘，不是等待**：指派給誰（或掛 Human）就立刻不再點名它；響過門檻就加倍（1→4→8→16，每個 PR 各自算）。搭配 `scripts/pr-verdict`（merge／reject／changes 各一個動作）。 | 🛑 擋（響過就退讓） |
 | `countdown-guard.sh` | **每一則回覆都自己說出「這件事已經花了多久／距今天收工線還剩多久」**，而且不必有人記得。一支閘掛兩個事件：你送出訊息時它先把算好的那一行放到 AI 眼前（`UserPromptSubmit`），AI 想收工時它再看這一回合的回覆裡到底有沒有那一行，沒有就擋一次要它補（`Stop`）。**只做前半 ＝ 又一個會被忽略的提醒**，所以兩半綁在一起。已過時間從**這段對話的第一則訊息**算起（＝一個 release 的起點）；收工線是台北 16:00，過線後四小時內顯示「已超過」，不會把超時悄悄換算掉。子 session、純工具回合、已經提醒過一次的，全部放行。**同一個注入點還帶第二行 `🎯 現在的主線是哪一個`**（`inkstone/ISEP#82`）——那一行沒有另外立閘，因為主線的名字本來就掛在被查核的 ⏱ 那一行上。 | 🛑 擋（至多攔一次） |
-| `browser-verify-guard.sh` | 這一輪 AI 宣稱「前端驗過了」，卻沒有真的用瀏覽器載入過，就擋下——`curl` 抓到 HTML 不算驗過。🔴 **先看這個 session 有哪種瀏覽器能力再要求用它**（`inkstone/ISEP#121`）：CF Browser Rendering（兩個 CF env 在場）／Browser MCP（transcript 出現過 `Claude_Browser__`）／容器內 chromium（雲端實測連不出去，不當能力）。有能力沒用它 ⇒ 擋，且教**實際可用的那一種**（雲端＝CF 的 `browser-rendering` 端點，不是叫不出來的 MCP）；**一種能力都沒有** ⇒ 訊息改成「缺什麼、怎麼補」（找 leo 幫 token 加 `Browser Rendering: Edit`／明說「本次無前端」），且**每個 session 只提醒一次**，不再每回合誤攔。 | 🛑 擋（沒能力時每 session 至多攔一次） |
+| `browser-verify-guard.sh` | 這一輪 AI 宣稱「前端驗過了」，卻沒有真的用瀏覽器工具載入過，就擋下——`curl` 抓到 HTML 不算驗過。 | 🛑 擋 |
 | `self-drive-police.sh` | AI 想停下來問你「早就決定過的事」（用固定句型判斷，例如「要不要 X」「下一步做什麼」「這交給你」）就擋下，反問它查過 wiki／查過派工表了沒。 | 🛑 擋 |
 | `self-drive-judge.sh` | 跟上面同一件事，但改用小模型（haiku）判斷「換句話說」的請示句——防止 AI 只是把「要不要」改寫成「不確定是否符合期待」就閃過上一支閘。 | 🛑 擋 |
 | `delivery-police.sh` | AI 宣稱「這件事做完了」，卻看不到任何實測證據（畫面截圖、指令輸出、HTTP 狀態碼…）就擋下。 | 🛑 擋 |

hooks/baton-handback-guard.sh

@@ -149,16 +149,12 @@ check_one(){ # $1 owner $2 repo $3 num
     J=$(cat "$BATON_GUARD_FIXTURE/issue.json")
     C=$(cat "$BATON_GUARD_FIXTURE/comments.json")
   else
-    # token：掃已知的 checkout 找第一個帶憑證、指向本站的 remote（同 scripts/ticket 的做法）
-    local ROOT="${CLAUDE_PROJECT_DIR:-$(pwd)}" URL="" U dir TOKEN
-    for dir in "$ROOT" "$ROOT/products/$REPO" "$ROOT/matrix/$REPO" "$ROOT/polaris/$REPO"; do
-      [ -e "$dir/.git" ] || continue
-      U=$(git -C "$dir" remote -v 2>/dev/null | grep -m1 'git\.uncle6\.me' | grep '@' | awk '{print $2}') || true
-      [ -n "${U:-}" ] && { URL="$U"; break; }
-    done
-    [ -n "$URL" ] || return 0
-    TOKEN=$(printf '%s' "$URL" | sed -E 's|.*//[^:]+:([^@]+)@.*|\1|')
-    [ "$TOKEN" != "$URL" ] || return 0
+    # token：來源＝env／.env（inkstone/ISEP#47），不再從 remote URL 抽（那會逼 token 明文嵌在 URL 裡）
+    local TOKEN _GT_LIB
+    _GT_LIB="$(dirname -- "$0")/../scripts/lib/gitea-token.sh"; [ -f "$_GT_LIB" ] && . "$_GT_LIB"
+    command -v gitea_token >/dev/null 2>&1 || return 0
+    TOKEN=$(gitea_token) || return 0
+    [ -n "$TOKEN" ] || return 0
     J=$(curl -s --max-time 12 -H "Authorization: token $TOKEN" \
           "https://git.uncle6.me/api/v1/repos/$OWNER/$REPO/issues/$NUM" 2>/dev/null) || return 0
     C=$(curl -s --max-time 12 -H "Authorization: token $TOKEN" \

hooks/browser-verify-guard.sh

@@ -12,42 +12,21 @@
 #   ⇒ 判準升級：`HTTP 200 不算驗過` → `grep 到字串也不算驗過`
 #              → **只有「瀏覽器載入後看起來能用」才算**。
 #
-# ── inkstone/ISEP#121：閘要先看「這台有沒有瀏覽器能力」，再要求用它 ──────
-# 2026-09-01 實撞：這支閘每回合都要求 `mcp__Claude_Browser__*`，但那套工具
-#   **在雲端這台根本叫不出來**（ToolSearch：No matching deferred tools found），
-#   容器內 chromium 也連不出去（ERR_TUNNEL_CONNECTION_FAILED）。
-#   ⇒ 它一整天每回合都在懲罰一個「這台辦不到」的要求。
-#
-#   正解不是取消驗證，是**先判斷這個 session 有哪種瀏覽器能力，再教對應的那一種**：
-#     · CF Browser Rendering（雲端首選）＝ 環境變數 CLOUDFLARE_API_TOKEN_YOULIN_CC_USE
-#       ＋ CLOUDFLARE_ACCOUNT_ID_YOULIN 都在場（token 需 Browser Rendering: Edit）
-#     · Browser MCP ＝ 這個 session 的 transcript 出現過 Claude_Browser__* 工具
-#     · 容器內 chromium ＝ ISEP#121 實測雲端網路被擋，不可靠 → 不當能力來源
-#
-#   有能力才要求用它（且教實際可用的那一種）；**一種都沒有時**，訊息改成
-#   「缺什麼、怎麼補」，且**每個 session 只提醒一次**（stamp）——不再每回合誤攔。
-#
-# ── 判準是「有沒有用瀏覽器能力」這個動作，不是措辭 ──────────────────────
-#   驗過的證據（正向存在性檢查，任一種即放行）：
-#     · 這回合叫過 Claude_Browser__(preview_start|navigate|computer|…)
-#     · 這回合打過 CF 的 .../browser-rendering/... 端點
+# 機制：這回合若出現「前端驗過」類宣稱，就要求同一回合真的用過瀏覽器工具。
+#   有 curl 沒有瀏覽器 ⇒ exit 2。
 #
 # 逃生口：這次真的沒有前端可驗（純後端／純腳本）⇒ 在回覆裡明說「本次無前端」，
 #   本 hook 認得這句話就放行——留痕，不是默默略過。
 set -eu
 
-INPUT="$(cat 2>/dev/null || echo "")"
-[ -z "$INPUT" ] && exit 0
-
-# 這回合的文字＋工具名（最後 40 則）
-TURN="$(printf '%s' "$INPUT" | python3 -c '
+TURN="$(cat 2>/dev/null | python3 -c '
 import sys, json
 buf = []
 try:
     d = json.load(sys.stdin)
     t = d.get("transcript_path") or ""
     if t:
-        import os
+        import io, os
         if os.path.exists(t):
             for line in open(t, encoding="utf-8", errors="ignore").readlines()[-40:]:
                 try:
@@ -72,66 +51,16 @@ print("\n".join(buf))
 ' 2>/dev/null || echo "")"
 [ -z "$TURN" ] && exit 0
 
-# 整個 session 的 transcript 路徑與 session_id（能力偵測與 stamp 用）
-TP="$(printf '%s' "$INPUT" | python3 -c 'import sys,json
-try: print(json.load(sys.stdin).get("transcript_path") or "")
-except Exception: print("")' 2>/dev/null || echo "")"
-SID="$(printf '%s' "$INPUT" | python3 -c 'import sys,json,re
-try:
-    s=str(json.load(sys.stdin).get("session_id") or "nosid")
-    print(re.sub(r"[^A-Za-z0-9_.-]","_",s)[:64])
-except Exception: print("nosid")' 2>/dev/null || echo "nosid")"
-
-# ── 這回合有沒有「前端／畫面驗過」的宣稱？沒有就與本閘無關 ──
+# 有沒有「前端／畫面驗過」的宣稱？
 printf '%s' "$TURN" | grep -qiE '前端(驗|測|複驗|確認)|畫面(驗|確認|複驗)|用戶.{0,6}看到的|驗前端|抓實際畫面' || exit 0
 
-# ── 逃生口：明說沒有前端 ⇒ 放行（留痕） ──
+# 明說沒有前端 ⇒ 放行（留痕）
 printf '%s' "$TURN" | grep -qE '本次無前端|沒有前端可驗|純後端|不涉及前端' && exit 0
 
-# ── 驗過的證據：這回合真的用過某種瀏覽器能力（正向存在性檢查）──
-printf '%s' "$TURN" | grep -qE 'Claude_Browser__(preview_start|navigate|computer|get_page_text|read_console_messages|snapshot)' && exit 0
-printf '%s' "$TURN" | grep -qE 'browser-rendering/' && exit 0   # CF Browser Rendering 端點
+# 真的用過瀏覽器嗎？
+printf '%s' "$TURN" | grep -qE 'Claude_Browser__(preview_start|navigate|computer|get_page_text|read_console_messages)' && exit 0
 
-# ── 這個 session 有哪種瀏覽器能力？（正向存在性檢查）──
-CF_CAP=0
-[ -n "${CLOUDFLARE_API_TOKEN_YOULIN_CC_USE:-}" ] && [ -n "${CLOUDFLARE_ACCOUNT_ID_YOULIN:-}" ] && CF_CAP=1
-
-MCP_CAP=0
-if [ -n "$TP" ] && [ -f "$TP" ]; then
-  grep -q 'Claude_Browser__' "$TP" 2>/dev/null && MCP_CAP=1
-fi
-
-# ── 一種能力都沒有：不能要求做不到的事 → 每個 session 只提醒一次「缺什麼、怎麼補」──
-if [ "$CF_CAP" -eq 0 ] && [ "$MCP_CAP" -eq 0 ]; then
-  STAMP="/tmp/.browser-cap-warned-$SID"
-  [ -f "$STAMP" ] && exit 0            # 這個 session 已經提醒過 ⇒ 不再誤攔
-  : > "$STAMP" 2>/dev/null || true
-  cat >&2 <<'EOF'
-🖥️ 前端驗證警察：你宣稱驗了畫面，但**這個 session 一種瀏覽器能力都沒有**——
-   沒有能力就無法看畫面，所以問題不是「你沒驗」，是「這台缺瀏覽器能力，去補」。
-
-【inkstone/ISEP#121】閘要先看這台有沒有瀏覽器能力，才不會要求你做一件辦不到的事。
-
-補齊任一種即可看畫面（雲端首選第①種）：
-  ① CF Browser Rendering ── 需要兩個環境變數在場，且 token 要有 Browser Rendering: Edit：
-       CLOUDFLARE_API_TOKEN_YOULIN_CC_USE
-       CLOUDFLARE_ACCOUNT_ID_YOULIN
-     缺權限就通知 leo 幫該 token 加 Browser Rendering: Edit（ISEP#115 就是這樣解開的）。
-  ② Browser MCP ── mcp__Claude_Browser__*（本機通常有；雲端這台叫不出來）。
-  ③ 容器內 chromium ── ISEP#121 實測雲端網路被擋（ERR_TUNNEL_CONNECTION_FAILED），
-     不可靠，別依賴它當唯一驗法。
-
-在補上能力之前：這次若真的沒有前端可驗（純後端／純腳本），
-在回覆裡明說「本次無前端」即放行。
-
-本閘每個 session 只在這裡提醒一次，不會每回合攔你（inkstone/ISEP#121）。
-EOF
-  exit 2
-fi
-
-# ── 有能力卻沒用它 → 擋，並教「這台實際可用的那一種」──
-if [ "$CF_CAP" -eq 1 ]; then
-  cat >&2 <<'EOF'
+cat >&2 <<'EOF'
 🖥️ 前端驗證警察：你宣稱驗了畫面，但**這回合沒有用過瀏覽器**。
 
 【leo 2026-08-08】「**你的環境有 web，你應該用 web 驗，你已經開啓了卻沒有完成。**」
@@ -141,42 +70,7 @@ if [ "$CF_CAP" -eq 1 ]; then
   08-08 實撞：我 grep 到文案就說「前端驗過」，
   而使用者實際看到的是整條紅色「設定檔沒載入（config.js）」——**那個畫面我一次都沒看到**。
 
-這台有 CF Browser Rendering（雲端首選）。用它看畫面，不是看原始碼：
-
-  # 跑完 JS 的 DOM（能看到 config.js 載入後的真實內容）
-  curl -sS -X POST \
-    "https://api.cloudflare.com/client/v4/accounts/${CLOUDFLARE_ACCOUNT_ID_YOULIN}/browser-rendering/content" \
-    -H "Authorization: Bearer ${CLOUDFLARE_API_TOKEN_YOULIN_CC_USE}" \
-    -H "Content-Type: application/json" \
-    --data '{"url":"<用戶會走的網址>"}'
-
-  # 截圖（用戶會看到的那個畫面）
-  curl -sS -X POST \
-    "https://api.cloudflare.com/client/v4/accounts/${CLOUDFLARE_ACCOUNT_ID_YOULIN}/browser-rendering/screenshot" \
-    -H "Authorization: Bearer ${CLOUDFLARE_API_TOKEN_YOULIN_CC_USE}" \
-    -H "Content-Type: application/json" \
-    --data '{"url":"<用戶會走的網址>"}' --output /tmp/screen.png
-
-要看的是：有沒有錯誤橫幅／資料是不是還卡在「載入中…」／DOM 裡有沒有紅字錯誤。
-
-⚠️ 順帶：用 curl 查線上狀態時，`?cb=$RANDOM` **繞不掉 Cloudflare 邊緣快取**——
-   要加 `-H "Cache-Control: no-cache"`，否則你可能是在驗快取而不是驗線上。
-
-本次真的沒有前端可驗 ⇒ 在回覆裡明說「本次無前端」即放行。
-EOF
-  exit 2
-fi
-
-# MCP_CAP == 1（且沒有 CF）：教 Browser MCP
-cat >&2 <<'EOF'
-🖥️ 前端驗證警察：你宣稱驗了畫面，但**這回合沒有用過瀏覽器**。
-
-【leo 2026-08-08】「**你的環境有 web，你應該用 web 驗，你已經開啓了卻沒有完成。**」
-
-【為什麼 curl | grep 不算】curl 拿到的是 **HTML 原始碼**——
-  它**不執行 JS、不載入 config.js、不發 API 請求**。
-
-這台有 Browser MCP。改用這三步（看畫面，不是看原始碼）：
+改用這三步（看畫面，不是看原始碼）：
   mcp__Claude_Browser__preview_start        {url: "<用戶會走的網址>"}
   mcp__Claude_Browser__computer             {action: "screenshot"}
   mcp__Claude_Browser__read_console_messages {onlyErrors: true}

hooks/factory-idle-guard.sh

@@ -294,7 +294,10 @@ for d in /private/tmp/claude-501/*/*/tasks; do
 done
 [ "$RUNNING" -gt 0 ] && exit 0
 
-TOKEN=$(git -C "$PROJ" remote get-url gitea 2>/dev/null | sed -E 's|.*//[^:]+:([^@]+)@.*|\1|') || TOKEN=""
+# token 來源＝env／.env（inkstone/ISEP#47），不再從 remote URL 抽（那會逼 token 明文嵌在 URL 裡）
+_GT_LIB="$(dirname -- "$0")/../scripts/lib/gitea-token.sh"; [ -f "$_GT_LIB" ] && . "$_GT_LIB"
+command -v gitea_token >/dev/null 2>&1 || exit 0
+TOKEN=$(gitea_token) || TOKEN=""
 [ -z "$TOKEN" ] && exit 0
 
 # 🔴 org 是 inkstone，不是 Leo（2026-08-13 搬遷；舊值讓本閘靜默失效到 08-16）

hooks/issue-status-autoflip.sh

@@ -43,17 +43,12 @@ for line in p.splitlines():
 set -- $SPEC
 OWNER="$1"; REPO="$2"; NUM="$3"
 
-# token 從該 repo 的 gitea remote 取；取不到就安靜結束（不影響派工）
-for d in "$CLAUDE_PROJECT_DIR/products/$REPO" "$CLAUDE_PROJECT_DIR/matrix/$REPO" "$CLAUDE_PROJECT_DIR"; do
-  [ -d "$d/.git" ] || continue
-  URL=$(git -C "$d" remote get-url gitea 2>/dev/null) || continue
-  case "$URL" in *@*) break ;; esac
-done
-[ -n "${URL:-}" ] || exit 0
-
-TOKEN=$(printf '%s' "$URL" | sed -E 's|.*//[^:]+:([^@]+)@.*|\1|')
-HOST=$(printf '%s' "$URL" | sed -E 's|.*@([^/]+)/.*|\1|')
-[ "$TOKEN" != "$URL" ] || exit 0
+# token 來源＝env／.env（inkstone/ISEP#47），不再從 remote URL 抽；取不到就安靜結束（不影響派工）
+_GT_LIB="$(dirname -- "$0")/../scripts/lib/gitea-token.sh"; [ -f "$_GT_LIB" ] && . "$_GT_LIB"
+command -v gitea_token >/dev/null 2>&1 || exit 0
+TOKEN=$(gitea_token) || exit 0
+[ -n "$TOKEN" ] || exit 0
+HOST="git.uncle6.me"
 
 curl -s -o /dev/null --max-time 8 \
   -X POST -H "Authorization: token $TOKEN" -H "Content-Type: application/json" \

hooks/lib/gitea_token.py

@@ -0,0 +1,67 @@
+#!/usr/bin/env python3
+"""gitea_token.py — 解出 Gitea 憑證（GITEA_TOKEN_CLAUDE_CODE）的唯一 Python 來源。
+
+為什麼存在（inkstone/ISEP#47）：舊法用 `git remote -v` ＋
+  `re.search(r"//[^:/]+:([^@]+)@")` 從 remote URL 抽 token ⇒ token 必須明文嵌在
+  URL 裡 ⇒ 任何印出 remote URL 的訊息（git-lfs 的 locksverify 那行）都會把它洩進
+  transcript／log。來源統一到這裡後，remote URL 才能改乾淨。
+
+這是 `scripts/lib/gitea-token.sh` 的 Python 對照——**順序刻意一致**，讓 shell 與
+Python 兩邊解出來的是同一把（兩份必然漂移，所以只留一條路：先 env、再 .env）。
+
+解析順序（先環境、後檔案——雲端只有 env、本機有 .env，兩邊都涵蓋）：
+  1) 環境變數 GITEA_TOKEN_CLAUDE_CODE，再退 GITEA_TOKEN（本機 source .env 後也在）
+  2) $CLAUDE_PROJECT_DIR/.env 的 GITEA_TOKEN_CLAUDE_CODE=
+  3) git 根目錄的 .env 的 GITEA_TOKEN_CLAUDE_CODE=
+  讀不到 → 回 None（呼叫者自己判空，不能把 None 當成功）。
+
+🔴 只回值、不印別的——絕不把 token 印進 log。
+🔴 不從 remote URL 抽 token——那正是 ISEP#47 要根除的洩漏源。
+"""
+import os
+import subprocess
+
+
+def _from_file(path):
+    """從一個 .env 檔抓 GITEA_TOKEN_CLAUDE_CODE=，去掉外圍引號。抓不到回 None。"""
+    try:
+        with open(path, encoding="utf-8", errors="replace") as f:
+            for line in f:
+                if line.startswith("GITEA_TOKEN_CLAUDE_CODE="):
+                    v = line.split("=", 1)[1].strip()
+                    if len(v) >= 2 and v[0] == v[-1] and v[0] in ("'", '"'):
+                        v = v[1:-1]
+                    return v or None
+    except OSError:
+        pass
+    return None
+
+
+def _git_root():
+    """git rev-parse --show-toplevel（跟 shell 版同一把尺）。拿不到回 None。"""
+    try:
+        out = subprocess.run(["git", "rev-parse", "--show-toplevel"],
+                             capture_output=True, text=True, timeout=20)
+        root = (out.stdout or "").strip()
+        return root or None
+    except Exception:
+        return None
+
+
+def gitea_token():
+    """回 Gitea token 字串，或 None（拿不到）。順序見模組 docstring。"""
+    for env in ("GITEA_TOKEN_CLAUDE_CODE", "GITEA_TOKEN"):
+        v = os.environ.get(env)
+        if v:
+            return v
+    pd = os.environ.get("CLAUDE_PROJECT_DIR")
+    if pd:
+        v = _from_file(os.path.join(pd, ".env"))
+        if v:
+            return v
+    root = _git_root()
+    if root:
+        v = _from_file(os.path.join(root, ".env"))
+        if v:
+            return v
+    return None

hooks/lib/release_chain.py

@@ -25,9 +25,16 @@ import json
 import os
 import re
 import subprocess
+import sys
 import urllib.error
 import urllib.request
 
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+try:
+    from gitea_token import gitea_token as _gitea_token   # 唯一 token 來源（ISEP#47）：env→.env，不碰 remote URL
+except Exception:      # 旁邊沒有 gitea_token.py（部分部署）也要能載入——讀 tag／release 一律匿名，不靠 token
+    _gitea_token = None
+
 DEFAULT_HOST = "https://git.uncle6.me"
 DEFAULT_REPO = "inkstone/ISEP"
 MANIFEST_PATH = ".claude-plugin/plugin.json"
@@ -58,23 +65,16 @@ def tagname(v):
 
 
 def token_from_env_or_remote(host, root=None):
-    """建 release 才用得到。環境變數優先；沒有就從 remote URL 裡撈（bootstrap 會帶）。"""
+    """建 release（POST）才用得到。來源＝env／.env（ISEP#47），**不再從 remote URL 抽**——
+    那會逼 token 明文嵌在 URL 裡，任何印出 remote 的訊息都會洩一次。解析順序見
+    hooks/lib/gitea_token.py（先 env、再 $CLAUDE_PROJECT_DIR/.env、最後 git 根的 .env）。
+    `host`／`root` 參數保留給呼叫端相容，現已不參與解析。拿不到回 ""（呼叫者自己判空）。"""
+    if _gitea_token is not None:
+        return _gitea_token() or ""
+    # 退路：gitea_token.py 不在旁邊——只讀 env（仍不碰 remote URL，不重現 #47 的洩漏源）
     for env in ("GITEA_TOKEN_CLAUDE_CODE", "GITEA_TOKEN"):
         if os.environ.get(env):
             return os.environ[env]
-    if not root:
-        return ""
-    h = host.split("//")[-1].rstrip("/")
-    try:
-        out = subprocess.run(["git", "-C", root, "remote", "-v"],
-                             capture_output=True, text=True, timeout=20).stdout
-    except Exception:
-        out = ""
-    for line in out.splitlines():
-        if h in line:
-            m = re.search(r"//[^:/]+:([^@]+)@", line)
-            if m:
-                return m.group(1)
     return ""
 
 

hooks/no-ticket-no-dispatch.sh

@@ -79,10 +79,12 @@ set -- $REF
 OWNER="$1"; REPO="$2"; NUM="$3"
 
 # 拿 token（拿不到就放行——這是本地環境問題，不是派工者的錯）
-URL=$(git -C "${CLAUDE_PROJECT_DIR:-.}" remote get-url gitea 2>/dev/null || true)
-case "${URL:-}" in *@*) ;; *) exit 0 ;; esac
-TOKEN=$(printf '%s' "$URL" | sed -E 's|.*//[^:]+:([^@]+)@.*|\1|')
-HOST=$(printf '%s' "$URL" | sed -E 's|.*@([^/]+)/.*|\1|')
+# token 來源＝env／.env（inkstone/ISEP#47），不再從 remote URL 抽（那會逼 token 明文嵌在 URL 裡）
+_GT_LIB="$(dirname -- "$0")/../scripts/lib/gitea-token.sh"; [ -f "$_GT_LIB" ] && . "$_GT_LIB"
+command -v gitea_token >/dev/null 2>&1 || exit 0
+TOKEN=$(gitea_token) || exit 0
+[ -n "$TOKEN" ] || exit 0
+HOST="git.uncle6.me"
 
 RESP=$(curl -s --max-time 15 -H "Authorization: token $TOKEN" \
   "https://$HOST/api/v1/repos/$OWNER/$REPO/issues/$NUM" 2>/dev/null || true)

hooks/pr-verdict-guard.sh

@@ -62,17 +62,12 @@ set -u
 PROJ="${CLAUDE_PROJECT_DIR:-$(pwd)}"
 PAYLOAD=$(cat 2>/dev/null || echo '{}')
 
-# ── token：同 scripts/ticket 的做法（掃 remote 找帶憑證的，再退到環境變數）──
+# ── token：來源＝env／.env（inkstone/ISEP#47），不再從 remote URL 抽 ──
+# （舊法掃各 repo 的 remote 找帶憑證的網址，代表 token 得明文嵌在 URL 裡 → 會洩進 log）
 TOKEN=""
 if [ -z "${PR_VERDICT_FIXTURE:-}" ]; then
-  for d in "$PROJ" "$PROJ/products"/* "$PROJ/matrix"/* "$PROJ/polaris"/*; do
-    [ -e "$d/.git" ] || continue
-    U=$(git -C "$d" remote -v 2>/dev/null | grep -m1 'git\.uncle6\.me' | grep '@' | awk '{print $2}') || true
-    if [ -n "${U:-}" ]; then
-      T=$(printf '%s' "$U" | sed -E 's|.*//[^:]+:([^@]+)@.*|\1|')
-      [ "$T" != "$U" ] && { TOKEN="$T"; break; }
-    fi
-  done
+  _GT_LIB="$(dirname -- "$0")/../scripts/lib/gitea-token.sh"; [ -f "$_GT_LIB" ] && . "$_GT_LIB"
+  command -v gitea_token >/dev/null 2>&1 && TOKEN=$(gitea_token) || TOKEN=""
   [ -n "$TOKEN" ] || TOKEN="${GITEA_TOKEN_CLAUDE_CODE:-${GITEA_TOKEN:-}}"
 fi
 

hooks/tests/browser-verify-guard.test.sh

@@ -1,197 +0,0 @@
-#!/usr/bin/env bash
-# browser-verify-guard.sh 的迴歸測試（inkstone/ISEP#121）。
-#
-# 來由：2026-09-01 雲端這台「一種瀏覽器能力都沒有」，這支閘卻每回合都要求
-#   mcp__Claude_Browser__*（那套工具在這台叫不出來），於是一整天每回合誤攔一次。
-#   正解：閘先判斷「這個 session 有哪種瀏覽器能力」，有能力才要求用它，且教實際
-#   可用的那一種（雲端＝CF Browser Rendering）；一種都沒有時訊息改成「缺什麼、
-#   怎麼補」，且每個 session 只提醒一次。
-#
-# 三個方向都要有證據：
-#   A 群「該放行」——沒宣稱／明說無前端／真的用過某種瀏覽器能力／壞輸入 fail-open
-#   B 群「該擋」  ——有能力卻沒用它（且教對的那一種）
-#   C 群「沒能力時不誤攔」——第一次提醒一次（缺什麼怎麼補），同 session 第二次放行
-#
-# 用法：hooks/tests/browser-verify-guard.test.sh [hooks/browser-verify-guard.sh 的路徑]
-# 🔴 全程在乾淨 TMP 底下造假 transcript，跑完自己清；不碰真 repo、不打網路。
-#    每個案子自帶 session_id，並清掉可能殘留的 /tmp/.browser-cap-warned-* stamp。
-
-set -u
-HOOK="${1:-$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)/browser-verify-guard.sh}"
-TMP=$(mktemp -d)
-trap 'rm -rf "$TMP"; rm -f /tmp/.browser-cap-warned-bvtest_* 2>/dev/null' EXIT
-rm -f /tmp/.browser-cap-warned-bvtest_* 2>/dev/null || true
-
-PASS=0; FAIL=0; N=0
-
-# mk <transcript 路徑> <block spec>...
-#   單一 assistant 訊息的多個 block：`T:<文字>`＝文字段；`U:<工具名>`＝tool_use
-mk() {
-  python3 - "$@" <<'PY'
-import json, sys
-path, specs = sys.argv[1], sys.argv[2:]
-rows = [{"type": "user", "message": {"content": [{"type": "text", "text": "【工單】去辦這件事"}]}}]
-blocks = []
-for s in specs:
-    k, v = s.split(":", 1)
-    blocks.append({"type": "text", "text": v} if k == "T"
-                  else {"type": "tool_use", "name": v, "id": "t1", "input": {"cmd": v}})
-rows.append({"type": "assistant", "message": {"content": blocks}})
-with open(path, "w") as f:
-    for r in rows:
-        f.write(json.dumps(r, ensure_ascii=False) + "\n")
-PY
-}
-
-# mk2 <transcript 路徑> <早期工具名> <本回合文字>
-#   早一則 assistant 用過某工具（進得了 transcript 但不在「這回合的驗證」裡），
-#   本回合只有文字宣稱 → 用來造「有 MCP 能力、但這回合沒用它」。
-mk2() {
-  python3 - "$@" <<'PY'
-import json, sys
-path, tool, text = sys.argv[1], sys.argv[2], sys.argv[3]
-rows = [
-  {"type": "user", "message": {"content": [{"type": "text", "text": "先看一下"}]}},
-  {"type": "assistant", "message": {"content": [{"type": "tool_use", "name": tool, "id": "e1", "input": {}}]}},
-  {"type": "user", "message": {"content": [{"type": "text", "text": "【工單】去辦這件事"}]}},
-  {"type": "assistant", "message": {"content": [{"type": "text", "text": text}]}},
-]
-with open(path, "w") as f:
-    for r in rows:
-        f.write(json.dumps(r, ensure_ascii=False) + "\n")
-PY
-}
-
-# run <session_id> <cf?> <transcript> → 設定/清空 env，回傳 out（含 stderr），rc 存 $RC
-run() {
-  sid="$1"; cf="$2"; tr="$3"
-  if [ "$cf" = "cf" ]; then
-    out=$(printf '{"transcript_path":"%s","session_id":"%s"}' "$tr" "$sid" \
-      | CLAUDE_PROJECT_DIR="$TMP" \
-        CLOUDFLARE_API_TOKEN_YOULIN_CC_USE="fake-token" \
-        CLOUDFLARE_ACCOUNT_ID_YOULIN="fake-acct" \
-        sh "$HOOK" 2>&1); RC=$?
-  else
-    out=$(printf '{"transcript_path":"%s","session_id":"%s"}' "$tr" "$sid" \
-      | CLAUDE_PROJECT_DIR="$TMP" \
-        CLOUDFLARE_API_TOKEN_YOULIN_CC_USE="" \
-        CLOUDFLARE_ACCOUNT_ID_YOULIN="" \
-        sh "$HOOK" 2>&1); RC=$?
-  fi
-}
-
-# t <期望exit> <cf|nocf> <說明> <block spec>...
-t() {
-  want="$1"; cf="$2"; desc="$3"; shift 3
-  N=$((N+1)); tr="$TMP/tr-$N.jsonl"; mk "$tr" "$@"
-  run "bvtest_$N" "$cf" "$tr"
-  if [ "$RC" -eq "$want" ]; then printf '  ✅ %s\n' "$desc"; PASS=$((PASS+1))
-  else printf '  ❌ %s —— 期望 exit=%s，實得 exit=%s\n' "$desc" "$want" "$RC"
-       printf '%s\n' "$out" | sed -n '1,6p' | sed 's/^/     /'; FAIL=$((FAIL+1)); fi
-}
-
-echo "── A 群：該放行 ──────────────────────────────────────────────"
-
-t 0 nocf "沒有前端驗過的宣稱 ⇒ 與本閘無關" \
-  'T:我把後端 API 跑了一遍，回 200。'
-
-t 0 nocf "宣稱驗前端 ＋ 明說「本次無前端」⇒ 逃生口放行" \
-  'T:這條線是純腳本，本次無前端可驗。'
-
-t 0 cf "宣稱驗前端 ＋ 這回合用過 Claude_Browser__computer ⇒ 已驗放行" \
-  'T:前端我複驗過了。' 'U:mcp__Claude_Browser__computer'
-
-t 0 cf "宣稱驗前端 ＋ 這回合打過 CF browser-rendering 端點 ⇒ 已驗放行" \
-  'T:畫面確認過了。' 'U:curl -X POST https://api.cloudflare.com/client/v4/accounts/x/browser-rendering/screenshot'
-
-echo
-echo "── B 群：有能力卻沒用它 → 該擋，且教對的那一種 ─────────────────"
-
-# CF 能力在場、這回合只有 curl|grep 宣稱 ⇒ 擋，且教 CF 而不是 MCP
-N=$((N+1)); tr="$TMP/tr-cf.jsonl"
-mk "$tr" 'T:我 curl 抓了頁面，grep 到文案，前端驗過了。'
-run "bvtest_cf" "cf" "$tr"
-if [ "$RC" -eq 2 ] \
-   && printf '%s' "$out" | grep -q 'browser-rendering/screenshot' \
-   && ! printf '%s' "$out" | grep -q 'preview_start'; then
-  printf '  ✅ 有 CF 能力沒用它 ⇒ 擋，且教 CF（browser-rendering），不是 MCP 三步\n'; PASS=$((PASS+1))
-else
-  printf '  ❌ CF 能力在場時，擋法或教學不對（exit=%s）\n' "$RC"
-  printf '%s\n' "$out" | sed -n '1,8p' | sed 's/^/     /'; FAIL=$((FAIL+1)); fi
-
-# 只有 MCP 能力（transcript 早一則用過 Claude_Browser__，但非驗證類、且這回合沒用）⇒ 擋，且教 MCP
-N=$((N+1)); tr="$TMP/tr-mcp.jsonl"
-mk2 "$tr" "mcp__Claude_Browser__close" "我 curl 抓了頁面，前端驗過了。"
-out=$(printf '{"transcript_path":"%s","session_id":"%s"}' "$tr" "bvtest_mcp" \
-  | CLAUDE_PROJECT_DIR="$TMP" CLOUDFLARE_API_TOKEN_YOULIN_CC_USE="" CLOUDFLARE_ACCOUNT_ID_YOULIN="" \
-    sh "$HOOK" 2>&1); RC=$?
-if [ "$RC" -eq 2 ] \
-   && printf '%s' "$out" | grep -q 'preview_start' \
-   && ! printf '%s' "$out" | grep -q 'browser-rendering'; then
-  printf '  ✅ 只有 MCP 能力沒用它 ⇒ 擋，且教 MCP 三步，不是 CF\n'; PASS=$((PASS+1))
-else
-  printf '  ❌ MCP 能力在場時，擋法或教學不對（exit=%s）\n' "$RC"
-  printf '%s\n' "$out" | sed -n '1,8p' | sed 's/^/     /'; FAIL=$((FAIL+1)); fi
-
-echo
-echo "── C 群：一種能力都沒有 → 不誤攔（ISEP#121 的正題）─────────────"
-echo "   演練：這台沒有 CF env、transcript 也沒 Claude_Browser__，卻宣稱驗了前端"
-
-# 第一次：提醒一次（缺什麼、怎麼補），exit 2
-N=$((N+1)); tr="$TMP/tr-nocap.jsonl"
-mk "$tr" 'T:我 curl 抓了 stage 頁面，grep 到標題，前端驗過了。'
-run "bvtest_nocap1" "nocf" "$tr"
-first_rc="$RC"; first_out="$out"
-if [ "$first_rc" -eq 2 ] \
-   && printf '%s' "$first_out" | grep -q '一種瀏覽器能力都沒有' \
-   && printf '%s' "$first_out" | grep -q 'CLOUDFLARE_API_TOKEN_YOULIN_CC_USE' \
-   && printf '%s' "$first_out" | grep -q 'Browser Rendering: Edit' \
-   && printf '%s' "$first_out" | grep -q '只在這裡提醒一次'; then
-  printf '  ✅ 第一次：提醒「缺什麼、怎麼補」（要哪個 env、找 leo 加什麼權限）\n'; PASS=$((PASS+1))
-else
-  printf '  ❌ 第一次的提醒內容不對（exit=%s）\n' "$first_rc"
-  printf '%s\n' "$first_out" | sed -n '1,12p' | sed 's/^/     /'; FAIL=$((FAIL+1)); fi
-
-# 第二次：同一個 session、同樣沒能力、同樣宣稱 ⇒ 放行（不再每回合誤攔）
-N=$((N+1)); tr2="$TMP/tr-nocap2.jsonl"
-mk "$tr2" 'T:我又 curl 抓了一次，前端驗過了。'
-run "bvtest_nocap1" "nocf" "$tr2"   # ← 故意沿用同一個 session_id
-if [ "$RC" -eq 0 ]; then
-  printf '  ✅ 第二次（同 session）：放行 ⇒ 不再每回合誤攔（ISEP#121 主症狀已解）\n'; PASS=$((PASS+1))
-else
-  printf '  ❌ 第二次還在攔（exit=%s）⇒ 仍會每回合誤攔\n' "$RC"
-  printf '%s\n' "$out" | sed -n '1,8p' | sed 's/^/     /'; FAIL=$((FAIL+1)); fi
-
-echo
-echo "── C 群：沒能力時，逃生口仍走得通 ───────────────────────────"
-
-t 0 nocf "沒能力 ＋ 明說「本次無前端」⇒ 照樣放行（逃生口不受能力影響）" \
-  'T:宣稱一下前端驗過的字樣，但其實本次無前端可驗。'
-
-echo
-echo "── 訊息裡用引號 heredoc，反引號不被當命令執行（mistakes.md）─────"
-N=$((N+1)); tr="$TMP/tr-heredoc.jsonl"
-mk "$tr" 'T:我 curl 抓了頁面，前端驗過了。'
-run "bvtest_heredoc" "cf" "$tr"
-if printf '%s' "$out" | grep -q 'Cache-Control: no-cache' \
-   && ! printf '%s' "$out" | grep -qi 'command not found\|line [0-9].*: '; then
-  printf '  ✅ 訊息原樣印出（反引號沒被展開執行）\n'; PASS=$((PASS+1))
-else
-  printf '  ❌ 訊息疑似被 shell 展開（反引號被當命令）\n'
-  printf '%s\n' "$out" | sed -n '1,4p' | sed 's/^/     /'; FAIL=$((FAIL+1)); fi
-
-echo
-echo "── 壞輸入不准亂擋（fail-open）────────────────────────────────"
-for payload in '{}' '{"transcript_path":"/nonexistent/xx.jsonl"}' 'not-json' ''; do
-  N=$((N+1))
-  printf '%s' "$payload" | CLAUDE_PROJECT_DIR="$TMP" \
-    CLOUDFLARE_API_TOKEN_YOULIN_CC_USE="" CLOUDFLARE_ACCOUNT_ID_YOULIN="" \
-    sh "$HOOK" >/dev/null 2>&1; rc=$?
-  label="${payload:-（空輸入）}"
-  if [ "$rc" -eq 0 ]; then printf '  ✅ 壞輸入 %-34s ⇒ exit=0\n' "$label"; PASS=$((PASS+1))
-  else printf '  ❌ 壞輸入 %-34s ⇒ exit=%s（期望 0）\n' "$label" "$rc"; FAIL=$((FAIL+1)); fi
-done
-
-echo
-echo "────── 通過 $PASS ／ 失敗 $FAIL （共 $N 向）"
-[ "$FAIL" -eq 0 ]

hooks/tests/isep-presence-beacon.test.sh

@@ -25,6 +25,8 @@ mkplugin() {
   cp "$HOOK" "$d/hooks/$(basename "$HOOK")"
   cp "$REAL_HOOKS/lib/beacon_report.py" "$d/hooks/lib/beacon_report.py"
   cp "$REAL_HOOKS/lib/release_chain.py" "$d/hooks/lib/release_chain.py"
+  # release_chain 現在會 import gitea_token（ISEP#47 唯一 token 來源）；一起造出來才是真實的 plugin 樣子
+  cp "$REAL_HOOKS/lib/gitea_token.py" "$d/hooks/lib/gitea_token.py"
   printf '#!/bin/sh\necho real\n' > "$d/scripts/ticket"
   # inkstone/ISEP#122：會自動載入的東西（skill／command／agent）也要造得出來
   mkdir -p "$d/skills/demo" "$d/commands" "$d/agents" "$d/docs"

hooks/ticket-api-bypass-guard.sh

@@ -116,10 +116,10 @@ fi
 # 不影響「擋下來」這個判斷本身。
 HITS=""
 if [ "$RESOURCE" = "issues" ]; then
-  REMOTES=$(git -C "${CLAUDE_PROJECT_DIR:-.}" remote -v 2>/dev/null || true)
-  CRED_LINE=$(printf '%s' "$REMOTES" | grep -m1 'git\.uncle6\.me' | grep -m1 '@' || true)
-  if [ -n "$CRED_LINE" ]; then
-    TOKEN=$(printf '%s' "$CRED_LINE" | sed -E 's|.*//[^:]+:([^@]+)@.*|\1|')
+  # token 來源＝env／.env（inkstone/ISEP#47），不再從 remote URL 抽（那會逼 token 明文嵌在 URL 裡）
+  _GT_LIB="$(dirname -- "$0")/../scripts/lib/gitea-token.sh"; [ -f "$_GT_LIB" ] && . "$_GT_LIB"
+  TOKEN=""; command -v gitea_token >/dev/null 2>&1 && TOKEN=$(gitea_token) || TOKEN=""
+  if [ -n "$TOKEN" ]; then
     # 只認雙引號的 "title": "..."（curl -d／json.dumps 輸出的實際格式，也是
     # 2026-08-27 那 13 張票真實用的寫法，見 scripts/test-ticket-api-bypass-guard.sh
     # 既有的模擬指令）。刻意不支援單引號版本——這段 python 要塞進 bash 單引號

scripts/debt-worklist

@@ -51,6 +51,7 @@ try:
     import mainline as ML
 except Exception:      # 拿不到共用零件就退回舊行為（fail-open），不讓還債線整個癱掉
     ML = None
+from gitea_token import gitea_token as _gitea_token   # 唯一 token 來源（ISEP#47）：env→.env，不碰 remote URL
 
 # 等 leo 的票不進「可領清單」——不是它們不重要，是**沒有人能替他領**：
 #   Human／human/exec ＝ 要他親手批示或動手
@@ -67,28 +68,17 @@ def die(msg, code=2):
     sys.exit(code)
 
 
-# ── 連線（跟 scripts/ticket 同一套：先找帶憑證的 remote，再退環境變數）────────
+# ── 連線（跟 scripts/ticket 同一套 token 來源：env／.env，不碰 remote URL；ISEP#47）────────
 def token():
-    root = os.environ.get("CLAUDE_PROJECT_DIR") or os.getcwd()
+    tok = _gitea_token()
+    if tok:
+        return tok
     host = HOST.split("//")[-1].rstrip("/")
-    try:
-        out = subprocess.run(["git", "-C", root, "remote", "-v"],
-                             capture_output=True, text=True, timeout=20).stdout
-    except Exception:
-        out = ""
-    for line in out.splitlines():
-        if host in line:
-            m = re.search(r"//[^:/]+:([^@]+)@", line)
-            if m:
-                return m.group(1)
-    for env in ("GITEA_TOKEN_CLAUDE_CODE", "GITEA_TOKEN"):
-        if os.environ.get(env):
-            return os.environ[env]
     die(f"""🔴 拿不到 {host} 的 token
 
 擇一：
-  • 讓某個 remote 帶憑證（多數 repo 的 gitea/origin 本來就有）
-  • 或設環境變數 GITEA_TOKEN_CLAUDE_CODE""")
+  • 設環境變數 GITEA_TOKEN_CLAUDE_CODE
+  • 或在 $CLAUDE_PROJECT_DIR/.env（或 git 根的 .env）放 GITEA_TOKEN_CLAUDE_CODE=""")
 
 
 def api(path):

scripts/git-credential-gitea.sh

@@ -0,0 +1,26 @@
+#!/bin/sh
+# git-credential-gitea.sh — git credential helper：把 Gitea 憑證從 env／.env 餵給 git，
+#   讓 remote URL 不必嵌 token（inkstone/ISEP#47）。URL 乾淨 ⇒ git 把它印出來也不洩 token。
+#
+# 安裝（gitea-bootstrap.sh 會自動設好，這裡是手動法）：
+#   git config credential.helper "$(git rev-parse --show-toplevel)/scripts/git-credential-gitea.sh"
+# 只對 git.uncle6.me 的 get 供憑證；store／erase 不做事（token 不由 git 保管）。
+DIR=$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)
+. "$DIR/lib/gitea-token.sh"
+
+[ "${1:-}" = "get" ] || exit 0
+
+HOST=""
+while IFS='=' read -r k v; do
+  [ -z "$k" ] && break
+  [ "$k" = "host" ] && HOST="$v"
+done
+case "$HOST" in
+  git.uncle6.me|"") : ;;
+  *) exit 0 ;;
+esac
+
+TOK=$(gitea_token) || exit 0
+[ -n "$TOK" ] || exit 0
+printf 'username=claude-code\n'
+printf 'password=%s\n' "$TOK"

scripts/gitea-bootstrap.sh

@@ -16,14 +16,29 @@ set -eu
 REPO=""
 [ "${1:-}" = "-r" ] && { REPO="${2:?-r 後面要接 owner/repo}"; }
 
-REMOTE=$(git remote get-url gitea 2>/dev/null) || {
-  echo "✗ 當前目錄沒有名為 gitea 的 remote。請 cd 到目標 repo，或先加 remote。" >&2; exit 1; }
+# 取當前 repo 的 remote（雲端叫 origin、本機慣例叫 gitea）
+REMOTE_NAME=$(git remote get-url gitea >/dev/null 2>&1 && echo gitea || (git remote get-url origin >/dev/null 2>&1 && echo origin))
+[ -n "$REMOTE_NAME" ] || { echo "✗ 當前目錄沒有 gitea/origin remote。請 cd 到目標 repo，或先加 remote。" >&2; exit 1; }
+REMOTE=$(git remote get-url "$REMOTE_NAME" 2>/dev/null)
+# 去掉網址裡可能嵌著的憑證 → 乾淨 URL（inkstone/ISEP#47：token 不進 remote URL）
+REMOTE=$(printf '%s' "$REMOTE" | sed -E 's#//[^/@]*@#//#')
 
-TOKEN=$(printf '%s' "$REMOTE" | sed -E 's|.*//[^:]+:([^@]+)@.*|\1|')
-[ "$TOKEN" = "$REMOTE" ] && { echo "✗ gitea remote URL 裡沒有 token，無法取得認證。" >&2; exit 1; }
-HOST=$(printf '%s' "$REMOTE" | sed -E 's|.*@([^/]+)/.*|\1|')
+# token 來源＝env／.env（不從 remote URL 抽——那會逼 token 明文嵌在 URL 裡 → 洩進 log）
+_GT_DIR=$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)
+[ -f "$_GT_DIR/lib/gitea-token.sh" ] && . "$_GT_DIR/lib/gitea-token.sh"
+TOKEN=""; command -v gitea_token >/dev/null 2>&1 && TOKEN=$(gitea_token || true)
+[ -n "$TOKEN" ] || { echo "✗ 取不到 Gitea token（設 GITEA_TOKEN_CLAUDE_CODE，或在 .env 放 GITEA_TOKEN_CLAUDE_CODE=）。" >&2; exit 1; }
+HOST=$(printf '%s' "$REMOTE" | sed -E 's|.*://([^/]+)/.*|\1|')
 [ -n "$REPO" ] || REPO=$(printf '%s' "$REMOTE" | sed -E 's|.*://[^/]+/(.+)\.git$|\1|')
 
+# 設定乾淨 remote URL + credential helper（冪等）：URL 不含 token，認證改由 helper 從 env／.env 供
+# ⇒ git 把 remote URL 印出來（git-lfs 的 locksverify 那行）也不會洩 token（inkstone/ISEP#47）。
+if [ -f "$_GT_DIR/git-credential-gitea.sh" ]; then
+  CUR=$(git remote get-url "$REMOTE_NAME" 2>/dev/null || true)
+  case "$CUR" in *@*) git remote set-url "$REMOTE_NAME" "$REMOTE" && echo "  ✓ remote $REMOTE_NAME 已清乾淨（移除嵌入的 token）" ;; esac
+  git config credential.helper "$_GT_DIR/git-credential-gitea.sh"
+fi
+
 echo "→ repo: $REPO　host: $HOST"
 
 # 狀態機（互斥 scope label）。順序＝出貨流程：

scripts/gitea-labels-sync.sh

@@ -30,16 +30,15 @@ if [[ ! -f "$LABELS_YAML" ]]; then
   exit 1
 fi
 
-# --- token：跟 InkStoneCo 頂層 gitea remote 拿同一把（不落地檔案、不印出來） ---
+# --- token：來源＝env／.env（inkstone/ISEP#47），不再從 remote URL 抽（那會逼 token 明文嵌在 URL 裡） ---
 TOKEN="${GITEA_TOKEN:-}"
 if [[ -z "$TOKEN" ]]; then
-  INKSTONE_TOP="${INKSTONE_TOP:-$HOME/Documents/tech_projects/InkStoneCo}"
-  if [[ -d "$INKSTONE_TOP/.git" ]]; then
-    TOKEN="$(git -C "$INKSTONE_TOP" remote get-url gitea 2>/dev/null | sed -E 's|.*//[^:]+:([^@]+)@.*|\1|')"
-  fi
+  _GT_LIB="$(cd "$(dirname "${BASH_SOURCE[0]:-$0}")" && pwd)/lib/gitea-token.sh"
+  [[ -f "$_GT_LIB" ]] && . "$_GT_LIB"
+  command -v gitea_token >/dev/null 2>&1 && TOKEN="$(gitea_token || true)"
 fi
 if [[ -z "$TOKEN" ]]; then
-  echo "拿不到 Gitea token——設 GITEA_TOKEN 環境變數，或確認 $INKSTONE_TOP 的 gitea remote 存在" >&2
+  echo "拿不到 Gitea token——設 GITEA_TOKEN_CLAUDE_CODE 環境變數，或在 .env／頂層 .env 放 GITEA_TOKEN_CLAUDE_CODE=" >&2
   exit 1
 fi
 

scripts/isep-nag

@@ -74,6 +74,8 @@ HOST = os.environ.get("TICKET_HOST") or "https://git.uncle6.me"
 ORG = os.environ.get("ISEP_NAG_ORG") or "inkstone"
 STALE_DAYS = int(os.environ.get("ISEP_NAG_STALE_DAYS") or 3)
 HERE = os.path.dirname(os.path.abspath(__file__))
+sys.path.insert(0, os.path.join(HERE, "..", "hooks", "lib"))
+from gitea_token import gitea_token as _gitea_token   # 唯一 token 來源（ISEP#47）：env→.env，不碰 remote URL
 
 # 「等 leo」的兩個訊號：掛 Human 標籤，或指派給他本人。
 HUMAN_LABEL = "Human"
@@ -83,23 +85,8 @@ BATON_LABELS = {"s/doing", "s/review"}
 
 
 def token():
-    for env in ("GITEA_TOKEN_CLAUDE_CODE", "GITEA_TOKEN"):
-        v = os.environ.get(env)
-        if v:
-            return v
-    root = os.environ.get("CLAUDE_PROJECT_DIR") or os.getcwd()
-    host = HOST.split("//")[-1].rstrip("/")
-    try:
-        out = subprocess.run(["git", "-C", root, "remote", "-v"],
-                             capture_output=True, text=True, timeout=20).stdout
-    except Exception:
-        out = ""
-    for line in out.splitlines():
-        if host in line:
-            m = re.search(r"//[^:/]+:([^@]+)@", line)
-            if m:
-                return m.group(1)
-    return None
+    # 來源＝env／.env（ISEP#47），不碰 remote URL。拿不到回 None（呼叫者自己判空）。
+    return _gitea_token()
 
 
 def api(path, tok):

scripts/isep-notify

@@ -72,6 +72,9 @@ GITEA_HOST = os.environ.get("TICKET_HOST") or "https://git.uncle6.me"
 PROD_STAMP = "/tmp/.prod-write-ok"
 GATE_FACT = "gate-verdict.json"
 
+sys.path.insert(0, os.path.join(os.path.dirname(os.path.abspath(__file__)), "..", "hooks", "lib"))
+from gitea_token import gitea_token as _gitea_token   # 唯一 token 來源（ISEP#47）：env→.env，不碰 remote URL
+
 
 # ══ 一、這個 session 的閘是哪一份、哪一版 ═══════════════════════════════
 #
@@ -302,23 +305,8 @@ def send_bot_api(text):
 
 # ══ 三、退路：貼回票上 ═══════════════════════════════════════════════════
 def gitea_token():
-    for env in ("GITEA_TOKEN_CLAUDE_CODE", "GITEA_TOKEN"):
-        v = os.environ.get(env)
-        if v:
-            return v
-    root = os.environ.get("CLAUDE_PROJECT_DIR") or os.getcwd()
-    host = GITEA_HOST.split("//")[-1].rstrip("/")
-    try:
-        out = subprocess.run(["git", "-C", root, "remote", "-v"],
-                             capture_output=True, text=True, timeout=20).stdout
-    except Exception:
-        out = ""
-    for line in out.splitlines():
-        if host in line:
-            m = re.search(r"//[^:/]+:([^@]+)@", line)
-            if m:
-                return m.group(1)
-    return None
+    # 來源＝env／.env（ISEP#47），不碰 remote URL。拿不到回 None（呼叫者自己判空）。
+    return _gitea_token()
 
 
 def fallback_body(text, gate_fact, why=None):

scripts/lib/gitea-token.sh

@@ -0,0 +1,44 @@
+#!/bin/sh
+# gitea-token.sh — 解出 Gitea 憑證（GITEA_TOKEN_CLAUDE_CODE）。source 它、呼叫 gitea_token()。
+#
+# 為什麼存在（inkstone/ISEP#47）：舊法用 `git remote get-url gitea | sed` 從 remote URL
+#   抽 token ⇒ token 必須明文嵌在 URL 裡 ⇒ 任何印出 remote URL 的訊息（git-lfs 的
+#   locksverify 那行）都會把它洩進 transcript／log。來源統一到這裡後，remote URL 才能改乾淨。
+#
+# 解析順序（先環境、後檔案——雲端只有 env、本機有 .env，兩邊都涵蓋）：
+#   1) 環境變數 $GITEA_TOKEN_CLAUDE_CODE（雲端 make-cloud-env 注入；本機 source .env 後也在）
+#   2) .env 的 GITEA_TOKEN_CLAUDE_CODE=（先找 $CLAUDE_PROJECT_DIR/.env，再找 git 根的 .env）
+#      —— 與既有 gitea_arm_token()（scripts/lib/gitea-arm-common.sh）同一條路，照既有寫法走。
+#   讀不到 → 印空字串、回非 0（呼叫者必須自己判空，不能把空字串當成功）。
+#
+# 🔴 只回值、不印別的——絕不 echo 出 token 以外的東西（避免洩進 log）。
+
+# 內部：從一個 .env 檔抓 GITEA_TOKEN_CLAUDE_CODE=，去掉外圍引號。
+_gitea_token_from_file() {
+  [ -f "$1" ] || return 1
+  _gt_val=$(grep '^GITEA_TOKEN_CLAUDE_CODE=' "$1" 2>/dev/null | head -1 | cut -d= -f2-)
+  _gt_val=${_gt_val%\"}; _gt_val=${_gt_val#\"}
+  _gt_val=${_gt_val%\'}; _gt_val=${_gt_val#\'}
+  [ -n "$_gt_val" ] || return 1
+  printf '%s' "$_gt_val"
+  return 0
+}
+
+gitea_token() {
+  # 1) 環境變數優先
+  if [ -n "${GITEA_TOKEN_CLAUDE_CODE:-}" ]; then
+    printf '%s' "$GITEA_TOKEN_CLAUDE_CODE"
+    return 0
+  fi
+  # 2) $CLAUDE_PROJECT_DIR/.env
+  if [ -n "${CLAUDE_PROJECT_DIR:-}" ] && _gitea_token_from_file "$CLAUDE_PROJECT_DIR/.env"; then
+    return 0
+  fi
+  # 3) git 根的 .env
+  _gt_root=$(git rev-parse --show-toplevel 2>/dev/null || true)
+  if [ -n "${_gt_root:-}" ] && _gitea_token_from_file "$_gt_root/.env"; then
+    return 0
+  fi
+  printf ''
+  return 1
+}

scripts/milestone-account

@@ -41,6 +41,8 @@ import urllib.request
 HOST = os.environ.get("MILESTONE_ACCOUNT_HOST", "https://git.uncle6.me")
 HERE = os.path.dirname(os.path.abspath(__file__))
 ROOT = os.path.dirname(HERE)
+sys.path.insert(0, os.path.join(HERE, "..", "hooks", "lib"))
+from gitea_token import gitea_token as _gitea_token   # 唯一 token 來源（ISEP#47）：env→.env，不碰 remote URL
 def _project_roots():
     """跟 `hooks/lib/mainline.py::project_roots()` 同一把尺（那裡是唯一定義；載不到才退回同形狀的內建）。"""
     try:
@@ -112,22 +114,8 @@ def die(msg, code=2):
 
 
 def token():
-    root = os.environ.get("CLAUDE_PROJECT_DIR") or HERE
-    host = HOST.split("//")[-1].rstrip("/")
-    try:
-        out = subprocess.run(["git", "-C", root, "remote", "-v"],
-                             capture_output=True, text=True, timeout=20).stdout
-    except Exception:
-        out = ""
-    for line in out.splitlines():
-        if host in line:
-            m = re.search(r"//[^:/]+:([^@]+)@", line)
-            if m:
-                return m.group(1)
-    for env in ("GITEA_TOKEN_CLAUDE_CODE", "GITEA_TOKEN"):
-        if os.environ.get(env):
-            return os.environ[env]
-    return ""
+    # 來源＝env／.env（ISEP#47），不碰 remote URL。拿不到回 ""（呼叫者自己判空）。
+    return _gitea_token() or ""
 
 
 _FX = None

scripts/pr-verdict

@@ -31,6 +31,9 @@ import urllib.request
 HOST = os.environ.get("PR_VERDICT_HOST", "https://git.uncle6.me")
 DRY = False
 
+sys.path.insert(0, os.path.join(os.path.dirname(os.path.abspath(__file__)), "..", "hooks", "lib"))
+from gitea_token import gitea_token as _gitea_token   # 唯一 token 來源（ISEP#47）：env→.env，不碰 remote URL
+
 
 def die(msg, code=2):
     print(msg, file=sys.stderr)
@@ -38,22 +41,12 @@ def die(msg, code=2):
 
 
 def token():
-    root = os.environ.get("CLAUDE_PROJECT_DIR") or os.getcwd()
+    # 來源＝env／.env（ISEP#47），不碰 remote URL。解析順序見 hooks/lib/gitea_token.py。
+    tok = _gitea_token()
+    if tok:
+        return tok
     host = HOST.split("//")[-1].rstrip("/")
-    try:
-        out = subprocess.run(["git", "-C", root, "remote", "-v"],
-                             capture_output=True, text=True, timeout=20).stdout
-    except Exception:
-        out = ""
-    for line in out.splitlines():
-        if host in line:
-            m = re.search(r"//[^:/]+:([^@]+)@", line)
-            if m:
-                return m.group(1)
-    for env in ("GITEA_TOKEN_CLAUDE_CODE", "GITEA_TOKEN"):
-        if os.environ.get(env):
-            return os.environ[env]
-    die(f"🔴 拿不到 {host} 的 token（remote 沒帶憑證，也沒有 GITEA_TOKEN_CLAUDE_CODE）")
+    die(f"🔴 拿不到 {host} 的 token（沒有 GITEA_TOKEN_CLAUDE_CODE，.env 裡也沒有）")
 
 
 def api(path, payload=None, method=None, soft=False):

scripts/release-manifest

@@ -41,6 +41,8 @@ import urllib.request
 
 HOST = os.environ.get("RELEASE_MANIFEST_HOST", "https://git.uncle6.me")
 HERE = os.path.dirname(os.path.abspath(__file__))
+sys.path.insert(0, os.path.join(HERE, "..", "hooks", "lib"))
+from gitea_token import gitea_token as _gitea_token   # 唯一 token 來源（ISEP#47）：env→.env，不碰 remote URL
 def _resolve_dir():
     """清單住哪裡。
 
@@ -74,22 +76,8 @@ def die(msg, code=2):
 
 
 def token():
-    root = os.environ.get("CLAUDE_PROJECT_DIR") or HERE
-    host = HOST.split("//")[-1].rstrip("/")
-    try:
-        out = subprocess.run(["git", "-C", root, "remote", "-v"],
-                             capture_output=True, text=True, timeout=20).stdout
-    except Exception:
-        out = ""
-    for line in out.splitlines():
-        if host in line:
-            m = re.search(r"//[^:/]+:([^@]+)@", line)
-            if m:
-                return m.group(1)
-    for env in ("GITEA_TOKEN_CLAUDE_CODE", "GITEA_TOKEN"):
-        if os.environ.get(env):
-            return os.environ[env]
-    return ""
+    # 來源＝env／.env（ISEP#47），不碰 remote URL。拿不到回 ""（呼叫者自己判空）。
+    return _gitea_token() or ""
 
 
 def _fixture():

scripts/test-gitea-token.sh

@@ -0,0 +1,108 @@
+#!/bin/bash
+# Gitea token 解析器的測試（inkstone/ISEP#47）——鎖住「token 只從 env／.env 來，
+# 絕不從 remote URL 抽」這條規約。一支解析器兩份實作（Python：hooks/lib/gitea_token.py；
+# shell：scripts/lib/gitea-token.sh），兩份必須解出同一把、順序一致，所以一起測。
+#
+# 全程離線：造暫存的 .env 與乾淨／髒的 git remote，**不打 Gitea、不碰 $HOME、不留測試票**。
+#
+# 為什麼要有這支：ISEP#47 的洩漏源是「token 明文嵌在 remote URL 裡」。
+#   c9128 複驗指出雲端那次只改了 6 支、漏了 8 支 Python，且雲端有環境變數所以測不出
+#   本機（只有 .env）的壞法。這支把那個壞法變成一條會紅的測試——
+#   remote 髒、但 token 只在 URL 裡時，解析器**必須解不出**（否則洩漏源還在）。
+cd "$(dirname "$0")/.." || exit 1
+REPO=$PWD                                  # ISEP 樹根：子 shell cd 進暫存目錄後仍要指得回來
+PYLIB=hooks/lib/gitea_token.py
+SHLIB=scripts/lib/gitea-token.sh
+PASS=0; FAIL=0
+T=$(mktemp -d); trap 'rm -rf "$T"' EXIT
+TOK=deadbeefdeadbeefdeadbeefdeadbeef00001111   # 假 token，40 字，長得像真的
+
+ok(){ # $1=條件 $2=說明
+  if eval "$1"; then PASS=$((PASS+1)); printf '  ✅ %s\n' "$2"
+  else FAIL=$((FAIL+1)); printf '  ❌ %s\n     判準：%s\n' "$2" "$1"; fi
+}
+
+# 造一個 git repo，remote 可選乾淨或髒（把 token 嵌進 URL＝重現舊洩漏源）
+mkrepo(){ # $1=repo 目錄 $2=dirty|clean $3=有沒有 .env(env|noenv)
+  d="$T/$1"; mkdir -p "$d"; ( cd "$d" && git init -q )
+  if [ "$2" = "dirty" ]; then
+    ( cd "$d" && git remote add origin "https://claude-code:${TOK}@git.uncle6.me/inkstone/ISEP.git" )
+  else
+    ( cd "$d" && git remote add origin "https://git.uncle6.me/inkstone/ISEP.git" )
+  fi
+  [ "$3" = "env" ] && printf 'FOO=x\nGITEA_TOKEN_CLAUDE_CODE=%s\nBAR=y\n' "$TOK" > "$d/.env"
+  echo "$d"
+}
+
+# 解析器跑一次：清掉環境變數（除非 $WITHENV），回傳解出的值到 $GOT
+resolve_py(){ # $1=cwd $2=CLAUDE_PROJECT_DIR(空=不設) $3=setenv|noenv
+  local envargs="-u GITEA_TOKEN_CLAUDE_CODE -u GITEA_TOKEN"
+  [ "$3" = "setenv" ] && envargs="GITEA_TOKEN_CLAUDE_CODE=$TOK"
+  # 空＝真的不設：CC session 會繼承一個 CLAUDE_PROJECT_DIR，不 -u 掉就會解到真的 token（09-19 在本機實撞）。
+  # env 的 -u 一定要排在 NAME=VALUE 前面，所以「要設」時放在最後、「不設」時併進 -u 那串。
+  local pd=""; if [ -n "$2" ]; then pd="CLAUDE_PROJECT_DIR=$2"; else envargs="-u CLAUDE_PROJECT_DIR $envargs"; fi
+  GOT=$( cd "$1" && env $envargs $pd python3 -c "
+import sys; sys.path.insert(0,'$REPO/hooks/lib')
+from gitea_token import gitea_token
+print(gitea_token() or '')" 2>/dev/null )
+}
+resolve_sh(){ # 同上，走 shell 版
+  local envargs="-u GITEA_TOKEN_CLAUDE_CODE -u GITEA_TOKEN"
+  [ "$3" = "setenv" ] && envargs="GITEA_TOKEN_CLAUDE_CODE=$TOK"
+  # 空＝真的不設：CC session 會繼承一個 CLAUDE_PROJECT_DIR，不 -u 掉就會解到真的 token（09-19 在本機實撞）。
+  # env 的 -u 一定要排在 NAME=VALUE 前面，所以「要設」時放在最後、「不設」時併進 -u 那串。
+  local pd=""; if [ -n "$2" ]; then pd="CLAUDE_PROJECT_DIR=$2"; else envargs="-u CLAUDE_PROJECT_DIR $envargs"; fi
+  GOT=$( cd "$1" && env $envargs $pd sh -c ". $REPO/$SHLIB; gitea_token" 2>/dev/null )
+}
+
+echo "── 解析順序：先 env、再 \$CLAUDE_PROJECT_DIR/.env、最後 git 根的 .env ──"
+
+# ① 環境變數優先（就算 .env 沒有也拿得到）
+R=$(mkrepo r1 clean noenv)
+resolve_py "$R" "" setenv;  ok '[ "$GOT" = "$TOK" ]' 'Py ① 環境變數在 → 解得出'
+resolve_sh "$R" "" setenv;  ok '[ "$GOT" = "$TOK" ]' 'sh ① 環境變數在 → 解得出'
+
+# ② 沒有環境變數，token 在 $CLAUDE_PROJECT_DIR/.env（＝本機 Mac 的實況）
+R=$(mkrepo r2 clean env)
+resolve_py "$R" "$R" noenv; ok '[ "$GOT" = "$TOK" ]' 'Py ② 無 env、CLAUDE_PROJECT_DIR/.env 有 → 解得出（c9128 的壞法，這條要綠）'
+resolve_sh "$R" "$R" noenv; ok '[ "$GOT" = "$TOK" ]' 'sh ② 無 env、CLAUDE_PROJECT_DIR/.env 有 → 解得出'
+
+# ③ 沒有環境變數、沒設 CLAUDE_PROJECT_DIR，token 在 git 根的 .env
+R=$(mkrepo r3 clean env)
+resolve_py "$R" "" noenv;   ok '[ "$GOT" = "$TOK" ]' 'Py ③ 退到 git 根的 .env → 解得出'
+resolve_sh "$R" "" noenv;   ok '[ "$GOT" = "$TOK" ]' 'sh ③ 退到 git 根的 .env → 解得出'
+
+echo "── 洩漏源必須斷：token 只在 remote URL 裡時，解析器不准解出它 ──"
+
+# ④ remote 髒（URL 嵌 token）、但沒有 env、沒有 .env ⇒ 必須解不出（否則 ISEP#47 沒修好）
+R=$(mkrepo r4 dirty noenv)
+resolve_py "$R" "" noenv;   ok '[ -z "$GOT" ]' 'Py ④ 只有髒 remote → 解不出（不再從 URL 抽 token）'
+resolve_sh "$R" "" noenv;   ok '[ -z "$GOT" ]' 'sh ④ 只有髒 remote → 解不出'
+
+# ⑤ 什麼都沒有 ⇒ 空
+R=$(mkrepo r5 clean noenv)
+resolve_py "$R" "" noenv;   ok '[ -z "$GOT" ]' 'Py ⑤ 什麼都沒有 → 空'
+resolve_sh "$R" "" noenv;   ok '[ -z "$GOT" ]' 'sh ⑤ 什麼都沒有 → 空'
+
+echo "── 八支腳本在「本機實況」下都拿得到 token（無 env＋乾淨 remote＋.env 有）──"
+# 走到 token 之後就打不通的 host，區分：印「拿不到 token」＝死在 token 步；連線失敗＝已過 token 步。
+R=$(mkrepo r6 clean env)
+past_token(){ # $1=說明 其餘=命令
+  local desc="$1"; shift
+  local out; out=$( cd "$R" && env -u GITEA_TOKEN_CLAUDE_CODE -u GITEA_TOKEN CLAUDE_PROJECT_DIR="$R" \
+        TICKET_HOST="http://127.0.0.1:9" MILESTONE_ACCOUNT_HOST="http://127.0.0.1:9" \
+        PR_VERDICT_HOST="http://127.0.0.1:9" RELEASE_MANIFEST_HOST="http://127.0.0.1:9" \
+        "$@" 2>&1 )
+  if echo "$out" | grep -q "拿不到.*token"; then ok 'false' "$desc（死在 token 步）"
+  else ok 'true' "$desc"; fi
+}
+past_token 'ticket mine 過 token'        python3 "$PWD/scripts/ticket" mine
+past_token 'isep-nag 過 token'           python3 "$PWD/scripts/isep-nag"
+past_token 'isep-notify 過 token'        python3 "$PWD/scripts/isep-notify" --text probe --ticket inkstone/ISEP#47
+past_token 'milestone-account 過 token'  python3 "$PWD/scripts/milestone-account"
+past_token 'pr-verdict 過 token'         python3 "$PWD/scripts/pr-verdict" --pr inkstone/ISEP#1
+past_token 'debt-worklist 過 token'      python3 "$PWD/scripts/debt-worklist"
+
+echo ""
+echo "通過 $PASS 條，失敗 $FAIL 條（共 $((PASS+FAIL)) 條）"
+[ "$FAIL" -eq 0 ]

scripts/test-ticket-api-bypass-guard.sh

@@ -68,7 +68,10 @@ echo "   裸引號的 python dict 寫法，跟 2026-08-27 那 13 張票實際的
 echo "   curl -d 那種「JSON 被跳脫成字串塞進另一層引號」的寫法，本閘的猜題功能"
 echo "   刻意不支援，見 hook 檔頭「只認雙引號」那段註解，訊息裡不會列候選舊票，"
 echo "   但擋下來這件事不受影響，另有獨立案例覆蓋。）"
-if git remote -v 2>/dev/null | grep 'git\.uncle6\.me' | grep -q '@'; then
+# 能不能打網路：看 token 解不解得出來（inkstone/ISEP#47 之後 remote URL 乾淨、不再帶憑證，
+# 舊判準「remote 有沒有 @」會讓這條在每台機器上永遠 SKIP ⇒ 等於沒有這條測試）
+_GT_TOK=""; . "$(dirname "$0")/lib/gitea-token.sh" 2>/dev/null && _GT_TOK=$(gitea_token 2>/dev/null || true)
+if [ -n "$_GT_TOK" ]; then
   OUT=$(printf '%s' "{\"tool_name\":\"Bash\",\"tool_input\":{\"command\":$(python3 -c 'import json,sys;print(json.dumps(sys.argv[1]))' 'req("POST", f"{API}/repos/{REPO}/issues", {"title":"總圖說我一條關聯都沒有，三元組 graph 全部消失"})')}}" \
     | bash "$H" 2>&1 >/dev/null)
   RC=$?
@@ -79,7 +82,7 @@ if git remote -v 2>/dev/null | grep 'git\.uncle6\.me' | grep -q '@'; then
     printf '%s\n' "$OUT"
   fi
 else
-  echo "  ⏭️  SKIP（這台機器的 git remote 沒帶 git.uncle6.me 的憑證，連不上就不算數）"
+  echo "  ⏭️  SKIP（解不出 Gitea token：沒有 \$GITEA_TOKEN_CLAUDE_CODE、\$CLAUDE_PROJECT_DIR/.env 也沒有，連不上就不算數）"
 fi
 
 [ -n "$SAVED" ] && printf '%s' "$SAVED" > /tmp/.ticket-where-ok

scripts/ticket

@@ -66,6 +66,7 @@ try:
     from dispatch_parse import parse_identity, IDENTITY_ROLES
 except Exception:      # 拿不到共用零件就不擋（fail-open）——開票的路不該被一個 import 卡死
     parse_identity, IDENTITY_ROLES = None, ("總管", "subagent", "leo")
+from gitea_token import gitea_token as _gitea_token   # 唯一 token 來源（ISEP#47）：env→.env，不碰 remote URL
 
 
 def check_identity(body, what):
@@ -109,36 +110,17 @@ def die(msg, code=2):
 
 
 def token():
-    root = os.environ.get("CLAUDE_PROJECT_DIR") or os.getcwd()
-    # 掃這個 repo 的**所有** remote，找第一個指向本站、且帶憑證的。
-    # 原本寫死只認名叫 "gitea" 的 remote —— 2026-08-20 實撞：
-    # ISEP 這個新 repo 的 remote 叫 origin，於是這支腳本在那裡整個跑不起來，
-    # 「開票前先搜」那道閘在新 repo 等於不存在。閘不該綁在某個 remote 的名字上。
+    # 來源＝env／.env（ISEP#47），不再從 remote URL 抽——那會逼 token 明文嵌在 URL 裡，
+    # 任何印出 remote 的訊息（git-lfs locksverify）都會洩一次。解析順序見 hooks/lib/gitea_token.py。
+    tok = _gitea_token()
+    if tok:
+        return tok
     host = HOST.split("//")[-1].rstrip("/")
-    try:
-        out = subprocess.run(["git", "-C", root, "remote", "-v"],
-                             capture_output=True, text=True, timeout=20).stdout
-    except Exception:
-        out = ""
-    for line in out.splitlines():
-        if host not in line:
-            continue
-        m = re.search(r"//[^:/]+:([^@]+)@", line)
-        if m:
-            return m.group(1)
-    # 退而求其次：環境變數（雲端／CI 沒有帶憑證的 remote 時走這條）
-    for env in ("GITEA_TOKEN_CLAUDE_CODE", "GITEA_TOKEN"):
-        v = os.environ.get(env)
-        if v:
-            return v
     die(f"""🔴 拿不到 {host} 的 token
 
-這個 repo 的 remote 裡沒有一個帶憑證且指向 {host}：
-{out.strip() or "（沒有任何 remote）"}
-
 擇一：
-  • 讓某個 remote 帶憑證（多數 repo 的 gitea/origin 本來就有）
-  • 或設環境變數 GITEA_TOKEN_CLAUDE_CODE""")
+  • 設環境變數 GITEA_TOKEN_CLAUDE_CODE
+  • 或在 $CLAUDE_PROJECT_DIR/.env（或 git 根的 .env）放 GITEA_TOKEN_CLAUDE_CODE=""")
 
 
 _TOLERATE = ()          # 這一次呼叫可以吞掉的 HTTP 狀態碼（見 add_dependency）

scripts/wiki-panorama.sh

@@ -61,15 +61,21 @@ done
 
 [ -f "$ROSTER" ] || { echo "找不到 roster：$ROSTER" >&2; exit 1; }
 
-# ── Gitea base（含憑證，**絕不可印出來**）────────────────────────────────
-REMOTE=$(git -C "$ROOT" remote get-url gitea 2>/dev/null || true)
-[ -n "$REMOTE" ] || { echo "本 repo 沒有 gitea remote，無法取 repo。" >&2; exit 1; }
+# ── Gitea base（乾淨網址；token 來源＝env／.env，不從 URL 抽——inkstone/ISEP#47）──────────
+_GT_DIR=$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)
+[ -f "$_GT_DIR/lib/gitea-token.sh" ] && . "$_GT_DIR/lib/gitea-token.sh"
+REMOTE=$(git -C "$ROOT" remote get-url gitea 2>/dev/null || git -C "$ROOT" remote get-url origin 2>/dev/null || true)
+[ -n "$REMOTE" ] || { echo "本 repo 沒有 gitea/origin remote，無法取 repo。" >&2; exit 1; }
+# 去掉網址裡可能還嵌著的舊憑證（遷移期相容）→ 乾淨 base，clone/fetch 靠 credential helper 認證
+REMOTE=$(printf '%s' "$REMOTE" | sed -E 's#//[^/@]*@#//#')
 BASE=${REMOTE%/InkStoneCo.git}
 BASE=${BASE%/InkStoneCo}
 SELF=$(basename "$REMOTE" .git)
-SECRET=$(printf '%s' "$REMOTE" | sed -nE 's|.*//[^:]+:([^@]+)@.*|\1|p')
-# 任何要外流的字串都先過這關（錯誤訊息可能夾帶 clone URL）
+# scrub 用的 SECRET：token 從 env／.env 取（不從 URL 抽），用來遮掉萬一夾帶在錯誤訊息裡的 token
+SECRET=""; command -v gitea_token >/dev/null 2>&1 && SECRET=$(gitea_token || true)
 scrub() { if [ -n "$SECRET" ]; then sed "s|$SECRET|***|g"; else cat; fi; }
+# clone/fetch 的認證：乾淨 URL + credential helper（token 不進 URL、不洩進 log）
+GIT_CRED=""; [ -f "$_GT_DIR/git-credential-gitea.sh" ] && GIT_CRED="-c credential.helper=$_GT_DIR/git-credential-gitea.sh"
 
 mkdir -p "$CACHE"
 # 自己這個 repo 一律讀工作副本 ⇒ 快取裡若留著一份舊的自己，是誤導來源（會被人拿去讀）
@@ -95,7 +101,7 @@ for repo in $REPOS; do
   if [ -d "$dst/.git" ]; then
     if [ "$DO_FETCH" = 1 ]; then
       br=$(git -C "$dst" symbolic-ref --short HEAD 2>/dev/null || echo main)
-      git -C "$dst" fetch --quiet origin "$br" 2>&1 | scrub >&2 || true
+      git $GIT_CRED -C "$dst" fetch --quiet origin "$br" 2>&1 | scrub >&2 || true
       git -C "$dst" reset --quiet --hard FETCH_HEAD 2>/dev/null || true
     fi
   else
@@ -104,7 +110,7 @@ for repo in $REPOS; do
     fi
     # blobless + sparse：只下載 wiki 目錄的內容，但保留完整 commit 歷史
     #（要歷史才算得出「每個檔最後更新是哪天」——淺 clone 會讓所有檔同一天）
-    if ! err=$(git clone --quiet --filter=blob:none --sparse "$BASE/$repo.git" "$dst" 2>&1 | scrub); then
+    if ! err=$(git $GIT_CRED clone --quiet --filter=blob:none --sparse "$BASE/$repo.git" "$dst" 2>&1 | scrub); then
       printf '%s\tclone-failed\t%s\n' "$repo" "$(printf '%s' "$err" | tr '\n' ' ')" >> "$STATUS_TSV"
       rm -rf "$dst"; continue
     fi
@@ -312,7 +318,7 @@ if gap > 0:
       f"Gitea `Leo/*` 在 {ASOF} 實查是 **{TOTAL} 個**，名單 {len(repos)} 個 ⇒ **還有 {gap} 個沒被點名**。")
     w("  補法（人發起，一次呼叫，不排程）——拿到完整清單、把缺的名字加進名單再重跑：")
     w("  ```")
-    w("  TOKEN=$(git remote get-url gitea | sed -E 's|.*//[^:]+:([^@]+)@.*|\\1|')")
+    w("  TOKEN=$GITEA_TOKEN_CLAUDE_CODE   # 來源＝env／.env，不從 remote URL 抽（inkstone/ISEP#47）")
     w("  curl -s -H \"Authorization: token $TOKEN\" \\")
     w("    'https://git.uncle6.me/api/v1/orgs/Leo/repos?limit=100' | python3 -c \\")
     w("    'import sys,json;[print(r[\"name\"]) for r in json.load(sys.stdin)]'")