前言¶
DeepSeek Harness（DSH）的理念是「一切皆插件」。在 dsh Web UI 里浏览 GitHub dsh-plugin topic 插件、搜索并安装第三方插件时，通常需要手动找仓库、执行安装、处理进度。
dsh-plugin-market 由 TheYoungChen 维护，是一个 DSH bundle 插件：在 Web UI 左侧「设置」上方新增「插件市场」入口，也集成到「设置 → 插件 → 插件市场」标签页，支持分页浏览、关键字搜索、一键安装和实时进度。
它不是 DeepSeek / 幻方官方应用商店，与 DeepSeek / 幻方无官方从属关系，只提供插件发现与安装入口。
这是什么¶
一句话定位：dsh-plugin-market 是 DSH Web UI 的插件市场 bundle 插件，用于浏览 GitHub dsh-plugin topic 下的插件并辅助安装。
它主要做三件事：
- 在 Web UI 提供浏览和搜索入口。
- 用静态索引减少前端直接调用 GitHub API，索引不可用时回退搜索 API。
- 在安装时调用
pnpm add github:<owner/repo>，并把声明dsh.bundle的依赖 reconcile 进dsh.profile.bundles层栈。
核心功能¶
浏览与搜索¶
市场浏览 GitHub dsh-plugin topic 插件，支持关键字搜索、刷新和按 star 排序。
数据优先使用 GitHub Action 生成的 registry.json，并通过 jsDelivr CDN 分发。索引不可用时，自动回退搜索 API。
已安装识别与更新¶
市场会识别已安装插件，并在列表中置顶；检测到新版时会显示更新提示。
一键安装与进度¶
点击安装后，插件市场执行：
pnpm add github:<owner/repo>
安装过程中提供实时日志、已用时长，可终止任务，也可转后台下载。后台任务会在右上角显示状态条，可展开查看日志，完成后提供「立即重启」按钮，手动关闭。
类型识别¶
市场按仓库根文件识别插件、Skill、预设、脚本类型，并采用对应安装方式。
统计与引导¶
页面提供插件总数统计，以及「如何发布插件」引导链接。
安装与启用¶
安装命令如下：
dsh plugin --profile web add github:TheYoungChen/dsh-plugin-market && dsh web
安装源固定为 github:<owner/repo>，插件装进 web profile，重启 dsh 后生效。dsh-plugin-market 无 prepare 构建脚本，lib/ 已预编译，git 安装不需要额外构建。
典型用法¶
下面介绍几个可复现的使用步骤。
1、打开市场：通过侧边栏「设置」上方入口，或「设置 → 插件 → 插件市场」标签页浏览插件。
2、搜索与排序：输入关键字搜索，使用刷新按钮重新拉取列表，按 star 排序查看插件。
3、安装插件：选择目标插件后确认安装。安装过程会实时显示日志和已用时长，可按需终止或转后台下载。
4、处理构建许可：如果 pnpm 进度中报 allowBuilds，按提示把对应 key 加进：
~/.dsh/profiles/web/pnpm-workspace.yaml
然后重新安装。
5、从源码构建：
cd dsh-plugin-market
pnpm install
pnpm build
适用场景与注意¶
适合已经使用 dsh Web UI、希望在界面内快速发现 GitHub dsh-plugin topic 插件的人。
需要注意：
- 安装第三方插件前，先检查其源码、权限与许可证。插件以当前 dsh 进程权限运行。
- 本市场只提供发现与安装入口，不做安全背书。
- 静态索引每 2 小时由 CI 更新一次，新发布的插件最迟 2 小时进索引。
- 版本检测按需读取 GitHub
package.json，受未鉴权速率限制，约 60 次/小时。 - 安装进度为轮询式，约 600ms 一次，非逐字节流式。
dsh-plugin-market 的许可证为 MIT，Copyright (c) 2025 TheYoungChen。
链接¶
GitHub 仓库：https://github.com/TheYoungChen/dsh-plugin-market
