# 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 查無此卡，等於從未建立。