> ## 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 配置專案環境，在專案頁檢視會話、提交、檔案和網站預覽，以及分享、匯出、設定和刪除專案。

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

## 雲端專案和本地專案

* **雲端專案**：程式碼在你的[雲主機](https://docs.aihubmix.com/zh-Hant/cloud/environments/cloud-host.md)上，包括從零新建、從 GitHub 匯入和上傳本地專案三種來源。需要 Plus。
* **本地專案**：關聯你某臺電腦上的資料夾，會話在那臺電腦上執行，見[在本機執行](https://docs.aihubmix.com/zh-Hant/cloud/environments/your-device.md)。檔案不上傳，不需要雲主機。

側欄按這兩類分割槽顯示專案，專案建好後不會換區。在網頁版或另一臺電腦上，可以看到本地專案和它的會話，也能在裡面新建會話，但看不到還沒上雲的檔案和提交。

![專案列表](https://mintcdn.com/aihubmix/ADcIS2RBGw_ogRXt/images/cloud/en/projects.png?fit=max\&auto=format\&n=ADcIS2RBGw_ogRXt\&q=85\&s=163abfbe35d19fd703de8fb5a1a5b1fd)

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

## 新建專案

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

### 從零新建

**1. 填寫名稱**

最多 64 個字元，留空時使用 `my-app`。

**2. 選擇起點模板**

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

**3. 建立**

需要時勾選 **在 GitHub 建立私有倉庫**（需已連線 GitHub），然後點 **建立專案**。

### 從 GitHub 匯入

**1. 選擇倉庫**

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

**2. 開始建立**

點 **開始建立**，完成後進入新會話頁並選中這個專案。

![新建專案：從 GitHub 匯入](https://mintcdn.com/aihubmix/ADcIS2RBGw_ogRXt/images/cloud/en/new-project.png?fit=max\&auto=format\&n=ADcIS2RBGw_ogRXt\&q=85\&s=c08c4b54fadb27957fe5757eb30d873c)

從 GitHub 匯入倉庫

列表裡找不到倉庫時，點 **配置訪問許可權** 到 GitHub 調整授權，回來後點 **重新整理**。還沒連線 GitHub 的，見[聯結器](https://docs.aihubmix.com/zh-Hant/cloud/integrations/connectors.md)。

### 上傳本地專案

把資料夾拖進視窗或點 **選擇資料夾…**，確認檔案數和大小後點 **開始建立**。上傳有以下限制：總大小 2 GiB、最多 5 萬個檔案、單個檔案 100 MiB。`.gitignore` 裡的內容、`node_modules`、`.git`、`.env` 類檔案以及憑據、私鑰、證書會自動排除。

上傳失敗或取消後不會保留已傳的部分，重試會從頭開始。上傳的專案沒有遠端倉庫，改動以補丁交付。

> [!NOTE]
>
> 手機瀏覽器不能選擇資料夾，無法上傳本地專案。

### 關聯本機資料夾

**1. 選擇資料夾**

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

**2. 建立**

點 **建立專案**，進入新會話頁，執行位置預設是這臺電腦。

主目錄這類範圍太大的資料夾、沒有讀取許可權的資料夾不能選。建立後可以在專案設定裡附加同一臺電腦上的其他資料夾。

> [!NOTE]
>
> 只有桌面客戶端可以新建本地專案。

## 配置雲端專案的環境

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

**1. 開啟配置環境頁**

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

**2. 等 AI 生成草稿**

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

**3. 完成三步檢查**

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

**4. 釋出**

AI 在雲主機上執行安裝指令碼，透過後點 **釋出到雲主機**，再點 **開始任務** 進入新會話。失敗時可以點 **重試** 或 **編輯環境**，不影響開始會話。

之後可以在頁面底部輸入框繼續補充要求，AI 會據此重新配置。修改已釋出的環境後需要再次釋出才生效。不要在輸入框裡直接傳送金鑰，請在檢查步驟或金鑰設定裡填寫。

## 在專案頁檢視進展

點進一個專案，可以看到：

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

## 分享預覽或檔案

**1. 開啟分享**

在網站預覽裡點 **分享**，或在檔案檢視裡點 **分享檔案**。

**2. 設定訪問範圍和有效期**

可以選僅本人、持連結的人（預設）或公開，有效期 1 到 30 天（預設 7 天）。

**3. 複製連結**

點 **建立連結**，再點 **複製連結**。

> [!WARNING]
>
> 連結只顯示這一次，關閉後無法再檢視，請立即複製。選擇公開前請確認內容可以公開。

在 **我的分享** 裡可以撤銷連結（立即失效）或重新分享已過期的連結。當日流量超限的分享會暫停，次日恢復。

## 修改專案設定

從專案頁右上角 **專案設定** 或專案選單 **編輯** 進入，改完點 **儲存** 生效。

* **名稱與描述**：名稱 1 到 64 個字元。
* **倉庫**：主倉庫不能移除，可以從 GitHub 拉取最新；點 **新增倉庫** 輸入 `owner/name` 一起克隆其他倉庫。
* **基礎分支**：會話從這個分支建立工作分支，推送和 PR 也以它為目標。
* **提交方式**：建立 PR（預設）、推送分支或自定義；**提交作者** 可選 AIHubMix Agent（預設）或你的 GitHub 帳號。提交和 PR 見[審閱與交付成果](https://docs.aihubmix.com/zh-Hant/cloud/sessions/review-and-deliver.md)。

### 管理金鑰與環境變數

在 **設定 › 工作區 › 金鑰與環境變數** 裡新增和編輯。每個專案有自己的一組，另有所有專案共用的一組；同名時專案的值優先。

* 金鑰加密儲存，AI 看不到原值。編輯時看不到原值，需要輸入新值覆蓋。
* 點 **批次新增** 可以直接貼上 `.env` 內容，每行一個 `KEY=value`，名稱裡含 KEY、TOKEN、SECRET、PASSWORD 的會按金鑰儲存。
* 刪除沒有二次確認，已執行的環境需要重啟才生效。
* 在本機執行時，裝置設定決定哪些工作區金鑰會提供給那臺電腦，見[在本機執行](https://docs.aihubmix.com/zh-Hant/cloud/environments/your-device.md)。

### 匯出專案

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

## 刪除專案

在專案選單或專案設定裡點 **刪除專案…** 並確認。專案裡的會話會被歸檔，可以在 **設定 › 工作區 › 已歸檔對話** 找回。有未推送的改動時會列出提示，需要輸入專案名才能刪除。

> [!WARNING]
>
> 刪除會清除這個專案在雲端的環境、檔案和依賴快取，無法恢復。本地專案在你電腦上的資料夾不受影響。


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