用途:当用户要求创建 openship.json、配置 OpenShip 部署、让仓库可在 OpenShip 上部署或修复相关配置时使用。
主要能力:遵循 OpenShip 上游配置流程——检查仓库、只声明必要的覆盖项、然后校验。自动检测会补全省略字段。除非用户选择云端,否则优先自托管部署。
使用方式:检查 package scripts、lockfile、框架设置、Dockerfile、compose 文件、工作区布局和已有 openship.json。选择单一应用、compose 服务或检测到的 monorepo 应用,不要随意混合这些形态。monorepo.apps 按根目录覆盖已检测应用,不会发现新应用。仅在文件不存在时运行 openship config init;保留已有配置,只添加需要覆盖检测的值,并保持 $schema 为 https://openship.io/openship.schema.json。用部署所用的 CLI 版本运行 openship --json config validate,修复错误并查看警告。
限制:openship.json 表达期望配置,不证明域名已迁移或运行中的部署已改变;部署与实时验证由配套的 openship-deploy 技能处理。不要把真实密钥值提交进 JSON,secret: true 只控制摄取后的存储处理,不加密 Git 文件中的凭据。自托管默认资源不限,仅在需要时声明上限。具体字段含义、示例和版本行为请查阅上游配置指南与源码。