跳转到主要内容
项目环境是云端项目在云主机上的运行条件:安装脚本、启动命令,以及项目要用的密钥和环境变量。AI 会读取仓库,生成安装脚本和启动命令,列出缺少的密钥和变量;你在「环境检查」里确认、补充后,AI 在云主机上运行安装脚本,通过后由你发布。 环境配置是可选的:项目建好就可以开始会话,配置状态不影响开始会话。本地项目使用电脑本身的环境,不经过这一步。

适用范围

入口

  • 「项目设置 › 环境」右侧的编辑按钮(「编辑环境」)。
  • 通知里关于项目缺少环境变量的提醒,点开直接进入配置环境页。
配置环境页是项目上的独立页面,不属于会话,不会出现在侧栏的会话列表里。

环境状态

「设置 › 工作区 › 项目」里每个云端项目会显示环境状态:

第一次配置

第一次打开配置环境页时,AI 先根据仓库生成草稿(安装脚本、启动命令、需要的密钥和变量),等你完成环境检查后才会运行安装脚本。
  • 缺少密钥或环境变量时,输入框上方直接展开「检查环境」卡片。
  • 什么都不缺时,点输入框上方的「编辑环境」打开同一张卡片确认。
AI 的处理步骤折叠在「已处理 N 秒」下,可以点开查看。

环境检查三步

「检查环境」卡片分三步,用「下一步」「跳过」前进,最后一步点「完成检查」。缺少必填项时可以点「稍后处理」收起,卡片变成一行「需要你处理」,点它重新展开,已填的值保留。
  1. 确认安装与启动:查看 AI 生成的「安装脚本」(创建环境和依赖变化时运行)和「启动命令」(每次唤醒环境后运行),点编辑按钮可以修改。
  2. 配置密钥:填写每个密钥的值。已保存过的密钥留空则不变。标「工作空间」的建议保存为工作区级,同工作区的项目共用;其余保存为这个项目的密钥。名称只能包含字母、数字和下划线,且不能以数字开头。
  3. 配置环境变量:AI 有建议值的会预先填好,可以修改或「添加变量」。已保存的变量不显示原值,留空则保持不变。
密钥和环境变量两步要把必填值都填好,「下一步」才可用。

检查完成后

点「完成检查」后,页面显示摘要「你已完成环境检查」(安装与启动是否修改、保存了哪些密钥、环境变量数量),AI 随即用确认后的脚本在云主机上运行安装脚本。密钥的值不会显示在页面上。

配置结果

环境已就绪

安装脚本通过后,页面出现环境卡片「项目名 环境已就绪」,列出仓库、运行时、安装脚本、启动命令、密钥(还没填值的标「(未填写)」)和环境变量数量。
  • 「编辑」:重新打开检查卡片修改后再运行。
  • 「发布到云主机」:发布后卡片变为「环境已发布」,点「开始任务」进入新会话页并选中这个项目。

配置失败

安装脚本没通过时显示错误信息,不影响开始会话:
  • 「重试」:用最近一版脚本再运行一次。
  • 「编辑环境」:修改脚本后点「完成检查」重新运行。

继续补充要求

配置失败、已就绪或已发布后,可以在页面底部的输入框(「继续补充要求」)里发送要求,AI 会据此重新配置。配置进行中不能发送;这里不能切换模型。

修改已发布的环境

从「项目设置 › 环境」进入配置环境页,点「编辑环境」,改完点「完成检查」会重新运行安装脚本。通过后项目进入「待发布」,需要再点「发布到云主机」才生效。 项目级的密钥和变量也可以直接在「设置 › 工作区 › 密钥与环境变量」里改,见 工作区设置。删除变量后,已运行的环境需要重启才生效。

注意与限制

  • 不要在会话或配置环境页的输入框里直接发送密钥;在环境检查或「设置 › 工作区 › 密钥与环境变量」里填写。
  • 云端环境只能访问公网。
  • 环境配置只作用于云主机上的云端项目。

常见问题

环境检查跳过了,之后还能补密钥吗?

可以。在「设置 › 工作区 › 密钥与环境变量」里补,或回到配置环境页点「编辑环境」。

发布前能改安装脚本吗?

可以。在环境卡片上点「编辑」,或在检查第 1 步里直接改。

为什么新建项目后没有自动开始配置?

配置环境是可选的。需要时到「项目设置 › 环境」点编辑按钮进入。

相关