前言¶
DeepSeek Harness（dsh）把能力拆成可組合的插件；日常開發裏，除了裝插件，還需要在設置裏看清各插件提供了什麼、在對話界面裏掛載節點 UI，以及從社區目錄裏發現同類插件。宿主自帶界面未必覆蓋「設置卡片 + 對話節點 + 社區市場」這一整套體驗。下面介紹社區插件 dsh-plugin-cards（維護者 yuanzukun），它在 dsh 桌面端 / Web 面板中提供設置卡片、對話節點渲染，並內置基於官方 topic 口徑的插件市場。
這是什麼¶
dsh-plugin-cards 是 dsh 的客戶端類插件：在 npm 上的包名爲 dsh-plugin-cards，當前版本 0.9.29（見倉庫 package.json），許可證 MIT。倉庫在 GitHub，SkillHub 目錄頁爲 skillhub.cn/plugins/yuanzukun/dsh-plugin-cards。
插件在 manifest 中聲明 dsh.engine 爲 >=0.1.7-rc.2；README 說明設置卡片、對話節點與 locale 相關完整能力需宿主 ≥ 0.2.0，舊宿主上會 fail-fast 或走能力檢查與中文回退。
核心功能¶
設置卡片與對話節點¶
安裝並啓用後，設置卡片出現在該插件在設置裏的詳情頁內；對話節點渲染在 chat 目標上。客戶端通過 dsh.client.inject 注入 @deepseek-ai/dsh-client-ui-conversation 與 @deepseek-ai/dsh-client-ui-renderer，平臺爲 web。
內置插件市場¶
市場目錄的唯一來源爲 GitHub 官方社區 topic：github.com/topics/dsh-plugin。發現規則包括：topic:dsh-plugin、近 12 個月有更新、名稱/描述/標籤含 dsh 等；安裝需通過宿主 L1 門禁（聲明 dsh.bundle）。界面提供六大類與二級分類篩選、中文描述優先級（快照 description_zh → 運行時翻譯 → 原文）、搜索與 Tab 狀態持久化（localStorage 鍵 dcards.mktview.v1）。
網絡安裝失敗時，客戶端按文檔實現降級梯（例如 npm 同名探測、hub tarball、codeload tarball、原通道重試等），並對 pnpm 11 git 依賴構建授權、GitHub 連接超時等錯誤給出中文說明與自救提示。
出廠快照與在線補齊¶
發版產物內聯按星數裁剪的 Top 1500 條目快照（完整目錄約 1.3 萬+ 條，打開市場後在線補齊）；快照來自 hub 定時任務與面板靜默檢查，Stale 守衛與 jsDelivr 鏡像策略見倉庫 README「數據通道與緩存」一節。
安裝與啓用¶
普通用戶推薦全程在桌面端 UI完成，無需命令行：
- 打開 DSH 桌面端（或
dsh web面板） - 進入 設置 → 插件 → 插件市場
- 搜索
dsh-plugin-cards，點擊 安裝（本插件已收錄於上述 topic 社區；新插件最遲次日快照收錄） - 安裝後自動啓用；桌面端安裝後需重啓宿主才加載（宿主無 HMR 時界面會提示「下次啓動 DeepSeek Harness 後加載」）
更新同樣在市場內完成：已安裝插件有新版本時卡片顯示「有更新」，可一鍵升級。
命令行備選（CI / 無頭環境）如下，profile 需與使用場景一致：
dsh plugin --profile desktop add dsh-plugin-cards
dsh plugin --profile <name> add dsh-plugin-cards
dsh 0.2.0+ 時，桌面端可通過「Manage dsh command」內置 dsh 並管理插件；dsh 已在 PATH 時 CLI 與桌面端默認共用 ~/.dsh。
注意：README 記錄 CLI 本地路徑 link 安裝可能只寫 dependencies、不寫 dsh.profile.bundles，重啓後插件 UI 會靜默消失；市場 UI 安裝不受影響。0.1.x 舊版用戶若本機無全局 dsh，需在 deepseek-harness 源碼根目錄用與桌面端一致的 pnpm 執行 pnpm dsh plugin ...。
典型用法（本地調試）¶
維護者本地聯調 dsh 源碼時，在插件倉庫構建後，用 dev patch 掛到宿主：
pnpm install
pnpm build
在 deepseek-harness 源碼 checkout 根目錄執行（路徑按本機修改）：
pnpm dsh web --patch D:/導航/dsh-plugin/cordis.dev.patch.yml
pnpm dsh --profile web --dump-config
啓動後終端應打印 [dsh-plugin-cards] plugin loaded!，UI 在 http://127.0.0.1:3080；dump-config 輸出中應出現 # == dsh-plugin-cards 配置層。
適用場景與注意¶
適合誰：已在用 dsh 桌面端或 Web 面板、希望在設置裏用卡片管理插件配置、在對話裏使用節點 UI，並需要從官方 topic 口徑瀏覽、安裝社區插件的用戶與插件作者。
權限與安全：插件以當前 dsh 進程權限運行；安裝前應閱讀 倉庫源碼 與 MIT 許可證，自行評估供應鏈與網絡安裝行爲（含 git / npm 拉取與構建授權）。
生態說明：DSH 社區插件目錄（如 SkillHub）是獨立社區站點，與 DeepSeek / 幻方無官方從屬關係；本插件市場數據口徑對齊 GitHub dsh-plugin topic，而非第三方自封的「官方應用商店」。
結尾¶
dsh-plugin-cards 把設置卡片、對話節點和社區插件市場收進同一客戶端插件，安裝路徑以桌面端市場爲主、CLI 爲輔。進一步瞭解實現與發佈流水線見倉庫 README 與 docs/dsh-plugin-開發建議方案.md。
