更新与卸载，保持你的 Hermes 最新

更新與卸載，保持你的 Hermes 最新

嘿，朋友們！歡迎回到我們的 Hermes 系列教學。今天這篇是第四篇，咱們來聊聊怎麼讓 Hermes 保持最新狀態，以及如果哪天想「分手」了，怎麼乾淨俐落地卸載它。別擔心，這比你想像中簡單多了。

一鍵更新，就是這麼簡單

老規矩，先上指令：

hermes update

就這一條指令，Hermes 會自動幫你完成所有髒活累活。它會從 main 分支拉取最新程式碼、更新依賴，還會自動偵測新增的設定選項並提示你進行設定。是不是很貼心？

小提示：如果你當時跳過了設定提示，別慌！手動執行 hermes config check 就能看到缺失的設定項，再用 hermes config migrate 就能互動式地補上啦。

更新時到底發生了什麼？

你可能好奇，一條 hermes update 背後到底幹了啥？我給你拆解一下：

1. 更新前快照 — 預設會儲存一份輕量級狀態快照（包括配對資料、定時任務、config.yaml、.env 等）。每個設定檔都會單獨存一份，這樣就算更新出問題也能還原。
2. 拉取程式碼 — 從 main 分支拉取最新程式碼並更新子模組。
3. 語法檢查 + 自動回滾 — 拉取後會自動編譯 9 個關鍵檔案。如果發現解析失敗（例如合併衝突殘留），會自動 git reset --hard 回滾，保證你的終端機永遠能正常啟動。
4. 安裝依賴 — 執行 uv pip install -e ".[all]" 安裝新增或變更的依賴。
5. 設定遷移 — 偵測新設定項並提示你設定。
6. 閘道自動重啟 — 更新完成後自動重啟閘道，讓新程式碼立即生效。

進階玩法：更新到其他分支

預設情況下，hermes update 追蹤的是 origin/main。但如果你想體驗測試版或候選版本，可以用 --branch 參數：

hermes update --branch release-candidate

這樣就能從指定分支更新啦，非常適合喜歡嚐鮮的朋友。

關於分支切換的那些事兒

如果你之前手動切換到了其他分支，hermes update 會自動處理：

• 分支已完全合併：自動切回 main，並提示你「已合併，已切回主分支」。
• 分支有未合併的提交：仍會切到 main 完成更新，但會大聲提醒你，並告訴你怎麼找回自己的提交。
• 工作區有未提交的變更：不會動你的程式碼，更新會標記為 SKIPPED，並給出明確的解決指令。

如果你有自己維護的補丁分支，可以在 config.yaml 裡設定 updates.parked_branch_strategy: update_in_place，這樣更新會直接合併到你的分支裡，而不是切走。

卸載 Hermes

雖然我們捨不得，但萬一你需要卸載 Hermes，過程同樣簡單。直接刪除安裝目錄和設定目錄即可（具體路徑取決於你的安裝方式）。如果你用的是套件管理器安裝的，也可以用對應的卸載指令。

---

好啦，關於更新和卸載就講到這裡。記住，保持 Hermes 最新不僅能獲得新功能，還能修復潛在的安全問題。下期見！👋

---