解除安裝 DeepSeek Harness 外掛
五步截圖實測：移除單一外掛、解除安裝 dsh 本體、徹底清理 ~/.dsh 資料目錄，不留任何殘留。
最近更新: 2026-10-25
DeepSeek Harness 萬物皆外掛，解除安裝也遵循同一套邏輯：profile 裡記錄著相依套件條目，CLI 負責刪除，重新啟動之後正在執行的工作階段才真正放手。按順序做完這三步，就不會留下殘留。
下面的圖文涵蓋三個層級——解除安裝單一外掛、解除安裝 dsh 本體、刪除 ~/.dsh 資料目錄——截圖全部來自公開錄影，並在頁面底部署名出處。
五步解除安裝 DeepSeek Harness 外掛
- 2
一條指令把外掛移出 profile
解除安裝單一外掛只需一條指令：dsh plugin --profile web remove <套件名>，它會把相依套件條目從 web profile 裡刪掉。終端機會印出帶減號的 diff，一秒內確認完成。如果外掛裝在別的 profile，就對同一個 profile 執行 remove。
$dsh plugin --profile web remove <package>
一條指令把外掛移出 profile——帶減號的那行就是被刪掉的相依套件。看影片第 7:32 - 3
重新啟動，然後驗證它真的沒了
正在執行的工作階段沿用的是啟動時的外掛組合，所以刪完先結束 harness 再啟動，再確認結果。重新執行 list 指令——條目已經消失——再到網頁端搜尋同一個關鍵字：之前命中你外掛的查詢，現在只剩內建外掛。
$dsh plugin --profile web list
同樣的關鍵字、同樣的清單：現在只剩內建的 shell-env。如果還看得到，先重新啟動再查。看影片第 7:46 - 5
刪除資料目錄，乾淨重啟
harness 把 profile、工作階段、設定和金鑰都放在 ~/.dsh（Windows 是 %USERPROFILE%\.dsh）——刪掉它就是完全重置。手動新增的外掛只是專案裡的普通資料夾，順手一起刪。之後重新執行 dsh web，你會看到一個帶著空白工作區的全新控制台。
$rm -rf ~/.dsh$Remove-Item -Recurse -Force "$env:USERPROFILE\.dsh"$dsh web
手動新增的外掛只是普通資料夾——remove 指令不會碰這些檔案。看影片第 4:00
Windows 警告：移除 link: 外掛可能刪除原始碼檔案
討論區 #9835（Critical，截至 2026-10-17 官方尚未修復）記錄了一起真實事故：在 Windows 上解除安裝以本機目錄（pnpm link:）方式安裝的外掛時，profile 裡的 node_modules/<pkg> 其實是一個 junction，刪除邏輯把它當一般目錄一路遞迴進去——刪掉的卻是開發者的原始碼儲存庫本體。事故儲存庫遺失了 .deepseek-harness/（agent 長期記憶）與 .git 的頭部檔案，直接報 fatal: not a git repository。
在 Windows 上移除外掛前，先檢查 profile 的 package.json 或 pnpm-lock.yaml 是否記錄了 link:<路徑>。將原始碼資料夾完整複製到其他位置，包含隱藏資料夾和未提交的檔案，並確認備份可用。只推送 Git 無法備份未提交的內容。執行 Remove 或 dsh plugin --profile <name> remove 前，請先閱讀本警示。
觸發面有兩處：Desktop 外掛頁的 Remove 與 CLI 指令。macOS/Linux 上 pnpm 用符號連結、刪除邏輯能正確識別，推測不受影響（回報者也在等官方確認）。截至 0.2.1-alpha.5 尚無修復版本。
停用、移除、解除安裝：三個動詞各管一段
三個動詞對應三種投入程度：停用只關開關，磁碟上一切照舊；移除把單一外掛從 profile 摘除；解除安裝是連本體帶資料的全部清空。選能解決問題的最小動詞。
停用（Disable）——暫停，不是刪除
Settings → Plugins 裡的 Enabled 開關只負責關閉外掛：相依條目、外掛檔案和你的設定全部原地保留，重新啟用即恢復原樣。排障、騰出快捷鍵、對比外掛效果，都先用停用。
一個版本注記：0.2.1-alpha.5 之前，已開啟工作階段的 / 選單在停用後不會重新整理技能清單，重啟工作階段才對齊；alpha.5 已修復該重新整理問題，選單與面板所見即所得。
移除（Remove）——把單一外掛摘出 profile
dsh plugin --profile web remove <package> 會從指定 profile 移除套件相依項目，重新啟動該 profile 後外掛停止載入。之後可用 add 重新安裝，但重新安裝無法保證還原外掛資料。Windows 的本機 link: 安裝請先閱讀備份警示。
解除安裝（Uninstall）——本體與資料一起清
下方第 4-5 步是完整退場：npm uninstall -g @deepseek-ai/dsh 解除安裝程式本體，再刪除 ~/.dsh 一次清空所有 profile、工作階段與金鑰。對資料而言，刪掉這個目錄才是「解除安裝乾淨」的唯一定義。
一條生命週期，四個頁面：本頁管哪段？
外掛管理的動詞很容易混，先劃清邊界。本頁只管「解除安裝/停用」——把單一外掛拿走；下面三頁各管生命週期的其餘段落，連結直達對應指令參考。
DeepSeek Harness 外掛解除安裝常見問題
執行 remove 指令之前，使用者最關心的問題。
如何解除安裝 DeepSeek Harness 外掛？會留下殘留嗎？
按本頁流程操作不會。解除安裝外掛用 remove 指令會刪除 profile 裡的相依套件條目和能力層，重新啟動後生效；唯一不受它影響的是你手動放進專案的外掛資料夾和 ~/.dsh 資料目錄——前者手動刪除，後者只在你打算徹底重置時才動。
解除安裝外掛會刪掉我的工作階段和設定嗎？
不會。解除安裝外掛只改寫 profile——~/.dsh 下的工作階段、工作區檔案和設定原封不動。反過來也一樣：解除安裝外掛不會復原它已經改動過的檔案或外部狀態，這部分要單獨檢查。
為什麼 remove 之後外掛還在執行？
因為工作階段在啟動時就載入了外掛組合。harness 只在工作階段啟動時讀取 profile，所以順序永遠是：刪除、重新啟動、驗證。如果重新啟動後清單裡還有它，表示 remove 是對另一個 profile 執行的。
怎麼徹底解除安裝 DeepSeek Harness？
三步：停掉伺服器；如果是全域安裝的，執行 npm uninstall -g @deepseek-ai/dsh；再刪除 ~/.dsh 資料目錄（Windows 是 %USERPROFILE%\.dsh）。程式和它存過的 profile、工作階段、金鑰就都清乾淨了。
DeepSeek Harness 的資料存在哪裡？
在家目錄的 ~/.dsh 下。每個 profile 有獨立的子目錄——list 指令會印成 dsh-profile-web ~/.dsh/profiles/web (PRIVATE) 這樣的路徑。工作階段、設定、金鑰都在裡面，所以刪掉這個目錄才是徹底解除安裝。
解除安裝之後還能裝回來嗎？
可以，解除安裝完全可逆。dsh plugin --profile web add <套件名> 即可還原，GitHub 上的社群外掛也是同樣裝法（dsh plugin --profile web add "github:user/repo"）。安裝教學裡有這兩條指令的完整截圖示範。
link:（本機目錄）安裝的外掛在 Windows 上怎麼安全解除安裝？
先檢查 profile 的 package.json 或 pnpm-lock.yaml 是否包含 link:<路徑>。討論 #9835 記錄了移除操作沿 Windows junction 進入原始碼儲存庫並刪除檔案的事故。嘗試移除前，應完整複製原始碼資料夾，包含隱藏資料夾和未提交的檔案，並核對備份；只推送 Git 無法備份未提交內容。報告推測 macOS/Linux 可能不受影響，但截至核驗日期尚未獲得確認。
停用了外掛，/ 選單裡還在顯示它的技能，是移除失敗了嗎？
這是一個已知 bug，不是移除失敗：外掛頁停用後，已開啟工作階段的 / 選單不會重新整理技能清單，顯示的還是舊條目。0.2.1-alpha.5 修復了它——啟用或停用後選單即時更新。舊版本上重啟工作階段即可對齊。如果重啟後外掛仍在，多半是 remove 跑在另一個 profile 上，回看上面的移除三步。
解除安裝把外掛的原始碼儲存庫刪壞了，還能救回來嗎？
先保留受損資料夾，再尋找備份。從遠端重新 clone 只能還原已推送的提交；本機提交和未提交的檔案需要獨立備份或檔案系統復原，也可能無法找回。請勿直接在唯一一份受損資料夾上執行修復指令；如需檢查 Git 資料，先複製一份再操作。
停用、移除、解除安裝，到底該用哪個？
暫時不用外掛時選停用，保留安裝；需要從某個 profile 移除套件相依項目時選移除，之後可以重新安裝，但不保證還原外掛資料。不再使用 harness 時可解除安裝 dsh 程式。刪除 ~/.dsh 是另一項無法復原的資料清理，操作前需要備份。
相關教學
外掛生命週期的其餘環節，從首次安裝到日常更新。
DeepSeek Harness 外掛安裝教學
找外掛、從 npm 或 GitHub 新增、驗證載入，一篇講清楚。
閱讀教學Windows 安裝 DeepSeek Harness 指南
從 Node.js 到控制台，Windows 全新機器的 PowerShell 實戰。
閱讀教學Mac 安裝 DeepSeek Harness 指南
以終端機為主的 macOS 實戰，API Key 彈出視窗怎麼選都講到了。
閱讀教學Linux 安裝 DeepSeek Harness 指南
Ubuntu 等發行版：無頭執行或帶網頁介面都可以。
閱讀教學DeepSeek Harness 外掛更新教學
涵蓋安裝、鎖定版本、回復一次失敗的更新。
閱讀教學升級 dsh 本體
該升級的是 harness 而不是外掛時看這裡：升級路徑、0.2.0 預發布線與版本間的破壞性變更。
閱讀教學dsh 指令速查表
dsh 指令一頁通：外掛 add/remove/list、profile、設定匯出與重啟姿勢，全部可複製。
閱讀教學來源與署名
截圖來自以下公開錄影；外掛生命週期的事實與官方文件交叉核對過。每張圖都可深鏈回源影片的對應時間點。