前言¶
DeepSeek Harness（DSH）採用「一切皆插件」的架構：能力擴展依賴社區倉庫，而不是內置應用商店。開發者通常需要自己去 GitHub 找帶 dsh-plugin topic 的倉庫，複製安裝命令，處理網絡、依賴和 profile 配置。倉庫數量在增長，手動維護已安裝列表和版本也變得麻煩。
Zat-DSH Engine 由 mishibeikejie 維護，是一個客戶端插件，在 DSH Web GUI 的 Settings → Plugins 頁面增加 Plugin Market 標籤頁，把 GitHub 上 dsh-plugin topic 的社區目錄做成可瀏覽、可搜索、可一鍵安裝的可視化市場。它與 SkillHub 等社區目錄站點相互獨立，並非 DeepSeek 或幻方官方應用商店。
這是什麼¶
Zat-DSH Engine（mishibeikejie/zat-dsh-engine）是面向 DeepSeek Harness 的可視化插件市場。它在設置頁的插件列表右側增加市場入口，即時拉取 GitHub 上 dsh-plugin topic 的倉庫目錄，展示雙語簡介，並通過官方 dsh plugin profile 機制完成安裝、更新與卸載。
當前版本 0.7.0，MIT 許可證，分類爲客戶端插件。
核心功能¶
社區目錄與搜索¶
市場通過 GitHub 搜索 API 即時列出 dsh-plugin topic 下的社區倉庫（README 稱該 topic 下有 1700+ 倉庫，且仍在增長）。支持按分類篩選，共 12 類：Theme、Tools、Browser、Skills、Vision、Network、Agents、Data、Hardware、Design、Security 等。輸入關鍵詞即可過濾，無需按 Enter；清空搜索框回到完整列表。
插件卡片附帶雙語簡介：內置 999 條預翻譯的中文介紹；快照之後發佈的新插件保留英文描述。英文界面顯示 GitHub 原始 description。
安裝、更新與卸載¶
安裝、更新、卸載均基於官方 dsh plugin profile 機制，底層使用 pnpm。單插件倉庫靜默安裝；monorepo 倉庫會彈出選擇器，讓你挑選要安裝的子插件。已安裝的插件會被標記，並做版本比對，有新版本時顯示更新徽章。卡片上可直接啓用或禁用插件（官方核心插件和市場自身受保護，不可誤關）。
安裝、更新、卸載過程中，卡片上顯示即時進度條（百分比與計數），離開市場頁面再回來進度仍保留。
AI 插件查找¶
在任意對話中描述需求（例如「幫我找一個能讓模型看圖片的插件」），AI 會在市場中搜索、推薦候選，並對每個候選報告安裝前健康檢查與安全掃描結果（✅/⚠️/❌）。有問題會如實說明，不會盲目推薦。
安裝前檢查與安全掃描¶
安裝前會執行衝突檢測與健康檢查：阻止同時安裝兩個市場類插件、官方包劫持、重複 patch 行或註冊名衝突等問題。每個候選插件在安裝前做健康與安全掃描，檢查入口文件、構建產物、依賴風格、網絡目標、OS 支持等；安全掃描可識別混淆、憑據竊取、外泄等行爲（僅警告，避免誤報）；客觀問題（缺少入口、不支持當前 OS）會被阻斷。
提供一鍵檢查與修復：檢測網絡、pnpm、入口、OS、歷史錯誤等問題，能自動修復的（如安裝 pnpm、啓用插件、補齊依賴）會自動處理，其餘給出說明。
網絡與跨平臺¶
繼承系統 VPN/代理設置。GitHub 不可達時，請求自動回退到 gh-proxy.com 鏡像。鏈路順序爲：代理 → 直連 → 鏡像 → 內置 fetch 回退，無 VPN 也可使用。完整支持 Windows 與 Linux（PowerShell / sh，curl / wget，系統代理感知）。
其他能力¶
- 一鍵 star：複用本地 git 憑據爲倉庫加星。
- 自更新：市場自身有新版本時，標題旁出現 Update 按鈕。
- 安全回滾：安裝/卸載/切換失敗時自動回滾；profile 目錄下
zat-backup/保存最近一次成功操作後的狀態，可一鍵恢復。
安裝與啓用¶
請使用下方命令安裝，不要手動編輯
cordis.patch.yml。README 說明：手動把plugin-market行寫入app.asar.unpacked/cordis.patch.yml和~/.dsh/profiles/<profile>/cordis.patch.yml兩處會導致 id 重複，DSH 無法啓動。
環境要求：已安裝並可運行的 dsh；pnpm 和 curl 在 PATH 中；profile 已初始化（首次執行 dsh plugin --profile web add 時會創建）。
從 GitHub 安裝（推薦）¶
dsh plugin --profile web add github:mishibeikejie/zat-dsh-engine
國內無 VPN 時（經 gh-proxy 鏡像）¶
dsh plugin --profile web add https://gh-proxy.com/https://github.com/mishibeikejie/zat-dsh-engine.git
兩條命令安裝的是同一插件。安裝後，市場自身的搜索與安裝路徑已內置鏡像回退。
從本地 checkout 安裝¶
git clone https://github.com/mishibeikejie/zat-dsh-engine.git
dsh plugin --profile web add ./zat-dsh-engine
若你使用的 profile 不是 web（例如 headless），把命令中的 web 換成實際 profile 名。可在市場頁腳查看 Profile: 行確認。
安裝完成後重啓 dsh。
典型用法¶
- 重啓 dsh。
- 打開 Web GUI → Settings → Plugins。
- 在插件列表右側點擊 Plugin Market 標籤頁。
- 瀏覽、搜索、按分類或安裝狀態篩選，在卡片上點擊 Install。
- 再次重啓 dsh 以激活已安裝的插件。
更新¶
dsh plugin --profile web add github:mishibeikejie/zat-dsh-engine
重複執行 add 即更新到最新 commit。市場也會在檢測到自身新版本時顯示 Update 按鈕。
卸載¶
dsh plugin --profile web remove zat-dsh-engine
用對話找插件¶
在任意會話中直接描述你需要的功能，AI 會在市場中檢索並給出候選及每項的安裝前掃描結果，再決定是否安裝。
適用場景與注意¶
適合誰
- 經常在 DSH 裏試用社區插件、不想手動翻 GitHub topic 的用戶。
- 需要在一處瀏覽分類、比對版本、批量管理安裝狀態的用戶。
- 網絡環境不穩定、希望自動走代理或鏡像回退的用戶。
使用限制
- All 視圖最多顯示 1000 個插件，這是 GitHub Search API 的單次查詢上限；用搜索或分類篩選可觸達更多倉庫。
- 不能同時安裝兩個市場類插件；切換前需先卸載當前市場插件。
- 鏡像僅在直連 GitHub 失敗時用於拉取公開倉庫元數據。
安全提示
該插件本質是包管理器，需要執行 shell 命令（安裝/更新/卸載時調用 pnpm、curl 等）、讀寫 profile 文件、訪問 GitHub 與鏡像。插件以當前 dsh 進程權限運行，安裝任何社區插件前請檢查源碼與許可證。安裝前掃描會阻斷部分客觀風險，但不應替代你自己的審查。
故障恢復
若安裝某插件後 dsh 無法啓動，可從 profile 目錄的 zat-backup/ 恢復：
# macOS / Linux
cp ~/.dsh/profiles/web/zat-backup/* ~/.dsh/profiles/web/
# Windows (PowerShell)
Copy-Item "$HOME\.dsh\profiles\web\zat-backup\*" "$HOME\.dsh\profiles\web\" -Force
恢復後重新啓動 dsh。
鏈接¶
- SkillHub 目錄頁：https://www.skillhub.cn/plugins/mishibeikejie/zat-dsh-engine
- GitHub 倉庫：https://github.com/mishibeikejie/zat-dsh-engine
Zat-DSH Engine 把分散在 GitHub dsh-plugin topic 下的社區插件收進 DSH 設置頁，用可視化方式完成瀏覽、搜索、安裝與版本管理，並內置網絡回退和安裝前檢查。若你已在用 DSH 擴展能力，可以把它當作日常裝插件的入口。
