dsh-market/README.zh.md

dsh-market

English | 中文

装在 DeepSeek Harness 里的插件市场。打开设置 → 插件市场 → 逛一逛，点一下，装好。

主题一键换：装完即生效，点一下切换，不用重启。

安装

dsh plugin --profile web add dshmarket

重启 dsh web，打开 设置 → 插件市场。

需要 dsh web 0.1.0-rc.6 或更新版本。 宿主太旧时市场会自我禁用，并在浏览器 控制台说明原因，而不是拿缺失的原语去渲染——如果设置里根本没出现「插件市场」这 一项，通常就是这个原因。桌面端要留意：它可能内置了比 npm 装到的更旧的 dsh（#139）。

你会得到

• 逛与搜——完整社区目录（4200+ 插件，每天在涨），分类筛选、star 数、最热/最新排序，中英描述跟随界面语言
• 按宿主发现——卡片展示插件通过 engines.dsh 或同版本线 @deepseek-ai/dsh-* peer 声明的 DSH 要求；可选筛选只隐藏与当前宿主明确不匹配的插件。未声明、格式异常、暂时取不到清单及仅 GitHub 发布的条目仍保持可见，不猜成不兼容
• 截图展示——App Store 式截图，多图自动轮播，点开还能看大图；作者在 registry 里策展的截图列表卡片就直接显示（零额外请求），没有策展的插件则在打开安装弹窗时自动从 README 抽取；图片仅从 GitHub 图床加载
• 评论——每张卡片都能就地打开该插件的讨论。它和插件在 dshmarket.com 与目录站上的页面共用同一条讨论，一个插件只有一处对话，而不是三处。底层是 GitHub Discussions（经由 giscus）：打开即加载，只有发表评论才需要 GitHub 账号；说明里也直说打开会连接 giscus.app 与 GitHub。本地 dsh web 继续内嵌评论供阅读，登录和发表则通过专用 GitHub 入口在新标签页打开当前插件的精确讨论，不让跨站回跳携带或依赖宿主会话
• 收藏——在「发现」或「主题」页点书签即可收藏插件/主题；「收藏」Tab 集中展示，支持搜索、排序与安装。书签写入 profile 的市场状态（state.json）；已下架条目可一键清除
• 分组——把已安装插件整理进具名分组（可重命名、删除，分组内单独搜索）；一个插件属于一个分组，默认是「未分组」。它只用于整理，面板上写明了这一点，不改变任何启用状态。分组本身是 profile state.json 里的本地状态
• 备注——给任何已安装插件写一行你自己的说明，它会在这行代替作者简介显示——四十个插件的列表因此能用你自己的话回答「我当初为什么装它」。和分组、收藏一样只存在本地，不上传
• 主题——独立主题页：装完立即生效，点一下切换（主题互斥、选择跨重启保留），卸载即恢复
• 一键安装——确认来源，实时进度；多数插件刷新页面即可用，无需重启
• 备份与恢复——把 profile 的插件清单与配置导出为可读 JSON，换机导入，存到 WebDAV 并每日自动备份，或通过私有 GitHub Gist 跨机器同步；恢复采用合并方式（备份之后新装的插件会保留），写入前校验、失败自动回滚
• 更新——逐插件检测（npm 版本或锁定 commit 对比 HEAD），一键更新或全部更新；市场自己也走同一通道升级。每个有待更新的行上都有「更新内容」链接——有版本说明就是版本说明，对不上版本时给提交记录。暂时不处理的提醒可以本次不再提醒（本次 = 当前宿主进程），重启后提醒会回来——「忽略」永远不等于「关闭」
• GitHub 多线路容错——中国大陆下载区域会为 Git ref、README 与头像分别维护 fallback 顺序，记住上次可用线路，只在传输、HTTP 状态或响应内容校验失败后换线，并拒绝公共反代伪装成 HTTP 200 的 HTML 错误页。内置线路全部失效时，可到设置 → 插件 → 插件配置 → GitHub 加速填写一个持久化的自定义 HTTPS 前缀；运维设置的 DSHM_GITHUB_PROXY 始终优先
• 公共更新接口——插件自己的设置页可调用带版本号、能力探测和回滚状态的更新 API v1（beta），无需复制包管理逻辑，也不依赖市场 UI 的私有响应字段
• 卸载——两步确认防误触；本次会话装的插件即点即卸
• 热禁用 / 启用——开关会往 profile 的 cordis.patch.yml（官方补丁层，机制移植自 dsh-plugin-hub）写入 - id: … + disabled: true|false：DSH 的 HMR 约 1 秒内重新组合，无需重启，loader 每次启动都会重新应用这个选择；手工改过的补丁行会显示成徽标，宿主基础设施插件禁止开关，补丁文件格式不对时绝不会被写得更糟
• 按需重启——无法热加载的变更会在待重启提示旁显示一键重启；操作仅接受本机同源请求
• 重启没起来时的恢复——DSH 的启动是全有全无：一个插件加载失败，整个进程就退出，市场自己的界面也随宿主一起消失。现在这个失败提示处多了一个 调整插件：DSH 点名的插件会标红并默认取消勾选，你自己选下次启动要启用哪些，选择写进市场开关用的同一套 cordis.patch.yml 停用行（停用载体还会同步 dsh.profile.bundles），然后自动重试启动。这个恢复界面由脱离终端的重启助手在同一个地址上提供——页面原本就在轮询它，所以宿主已经没了也照样能打开；直接访问地址则会渲染同一份内容的独立页面。DSH 正常启动时，这一切都不会出现
• 零术语——缺组件（pnpm）时市场自己发现、一键自动装好，全程不见命令行
• 导出日志——一键生成脱敏纯文本日志方便反馈（home 路径与密钥形状已打码；任何数据都不会被上传）。市场版本号就在标题旁边，截图反馈时自带版本信息
• 设置卡片——dsh 0.1.0-rc.7 起，市场在 设置 → 插件 → 插件配置 里管理它自己，和其它插件并排：看当前版本、选择更新通道（稳定版，或 Beta 抢先试用还在验证中的版本——只影响市场自己，不影响你装的其它插件；打开开发者模式后还会多出「开发版」通道，直接取开发分支上的构建）、更新、或者移除市场。移除时可勾选一并清理——包括市场写进补丁层的停用行，被它关掉的插件会恢复运行，而不是保持停用却再没有界面能打开它们
• 诊断——插件加载顺序与冲突一页看全：bundle 栈（官方/社区徽标）、重复的 loader 条目、依赖版本不一致、核心包多版本共存、覆盖项与非法配置条目，以及残留目录——更新被打断后留下的、缺少 package.json 的包目录，和 pnpm 自己的 *_tmp_* 暂存目录。它们都不妨碍启动，所以只列出来而不报成警告，也是唯一会说清磁盘上到底有什么的地方。术语说人话，问题块高亮，全部可折叠
• 加载顺序——拖拽调整社区 bundle 的顺序，或直接采用按插件自身 before/after 规则推导出的建议顺序。写入前先跑一次静态组合校验，通过才落盘；应用之前面板会告诉你这个顺序会改变什么（多少处覆盖、多少无效或重复条目）
• AI 修复——一键把诊断结果生成的修复 prompt（错误/警告/顺序冲突 + 保守的改动范围约束）复制到剪贴板，你粘进新对话，自己决定发不发。提示词会先让 Agent 判断自己是不是就是这个 profile 所在的 harness——若是，则严禁改动运行中组合、升级/重启 harness 或核心包、重装依赖，而是让它生成一份幂等的 apply 修改脚本和一份 rollback 回滚脚本，由你在外部终端执行并把输出拷回给它

