用 dsh-store 在 DeepSeek Harness 里浏览并一键安装插件

前言

DeepSeek Harness(dsh)是 DeepSeek 开源的智能体运行时,核心设计是「一切皆插件」:模型、工具、沙箱、会话存储、界面,甚至智能体循环本身,都可以用插件拼装。官方仓库目前仍处于 developer preview,兼容性可能随时变化。项目地址:https://github.com/deepseek-ai/deepseek-harness

预览版上线后,社区插件增长很快。GitHub 上 dsh-plugin topic、npm 关键词、各类 awesome 列表同时出现,质量参差不齐:有的包只是蹭了关键词,有的仓库没有 dsh 清单字段,装上去才会报错。自己到 npm 搜、对照 README、再手敲 dsh plugin add,对日常使用并不方便。

dsh-store 做的事情比较直接:把一份经过质量校验的插件目录嵌进 dsh 的 Web UI,浏览、搜索、安装、卸载、停用和更新都在同一套界面里完成。它由 huguangyu666 维护,采用 MIT 许可证,社区目录把它归在「界面增强」。需要先说清楚:本文依据的社区插件目录(https://deepseek-harness-plugin.com/zh-CN/plugins/)是独立站点,与 DeepSeek / 幻方没有官方从属关系,dsh-store 也不是官方应用商店。

这是什么

dsh-store 是跑在 dsh Web 界面里的插件商店。npm 上当前版本是 0.5.2(2026-08-16 发布),包名就是 dsh-store,要求 Node.js >=22.5package.json 里声明了 dsh.client.platformweb,也就是面向 Web UI,而不是无界面的 headless 进程。

截至 2026-08-18,GitHub 仓库 https://github.com/huguangyu666/dsh-store 与目录详情页均显示 4 颗星。目录页收录日期为 2026-08-15,最近一次推送为 2026-08-16。

它要解决的问题可以分成两层:

  1. 找得到:把 npm registry(keywords:dsh-plugin)、awesome-dsh-plugin 精选、GitHub topic:dsh-plugin 星标,以及 AdamPlatin123 自动雷达的运行级验证状态合并成一份目录。
  2. 装得上:安装走官方 dsh plugin add/remove,写到 dsh.profile.bundles 这一层,失败再回退 pnpm add 加 patch 合并。README 强调:目录里带 npm 条目的插件应当能真正装上,而不是一份只能跳转仓库的列表。

关于收录数量,几处文案并不完全一致,需要按来源分开看,不要混成一个「官方总数」:

  • 仓库 README 的功能说明、目录页「更多介绍」写的是四源合并后 750+ 插件。
  • package.json、npm 简介、目录页「关于这个插件」仍写 550+ 插件、11 个分类。
  • awesome 精选一侧,README 给出的数字是 324 个、11 分类;雷达一侧写的是 194+ 条目。

这些数字会随目录刷新变化,以商店页面实际加载为准。

核心功能

仓库 README 和目录页对能力的描述可以对上,当前版本主要有下面几块。

聚合目录与徽章。 搜索走 npm 的 keywords:dsh-plugin;分类和「精选」徽章来自 awesome-dsh-plugin;星标、仓库、更新时间来自 GitHub topic 搜索;雷达验证通过的条目会打「雷达验证」徽章。未上 npm 的精选插件不提供一键安装,卡片上给出 GitHub 跳转。

质量过滤。 后台会请求每个包的 npm /latest,检查 package.json 是否带 dsh 字段(真插件标记),没有该字段的会剔除。验证结果缓存 7 天。README 给过一组实测口径:关键词搜索大约 250 个包,过滤后剩 222 个。npm 搜索本身会混入蹭关键词的包,这一步是为了把噪声挡在目录外面。

安装与卸载。 界面上的「安装」调用官方 dsh plugin add,自动 reconcile dsh.profile.bundles;「卸载」走 dsh plugin remove,并清理 patch 残留。官方路径失败时回退 pnpm add 加 patch 合并。已安装识别会合并三处来源:bundles、dependencies、patch。

已安装管理与更新。 0.5.0 起支持对已安装插件「停用 / 启用」,写入 cordis.patch.ymldisabled,走 HMR,不必重启。顶部有「检查更新」,可列出可更新项并一键更新。装完需要重启的改动,页面提供「立即重启」。

入口与命令。 客户端在侧边栏页脚注册「插件商店」按钮,在设置页注册同名分区,点击打开 /plugin-store。另外注册两条命令:

  • /plugin-store:输出商店地址、已收录数量、已安装列表和热门摘要
  • /plugin-install <包名>:按包名直接安装,例如 /plugin-install dsh-plugin-notify

详情与缓存。 点击卡片可看描述、分类、README 摘要(本地优先,npm 兜底)和仓库链接。目录缓存 24 小时,写在 ~/.dsh/plugin-store/catalog.json,页面上的「刷新目录」会强制更新。

安装与启用

目录详情页给出的安装命令如下,在 DeepSeek Harness 终端里运行即可:

dsh plugin add github:huguangyu666/dsh-store

如需可复现安装,目录页建议固定 commit 哈希(把 commit 换成仓库里的实际哈希):

dsh plugin add github:huguangyu666/dsh-store#commit

README 还提供了带 profile 的写法,默认目标 profile 是 web

dsh plugin --profile web add dsh-store

装完后重启对应 profile。官方 Web UI 默认地址是 http://127.0.0.1:3080,商店页面路径是 /plugin-store,也就是:

http://<dsh地址>:<端口>/plugin-store

重启后,侧边栏应出现「插件商店」入口,设置页也会多一个同名分区。

README 里还有一条 npm i dsh-plugin-store。npm 上实际包名是 dsh-store,这条命令与 package.json 不一致,安装时以目录页的 dsh plugin add github:huguangyu666/dsh-store 为准,不要照抄那条 npm 命令。

插件以当前 dsh 进程的权限运行,安装时可能执行代码。安装前请检查源代码仓库和许可证。

典型用法

下面的步骤来自仓库 README 和源码里的页面 / 命令注册,可以按顺序试一遍。

1. 浏览目录

打开 /plugin-store。页面支持搜索、按分类筛选,以及按星标、最新、名称排序。卡片上会显示精选徽章、描述、作者、版本和星标。未上 npm 的精选条目只能跳 GitHub,不要期望点「安装」就能装上。

2. 安装一个插件

在卡片上点「安装」。商店会走官方 dsh plugin add。成功后点「立即重启」,新插件才会进入当前进程。

也可以在对话里直接安装:

/plugin-install dsh-plugin-notify

源码里的提示文案写明:该命令会改 cordis.patch.yml,装完需要重启 dsh 才生效。包名换成目录里真实存在的 npm 名称即可。

3. 停用、启用、卸载

已安装的插件会显示「停用 / 启用」。这一步只写 patch 的 disabled,HMR 实时生效,不必重启。卸载则走 dsh plugin remove,并清理 patch 残留。

4. 检查更新

点顶部「检查更新」,列出可更新项后再一键更新。更新后的生效方式以页面提示为准,需要重启时再用「立即重启」。

5. 国内访问 GitHub 时配代理

星标和部分仓库信息走 GitHub API。拉不到时目录仍可用(源码会打警告后继续),但星标可能为空。可在 ~/.dsh/plugin-store/config.json 写代理和目标 profile:

{
  "proxy": "http://127.0.0.1:7892",
  "profile": "web"
}

环境变量可以覆盖同名字段:

  • DSH_PLUGIN_STORE_PROXY:覆盖 proxy
  • DSH_PLUGIN_STORE_PROFILE:覆盖 profile

代理地址换成本机实际端口。proxy 示例里的 7892 只是 README 给的样例,不是固定端口。

6. 看商店摘要

/plugin-store

无参数时返回商店 URL、已收录数量、已安装列表,以及按星标排序的前几条摘要。

适用场景与注意事项

比较适合这几类人:已经在用 dsh web、希望在界面里找插件而不是自己拼 GitHub topic;需要区分「精选 / 雷达验证 / 仅 GitHub」三种条目;想用官方 dsh plugin add/remove 而不是手改 patch。

使用前注意下面几点。

权限与安全。 插件以当前 dsh 进程权限运行,能读本地文件、用已配置的凭证、访问网络。目录收录和「精选」徽章都不是安全审计。安装前应打开 GitHub 仓库看源码和许可证。dsh-store 自身是 MIT,版权声明为 Copyright (c) 2026 huguangyu666。

平台限制。 package.json 声明客户端只注入 Web 平台。headless 或不跑 Web UI 的 profile,侧边栏入口和 /plugin-store 页面都不会按文档出现。

目录不是全量镜像。 源码里 npm 搜索 size=250,GitHub topic 搜索 per_page=100。awesome 与雷达是额外叠加,不是把全网插件一次性拉完。GitHub API 失败时目录仍可用来自 npm / awesome 的条目,只是星标可能缺失。

不要把它当成官方商店。 DeepSeek Harness 官方仓库只提供插件机制和 dsh plugin add 命令。社区里还有 dsh-market、plugin-hub、workshop 等同类项目。dsh-store README 用对比表强调自己以 npm 为权威源、并用 dsh 字段做后台验证,这是作者自己的定位,不是官方评测。

版本仍在快迭代。 仓库 2026-08-14 才创建,到 0.5.2 已修过商店空白页、停用缩进等缺陷。dsh 本体也还在 developer preview。装完如果页面空白或安装失败,先看仓库 CHANGELOG 和 Issues,再决定是否固定某个 commit。

小结

dsh-store 把 npm、awesome 精选、GitHub 星标和雷达验证收进 dsh Web UI,用官方 dsh plugin add/remove 做安装卸载,并补上停用、更新和 README 摘要。对已经跑着 Web UI、不想自己维护一份插件清单的人,它能把「搜得到」和「装得上」放在同一页里。

目录页:https://deepseek-harness-plugin.com/zh-CN/plugins/dsh-store/

GitHub:https://github.com/huguangyu666/dsh-store

npm:https://www.npmjs.com/package/dsh-store

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