八、解除安裝¶
這章在講什麼：怎麼把 Agent 從這台機器上移除。
就像退租搬家——房子要還回去，但東西要不要一起丟掉，是另一個決定。解除安裝也一樣：服務一定會移除，但「證據檔要不要跟著刪」由您決定，程式會當面問您。
什麼時候看：這台 Agent 要下線、要換機器、或要打掉重裝時。
移除的指令只有一條：
但先別急著執行——請先看完 8.1 的兩件事，再回來下這條指令。
8.1 執行前先想清楚兩件事¶
① 證據檔還需要嗎¶
Agent 上的證據檔只有這一份，原廠手上沒有備份。移除時若選擇一併刪除資料，這些檔案就永久消失、無法索回。
要保留的話，兩條路擇一，做完再移除：
② 平台端要不要一起處理¶
移除 Agent 之後，平台上那一列會變成永久離線——它不會自己消失，需要您到平台上收尾。請一併：
- 到「儲存設定」頁把儲存方式改成其他選項（否則之後新產生的證據檔沒有地方存）。
- 到「檔案 Agent 管理」頁把該列刪除或撤銷。
8.2 執行時會問您兩個問題¶
程式不會默默把東西刪掉，它會分兩次問您，而且兩次都要求完整打字才算數——這是刻意設計的防呆，避免手滑按 Enter 就把資料刪光。
第一問：確定要移除服務嗎
必須一字不差地輸入 yes-remove-agent。打錯字、輸入 y、或直接按 Enter，一律當成取消，不會刪任何東西。
第二問：資料要不要一起刪
問您之前，它會先把三個資料區各自佔了多少空間列出來，方便您判斷。
| 您輸入什麼 | 會發生什麼 |
|---|---|
yes-delete-all-data |
🔴 證據檔、憑證、索引全部永久刪除 |
| 其他任何輸入（含直接 Enter） | 資料完整保留 |
保留資料有什麼好處：日後在同一台機器重新安裝時，會直接沿用既有的身分憑證與證據檔——不需要重新註冊（也就是不用再去平台要一組新的註冊憑證），平台上還是原本那一台。
沒有特別理由的話，建議選擇保留。資料佔的空間隨時可以之後再清（見 8.5）。
8.3 會移除什麼、會保留什麼¶
| 項目 | |
|---|---|
| 一定移除 | 兩個服務容器與它們的網路、安裝目錄 /srv/guidant-ai-agent/（設定、服務定義檔、您投放的檢測內容）、安裝紀錄 /etc/guidant-ai-agent/、/usr/local/bin 下的維運指令 |
| 問過您才移除 | 資料區（證據檔、憑證、索引） |
| 一定保留 | Docker 映像檔、過程紀錄 /var/log/guidant-ai-agent/ |
映像檔（安裝母片）刻意留著不刪——這樣重新安裝時可以直接沿用，不必再花時間重新載入映像。
過程紀錄留著的理由不太一樣：萬一移除本身出了問題，那份紀錄就是唯一的線索。不需要時您可以自己刪。
0.2.32 以前安裝目錄是保留的（因為那時候它同時也是您解開出貨包的地方，裡面還有出貨包本體）。1.0.0 起安裝目錄是系統自己建的專屬位置，移除時一併清掉才乾淨。
8.4 移除之後要重裝¶
這步在做什麼：把出貨包解開，在裡面重跑一次安裝。
接下來會怎樣，取決於您上一次的選擇：
- 上一次選擇保留資料 → 直接接回原本的身分與證據檔，不會重新註冊，平台上還是同一台。
- 上一次選擇刪除資料 → 等同全新安裝，需要向平台要一組新的註冊憑證（見 4.1）。
8.5 想手動清得更乾淨¶
移除之後若確定連映像檔與保留下來的資料區都不要了，可以手動清掉。
這幾行在做什麼：先列出有哪些資料區與映像檔，確認名稱之後逐一刪除。（安裝目錄已經在移除時清掉了，這裡不必再處理。）
sudo docker volume ls # 先看有哪些（名稱形如 guidant-ai-agent_agent-db）
sudo docker volume rm <名稱> # 🔴 刪了就沒了
sudo docker image ls | grep guidant # 找出映像
sudo docker image rm <映像>
sudo rm -rf /var/log/guidant-ai-agent # 連過程紀錄也不要的話
🔴 這些是 Docker 的原始指令，沒有任何確認提示，也沒有「還原」。
不像 8.2 那樣會問您、要您打字確認——按下 Enter 就直接執行完畢。執行前請再確認一次：這些資料確實不再需要了。