dsh-market/dsh-market · 上手攻略

  • 仓库：dsh-market/dsh-market
  • 链接：https://github.com/dsh-market/dsh-market
  • 分类：开发者工具 · AI Agent 生态
  • 作者：Tom
  • 更新：2026-08-21

这是什么

dsh-market 是 DeepSeek Harness（DSH）协议的可视化插件市场。简单说：你在 DeepSeek Harness 里装插件、换主题、管更新，以前要敲命令行、改配置文件，现在全部在浏览器界面里点一点搞定。

DSH 是一个本地 AI Agent 运行时（类似提前跑好的 agent loop），核心用 MIT 协议开源（deepseek-ai GitHub 组织），"Everything is a Plugin"是它的设计哲学——连 Web UI 本身都是一个插件。dsh-market 则是这个生态的 App Store，配上了一个完整的运营控制面（更新检测、热禁用、备份恢复、诊断）。

⚠️ 注意：dsh-market 本身不是 DeepSeek Harness 桌面客户端，它是一个需要装入 DSH 的插件。官方桌面客户端（dsh-desktop / deepseek-harness-desktop）内置了这个市场，开箱即用；如果用 dsh-web 手动部署，需要手动安装这个插件。

解决什么问题

DSH 的插件体系在 2026 年 8 月刚公开发布，围绕 dsh-plugin 这个 GitHub Topic 已经涌现 400+ 公开插件（含 MCP 集成、浏览器控制、工具类、Terminal UI 等）。但安装插件的过程一直是"找到 repo → 复制名字 → 终端粘贴命令 → 手动改 YAML 配置"，对非 CLI 用户不友好。

dsh-market 把这个流程变成了：打开 Settings → Plugin Market → 搜索 → 点 Install。

快速安装

前提条件

  • DSH web ≥ 0.1.0-rc.6（老版本市场自动禁用，不渲染错误 UI）
  • 已有可运行的 DSH 实例（dsh-desktop 或 dsh-web 部署均可）

安装命令（CLI）

dsh plugin --profile web add dshmarket

然后重启 DSH web，打开 Settings → Plugin Market 即可看到界面。

没有 dsh-desktop 怎么办

使用 dsh-web 部署的用户，需确认版本：

# 查看当前 dsh 版本（终端运行）
dsh --version
# 或在浏览器控制台查看 DSH 版本

版本低于 0.1.0-rc.6 需要先升级 DSH。

核心用法

1. 浏览和安装插件

打开 Plugin Market 界面后： - 用分类筛选或关键词搜索找到插件 - 插件卡片显示：截图、星级、安装量、描述（跟随 UI 语言双语显示） - 点击 Install 确认来源 → 实时显示安装进度 - 安装完成后刷新页面即可激活（大多数插件无需重启）

⚠️ 安全说明：插件来源被限制在 awesome-dsh-plugin.com 精选列表，不在列表内的插件会被拒绝安装。允许构建脚本（pnpm ≥10）需要逐个插件手动授权。

2. 主题（Themes）切换

Market 内置 Themes 标签页： - 点一下安装 → 直接生效，无需重启 - 再点一下切换另一个主题（主题互斥） - Uninstall 恢复默认皮肤 - 主题选择持久化，重启后保留

3. 更新管理

  • 单插件更新检查：每个插件旁显示 npm registry 版本 vs 当前 HEAD commit
  • 一键全部更新：一个按钮把所有插件更新到最新
  • 市场自身也可以通过同样机制更新

4. 热禁用 / 热启用

在插件列表找到对应插件： - 点击 Hot disable → 写入 disabled: true 到 cordis.patch.yml（DSH 官方 Patch 层） - DSH 在 ~1 秒内通过 HMR（热模块替换）重新合成，无需重启 - 下次启动自动恢复这个状态 - 手动编辑的 patch 行显示为 Badge；基础设施插件（host-infrastructure）受保护不可切换

⚠️ 注意：malformed patch 文件不会被进一步破坏，工具会拒绝写入有问题的配置。

5. 备份与恢复

  • Export：把当前 profile 的插件列表+配置导出为可读 JSON
  • 导入：在另一台机器导入相同 JSON，配置自动合并（备份后新装的插件不会被覆盖）
  • WebDAV 自动备份：支持同步到私有 WebDAV（仅 https，拒绝私网目标，密码不存储在浏览器）
  • GitHub Gist 同步：可把备份存到私有 Gist

6. 诊断工具（Diagnostics）

  • 查看所有已加载插件的完整依赖链和版本冲突
  • 显示：重复 loader 条目、多版本核心包、invalid config
  • 问题块高亮，可折叠
  • 拖拽调整加载顺序：可按插件自身声明的 before/after 规则自动排序；写入前会预演，告诉你"这个顺序会引发哪些 override 或重复项"

7. AI Fix（一键修复）

点击 AI Fix 按钮，工具把诊断报告（错误/警告/顺序冲突）+ 保守范围指令复制到剪贴板，粘贴进新对话窗口，由 AI 决定是否发送修复指令。

典型适用场景

场景 说明
DSH 桌面用户 开箱即用，无需任何配置
CLI 用户想 GUI 管理 Settings → Plugin Market 全覆盖
主题定制 社区 Themes 页，一键换肤
插件控 更新检查、批量更新、热禁用，完整的运营界面
插件开发者 Diagnostics 查依赖冲突，AI Fix 获取修复建议

坑与注意

  1. 版本门槛：Requires dsh web ≥ 0.1.0-rc.6，老版本市场静默禁用不报错。如果 Plugin Market 选项根本没出现，先升级 DSH。

  2. bundled dsh 可能更老：dsh-desktop 等桌面打包版本自带的 DSH 可能比 npm 最新版旧，需要单独升级 npm 包（Issue #139 已记录）。

  3. 重启按钮的 systemd 边界：当 DSH 以 systemd service 方式运行且是 unit 主进程时，重启按钮自动隐藏（否则会杀死 cgroup 导致服务无法恢复）。pm2 / launchd 用户需要在 Settings 里手动关闭 Allow restart。

  4. 备份含凭证：导出 JSON 前会有警告，数据包含 profile 配置，WebDAV 传输强制 https。

  5. 构建脚本风险：默认阻止构建脚本（pnpm ≥10 触发），CLI 类插件安装前会显示警告，逐个授权。

  6. 插件生态快速迭代：DSH 2026-08-13 刚公开发布，README 明确警告 breaking changes 即将到来，插件兼容性可能随 core 版本变化。

  7. 无 Token/成本显示：DSH 本身截至 2026-08 尚无每轮 Token 消耗显示，社区有成本追踪插件填补了这个空白，但属于第三方方案。

与同类对比

方案 安装方式 UI 生态规模 适用用户
dsh-market（本案） 内置 GUI + CLI 完整可视化市场 400+ 插件，1550+ 可安装 想要 GUI 的所有人
dsh-plugin-hub 配置文件手动编辑 无 同一生态 CLI 熟手
直接 npm install 终端手动安装 无 同一生态 开发者
MCP Server（其他生态） 各家自有一套 各家自有一套 更广但跨生态 跨平台用户

dsh-market 的核心优势是把 DSH 插件的完整生命周期（装/卸/更/禁用/备份/诊断）全放进一个 UI，不需要记住任何命令。

一句话推荐结论

如果你是 DSH（DeepSeek Harness）用户，装上 dsh-market 等于给 AI Agent 运行时装上了 App Store——从找插件到管插件全程点点点，再也不用和 YAML 配置文件打交道。