前言¶

DSH 的理念是「一切皆插件」。對 DSH 智能體開發者來說，Web 端插件越來越多之後，光看插件名稱或模塊名，往往不容易快速判斷某個插件是內置能力、第三方能力，還是隻負責某塊 UI/運行時能力。

dsh-web-plugin-explain 針對這個問題做了一件具體的事：增強 Web 設置裏的「插件列表」標籤頁，讓每個插件卡片展開後顯示插件包自身 package.json 的 description，並對第三方插件打標籤、支持按描述搜索。

這是什麼¶

dsh-web-plugin-explain 是 2710165659 維護的 DSH Web 端插件，許可證爲 MIT，包版本爲 0.1.0。

它增強的是 DSH Web 中的設置頁面：

設置 → 插件 → 「插件列表」

打開某個插件卡片後，可以看到該插件包 package.json 裏的 description 原文；如果解析不到描述，則顯示 —。插件已發佈到 npm，普通安裝不需要克隆倉庫或本地構建。

核心功能¶

下面介紹它已覈實的能力。

統一描述來源¶

內置插件與第三方插件使用同一套展示規則：展開卡片時，顯示插件包自身 package.json 的 description 原文。

解析不到 description 時，描述行顯示：

—

第三方標籤¶

模塊名不以 @deepseek-ai/ 或 cordis: 開頭的插件，會在名字後面顯示「第三方」小標籤。

@deepseek-ai/* 與 cordis:* 這類內置行即使字典未覆蓋，也不會被誤標爲第三方。

按描述搜索¶

搜索框會匹配：

• id
• 模塊名
• 描述

對於帶「第三方」標籤的行，還會匹配「第三方」標籤文本。

容錯展示¶

描述解析失敗時，例如 Remote 不可用，隻影響描述行；插件列表本身仍然正常渲染。

包聲明信息¶

package.json 中的名稱爲：

"name": "dsh-web-plugin-explain"

dsh.client.platform 聲明爲：

"web"

dsh.client.inject 聲明瞭多個 @deepseek-ai/dsh-client-* 包。dependencies 中包含：

"zod": "^4.4.3"

peerDependencies 中包含：

"@deepseek-ai/cordis": "4.0.1"

資料說明 zod 與 @deepseek-ai/dsh-client-* 等依賴由 pnpm 自動安裝。

安裝與啓用¶

npm 安裝¶

插件已發佈到 npm，安裝命令如下：

dsh plugin --profile web add dsh-web-plugin-explain

安裝完成後重啓 dsh web。

重啓 dsh web 時，typert-loader 會在啓動時註冊本插件的 strict 端點。

dsh plugin add 會自動識別包裏的 dsh.bundle 聲明，把它追加爲 web profile 的一層。

從源碼安裝¶

開發、改代碼或需要從本地構建時，可以先克隆倉庫：

git clone https://github.com/2710165659/dsh-web-plugin-explain.git
cd dsh-web-plugin-explain
npm install
npm run build          # 構建 lib/（index.js + client.js + typert.host.js）
dsh plugin --profile web add ./dsh-web-plugin-explain

構建會生成 lib/ 下的 index.js、client.js、typert.host.js。

同樣需要重啓 dsh web 後生效。

典型用法¶

1、安裝插件：

dsh plugin --profile web add dsh-web-plugin-explain

2、重啓 dsh web。

3、打開：

設置 → 插件 → 「插件列表」

4、展開任意插件卡片，查看 package.json 的 description。

5、在搜索框輸入插件 id、模塊名或描述，定位目標插件；第三方插件還可以搜索「第三方」。

卸載¶

卸載命令如下：

dsh plugin --profile web remove dsh-web-plugin-explain

重啓 dsh web 後，可恢復內置的插件列表。

適用場景與注意¶

這個插件適合以下場景：

• 維護多個 DSH Web 插件，需要快速查看插件包說明。
• 區分內置插件與第三方插件。
• 在設置頁面的「插件列表」裏按描述搜索插件。
• 開發 DSH Web 插件時，從源碼安裝並本地構建驗證。

使用前需要注意：

• 許可證爲 MIT。
• 插件以當前 dsh 進程權限運行；安裝前應檢查源碼、依賴與許可證。
• 該插件是社區插件線索中收錄的 Web 客戶端插件；社區目錄是獨立站點，不與 DeepSeek / 幻方構成官方從屬關係。
• 描述解析不到時顯示 —；描述解析失敗不會導致插件列表本身渲染失敗。

鏈接¶

• GitHub：https://github.com/2710165659/dsh-web-plugin-explain
• 目錄頁：https://www.skillhub.cn/plugins/2710165659/dsh-web-plugin-explain（來自插件線索，建議自行覈實）