一句话定位

dshmarket 把 DeepSeek Harness 的插件安装、主题切换、备份与诊断装进了一个可视化的「应用商店」——在 DSH 设置页里点开「插件市场」就能浏览社区精选列表、点一下装好常用插件、随时换主题、把整套配置备份到本机或云端；这个副本是 Deepseek-Harness-Desktop 桌面端预打包的版本。

核心能力

• 浏览和搜索精选列表中的社区插件，支持分类筛选、最热/最新排序和中英双语描述，跟随界面语言切换（README.md:36）
• 一键安装并实时显示进度：npm 包走 npm tarball 秒级完成，GitHub 源走整仓下载；多数插件无需重启即可热加载（README.md:38 / lib/hot.js:1-17）
• 主题独立标签管理：安装立即生效、点一下切换（互斥，跨重启保留），卸载即恢复默认（README.md:38 / lib/themes.js:1-6）
• 备份与恢复 profile：本地下载 JSON、上传到 WebDAV（仅 https）、或同步到 GitHub 私有 Gist；恢复采用合并方式，写入前校验、失败自动回滚（README.md:40 / lib/backup.js:1-22）
• 逐插件检测更新（npm latest dist-tag 或 GitHub HEAD 对比），一键更新单个或全部（README.md:41）
• 自定义插件分组：把常用插件归到一组、组级别一键开关（每次仍走单插件的持久化路径）（lib/groups.js:1-11）
• 一键重启：当变更无法热加载时，在待重启提示旁提供重启按钮；仅接受同源回环请求，进程管理器托管时可关闭（README.md:43 / lib/restart.js:1-65）
• 配置文件级诊断：bundle 顺序、loader id 冲突、核心包多版本、覆盖与孤儿行等问题块，并支持「AI fix」一键复制排错提示词到剪贴板（README.md:48-49）

技术实现

