FR-190 · 需求索引 · 本頁由 build 掃資料夾生成

FR-190 Agent 主控台權限能力點化

已收尾（2026-11-10 母卡 CM-3765 與 14 張子卡 Done）；四 repo 已合回 feature/FR-172 未 push；出貨基線已重產；STG／POC 未上

狀態：詳見下方文件 3 份 handoff 2 份

§1

🔴 先看哪一份

文件	性質	看什麼
定版交付	定版	最後長什麼樣：26 顆清單、權限怎麼到 Agent、規則、驗證結果、沒做完的
收尾總結	證據（收口）	做了什麼、終局決策、四 repo commits、行為差異、follow-up
討論稿	需求與討論	為什麼要拆、拆成什麼、D1～D9 的來龍去脈
互動雛形	畫面	四頁：角色設定頁、稽核員看到的主控台、舊版 Agent 橫幅、離線操作者對話框
設計定案	設計 v1.0	D1～D9 定案表、5.1 26 顆清單、5.2 舊顆展開、5.3 Agent 守門對照、拆卡表
拆卡底表	工具	`python handoff/cards.py` 驗批次與撞檔

§2

結論

Agent 主控台權限已經是主系統能力點、已經同步過去，問題是顆粒太粗：7 個範圍，一個「設定」包 9 頁、一個「下載」包 5 種檔。
拆成 11 個主控台功能 × 檢視／設定／執行／下載四個動作，共 26 顆，模組前綴用新的 agent（不放 detection，避開出貨 seed 的 detection.* 萬用字元讓稽核主管與唯讀角色自動拿到主控台權限）；同步機制（簽票、離線名單）不重做。
三邊（主系統、jedi-remote-agent、Agent）改讀 jedi-agent-protocol 裡同一份清單，不再各自硬寫。
舊 Agent 收到不認得的權限名改成「丟掉、照常登入、頂部提醒」，不再整張票拒收。
主系統派下來的掃描紀錄歸「掃描 · 檢視」，不再掛在「設定」底下。
像但不做：Agent 端自己做角色表、單台 Agent 給個人特別權限、舊主系統配新 Agent 的相容。

§3

📊 總進度

棒	Notion 卡	做什麼	狀態
討論稿	—	discussion.md ＋四頁雛形	✅ 2026-11-09
裁示	—	D1～D9	✅ 2026-11-09
design ＋拆卡	CM-3765	design.md、handoff/cards.py、母卡＋14 子卡	✅ 2026-11-09
批 1	CM-3766 P0-0 環境卡、CM-3767 P0-1 protocol 清單		✅
批 2	CM-3768 P1-1、CM-3769 P1-2、CM-3770 P1-3、CM-3771 P1-4、CM-3773 P1-6		✅
批 3	CM-3772 P1-5、CM-3774 P1-7		✅
批 4～5	CM-3775 P2-1 → CM-3776 P2-2		✅
批 6～7	CM-3777 P3-1 → CM-3778 P3-2、CM-3779 P3-3		✅
合回	—	四 repo ws-CM-3765 → feature/FR-172（BE 654edf68b、FE f530c70c、Agent bee291e、jedi b98737d8），零衝突	✅ 2026-11-10
基線重產	—	P1-2 migration 套進 188 基線庫（備份 20261110_1630）、重產 02／04／99、乾淨 postgres:16 裝驗 26 顆／舊顆 0／子頁綁 26／稽核員預帶 2／無萬用字元命中	✅ 2026-11-10
畫面手測	—	角色頁子頁、比照帶入鈕、主控台側欄與舊版橫幅，決策者用新版 Agent 實機看	⬜（follow-up）
收尾	—	SUMMARY、analysis、memory、母卡 Done	✅ 2026-11-10

§4

需求討論紀錄

