插件校验 Actionbowenliang123/dsh-plugin-checker

DeepSeek Harness 插件检查器 - GitHub Action

一个用于检查 DeepSeek Harness（dsh）插件正确性的 GitHub Action。

它按以下顺序检查插件，从成本最低的开始：

1. 检查清单文件 — package.json 存在、是有效的 JSON、声明了 name、声明了 dsh.bundle.patch，并且引用的补丁文件存在。没有 dsh.bundle 的包不是 dsh 插件。
2. 使用 dsh 安装 — 运行 dsh plugin --profile web add；如果 dsh 无法安装它（例如 pnpm 安装失败），则失败。
3. 验证层是否生效 — 运行 dsh --profile web --dump-config，如果插件未在组合配置中作为 bundle 层（# == ）出现，则失败。

用法

将此 action 添加到你的插件仓库的工作流中：

name: ci

on:
push:
branches: [main]
pull_request:

jobs:
check-plugin:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v7
- name: Check the DSH plugin
uses: bowenliang123/dsh-plugin-checker@v1

这会检查仓库根目录。要检查位于子目录中的插件，请传入 rootPath：

- name: Check the DSH plugin
uses: bowenliang123/dsh-plugin-checker@v1
with:
rootPath: plugins/my-plugin

输入

| 输入           | 描述                                                                               | 必需     | 默认值     |
| -------------- | ---------------------------------------------------------------------------------- | -------- | ---------- |
| rootPath     | 插件根目录的路径，相对于仓库根目录。                                               | 否       | .        |
| profile      | 要将插件安装到的 dsh profile。                                                     | 否       | web      |
| dshVersion   | 要安装的 @deepseek-ai/dsh npm 包版本。使用 latest 表示最新版本。               | 否       | latest   |
| pnpmVersion  | 要安装的 pnpm 版本（dsh 插件管理内部运行 pnpm）。                                | 否       | latest   |
| nodeVersion  | 用于运行 dsh CLI 的 Node.js 版本。                                                 | 否       | 24       |

工作原理

1. 设置 Node.js，并从 npm 安装 pnpm 和 @deepseek-ai/dsh CLI（npm install @deepseek-ai/dsh）。
2. 静态检查插件的 package.json 清单文件（有效的 JSON、name、声明了 dsh.bundle.patch、补丁文件存在）。
3. 运行 dsh plugin --profile  add ，将插件安装到 runner home 下的全新 dsh profile 中。
4. 运行 dsh --profile  --dump-config，并验证插件作为 bundle 层（# == ）出现，确认补丁确实加载了。

插件的 package.json 看起来像这样：

{
"name": "my-dsh-plugin",
"version": "0.1.0",
"type": "module",
"main": "index.js",
"dsh": {
"bundle": {
"patch": "./cordis.patch.yml"
}
}
}

示例
- examples/hello-plugin — 一个通过检查的最小有效插件。
- examples/broken-plugin — 一个 package.json 无效、必须检查失败的插件。

许可证

Apache License 2.0