FR-066 檢測 Agent 原生安裝包 — STATE（living，只描述此刻）

這份是 living 檔：每棒就地 Edit，只描述「此刻」。歷史脈絡與決策軌跡見同資料夾 FR-066-LOG.md。

這節寫一次，之後各棒不動（需求改案要在 LOG 記一筆）。

• 要解決什麼：檢測 Agent（evidence-agent repo，v0.2.27）目前以 docker 三容器（agent＋agent-db postgres＋nginx mTLS sidecar）出貨，但 agent 的本職是量測宿主機——機器指紋（/sys/class/dmi/id/product_uuid、/etc/machine-id、主網卡 MAC）在容器內讀不到或會漂移（已發生 Debian base image machine-id 空檔退回隨機 MAC 的指紋漂移事故），現行靠 deploy/collect-host-id.sh workaround 硬撐。業界同類（Nessus / Qualys / Wazuh / Datadog Agent）全部原生套件＋systemd 交付——貼宿主量測的產品，原生安裝就是行規。
• 目標模型：agent 改 Nuitka standalone 編譯（原始碼不可見）＋外部檢測工具（CINC / sonar-scanner / LibreOffice＋中文字型…）全包一顆 tarball（~1GB+，已接受），install.sh 一鍵裝成 Linux systemd 服務；封閉網路（既定支援情境）離線完全自足。SQLite 取代 agent-db、agent 自起 TLS 取代 nginx sidecar、build 期 manifest 簽章＋啟動驗章（FR-064 泛用層瘦身複用）。
• Windows 不實作，只出評估文件與前提清單（D8；附錄有 2026-08-18 口頭初判，非定案）。
• 戰線位置：落地版交付三部曲（FR-063 編譯／FR-064 防竄改／FR-065 installer，皆已收）之後的獨立新戰線——FR-065 期間決策者裁定「agent 安裝包另起新 FR、非 docker」，即本案。與 FR-065 殘項（PROD 鑰／T-4.2／收尾）無依賴，可平行。

本 arc 首腦 session＝分析決策／協調：需求釐清、拍板、拆卡、派工單、親驗抽查（不信 runner 自報）。實作全走 runner session——派工只給卡號＋一句話，內容都在卡裡。push 永遠 user 本人做。

0.1 🔒 先懂需求 gate（全讀，讀完才能碰任何東西）

1. 本檔 🧭 WHY 節＋ §2 已定裁示
2. docs/features/FR-066-2608-agent-native-installer/design.md §2（分工概述）＋§3（D1–D9 決策表）＋§6（拆分表與 Q1–Q4 歸屬）全讀；要細節再開 §4/§5
3. notion-fetch CM-1284＋要派的對應子卡

0.2 現況與待辦

4. 本檔 §1 當前狀態、§3 下一步
5. FR-066-LOG.md 最後 2 個 block

0.3 ✅ 冷接自檢（答不出來回 0.1，不要碰任何東西）

1. 為什麼 agent 不能繼續用 docker 交付？（指紋量測在容器內讀不到／漂移＋業界行規）
2. D3 為什麼外部工具全包一顆 tarball、不做分層附加包？（封閉網路漏帶無法補救）
3. SQLite 檔為什麼落資料目錄、不能放版本目錄？（D7 升級＝切 symlink，資料要跨版本存活）
4. 本案改 code 的 repo 是哪個？（evidence-agent，不是 BE——BE 只放文件）

D16 拍板：原生 tarball 暫不出貨、出貨一律 compose 版。.6 全系（1323~1328/1330~1335）收 Done；T-4.3 Windows 評估完成（1300 修正待驗證，首腦已親驗）；T-4.1 隨 D16 暫緩。

