前言¶
DeepSeek Harness(DSH)采用「一切皆插件」的设计理念,插件来源分散在 npm 注册表和 GitHub 仓库中,查找和选择合适插件的过程较为依赖搜索。dsh-plugin-market 插件在 DSH 内部增加了「Market」页面,通过自动发现、展示和模型审查,简化了插件的发现与决策流程。
插件介绍¶
这是 DeepSeek Harness 的一个内置插件,由 duxingxiake3 维护。
核心价值:
1. 自动发现:从 npm registry 和 GitHub 自动发现 DSH 插件。
2. 可视化展示:显示插件的功能描述和作者提供的截图。
3. 安全审查:在安装任何插件前,会通过模型对插件进行审查。
核心功能¶
- Market 页面:在 DSH 客户端中增加一个专门的插件市场入口。
- 信息聚合:展示插件名称、开发者、许可证、主页以及摘要信息。
- 预安装审查:在用户批准安装前,利用模型对插件内容进行风险评估。
- 安装后管理:插件安装完成后,由内置的 Plugins 页面统一负责启用、配置和卸载,Market 页面仅提供链接跳转。
安装与启用¶
插件支持通过 DSH 界面、命令行或手动配置三种方式安装。
1. 通过 DSH 界面安装¶
- 打开 Plugins → Add plugin。
- 输入包名
dsh-plugin-market并批准安装。
2. 通过命令行或链接安装¶
在 Add plugin 界面直接输入以下内容:
dsh-plugin-market
或指向仓库(适用于未发布 npm 包的情况):
github:duxingxiake3/dsh-plugin-market
3. 手动安装¶
在用户配置的 package.json 中添加依赖和插件入口:
{
"dsh": { "profile": { "bundles": ["…", "dsh-plugin-market"] } },
"dependencies": { "dsh-plugin-market": "link:/path/to/dsh-plugin-market" }
}
配置完成后需要重启 DSH。
访问方式¶
安装完成后,可以通过以下任一方式打开插件市场:
* 侧边栏中的 Plugin Market 图标(位于内置 Plugins 按钮旁)。
* Settings → Built-in plugins → Market 标签页。
插件作者指南¶
插件作者无需额外操作即可在市场中被自动发现,但为了展示效果,需遵循特定的目录结构。
目录结构¶
在插件仓库根目录下创建 dsh-market 文件夹,并将展示内容放入其中:
your-plugin/
├─ package.json # "icon" 字段指向此文件夹内的 logo
├─ README.md
└─ dsh-market/
├─ market.json # 描述、开发者、截图列表
├─ logo.svg # 插件图标
└─ screenshots/ # 截图目录
├─ dashboard.png
└─ settings.png
字段说明¶
market.json:包含displayName(显示名称)、summary(摘要)、description(描述)、homepage、license以及screenshots数组。logo.svg:用于 Market 列表中的图标。package.json:icon字段用于 Plugins 页面,指向./dsh-market/logo.svg。
路径规则(重要)¶
package.json中的路径是相对于package.json文件的,用于本地文件解析。market.json中的路径(如logo或screenshots[].url)是相对于仓库根目录的,用于从 GitHub 读取。- Package 相对路径(如
./dsh-market/logo.svg)在market.json中不能作为仓库路径使用,会导致 404 错误并回退到默认图标。
注意事项¶
- 重启要求:手动安装后必须重启 DSH。
- 自动重载:DSH 运行时,浏览器组件会自动重载,无需手动刷新。
- 截图域名限制:
market.json中的截图 URL 仅允许指向允许的主机(如raw.githubusercontent.com等),拒绝其他域名以保护用户隐私。 - 权限运行:插件以当前 DSH 进程的权限运行,安装前建议检查源码与许可证。