> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 项目环境：AI 配置环境、环境检查与发布

> 云端项目在云主机上的安装脚本、启动命令、密钥和环境变量如何由 AI 配置：进入配置环境页、三步环境检查、运行结果、发布，以及环境状态的含义。

**项目环境**是云端项目在云主机上的运行条件：安装脚本、启动命令，以及项目要用的密钥和环境变量。AI 会读取仓库，生成安装脚本和启动命令，列出缺少的密钥和变量；你在「环境检查」里确认、补充后，AI 在云主机上运行安装脚本，通过后由你发布。

环境配置是可选的：项目建好就可以开始会话，配置状态不影响开始会话。本地项目使用电脑本身的环境，不经过这一步。

## 适用范围

| 形态 | 支持情况 | 说明 |
| - | - | - |
| 桌面客户端 | 支持 | |
| 网页版 | 支持 | |
| 手机网页 | 支持 | |

## 入口

* 「项目设置 › 环境」右侧的编辑按钮（「编辑环境」）。
* 通知里关于项目缺少环境变量的提醒，点开直接进入配置环境页。

配置环境页是项目上的独立页面，不属于会话，不会出现在侧栏的会话列表里。

## 环境状态

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

| 状态 | 含义 |
| - | - |
| 「待配置环境」 | 还没配置过环境，可以直接开始会话 |
| 「正在配置」 | 安装脚本正在云主机上运行，期间可以继续使用项目 |
| 「待发布」 | 安装脚本已通过、还没发布，或已发布的环境又有修改 |
| 「配置失败」 | 安装脚本没有通过，可以重试；不影响开始会话 |
| 不标注 | 环境已发布到云主机 |

## 第一次配置

第一次打开配置环境页时，AI 先根据仓库生成草稿（安装脚本、启动命令、需要的密钥和变量），**等你完成环境检查后才会运行安装脚本**。

* 缺少密钥或环境变量时，输入框上方直接展开「检查环境」卡片。
* 什么都不缺时，点输入框上方的「编辑环境」打开同一张卡片确认。

AI 的处理步骤折叠在「已处理 N 秒」下，可以点开查看。

## 环境检查三步

「检查环境」卡片分三步，用「下一步」「跳过」前进，最后一步点「完成检查」。缺少必填项时可以点「稍后处理」收起，卡片变成一行「需要你处理」，点它重新展开，已填的值保留。

1. **确认安装与启动**：查看 AI 生成的「安装脚本」（创建环境和依赖变化时运行）和「启动命令」（每次唤醒环境后运行），点编辑按钮可以修改。
2. **配置密钥**：填写每个密钥的值。已保存过的密钥留空则不变。标「工作空间」的建议保存为工作区级，同工作区的项目共用；其余保存为这个项目的密钥。名称只能包含字母、数字和下划线，且不能以数字开头。
3. **配置环境变量**：AI 有建议值的会预先填好，可以修改或「添加变量」。已保存的变量不显示原值，留空则保持不变。

密钥和环境变量两步要把必填值都填好，「下一步」才可用。

## 检查完成后

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

## 配置结果

### 环境已就绪

安装脚本通过后，页面出现环境卡片「项目名 环境已就绪」，列出仓库、运行时、安装脚本、启动命令、密钥（还没填值的标「（未填写）」）和环境变量数量。

* 「编辑」：重新打开检查卡片修改后再运行。
* 「发布到云主机」：发布后卡片变为「环境已发布」，点「开始任务」进入新会话页并选中这个项目。

### 配置失败

安装脚本没通过时显示错误信息，不影响开始会话：

* 「重试」：用最近一版脚本再运行一次。
* 「编辑环境」：修改脚本后点「完成检查」重新运行。

## 继续补充要求

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

## 修改已发布的环境

从「项目设置 › 环境」进入配置环境页，点「编辑环境」，改完点「完成检查」会重新运行安装脚本。通过后项目进入「待发布」，需要再点「发布到云主机」才生效。

项目级的密钥和变量也可以直接在「设置 › 工作区 › 密钥与环境变量」里改，见 [工作区设置](https://docs.aihubmix.com/cn/cloud/settings/workspace.md)。删除变量后，已运行的环境需要重启才生效。

## 注意与限制

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

## 常见问题

### 环境检查跳过了，之后还能补密钥吗？

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

### 发布前能改安装脚本吗？

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

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

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

## 相关

* [项目](https://docs.aihubmix.com/cn/cloud/projects/projects.md)
* [工作区设置](https://docs.aihubmix.com/cn/cloud/settings/workspace.md)
* [运行环境：本机与云主机](https://docs.aihubmix.com/cn/cloud/projects/run-environment.md)
* [云主机](https://docs.aihubmix.com/cn/cloud/cloud-host/overview.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.