用途:按发布操作手册准备并核验社区插件发布到 npm、PyPI 或 ClawHub,覆盖包与工作流矩阵、授权字段、命令及回执检查;若所选包存在 RELEASING.md,可据其补充宿主特定验收要求,命令默认在仓库根目录执行。
主要能力:依据 integrations.json 确定目标包与真实分发渠道(仅凭包清单不构成发布契约);检查注册表当前版本与自上次交付以来的变更,区分发布准备、已发布产物与真实宿主验收;同步更新所选清单、锁文件、注册表、变更日志、运行时诊断版本与活动 pin。
使用方式:先运行所选插件的定向测试与相关注册表/安装契约,再执行 python3 scripts/plugin-release.py preflight <plugin> <version>,以及 python3 -m unittest discover -s scripts -p 'test_plugin_release.py' -v;用 actionlint 检查被改工作流,检查实际 pack 或 wheel/sdist 而非仅源码。烟测使用一次性安装根/配置,不写入用户活跃 agent 配置或 Mem 数据。发布前合并已评审的发布 PR,记录 40 位 SHA 并确认其为 origin/main 祖先;用 --ref main 与确切提交输入派发,工作流代码与产物 SHA 均需评审。核验各包 Trusted Publisher 与手册中的仓库、工作流文件名、环境一致,不收集密码/OTP、不加长期令牌回退、不削弱 2FA、不扩大授权。
限制:使用稳定 X.Y.Z 版本,不覆盖已有版本、不回退 latest、不为掩盖失败而编造版本递增。ClawHub OIDC 要求来源 SHA 等于工作流运行 SHA、来源 ref 等于 OIDC ref(refs/heads/main);runtime 范围为 @nowledge/openclaw-nowledge-mem,family code-plugin,owner nowledge,需使用工作流固定的支持 code-plugin 的 CLI。发布失败时停止重试,先检查失败步骤与远程注册表;npm/PyPI 上传成功但回读失败时使用 verify-plugin-release.yml 恢复工作流。其他细节暂未提供。