• D1 Nuitka standalone（非 onefile）→ tarball → systemd（2026-08-18）
• D2 agent-db（postgres:16）退役換 SQLite——現況只服務 jedi-file-upload upload_files 一張表；Q2 PG 方言掃描是 T-1.1 前置守門（2026-08-18）
• D3 外部工具全包一顆 tarball、離線自足，體積 ~1GB+ 已明示接受（2026-08-18）
• D4 nginx sidecar 退役，agent 以 gunicorn/ssl 自起 8443 mTLS（2026-08-18）
• D5 設定＝/etc/guidant-agent/agent.env（systemd EnvironmentFile），install.sh 互動三題生成；enrollment 既有流程零改（2026-08-18）
• D6 簽章防竄改瘦身版：build 期 manifest 簽章＋啟動驗章（FR-064 泛用層加 agent_manifest type），不做 runtime 抽查／lockdown（2026-08-18）
• D7 升級＝versions/<ver>/＋current symlink 切換；SQLite／憑證在資料目錄不隨版本走；無備份模型（agent 無 migration）（2026-08-18）
• D8 Windows 只出評估文件不實作；design.md D8 附錄有口頭可行性初判（非定案），是 T-4.3 起點素材（2026-08-18）
• D9 指紋只做 Linux 原生直讀，不預抽 OS 抽象層；collect-host-id.sh 廢除（2026-08-18）——⚠️ D11 起指紋改二源，本條的「三源直讀」已被 D11 部分取代
• Q1–Q4 是對應卡的前置查證項（Q1 LibreOffice 離線形式→T-2.1／Q2 PG 方言→T-1.1／Q3 EXCLUDE 名單→T-1.3／Q4 openscap-utils・sshpass 殘留→T-2.1），不阻擋開工但 Q2 先行
• D10 EL（Rocky/RHEL）＝方案 A 低 glibc 容器編譯（2026-08-20 定，隨 .5 暫緩）
• D11 指紋二源化全域：sha256(product_uuid|machine-id)，MAC 退場；撞號防護＝BE enroll 端偵測（2026-08-21）
• D12 雙形態單產線：compose=有 docker 首選／原生=封閉網路；同一顆產物同一套簽章；升級包不帶 seaweedfs image、形態宣告寫 manifest 檔頭（2026-08-21）
• D13 「使用 Agent 服務」＝FR-039 既有功能，BE/FE 零新功能，只做 agent 端（2026-08-21）
• D14 儲存後端設定＝CLI（configure-storage）先做；web 下發開 CM-1329 評估卡等 PM（2026-08-21）
• D15 compose 版配互動安裝程式（照 FR-065 主產品模式），受眾一線工程師不假設會 docker（2026-08-22）
• 恢復預設方案（2026-08-22）：出廠快照＋一鍵恢復（主產品 FACTORY_DEFAULT 隱藏列／agent factory-defaults.env）；排除動態讀現值、教 user 翻 credentials、恢復重生帳密
• D16 出貨形態收斂（2026-08-22）：原生 tarball 暫不出貨、現階段一律 compose 版（開發成果保留，解凍等商務需求）；T-4.1 暫緩、T-4.2 改 compose 為主。同日裁示：compose 交付包廢除 install/upgrade 兩包制、收斂一顆通吃（CM-1335，evidence-agent a89a701）。⚠️ 斷網封閉網路驗證（D3 根基）至今無人跑過，不隨原生凍結——歸屬待裁示
• WSL/docker 過渡風險接受度（2026-08-22 決策者口頭）：Windows docker 過渡的指紋不穩問題，「只要有 log 記錄發生什麼事、或可重新註冊 agent 就沒問題」——重置後重綁定屬可接受維運事件，非否決點（T-4.3 文件的「不建議當正式方案」讀成「不當長期形態」即可）
• 防篡改宣稱邊界（T-6.2 查證，2026-08-21）：只可講「改動必被偵測」（雲端 sha256 錨點），不可講 WORM／不可刪除——SeaweedFS 3.99 Object Lock 有效但整桶刪擋不住、且我們未啟用

主線（決策者 2026-08-23 拍板）：手冊收完 → v1.16.0 進版 → 189 遷移 bundle 形態。之後全環境統一「拿新 bundle 跑 install.sh --upgrade」升級模式。

