云开发使用指南
云开发已正式向商家开放,与云应用共同组成 PaaS AI。云开发负责与 AI 对话实现和修改功能;云应用负责预览、正式发布与托管运行。
在商家后台的“云应用”页面选择应用,点击“进入云开发”。入口仍要求商家已开通功能,当前员工具有管理员或开发者权限。无需自己配置开发账号或安装 CLI。
开始与继续开发
- 第一次开发:描述业务问题、使用者和核心流程。AI 会按实际缺项提问;需求规划阶段先明确方案,进入应用开发后再修改代码。
- 继续之前的工作:从左侧对话记录进入原对话,接着说明要改什么。关闭页面不等于删除对话,也不需要每次重新开始。
- 新建对话:“修改现有应用”沿用当前代码;“重新做一版”从新版开始。新对话不是新建另一个云应用,也不会仅因创建对话就替换正式版。
- 接入已有源码:导入用于替换开发代码,不是把另一套项目追加到正在进行的对话。按导入页面说明操作;有未结束对话时,先处理原对话。
保存与恢复
应用开发轮次收尾时会执行代码保存,平台也有自动草稿保护。以工作台实际显示的保存结果为准:已有保存版本表示该版本已收到,不代表最后一次尚未保存的修改也已包含。
保存失败时平台应显示具体状态;可以在原对话继续处理,不需要使用者自行检查 Git。停止任务不会撤销已经完成的改动,也不能保证停止前最后一次修改已保存。
开发环境空闲释放后,再次发送需求会尝试恢复已保存代码。若平台更换了开发账号,符合接续条件的空闲对话可沿用原对话、聊天记录和已保存代码;有任务仍在执行或保存状态不明确时,不会直接重放任务。恢复失败应查看实际提示,不能把临时开发磁盘当作永久备份。
保存代码不等于发布预览,发布预览也不等于正式上线。 云应用数据库和文件存储与代码保存是不同的内容,恢复代码不会把业务数据一起回滚。
在对话中发布
可以直接说“发布到预览”或“把这个版本正式上线”,也可以使用工作台的发布面板。
| 你的表达与当前状态 | 云开发的处理 |
|---|---|
| 明确要求测试、预览 | 发布测试版,不替换正式应用 |
| 明确要求正式、生产 | 按正式目标处理;还没有可用预览时,先构建并确认就绪,再上线同一版本 |
| 只说“推送吧”,当前代码没有就绪预览或又有改动 | 先发布测试版 |
| 只说“推送吧”,同一份代码的预览已就绪且没有新改动 | 可以按正式上线处理;不确定时会询问目标 |
| 只讨论怎么上线、明确说先别上线,或只是开发完成 | 不视为发布授权 |
查看实际进度与结果:“已受理”“正在构建”“正在启动”都不代表已经能打开;正式上线完成后,打开正式应用验证。发布失败时查看失败原因,不能把 AI 的口头说明当成成功回执。
本地 WorkBuddy/CLI 采用本地接入指引,目标不明确时先发布测试版,见交给 AI 开发。不要把两套流程的默认行为混为一谈。
检查与安全扫描
平台代码检查发现的可疑写法不等于已经确认的漏洞。AI 应核实实际代码与数据来源,修复确实存在的问题,并记录真正执行过的测试;不能只靠一句“误报”把平台结果改成通过。
正式上线前选择额外安全扫描时,需要等待实际扫描结果。失败、超时或报告不完整都不算通过;是否重新扫描由你决定,不会自动修代码。额外扫描会产生相应开发用量;费用按系统最终取得的实际用量结算,不需要商家手动计算。
工具如何更新
新开发工作区准备时会检查平台工具,已有工作区在下一轮开发前按检查间隔处理,当前最多每天检查一次。同日连续聊天不会每轮下载,也不会在无人开发时为了更新而启动环境。更新失败会尽量保留可用旧版。
这是工作区 CLI 和工具包的更新,不会自动改写应用自己的 SDK 依赖、锁文件或业务代码。需要新 SDK 功能时,由 AI 在当前项目中升级、测试并重新发布。