FR-166 Agent 獨立作業主控台 — STATE（living，只描述此刻）

更新：2026-10-28 首腦第 7 棒收尾（23:xx）｜全案收尾：決策者 123 手測五項全過、69 張子卡全 Done｜出貨基線已重產（BE 4c927ece4）｜套件已發版、BE 釘版｜123 跑 Agent 0ccb44c＋主控台 44f2e5f7｜BE 收尾 commit 未推（基線＋文件）；FE／Agent／套件無未推｜總結 2026-10-28-FR-166-SUMMARY.md 讀序：本檔 → FR-166-LOG.md 最後一段（第 6 棒）→ ../design.md（v2，§3 決策 D1～D23、§10 手測追加）→ ../README.md → ../prototype/index.html

老闆 2026-10-26：Agent 與主系統斷線時仍能獨立作業——直接打 Agent 網址登入、不經任務按八支掃描工具、網路除錯（ping／traceroute 等，使用者勾選、有些公司會告警）、斷線不停工復線補傳、多據點各自作業報告回台北；不能變跳板或駭客工具。決策者追加：登入方式比較業界模式、LDAP（老闆會要）、重啟 Agent、總覽像儀表板、登入頁與殼照主系統改 Agent 模式。

1. 「誰能登入」與「能掃誰」為什麼是兩道門？local-admin 拿到了能掃任意 IP 嗎？（答：不能，掃描範圍由主系統下發的清冊決定、不看身分；未同步的 Agent 連清冊都沒有，什麼都掃不了）
2. 第三方元件掃描是「移到 Agent」嗎？（答：不是，FR-156 後執行本來就全在 Agent；本案只補 Agent 自己的入口，結果走既有 source_scans）
3. 為什麼不起 Postgres、為什麼抽 jedi-ldap 而不是 Agent 裝 jedi-iam？（答：§13.4／§3.5）
4. §13 推翻了前稿哪四處？（Nmap 執行主機已過清冊；主系統沒有派工逾時；receive_result 只對 cancelled 冪等；Agent 沒有 migration 機制）

全部在 discussion.md §9 表。關鍵幾條：

• D1 三層登入：安裝時強制設 local-admin（既有救援碼 sub 加密碼、永不過期、仍過清冊）＋主系統授權離線操作者（心跳下發名單、本人在線時設離線密碼、到期日、離線 30 天停用）＋入場券跳轉；救援碼保留。Agent 端沒有新增使用者。
• D3 八支工具全部可在 Agent 手動執行（決策者明令「所有掃描工具都要能在 Agent 獨立執行」）；ZAP 網址解析成 IP 後過清冊，Agent 端 allowed_targets.py 補。不要再拿 FR-129 當理由砍 ZAP。
• D5 網路除錯：本機儀表板九卡（自動載入、無噪音）＋十項診斷（安靜預設勾，traceroute／mtr 式要勾並確認）全進第一版；結果＝路徑圖＋判讀卡。tcpdump／iperf／埠範圍／nmap 探測／ARP 掃描不包（D10）。
• D7／D15 續傳：Agent outbox（任務結果永不丟）＋心跳 drain；主系統 receive_result 改任何終態冪等；派工 Agent 離線 7 天 reaper。
• D8 不加據點欄，靠 Agent 名稱。D9 CIDR 安裝時設底線、主系統只能收緊、隱含 loopback。D11 不起 Postgres。D12 未同步只准 local-admin 登、只准主系統連線診斷。D13 新裝強制設密碼、升級非互動不強制。D14 重啟兩入口＋心跳旗標 when_idle／now。D16 最小 schema_version 表。
• D17 Agent LDAP 三選一（同步／自設／不接），名單仍主系統決定。D18 憑證首次信任釘住、拿掉勾選框、預設 STARTTLS（推翻 CM-2239，主系統 LDAP 設定頁一併改）。D19 抽 jedi-ldap 零相依套件。
• 殼：結構照主系統（側欄 14rem、頂欄 4rem）、身分靠四訊號（側欄 teal、側欄頂 AGENT＋這台狀態、常駐狀態列、分頁標題）。總覽＝儀表板不另開 Dashboard 頁。
• 資安例外兩條（SR-08.2 逐項回結果、SR-04.9 內網直連）照三條件登記：目標受限／單目標序列限速／稽核含完整目標。
• 多因子明列「太龐大不做、決策者可反對」。
• D22：主控台儲存位置只能選內建 SeaweedFS，其餘三型只走 CLI。
• D23：離線操作者權限跟主系統同一份。名單只管能不能離線登入與到期日，範圍每次心跳依當下 Agent 能力點算（restart 不下放）；沒有任何 Agent 能力點的人不可加入。

