FR-181 Agent 只出站通道 — 交接日誌（LOG）

append-only：每棒收工追加一個 block，既有 block 不改。現況看 fr181-STATE.md。

做了什麼

• 探脈：實查 FR-171 後八種「主系統連 Agent 8443」用途（六種指令＋同步問答），證明心跳補推也連 8443。決策者裁客戶不開入站埠、改 Agent 長輪詢、直推退役（後改判留程式加開關）。
• 討論稿 → design v1.0 → v1.1（無人值守：批次 7→6、P-0 判據寫死、驗收改本機模擬）→ 開卡 CM-3595 母卡＋13 子卡 → 工作坊 42 跑 16 小時。
• 監控處置：E-1 契約互鎖轉 A-1；F-3 撞 FR-178 先發的 1.15／1.16（決策者裁 B：工作區 merge ws-CM-3533 再發）；C-1 runner 斷線首腦接手收尾（PYTHONPATH 指工作區跑守衛）。
• 工作坊首腦補開 B-4（CM-3619，agent_credential_client.py 在主系統不在套件，首腦拆卡位置寫錯）、B-5（CM-3631，連線欄值是套件算的，首腦漏套件那一半）；決策者裁文件太早 → C-1 縮為釘版＋守衛、C-2 文件拆出暫緩。
• 首腦驗收抓到「對帳」仍直推（§1.2 併進證據檔沒單獨列）→ 補開 B-6a～d（CM-3634～3637）。
• 決策者裁直接合回：四 repo ws-CM-3595 merge 進 feature/FR-172；FR-182 首腦合回時一併推遠端。
• 靜態驗收：BE 178／Agent 173／detection 303／契約 73（補刀 b20f85c5）綠；remote-agent 接受 runner 540 打折。
• 磁碟 1 G → 99 G：清 poetry／pip 快取、已結束 job tmp、兩個已結案 BE 工作區、37 個 Agent venv 孤兒；Docker.raw 71 G 是 sparse 只長不縮（實際內容 17 G）。

關鍵決策：D1～D8 全文 design v1.1 §3；文件等真機驗收過後寫；工作坊 44（FR-182）先合回、40（FR-179）後合回、本案釘版跟進不自改。

教訓

• Nexus 允許同版號重傳：本案 B-6a 發契約 0.5.2，FR-182 P3-4a 首腦更正版號後也發 0.5.2 蓋掉（少 KIND_VERIFY_FILE）。FR-182 自己發 0.5.3 合併版修掉。平行工作坊發同一套件，publish 前要查 Nexus 最新號（已進 memory）。
• 拆卡盤點要逐個選單項對實作：B-4／B-5／B-6 三張補卡都是「盤點時併類沒單獨列」或「漏套件那一半」。
• 共用 .venv 對應主線：runner 在工作區 poetry update 是當棒有效、合回後被蓋回；驗收用 PYTHONPATH 指工作區原始碼，不動共用 venv。
• 每個工作區 poetry install 各建一個 venv（37 個孤兒 ~9 G）＋ BE 工作區帶 4.3 G docs/（spec-site build 產物入版控）＝今天磁碟漲 50 G 的來源之一。
• 已註冊無照的 Agent 主控台登不進（FR-182×FR-179 縫，根因閘門關時不載 holder.state）——回寫 FR-182 母卡，不是本案的。

推翻了什麼：FR-170 §3.x「落地版直推一定通」；FR-171 A 指令通道（D2／D3／D11）。首腦自己的「直推整支刪」（決策者改判留開關）、「F-1／F-2 要等 P-0」（不吃結論，併批 1）。

commits（主 repo 文件）：0c190344a 討論稿＋design v1.0；081a28a23 開卡；3eec74a11 design v1.1；0978de723 B-4；2493f266a B-5；83d136056 C-2 拆；c5df193a8 B-6；445f69bbe／3d02aec61 README 進度。合回：BE b61d9710c／a577aec82。

做了什麼

• 接手 pre-flight 與 STATE 一致；決策者回報「主系統登不進主控台、沒授權卻沒地方輸入照」。
• 查到並直接修掉 FR-182 主控台三個缺陷（決策者兩度裁「直接改」，三筆回寫 FR-182 母卡 CM-3609）：
  • Agent 1a47d90：閘門關時 start_planes() 先用既有 cert_files.load_enroll_state() 載身分，只載不起同步。
  • FE 2a07071b：總覽授權提醒列加 missing／invalid／mismatch 紅條；沒照時隱藏「斷線＋網路除錯」條。
  • Agent 24ee084：8444 主控台改經 license.current_gate() 取 gate（原本找根容器 provider，但 8444 拿到的是 files 子容器）；ServerError 參數修正；fixture 改真實容器形狀。
• 本機 Agent 裝照後 sync 起來：心跳 200、長輪詢 commands?wait=30 循環——新通道第一次在真實執行環境跑通。
• 推 evidence-agent 與 FE；123 由決策者解 keyring 後 git pull 到 24ee084、首腦 poetry install（契約 0.4.1→0.5.3）並起 Agent，閘門 missing 待裝照。

關鍵決策：FR-182 缺陷由本案首腦直接修（決策者裁），不另開卡；總覽中間卡／狀態燈「可以接工作」誤導未改，建議開 FR-182 卡（未裁）。

教訓

• FR-182 的授權分頁在真實 Agent 上從沒正常過：測試 fixture 自己往根容器塞 gate，真實啟動交給 8444 的是 files 子容器。fixture 要用真實的物件形狀，否則守不到「取不到」這種接線錯誤。
• 前端改了沒效果時先實打 API 看資料：總覽提示沒出現，前端早已生效，缺的是後端回的欄位；第一輪只改前端白繞一圈。
• 123 git pull 靠 GNOME keyring：重開機（今天 17:14）後沒人登入桌面就解不開，ssh 進去 pull 失敗；Agent 17:11 停掉也是重開機造成的，不是故障。

推翻了什麼：第 1 棒 STATE 寫「主控台本機管理員登入通」只代表登得進，授權分頁其實是 500；「主系統票登入被擋由 FR-182 開卡」改為本案直接修完。

commits：Agent 1a47d90、24ee084；FE 2a07071b（皆 feature/FR-172，已推）；主 repo 本棒文件見下一筆 commit。

第 2 棒補記 — 2026-11-07 22:00 — C-2 文件收口

• 決策者裁 C-2 由首腦直接做、不等真機驗收：BE 5de3ae6cc（已推；同次 push 帶到另一 session 的 FR-184 5ac49c456）。卡 CM-3632 改修正待驗證。
• 教訓：寫文件前實打程式，抓到設計 D7「8443 只剩健檢」不成立——/blob、/detection 仍無條件掛著，只有 FR-171 cmd_* 受開關；先寫進手冊的「只剩健檢」當場改掉。
• 教訓：資安報告是 render_index 站，單檔 render_doc.py 會把 css 改指 specs/_shared 並丟導覽列；要整站重 build。