• 语言: TypeScript（Node.js ESM）；客户端 UI 由 React 18 + ui-primitives 写成单文件 bundle client/client.js（client/client.js:1037 / package.json:91-93）
• 关键依赖: @deepseek-ai/cordis ^4.0.1（peerDep，宿主框架）；js-yaml ^4.1.0（解析 bundle patch YAML）；undici ^7.29.0（HTTP 客户端）；@deepseek-ai/dsh-settings ^0.1.0-rc.7（peerDep 可选，仅 dsh 0.1.0-rc.7+ 可用）
• 架构模式: 宿主 + 客户端双形态 —— 宿主侧 apply(ctx, config) 在 cordis.webServer 上挂载 /dsh-market/* HTTP 路由，客户端侧通过 cordis slots 在「设置」页注册「插件市场」section 和安装完成 toast；安装通过 node:child_process 调起 dsh plugin 子进程，主题与补丁通过 cordis 的 user patch layer + 自定义 hot mount 实现「无需重启」的活体切换；检测到宿主暴露 desktopProfiles 时走桌面端路径（用宿主自带的 desktopPnpm 而不是再 spawn 一个 pnpm，allowRestart 强制 false）（lib/index.js:26-69）
• 入口文件: 宿主入口 lib/index.js（导出 name、Config、apply）；客户端入口 client/client.js（UI 单文件 bundle）；HTTP 路由表在 lib/routes.js；cordis.patch.yml 把 id: dsh-market 的 bundle 层插入 profile 的层栈

适用场景

日常用 DSH web 或 Deepseek-Harness-Desktop 桌面端、想从社区里挑插件而不是手敲 dsh plugin add 命令的用户；想在多台机器间同步 profile、或在出问题时快速拿到「脱敏日志 + 诊断」反馈给开发者的用户；以及想把主题、功能插件归组管理、按需开关的运维型用户。在桌面端，DHH Desktop 内置的 dsh 通常可能比 npm 上拿到的旧（README.md 提到的 #139），所以桌面端用户更需要这个市场来统一更新插件。

前置依赖与兼容性

安装方式

dsh plugin --profile web add github:ChisaAlter/Deepseek-Harness-Desktop/vendor/dshmarket

配置项

市场支持两层配置：插件级（写在 profile 的 cordis patch 配置里）和环境变量级。

插件配置（在 cordis 传入 apply(ctx, config)）

环境变量

常见问题

Q: dshmarket 和 awesome-dsh-plugin.com 是什么关系？

A: 市场只显示 awesome-dsh-plugin.com/plugins.json 精选列表里的插件，安装请求只接受列表内的来源；想上架插件需要去 awesome-dsh-plugin 仓库提 PR，本仓库只读该列表。

Q: 安装后需要重启 DSH 吗？

A: 大多数纯 insert 形式的插件可以热加载（无需重启、刷新页面即可用）；含配置行/表达式的 bundle patch、纯客户端插件、或激活超过 10 秒未就绪的插件会被提示「重启后生效」，界面提供一键重启按钮。

Q: 主题和工作组件有什么不同？

A: 主题属于互斥资源，同一时间只能激活一个（装新主题自动停用旧主题，卸载即恢复），仅在「Themes」标签管理；普通插件则可独立开关并归入自定义分组。

Q: 备份能跨机器同步吗？

A: 可以。三种通道：本地 JSON 下载、WebDAV 上传/拉取（仅 https、拒绝内网地址）、GitHub 私有 Gist（需 gh CLI 已登录或 DSH_GITHUB_TOKEN 环境变量）。恢复采用合并方式——备份后装的插件会保留。

Q: 一键重启在什么情况下不可用？

A: 当 DSH 由 systemd、launchd、pm2 等进程管理器托管时，请在插件配置里设 allowRestart: false，交由管理器负责重启；市场显示待重启提示但隐藏按钮。此外重启接口只接受本机同源回环请求，无法远程触发。

Q: 市场对宿主基础插件（如 HMR、webserver）会怎么处理？

A: 这类插件被锁定禁止开关。市场会显示「属于宿主基础设施，禁止开关」，避免误关 HMR/传输/存储链导致整个宿主无法热加载。

Q: 怎么排查安装失败？

A: 页面顶部「导出日志」按钮生成一份脱敏的纯文本日志（home 路径和密钥形状已遮盖），可贴到 GitHub issue；诊断页（Diagnostics）会展示 bundle 顺序、loader id 冲突、核心包多版本、覆盖与孤儿行等问题块。

Q: Deepseek-Harness-Desktop 里这个市场和别处装的 dshmarket 是一回事吗？

A: 是同一个插件（package.json 中 name=dshmarket、插件 id dsh-market，cordis.patch.yml 把 id=dsh-market 的层注入 profile 的层栈），版本 1.14.0；只是被预打包到 Deepseek-Harness-Desktop 的 vendor/ 目录随桌面端一起分发，安装命令使用 github: 路径指向 vendor 子目录。

上手难度

入门 — 安装即用、零配置，主页三个标签覆盖了 80% 的日常需求；遇到 pnpm / 网络 / 构建脚本等具体错误时市场会用中英双语给出可操作的指引，无需查文档。

已知问题与限制

• 含 config/expression 行的 bundle patch、纯客户端插件（仅 dsh.client 无 dsh.bundle）、或激活超过 10 秒未就绪的插件只能「重启后生效」，市场会在界面给出具体原因而不是统一提示（lib/hot.js:33-38）
• 通过 link: / file: 链接安装的本地插件无法在 UI 里更新（要从 checkout 目录手动同步）
• pnpm 11 默认的 minimumReleaseAge（约 24 小时）会拦截刚发布的版本，市场会自动重试一次 --config.minimumReleaseAge=0（lib/install.js:43-79）；但若 registry latest 指向一个旧版本，「更新」按钮会拒绝把已装的精确版本降级到 @latest
• 大型 GitHub 源插件（下载整仓）在慢网下会触发 pnpm 60 秒下载超时，市场会自动用 --config.fetchTimeout=600000 重试一次，仍超时则报错（lib/install.js:43-79）
• 重启接口只接受 127.0.0.1 / ::1 同源回环请求，禁止任何代理转发头；远程重启场景不可用（lib/restart.js:40-61）
• 同一 profile 里两个插件声明了相同的 loader entry id 时安装会被拒绝并自动移除新插件（防止下次启动失败），需要单独建 profile 给这类插件
• 备份的 JSON 体积上限 2 MB、文件数上限 256；GitHub Gist 单文件上限 1 MB；超出会被拒（lib/backup.js:16-17）
• 在 macOS 通过 Finder/Dock 等图形入口启动 DSH 时，子进程拿不到终端 PATH，市场会自动补 /opt/homebrew/bin、/usr/local/bin、~/.local/bin，但极少数 PATH 完全为空的场景仍需在终端里启动
• 桌面端（DHH Desktop / Deepseek-Harness-Desktop 类）内置的 dsh 可能比 npm 上拿到的旧（README.md 提到的 #139），所以桌面端用户使用本市场更新其它插件前，可能需要先解决宿主 dsh 的版本问题

Deepseek-Harness-Desktop

DeepSeek Harness 官方 Web UI 的桌面客户端
下载安装即可使用，不用自己起 dsh web

中文 · English  ·  下载  ·  DeepSeek Harness

安装

到 Releases 下载，装完不需要本机 Node。

macOS 安装包未签名：下载后右键打开，或执行 xattr -cr /Applications/Deepseek-Harness-Desktop.app。请不要安装已撤回的 v0.2.0。

功能

• 官方界面 — 对话、工具调用、审批就是 dsh web，没有另做一套聊天页。
• Git — 标题栏切分支、提交、推送、开变更请求。
• 文件与终端 — Ctrl+\ 打开右栏（Files / Diff / Browser / Agents）；Ctrl+` 打开底栏终端，选区可送进对话。
• 模型 — 第三方思考强度、识图兜底；最新一条用户消息可改完再发。
• 外观 — 浅色 / 深色主题。壁纸在外观里选或点「浏览」打开图库（分类、搜索、收藏，确认后按窗口比例裁切）；毛玻璃和像素化也在外观里调。
• 扩展 — 设置里管理 MCP、技能和插件。市场是随应用内置的 dsh-market（dshmarket），没有独立窗口。
• 桌面 — 关闭进托盘、自动更新；Harness 挂了会回到故障页并自动重启。用户插件把启动弄挂时，启动页可以跳过它们。

Ctrl+, 打开设置。

从源码运行

需要 Windows 10+ 或 macOS 14+（Apple Silicon），Node 22.19+ / 24+，pnpm 11。

git clone https://github.com/ChisaAlter/Deepseek-Harness-Desktop.git
cd Deepseek-Harness-Desktop
npm install
npm run setup:harness
npm start

第一次 setup:harness 会构建随仓库提供的 vendor/deepseek-harness，比较慢。安装版和源码启动会互相抢锁，开发前先退出已安装的应用。

开发

改界面请改 vendor/deepseek-harness，并遵守 设计语言 和 动效。改完客户端源码后，在该目录执行 pnpm run build:lib:client 再重启桌面端。

当前官方基线写在 vendor/harness-upstream.json，现为 0.1.0-rc.8（dsh-v0.1.0-rc.8 / 141eb6fef83422698aef7a981029e843e8161534）。npx 兜底是官方 @deepseek-ai/dsh@0.1.0-rc.8，不含标题栏、Git、右栏 surfaces 和底栏终端；那些只在源码启动和安装包路径里。SQLite 会话库与 rc.7 不兼容。

npm test              # 桌面壳单测
npm run sync:harness -- --ref dsh-v0.1.0-rc.8 --sha 141eb6fef83422698aef7a981029e843e8161534
npm run dist          # Windows 安装包
npm run dist:mac      # macOS 安装包（须在 macOS 上）

推送与 package.json 一致的 v* 标签，GitHub Actions 会出 Windows 和 macOS 安装包。

交流

扫码进群。Issue 和 PR 也欢迎。感谢 Linux.do。

许可证

MIT