ouyangyipeng/dsh-marketplace

简体中文 · English

dsh-marketplace 本身就是一个 DeepSeek Harness bundle。它把 GitHub topic:dsh-plugin 的实时社区仓库放进 设置 → 插件 → Marketplace，让插件发现、搜索、检查、安装、更新和卸载留在同一个 Harness 界面里。

真实 DeepSeek Harness 设置页面中的 DSH Marketplace 插件列表

[!IMPORTANT] Marketplace 能检查包格式和收紧安装过程，不能证明第三方插件可信。插件重启后会在 DSH 进程内运行；启用前仍应阅读源码。

安装

DS-Harness Desktop

DS-Harness Desktop 从 desktop-v0.2.0 起离线内置固定版本的 Marketplace。打开应用后进入 设置 → 插件 → Marketplace，不需要先安装本插件。

内置版本显示“Desktop 内置”，不能在 Marketplace 里更新或卸载自己；它随经过验证的 Desktop release 更新。其他插件仍安装进 Desktop 隔离的 web profile。

标准 DSH Web profile

需要当前 DeepSeek Harness、Node.js ^22.19.0 || >=24.0.0 和位于 PATH 中的 pnpm：

dsh plugin --profile web add "github:ouyangyipeng/dsh-marketplace#v0.1.1"

重启 dsh web，然后打开 设置 → 插件 → Marketplace。

更新或卸载独立安装的 Marketplace 使用 DSH 原生命令：

dsh plugin --profile web update dsh-marketplace
dsh plugin --profile web remove dsh-marketplace

一条插件从发现到激活

flowchart LR
  Topic["GitHub topic:dsh-plugin"] --> Cache["Catalog cache + ETag"]
  Cache --> UI["Marketplace Client"]
  UI --> Stage["pnpm add --ignore-scripts"]
  Stage --> Inspect["Manifest + exports + path checks"]
  Inspect --> Profile["Atomic profile edit"]
  Profile --> Restart["Restart DSH"]

Host 最多读取 GitHub Search 的 10 页、每页 100 个公开仓库。
Client 在本地按名称、作者、简介和 topic 搜索，并按更新时间、Stars 或名称排序。
点击安装时，候选包先进入独立临时项目；这一步不修改用户 profile。
包通过预构建入口、bundle patch 和路径检查后，才正式写入 profile dependency。
dsh.profile.bundles 使用原子文件替换；安装失败时不激活，卸载失败时恢复旧 manifest。
生命周期变化在重启 DSH 后生效。

安全边界

Marketplace 会做	Marketplace 不会承诺
用严格的 `owner/repository` 语法解析仓库	审核插件业务逻辑或作者身份
始终以 `pnpm add --ignore-scripts` 暂存和安装	把安装后的插件放进运行时沙箱
要求安全包名、预构建 Host 与标准 `dsh.bundle.patch`	证明仓库没有恶意代码
声明 Web Client 时要求预构建 `./client` export	读取私有仓库或保存 GitHub token
检查 patch/entry 的真实路径仍位于包目录内	让源码包或依赖构建脚本的仓库自动兼容
逐项传递子进程参数，不拼接 shell command	绕过 DSH 的重启激活语义
只允许同源 loopback + 进程 nonce 调用写接口	把 Marketplace 变成远程管理 API
把 GitHub 数据作为 React 文本渲染，不插入 HTML	加载远端头像或仓库 HTML

只有 TypeScript 源码、依赖 prepare/postinstall、实际是独立应用或没有标准 DSH bundle 声明的仓库仍会出现在目录中，但安装会明确失败。Marketplace 不会退回执行它们的脚本。

原生 DSH 结构

本包有两个 DSH face：

flowchart LR
  Patch["cordis.patch.yml"] --> Host["Host face"]
  Host --> API["/dsh-marketplace/v1"]
  Manifest["package.json#dsh.client"] --> Client["Client face"]
  API --> Client
  Client --> Slot["settings.plugins.tab"]
  Host --> Profile["$DSH_HOME/profiles/web"]

cordis.patch.yml 挂载 Host。
package.json#dsh.bundle.patch 声明可安装的 profile bundle。
package.json#dsh.client 声明 Web Client 和注入的 DSH 服务。
Host 只注册一个 effect-scoped 路由前缀；Client 只注册一个设置页 Tab。
Host 不根据进程名或路径猜测宿主。Desktop 等发行版通过 bundledRepositories 明确声明自己的固定内容。

HTTP API

所有响应均为 JSON，并带 Cache-Control: no-store。

Method	Path	用途
`GET`	`/dsh-marketplace/v1/bootstrap`	nonce、写权限、profile inventory 与 host-bundled repositories
`GET`	`/dsh-marketplace/v1/catalog`	缓存目录；`?refresh=1` 强制重验证
`POST`	`/dsh-marketplace/v1/install`	暂存、验证、安装/更新并激活仓库
`POST`	`/dsh-marketplace/v1/remove`	按 package + repository 停用并移除插件

写接口要求 TCP 对端、Host 和可选 Origin 均为 loopback，同时提交同源 bootstrap 返回的进程 nonce。LAN 客户端、远端 Origin、错误 nonce、非 JSON 内容、超过 16 KiB 的 body 和 host-bundled repository mutation 都会被拒绝；bundled conflict 返回 HTTP 409。

配置

独立安装使用以下保守默认值：

- insert:
    - id: dsh-marketplace
      name: dsh-marketplace
      config:
        profile: web
        cacheTtlMs: 600000

可选配置：

home：覆盖 DSH Home；空值依次使用 DSH_HOME 和 ~/.dsh。
bundledRepositories：宿主拥有的不可变 owner/repository 列表；默认 []。坐标在加载时规范化，非法值和大小写归一后的重复值会让插件启动失败。

目录与限流

GitHub Search 对一个查询最多返回 1,000 条结果。
未登录 Search API 限流较低；Marketplace 不收集或持久化 GitHub token。
Host 使用十分钟缓存、ETag 重验证、可见的 rate-limit 状态和 stale-on-error 回退。
兼容性只在用户点击安装或更新时验证，避免提前 clone 1,000 个未知仓库。
GitHub 不可用不会阻止 Harness 或 Desktop 启动。

开发与验证

git clone https://github.com/ouyangyipeng/dsh-marketplace.git
cd dsh-marketplace
pnpm install

pnpm test
pnpm run typecheck
pnpm run build
pnpm site:check
pnpm pack --dry-run

把本地 checkout 接入 DSH：

dsh plugin --profile web add "link:$(pwd)"
dsh web

测试覆盖目录分页与缓存、仓库坐标、manifest/entry/patch 验证、真实路径和符号链接逃逸、禁脚本子进程参数、profile 原子更新与回滚、Host HTTP policy、bundled mutation、远端文本渲染、Client 搜索和产品站静态约束。

License

MIT。DeepSeek Harness、DeepSeek 名称与社区插件保留各自的许可证和商标。本项目是社区维护的非官方插件。