跳轉到主要內容
專案是一組程式碼來源加上它的環境設定,來源可以是 GitHub 倉庫、上傳到雲主機的資料夾,或你電腦上的一個資料夾。會話可以放在專案裡執行,也可以不屬於任何專案。

雲端專案和本地專案

  • 雲端專案:程式碼在你的雲主機上,包括從零新建、從 GitHub 匯入和上傳本地專案三種來源。需要 Plus。
  • 本地專案:關聯你某臺電腦上的資料夾,會話在那臺電腦上執行,見在本機執行。檔案不上傳,不需要雲主機。
側欄按這兩類分割槽顯示專案,專案建好後不會換區。在網頁版或另一臺電腦上,可以看到本地專案和它的會話,也能在裡面新建會話,但看不到還沒上雲的檔案和提交。
專案列表

專案頁列出工作區裡的全部專案

新建專案

點側欄分割槽標題上的 +、專案頁的 新建專案,或新會話輸入框上方專案選單裡的 新建專案。新建雲端專案時如果還沒有 Plus,會先開啟訂閱視窗,開通後點繼續即可回到新建視窗,已選的倉庫會保留。

從零新建

1

填寫名稱

最多 64 個字元,留空時使用 my-app。
2

選擇起點模板

例如空專案、Node · TypeScript、Next.js、Python,以介面顯示為準。
3

建立

需要時勾選 在 GitHub 建立私有倉庫(需已連線 GitHub),然後點 建立專案。

從 GitHub 匯入

1

選擇倉庫

勾選一個或多個倉庫。選了多個時,第一個是主倉庫,其餘一起克隆進專案。
2

開始建立

點 開始建立,完成後進入新會話頁並選中這個專案。
新建專案:從 GitHub 匯入

從 GitHub 匯入倉庫

列表裡找不到倉庫時,點 配置訪問許可權 到 GitHub 調整授權,回來後點 重新整理。還沒連線 GitHub 的,見聯結器。

上傳本地專案

把資料夾拖進視窗或點 選擇資料夾…,確認檔案數和大小後點 開始建立。上傳有以下限制:總大小 2 GiB、最多 5 萬個檔案、單個檔案 100 MiB。.gitignore 裡的內容、node_modules、.git、.env 類檔案以及憑據、私鑰、證書會自動排除。 上傳失敗或取消後不會保留已傳的部分,重試會從頭開始。上傳的專案沒有遠端倉庫,改動以補丁交付。
手機瀏覽器不能選擇資料夾,無法上傳本地專案。

關聯本機資料夾

1

選擇資料夾

在新建本地專案視窗的來原始檔夾裡點 新增。專案名稱自動填為資料夾名,可以修改。
2

建立

點 建立專案,進入新會話頁,執行位置預設是這臺電腦。
主目錄這類範圍太大的資料夾、沒有讀取許可權的資料夾不能選。建立後可以在專案設定裡附加同一臺電腦上的其他資料夾。
只有桌面客戶端可以新建本地專案。

配置雲端專案的環境

專案環境包括安裝指令碼、啟動命令,以及專案要用的金鑰和環境變數。配置是可選的,專案建好就能開始會話;本地專案使用電腦自身的環境,不需要這一步。
1

開啟配置環境頁

在 專案設定 › 環境 點編輯按鈕。配置環境頁是專案上的獨立頁面,不會出現在會話列表裡。
2

等 AI 生成草稿

AI 讀取倉庫,生成安裝指令碼、啟動命令和需要的金鑰與變數。完成檢查前不會執行任何指令碼。
3

完成三步檢查

依次確認安裝指令碼和啟動命令、填寫金鑰、填寫環境變數,必填項填好後點 完成檢查。暫時沒有可以點 稍後處理,已填的值會保留。
4

釋出

AI 在雲主機上執行安裝指令碼,透過後點 釋出到雲主機,再點 開始任務 進入新會話。失敗時可以點 重試 或 編輯環境,不影響開始會話。
之後可以在頁面底部輸入框繼續補充要求,AI 會據此重新配置。修改已釋出的環境後需要再次釋出才生效。不要在輸入框裡直接傳送金鑰,請在檢查步驟或金鑰設定裡填寫。

在專案頁檢視進展

點進一個專案,可以看到:
  • 最近會話:進行中和等你批准的會被標出,點 檢視全部 檢視這個專案的全部記錄。
  • 提交記錄:當前分支最近的提交,點開可以看改動的檔案和增刪行數。
  • 檔案:目錄裡有 README 時直接顯示。Markdown 等檔案可以切換預覽和原始碼,也可以複製或分享。.env、私鑰等敏感檔案不會顯示。
  • 網站預覽:雲主機上這個專案正在監聽的服務,例如 localhost:3000,點 開啟 在應用內預覽。讓 Agent 啟動開發伺服器後這裡就會出現入口,雲主機沒有執行時無法預覽。

分享預覽或檔案

1

開啟分享

在網站預覽裡點 分享,或在檔案檢視裡點 分享檔案。
2

設定訪問範圍和有效期

可以選僅本人、持連結的人(預設)或公開,有效期 1 到 30 天(預設 7 天)。
3

複製連結

點 建立連結,再點 複製連結。
連結只顯示這一次,關閉後無法再檢視,請立即複製。選擇公開前請確認內容可以公開。
在 我的分享 裡可以撤銷連結(立即失效)或重新分享已過期的連結。當日流量超限的分享會暫停,次日恢復。

修改專案設定

從專案頁右上角 專案設定 或專案選單 編輯 進入,改完點 儲存 生效。
  • 名稱與描述:名稱 1 到 64 個字元。
  • 倉庫:主倉庫不能移除,可以從 GitHub 拉取最新;點 新增倉庫 輸入 owner/name 一起克隆其他倉庫。
  • 基礎分支:會話從這個分支建立工作分支,推送和 PR 也以它為目標。
  • 提交方式:建立 PR(預設)、推送分支或自定義;提交作者 可選 AIHubMix Agent(預設)或你的 GitHub 帳號。提交和 PR 見審閱與交付成果。

管理金鑰與環境變數

在 設定 › 工作區 › 金鑰與環境變數 裡新增和編輯。每個專案有自己的一組,另有所有專案共用的一組;同名時專案的值優先。
  • 金鑰加密儲存,AI 看不到原值。編輯時看不到原值,需要輸入新值覆蓋。
  • 點 批次新增 可以直接貼上 .env 內容,每行一個 KEY=value,名稱裡含 KEY、TOKEN、SECRET、PASSWORD 的會按金鑰儲存。
  • 刪除沒有二次確認,已執行的環境需要重啟才生效。
  • 在本機執行時,裝置設定決定哪些工作區金鑰會提供給那臺電腦,見在本機執行。

匯出專案

在專案設定裡點 匯出…,再點 開始匯出,打包完成後點 下載壓縮包。壓縮包不含 .env、金鑰、依賴與快取。需要雲主機正在執行,只有專案所有者可以匯出。

刪除專案

在專案選單或專案設定裡點 刪除專案… 並確認。專案裡的會話會被歸檔,可以在 設定 › 工作區 › 已歸檔對話 找回。有未推送的改動時會列出提示,需要輸入專案名才能刪除。
刪除會清除這個專案在雲端的環境、檔案和依賴快取,無法恢復。本地專案在你電腦上的資料夾不受影響。