dsh-unified-market — 统一插件市场（Unified Plugin Market for DeepSeek Harness）

一个市场，三个数据源：精选目录 + GitHub dsh-plugin 生态 + npm registry。对 DSH Desktop（EAC）针对性适配，开箱即用的插件安装 / 更新 / 自动更新 / 管理。

在设置页 设置 → 插件 → 🛒 统一市场 提供一站式体验：三源切换、分类下拉筛选、已下载插件更新面板（一键全部更新 / 逐个更新 / 自动更新三档开关）、更新进度窗口、市场自身自更新。

整合自哪三个插件

本项目把三个社区插件市场的能力合并为单一市场，三者分别是：

来源插件	定位	本市场吸收的能力
dsh-webui-market（精选目录市场）	awesome-dsh-plugin.com 精选目录	🎯 精选目录 + 离线快照兜底（`data/catalog-snapshot.json`）、来源白名单 + 试装验证（trial boot）：安装前在临时环境实际启动一次、只认 `dsh web:` 就绪行才放行、真实 profile 从未被写过、安装前快照可回滚、简单插件热挂载免重启、安装前冲突预检、`allowBuilds` 自动放行、第三方本地构建产物保留
zat-dsh-engine（GitHub 生态市场）	GitHub `dsh-plugin` topic 检索 + 中文简介 + 国内镜像	🐙 GitHub 生态实时检索（按星排序、分页）、中文简介（README.zh.md 摘要）、gh-proxy / ghfast 双镜像抓取兜底（无 VPN 也能访问 GitHub）
dsh-plugin-marketplace（npm 市场，DSH Desktop 配套）	npm registry 检索 dsh 插件	📦 npm registry 检索（keywords:dsh-plugin）、更新检测（版本对照、TTL 缓存）、更新失败回滚、全部更新

三方定位与 “对 EAC 特化” 的联系：旧三个市场在 DSH Desktop（EAC）桌面壳里交错存在，各有失效面（profile 解析错误、重复注册、更新链路不完整），本项目把它们整合为一个对桌面壳正确的统一入口。

对 EAC 的针对性适配

EAC（DeepSeek Harness Desktop）的 Web UI 跑在桌面专属 profile web-desktop （由主进程通过 DSH_DESKTOP_PROFILE 注入）。旧市场中：

zat-dsh-engine 只认 DSH_PROFILE、否则回落选 web；
dsh-plugin-marketplace 写死 web；

→ 它们在桌面壳里检测/修复/安装的实际对象是另一套 profile（这就是“在 EAC 里是摆设”的根因）。本市场所有读写统一解析为：

DSH_DESKTOP_PROFILE → DSH_PROFILE → web（独立安装时回退）

另针对桌面壳做了这批适配：

profile / 同步层
- 全部读写走桌面壳真实 profile（desktopProfile() + resolveProfile() 归一化）。
- 内置插件清单（.dsh-builtin-plugins.json）识别：内置插件不进入市场检测/更新，由官方「内置插件更新」统一维护，避免与 syncCompanionPlugins 冲突。
- 市场自身作为内置插件（COMPANION_PLUGINS 注册 unified-market），上游发布后走官方 PLUGIN_UPDATE_SOURCES 自更新。
安装 / 更新链路
- 试装验证、冲突预检、来源白名单、安装前快照、热挂载（源自 dsh-webui-market）。
- Windows 文件锁（服务运行中 pnpm 写 node_modules）：任务自动排队（.dsh-market-pending.json），并在「Web 服务启动早期」由本市场 host 自动消费；同时修复主进程排队消费对 kind:"update" 任务的遗漏。
- 本地链接（link:/file: 指向开发目录）插件也能更新：从上游接管安装，更新前先删除 junction/符号链接（Windows pnpm 替换 symlink 会 EPERM），失败自动回滚恢复原链接；本地开发目录原样保留。
- 24h 发布保护期：上游新版本发布不足 24h（pnpm minimumReleaseAge）时不显示 “可更新”，避免“可见不可装”。
- pnpm allowBuilds 拦截自动放行并重试。
自动更新 / 自更新
- 后台自动检测（启动 20s 后首检 + 每 6 小时），三档：关闭 / 仅提示 / 自动升级；状态持久化在 <profile>/.dsh-unified-market.json。
- 市场自身自更新接口（selfUpdate）+ 官方内置插件更新引擎对接。

