DeepSeek Harness 升級指南：npm 更新 dsh 本體、驗證與還原
真實 Windows 螢幕錄影逐格拆解：查目前執行的版本、查 registry 最新版、一條指令升級、讀懂完成訊息、重啟驗證——再加一條裝回指定版本的還原指令。
最近更新: 2026-10-02
dsh 迭代很快：release candidate 幾乎每週一支，0.2.0 還停在帶破壞性變更的預發布線上。本頁把本體升級拆成一個安靜的循環——查在跑什麼、查最新是什麼、升級、讀完成訊息、驗證、重啟——全部畫面來自 coder_Mars 的 Windows 真實錄影。片中的版本號與套件數（0.1.5-rc.1 升到 0.1.5-rc.2、changed 520 packages）是那支錄影的範例，不是指標。
動手前先分清兩層：本頁升級的是 dsh 本體，也就是 npm 全域套件；替 profile 裝好的外掛做更新是另一層、另一套指令，兩份教學互相連結。那套流程在 外掛更新指南
TL;DR
- ▸兩層各管各的：dsh 本體用 npm update -g @deepseek-ai/dsh 升級；外掛走 Web UI 外掛市場或 dsh plugin update，別混用。
- ▸完整循環：先 dsh --version 和 npm view @deepseek-ai/dsh version，再升級，接著 dsh --version 複查、dsh web 啟動驗證。
- ▸警告不等於失敗：錄影裡 deprecated、EPERM 清理警告塞滿畫面，最後照樣打出 changed 520 packages。升級成敗看完成訊息那一行。
- ▸還原只要一條指令：npm install -g @deepseek-ai/dsh@<版本號>；搗亂的外掛用 dsh plugin --profile web remove 請出去。
從查版本到一次有證據的還原
第一部分 · 升級前
- 1
查本機版本，查最新版本
兩條唯讀指令開場。dsh --version 印出機器實際在跑的版本——錄影中是 0.1.5-rc.1；npm view @deepseek-ai/dsh version 向 npm registry 詢問最新發布版，錄製當下是 0.1.5-rc.2。兩個數字不同，代表有更新等著；相同，代表已是最新，可以收工。
$dsh --version$npm view @deepseek-ai/dsh version
本機 0.1.5-rc.1，registry 0.1.5-rc.2：一眼兩版在 1:50 觀看 - 2
記下基準：會話、外掛與排程任務
升級替換的是程式，不是資料——設定、會話、已裝外掛都在你的使用者目錄裡（完成訊息的畫面格能看到 DSH_HOME 解析到 C:\Users\Admin\.dsh）。保險起見還是記錄現況：dsh plugin --profile web list 列出已裝外掛，Web UI 裡能看到會話。如果打算跨進 0.2.0 預發布線，把排程任務也抄一份——0.2.0 遷移簡報明說 0.1.x 的自動化任務不會自動遷移。跨大版本前備份一次設定，是最便宜的保險。
$dsh plugin --profile web list
升級前基準：會話與外掛都在正常工作在 0:40 觀看
第二部分 · 升級、警告與驗證
- 3
一條指令升級本體
整個升級就是 npm update -g @deepseek-ai/dsh，和本頁其他操作用同一個終端機。錄影中作者跑了兩次——一次在 PowerShell，一次在全新 CMD 視窗（此前已經升過一輪）。重複執行沒有副作用：npm 會比對版本，有差異才動手。
$npm update -g @deepseek-ai/dsh
整個升級就一條 npm 指令在 2:50 觀看 - 4
看懂警告牆，別慌
升級途中終端機刷黃：一條 npm warn deprecated（傳遞依賴被棄用），接著一串 npm warn cleanup EPERM——Windows 拒絕刪除暫存目錄裡舊的 sharp-win32-x64 DLL。這些都沒攔住安裝，這一輪最後照樣打出 changed 520 packages（耗時 17s）。結論：判斷升級成敗看最後一行完成訊息，別看上方捲動的警告。
警告塞滿畫面，安裝照常完成在 2:00 觀看 - 5
核對完成訊息，重啟 dsh web
完成訊息的畫面格一幕講完整個契約：changed 520 packages in 1m；隨後 dsh --version 仍是 0.1.5-rc.2——與升級前相同，在這裡的含義是「已是最新」，沒有更新的版本可裝。作者最後用 dsh web 啟動收尾：DSH_HOME 解析成功、key pools 載入、rotation proxy 監聽 127.0.0.1:8787。你的連接埠與外掛名會不同，但「版本證據 + 啟動日誌」這個形狀應當一致。
$dsh --version$dsh webchanged 520 packages in 1m，版本未變 = 已最新在 3:16 觀看
第三部分 · 升級後：市場巡檢、疑難排解與還原
- 6
升級後巡檢：外掛市場是另一層
本體升完，Web UI 的外掛市場顯示市場自身 v1.40.0、已安裝 10 個、全部更新 (5) 按鈕——外掛有自己的版本線與更新佇列，剛才的本體升級沒碰它們。隨時在這個介面或用終端機更新外掛；那套流程歸外掛更新指南管。
市場 v1.40.0：已裝 10 個，5 個更新在排隊在 3:24 觀看 - 7
出問題第一步：先確認版本
疑難排解錄影的開場和升級錄影一模一樣：一個新提示字元，dsh --version。動外掛、動設定之前，先弄清實際在跑的是哪個版本——影片的場景是一台升到 0.2.0-rc.1 後出問題的機器，它的第一步仍然是這條唯讀指令。終端機裡的版本號才是事實，記憶與二手教學都不是。
$dsh --version
疑難排解第一律：先讀版本號在 2:05 觀看 - 8
還原：裝回指定版本，請走問題外掛
兩條出路，各一行指令。要把某個版本裝回去，就按精確版本號安裝：npm install -g @deepseek-ai/dsh@<版本號>——影片講義寫作「重新下載指定版本」（歷史 tag 在專案的 GitHub Releases 頁可查）。如果肇事的是外掛而非本體，dsh plugin --profile web remove 會把它從 web profile 移除；同一支影片還提到：也可以在 Web UI 外掛清單直接點解除安裝，外掛糟到讓 DSH 起不來時，可以手動清理設定檔與依賴。把 <版本號> 換成真實 tag，例如你升級前所在的 0.1.5-rc.2。
$npm install -g @deepseek-ai/dsh@<version>$dsh plugin --profile web remove
裝回舊版本，或把壞外掛請出去在 3:35 觀看
0.2.0 線：開發者預覽，不是歸宿
截至 2026-10-02，deepseek-ai/deepseek-harness 的最新 release 是 dsh-v0.2.0-rc.2，2026-09-29 發布，帶 prerelease 標記。0.2.0 線目前整條都是含破壞性變更的 developer preview；本頁錄影所在的 0.1.x 線才是求穩的選擇。
文件裡最咬人的破壞性變更：自動化任務改成了可選外掛套件，0.1.x 裡設定好的排程任務升級後不會自動遷移。遷移簡報給的三步：升級前抄下現有排程任務設定；升級後到外掛管理裡安裝自動化任務外掛套件；逐一重建任務並在第一次執行時驗證。
討論區裡翻得到真實的升級事故：啟動當機、舊版本裝不回去。這不是永遠不升級的理由，而是把本頁兩個習慣養成的理由——跨版本前備份設定，口袋裡放著那條指定版本安裝指令。版本真的翻車時，疑難排解手冊與常見錯誤頁已經把典型故障寫好了。
FAQ
在讓 npm 碰一個能用的安裝之前，讀者想問的事。
升級會丟設定、會話或外掛嗎？
npm 套件與你的資料不在同一個地方：更新替換的是全域程式，設定、會話、已裝外掛都在使用者目錄——錄影啟動日誌裡 DSH_HOME 解析到 C:\Users\Admin\.dsh，升級後外掛市場仍顯示已安裝 10 個。例外是跨進 0.2.0：自動化任務變成外掛套件，0.1.x 的排程任務不會自己遷移。跨大版本前先備份設定。
怎麼還原到舊版本？
按精確版本重新安裝：npm install -g @deepseek-ai/dsh@<版本號>，把 <版本號> 換成真實 tag（例如 0.1.5-rc.2）。歷史版本與 tag 都在 GitHub Releases 頁。如果是外掛闖的禍，先用 dsh plugin --profile web remove 解除安裝——帶著壞外掛升本體，多半把同樣的毛病再升一遍。
0.2.0 穩定了嗎？現在該升嗎？
還沒有。截至 2026-10-02，最新 release 是 dsh-v0.2.0-rc.2，prerelease 標記，2026-09-29 發布——0.2.0 整條線都是含破壞性變更的 developer preview，例如自動化任務移進外掛套件且不自動遷移。靠它工作的機器留在 0.1.x 線；想嘗鮮就先備份，按三步遷移走，重建的任務逐一在第一次執行時驗證。
升級後外掛不見了或報錯怎麼辦？
先分層：本體升級不會刪外掛——錄影結尾市場裡還顯示已安裝 10 個。若是外掛在新本體上報錯，只解除安裝出問題的那個（dsh plugin --profile web remove），重啟後再裝回新版。想把外掛整體更新到最新，走外掛更新那套流程；DSH 完全起不來時，疑難排解手冊裡有含外掛導致啟動失敗的完整排查。
終端機被 npm 警告洗版，升級失敗了嗎？
大概率沒有。錄影裡 deprecated、EPERM 清理警告一路捲進 changed 520 packages 完成訊息。npm 警告是旁白，完成訊息那一行與隨後的 dsh --version 才是判決。版本真沒動，就把 npm update -g @deepseek-ai/dsh 再跑一次——影片裡的作者正是這麼做的。
相關攻略
圍繞本體升級的每一層。
來源與署名
全部截圖均為 coder_Mars B站錄影的畫面格，每張深鏈到各自秒數。0.2.0 事實來自官方 GitHub Releases（2026-10-02 查詢）與下列兩支純簡報影片——簡報只作事實源，不取格。