DeepSeek Harness 外掛安裝教學：dsh 外掛怎麼裝（安全指南）

先說清楚：「安裝」在這裡是什麼意思

DeepSeek Harness 外掛不是透過某個中央套件管理器裝的，跟瀏覽器擴充功能商店也不一樣。一個外掛就是一個 Cordis 外掛，安裝意味著往 Profile / Patch 設定裡加一筆記錄，下次啟動時它進入外掛樹。外掛自己的 README 會給出確切的那一行。

好消息是可逆性保證：刪掉這筆記錄，外掛註冊過的一切隨之撤銷。沒有需要大海撈針的卸載殘留——這正是「試外掛成本很低」的原因（疊加原理見設定教學）。

dsh 外掛的「安裝指令」

從其他生態過來的人，總會找那一條指令——npm install 或 pip install 的等價物。這裡要分清兩個不同的「安裝指令」：

# 1. 安裝 Harness 本體（dsh CLI）——這一條確實是套件管理器指令
npm install -g @deepseek-ai/dsh

# 2. 安裝外掛——並不存在 `dsh install <外掛>`；
#    裝外掛就是往設定裡加一筆記錄

安裝一個外掛，就是往你的 Profile / Patch 設定（一組按順序疊加的 cordis.patch.yml）裡加一筆記錄，下次啟動時它進入外掛樹。記錄的確切寫法（名稱、套件來源、選項）以各外掛自己的 README 為準，因為外掛需要什麼只有它自己知道。改完設定後重新啟動 dsh，外掛樹重新組裝即可生效。

為什麼沒有統一的安裝指令？因為 dsh 外掛可以替換 Harness 的任何部分——而不只是往上疊加——可層層覆蓋的設定層，比一張扁平的套件清單更適合這個模型。代價是每裝一個外掛多改一行設定，換來的是徹底的可逆性。

去哪裡找外掛

• 本站目錄 —— 按分類、星標或更新時間瀏覽；詳情頁展示授權條款、語言、是否封存，以及哪些來源收錄了它。
• dsh-plugin GitHub topic —— 生態的註冊表主幹，幾百個倉庫。
• 社群清單 —— 本目錄聚合的四份人工維護清單，生態指南裡有完整地圖。

五分鐘審查流程

在往設定裡加那一行之前，花五分鐘看看倉庫：

1. 讀 README —— 它幹什麼、怎麼裝、最好還寫明會存取什麼：檔案、網路、會話。
2. 看授權條款 —— 這個生態裡開源是常態；授權條款缺失或怪異，就該停下來想想。
3. 掃一眼原始碼 —— 不用逐行稽核，但瞄一下入口：有沒有偷偷連網回報、有沒有碰工作區以外的檔案。
4. 看活躍度與健康度 —— 最近推送時間、open issues、是否封存。本站詳情頁這三樣都有。
5. 優先選精選條目 —— 如果某份人工維護的清單收錄了它並寫了描述，說明第 1–4 步已經有人替你做過了。

安裝與驗證

1. 按外掛 README 的安裝行，把它寫進你的 Profile / Patch 設定。
2. 重新啟動 Harness，讓外掛樹載入它。
3. 開一個會話，確認外掛真的註冊上了——工具出現了、面板顯示了，總之 README 承諾什麼就驗證什麼。
4. 先在一次性工作區裡試，從 read-only 沙箱起步，再升到 workspace-write（見安全指南）。

應該停手安裝的紅旗

• README 索取的憑證或環境變數，跟外掛本職毫無關係。
• 程式碼往 README 從沒提過的端點發資料。
• 一個本不該碰工作區以外的外掛，卻要求 danger-full-access。
• 倉庫沒有授權條款、沒有 README、也沒有任何活躍記錄。

這些都不是一票否決，但每一條都意味著：裝之前要讀原始碼，而不是出事之後再讀。

出問題了怎麼辦

1. 停掉會話。
2. 從 Profile / Patch 設定裡刪掉外掛的條目。
3. 重新啟動，確認 Harness 恢復正常——得益於可逆註冊，一般都沒事。
4. 到外掛倉庫提 issue，說清楚發生了什麼；這個生態的維護者動作很快。

常見問題

有 dsh plugin install 這樣的指令嗎？ 沒有。整個生態裡唯一的套件管理器指令是裝 Harness 本體：npm install -g @deepseek-ai/dsh。裝外掛是往 Profile / Patch 設定裡加一筆記錄——每個外掛的 README 都寫明了那一行——然後重新啟動。

裝完外掛需要重啟 dsh 嗎？ 需要。外掛樹是在啟動時從設定層組裝出來的，新加的條目下次啟動才生效。

怎麼卸載 dsh 外掛？ 從 Profile / Patch 設定裡刪掉它的條目，重新啟動。註冊被要求是可逆的，外掛註冊過的一切——工具、UI 面板、服務——隨之撤銷，不留殘餘。

這個目錄裡的外掛經過審核嗎？ 收錄不等於背書。目錄把授權條款、活躍度、是否封存都擺在明面上，是為了讓你那五分鐘的自查足夠快——上面的流程本身就是審核。

繼續閱讀

• dsh 外掛是什麼？ —— 安裝行背後的概念
• 外掛開發入門教學 —— 安裝行的另一頭
• dsh plugins 生態盤點 —— 目錄資料從哪裡來
• 瀏覽全部外掛