這張卡做什麼（白話）

給 installer 加一個 fingerprint 子命令：不用開瀏覽器、甚至服務起不來時，在主機上跑一行指令就能算出這台機器的授權指紋（license 綁定用）。它是精靈頁指紋顯示（主展示面）的保底工具——裝機尾端自動印一次、之後客戶隨時可重跑。

• 母案 CM-1189：https://app.notion.com/p/FR-065-Installer-3bc346da4cd081c4abf3ce74a28ba384
• 所屬子需求卡 CM-1245：https://app.notion.com/p/FR-065-3-Web-3be346da4cd081f3b401c610fa8e419d
• 設計文件：docs/features/FR-065-2608-onprem-installer/design.md §4.6（D6）

具體實作內容

• installer fingerprint 子命令（install.sh 子命令形式）：讀宿主 /etc/machine-id 算 sha256(machine-id)
• 演算法必須與 BE machine_fingerprint.py 一字不差（含讀檔後是否 strip、編碼、大小寫輸出格式等每一個細節）
• 裝機尾端（install.sh 完成訊息附近）自動印一次
• 加「兩邊同值」驗證步驟：實作時實際比對 installer 算出的值與 BE API 回的機器指紋完全相同，留紀錄

易踩雷提醒

• 指紋演算法差一個 strip／大小寫就是不同值——客戶拿錯指紋申請 license，簽回來的照綁不上，除錯成本極高
• machine-id 檔案內容尾端有換行——兩邊對 newline 的處理必須一致（以 machine_fingerprint.py 實作為準）
• 容器內 BE 讀的是掛載進去的宿主 /etc/machine-id——installer 在宿主直接讀同一檔，來源一致才會同值

驗收條件

• installer 與 BE 算出同一指紋（實測比對紀錄）
• 服務未起時仍可查

依賴

• 無前置卡

已完成修正（2026-08-17，commit e0a8f423）