前言¶
DeepSeek Harness（簡稱 DSH）的設計口號是「一切皆插件」：模型、工具、會話、沙箱、界面都可以換成插件，再由 Cordis 把它們組裝起來。官方倉庫也建議作者給倉庫打上 dsh-plugin 話題，方便別人發現。
實際用起來，發現插件這件事仍然分散。GitHub 上搜 topic:dsh-plugin，結果裏會夾着官方 harness 本身；社區還有獨立的插件目錄站點，但它不是 DeepSeek / 幻方的官方應用商店，和 DSH 核心倉庫沒有從屬關係。想在網頁界面裏隨手瀏覽、看熱度、裝一個包，往往還要切出終端敲 dsh plugin add。
dsh-plugin-workshop 走的是另一條路：不搭市場後臺，不搞賬號系統，把 Steam 創意工坊那種瀏覽體驗嵌進 DSH Web UI 側欄，目錄、搜索和趨勢窗口直接問 GitHub。下面按社區目錄頁和 GitHub 倉庫交叉覈對後說明它是什麼、能做什麼、怎麼裝、怎麼用。
這是什麼¶
dsh-plugin-workshop 是一款界面增強插件，由 GitHub 用戶 yyyyukari 維護，倉庫爲 yyyyukari/dsh-plugin-workshop，npm 包名是 @dsh-external/dsh-plugin-workshop。許可證爲 MIT，主要語言是 JavaScript。社區目錄將其歸入「界面增強」；倉庫 package.json 裏當前版本爲 1.6.1，並聲明 dsh.client.platform 爲 web，也就是掛在網頁界面上，而不是終端 TUI。
截至 2026-08-17，GitHub 倉庫星標爲 26。社區目錄頁收錄於 2026-08-15，當時展示的星標是 18，以 GitHub 一手數據爲準。
它要解決的問題很具體：在已經打開的 DSH Web UI 裏，用工坊式界面搜索、篩選、查看社區插件，並按倉庫類型一鍵安裝、更新或卸載。README 寫明，這和 DSH_Creative_Workshop 那種中心化市場平臺不同——本項目不部署控制平面，裝進 profile 即可用。
核心功能¶
側欄常駐入口¶
安裝並激活後，工坊入口出現在官方「新會話」按鈕正下方。README 說明實現方式是 DOM 克隆官方按鈕，寬側欄和窄側欄都能跟上，刷新或重啓後入口仍在。設置頁的「插件」區域裏也有一個「插件工坊」標籤頁，和側欄浮層是同一套界面的兩處掛載。
搜索、排序和飆升窗口¶
默認範圍是 GitHub 話題 topic:dsh-plugin，也就是官方建議作者打上的插件標記。搜索結果會在查詢裏用 -repo: 排除官方 harness 等核心倉庫，避免它們長期佔住榜首。
排序提供「最熱」和「最新」。另外有一組近似 Steam Trending 的時間窗口：近 7 天、近 30 天、近 90 天內新建的倉庫，再按星標排序。這是 GitHub 搜索 API 能提供的近似，不是商店後臺統計出來的真實裝機增速。
中文關鍵詞可以直接輸入。README 的例子是「天氣」「翻譯」這類詞，插件會映射到英文再去搜。
切到全站模式時，會做一次插件特徵驗證：檢查倉庫 package.json 裏的 dsh 字段、cordis.yml 等特徵，請求走 raw.githubusercontent.com，不消耗 GitHub 搜索 API 額度。驗證不過的倉庫默認濾掉。
詳情頁和雙語¶
點開一張卡片可以看到星標、fork、語言、許可證、創建時間，以及輕量渲染的 README。頁面上會給出手動安裝命令，並提供 GitHub 直達鏈接。
描述可以在原文和中文機翻之間切換；詳情頁還能整篇翻譯 README。翻譯走 Google 翻譯接口，結果會緩存。機翻不能當成作者官方中文文檔。
智能安裝、更新和卸載¶
詳情頁會先預檢倉庫結構，給出三級評級：可直接安裝、有風險、建議手動。
- 標準形態繼續走一鍵安裝。README 把倉庫分成三類：bundle 型（
package.json聲明dsh.*）走官方dsh plugin add；若聲明瞭dsh.bundle.patch，DSH 會把它加入 profile 的 bundles，補丁層自動激活。nested 型是目錄樹裏恰好有一個 dsh 包（支持packages/<name>這類多層 monorepo），本地副本再link:子包。preset 型拷進.agent-presets。 - 特殊結構（多包 monorepo、非插件倉庫、帶構建腳本等）不會自動執行安裝，而是從 README 抽出作者給出的命令，只允許複製。
- 卸載按安裝路徑逆向清理。README 寫明：
pnpm remove失敗則不動文件、不留失效鏈接；成功後會自動重啓dsh web以刷新插件表。本機缺少 git 時，界面會明確提示。
工具欄還有「已安裝」視圖，合併 profile 依賴、激活行和本地預設，展示類型、激活狀態和安裝來源，並提供一鍵更新（pnpm update / git pull）和卸載。
額度、Token 和可選統計¶
搜索數據來自 GitHub Search API，瀏覽器直連（CORS）。匿名額度是每分鐘 10 次。界面會顯示剩餘次數和恢復倒計時。需要更高額度時，可在工具欄填入 GitHub Personal Access Token，README 寫的是每分鐘 30 次，Token 只存在本機瀏覽器的 localStorage。
特徵驗證和 README 拉取走 raw CDN，不佔搜索額度。
零服務器是默認形態。倉庫 remote/ 目錄提供一份可選的 Cloudflare Worker + D1 統計服務參考實現：部署後可以顯示社區裝機徽章，以及按實際安裝淨增長計算的飆升榜。不部署則完全不影響主功能；宿主側只在環境變量 DSH_WORKSHOP_STATS_URL 存在時才上報。README 說明上報字段是倉庫全名、事件類型（install / update / uninstall）和每臺機器一個匿名 UUID，不帶用戶身份、路徑，也不持久化 IP。
安裝與啓用¶
社區目錄頁給出的安裝命令如下，在 DeepSeek Harness 終端中運行即可：
dsh plugin add github:yyyyukari/dsh-plugin-workshop
這是目錄頁原文。該插件掛在 Web UI 上，倉庫 README 建議明確指定 web profile：
dsh plugin --profile web add "github:yyyyukari/dsh-plugin-workshop"
README 解釋：本包在 package.json 裏聲明瞭 dsh.bundle.patch，指向倉庫中的 cordis.patch.yml。dsh plugin add 會把它加入當前 profile 的 dsh.profile.bundles，啓動時作爲 bundle 補丁層自動激活，一般不用手改配置。cordis.patch.yml 裏插入的插件 id 是 plugin-workshop，name 是 @dsh-external/dsh-plugin-workshop。
裝完後需要重啓 dsh web，並刷新瀏覽器。側欄「新會話」下方應出現「🧩 插件工坊」。
如果需要可復現安裝，目錄頁建議固定 commit 哈希：
dsh plugin add github:yyyyukari/dsh-plugin-workshop#commit
把末尾的 commit 換成實際哈希。目錄頁同時提醒：插件以當前 dsh 進程的權限運行，安裝時可能執行代碼。安裝前應檢查源代碼倉庫和許可證。
舊流程是把包加進 profile 依賴，再手動往 $DSH_HOME/profiles/web/cordis.patch.yml 寫入激活行。當前版本已聲明 bundle patch，這條只在接入其它 profile、或自動激活未生效時才需要。
典型用法¶
激活後，點擊側欄「插件工坊」打開浮層，或到「設置 → 插件」裏的同名標籤頁。
- 瀏覽社區插件：保持默認的「插件話題」列表，看
topic:dsh-plugin下的倉庫。 - 看近期新項目：時間下拉選近 7 / 30 / 90 天飆升，再按「最熱」排序。
- 中文搜索：直接輸入中文關鍵詞，由插件映射到英文再查詢。
- 讀中文說明：工具欄打開「描述中文」；詳情頁需要全文時再點「翻譯 README」。
- 安裝或卸載：打開詳情，先看預檢評級。可直接安裝的倉庫用「一鍵安裝（訂閱）」；有風險或建議手動的，複製作者命令，不要指望工坊代跑。更新和卸載走詳情頁或「已安裝」視圖。
- 搜索被限流：工具欄齒輪裏填入僅用於提高 GitHub 搜索額度的 Token。這不是登錄工坊賬號，工坊本身沒有賬號系統。
宿主側在 webServer 上註冊同源路由 /dsh-plugin-workshop/api/{status,install,update,uninstall}。安裝和卸載走這些接口，並帶自定義頭做 CSRF 防護。瀏覽器側負責界面和 GitHub 查詢，README 寫明瀏覽器半邊不執行第三方插件代碼。
適用場景與注意事項¶
比較適合這幾類情況：
- 已經在用 DSH Web UI，希望少切終端、在側欄裏找社區插件。
- 接受「目錄來自 GitHub、熱度來自星標和時間窗口」，不需要中心化審覈商店。
- 需要中文關鍵詞和機翻描述，快速掃一遍 README 再決定裝不裝。
- 本機已安裝 git，這樣才能走 clone / pull 一類路徑。
使用前需要知道邊界：
- 權限與信任。插件以當前 dsh 進程權限運行。工坊能代爲執行
dsh plugin add、改 profile、重啓 web 服務，等於把一部分包管理能力交給這個插件。安裝工坊本身、以及經工坊再裝其它插件之前，都應打開對應倉庫看源碼和許可證。 - 只覆蓋網頁界面。
package.json聲明平臺爲web。只用終端、不用 Web UI 的環境裝上它，側欄入口不會出現。 - GitHub 額度。匿名搜索每分鐘 10 次，填 Token 後 README 寫的是 30 次。額度用盡時界面會顯示倒計時，不是工坊宕機。
- 飆升榜的含義。默認窗口是「時間範圍內新建 + 按星標排序」，不是真實裝機量。真·飆升榜依賴可選統計服務，未部署時沒有這項數據。
- 機翻。中文描述和 README 翻譯來自 Google 接口，可能不準確，安裝命令仍以倉庫原文爲準。
- 和其它「工坊」不是同一個項目。社區裏還有走中心化市場路線的
DSH_Creative_Workshop，以及另一個 Steam 風格商店插件dsh-workshop（維護者 loguhan）。本文介紹的是yyyyukari/dsh-plugin-workshop，安裝命令不要混用。 - 社區目錄不是官方商店。https://deepseek-harness-plugin.com 是獨立的社區站點，用來檢索和展示安裝命令，並不代表 DeepSeek 官方背書。
小結¶
dsh-plugin-workshop 把插件發現從「打開 GitHub 或目錄站、再回到終端安裝」收進 DSH Web UI 側欄。它不自建服務器，搜索和趨勢窗口直接使用 GitHub；安裝路徑儘量複用官方 dsh plugin add 和 bundle 補丁機制，特殊倉庫則退回作者文檔裏的命令。
如果你已經在跑網頁界面，又希望用一種不額外運維的方式瀏覽 dsh-plugin 生態，可以先看源碼，再按目錄頁命令裝進 web profile。
- 社區目錄：https://deepseek-harness-plugin.com/zh-CN/plugins/dsh-plugin-workshop/
- GitHub：https://github.com/yyyyukari/dsh-plugin-workshop
- DeepSeek Harness 官方倉庫：https://github.com/deepseek-ai/deepseek-harness
