DeepSeek Harness plugins directoryDSH Pluginsdsh 外掛市集
返回教學

如何更新 DeepSeek Harness 與外掛（dsh）

查當前版本、升級 dsh 本體、在終端機或 Web UI 外掛市場更新外掛，出問題時固定版本或退回舊版。

最近更新: 2026-09-09

DeepSeek Harness 還處於開發者預覽階段，迭代非常快：@deepseek-ai/dsh 上線第一個月就發了 15 個 npm 版本，官方 README 也用大寫字明確警告「會出現破壞相容性的改動」。定期更新是整套環境能持續正常運轉的前提，而會回滾，是在某個版本翻車時保住自己的辦法。

下文每條命令都對照了 deepseek-ai/deepseek-harness 官方倉庫、npm 上的 @deepseek-ai/dsh 包核實，寫法與站內《外掛安裝指南》保持一致。截圖來自兩支真實錄屏——一支英文、一支中文，你既能看到命令在真實終端裡的執行過程，也能看到 Web UI 的實際介面。

六步更新 DSH 與外掛

  1. 1

    先查清自己在跑什麼版本

    用事實說話，別憑記憶。在任意終端裡執行 dsh --version（簡寫 dsh -V），會列印當前 PATH 上 @deepseek-ai/dsh 包的版本號。外掛這邊，開啟 Web UI 的 Settings → Plugins 面板，列表裡每個隨 Web 配置檔案載入的元件都帶 Enabled 或 Disabled 狀態。把現狀記下來——更新之後你要靠它對比。

    $dsh --version
    $dsh plugin --profile web list
    macOS 終端停在 deepseek-harness 倉庫目錄，zsh 提示符後輸入了 pnpm dsh --profile headless 命令
    所有 dsh 命令——包括查版本——都從同一條命令列出發。在影片 13:31 處觀看
    DeepSeek Harness Web UI 設定的 Plugins 面板，列出內建外掛及綠色 Enabled、灰色 Disabled 狀態
    Plugins 面板是檢視 Web profile 實際載入了什麼的最快方式。在影片 4:30 處觀看
  2. 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
    DeepSeek Harness 官方 get-started 頁面，並排展示 npx @deepseek-ai/dsh web 快速啟動命令和 git clone 原始碼安裝選項
    兩條官方安裝路徑——日後拉取新版本走的也是它們。在影片 1:15 處觀看
    zsh 視窗正在對 deepseek-ai/deepseek-harness 的 GitHub 倉庫執行 git clone
    原始碼方式安裝的，升級也是同一套：拉取、重新構建、重啟。在影片 1:25 處觀看
  3. 3

    更新外掛：覆蓋安裝即可

    外掛沒有單獨的「升級體系」——更新就是再裝一遍。dsh plugin 會把引數原樣轉發給配置目錄裡的 pnpm，所以重跑 add 就會拉取最新的匹配版本並把配置指過去。update 同樣可用：它會在配置允許的版本範圍內重新整理包。下面中文錄屏演示了把 dshmarket 外掛裝進 web profile——同一條命令以後再跑一次，拉到的就是新版本。前提只有一個：pnpm 必須在 PATH 上，因為 dsh plugin 要呼叫它。

    $dsh plugin --profile web add dshmarket
    $dsh plugin --profile web update
    中文 DeepSeek Harness 教程幻燈片，把 dsh plugin --profile add 命令拆解成 profile 名和外掛來源兩部分
    更新命令就是安裝命令——形狀不變，包更新（中文介面）。在影片 2:45 處觀看
    macOS 終端提示符後輸入 dsh plugin --profile web add dshmarket，安裝外掛市場外掛
    重跑 add 命令就會拉取最新版本——動作和首次安裝一模一樣（中文介面）。在影片 5:30 處觀看
    dsh plugin --profile web add dshmarket 的終端輸出，以 Already up to date 和 Done in 3.5s using pnpm 結尾
    pnpm 會如實報告改了什麼——或者確認你本來就是最新（中文介面）。在影片 5:35 處觀看
  4. 4

    或者在 Web UI 外掛市場裡更新

    不想敲命令的話，Settings 裡有「外掛市場」入口。發現頁列出可裝的外掛，已安裝頁顯示 profile 裡已有的，卡片上的安裝按鈕點下去就是重新安裝——市場路徑和命令路徑最終改的是同一個 profile。中文截圖裡還能看到：市場連自己有新版本都會用橫幅提示升級。

    中文版 DeepSeek Harness Web UI 設定側欄，手形游標正點開外掛市場入口
    Web UI 在設定裡自帶外掛市場（中文介面）。在影片 5:40 處觀看
    中文版 DeepSeek Harness 外掛市場，顯示發現、已安裝標籤頁，以及「市場有新版本，升級」橫幅
    市場會提示自身的新版本；已安裝頁列出你現有的外掛（中文介面）。在影片 5:45 處觀看
  5. 5

    重啟，然後驗證

    外掛樹是啟動時裝配的，不重啟就不生效。停掉舊程序，執行 dsh web，等本地地址打印出來。然後檢查：Plugins 面板應顯示更新後的外掛集合，沒有卡在半註冊狀態的項；再丟一個無關緊要的小任務進去，確認整條鏈路真的能跑。中文錄屏裡的口訣值得養成習慣——裝前看最新 README，裝完重啟，再開始信任它。

    $dsh web
    終端執行 pnpm dsh web 啟動 DeepSeek Harness Web UI，並列印本地地址 127.0.0.1:3080
    重啟成功後，你會回到熟悉的本地地址。在影片 1:40 處觀看
    教程幻燈片，提示使用者安裝前檢視最新 README，安裝後重啟 dsh web
    看 README、安裝、重啟——完整更新迴圈三張卡講完（中文介面）。在影片 16:30 處觀看
  6. 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>
    GitHub 上 DeepSeek-Reasonix 和 OpenViking 的倉庫卡片，帶 dsh-plugin 主題標籤和 Updated 1 hour ago 更新時間
    倉庫卡片能看到外掛最近一次動靜——新版本在等的第一個訊號。在影片 7:02 處觀看

更新 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 裡「安裝外掛」到底發生什麼，附一套第三方程式碼審查清單。

閱讀教學

疑難排解與錯誤百科

症狀 → 原因 → 修復：安裝失敗、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 上的兩支社群錄屏——上文部分截圖為中文介面。

DeepSeek Harness: Beginner To Expert in 15 MinutesShab Noor · YouTube觀看來源DeepSeek Harness 插件安装指南 (Plugin Installation Guide)嗯哌AI · YouTube觀看來源

DSH Plugins 是獨立的 DeepSeek Harness 外掛市集，與 DeepSeek 官方無關，也不代表官方背書。第三方外掛未經安全稽核，安裝前請審查原始碼。

每週取得最新的 DeepSeek Harness 外掛，絕不濫發。