2026-11-09 決策者提需求：下載權限要能分功能給；Agent 主控台的選單與操作都能力點化、從主系統同步過去；一併整理 Agent 的角色能力點。
2026-11-09 決策者裁：顆粒做滿 26 顆（D1）；舊 Agent 不認得的權限丟掉不拒收（D2）；主系統派的掃描紀錄歸掃描檢視（D3）。
2026-11-09 決策者問「Agent 的角色能力點自己有一區對嗎」：有，但現況 11 顆平鋪在「檢測 › Agent 管理」底下與管理用四顆混在一起；本案改成「Agent 主控台」子頁分組（D4 A 案，待裁）。
2026-11-09 決策者問「要不要跟主系統設定一起走，像掃描設定主系統有勾這邊也有」：比對 11 個功能對應表後建議不連動但一次給（角色範本預帶＋「比照帶入」鈕），兩處等價的（工具帳密、金鑰換發）改守同一顆；開成 D9 待裁。
2026-11-09 決策者裁 D4 A、D5 A、D8 A、D9 要；D6 改判「重啟下放離線操作者」（推翻 FR-166 D14，理由：斷線卡住要能現場重啟，重啟可逆、換版不可逆）；D7 照表。
2026-11-09 決策者點名派工紀律：雛形是解釋版，之前 runner 把註解、說明、分步切換鈕照抄進正式版；本案每張 FE 卡紀律段帶「雛形只取結構、文案全部重寫」，開卡範本加為硬規則 8。
2026-11-09 開卡後自動資安審查抓到：seed 四個系統角色帶 detection.*.*／detection.*.read，26 顆若放 detection 底下會被自動送出去（FR-166 的 7 顆已踩在這洞上）。模組改 agent，P1-2 加守衛測試掃 seed；design／discussion／cards 就地改，母卡與十張子卡 append 更正（卡未派）。
2026-11-10 首腦總驗：protocol 26 顆／模組 agent／離線 24 顆；DEV 26 顆在、舊顆 0、子頁在、無孤兒；BE／Agent／FE 舊名 grep 全 0；Agent 全套 2542 綠、remote-agent 606 綠、protocol 鏡像對 worktree 與合回後主線皆 96 綠；FE 權限測試 74 綠、兩個 build 過、border-left 0；BE 守衛紅的一條是主線本來就紅的 13 顆 proj.*，與本案無關。打折：掃描報告沒下載到 200（DEV Agent 離線）、Agent 新舊票用測試 client、畫面沒人實機點。
2026-11-10 決策者標 14 張子卡 Done、裁合回與基線重產、裁收尾。文件盤點：卡上寫的 role-manage.md runner 改寫在 access-role-detail.md（FR-132 後角色設定頁的實際 SPEC），判斷正確。合回後 FR-188 session 依決策者指示把 FE「換發憑證」按鈕改掛 agent.keys.update 並重產權限矩陣。

§5

文件

以下全部由 build 掃資料夾產生，新增檔案重 build 即自動出現。標題連結指向渲染後的 HTML，md 連向源檔。

定版交付

文件	類型	標題	最後更新
FINAL-SPEC ／ md	定版交付	定版交付：Agent 主控台權限能力點化	2026-11-10

需求與討論

文件	類型	標題	最後更新
discussion ／ md	需求討論稿	Agent 主控台權限能力點化	2026-11-09

設計

文件	類型	標題	最後更新
design ／ md	設計	Agent 主控台權限能力點化	2026-11-09

交接與收口時間軸（handoff/，2 份）

由新到舊。每份是某一棒次交接當下的完整現況快照，看某個時間點「當時知道什麼」請從這裡進。

日期	文件	標題
2026-11-10	ENV ／ md	FR-190 開發環境：套件改走本機路徑
2026-11-10	2026-11-10-FR-190-SUMMARY ／ md	FR-190 Agent 主控台權限能力點化 — 收尾總結（2026-11-10）

資產子資料夾（無文件，不建頁）：prototype/（1 個檔）

§6

Notion 卡

卡片內容（決策紀錄、驗收條件）以 Notion 為準，本頁只記座標。

關係	卡號	標題	狀態
母案	CM-3765	FR-190 母案	—
子卡	CM-3766	—	—
子卡	CM-3767	—	—
子卡	CM-3768	—	—
子卡	CM-3769	—	—
子卡	CM-3770	—	—
子卡	CM-3771	—	—
子卡	CM-3772	—	—
子卡	CM-3773	—	—
子卡	CM-3774	—	—
子卡	CM-3775	—	—
子卡	CM-3776	—	—
子卡	CM-3777	—	—
子卡	CM-3778	—	—
子卡	CM-3779	—	—

§7

關聯

相關需求：