跳轉到主要內容
專案環境是雲端專案在雲主機上的執行條件:安裝指令碼、啟動命令,以及專案要用的金鑰和環境變數。AI 會讀取倉庫,生成安裝指令碼和啟動命令,列出缺少的金鑰和變數;你在「环境检查」裡確認、補充後,AI 在雲主機上執行安裝指令碼,透過後由你釋出。 環境配置是可選的:專案建好就可以開始會話,配置狀態不影響開始會話。本地專案使用電腦本身的環境,不經過這一步。

適用範圍

入口

  • 「项目设置 › 环境」右側的編輯按鈕(「编辑环境」)。
  • 通知裡關於專案缺少環境變數的提醒,點開直接進入配置環境頁。
配置環境頁是專案上的獨立頁面,不屬於會話,不會出現在側欄的會話列表裡。

環境狀態

「设置 › 工作区 › 项目」裡每個雲端專案會顯示環境狀態:

第一次配置

第一次開啟配置環境頁時,AI 先根據倉庫生成草稿(安裝指令碼、啟動命令、需要的金鑰和變數),等你完成環境檢查後才會執行安裝指令碼。
  • 缺少金鑰或環境變數時,輸入框上方直接展開「检查环境」卡片。
  • 什麼都不缺時,點輸入框上方的「编辑环境」開啟同一張卡片確認。
AI 的處理步驟摺疊在「已处理 N 秒」下,可以點開檢視。

環境檢查三步

「检查环境」卡片分三步,用「下一步」「跳过」前進,最後一步點「完成检查」。缺少必填項時可以點「稍后处理」收起,卡片變成一行「需要你处理」,點它重新展開,已填的值保留。
  1. 確認安裝與啟動:檢視 AI 生成的「安装脚本」(建立環境和依賴變化時執行)和「启动命令」(每次喚醒環境後執行),點編輯按鈕可以修改。
  2. 配置金鑰:填寫每個金鑰的值。已儲存過的金鑰留空則不變。標「工作空间」的建議儲存為工作區級,同工作區的專案共用;其餘儲存為這個專案的金鑰。名稱只能包含字母、數字和下劃線,且不能以數字開頭。
  3. 配置環境變數:AI 有建議值的會預先填好,可以修改或「添加变量」。已儲存的變數不顯示原值,留空則保持不變。
金鑰和環境變數兩步要把必填值都填好,「下一步」才可用。

檢查完成後

點「完成检查」後,頁面顯示摘要「你已完成环境检查」(安裝與啟動是否修改、儲存了哪些金鑰、環境變數數量),AI 隨即用確認後的指令碼在雲主機上執行安裝指令碼。金鑰的值不會顯示在頁面上。

配置結果

環境已就緒

安裝指令碼透過後,頁面出現環境卡片「项目名 环境已就绪」,列出倉庫、執行時、安裝指令碼、啟動命令、金鑰(還沒填值的標「(未填写)」)和環境變數數量。
  • 「编辑」:重新開啟檢查卡片修改後再執行。
  • 「发布到云主机」:釋出後卡片變為「环境已发布」,點「开始任务」進入新會話頁並選中這個專案。

配置失敗

安裝指令碼沒透過時顯示錯誤資訊,不影響開始會話:
  • 「重试」:用最近一版指令碼再執行一次。
  • 「编辑环境」:修改指令碼後點「完成检查」重新執行。

繼續補充要求

配置失敗、已就緒或已釋出後,可以在頁面底部的輸入框(「继续补充要求」)裡傳送要求,AI 會據此重新配置。配置進行中不能傳送;這裡不能切換模型。

修改已釋出的環境

從「项目设置 › 环境」進入配置環境頁,點「编辑环境」,改完點「完成检查」會重新執行安裝指令碼。透過後專案進入「待发布」,需要再點「发布到云主机」才生效。 專案級的金鑰和變數也可以直接在「设置 › 工作区 › 密钥与环境变量」裡改,見 工作區設定。刪除變數後,已執行的環境需要重啟才生效。

注意與限制

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

常見問題

環境檢查跳過了,之後還能補金鑰嗎?

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

釋出前能改安裝指令碼嗎?

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

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

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

相關