母卡 CM-3109。狀態欄：⬜ Not started／🔵 In progress／🟡 修正待驗證／🟢 驗收通過待確認／✅ Done／⏸ 暫緩。

以 Notion 讀回（2026-10-28）：69 張。原案＋補丁／P5 共 59 張（58 驗收通過待確認、CM-3148 暫緩），批號以工作坊實際排法為準；表尾「延」開頭是 2026-10-28 決策者逐項追加的延伸卡（首腦直接做，不走工作坊）。

全案已收尾（2026-10-28）。決策者 123 手測五項全過、卡全 Done、基線重產、手冊／SPEC／SUMMARY／analysis／memory 補齊。總結見 2026-10-28-FR-166-SUMMARY.md。

等令：push BE 收尾 commit；母卡 CM-3109 改 Done（決策者）；上 STG／POC（前提 https）。

續作 FR-166.1（母卡 CM-3199，2026-10-29）：PM 六條回饋另立續作，本案不重開；兩邊 Notion 母卡已互指。待決策者第 1 項（檢測工具頁拆或翻回）已隨 FR-166.1 B3 定案為翻回改名「Agent 工具帳密代設」。

123 升級固定步驟：git -C /opt/evidence-agent pull origin feature/FR-139 →（相依有變才）poetry install --only main → 本機 npm run build:CONSOLE，COPYFILE_DISABLE=1 tar -czf 打包 scp 到 ~/guidant-agent-dev/、舊 dist 改名 dist-console.bak-<時間> 再解開 → kill $(cat agent.pid) 等它結束 → bash start-agent-dev.sh。打路由要 curl --http1.1；8443 是 mTLS，主控台在 8444。只換畫面時不用重啟 Agent。

待決策者（問了沒答或等 PM）：

1. 主系統「檢測工具」頁已隱藏，PM 確認後是連端點一起拆（開卡）還是翻回 enable=1。
2. 守衛測試 4 支紅不是本 arc 的：evidence-reuse-* 三頁沒登記 ui_routes、scan-tool-resources 沒進入門檻——要不要開卡。
3. 上 STG／POC 前主系統要有 https（CM-3178）。
4. 本機管理員登入通知只寄信，Telegram／Discord 要不要。
5. DEV 補登 011、012；出貨基線重產 第 7 棒已做。
6. jedi-iam 4 支既有紅燈（FR-155 留下：plugin_contract、role_import ×2、my_capabilities）要不要修。
7. 刪除 Agent 是硬刪、不清關聯、開著的機器會自動重註冊——要不要開卡改成「在線擋下」或「一併清理」。
8. 123 的掃描帳號 sudo 權限過寬（不限於 nmap），第 6 棒又讓 Agent 用的掃描私鑰能登入它——正式環境應只留 nmap 那條 sudo。細節在 123 主機上查，不寫進文件。
9. 主系統多處「複製」按鈕在 http＋IP 下無效（navigator.clipboard 需安全環境），決策者裁「測試機的關係先不管」。

