跳转到内容

插件发布

官方插件和社区插件使用同一套发布工具链。

Terminal window
npx --yes @haloforge/plugin-pack@0.2.13 check .
npx --yes @haloforge/plugin-pack@0.2.13 pack . --release --out dist/package
Terminal window
npx --yes @haloforge/plugin-pack@0.2.13 metadata dist/package/<plugin-id>-<version>.hfpkg \
--signing-key-id haloforge-official-2026-05 \
--signing-key-env HF_PLUGIN_SIGNING_PRIVATE_KEY \
--pretty \
--output dist/catalog-draft.json
Terminal window
npx --yes @haloforge/plugin-pack@0.2.13 submit dist/catalog-draft.json --token-env HF_ADMIN_TOKEN

官方插件仓库应通过 GitHub Actions 执行,并把签名 key 放在 repository secrets 中。 如果插件使用多窗口 manifest 策略或当前窗口标题 SDK API,发布时 min_app_version 至少应为 0.8.0min_host_api_version 至少应为 0.2.13

提交 metadata 会创建 draft,管理员审核:

  • source label
  • package signature
  • manifest permissions
  • compatibility
  • artifact URL
  • homepage/repository URL
  • trust policy

只有审核通过后才发布到公开 catalog。