速度

安装依次优先使用经仓库验证的 npm 包、作者提供的 GitHub Release 预构建 tarball，最后才回退到整仓 GitHub 源码下载。预构建安装通常只需数秒且无需执行本地构建脚本；仅提供源码的插件仍取决于你到 GitHub 的网络。

安全

• 只允许安装 awesome-dsh-plugin 精选列表内的来源,其它一律拒绝

• 构建脚本默认禁止执行（pnpm ≥10）,放行与否由你按包显式决定

• 终端/命令行类插件装进网页版前会被明确提醒

• 安装接口只接受同源 POST;市场不会向任何地方上报数据

• 备份可能包含 profile 配置里的密钥——导出与上传前 UI 会明确提醒;WebDAV 同步仅限 https、拒绝内网地址,且密码永不落盘浏览器

• 带鉴权的 Gist 请求始终直连 api.github.com，Bearer token 不会交给公共 GitHub 加速服务；GitHub 源码归档也保持 canonical codeload URL，以保留 pnpm 的完整性校验边界

• 重启接口还要求客户端直接来自环回地址（拒绝代理转发请求），并使用原入口、参数、环境和工作目录重新启动 DSH

• 一键重启会启动脱离终端的替代进程。当本进程就是 systemd 服务的主进程时，按钮会自动隐藏——否则市场重启会连带杀掉 cgroup 里的接管进程，服务起不来，待重启提示会说明原因。判定要求「systemd 标记」和「本进程是该 unit 的主进程」同时成立：INVOCATION_ID 会被 unit 的所有后代继承（包括普通终端），只看它会误伤一大批本来能正常重启的机器。pm2 和 launchd 不做检测，这类部署需要下面的显式配置。两种做法：在设置 → 插件 → 插件配置里关掉「允许重启」，或者写进 profile 补丁——注意必须嵌在 config: 下面，因为 loader 只把这个子对象传给插件，写在顶层会静默失效（#227，感谢 @Fantasymax）：

  - id: dsh-market
    name: dshmarket
    config:
      allowRestart: false   # 不要和 `name:` 并排写在顶层
  

  dsh 0.1.7 及更新版本上没有这个开关可关：宿主改为从插件自己的 Config schema 派生设置，不再为插件注册的设置命名空间提供服务，市场在那里没有可用的控件。用下面的 profile patch，它在所有宿主上都有效。

  生效后 GET /dsh-market/status 会返回 "restart": false。

