前言¶

在 DSH / 智能體開發中，擴展能力經常依賴社區插件。插件分散在 GitHub 倉庫裏，手動搜索、判斷類型、安裝和更新容易變成碎片化流程。dsh-whale-market（鯨魚插件市場 / Whale Market）提供統一入口，用於瀏覽、搜索、一鍵安裝與更新 GitHub dsh-plugin 主題下的 DSH 社區插件。

這是什麼¶

dsh-whale-market 是社區維護的 DSH 插件市場，不是 DeepSeek / 幻方官方應用商店。倉庫所有者爲 hoangdtdoothanh-svg，許可證爲 MIT。

它運行在 DSH 的 Web 設置頁中，同時爲 Agent 提供四個市場工具：market_search、market_install、market_installed、market_update。

核心功能¶

市場瀏覽¶

市場圍繞 DSH 社區插件提供四個欄目：

• 插件
• Skills
• 皮膚
• 預設

即時市場通過 GitHub Search API 拉取：

• topic:dsh-plugin
• topic:agent-skills

支持按 star 排序、分頁和關鍵詞搜索。

搜索與篩選¶

搜索和篩選能力包括：

• 按分類篩選
• 按語言篩選
• 只看收藏
• 只看已驗證
• 按星標排序
• 按最近更新排序

輸入中文功能詞時，會自動擴展爲英文同義詞 OR 查詢，便於從功能名找到對應倉庫。

數據降級¶

市場提供四級數據降級：

即時 API → 磁盤快照 → 靜態索引 → 內置種子

網絡狀態不佳時，仍可通過靜態索引或內置種子瀏覽市場內容。

安裝與風險確認¶

安裝流程包括：

• 類型檢測
• 兼容性評分
• 腳本型、非插件、手動型倉庫安裝前風險確認門禁
• 分形態安裝：技能、預設、腳本、插件
• git 直連失敗時自動回退 codeload tarball
• 分級錯誤提示
• 網絡診斷審計

安裝前會給出類型判定、兼容性評分與危險模式掃描結果，並要求用戶確認。

已安裝管理¶

已安裝管理支持：

• 開關
• 更新
• 卸載
• 環境變量編輯
• 收藏夾與收藏更新通知
• 安裝歷史
• 備份 / 恢復
• WebDAV 備份
• 安裝反饋生成 GitHub Issue
• 審計日誌
• 市場數據大盤
• 插件作者工具
• 錯標倉庫適配層

界面支持雙語 UI，並對齊原生 DSH 設計 tokens。

Agent 工具與接口¶

Agent 可用工具包括：

market_search
market_install
market_installed
market_update

HTTP 接口可用於查詢市場列表：

GET /plugins/dsh-whale-market/list

支持參數：

kind
category
language
sort
favorite

安裝與啓用¶

先確認環境滿足以下條件：

• Node ≥ 18
• dsh 或 whale CLI 在 PATH 上
• pnpm 在 PATH 上

執行安裝命令：

dsh plugin --profile desktop add dsh-whale-market

這條命令將 dsh-whale-market 安裝到 desktop profile。

安裝完成後，重啓 DSH，然後進入：

• 設置 → 插件 → 插件市場
• 設置 → 插件 → 已安裝

典型用法¶

Agent 工具示例¶

以下工具用於搜索、安裝、查看和更新插件：

market_search q=記憶 kind=plugin
market_install spec=owner/repo
market_installed
market_update name=xxx

說明：

• market_search：按關鍵詞和類型搜索
• market_install：安裝指定倉庫，風險倉庫會要求確認
• market_installed：查看已安裝清單
• market_update：更新指定插件

市場列表接口¶

查詢市場列表：

GET /plugins/dsh-whale-market/list

可通過 kind、category、language、sort、favorite 參數縮小範圍。

適用場景與注意¶

適合以下使用場景：

• 在 DSH 中瀏覽和搜索社區插件
• 通過 Web 設置頁安裝、更新、卸載插件
• 用 Agent 工具完成市場搜索、安裝和更新
• 在網絡不佳時通過靜態索引或內置種子瀏覽市場
• 管理插件開關、環境變量、備份與安裝歷史

注意事項：

• 安裝第三方插件會運行第三方代碼，插件以當前 DSH 進程權限運行；安裝前應檢查源碼與許可證。
• 市場會提供類型檢測、兼容性評分與危險模式掃描，並在腳本型、非插件、手動型倉庫安裝前要求確認。
• 安裝、更新、卸載、開關後需要重啓 DSH 才生效；技能熱加載除外。
• 只支持安裝到市場自身所在的 profile。
• 環境變量編輯不會寫入備份文件，密鑰不進備份。

獲取¶

GitHub 倉庫：

https://github.com/hoangdtdoothanh-svg/dsh-whale-market

目錄頁（插件線索來源）：

https://www.skillhub.cn/plugins/hoangdtdoothanh-svg/dsh-whale-market