功能一览

三源切换：🎯 精选目录 / 🐙 GitHub dsh-plugin 生态 / 📦 npm，各自搜索、排序、分页；精选目录分类用下拉框筛选（含“全部 / 已安装”）。
安装：内置标记拦截 → 冲突预检（refuse 拒装）→ 来源白名单 → 试装验证 → 安装前快照 → pnpm allowBuilds 放行 → 本地构建产物保留 → 简单插件热挂载免重启。
已下载插件更新面板：只列可更新的插件；每项 当前版本 → 最新版本 + 单个「更新」按钮；顶部「⬆ 全部更新 (N)」一键批量；「检查更新」强制重查。
更新进度窗口：后台批量更新实时进度（第 x/y 个、成功/排队/失败计数、最近输出）；失败或排队时窗口保留显示原因（✕ 手动关闭），不再自动消失。
自动更新三档：关闭 / 仅提示（默认）/ 自动升级。
本地链接插件：也检测上游更新（GitHub repo / npm 名推断 → 市场按名匹配，可从上游接管安装或保留链接在本地更新。
市场自更新：上游发布后由官方「内置插件更新」自动/手动升级。

安装

方式一：DSH Desktop（EAC）内置分发（推荐）

把本包放入 assets/plugins/dsh-unified-market/，并在桌面壳 main.js：

COMPANION_PLUGINS 增加：

{ id: 'unified-market', name: 'dsh-unified-market', dir: 'dsh-unified-market' }

（可选）移除旧 dsh-market-plugin（dsh-webui-market）与 zat-market（zat-dsh-engine）条目。
重新启动应用，syncCompanionPlugins 会把包同步进 web-desktop profile 并挂载。

方式二：独立安装（非内置、脱壳）

dsh plugin --profile web-desktop add dsh-unified-market
# 或 GitHub 源：
dsh plugin --profile web-desktop add github:jing-hy/dsh-unified-market

安装后 重启 Web 服务，在 设置 → 插件 → 🛒 统一市场 使用。

市场自更新（内置分发时启用）

在 main.js 的 PLUGIN_UPDATE_SOURCES 启用：

'unified-market': { npm: 'dsh-unified-market' },

之后由官方「内置插件更新」（启动 20s 后 + 每 6 小时检测、可开自动更新）负责更新到覆盖层并重启服务生效；独立安装时市场的 selfUpdate 接口同样对比 npm 版本。

目录结构

dsh-unified-market/
├── package.json            # dsh.bundle.patch / dsh.client 声明 + 发布元信息
├── cordis.patch.yml        # host 半边挂载声明
├── lib/
│   ├── host.js             # host 半边（ESM）：HTTP 路由 /api/dsh-unified-market
│   ├── client.js           # 浏览器半边：设置页「统一市场」tab
│   ├── allow-builds.mjs    # pnpm allowBuilds 拦截自动放行
│   ├── artifact-keep.mjs   # 第三方本地构建产物保留
│   └── plugin-conflict-scan.mjs  # 安装前冲突预检
├── data/catalog-snapshot.json    # 精选目录离线快照（官网不可达时兜底）
├── README.md
└── LICENSE

通信：client 通过 POST /api/dsh-unified-market（兼容 /api/dsh-market）调用 host。 host 半边运行在 dsh web 进程（Cordis plugin，注入 webServer）。

版本记录

0.2.0（2026）：三源合一 + EAC 适配（web-desktop profile、文件锁排队与启动消费、 link→上游接管、24h 保护期、更新进度窗口）。
0.2.1（2026）：修复 README 编码（去除 BOM / 修正 mojibake）。

发布

npm：npm publish（包名 dsh-unified-market，已发布 0.2.1）。
GitHub：github.com/jing-hy/dsh-unified-market（main 分支）。

License

MIT（见 LICENSE）。离线目录快照数据来自 awesome-dsh-plugin.com 社区目录，版权归各自作者；三方整合能力分别源自对应插件的 MIT/开源许可。

dsh-unified-market

Install

README