前言¶
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，实现了插件安装的自动化与可视化。对于需要频繁管理或测试第三方插件的开发者，它提供了比手动配置更高效、更规范的解决方案。
