> ## 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/zh-Hant/cloud/settings/workspace.md)。刪除變數後，已執行的環境需要重啟才生效。

## 注意與限制

* 不要在會話或配置環境頁的輸入框裡直接傳送金鑰；在環境檢查或「设置 › 工作区 › 密钥与环境变量」裡填寫。
* 雲端環境只能訪問公網。
* 環境配置只作用於雲主機上的雲端專案。

## 常見問題

### 環境檢查跳過了，之後還能補金鑰嗎？

可以。在「设置 › 工作区 › 密钥与环境变量」裡補，或回到配置環境頁點「编辑环境」。

### 釋出前能改安裝指令碼嗎？

可以。在環境卡片上點「编辑」，或在檢查第 1 步裡直接改。

### 為什麼新建專案後沒有自動開始配置？

配置環境是可選的。需要時到「项目设置 › 环境」點編輯按鈕進入。

## 相關

* [專案](https://docs.aihubmix.com/zh-Hant/cloud/projects/projects.md)
* [工作區設定](https://docs.aihubmix.com/zh-Hant/cloud/settings/workspace.md)
* [執行環境：本機與雲主機](https://docs.aihubmix.com/zh-Hant/cloud/projects/run-environment.md)
* [雲主機](https://docs.aihubmix.com/zh-Hant/cloud/cloud-host/overview.md)


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