FR-157 Agent 本機設定主控台 — STATE（living，只描述此刻）

日期：2026-10-23　｜　母卡：CM-3026　｜　LOG：FR-157-LOG.md　｜　未 push

1. 要做什麼

檢測工具連線帳密（OpenVAS／SonarQube／OpenSCAP SSH 私鑰等）不存主系統，改在 Agent 機的主控台填、加密存 Agent 本機（推翻 FR-056 D9）。主系統 Agent 管理頁簽五分鐘入場券跳轉；同一主控台加「檔案瀏覽」查這台 Agent 實際存的證據檔。決策 D1～D11 全文見 design.md。

2. 卡片現況（子卡 CM-3027～3039）

卡	內容	狀態
CM-3027 A1	兩個能力點、主控台票	驗收通過待確認
CM-3028 A2	Agent 主控台殼、FE console	驗收通過待確認
CM-3029 B1	檔案瀏覽	驗收通過待確認
CM-3030 C1	工具表單下發、本機加密存	驗收通過待確認
CM-3031 C2	派工不再下發帳密	驗收通過待確認
CM-3032 D1	主系統三頁改版	驗收通過待確認
CM-3033 D2	既有帳密搬家	驗收通過待確認
CM-3034 D3	主控台操作進稽核	驗收通過待確認
CM-3035 E1	SPEC／手冊／安裝文件	In progress
CM-3036 E2	本卡：交接檔＋基線	交接檔已寫；基線重產等令
CM-3037 F1	Agent 斷線也進得了主控台	驗收通過待確認
CM-3038 F2	票帶 Agent／租戶名稱	驗收通過待確認
CM-3039 G1	前端權限判斷改回 v-can，守衛轉綠	修正待驗證

3. 出貨基線

本案主線 migration 只有一支：scripts/sql/2026-10-22-fr157-agent-console-capabilities.sql（兩個能力點 detection.remote-agent.configure／browse-files、選單綁定、預設角色授權；已登記 manifest.tsv）。scripts/init/02-schema.sql、04-seed-core.sql 目前不含這兩個能力點——新裝客戶會缺，且無錯誤訊息。 待決策者明示「可以寫 188:25432 基線庫」才重產（補套該支 migration → 跑 scripts/init/gen_*.sh → 核 schema_migrations +1）。套件 migration（jedi-remote-agent 010、jedi-detection handover）由套件機制帶，重產時套件版本要對。STG／POC 不碰。

4. 真 Agent 手測（本機 Agent 對本機 BE）

本機 Agent 直接跑 evidence-agent 源碼、對本機 BE 註冊，不出安裝包：啟動腳本 ~/guidant-agent-local/start-agent.sh，資料夾 ~/guidant-agent-local/data，log ~/guidant-agent-local/agent.log，只綁 127.0.0.1（8010／8443／8444）。新註冊的 Agent 是 pending，要在 Agent 管理頁核准，核准前心跳一律 403。

已走通：註冊→核准→心跳（credential_store／configured_tools／storage 進主系統）；設定轉移（7 支工具交到本機、雲端密文因 50.123 舊版仍啟用而保留，符合規則）；主系統簽票→主控台登入（6084／6085 進 system_logs）；工具與檔案分頁讀取；弱點資料首次同步與刪除後自動重拉（下載、指紋、驗章、切換、回報）；主控台亮色／暗色跟主系統。

還沒走：主控台改帳密存檔（6086）、清除帳密（6087）、測試連線、上傳檔後下載（6088）、派工跑 OpenVAS（需本機連得到一台 OpenVAS）、console-login。

5. 上線前提（等進版令）

jedi-remote-agent 1.6.0、jedi-detection 1.4.0 已發 Nexus，BE 已換 pin。剩 Agent 出包、FE console 進包，同屬進版令。Agent 安裝包的主控台體積上限放寬為 2.5 MB（含亮色主題約 2.2 MB）。

6. 決策者裁定（2026-10-23）

畫面用語「帳密搬家中」改為「設定轉移中」；主控台要有亮色並跟著主系統的亮暗設定。
「系統稽核紀錄頁」先不做：主控台操作（6085～6088）會寫進 system_logs，但客戶畫面上看不到，要查由原廠下 SQL。
「Agent 檔案」出廠給誰：已有 detection.remote-agent.update 的系統角色，兩顆能力點一起給，之後由客戶在角色管理頁自行調整。

7. 陷阱

「稽核員」出廠範本在 FR-155 後是專案角色，只認 proj.*，所以能力點 migration 不補它（結論見 §6）。
綁定 requirement=ANY：只持有 browse-files 的人也要看得到 Agent 管理選單。

8. 不在本案、記下待決：儲存轉移工具

切換儲存後端只影響新檔，舊檔仍從原處讀；舊儲存要下線前必須先搬，否則永久遺失，系統內建檔（框架 PDF）更是切換當下就讀不到。目前沒有工具，手冊寫的是「聯繫原廠或用 S3 同步指令、路徑保持不變」。決策者認為需要、來源與目的地要能彈性選，但現階段檔案量小（DEV 整個 bucket 約 1.4 GB）不急。觸發時機：第一個客戶要把既有檔案換到 Agent 當儲存、或量大到手動搬不實際時，另開 FR 走討論稿。FR-065 規劃時的卡號 CM-1279 在 Notion 查無此卡，等於從未建立。