前言¶
DeepSeek Harness（DSH）的核心理念是「一切皆插件」。随着插件生态的扩展，通过命令行逐个安装、管理依赖、检查版本变得越来越繁琐，且容易出现配置错误。dsh-plugin-hub 是一个为 DSH Web UI 设计的图形化插件商店，它允许用户在浏览器中直接浏览、搜索并一键安装 GitHub 上的 dsh-plugin 主题仓库。除了作为通用的插件分发渠道，该插件本身包含 21 个内建功能模块，并预置了 16 个常用插件，旨在简化 DSH 插件的生命周期管理。
核心功能¶
图形化管理与发现
在 DSH Web UI 的侧边栏底部会出现「插件商店」入口。商店支持 12 个分类筛选、7 种排序方式（随机、健康度、Stars、评分、下载量、更新、名称），并提供搜索与已安装过滤功能。用户可以查看插件的信任徽章、下载来源，并通过点击「安装」按钮将插件写入 cordis.patch.yml，实现配置的实时生效。
21 个内建插件与离线预置
dsh-plugin-hub 本体是一个包含 22 行配置的包（1 个核心 + 21 个子插件），涵盖基础内核、安全与质量、发布流水线、洞察与内容、运维五大类。所有内建插件在设置页「插件商店」下均可单独开关。
此外，为了解决新用户同步延迟导致的「空白商店」问题，插件内置了 16 个离线预置插件（如 dsh-cost-meter、dsh-notification 等）。这些插件通过 hub-ext-seed-catalog 写入本地目录，遵循「只插不覆盖」原则，即一旦包被真实同步写入，预置目录将不再覆盖其内容。
健康度与安全
商店提供 Top 20 健康度排行榜，展示插件的信任等级与动态趋势。详情页包含评分构成、版本发布线以及基于 npm 真实下载量的趋势图。安装前，插件会通过安全扫描检测危险脚本、敏感文件读取、动态执行及可疑外联，并通过冲突检测与质量门禁拦截不合规的安装。
发布与审计
支持一键发布功能，通过填写 Markdown 介绍，同时向 GitHub 仓库推送代码与 npm 包发布。发布流程包含安全扫描、版本一致性守卫（检查 package.json、README、exports 等是否同步更新）以及质量门禁检查。所有操作（安装、卸载、启停、评分、发布）都会记录在审计日志中，并持久化到本地 SQLite 数据库。
安装与启用¶
通过命令行安装该插件：
dsh plugin --profile web add dsh-plugin-hub
安装完成后，侧边栏会出现「插件商店」入口，设置页会增加「插件商店」配置区块。首次使用建议在设置页点击「立即同步」，以加载本地镜像缓存。
设计与实现¶
声明式依赖与解耦
为了避免硬依赖导致的死锁问题（即「提供者被停用 → 消费者永久 Pending」），dsh-plugin-hub 采用声明式依赖管理。插件间的依赖关系写在配置清单中，而非通过 Cordis 的 inject 硬注入。当用户关闭某个插件（如「商店数据库」）时，其他依赖该插件的模块会主动上报「依赖阻塞」并让位，不再提供服务或注册界面；重新开启该插件后，依赖链自动恢复。
两级开关机制
插件支持两级控制：
1. 安装级：在 cordis.patch.yml 中配置 disabled: true，控制插件是否被加载。
2. 日常级：在 DSH 设置页的「内建插件」中按分组管理，修改 storages/plugin-store/plugins.json 并重启 DSH 生效。
注意：默认关闭的四个插件（changelog / baike / skill-store / diagnostics）在 patch.yml 中不写 disabled: true。这是因为如果 loader 未加载该模块，模块内的代码将无法读取设置页的开关，导致无法生效。默认关闭由模块自身的启动逻辑实现，确保开关可逆。
内建插件详解¶
用量与费用
hub-ext-usage 提供带日期的价格表，支持回溯历史价格。它会记录会话中每个请求的 Token 与缓存命中率，并展示当时价与现价的差额。价格表按版本管理，调价时仅追加新版本，历史不可变。
运维与诊断
hub-ext-backup 支持 VACUUM INTO 导出数据库与插件状态快照，仅保留最近 10 个备份，且支持回滚前的二次备份。hub-ext-diagnostics（默认关闭）可导出包含环境、插件状态、依赖统计与审计日志的诊断报告（Markdown 格式）。
注意事项¶
- 版本适配：该插件适配 DSH
0.1.5-rc.1（基于 cordis 4.0.2）。 - 权限要求：插件以当前 DSH 进程权限运行，发布功能需要配置有效的 GitHub Token。
- 生态说明：DSH 是开源项目，dsh-plugin-hub 是社区维护的插件，与 DeepSeek / 幻方无官方从属关系。
