如何更新 DeepSeek Harness 與外掛（dsh）
查當前版本、升級 dsh 本體、在終端機或 Web UI 外掛市場更新外掛，出問題時固定版本或退回舊版。
最近更新: 2026-10-09
DeepSeek Harness 還處於開發者預覽階段，迭代非常快：@deepseek-ai/dsh 上線第一個月就發了 15 個 npm 版本，官方 README 也用大寫字明確警告「會出現破壞相容性的改動」。定期更新是整套環境能持續正常運轉的前提，而會回滾，是在某個版本翻車時保住自己的辦法。
下文每條命令都對照了 deepseek-ai/deepseek-harness 官方倉庫、npm 上的 @deepseek-ai/dsh 包核實，寫法與站內《外掛安裝指南》保持一致。截圖來自兩支真實錄屏——一支英文、一支中文，你既能看到命令在真實終端裡的執行過程，也能看到 Web UI 的實際介面。
六步更新 DSH 與外掛
- 1
先查清自己在跑什麼版本
用事實說話，別憑記憶。在任意終端裡執行 dsh --version（簡寫 dsh -V），會列印當前 PATH 上 @deepseek-ai/dsh 包的版本號。外掛這邊，開啟 Web UI 的 Settings → Plugins 面板，列表裡每個隨 Web 配置檔案載入的元件都帶 Enabled 或 Disabled 狀態。把現狀記下來——更新之後你要靠它對比。
$dsh --version$dsh plugin --profile web list
所有 dsh 命令——包括查版本——都從同一條命令列出發。在影片 13:31 處觀看 
Plugins 面板是檢視 Web profile 實際載入了什麼的最快方式。在影片 4:30 處觀看 - 2
升級 dsh 本體
更新方式取決於當初怎麼裝的。全域 npm 安裝：帶上 latest 標籤重跑安裝命令，npm 會替換舊版本。用 npx 啟動：加上 @latest，讓 npx 拉取最新包而不是複用快取。git clone 裝的：拉取儲存庫後按首次安裝的方式重新建置。命令在版本之間有過變動，遇到報錯時以官方 get-started 頁面為準。
$npm install -g @deepseek-ai/dsh@latest$npx @deepseek-ai/dsh@latest web
兩條官方安裝路徑——日後拉取新版本走的也是它們。在影片 1:15 處觀看 
原始碼方式安裝的，升級也是同一套：拉取、重新構建、重啟。在影片 1:25 處觀看 - 3
更新外掛：覆蓋安裝即可
外掛沒有單獨的「升級體系」——更新就是再裝一遍。dsh plugin 會把引數原樣轉發給配置目錄裡的 pnpm，所以重跑 add 就會拉取最新的匹配版本並把配置指過去。update 同樣可用：它會在配置允許的版本範圍內重新整理包。下面中文錄屏演示了把 dshmarket 外掛裝進 web profile——同一條命令以後再跑一次，拉到的就是新版本。前提只有一個：pnpm 必須在 PATH 上，因為 dsh plugin 要呼叫它。
$dsh plugin --profile web add dshmarket$dsh plugin --profile web update
更新命令就是安裝命令——形狀不變，包更新（中文介面）。在影片 2:45 處觀看 
重跑 add 命令就會拉取最新版本——動作和首次安裝一模一樣（中文介面）。在影片 5:30 處觀看 
pnpm 會如實報告改了什麼——或者確認你本來就是最新（中文介面）。在影片 5:35 處觀看 - 4
或者在 Web UI 外掛市場裡更新
不想敲命令的話，Settings 裡有「外掛市場」入口。發現頁列出可裝的外掛，已安裝頁顯示 profile 裡已有的，卡片上的安裝按鈕點下去就是重新安裝——市場路徑和命令路徑最終改的是同一個 profile。中文截圖裡還能看到：市場連自己有新版本都會用橫幅提示升級。
Web UI 在設定裡自帶外掛市場（中文介面）。在影片 5:40 處觀看 
市場會提示自身的新版本；已安裝頁列出你現有的外掛（中文介面）。在影片 5:45 處觀看 - 5
重啟，然後驗證
外掛樹是啟動時裝配的，不重啟就不生效。停掉舊程序，執行 dsh web，等本地地址打印出來。然後檢查：Plugins 面板應顯示更新後的外掛集合，沒有卡在半註冊狀態的項；再丟一個無關緊要的小任務進去，確認整條鏈路真的能跑。中文錄屏裡的口訣值得養成習慣——裝前看最新 README，裝完重啟，再開始信任它。
$dsh web
重啟成功後，你會回到熟悉的本地地址。在影片 1:40 處觀看 
看 README、安裝、重啟——完整更新迴圈三張卡講完（中文介面）。在影片 16:30 處觀看 - 6
新版本出問題時：固定、隔離、回滾
破壞性變更是官方明示的常態，所以要提前想好退路。在包名後面加 @版本號 可以釘住精確版本——站內安裝指南里 dsh plugin add dsh-mnemon@^1.2.0 就是這種寫法。有風險的升級放進一次性 profile 裡測：CLI 首次使用時會自動初始化新 profile，--from-default-profile web 還能用官方 web 模板做種子。回滾就是把舊版本號重灌一遍，或者先 remove 掉等修復。帶 dsh-plugin 主題標籤的社群倉庫都顯示最近更新時間，一眼就能看出誰還在維護。
$dsh plugin --profile web add <package>@<version>$dsh --profile test --from-default-profile web$dsh plugin --profile test add <package>$dsh plugin --profile web remove <package>
倉庫卡片能看到外掛最近一次動靜——新版本在等的第一個訊號。在影片 7:02 處觀看
升級 dsh 本體：0.1.7-rc.2 已是 latest
2026-09-28，npm dist-tags 完成翻轉：latest 指向 0.1.7-rc.2，同日 0.2.0 首個候選登上 next 標籤。如果你還停在 0.1.5-rc.3，穩定線已經前進——以下是核實過的跟進方法。
先看清自己在哪：一個版本號，三條通道
dsh --version 看自己的版本，npm view @deepseek-ai/dsh dist-tags 看地圖：latest = 0.1.7-rc.2（從 0.1.5-rc.3 翻轉），next = 0.2.0-rc.1（0.2.0 線首個候選，2026-09-28 發布），alpha = 0.1.7-alpha.2。下面的升級與回滾做法，都建立在你分得清楚自己在哪條通道上。
一條命令升級——或預覽 0.2.0
npm install -g @deepseek-ai/dsh@latest 升到 0.1.7-rc.2；npm install -g @deepseek-ai/dsh@0.2.0-rc.1 把 0.2.0 預覽寫死到精確版本號（候選版永遠不該交給 @latest 去抓）。按 0.2.0-rc.1 發布說明：自動化任務改由可選外掛包提供，外掛管理介面與安裝引導重做，DeepSeek 帳號模型的會話免另配 API Key 即可網頁搜尋，Windows 內建沙箱新增權限診斷技能（帶備份、可還原的權限修復）。裝完必須重啟——外掛樹在啟動時組裝。
升級翻車就鎖回去
09-28 這波升級把官方討論區刷成了五種經典故障：工作區被清（#8140）、外掛成批死亡（#8145）、rc.2 上對話中斷（#8118）、git pull 後專案起不來（#8152）、Windows 沙箱 0xC0000142（#8141–#8143）。回滾就是寫死精確版本——npm install -g @deepseek-ai/dsh@0.1.7-rc.2（或你上次可用的 0.1.5-rc.3），絕不用 @latest。先備份 cordis.patch.yml，再去排錯指南按「症狀 → 原因 → 修復」逐條對症。
批次更新與不相容外掛處理
一次 harness 升級可能同時擱淺一批外掛：0.2.0-rc.1 落地當天，討論帖 #8199 數出 22 個第三方外掛裡 11 個被標為異常——它們的相依宣告還停留在 0.1.x 區間。rc.2 把落地變軟了：外掛安裝流程開始區分「已安裝、不相容、內建」三類並分別給出升級提示，但恢復動作仍然要你自己跑。
按 profile 批次重裝
沒有「一鍵全更新」的指令，那就把迴圈寫明確：先列出 profile（`dsh plugin --profile web list`），再對著新宿主逐條重裝——`dsh plugin --profile web add <package>` 會抓取相容版本。先在副本上演練：`dsh --profile test --from-default-profile web` 給你一個和線上一模一樣的排練 profile。
不能動的先鎖住
對依賴的外掛，從精確 tag 重裝而不是跟著移動分支：`dsh plugin add github:owner/repo#v1.2.3`。鎖住版本，外掛在新宿主面前就保持可載入，等作者追上來你再主動升級，而不是被自動更新碾過去。
其餘的先停用，等相容版
相依宣告還停在 0.1.x 的外掛在 0.2.0 下不會載入——除了等作者發新版，沒有指令能修。把它的條目設為 `enabled: false`，harness 留在你選定的通道上，相容版本發布後再啟用。
桌面版更新：官方檢查與社群更新器
上面的 CLI 流程永遠可用，但桌面應用有自己的更新器——而打包版目前根本無法成功。下面說清楚壞在哪，以及社群怎麼補位。
官方「檢查更新」按構造必敗（#9197）
討論 #9197 記錄了這個缺陷：打包版從未產出更新器依賴的 app-update.yml 檔案，所以內建的檢查更新點多少次都不會成功。桌面端檢查更新失敗不是你的網路問題——缺的就是那個檔案。
dsh-updater：社群桌面更新器（#9221）
討論 #9221 介紹了 dsh-updater——在官方檢查失效處補位的社群工具：標題列三個按鈕——偵測、回滾、版本——涵蓋版本偵測、回滾到可用建置與版本檢視。和其他社群工具一樣，它也是第三方程式碼：跑之前先讀。
官方修復落地前：走 CLI 更新
本指南的 CLI 流程不依賴桌面更新器：dsh --version 看目前版本，npm install -g @deepseek-ai/dsh@<確切版本號> 升級（發行候選版絕不裸上 @latest），重新啟動，驗證。同一組指令也是回滾路徑。
乾淨重裝之後外掛還是不肯載入？或者一次升級搞掛了半套外掛？回滾與鎖版本的完整打法在疑難排解指南裡。
打開疑難排解 §8更新 DSH 常見問題
第一次被升級坑到之前，值得先想清楚的問題。
DeepSeek Harness 外掛會自動更新嗎？
不會。已安裝的外掛是記錄在 profile 裡的一條依賴，在你動手之前 dsh 會原樣保留它。重跑 dsh plugin add 會拉取最新版本，dsh plugin update 會在允許的版本範圍內重新整理，Web UI 外掛市場則等你自己點安裝。沒有東西會在背後偷偷升級——同理，也沒有東西會自己修好自己。
更新會弄丟我的設定或工作階段嗎？
更新替換的是包依賴，不是你的設定。profile 的自定義內容存放在自己的 cordis.patch.yml 使用者層（站內《外掛安裝指南》講的正是這套機制），會話也與外掛分開儲存，重啟後 Harness 會按你的配置重新裝配外掛樹。真正的風險在語義層面：破壞性版本可能改變某個配置項的含義。所以升級前讀一遍 changelog 或 README，並保留第一步的記錄，才能分清「更新搞壞了」和「配置本來就不對」。
怎麼把外掛退回舊版本？
把舊版本號蓋裝上去：dsh plugin --profile web add <包名>@<版本號>。這會把 profile 重新指到那個精確版本——站內安裝指南里 dsh plugin add dsh-mnemon@^1.2.0 就是同樣的寫法（範圍語法）。裝完用 dsh plugin --profile web why <包名> 確認實際安裝的版本，這是 dsh 幫助文本里明確列出的轉發命令之一。
能在不動主力環境的前提下測試新版本嗎？
可以——profile 就是為這個準備的。dsh --profile test --from-default-profile web 會用官方 web 模板建立名為 test 的 profile，然後 dsh plugin --profile test add <包名> 把候選版本裝進去（首次使用時自動初始化）。在做出決定之前，主 web profile 一直跑舊版本。注意一個邊界：desktop profile 由 Electron 應用專門管理，會拒絕手動外掛命令。
Harness 升級後某個外掛壞了怎麼辦？
這是開發者預覽階段白紙黑字寫明的代價——README 直說會有破壞相容性的改動。先去外掛倉庫看有沒有更新：社群外掛大多帶 dsh-plugin 主題標籤，倉庫卡片直接顯示最近更新時間。然後三選一：重新 add 讓外掛拿到修復、釘回能用的舊版本，或者用 dsh plugin --profile web remove <包名> 先移除，等兩邊版本對齊再裝回來。
怎麼查最新版本號？
對比兩個數字。已安裝的用 dsh --version 查；最新發布版看 npmjs.com 上的 @deepseek-ai/dsh 頁面，或在任意終端執行 npm view @deepseek-ai/dsh version。GitHub releases 頁面按日期列出每個 tag——也是判斷這個專案節奏快不快、要不要現在升級的最快途徑。
dsh 的更新指令是什麼？
沒有一條「全量更新」指令——更新就是重裝。先用 dsh --version 查目前版本，CLI 用 npm install -g @deepseek-ai/dsh@latest 升級（發行候選版要寫明確 @版本號），外掛則重跑 dsh plugin add 或在 profile 裡用 dsh plugin update——Web UI 外掛市集的 Install 按鈕做的是同一件事。npm view @deepseek-ai/dsh dist-tags 可以看各通道分別停在哪個版本。
相關指南
本篇依賴的頁面，以及接下來該去哪。
dsh 本體升級：更新、驗證與還原
外掛更新指南的本體篇：查版本、一條 npm 指令升級、讀懂 changed packages 完成訊息，出問題時用指定版本號裝回去。
閱讀教學安全地安裝外掛
dsh 裡「安裝外掛」到底發生什麼，附一套第三方程式碼審查清單。
閱讀教學疑難排解與錯誤百科
症狀 → 原因 → 修復：安裝失敗、pnpm workspace allowlist 錯誤、cordis.patch.yml 衝突、bundle 格式錯誤與 Profile 設定無效。
閱讀教學DeepSeek Harness Windows 安裝教學
10 步實機截圖安裝教學:Node.js、npm 全域安裝、3080 埠的 Web UI、API key,Win10/11 免 WSL。
閱讀教學DeepSeek Harness 桌面版：官方 vs 社群
官方 Web UI、DSHDesktop 等社群客戶端，以及一份安全下載清單。
閱讀教學Awesome DeepSeek Harness
「Awesome DeepSeek Harness」清單的線上目錄版 —— 可瀏覽、附 GitHub 星數與維護狀態資料。
閱讀教學來源與致謝
命令於 2026 年 9 月對照官方 deepseek-ai/deepseek-harness 倉庫（README 與 CLI 原始碼）、npm 上的 @deepseek-ai/dsh 包以及 DeepSeek 官方 get-started 頁面核實。截圖擷取自 YouTube 上的兩支社群錄屏——上文部分截圖為中文介面。