• 五 repo 都在 feature/FR-139：BE ~/Projects/Billows/Audit-Manager/compliance-manager-be、FE compliance-manager-fe（主控台源碼 console/，npm run build:CONSOLE 出 dist-console）、Agent ~/Projects/Billows/Audit-Manager/evidence-agent、套件 ~/Projects/Jedicogy/module/jedi-python-package/、test compliance-manager-test。
• 本機 Agent：源碼跑，~/guidant-agent-local/start-agent.sh（CLOUD_WEB_URL=http://localhost:5180、AGENT_ALLOW_INSECURE_CLOUD=1），主控台 https://127.0.0.1:8444/console。已設本機管理員密碼（存在首腦 scratchpad，不入版控；要用請決策者自行重設 local-state set-admin-password）。名稱「本機測試 Agent」。
• 123 dev Agent：/opt/evidence-agent 源碼跑（0ccb44c），~/guidant-agent-dev/start-agent-dev.sh（CLOUD_ENDPOINT=http://10.8.0.6:8000、CLOUD_WEB_URL=http://10.8.0.6:5180、AGENT_ALLOW_INSECURE_CLOUD=1），前端 ~/guidant-agent-dev/dist-console（44f2e5f7；舊版備份 dist-console.bak-<時間> 已累積十來份，未清）。沒設本機管理員密碼（燈紅屬預期，源碼模式沒走安裝程式）。掃描帳號第 6 棒補了 Agent 掃描私鑰的授權（改前有備份），Nmap 可用 123 當執行主機。
• 租戶 102 離線登入天數目前是 5（決策者手測改的），預設是 7。
• 本機 BE 已無 path dependency（第 6 棒發版後還原）。日後要改套件：pyproject 該套件 pin 註解、path 行取消註解，用 .venv/bin/pip install -e <套件路徑> --no-deps（poetry install 會被 lock 擋）；切完 pip show 確認每支都是 Editable——重裝一支會把別支換回 wheel。開發期間 pyproject／poetry.lock 設 assume-unchanged、不可 commit。
• worker 要另外起：(RUN_MODE=worker nohup .venv/bin/python main.py >> log/worker-stdout.log 2>&1 &)。沒起的話第三方元件分析、證據分類、弱點庫檢查全停在排隊，畫面四個圈空轉（第 5 棒踩到）。
• 重啟 BE／Agent 不要包在會被停掉的背景指令裡：停背景指令會連帶殺掉它起的程序（本棒踩兩次）。用 (nohup … &) 起。
• headless 截圖：compliance-manager-test/ 內跑 node＋Playwright（腳本放 repo 內暫存檔，跑完刪；放 scratchpad 會找不到 playwright）。主系統登入頁有 Turnstile，用 API 登入後把 token 寫進 localStorage 的 cm_store（currentLocale: 'tw'，用 addInitScript）。主控台用 POST /remote-agents/<uid>/console-ticket 簽票、POST /console/session 換 cookie。PrimeVue popup 選單（⋮）在 headless 點不開，改用元件單元測試＋在頁面裡直接嵌入目標網址實測。
• FE 開發代理：vite.config.js 把 /api 轉到 VITE_DEV_API_TARGET（預設 http://localhost:8000），只在 npm run dev 生效。開發機要 HTML 預覽正常，.env.development.local 的 VITE_API_URL 必須是 /api/1.0（直連 8000 會被 X-Frame-Options: SAMEORIGIN 擋）。
• 超標檔：RemoteAgentManage.vue ~530、Overview.vue ~300 已拆過；install.sh ×2、scheduler.py、detection_orchestration_service.py、agent_enrollment_service.py 620（接近上限）。

• 首腦不開 subagent（決策者本輪亦問「要不要 subagent 做互動雛形」，首腦建議不用：脈絡都在首腦，CLAUDE.md 定首腦自己刻雛形）。
• 無卡不派；開卡一次建完；派工由工作坊。
• 雛形交稿前 grep -n "border-left" 要 0；資料區塊上下疊不排左右；清單頁 SegmentButtons。
• 文件衛生 grep（原本／改判／第 N 棒／這次整理／當初）要 0。