发布插件

约 567 字大约 2 分钟

2026-08-14

您可以将插件打包，通过插件市场或私下分享等方式分发。

打包插件

在项目文件中设置 <CreateSrpx>true</CreateSrpx>，每次构建会在 srpx/<ProjectName>.srpx 生成插件包：

dotnet build -c Release

包是 ZIP，根目录包含 manifest.yml、入口程序集以及所有外部包依赖；宿主提供程序集会被打包目标自动排除。
手动安装：将 .srpx 放入 data/cache/plugin-packages 并重启桌面应用；同 id 包会整目录替换，用于更新。

应用内置的插件市场从 SECTL/SecRandom-PluginIndex 加载。索引由该仓库的 workflow 在每次 push 与 nightly 自动重建：扫描 plugins/<id>.yaml，通过 GitHub API 取各插件作者最新 release 的唯一 .srpx 资产，从 release note 解析 SHA-256 块，聚合 index.json 后用 Ed25519 私钥签名，上传到固定 release tag generated。

插件作者投稿流程：

打包插件并计算包校验值：

dotnet build -c Release
./scripts/publish-plugin.ps1 -SrpxPath .\srpx\My.Plugin.srpx -RepoOwner MyGitHub -RepoName my-plugin-repo

在您的 GitHub 仓库发布 .srpx release，tag 形如 vX.Y.Z，release note 中内嵌 SHA-256 块：
```

```
release 需恰好包含一个 .srpx 资产，索引生成器才会匹配到它。
将脚本生成的 plugins/<id>.yaml 提交到 SECTL/SecRandom-PluginIndex 并打开 PR，审核通过后即进入插件市场；后续更新由 nightly 自动收录，无需再次 PR。

生成的 plugins/<id>.yaml 大致如下：

id: secrandom.example
name: SecRandom 示例插件
description: 一个最小 SecRandom 插件示例
author: SECTL
version: 1.0.0
apiVersion: "3.0.0"
repoOwner: SECTL
repoName: SecRandom
projectUrl: https://github.com/SECTL/SecRandom
dependencies:
  - id: some.other.plugin
    required: true

市场客户端行为：

客户端镜像优先（ghproxy.sectl.cn）→ GitHub 直连兜底下载 index.json + index.json.sig，用内嵌 Ed25519 公钥验证整个索引签名；每个包安装前校验 SHA-256。
依赖按 dependencies 拓扑排序安装（含环检测），依赖缺失或循环时报错。
兼容性由 apiVersion 主版本与 minimumHostVersion 判断，不兼容的插件会标记并禁用安装。