chnjames/dsh-plugin-market

DSH 插件市场

在 DeepSeek Harness「设置 → 插件」里发现、确认并安装社区插件；另有公开目录站供浏览与复制安装命令。

License: MIT
Website
CI

设置 → 插件 → 插件市场

公开浏览：https://dsh-plugin-market.vercel.app

功能

- 设置内「插件市场」Tab：搜索、分类、展开说明、确认后安装 / 卸载
- 安装走官方 dsh plugin add/remove，不执行第三方安装脚本
- 公开目录站：浏览、⌘K 搜索、中英 / 亮暗主题、复制安装命令
- 对话 Agent 工具：搜索、详情、安装、列出已装插件

安装

dsh plugin --profile web add github:chnjames/dsh-plugin-market
或
npx @deepseek-ai/dsh plugin --profile web add github:chnjames/dsh-plugin-market

安装后重启 dsh web，打开 设置 → 插件 → 插件市场。

Web profile 通常关闭配置热重载；改完插件后请重启再强刷页面。

使用

设置内卡片：

1. 标题行：名称 · 星标 · 展开
2. 简介（最多两行）
3. 底栏：已安装 / 作者 / 提示 · 查看仓库 · 安装（安装前确认）

卸载本市场插件：

dsh plugin --profile web remove dsh-plugin-market

公开目录站

线上目录：https://dsh-plugin-market.vercel.app

- 首页：安装命令终端、热门 / 分类 / 最近更新
- 分类页：排序、分页（?sort= / ?page=）
- 详情页：复制 dsh plugin add、README 摘要
- 顶栏：⌘K / Ctrl+K、中英、亮暗主题

本站只浏览与复制命令；真正安装在本机 DSH 设置里完成。
本地开发与 Vercel 部署见 website/README.md；设计约束见 website/design.md。

配置

常用项（写入 cordis.patch.yml 中本插件的 config）：

| 键 | 说明 |
|---|---|
| install.dshCommand | npx 用户设为 "npx @deepseek-ai/dsh" |
| catalog.urls | 自定义 registry.json 地址（自建域名时） |
| catalog.fallbackToSearch | 目录全失败时是否回退本机 GitHub / npm 搜索 |
| ui.showRiskLevel | 是否显示外观类 / 高权限等启发式提示 |

完整默认块见 cordis.yml。

完整配置示例

- insert:
- id: plugin-market
name: dsh-plugin-market
config:
catalog:
fallbackToSearch: true
urls: ["https://your-domain/registry.json"]
sources:
github:
enabled: true
topic: "dsh-plugin"
npm:
enabled: true
keyword: "dsh-plugin"
cache:
ttl: 21600
autoRefresh: true
refreshInterval: 21600
ui:
showRiskLevel: true
install:
defaultProfile: "web"
confirmBeforeInstall: true
dshCommand: "npx @deepseek-ai/dsh"

Agent 工具

需插件已加载：

| 工具 | 用途 |
|---|---|
| plugin_market_search | 按关键词搜索目录 |
| plugin_market_detail | 查看单条插件详情 |
| plugin_market_install | 经官方 CLI 安装（带确认策略） |
| plugin_market_list_installed | 列出本机已装插件 |

安全

- 目录只含公开元数据，不上传用户信息；目录不构成推荐
- 安装走官方 dsh plugin add/remove，确认后才调用；不执行第三方安装脚本
- 设置 Tab 用 React 文本节点渲染摘要，不 dangerouslySetInnerHTML
- permissionLevel 是文案启发式，默认「未评估」，不是权限审计；只安装你信任的来源

故障排除

| 现象 | 处理 |
|---|---|
| 设置里没有「插件市场」Tab | 确认 package.json 的 dsh.client.immediately；重启 DSH；检查 lib/client.js 是否已构建 |
| 列表为空 | 等同步；或 npm run build:registry 后提交 website/public/registry.json；检查 catalog.urls |
| 安装失败（Windows） | 确认调用的是 dsh.cmd / npx.cmd；npx 用户设 install.dshCommand |
| 日志仍出现 Web UI running at :3789 | 旧 profile 残留 ui.webPort：从 cordis.patch.yml 删掉并重启（本机已不再提供独立 HTTP 面板） |

手动挂载：若 dsh plugin add 未自动写入 patch，把仓库里的 cordis.yml 追加到 /profiles/web/cordis.patch.yml。

本地 file: 挂载（路径按本机调整）：

dsh plugin --profile web add file:C:/path/to/dsh-plugin-market

本地目录缓存：/plugin-market.db（删除后下次启动会重新拉目录）。

架构

GitHub Actions ──► registry.json ──► Vercel 网站（浏览 / CORS）
└──► DSH host（sql.js 缓存 + Typert Remote）
└──► 设置 → 插件 → 插件市场（本机安装）

| 层 | 说明 |
|---|---|
| Host | PluginMarketService（服务名 pluginMarket）；安装 Remote 方法为 installPlugin（不能叫 install） |
| Client | 设置 Tab（settings.plugins.tab）；经嵌套 inject 调用 remote.pluginMarket |
| 分类 / 风险 | src/utils/classifier.ts 与 shared/classifier.mjs 须保持同步 |
| README 摘要 | Host 截断下发；UI 再摘成可读段落（设置 Tab 不做完整 Markdown 渲染） |

本机拉取目录顺序：Vercel → jsDelivr → GitHub raw → 包内 lib/registry.snapshot.json →（可选）本机搜索。

开发

npm install
npm run build          # tsc + 复制 client + registry snapshot
npm run typecheck
npm run build:registry # 生成 website/public/registry.json

cd website && npm install && npm run dev   # http://localhost:3000

CI：.github/workflows/ci.yml（构建）、registry.yml（定时刷新目录）。

自测清单

重启 DSH 后：

- [ ] 设置 → 插件 出现「插件市场」Tab（在「插件配置」「插件列表」之后）
- [ ] 列表来自 catalog（Network 可见 registry.json，而非 GitHub Search）
- [ ] 搜索、分类可用；展开说明为摘要段落，完整 README 链到仓库
- [ ] 多数卡片无风险标签；主题类可显示「外观类」；明确高权限关键词才显示「高权限提示」
- [ ] 安装 / 卸载先确认，确认后 dsh plugin list 可见变化
- [ ] 「同步目录」会重新拉 registry；日志无 :3789
- [ ] 公开站 cd website && npm run build 成功；复制命令与 /registry.json CORS 正常
- [ ] Agent：搜索 / 列出已装插件工具可走通

已知限制

- 无单元测试；Client 与 Host 的 README 摘要实现可能漂移
- 约四成插件仍落在分类 other（关键词启发式）
- 无版本更新检测（需卸了再装）
- 本机缓存需「同步目录」或重启后才吃到新风险分数

文档

| 文档 | 内容 |
|---|---|
| website/README.md | 公开站本地开发与 Vercel |
| website/design.md | 公开站设计系统 |
| cordis.yml | 插件默认配置 |

许可证

MIT