• 需要本地编译的插件（原生模块）会在 dsh 进程继承到的环境里构建——而图形界面、systemd/launchd 托管、Windows 开始菜单启动的 dsh 不会继承你终端的环境。如果插件需要的编译器比机器默认的新（比如系统 g++ 太老，但其它工作又依赖这个版本，不能全局升级），就用 config: 下的 buildEnv 固定编译期环境变量——相当于在终端里 CC=... CXX=... dsh，且不动任何全局配置。固定的值可以覆盖继承来的环境变量，但绝不会覆盖市场为子进程算好的 PATH 和 CI（issue #336）：

  - id: dsh-market
    name: dshmarket
    config:
      buildEnv:
        CC: /usr/bin/gcc-11     # 也可以是 CXX、NODE_OPTIONS 等
        CXX: /usr/bin/g++-11
  

  界面上也可以在设置 → 插件 → 插件配置 → dshmarket → 编译环境变量里直接改（每行一个 KEY=value；保存后下一次安装即生效，留空保存则回到上面的 profile 配置）。无论在哪里配，PATH 和 CI 都由市场接管，不能覆盖。

• 从终端启动时，替代进程脱离原终端，关闭原终端后仍会继续运行

• 收录 ≠ 背书:插件是第三方代码,请只安装你信任的来源

提交你的插件

这个仓库是市场应用本身，不是插件目录。 市场里的插件列表来自精选列表 awesome-dsh-plugin——想让你的插件上架，请去那边提 PR（在列表里加一条即可，站点和本市场会自动收录，通常一天内生效）。请不要往本仓库提插件条目。

路线图与反馈

