用途:在本地以 cloudcannon dev 运行真实的 CloudCannon 应用,针对本地文件、无需登录、单一源,启动本地编辑循环并交给用户操作。适用于部署前先在 CloudCannon 中查看和编辑站点、刚写好可编辑区域/集合/输入项需要试用,或需要本地复现页面缺失、空白、损坏等问题。
主要能力与关键规则:cloudcannon dev 只提供目录服务并同步源文件,它本身从不构建站点。因此每次改动后必须重新构建,否则编辑器字段显示新文本而预览仍是旧页面,且不会报错。--live-sync 会把编辑器保存写入磁盘,但预览渲染的是构建产物。
使用方式:先运行 cloudcannon configure detect-build-commands 检测构建命令与输出目录,再构建站点,然后运行 cloudcannon dev <output-dir> --port 10101 并保持运行,让用户打开 http://localhost:10101,Ctrl-C 停止。构建命令必须用 CLI 检测结果(如 npm run build),不要另建检测表。预览在输出目录变化时自动重载,因此在第二个终端重新构建即可闭环。可让用户二选一:手动路线(一批编辑后自行重跑构建,无额外开销)或监听路线(运行 watch-build.mjs,每次改动触发完整构建)。构建慢或含重写整个输出的后置步骤时默认手动;用户在浏览器中编辑并希望页面跟随则默认监听。
限制:不负责编写集合、输入项或结构(属 cloudcannon-configuration),不负责可编辑区域(属 cloudcannon-visual-editing),不校验站点输出是否正确,不在浏览器中驱动编辑器,也不做最终签收——本地 CloudCannon 没有真实保存到 git、构建流水线和权限。注意 / 与 /index.html 都服务 CloudCannon 应用,构建后的首页在 /__output/index.html;服务器无目录索引,/about/ 需请求 /about/index.html;端口 10101 有响应不代表是你的站点。