用途:把 nao 项目的 context 文件夹与远程 nao 实例打通,使每次推送到 main 都通过 GitHub Actions 自动执行 nao deploy。nao deploy 会把本地项目打包为 tar.gz 上传到 <nao-url>/api/deploy,远程从 nao_config.yaml 读取 project_name,首次创建项目,之后完整替换其 context 文件夹(无合并)。
主要能力与用法:在远程实例的 Settings → Organization → Organization API keys 生成组织级 API key;在 GitHub 仓库添加 NAO_URL、NAO_API_KEY 两个 Secret;用 .naoignore 排除密钥与本地文件;创建 .github/workflows/nao-deploy.yml,使用 actions/checkout@v4、actions/setup-python@v5、安装 nao-core,并运行 nao deploy "$NAO_URL" --api-key "$NAO_API_KEY"。可选在同一 job 先跑 nao sync。
适用场景:nao Cloud 或自托管项目,用 Git 作为部署单一事实来源;可配合 GitHub Environments 做多环境。
限制:每次部署为完整替换,会覆盖 UI 手工修改;.naoignore 不是安全边界;不应扩大触发范围(仅 main),也不要从功能分支部署;密钥须经环境变量传入,切勿打印或提交。价格、配额、支持平台等暂未提供。