• Bug 提 issue，附上市场页面的「导出日志」能让排查快十倍
• 功能建议放 Roadmap。issues 只留「坏掉的东西」，所以提成 issue 的建议会被移到那边并关闭；讨论仍留在你写的地方
• 路线图上的每一项都欢迎社区 PR——动手前在对应条目里说一声，免得两个人重复造

数据源

每次打开都实时请求 awesome-dsh-plugin.com/plugins.json——精选条目、npm 映射、star 数由 CI 每日刷新，不使用过期缓存兜底；连不上时会给出具体原因和耗时，并提供「重试」按钮。

刻意不做本地快照兜底：目录每天都在增长，过期的答案不是「差一点」而是「错的」——今早刚发布的插件会显示成「不存在」。

中国大陆下载区域优先从 npm 读同一份目录，走的是插件自己也在走的那套区域感知线路：国内镜像本来就带着它、下载落在镜像而不是绕回源站，而且它有版本号——一份有问题的目录构建可以回滚，而不是只能往前修。源站仍作为「一直能用的那条」排在最后。区域判断只做一次并记住结果，可在设置 → 插件 → 插件配置里改。

如果你的网络访问不了这个域名，可以改指到镜像：在 dsh 运行的环境里设置 DSHM_REGISTRY_URL，指向任何提供相同 plugins.json 结构的地址：

DSHM_REGISTRY_URL=https://your-mirror.example/plugins.json dsh web

友情链接

DSH Desktop（dataelement）

dsh-desktop——DeepSeek Harness 桌面客户端：无需自装 Node.js 即可运行和管理本地 Harness，并默认预置本插件市场。dshdesktop.com

DeepSeek Harness Desktop（hairyf）

deepseek-harness-desktop——基于 Tauri（Rust + Web）构建的 DeepSeek Harness 原生桌面客户端：一键本地安装并启动，无需自装 Node.js；首次启动可选择安装本插件市场作为推荐插件。

DeepSeek Harness Desktop（anywhere-labs）

deepseek-harness-desktop——基于 Electron 的 DeepSeek Harness 桌面客户端，理念是「万物皆插件，桌面本身也是插件」：支持 profile 切换、内置 Node 与 pnpm，安装前会先给 profile 拍快照以便回滚。dshdesktop.cn

DSH App

dsh-app——基于 Tauri 2（而非 Electron）的 DeepSeek Harness 桌面客户端，因此安装包小得多，界面走系统 webview。AGPL-3.0。

Local DSH

local-dsh——可以把模型跑在本机的 DeepSeek Harness 桌面客户端：发行包内置 llama.cpp 与 Node、pnpm、DSH，下载一个 GGUF 模型就能对话，不必接外部 API。基于 Tauri 构建；目前支持 Apple 芯片的 Mac。localdsh.com

dsh desktop（MochiNek0）

dsh-desktop——基于 Tauri 构建的跨平台 DeepSeek Harness 桌面客户端（Windows / macOS / Linux），界面走系统 webview，安装包只有几 MB（Windows 2.3 MB、macOS 5.8 MB）。启动时自动在后台拉起 dsh web 并嵌入原生窗口，会话与配置和 CLI 共享；内置插件面板的推荐位第一条就是本市场，点一下即可装上。另有「运行环境」面板枚举与切换本机 Node、安装或升级 dsh，全程无需管理员权限；回合结束或 dsh 等待你确认时发出系统通知。dsh-desktop.cc.cd

DSH Get

DSH Get——DeepSeek Harness 插件的网页检索目录：分类筛选、中英描述、安装命令与插件详情页；其规范化的目录快照公开在 bobby-sheng/dshget-data。

modlens

modlens——全网第一个 DeepSeek Harness 视觉插件，为 DeepSeek、GLM 等纯文本模型外挂视觉能力，粘贴图片即得结构化 JSON 证据（OCR、版面、语义）。本市场内即可直接安装：

dsh plugin --profile web add @liustack/modlens

许可

MIT · dshmarket.com