前言¶
DeepSeek Harness 的核心理念是“一切皆插件”。在現有的工作流中，獲取插件通常需要依賴官方目錄或進行繁瑣的手動配置。dsh-github-installer 解決了這一痛點，它允許開發者通過粘貼 GitHub 倉庫網址、npm 包名或 GitLab/Gitee 地址，直接完成插件的安裝、卸載與更新，遵循標準的 dsh plugin add github:… 協議。
是什麼¶
dsh-github-installer 是一個由 yhPrime 維護的聯網工具插件。它基於 dsh-std Community v0.15 標準組件構建，旨在簡化插件的分發與管理流程。通過該插件，用戶可以繞過複雜的依賴配置，直接從主流代碼託管平臺獲取插件。
安裝與啓用¶
使用前需確保已安裝適配器，安裝後需重啓 DSH 生效。
- 安裝適配器（標準協議運行時）：
dsh plugin --profile web add @dsh-std/adapter-dsh
- 安裝本插件：
dsh plugin --profile web add github:yhPrime/dsh-github-installer
- 重啓 DSH，設置 → 插件 → 標準組件 清單中會出現本組件，設置頁側欄會出現“插件安裝”頁面。
核心功能¶
- 多源安裝支持：支持從 GitHub、npm、GitLab、Gitee 等來源安裝。
- 形態自動識別：安裝後自動讀取包內聲明，識別安裝形態（bundle/宿主補丁、std/標準組件、普通依賴）。
- 雙重交互模式：
- 設置頁 UI：集成在設置中，通過免會話同源 HTTP API 與宿主交互。
- 對話工具：提供
manage_plugin工具，支持在對話中操作。
典型用法¶
對話工具¶
通過 manage_plugin 工具執行操作，target 可爲倉庫網址、包名或插件包名。
# 安裝
install https://github.com/owner/repo
install github:owner/repo#path:/subdir
install dshmarket
install https://gitlab.com/group/repo
# 卸載與更新
uninstall dsh-some-plugin
update dsh-some-plugin
# 查詢
status
標準命令¶
支持以下標準命令，可在對話或自動化腳本中使用。
/ghp-install <target>
/ghp-uninstall <name>
/ghp-update <name>
/ghp-list
/ghp-list-full [force]
/ghp-status
/ghp-cancel
注意事項¶
- 依賴與重啓：安裝前需先安裝適配器
@dsh-std/adapter-dsh；安裝後必須重啓 DSH 才能生效。 - 受保護包：
@deepseek-ai/*、@dsh-std/*、dshmarket及本插件自身屬於受保護包，不可卸載。 - 網絡與權限：插件需要聯網訪問；插件以當前 DSH 進程權限運行，安裝前請檢查源碼與許可證。
總結¶
dsh-github-installer 通過標準協議和免會話 HTTP API，實現了插件安裝的自動化與可視化。對於需要頻繁管理或測試第三方插件的開發者，它提供了比手動配置更高效、更規範的解決方案。
