前言¶
DeepSeek Harness（简称 DSH）把「一切皆插件」贯彻得很彻底：界面、能力、甚至桌面壳子，都可以靠插件拼装。社区里插件数量涨得很快，光是 GitHub 上带 dsh-plugin 话题的仓库就已经很可观。问题在于，对多数用户来说，装插件仍停留在「翻文档、抄命令、碰运气」——不知道装什么、不知道命令怎么写、装完还要自己重启和排错。
dsh-market（npm 包名 dshmarket）想解决的就是这件事：把社区插件目录搬进 DSH Web 界面，像逛应用商店一样浏览、搜索、一键安装。它在 GitHub 上已获得约 2200+ star（截至 2026 年 8 月），是客户端类插件里关注度最高的一批之一。本文基于 SkillHub 目录页 与 官方 GitHub 仓库 核实后整理，供你在本地 Harness 里试用。
需要事先说明：DSH 的社区插件目录（包括 SkillHub、awesome-dsh-plugin 等站点）由社区维护，与 DeepSeek / 幻方并无官方从属关系；目录收录也不等于官方背书，安装前仍应自行审阅源码与许可证。
这是什么¶
dsh-market 由维护者 dsh-market 开源，许可证为 MIT。一句话定位：装在 DeepSeek Harness Web 端里的可视化插件市场——打开设置里的「插件市场」，即可逛社区目录、看截图与 star、点一下确认来源后完成安装。
它本身也是一个 DSH 插件，面向 web profile 注入客户端 UI，数据实时从 awesome-dsh-plugin.com/plugins.json 拉取（精选条目、npm 映射、star 数由 CI 每日刷新）。官方刻意不做本地过期快照兜底：目录每天都在增长，过期的列表会把「今早刚发布的插件」显示成不存在，这比「勉强能看」更误导人。
核心功能与亮点¶
逛与搜：完整社区目录¶
市场展示的是 awesome-dsh-plugin 精选 registry 对应的完整社区目录，规模在 1550+ 插件且仍在增长。支持分类筛选、按 star 或更新时间排序，插件描述会跟随界面语言在中英文之间切换。每张卡片可展示 App Store 风格的截图轮播；作者在 registry 里策展过的截图会直接出现在卡片上，没有策展的则在打开安装弹窗时尝试从 README 自动抽取（图片仅从 GitHub 图床加载）。
一键安装、更新与卸载¶
确认安装来源后，界面会显示实时进度。安装策略上优先走经仓库验证的 npm 包，其次尝试作者提供的 GitHub Release 预构建 tarball，最后才回退到整仓源码下载——预构建路径通常几秒完成，且不必在本地跑构建脚本。多数插件装完后 刷新页面即可生效，无需重启整个 Harness。
市场还提供逐插件更新检测（对比 npm 版本或锁定的 commit 与远端 HEAD）、一键全部更新，以及带两步确认的卸载；本次会话内安装的插件支持即点即卸。
主题页：装完即换肤¶
除插件外，市场有独立的 主题 标签页。社区主题装完立即生效，点一下即可切换（主题互斥，选择会跨重启保留），卸载则恢复默认外观。
备份、恢复与跨机同步¶
可把当前 profile 的插件清单与配置导出为可读的 JSON，在另一台机器导入；也支持存到 WebDAV 并每日自动备份，或通过私有 GitHub Gist 同步。恢复采用 合并 策略——备份之后新装的插件会保留；写入前校验，失败自动回滚。需注意：备份里可能含有 profile 配置中的密钥，导出前界面会明确提醒。
热禁用 / 启用与诊断¶
开关会向 profile 的 cordis.patch.yml 写入 disabled: true|false，借助 DSH 的 HMR 约在 1 秒内重新组合，一般无需重启。另有 诊断 页集中展示插件加载顺序、bundle 栈、重复 loader 条目、依赖版本冲突、非法配置等；还可拖拽调整社区 bundle 顺序，或采用按 before/after 规则推导的建议顺序，落盘前会先跑组合校验。
市场还提供 AI 修复：把诊断结果生成保守范围的修复 prompt 复制到剪贴板，由你在新对话里自行决定是否发给 Agent——若 Agent 恰好就是当前 Harness，prompt 会禁止它直接改动运行中组合，而是要求生成外部终端可执行的 apply / rollback 脚本。
其它实用细节¶
- 缺 pnpm 等组件时，市场会检测并尝试一键自动安装，尽量不让用户碰命令行。
- 导出日志 一键生成脱敏文本，便于提 issue；版本号显示在页面标题旁，截图反馈时自带版本信息。
- dsh 0.1.0-rc.7 及以上，可在「设置 → 插件 → 插件配置」里管理市场自身：查看版本、选择稳定 / Beta / 开发版更新通道（仅影响市场本身）、更新或移除。
安装与启用¶
官方 README 与 npm 包 dshmarket 给出的安装方式为：
dsh plugin --profile web add dshmarket
安装完成后 重启 dsh web，在浏览器打开 Harness，进入 设置 → 插件市场。
版本要求：需要 dsh web 0.1.0-rc.6 或更新。 若宿主过旧，市场会自我禁用并在浏览器控制台说明原因——设置里若根本看不到「插件市场」入口，多半是这个原因。部分桌面端内置的 dsh 可能比 npm 直接安装的更旧，需要留意。
若你习惯从 GitHub 固定版本安装，可参考 DSH 通用的 profile 安装写法（具体 commit 以你信任的发布为准）：
dsh plugin --profile web add github:dsh-market/dsh-market
典型用法示例¶
在界面里安装一个社区插件¶
- 按上文命令装好
dshmarket并重启dsh web。 - 打开 设置 → 插件市场，用分类或搜索找到目标插件（例如 README 中提到的视觉插件 modlens）。
- 查看卡片上的描述、star 与截图，点击安装并在弹窗中 确认来源。
- 等待进度条走完，按提示 刷新页面；多数插件此时即可使用。
若要在命令行直接安装 modlens（不经过市场 UI），README 给出的示例为：
dsh plugin --profile web add @liustack/modlens
网络无法访问 registry 时改镜像¶
若本机访问不了 awesome-dsh-plugin.com，可在启动 dsh 的环境里指定镜像地址（需返回相同结构的 plugins.json）：
DSHM_REGISTRY_URL=https://your-mirror.example/plugins.json dsh web
在 systemd 等服务环境下关闭一键重启¶
市场的一键重启仅接受本机同源、直连环回地址的请求。当本进程是 systemd unit 主进程时，重启按钮会自动隐藏，以免误杀服务。若使用 pm2、launchd 等未自动识别的部署方式，可在 profile 补丁中显式关闭（必须写在 config: 子对象下）：
- id: dsh-market
name: dshmarket
config:
allowRestart: false
适用场景与注意事项¶
适合谁用：
- 已经在跑 DSH Web（
dsh web），想图形化探索社区插件、少记命令的用户。 - 需要在多台机器之间 同步插件清单与配置 的开发者。
- 插件装多了之后需要 诊断加载顺序、依赖冲突 的场景。
注意事项：
- 权限与安全：插件以当前 dsh 进程的权限运行。市场只允许安装 awesome-dsh-plugin 精选列表内的来源，其它来源会被拒绝；构建脚本默认禁止执行（pnpm ≥10），放行须按包显式选择。终端 / CLI 类插件在装进 web profile 前会有提醒。收录 ≠ 背书，请只安装你信任的作者与仓库。
- 安装前审阅：建议打开 GitHub 仓库阅读 README、许可证与近期 issue，再点安装。
- 宿主版本：市场依赖较新的 dsh web 客户端原语；桌面发行版若捆绑旧版 dsh，可能出现入口缺失或功能降级。
- 备份敏感信息：导出 JSON 或同步 WebDAV 时，profile 里的 API Key 等可能一并带出，按界面警告操作。
- 上架自己的插件：dsh-market 仓库是市场应用本身，不是插件目录。要让插件出现在市场里，应向 awesome-dsh-plugin 提 PR 增加 registry 条目，站点与市场通常会在一天内同步收录。
结尾¶
社区插件生态越繁荣，「发现与安装」的体验就越值得单独做成一个插件——dsh-market 走的就是这条路：把目录、进度条、诊断和备份收进一个界面，让 DSH 的「万物皆插件」对普通用户也更可操作。
- 目录页（SkillHub）：https://www.skillhub.cn/plugins/dsh-market/dsh-market
- GitHub：https://github.com/dsh-market/dsh-market
- 项目主页：https://dshmarket.com
- npm：https://www.npmjs.com/package/dshmarket
若你已在用 DSH Web，可以先执行 dsh plugin --profile web add dshmarket，重启后进设置看一眼插件市场——往往比翻十几个仓库 README 找安装命令省事得多。
