前言¶
DeepSeek Harness（DSH）采用“一切皆插件”的架构。社区存在多个插件市场（精选目录、GitHub、npm），但它们分散且对 DSH Desktop（EAC）存在兼容性问题，例如错误的 Profile 识别（web-desktop 对比 web）。dsh-unified-market 将这三个来源合并为一个单一入口，并专门解决了 EAC Profile 适配问题，提供一站式的安装、更新和管理体验。
核心功能¶
该插件整合了以下能力：
- 三源聚合：合并精选目录（awesome-dsh-plugin）、GitHub dsh-plugin 生态和 npm registry。支持分类筛选、搜索与分页。
- 安装安全机制：安装前进行冲突预检与来源白名单校验；支持试装验证（在临时环境启动插件）；提供安装前快照与热挂载功能，实现简单插件的免重启安装。
- 更新管理：提供已下载插件的更新面板，支持一键全部更新、逐个更新以及自动更新（后台检测）。更新进度窗口会保留失败或排队原因，不再自动消失。
- 功能包管理：支持
.dshpack功能包的安装、卸载、更新、导出与回滚。 - Profile 适配与同步：
- 适配：统一解析为
DSH_DESKTOP_PROFILE→DSH_PROFILE→web，修复旧市场在 EAC 中识别错误的根因。 - 同步：采用 CAS 校验与原子写入，实现配置的双边同步（保留外部手动修改、防止整文件重写丢失变更）。
- 适配：统一解析为
- 本地开发支持：支持
link:/file:指向本地开发目录的插件更新。
安装与启用¶
方式一：命令行安装
dsh plugin --profile web-desktop add dsh-unified-market
或者直接从 GitHub 源安装：
dsh plugin --profile web-desktop add github:jing-hy/dsh-unified-market
安装后重启 Web 服务，进入 设置 → 插件 → 🛒 统一市场 即可使用。
典型用法¶
- 市场浏览与安装：在市场页面切换来源（精选目录、GitHub、npm），使用下拉框筛选分类或“已安装”状态，点击插件进行安装。
- 功能包管理：切换到 「📦 功能包」 tab，选择本地
.dshpack文件进行导入安装，或浏览功能包市场进行一键安装（支持 SHA-256 校验）。 - 批量更新：在已下载插件更新面板中，点击顶部 「⬆ 全部更新 (N)」 批量升级，或逐个点击更新按钮。点击 「检查更新」 强制刷新版本列表。
环境与兼容性¶
- Node.js 版本：需要 Node.js >= 18.18。
- 推荐运行环境：DSH Desktop（EAC）5.1 或 dsh 0.1.1-rc.2。
- 功能包逻辑：功能包的核心逻辑在 L2（
dsh-desktop框架层），本插件仅做交互编排与配置管理。 - 依赖变量：功能包管理依赖环境变量
DSH_DESKTOP_RESOURCE_ROOT。 - 更新保护：上游新版本发布不足 24 小时不会显示“可更新”状态。
结语¶
dsh-unified-market 旨在解决 DSH 生态中插件分发分散、EAC 适配不一致的问题，通过统一入口和精细化的配置管理，为桌面端用户提供更稳定、可控的插件使用体验。
