适用范围
入口
- 「项目设置 › 环境」右侧的编辑按钮(「编辑环境」)。
- 通知里关于项目缺少环境变量的提醒,点开直接进入配置环境页。
环境状态
「设置 › 工作区 › 项目」里每个云端项目会显示环境状态:第一次配置
第一次打开配置环境页时,AI 先根据仓库生成草稿(安装脚本、启动命令、需要的密钥和变量),等你完成环境检查后才会运行安装脚本。- 缺少密钥或环境变量时,输入框上方直接展开「检查环境」卡片。
- 什么都不缺时,点输入框上方的「编辑环境」打开同一张卡片确认。
环境检查三步
「检查环境」卡片分三步,用「下一步」「跳过」前进,最后一步点「完成检查」。缺少必填项时可以点「稍后处理」收起,卡片变成一行「需要你处理」,点它重新展开,已填的值保留。- 确认安装与启动:查看 AI 生成的「安装脚本」(创建环境和依赖变化时运行)和「启动命令」(每次唤醒环境后运行),点编辑按钮可以修改。
- 配置密钥:填写每个密钥的值。已保存过的密钥留空则不变。标「工作空间」的建议保存为工作区级,同工作区的项目共用;其余保存为这个项目的密钥。名称只能包含字母、数字和下划线,且不能以数字开头。
- 配置环境变量:AI 有建议值的会预先填好,可以修改或「添加变量」。已保存的变量不显示原值,留空则保持不变。
检查完成后
点「完成检查」后,页面显示摘要「你已完成环境检查」(安装与启动是否修改、保存了哪些密钥、环境变量数量),AI 随即用确认后的脚本在云主机上运行安装脚本。密钥的值不会显示在页面上。配置结果
环境已就绪
安装脚本通过后,页面出现环境卡片「项目名 环境已就绪」,列出仓库、运行时、安装脚本、启动命令、密钥(还没填值的标「(未填写)」)和环境变量数量。- 「编辑」:重新打开检查卡片修改后再运行。
- 「发布到云主机」:发布后卡片变为「环境已发布」,点「开始任务」进入新会话页并选中这个项目。
配置失败
安装脚本没通过时显示错误信息,不影响开始会话:- 「重试」:用最近一版脚本再运行一次。
- 「编辑环境」:修改脚本后点「完成检查」重新运行。
继续补充要求
配置失败、已就绪或已发布后,可以在页面底部的输入框(「继续补充要求」)里发送要求,AI 会据此重新配置。配置进行中不能发送;这里不能切换模型。修改已发布的环境
从「项目设置 › 环境」进入配置环境页,点「编辑环境」,改完点「完成检查」会重新运行安装脚本。通过后项目进入「待发布」,需要再点「发布到云主机」才生效。 项目级的密钥和变量也可以直接在「设置 › 工作区 › 密钥与环境变量」里改,见 工作区设置。删除变量后,已运行的环境需要重启才生效。注意与限制
- 不要在会话或配置环境页的输入框里直接发送密钥;在环境检查或「设置 › 工作区 › 密钥与环境变量」里填写。
- 云端环境只能访问公网。
- 环境配置只作用于云主机上的云端项目。