前言¶
DeepSeek Harness（DSH）把能力拆成可插拔的插件，社区目录也在持续扩充。若只靠手动查文档、记仓库地址、在终端里一条条 add，换机器或给同事复现同一套环境时成本会明显上去。下面介绍维护者 Sun-0306 的客户端插件 dshmarket：在宿主界面里浏览、搜索社区目录，确认来源后一键安装，并顺带承担已装插件的分组、更新与备份等管理工作。
这是什么¶
dshmarket（npm 包名 dshmarket）是跑在 DSH 宿主内的可视化插件市场。简介可概括为：在 Harness 里逛社区插件、点一下装好。它对接社区目录（README 称全量目录在 4200+ 条目且仍在增长），与 dshmarket.com、awesome-dsh-plugin.com 等站点同属社区生态，并非 DeepSeek / 幻方官方应用商店。
同一套列表也以 format-1 索引形式对外提供：在 dsh 0.2.1+ 可在 Plugins → Discover → Index sources 添加 https://cdn.jsdelivr.net/npm/dsh-plugin-catalog/index.json，供 Discover 与 plugin_market 等能力检索；README 说明该索引经 npm CDN 分发，相对部分 GitHub Pages 镜像更易在超时限制内加载。
源码与说明见 GitHub：Sun-0306/dshmarket，SkillHub 目录页：skillhub.cn/plugins/Sun-0306/dshmarket。package.json 中当前版本为 1.71.1，许可证 MIT。
核心功能¶
以下均来自项目 README 与元数据，按使用路径归纳。
浏览与安装¶
- 分类筛选、星标展示、热门/最新排序；描述可随界面语言中英切换。
- Host-aware discovery：卡片展示插件声明的
engines.dsh或与宿主锁步的@deepseek-ai/dsh-*要求；可选过滤仅隐藏「已确认与当前宿主不匹配」的条目，未声明或无法判定的仍可见。 - 一键安装：确认来源后可看实时进度；多数插件刷新页面即可生效，无需重启宿主。
- 主题：独立 Themes 标签，安装后即时切换，互斥生效，卸载可还原。
讨论、收藏与本地整理¶
- Comments：在卡片内嵌打开与 dshmarket.com / catalog 同一讨论串（giscus + GitHub Discussions）；阅读可内嵌，发帖需 GitHub 账号。
- Favorites：从 Discover 或 Themes 收藏，独立 Favorites 标签支持搜索、排序与安装；状态写在 profile 的
state.json。 - Groups：给已装插件建命名分组，组级开关可整组启停；每组最多一个主题；状态本地保存在
state.json。 - Notes：为已装插件写一行自用说明，仅本地展示，覆盖该行作者描述。
更新、备份与卸载¶
- 按插件检查 npm 版本或 pinned commit 相对 HEAD；支持单条更新或批量更新；市场自身也可用同样方式更新。归档链接安装的插件只沿原来源更新，不会被同名目录项静默替换。
- Backup & restore：导出/导入可读 JSON，可选 WebDAV 日备或私有 GitHub Gist；恢复为 merge，校验失败可回滚。
- Hot disable / enable：通过 profile 的
cordis.patch.yml写入disabled开关（机制自 dsh-plugin-hub 移植）。 - 卸载两步确认；本会话新装的插件可即时移除。
网络与其它¶
- 中国区等对 Git ref、README、头像维护多路 GitHub 回退，并记住上次可用路由；可在 Settings → Plugins → Plugin configuration → GitHub acceleration 配置自定义 HTTPS 前缀；环境变量
DSHM_GITHUB_PROXY为运维侧覆盖。 - 插件自有设置页可使用文档中的 update API v1（beta），避免复制市场内部逻辑。
安装与启用¶
宿主要求：README 写明需 dsh web 0.1.0-rc.6 或更新；过旧宿主会自行禁用并在浏览器控制台提示。Plugin Market 入口在 dsh 0.2.1+ 为 Plugins 页与 Installed 并列的 Plugin Market 标签；0.2.0 及更早仅 Settings → Plugin Market。也可在市场卡片下开启侧栏 Plugin Market 一行快捷入口。
DSH Desktop（官方桌面版）：在应用内 Settings → Plugins 搜索 dshmarket 安装。不要在 Desktop 机器上误以为下面 CLI 会装进桌面所用 profile——README 明确：在 Desktop 环境执行 dsh plugin --profile web add dshmarket 可能成功但只写入 profiles/web，界面不会出现。
常规 dsh web：执行后重启 dsh web：
dsh plugin --profile web add dshmarket
自定义 profile：将 web 换成宿主实际 profile 名：
dsh plugin --profile <profile> add dshmarket
安装完成后打开 Plugins → Plugin Market（或 Settings 中的入口，视版本而定）即可使用。
典型用法¶
- 打开 Plugin Market，用分类或搜索定位插件，查看卡片上的宿主要求与截图（有作者截图则直接展示；否则可在安装对话框中从 README 提取）。
- 需要与 Discover 共用目录时，在 Plugins → Discover → Index sources 添加索引 URL（见上文
cdn.jsdelivr.net地址）。 - 安装主题后在 Themes 标签一键切换；对常用插件 Favorites bookmark，对工作集用 Groups 整组开关。
- 迁移环境：Backup & restore 导出 JSON，在另一台机器 import；或配置 WebDAV / Gist 自动备份。
- 批量维护：使用「全部更新」前阅读各条 What changed（release notes 或 commit 列表）。
适用场景与注意¶
适合：日常用 DSH web 或 Desktop、希望少碰命令行即可完成社区插件发现、安装、更新与 profile 级整理的用户；需要与 Discover 索引同源目录的开发者也可按 README 添加 index source。
务必注意：
- 插件在 当前 dsh 进程权限 下运行，一键安装会从网络拉取第三方源码；安装前应查看目标插件仓库、许可证与
engines.dsh声明。 - 讨论区加载会联系 giscus.app 与 GitHub；企业或离线环境需自行评估。
- 社区目录与 SkillHub 条目独立维护；安装命令以 README 为准，应使用
dsh plugin --profile … add dshmarket，不要臆造github:owner/repo形式。
结尾¶
dshmarket 把社区插件目录收进 DSH 界面：浏览、搜索、安装、主题与更新在一处完成，本地分组、备注与备份则方便长期维护同一套 profile。进一步了解可访问 SkillHub 目录页 与 GitHub 仓库。
