cpp285/dsh-plugin-center

DSH 插件中心

在一个紧凑的设置页面中了解、发现和管理 DeepSeek Harness 插件。

DSH 插件中心在设置 → 插件中添加了一个原生风格的工作区。它将当前活动的 Loader 树转换为可读的插件清单，添加了 GitHub 发现功能，并将常用的生命周期操作置于触手可及之处。

DSH 插件中心显示已安装的插件

功能

实时已安装插件清单

- 读取当前活动的 DeepSeek Harness Loader 树，而不是仅依赖依赖文件。
- 显示每个模块的有效启用状态、运行时阶段、版本、包名、仓库和描述。
- 检测被父条目禁用的插件，并将内置模块与用户可管理的包区分开来。
- 汇总有多少模块已加载、正在运行以及使用自定义描述。
- 当包元数据提供有效的 GitHub URL 时，直接打开源仓库。

为不熟悉的模块提供清晰的描述

- 在可用时使用包描述，在不可用时生成简单的回退描述。
- 允许你为任何当前已加载的模块添加单独的中文和英文描述。
- 在界面中优先显示你的描述，同时将其来源显示为用户、包或生成的文本。
- 使用原子文件替换将覆盖内容本地存储在 $DSH_HOME/plugin-center/descriptions.json 中。

GitHub 插件发现

- 查找最多 100 个最近更新、未归档且发布在 dsh-plugin GitHub 主题下的仓库。
- 支持跨仓库名称、所有者、描述、类别和推荐理由的即时搜索。
- 自动将项目分组到内存、界面、自动化、视觉、开发者工具和连接器等类别中。
- 显示 Stars、类别和最后更新时间，并提供指向每个仓库的直接链接。
- 默认没有 Stars 限制；管理员可以添加可选的 maxStars 上限。
- 将 GitHub 结果缓存 10 分钟，并在需要最新数据时提供手动刷新按钮。

精选入门合集

- 为不想逐一查看每个发现结果的用户提供更短的列表。
- 为每个选定的项目添加通俗易懂的理由和类别。
- 获取实时仓库描述、Stars 和更新日期，而不是存储过时的副本。
- 跳过不可用的仓库，而不会破坏合集的其余部分。

插件生命周期管理

- 从 npm 包名或 github:owner/repository[#ref] 说明符安装插件。
- 更新和移除属于所选 DSH 配置文件的非内置包。
- 识别已安装的发现结果，并禁用重复安装。
- 显示操作进度、命令输出、有用的错误以及所需的重新启动通知。
- 通过页面保护 DeepSeek Harness 基础包和插件中心本身不被移除。
- 一次只运行一个管理操作，以避免配置文件更改发生重叠。
原生、稳健的界面

- 位于 设置 → 插件 中，并遵循周围的 DeepSeek Harness 视觉语言。
- 使用紧凑的列表布局，适用于标准和窄窗口。
- 继承宿主颜色以适配浅色和深色模式，并遵循减少动态效果偏好。
- 包含加载、空、错误、重试、确认和禁用状态，以应对日常故障。

要求

- 具有 web 配置文件的 DeepSeek Harness
- Node.js 22 或更高版本
- 在更改已安装插件后重启 dsh web 的权限

从 GitHub 安装

1. 添加插件

打开终端并运行：

dsh plugin --profile web add github:cpp285/dsh-plugin-center

等待命令完成后再继续。

2. 生成 web 配置文件

dsh --profile web --dump-config

这会使新的 bundle 条目对 web 配置文件可用。

3. 启动或重启 DeepSeek Harness

dsh web

如果 dsh web 已在运行，请停止当前进程并重新启动，以便加载新插件。

4. 打开 Plugin Center

打开 DeepSeek Harness，然后转到：

设置 → 插件 → Plugin Center

当你能看到上方截图中显示的 Installed、Discover 和 Featured 视图时，即表示安装成功。

从本地检出安装

在包含此项目的目录中运行以下命令：

dsh plugin --profile web add ./dsh-plugin-center
dsh --profile web --dump-config
dsh web

本地项目会链接到配置文件中，这在开发插件时很有用。无需构建步骤。

使用

- 打开 Installed 以查看插件状态、版本、描述、仓库、更新和移除操作。
- 打开 Discover 以浏览发布在 dsh-plugin GitHub 主题下的仓库。
- 打开 Featured 以查看更短的入门列表。
- 当已安装模块需要更清晰的说明时，使用 Edit description。
- 当界面提示时，在安装、更新或移除后重启 dsh web。

故障排除

- Plugin Center 缺失： 再次运行配置命令，重启 dsh web，并重新加载 DeepSeek Harness 页面。
- 页面仍显示较旧版本： 在重启宿主后执行强制刷新。
- GitHub 发现受到速率限制： 在启动 dsh web 之前设置 GITHUB_TOKEN。

配置

bundle 默认值位于 cordis.patch.yml 中：

config:
profile: web
allowMutations: true
trustedHosts: !!js ctx.webRuntime.trustedHosts

当你需要不同设置时，可在配置文件的 cordis.patch.yml 中使用 id: dsh-plugin-center 覆盖该行。

| 选项 | 默认值 | 用途 |
|---|---|---|
| profile | web | 选择要管理的 DSH 配置文件。 |
| maxStars | 无限制 | 可选地隐藏超过 Stars 阈值的发现结果。 |
| allowMutations | true | 启用安装、更新和移除操作。 |
| allowRemoteMutations | false | 启用后允许来自非回环地址的管理操作。 |
| dshCommand | dsh | 设置 DSH 可执行文件路径。 |
| trustedHosts | Web 默认值 | 定义哪些 Host 值可以访问 Plugin Center API。 |

GitHub 对匿名请求应用较低的 API 配额。如果你需要更高的配额，请在启动 dsh web 之前设置 GITHUB_TOKEN。该令牌仅由宿主进程使用，绝不会暴露给浏览器。

安全模型

- 安装目标仅接受 npm 包名或 github:owner/repository[#ref]。
- URL、本地路径和 shell 片段会被拒绝。
- 插件命令以参数数组形式运行，不经过 shell。
- 管理操作默认仅限于本地请求。
- API 请求会验证 Host、Origin 和跨站请求元数据。
- 同一时间只能运行一个生命周期操作。
- 界面在运行第三方插件代码之前会请求确认。

开发

npm test
npm run check

该项目使用纯 JavaScript 编写，不需要打包工具。

状态

版本 0.1.0 是首个公开开发版本。