1. ✅ 手冊全收（2026-08-23）：CM-1347（主產品對齊 1.15.0）＋CM-1299（agent 手冊十一章）＋CM-1348（21 章全面白話化，決策者初審打回後改寫、終審過）＋CM-1349（build 工具修 .md→.html 連結改寫＋SPEC 站白名單補兩頁）四卡 Done。手冊落點：docs/user-manual/onprem/＋agent/（md）與 onprem-html/＋agent-html/（網頁版，入口在 FR-065/066 文件站）。⚠️ 決策者提過「有個需求要先處理再發版」——內容未揭露，下一棒先問。
2. 可與手冊平行的前置：①PROD 簽章鑰四步組（LC repo 生鑰→BE PUBLIC_KEYS commit→出貨簽章切 PROD→驗證；正式 bundle 硬門檻）②189 探路盤點（唯讀）：舊 DB schema 落差（guidant_ai_poc 在機上 postgres 容器 port 25432、main HEAD 8c82e8e6 約 1.13 era、跑已退役 main_app.py）、.env 全量抄錄、camunda/pgadmin 誰在用、停機窗口問決策者。
3. 按序執行：merge feature/FR-066→main（BE+FE，決策者親手或明示）→ version-bump v1.16.0（skill 全套：release note/pyproject/FE 對齊/specs 凍結快照；⚠️ 191 現跑的 1.15.0 bundle 內容超前 main 的 1.15.0——進版時收掉此不一致）→ build_all 出正式 bundle（PROD 鑰簽）→ 189 遷移（pg_dump 舊庫→裝 bundle→灌回→upgrade 自動補 migration→驗收；POC 異動，執行當天等決策者當次明示）。
4. 連帶待拍：STG（188 裸跑）要不要同批遷 bundle；190/191 免密 sudo 收回。
5. 母卡 CM-1284 收口條件：雙手冊收完＋user 過目（Windows 已由 D19 移出範圍；斷網維持「先不管」）。
6. design.md D6 註記仍欠；其餘掛置：1298/.5 四卡/1329 暫緩；agent 自更新 follow-up；DEV 測試資料收尾清；demo 用 160 要有人登入帶 Docker Desktop（runbook 素材在 t71 報告）。

⚠️ 本節是建議清單，不是執行授權。接手方讀完盤點完即停，等 user 發令。

• 不切 branch、push 永遠 user 本人做、顯式 git add <檔名> 禁 -am；BE 與 evidence-agent 分開 commit。
• runner 收工回寫子卡「修正待驗證」＋白話已完成修正段＋commit hash；母卡／子需求卡收尾等令（首腦驗收後收）。
• 碎片卡預設不寫新 unit test（CLAUDE.md 測試政策）；驗證＝手測步驟＋既有測試不弄壞。
• 🔴 環境鐵律：開發只動本機／DEV；STG/POC/基線庫不碰。
• 派工＝先有 Notion 卡（本案 17 卡已建齊，派工 prompt 帶實際卡號＋URL）。

• Windows 實作（只出 T-4.3 評估文件）；OS 指紋抽象層（D9 明示延後）。
• ZAP / OpenVAS / OpenSCAP / Nmap 引擎不進 bundle（客戶自備或裝在受測機）。
• FR-064 runtime 全家桶（抽查／lockdown／unlock）不做（D6 瘦身版）。
• FR-065 殘項（PROD 鑰／T-4.2／全案收尾）屬另一條戰線，不在本 arc 順手做。

接手 FR-066 檢測 Agent 原生安裝包（母案 CM-1284）。先讀
docs/features/FR-066-2608-agent-native-installer/handoff/FR-066-STATE.md（§0 讀序全走：
WHY＋design.md §2/§3/§6＋Notion 母卡）＋ FR-066-LOG.md 最後 2 block，
答完自檢 4 問、跑完 §4 pre-flight 後回報現況。
讀取與盤點完成後不做任何事——不派工、不跑測試、不改檔，等我下指令才開始作業。