用 dsh-store 在 DeepSeek Harness 裏瀏覽並一鍵安裝插件

前言

DeepSeek Harness(dsh)是 DeepSeek 開源的智能體運行時,核心設計是「一切皆插件」:模型、工具、沙箱、會話存儲、界面,甚至智能體循環本身,都可以用插件拼裝。官方倉庫目前仍處於 developer preview,兼容性可能隨時變化。項目地址:https://github.com/deepseek-ai/deepseek-harness

預覽版上線後,社區插件增長很快。GitHub 上 dsh-plugin topic、npm 關鍵詞、各類 awesome 列表同時出現,質量參差不齊:有的包只是蹭了關鍵詞,有的倉庫沒有 dsh 清單字段,裝上去纔會報錯。自己到 npm 搜、對照 README、再手敲 dsh plugin add,對日常使用並不方便。

dsh-store 做的事情比較直接:把一份經過質量校驗的插件目錄嵌進 dsh 的 Web UI,瀏覽、搜索、安裝、卸載、停用和更新都在同一套界面裏完成。它由 huguangyu666 維護,採用 MIT 許可證,社區目錄把它歸在「界面增強」。需要先說清楚:本文依據的社區插件目錄(https://deepseek-harness-plugin.com/zh-CN/plugins/)是獨立站點,與 DeepSeek / 幻方沒有官方從屬關係,dsh-store 也不是官方應用商店。

這是什麼

dsh-store 是跑在 dsh Web 界面裏的插件商店。npm 上當前版本是 0.5.2(2026-08-16 發佈),包名就是 dsh-store,要求 Node.js >=22.5package.json 裏聲明瞭 dsh.client.platformweb,也就是面向 Web UI,而不是無界面的 headless 進程。

截至 2026-08-18,GitHub 倉庫 https://github.com/huguangyu666/dsh-store 與目錄詳情頁均顯示 4 顆星。目錄頁收錄日期爲 2026-08-15,最近一次推送爲 2026-08-16。

它要解決的問題可以分成兩層:

  1. 找得到:把 npm registry(keywords:dsh-plugin)、awesome-dsh-plugin 精選、GitHub topic:dsh-plugin 星標,以及 AdamPlatin123 自動雷達的運行級驗證狀態合併成一份目錄。
  2. 裝得上:安裝走官方 dsh plugin add/remove,寫到 dsh.profile.bundles 這一層,失敗再回退 pnpm add 加 patch 合併。README 強調:目錄裏帶 npm 條目的插件應當能真正裝上,而不是一份只能跳轉倉庫的列表。

關於收錄數量,幾處文案並不完全一致,需要按來源分開看,不要混成一個「官方總數」:

  • 倉庫 README 的功能說明、目錄頁「更多介紹」寫的是四源合併後 750+ 插件。
  • package.json、npm 簡介、目錄頁「關於這個插件」仍寫 550+ 插件、11 個分類。
  • awesome 精選一側,README 給出的數字是 324 個、11 分類;雷達一側寫的是 194+ 條目。

這些數字會隨目錄刷新變化,以商店頁面實際加載爲準。

核心功能

倉庫 README 和目錄頁對能力的描述可以對上,當前版本主要有下面幾塊。

聚合目錄與徽章。 搜索走 npm 的 keywords:dsh-plugin;分類和「精選」徽章來自 awesome-dsh-plugin;星標、倉庫、更新時間來自 GitHub topic 搜索;雷達驗證通過的條目會打「雷達驗證」徽章。未上 npm 的精選插件不提供一鍵安裝,卡片上給出 GitHub 跳轉。

質量過濾。 後臺會請求每個包的 npm /latest,檢查 package.json 是否帶 dsh 字段(真插件標記),沒有該字段的會剔除。驗證結果緩存 7 天。README 給過一組實測口徑:關鍵詞搜索大約 250 個包,過濾後剩 222 個。npm 搜索本身會混入蹭關鍵詞的包,這一步是爲了把噪聲擋在目錄外面。

安裝與卸載。 界面上的「安裝」調用官方 dsh plugin add,自動 reconcile dsh.profile.bundles;「卸載」走 dsh plugin remove,並清理 patch 殘留。官方路徑失敗時回退 pnpm add 加 patch 合併。已安裝識別會合並三處來源:bundles、dependencies、patch。

已安裝管理與更新。 0.5.0 起支持對已安裝插件「停用 / 啓用」,寫入 cordis.patch.ymldisabled,走 HMR,不必重啓。頂部有「檢查更新」,可列出可更新項並一鍵更新。裝完需要重啓的改動,頁面提供「立即重啓」。

入口與命令。 客戶端在側邊欄頁腳註冊「插件商店」按鈕,在設置頁註冊同名分區,點擊打開 /plugin-store。另外註冊兩條命令:

  • /plugin-store:輸出商店地址、已收錄數量、已安裝列表和熱門摘要
  • /plugin-install <包名>:按包名直接安裝,例如 /plugin-install dsh-plugin-notify

詳情與緩存。 點擊卡片可看描述、分類、README 摘要(本地優先,npm 兜底)和倉庫鏈接。目錄緩存 24 小時,寫在 ~/.dsh/plugin-store/catalog.json,頁面上的「刷新目錄」會強制更新。

安裝與啓用

目錄詳情頁給出的安裝命令如下,在 DeepSeek Harness 終端裏運行即可:

dsh plugin add github:huguangyu666/dsh-store

如需可復現安裝,目錄頁建議固定 commit 哈希(把 commit 換成倉庫裏的實際哈希):

dsh plugin add github:huguangyu666/dsh-store#commit

README 還提供了帶 profile 的寫法,默認目標 profile 是 web

dsh plugin --profile web add dsh-store

裝完後重啓對應 profile。官方 Web UI 默認地址是 http://127.0.0.1:3080,商店頁面路徑是 /plugin-store,也就是:

http://<dsh地址>:<端口>/plugin-store

重啓後,側邊欄應出現「插件商店」入口,設置頁也會多一個同名分區。

README 裏還有一條 npm i dsh-plugin-store。npm 上實際包名是 dsh-store,這條命令與 package.json 不一致,安裝時以目錄頁的 dsh plugin add github:huguangyu666/dsh-store 爲準,不要照抄那條 npm 命令。

插件以當前 dsh 進程的權限運行,安裝時可能執行代碼。安裝前請檢查源代碼倉庫和許可證。

典型用法

下面的步驟來自倉庫 README 和源碼裏的頁面 / 命令註冊,可以按順序試一遍。

1. 瀏覽目錄

打開 /plugin-store。頁面支持搜索、按分類篩選,以及按星標、最新、名稱排序。卡片上會顯示精選徽章、描述、作者、版本和星標。未上 npm 的精選條目只能跳 GitHub,不要期望點「安裝」就能裝上。

2. 安裝一個插件

在卡片上點「安裝」。商店會走官方 dsh plugin add。成功後點「立即重啓」,新插件纔會進入當前進程。

也可以在對話裏直接安裝:

/plugin-install dsh-plugin-notify

源碼裏的提示文案寫明:該命令會改 cordis.patch.yml,裝完需要重啓 dsh 才生效。包名換成目錄裏真實存在的 npm 名稱即可。

3. 停用、啓用、卸載

已安裝的插件會顯示「停用 / 啓用」。這一步只寫 patch 的 disabled,HMR 即時生效,不必重啓。卸載則走 dsh plugin remove,並清理 patch 殘留。

4. 檢查更新

點頂部「檢查更新」,列出可更新項後再一鍵更新。更新後的生效方式以頁面提示爲準,需要重啓時再用「立即重啓」。

5. 國內訪問 GitHub 時配代理

星標和部分倉庫信息走 GitHub API。拉不到時目錄仍可用(源碼會打警告後繼續),但星標可能爲空。可在 ~/.dsh/plugin-store/config.json 寫代理和目標 profile:

{
  "proxy": "http://127.0.0.1:7892",
  "profile": "web"
}

環境變量可以覆蓋同名字段:

  • DSH_PLUGIN_STORE_PROXY:覆蓋 proxy
  • DSH_PLUGIN_STORE_PROFILE:覆蓋 profile

代理地址換成本機實際端口。proxy 示例裏的 7892 只是 README 給的樣例,不是固定端口。

6. 看商店摘要

/plugin-store

無參數時返回商店 URL、已收錄數量、已安裝列表,以及按星標排序的前幾條摘要。

適用場景與注意事項

比較適合這幾類人:已經在用 dsh web、希望在界面裏找插件而不是自己拼 GitHub topic;需要區分「精選 / 雷達驗證 / 僅 GitHub」三種條目;想用官方 dsh plugin add/remove 而不是手改 patch。

使用前注意下面幾點。

權限與安全。 插件以當前 dsh 進程權限運行,能讀本地文件、用已配置的憑證、訪問網絡。目錄收錄和「精選」徽章都不是安全審計。安裝前應打開 GitHub 倉庫看源碼和許可證。dsh-store 自身是 MIT,版權聲明爲 Copyright (c) 2026 huguangyu666。

平臺限制。 package.json 聲明客戶端只注入 Web 平臺。headless 或不跑 Web UI 的 profile,側邊欄入口和 /plugin-store 頁面都不會按文檔出現。

目錄不是全量鏡像。 源碼裏 npm 搜索 size=250,GitHub topic 搜索 per_page=100。awesome 與雷達是額外疊加,不是把全網插件一次性拉完。GitHub API 失敗時目錄仍可用來自 npm / awesome 的條目,只是星標可能缺失。

不要把它當成官方商店。 DeepSeek Harness 官方倉庫只提供插件機制和 dsh plugin add 命令。社區裏還有 dsh-market、plugin-hub、workshop 等同類項目。dsh-store README 用對比表強調自己以 npm 爲權威源、並用 dsh 字段做後臺驗證,這是作者自己的定位,不是官方評測。

版本仍在快迭代。 倉庫 2026-08-14 才創建,到 0.5.2 已修過商店空白頁、停用縮進等缺陷。dsh 本體也還在 developer preview。裝完如果頁面空白或安裝失敗,先看倉庫 CHANGELOG 和 Issues,再決定是否固定某個 commit。

小結

dsh-store 把 npm、awesome 精選、GitHub 星標和雷達驗證收進 dsh Web UI,用官方 dsh plugin add/remove 做安裝卸載,並補上停用、更新和 README 摘要。對已經跑着 Web UI、不想自己維護一份插件清單的人,它能把「搜得到」和「裝得上」放在同一頁裏。

目錄頁:https://deepseek-harness-plugin.com/zh-CN/plugins/dsh-store/

GitHub:https://github.com/huguangyu666/dsh-store

npm:https://www.npmjs.com/package/dsh-store

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