dsh-pluginhub

DeepSeek Harness 原生社区插件管理器。
不离开设置页，即可发现、安装、更新、配置和恢复社区插件。

为什么使用 dsh-pluginhub

DeepSeek Harness 以可组合插件为核心。dsh-pluginhub 将社区生态直接带进原生设置页，同时让包操作保持透明、可控。

模块	能力
发现	按仓库、作者、描述或能力搜索；按分类筛选；按 Star 或活跃时间排序。
管理	安装、更新、卸载、取消和重试，并查看实时任务进度。
启用	通过当前 profile 的 patch 层启用或停用插件，并检查激活状态。
保护	在包变更前检查兼容性，并在操作失败时自动回滚。

界面预览

发现与安装

DeepSeek Harness 中的社区插件发现页

_{截图来自真实的 DeepSeek Harness 0.1.1-rc.2 宿主与 dsh-pluginhub 0.1.0，不是界面设计稿。}

快速开始

环境要求

已安装带 web profile 的 DeepSeek Harness。
从源码构建需要 Node.js 22.19+ 或 24+。
首次安装到 profile 时，PATH 中需要可用的 pnpm。

安装

dsh plugin --profile web add @funcodingdev/dsh-pluginhub

npm 包名为 @funcodingdev/dsh-pluginhub，设置中的显示名称为 社区插件（英文为 Community Plugins）。

从源码安装（可选）

git clone https://github.com/funcodingdev/dsh-pluginhub.git
cd dsh-pluginhub
npm install
npm pack
dsh plugin --profile web add ./funcodingdev-dsh-pluginhub-0.1.0.tgz

启动或重启 Web profile：

dsh web

然后打开 设置 → 社区插件。

目录数据与信任边界

插件目录来自公开的 dsh-plugin-hub Marketplace API。「社区插件」会聚合其分页结果、拒绝格式错误的仓库条目，并在安装前通过单插件接口重新校验。

这能防止本地 HTTP 接口被用于提交任意包地址，但不代表第三方代码天然安全。安装前请检查插件源码和权限；安装后的插件会在本地运行，并继承 DSH 进程拥有的权限。

浏览目录不会发送 dsh-pluginhub 遥测数据。

网络与镜像配置

环境变量	用途
`DSH_PLUGINHUB_REGISTRY_URL`	使用可信镜像替换默认目录数据源。
`DSH_PLUGINHUB_NPM_MIRROR`	覆盖目录与包操作使用的 npm registry。
`DSH_PLUGINHUB_GITHUB_PROXY`	通过指定代理下载 GitHub 资源。
`DSH_PLUGINHUB_UPDATES_ORIGIN`	覆盖更新元数据地址。

示例：

DSH_PLUGINHUB_REGISTRY_URL=https://mirror.example/marketplace/index.json dsh web

开发

npm install
npm run typecheck
npm test
npm run build
npm run validate:registry

浏览器产物输出到 client/client.js；Host 运行时代码与类型声明输出到 lib/。

src/          Host 运行时与 React 客户端源码
tests/        行为、组件、兼容性和真实宿主测试
data/         用于校验与站点构建的目录快照
site/         静态目录站点模板与资源
scripts/      构建、冒烟、预检和发布守卫

包括真实 DSH + Chromium 测试通道和 pnpm 兼容矩阵在内的完整测试策略，参见 TESTING.md。

参与贡献

产品缺陷和功能建议请提交到本仓库 Issues。
新增或修改插件收录，请向 funcodingdev/dsh-plugin-hub 贡献。data/ 下的 JSON 是生成快照，不是目录数据源。
请保持改动聚焦，并为行为变化补充测试。提交 PR 前运行 npm run check && npm test。