前言¶
DeepSeek Harness(DSH)的核心理念是“一切皆插件”。在开发过程中,管理第三方插件需要手动在终端执行安装命令,或者从外部目录复制粘贴,缺乏统一的入口。99galaxy/dsh-plugin-market 解决了这个问题,它是一个 DSH bundle,在设置面板中新增了“DSH 插件市场”一节,提供目录浏览、状态管理和一键安装的能力。
核心功能¶
这个插件市场连接了维护在 awesome-dsh-plugin 的官方目录,提供以下能力:
- 浏览与安装:在设置面板内直接浏览插件目录,点击“安装”按钮即可执行官方安装命令。
- 筛选与排序:支持按分类筛选,以及按 Star 数、下载量、名称或收录时间进行排序。
- 状态管理:提供三个标签页。全部插件显示完整目录;已安装列出当前 profile 已安装的插件;可更新列出目录中有新版本可升级的插件。
- 中英切换:插件简介支持中文/英文实时切换。
- 本地缓存:目录数据缓存于本地,1 小时内复用;如需最新数据,可点击“强制重新获取”。
- 降级策略:在获取目录时,采用四级降级机制(官方域名 → 镜像 → CDN → npm),确保可用性。
安装与启用¶
这是一个 DSH bundle,安装后需重启 DSH 才能自动加载。
首先,进入你的 profile 目录(默认为 ~/.dsh/profiles/web),使用 pnpm 安装包:
cd ~/.dsh/profiles/web
pnpm add github:99galaxy/dsh-plugin-market
安装完成后,必须将该包名显式声明在 package.json 的 dsh.profile.bundles 列表中,DSH 才会识别并加载它:
{
"dsh": {
"profile": {
"bundles": ["...", "@99galaxy/dsh-plugin-market"]
}
}
}
保存文件并重启 DSH。
使用步骤¶
- 打开 DSH 设置面板,找到“DSH 插件市场”一节。
- 在“全部插件”标签页浏览或搜索,点击卡片右侧的“安装”按钮。
- 安装完成后重启 DSH,插件才会生效。
- 在“已安装”标签页确认安装状态,在“可更新”标签页处理版本升级。
注意事项¶
- 包名识别:虽然仓库名为
99galaxy/dsh-plugin-market,但在package.json中声明时必须使用 scope 包名@99galaxy/dsh-plugin-market。 - 更新行为:点击“更新”执行的是目录中记录的官方安装命令,这可能导致插件来源变更(例如从 GitHub 安装变为从 npm 安装)。如果需要锁定特定来源,不建议点击更新。
- 安装限制:目录中列出的安装命令,其包名不能以
-开头,否则会被拒绝执行。 - 接口安全:HTTP 接口要求同源调用(校验
Sec-Fetch-Site与Origin)以及Content-Type: application/json,以确保安全。