前言¶
DeepSeek Harness(DSH)的生态靠社区插件扩展能力,插件条目分散在 GitHub 主题与社区目录里。若只在仓库里翻 README,或依赖英文为主的入口,找插件、看说明、对照安装命令往往要来回切换。社区里另有 dshmarket 等市场类插件;本项目在 DSH 内单独提供 「中文市场」 Tab,与「插件市场」命名区分,避免两个入口混淆。
下面介绍维护者 YML0823 开源的 dsh-local-market:从 awesome-dsh-plugin 拉取目录,支持中文检索、分类筛选、界面预览,并在本机调用 dsh plugin 一键安装。它可作为 DSH 插件嵌入客户端,也可独立网页运行。项目为 MIT 许可,当前 package 版本为 1.0.3;GitHub 星标数为 1。这是独立社区界面,不是 DeepSeek 或幻方官方应用商店。
这是什么¶
dsh-local-market 是给 DeepSeek Harness 用的中文插件市场前端与 Host:运行时读取社区目录 https://awesome-dsh-plugin.com/plugins.json,规范化后供 UI 展示;安装时只使用目录里登记好的 spec,不托管插件包本身。
结构上分两块:
- Host 插件(
plugin/index.js):在 DSH 的 webServer 上挂载/dsh-local-market/,提供静态页、实时目录 API、截图代理和安装 API。 - Client 插件(
plugin/client.js):向plugins.tab注册「中文市场」,用 iframe 打开市场页面。
运行时会读取本机 DSH_HOME、profile 和 dsh CLI,不包含作者机器上的路径或账号。
核心功能¶
实时目录¶
- 页面加载时从上游拉取最新目录,每 10 分钟自动同步;顶栏「同步」可手动刷新。
- 缓存 10 分钟,避免每次打开都重新下载。
- 网络不可用时回退到仓库内快照
public/data/plugins.json。 - 上游条目含中文说明、截图、安装参数、Star 与下载量等。
独立版若上游不可访问,可设置镜像:
$env:CATALOG_LIVE_URL="https://your-mirror.example/plugins.json"
node server.js
DSH 插件版默认用代码里的上游地址;需要镜像时可改 plugin/index.js 中的 LIVE_URL。
中文检索与筛选¶
- 按插件名、作者、中文说明、分类和能力搜索,支持中英文关键词。
- 23 个能力分类;支持「有界面图 / npm / GitHub / 已安装」等快速筛选与排序。
界面预览¶
展示作者提供的截图;无截图时用分类插画封面,详情页支持多图放大。截图经本地 /api/image 代理并按 URL 缓存,浏览器不直接访问截图主机。
一键安装与状态¶
点击安装后,Host 会:
- 按条目 id 在当前目录查出精确安装 spec,不接受任意用户输入;
- 校验 profile 名称与 spec 格式;
- 以当前用户权限运行本机
dshCLI; - 通过 SSE 把 stdout/stderr 实时推回页面;
- 成功后记入「已安装」。
目录中的安装参数示例形式为:
dsh plugin --profile web add dsh-meme
dsh plugin --profile web add github:owner/repo
dsh plugin --profile web add "https://github.com/.../release.tgz"
安装前页面会展示作者、仓库、npm 包、版本、权限声明与第三方代码提示。已安装状态读取当前 DSH profile 的真实依赖;在 DSH 别处安装的插件约 5 秒内同步到「已安装」。UI 支持桌面、平板、手机。
安装与启用¶
从 GitHub 安装¶
把 <profile> 换成你的 DSH profile(例如 web 或 desktop):
dsh plugin --profile <profile> add github:YML0823/dsh-local-market
安装后重启一次 DSH(或按提示重载)。打开左侧 插件,顶栏会出现:
已安装 中文市场 插件市场 发现
点击 中文市场 即可使用;在 已安装 里也可启停 dsh-local-market 本体。
从本地 tarball 安装¶
已发布版本见 GitHub Releases · v1.0.3:
dsh plugin --profile web add "file:F:/path/to/dsh-local-market-1.0.3.tgz"
自行构建 tarball:
node scripts/build-plugin.js
产物在 dist/dsh-local-market-1.0.3.tgz。
典型用法:独立网页版¶
需要 Node.js 20+,无需安装 npm 依赖。独立版与 DSH 插件版共用同一套 UI、目录和安装 API,区别只在入口。
cd dsh-plugin-market
node server.js
浏览器打开:
http://127.0.0.1:7788
Windows 也可双击 start.cmd。独立版默认只监听 127.0.0.1。
开发相关命令(来自 README):
node scripts/build-data.js
node scripts/build-plugin.js
node server.js
scripts/build-data.js 默认读 vendor/plugins.json,也可用环境变量 CATALOG_SOURCE 指定路径;运行时 Host 会自动拉取最新目录,不必每次手动生成快照。
适用场景与注意¶
适合谁:希望在 DSH 客户端里用中文检索社区插件、看截图再安装的智能体开发者;或想在本地浏览器单独逛目录、同样走本机 dsh 安装的人。
Desktop profile:DSH Desktop 的 desktop profile 由桌面应用管理,命令行安装可能被拒绝或安装后不出现。可优先用 设置 → 插件 安装,或把 profile 选为 web 供 dsh web / 命令行使用。安装后通常需刷新页面,部分插件需重启 DSH。
安全与隐私:插件是第三方代码,以你的本机权限运行;市场只做索引和调用,不做安全审计。安装前请到 GitHub 确认作者、来源与权限声明。安装接口只接受目录中存在的条目。项目源码不包含作者主机的绝对路径、凭据或 profile 目录。
数据与归属:目录主题来自 github.com/topics/dsh-plugin,社区目录为 awesome-dsh-plugin.com,运行宿主为 DeepSeek Harness。
结尾¶
dsh-local-market 把 awesome-dsh-plugin 社区目录搬进 DSH 的「中文市场」Tab:实时同步、中文搜索、截图预览与本机 CLI 安装日志,减少在仓库与命令行之间来回找 spec 的成本。