前言¶

在 DeepSeek Harness（DSH）裏裝插件，常見做法是翻 GitHub、記倉庫地址、手動執行 dsh plugin add。社區目錄站點能集中展示插件，但安裝仍要回到命令行。另一類方案是部署中心化市場平臺，需要額外基礎設施和賬號體系。

dsh-plugin-workshop（維護者 yyyyukari）走另一條路：把插件瀏覽、搜索、安裝整合進 DSH Web UI 側欄，數據全部來自 GitHub 搜索 API 與 raw CDN，不部署控制平面。下面介紹它的定位、能力與使用方式。

這是什麼¶

dsh-plugin-workshop 是 DSH Web UI 的創意工坊式插件瀏覽器，單包開箱即用，內置在側欄「新會話」按鈕正下方。與中心化市場平臺路線不同，它採用零基礎設施方案：目錄、搜索、熱度、發佈時間由 GitHub 免費提供，裝進 profile 即可使用。

• 維護者：yyyyukari
• 分類：客戶端
• 許可證：MIT
• 當前版本：1.6.2（package.json）
• GitHub 星標：25

核心功能¶

側欄入口與界面掛載¶

激活後，側欄「新會話」下方出現「插件工坊」入口，樣式與官方按鈕一致（DOM 克隆，寬/窄側欄自適應）。浮層通過 shell.overlay 打開；設置 → 插件區也有「插件工坊」標籤頁。刷新或重啓後入口不丟失。

搜索、排序與過濾¶

默認只搜 DSH 插件，查詢使用 topic:dsh-plugin。支持關鍵詞搜索，中文詞（如「天氣」「翻譯」）會自動映射爲英文關鍵詞。排序選項包括最熱、最新，以及飆升榜時間窗口（近 7/30/90 天新建 + 熱度排序）。

搜索結果自動排除官方 harness 等核心倉庫（查詢級 -repo: 過濾）。全站模式下會做插件特徵驗證：檢查 package.json 的 dsh 字段、cordis.yml 等，通過 raw CDN 拉取，不消耗 GitHub API 額度。

已安裝管理¶

工具欄「已安裝」視圖合併 profile 依賴、激活行與本地預設，展示本機插件的類型、激活狀態與安裝來源。支持一鍵更新（pnpm update / git pull）與卸載。

雙語體驗¶

描述可一鍵切換原文/中文機翻；詳情頁 README 可整篇翻譯（Google 翻譯接口，自動緩存）。

智能一鍵安裝與卸載¶

詳情頁會預檢倉庫結構，給出三級評級：可直接安裝、有風險、建議手動。標準 bundle/nested/preset 結構支持一鍵安裝；特殊結構（多包 monorepo、非插件倉庫、帶構建腳本等）會降級爲從 README 提取的安裝命令，僅可複製，不自動執行。

卸載按安裝方式逆向清理：pnpm remove 失敗則不改動文件；成功後自動重啓 dsh web 刷新插件表。本機缺少 git 時界面會明確提示。

詳情頁與額度透明¶

詳情頁展示星數、fork、語言、許可證、創建時間，輕量渲染 README，並提供手動安裝命令與 GitHub 直達鏈接。工具欄即時顯示 GitHub 搜索剩餘額度與恢復倒計時；可選填 GitHub Personal Access Token（30 次/分，僅存本機瀏覽器 localStorage）。

可選統計服務¶

可選接入統計服務後解鎖社區裝機徽章與真·飆升榜（參考實現見倉庫 remote/README.md）。不部署時零影響。

安裝與啓用¶

以 web profile 爲例，一條命令安裝：

# 本包在 package.json 聲明瞭 dsh.bundle.patch，
# dsh plugin add 會自動把它加入 profile 的 dsh.profile.bundles，
# 啓動時 cordis.patch.yml 作爲 bundle 補丁層自動激活。
dsh plugin --profile web add "github:yyyyukari/dsh-plugin-workshop"

# 重啓 dsh web 並刷新瀏覽器

手動接入舊流程：把本包加進 profile dependencies，並在 $DSH_HOME/profiles/web/cordis.patch.yml 添加：

- insert:
    - id: plugin-workshop
      name: '@dsh-external/dsh-plugin-workshop'

典型用法¶

適用場景與注意¶

適合誰： 經常在 DSH Web UI 裏瀏覽、搜索、安裝社區插件的開發者；希望用 GitHub 作爲唯一數據源、不想自建市場後端的用戶。

架構要點： 宿主側（lib/index.js）在 webServer 上註冊 /dsh-plugin-workshop/api/{status,install,update,uninstall} 路由；瀏覽器側（lib/client.js）用 React 實現界面。數據流爲 GitHub 搜索 API（匿名 10 次/分）→ raw CDN 特徵驗證 → Google 機翻。不執行任何第三方代碼。

安全提醒： 插件以當前 dsh 進程權限運行。一鍵安裝前建議查看目標倉庫源碼與許可證；對「有風險」或「建議手動」評級的倉庫，按 README 給出的命令自行判斷後再執行。

DSH 生態理念是「一切皆插件」；SkillHub 等社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。dsh-plugin-workshop 不是官方應用商店，而是把 GitHub 上的 DSH 插件生態接到 Web UI 裏的客戶端工具。

鏈接¶

• 目錄頁：https://www.skillhub.cn/plugins/yyyyukari/dsh-plugin-workshop
• GitHub：https://github.com/yyyyukari/dsh-plugin-workshop