掃描工具資源管理

我們現在的 Agent 組態檔好像沒有統一在一個功能內……未來應該還會有很多掃描套件的組態檔案或是 profile 或是資料庫等等要管理，是不是應該整理在一個功能裡面？不然每次多一個工具又多一個功能頁面，實在太亂也四散各處，像這次新的弱點資料庫就是這樣，當初做的時候完全忘記有掃描設定檔管理。 — 決策者原話（2026-10-26）

1.1 現況：兩頁各自為政

1.2 它們像在哪、不像在哪

像的部分：都是掃描工具要吃的內容；都要管「從哪來、多新、送到 Agent 沒有」；都是管理員在維護。

不像的部分是形狀，而且未來進來的東西也會落在這兩種形狀之一：

FR-059 當初就把形狀 A 設計成「不綁工具」：新工具接入零開發，seed 一筆就能用（FR-059 design §5.7）。形狀 A 的問題已經解掉了。真正沒解的是形狀 B：弱點資料庫是第一個參考資料庫，被做成一支專用頁、專用服務、專用的 Agent 同步接線。下一個 feed 進來，工程師只能整套複製一份改名，又多一頁。

整案一句話：把兩頁收進一個入口「掃描工具資源管理」，兩個分頁、兩種版面；資料不動、後端只加一支紀錄分頁端點；再定一條「新資源只能掛這裡」的規則。

依賴：第一期不依賴任何人。第二期等第二個參考資料庫真的要進來時才做（D3）。決策者功課：D3、D5、D6 三項裁示。

4.1 畫面

雛形：prototype/index.html。重點：

• 頁首：標題「掃描工具資源管理」＋一句說明。
• 兩個分頁（PrimeVue TabView）：「設定檔／基準」、「參考資料庫」。各分頁依權限顯示，沒權限的分頁整個不出現；只剩一個分頁時仍顯示分頁列（讓使用者知道這頁有兩類東西）。
• 分頁一：掛既有 DetectionProfileManageView.vue，零改動。控制項頁 DetectionProfileControlsView.vue 路徑改掛在新入口底下。
• 分頁二：一卡一庫。卡的版面固定：標題列（名稱、給哪個工具用、狀態膠囊）→ 連不到站的黃字提醒（只在發生時出現）→ 資訊列（資料日期含新鮮度色、來源與站台、自動更新開關、檢查頻率下拉（選項來自 system_menus 的 vulndb_check_interval）、下次檢查、四個來源明細常駐顯示、Agent 同步摘要與明細展開）→ 上傳進度條（上傳中才出現）→ 底列（檢查更新、上傳更新包、更新紀錄）。今天只有弱點資料一張，內容照 VulndbManage.vue 搬，把原本整頁的版面縮成一張卡。
• 原頁功能一個不少：搬進卡片是換版面不是減功能。驗收時拿 VulndbManage.vue 現有的每個控制項逐一對照（決策者 2026-10-26 審雛形時抓到頻率下拉漏畫）。
• 沒接上的不預告：設定檔分頁的「工具」下拉只列已接入設定檔庫的工具；參考資料庫分頁只列已登記的資料庫。不放「即將推出」、不放灰掉的選項。
• 更新紀錄改成對話框（點卡上「更新紀錄」開，按鈕不帶筆數），內有分頁，不再佔頁面下方整塊。後端 status.recent 現在固定回 20 筆，改成分頁端點（本案唯一的後端改動，小）。
• 不出現：任何「即將推出第二個資料庫」的預告。雛形上那張虛線卡只給決策者看形狀。

4.2 選單與路由（一支 migration）

能力點不新增、不改名（D2）。migration 屬主線 phase=active，寫完回報「出貨基線待重產」。

4.3 前端

超標提醒：DetectionProfileManageView.vue 947 行已超 800 行上限，本案不往裡加（它只是被掛進去）。

4.4 後端

只有一處：更新紀錄從 status.recent 固定 20 筆改成獨立分頁端點 GET /system/vulndb/updates?page=&size=（照既有分頁慣例）。其餘兩組端點（/detection/profiles/*、/system/vulndb/*）照用。

4.5 收尾文件（D4）

為了讓第一期的版面不會到第二期被推翻，這裡把第二期長什麼樣先講一次。

%%{init: {'theme':'base','themeVariables':{'primaryColor':'#E2F0F1','primaryTextColor':'#14201F','primaryBorderColor':'#0E7C86','secondaryColor':'#EEF2F3','secondaryTextColor':'#14201F','tertiaryColor':'#FBFCFC','tertiaryTextColor':'#14201F','lineColor':'#4A5A5C','textColor':'#14201F','mainBkg':'#E2F0F1','nodeBorder':'#0E7C86','nodeTextColor':'#14201F','edgeLabelBackground':'#FBFCFC','titleColor':'#14201F','clusterBkg':'#FBFCFC','clusterBorder':'#E4EAEB','actorBkg':'#E2F0F1','actorTextColor':'#14201F','actorBorder':'#0E7C86','actorLineColor':'#C7D1D2','signalColor':'#4A5A5C','signalTextColor':'#14201F','labelBoxBkgColor':'#EEF2F3','labelBoxBorderColor':'#C7D1D2','labelTextColor':'#14201F','loopTextColor':'#14201F','noteBkgColor':'#F6EBD5','noteTextColor':'#14201F','noteBorderColor':'#9C6B12','activationBkgColor':'#EEF2F3','activationBorderColor':'#C7D1D2','sequenceNumberColor':'#FFFFFF'}}}%%
flowchart LR
  subgraph plugins[各工具插件]
    P1[jedi-source-scan<br/>登記：vulndb]
    P2[未來某個 Agent 自帶工具的插件<br/>登記：它的資料庫代號]
  end
  REG[參考資料庫登記表<br/>代號／名稱／用途／支援的動作]
  API[GET /scan-resources/reference-dbs<br/>回清單＋每個的狀態]
  FE[參考資料庫分頁<br/>一卡一庫，照清單長]
  AG[Agent 心跳：帶每個資料庫的日期<br/>拉包：/agents/reference-dbs/&lt;代號&gt;/bundle]
  P1 --> REG
  P2 --> REG
  REG --> API --> FE
  REG --> AG

契約的五個動作（每個資料庫宣告支援哪幾個，不支援的按鈕不出現）：看狀態（日期、來源、紀錄）、上傳更新包、檢查更新、自動更新開關與頻率、Agent 同步狀態。弱點資料庫今天五個都有，是契約的樣板。

不做的事：不把 vulndb_updates 改成通用表。每個資料庫自己的紀錄表自己管，契約只規範「回傳最近 N 筆的形狀」。

四張卡，兩批。

A1、A2、A3 同批：A1 只動 SQL、A2 只動 FE 殼與卡、A3 動 BE 與紀錄元件，不撞檔；A2 的對話框先接現有 status.recent，A3 做完再換端點（卡內寫明）；A2 的路由名要與 A1 的 ui_routes.name 一致（scan-tool-resources），卡內寫死。

• D4：FR-156 G1 收完後，更新 SPEC 兩頁與使用手冊的入口位置（B1 卡）。
• 回報「出貨基線待重產」（A1 migration 屬主線）。
• docs/claude/frontend-overview.md 加規則：新工具資源一律掛掃描工具資源管理。
• FR 登記表 docs/features/README.md 加一列（本討論稿落地時一併做）。