JasperGuWP/dsh-plugin-market

dsh-plugin-market

一个 DeepSeek Harness 插件，用来浏览
deepseek-harness 插件库 —— 所有打上 GitHub 主题标签
dsh-plugin 的公开仓库 —— 并以「排名卡片列表」的形式呈现。

每张卡片包含：

- 缩略图 —— 仓库所属者的头像（avatar），
- 介绍 —— 仓库描述（description），
- 星标 —— stargazers_count，
- 排名 —— 按星标数降序的名次，
- 更新日期 —— 最近一次推送（pushed_at）。

交付内容

dsh-plugin-market 是一个双面（node + browser）的 bundle：

1. Web 停靠面板「插件技能库」（browser 半边，client.js）。聊天输入框上方的入口展开管理器：
已安装（内置 / 自制 / 社区插件 + 已安装 Skill 包——启用/停用热切换、更新、卸载）、
插件库（主题搜索、分类、安装预检（含 monorepo 子包发现）、一键安装、一键重启），以及
技能库（GitHub 技能主题搜索 + SKILL.md 检测，支持单技能与集合仓库，直接装入 skills 根目录、
实时生效免重启）。
2. 面向模型的工具 browse_dsh_plugins（node 半边，index.js）。同一份榜单给 agent 用，
经 Conversation Node 渲染为卡片网格。
3. 设置页「重启 Web」分区：一键重启 Web 服务，以及 deepseek-harness 本体自更新
（git pull + 安装依赖 + 构建，带实时日志）。

安装

先把插件打成 tarball，再把这个 tarball 装进 profile：

cd dsh-plugin-market
pnpm pack                              # -> dsh-plugin-market-0.1.0.tgz

在 deepseek-harness 源码目录
pnpm dsh plugin --profile web add ../dsh-plugin-market/dsh-plugin-market-0.1.0.tgz

要装 tarball，不要装目录。dsh plugin add ./dsh-plugin-market（直接给目录）会登记成
link: 依赖，Node 会从被链接目录的真实路径去解析插件内 @deepseek-ai/dsh-tools 的
import，而不是从 profile 的 node_modules —— 会报 ERR_MODULE_NOT_FOUND。tarball 会把
文件装进 profile 的 node_modules，harness 自身的包才能正常解析。

pnpm 会对 @deepseek-ai/dsh-tools 打印一个 peer dependency 警告，这是正常的 ——
由 harness 自身提供（autoInstallPeers 关闭），且 profile 里已经存在。

校验层级已合成，然后重启 Web profile：

pnpm dsh --profile web --dump-config | grep -A2 dsh-plugin-market
pnpm dsh web

需要重启正在运行的服务：node 半边（宿主插件）不支持热加载；browser 半边在合成时已加入
dsh.client 名单，同样在下一次启动时生效。

使用

例如对 agent 说：

用 browse_dsh_plugins 列出前 20 个 DSH 插件。

工具参数：

| 参数     | 类型   | 默认值    | 含义                                                              |
| -------- | ------ | --------- | ----------------------------------------------------------------- |
| limit  | number | 25      | 返回多少个插件（限制在 1–100）。                              |
| sort   | string | stars   | stars（按星标排名）或 updated（按最近推送）。                 |
| filter | string | related | related（默认）或 all，见下方「噪音过滤」。                   |

噪音过滤

dsh-plugin 主题含噪：很多仓库只是为了曝光而自标该标签，并非真正的 DeepSeek Harness
插件。默认（filter: "related"）只保留 名称或描述 —— 或其其它主题 —— 提及
deepseek、dsh 或 harness（不区分大小写）的仓库。传入 filter: "all" 可列出全部标签仓库。

GitHub 速率限制与可选 token

零配置即可用：未鉴权请求限额为核心接口（预检、SKILL.md 树扫描等）60 次/小时、
搜索接口 10 次/分钟。在此之上，插件还带 1 小时持久磁盘缓存
（~/.dsh/.cache/dsh-plugin-market.json，技能搜索与 SKILL.md 检测结果，重启不丢），日常浏览
基本不碰 API；面板上的「刷新」按钮可按需绕过缓存。

重度用户可把核心额度提到 5000 次/小时：在启动前设置自己的 GitHub token。仅用于公开仓库
只读的 token 无需勾选任何权限（classic PAT 全部不勾，或 fine-grained PAT 选
"Public Repositories (read-only)"）：

Windows（对新进程持久生效）
setx DSH_PLUGIN_MARKET_GITHUB_TOKEN ghp_xxx

macOS / Linux（当前 shell；写入 profile 可持久）
export DSH_PLUGIN_MARKET_GITHUB_TOKEN=ghp_xxx

插件会在发起请求时读取它，并作为 Bearer token 发送。

切勿把 token 提交进仓库或打进安装包：GitHub 会扫描公开仓库并自动吊销泄露的 token，
而且所有安装者会共享、烧光同一个账号的额度。每位用户用自己的 token、设自己的环境变量。
已装 GitHub CLI 的话，gh auth login 后用 gh auth token
即可拿到现成可用的 token。

工作原理

- node 半边通过 ctx.tools.register(...) 将工具注册到全局层，因此每个 agent（包括由
agent preset 组合出来的 web 会话）都能经由工具 scope 链看到它。
- 拉取目标是一个固定的公开 API
（https://api.github.com/search/repositories?q=topic:dsh-plugin&sort=stars），自带超时与取消。
- 工具返回单一规范 JSON 值，并把同一份列表投影进 output.presentationMeta
（{ kind: 'dsh-plugin-market', plugins, … }）。该投影持久化在 tool/result 事件上。
- browser 半边注册一个 ConversationNodeDefinition，匹配这些 tool/result 事件并渲染缩略图
网格 —— 可回放、无需额外持久化事件类型。

说明与限制

- 仅列出标记 dsh-plugin 主题的公开仓库（GitHub 搜索范围）。
- updatedAt 取 pushed_at（最近一次提交推送），而非元数据变更时间。
- 缩略图是 GitHub 所属者头像；主题/搜索 API 中仓库没有独立缩略图字段。

License

MIT