用途:为 CloudCannon 站点编写和定制配置,主要涉及 cloudcannon.config.yml(告诉 CloudCannon 如何理解和呈现站点内容)与 .cloudcannon/initial-site-settings.json(告诉 CloudCannon 如何构建站点)。适用于创建或修改配置、增改 Collections、Inputs、Structures、Select Data,修复编辑器缺失字段或输入类型错误,以及配置 Collection URL 以便页面在可视化编辑器中打开。
主要能力:覆盖集合、输入、结构、选择数据、集合 URL、构建命令与故障排查;提供 SSG 专属文档(如 Astro 的配置流程、集合 URL、常见陷阱);并列出常见无效键与正确键的对照,例如 disable_url_preview 应为 disable_url,type: hidden 应为 hidden: true,options.max 应为 options.max_length,options.structures 需写全路径 _structures.my_blocks,timezone 为顶层键且须用 IANA 名称。
必要用法:写任何配置前先下载权威 JSON schema: mkdir -p .cloudcannon/migration curl -sL "https://github.com/cloudcannon/configuration-types/releases/latest/download/cloudcannon-config.latest.schema.json" -o .cloudcannon/migration/cloudcannon-config.latest.schema.json curl -sL "https://github.com/cloudcannon/configuration-types/releases/latest/download/cloudcannon-initial-site-settings.schema.json" -o .cloudcannon/migration/cloudcannon-initial-site-settings.schema.json 两个文件都存在后再继续。若尚无 cloudcannon.config.yml,可生成基线: npx @cloudcannon/cli configure generate --auto --initial-site-settings 每次修改后运行 npx @cloudcannon/cli validate 校验未知键与类型错误。
限制与边界:不负责模板中的可编辑区域(属 cloudcannon-visual-editing)、MDX 组件或内联 HTML(属 cloudcannon-snippets)、完整迁移(从 migrate-to-cloudcannon 开始)、托管站点操作(属 cloudcannon-cli)。CLI 输出仅为基线,仍需定制输入类型、结构、选择数据与工具栏;每个数组都需要结构定义,否则编辑器无法添加条目;显式 _inputs 优先于类型推断。其余细节暂未提供。