> ## 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.

# 設定 › 工作區：基本資訊、金鑰與環境變數、專案

> 工作區設定裡的基本資訊、金鑰與環境變數（專案級與所有專案共用、批次新增）、專案列表與專案設定入口。

**工作區**是專案、會話、金鑰和環境變數的歸屬範圍。「设置」導航的「工作区」分組包含「基本信息」「机器」「密钥与环境变量」「项目」「已归档对话」。本頁說明基本資訊、金鑰與環境變數和專案；機器見 [執行環境：本機與雲主機](https://docs.aihubmix.com/zh-Hant/cloud/projects/run-environment.md)，已歸檔對話見 [歸檔](https://docs.aihubmix.com/zh-Hant/cloud/settings/archived.md)。

## 適用範圍

桌面客戶端、網頁版、手機網頁都支援；手機網頁上設定導航改為分組列表，點進詳情。

## 入口

帳戶選單 ›「设置」，左側導航「工作区」分組。

## 基本資訊

| 行 | 顯示 | 操作 |
| - | - | - |
| Workspace 名稱 | 當前名稱，沒有時為「未命名」 | 「修改」 |
| 專案 | 「N 个项目」 | 「查看」開啟「设置 › 工作区 › 项目」 |
| 成員 | 個人工作區顯示「只有你 · 所有者」；團隊工作區顯示「团队工作区 · 成员管理暂未开放」 | 無 |

修改名稱時，名稱 1–64 個字元，不能為空。

### 雲主機管理員許可權

「基本信息」下方是「云主机管理员权限」開關（開啟後 Agent 可以在雲主機上安裝軟體、調整系統配置；預設開啟）和它的實際狀態，見 [雲主機管理員許可權](https://docs.aihubmix.com/zh-Hant/cloud/cloud-host/admin-permission.md)。

## 金鑰與環境變數

頁面分兩部分：

* **專案**：每個專案一組，顯示專案名、來源和摘要（如「2 个变量 · 1 个密钥」）。
* **所有專案共用**：工作區級，對每個專案生效。

規則：

* 同名時專案的值優先；專案裡沒有同名項時才用「所有项目共用」的值。專案組裡覆蓋了工作區的項帶「覆盖 Workspace」，工作區組裡被覆蓋的項帶「N 个项目覆盖」。
* 金鑰加密儲存，AI 看不到原值；介面上金鑰的值顯示為圓點。
* 每組右上角有「批量添加」和「添加密钥或变量」；每行有編輯和刪除按鈕。刪除沒有二次確認。

### 新增或編輯

| 欄位 | 說明 |
| - | - |
| 名稱 | 自動轉為大寫，空格換成下劃線，例如 `API_BASE_URL`；編輯時不能改 |
| 值 | 必填。編輯時看不到原值，需要輸入新值覆蓋 |
| 型別 | 「变量」（預設）或「密钥」 |

### 批次新增

點「批量添加」，每行寫一個 `KEY=value`，可以直接貼上 `.env` 檔案內容，同名的會被覆蓋：

* 名稱裡含 KEY、TOKEN、SECRET、PASSWORD 的按金鑰儲存，其餘按變數儲存。
* 空行和 `#` 開頭的行會被忽略；支援 `export KEY=value`；值兩端成對的引號會被去掉。
* 名稱只能包含字母、數字和下劃線，不能以數字開頭，最長 64 個字元；值不能為空；同一名稱不能寫兩行。
* 不合格的行留在文字框裡並標出「第 N 行：原因」，其餘行照常儲存。

### 金鑰會用在哪裡

* 雲主機上的專案環境：按上面的同名優先規則取值。
* 本機方式執行時：裝置的「可下发的密钥」決定哪些工作區金鑰會提供給那臺電腦，見 [執行環境：本機與雲主機](https://docs.aihubmix.com/zh-Hant/cloud/projects/run-environment.md)。
* AI 配置環境時發現缺少的金鑰和變數，會在 [環境檢查](https://docs.aihubmix.com/zh-Hant/cloud/projects/environment-setup.md) 裡請你填寫，結果也儲存在這裡。

## 專案

「设置 › 工作区 › 项目」列出工作區的所有專案，每行顯示名稱、來源（GitHub 倉庫或資料夾）、狀態（如「待配置环境」「配置失败」「只在本机」）和變數數。點一行進入專案頁，點行尾齒輪直接開啟專案設定。狀態含義見 [專案環境](https://docs.aihubmix.com/zh-Hant/cloud/projects/environment-setup.md) 和 [專案](https://docs.aihubmix.com/zh-Hant/cloud/projects/projects.md)。

## 專案設定

單個專案的設定可以從專案列表的齒輪、專案頁右上角「项目设置」或專案選單「编辑」進入：

| 區域 | 內容 | 生效方式 |
| - | - | - |
| 專案資訊 | 名稱、描述、倉庫或來原始檔夾、基礎分支、提交方式、提交作者、額外克隆的倉庫 | 點「保存」後生效，可「放弃」 |
| 環境 | 安裝指令碼、啟動命令 | 重新執行併發布後生效 |
| 金鑰與環境變數 | 專案級的項，以及「继承自 Workspace」的項 | 刪除即時生效；新增和編輯在「设置 › 工作区 › 密钥与环境变量」裡做 |
| 刪除專案 | 「删除项目…」 | 確認後立即生效 |
| 匯出專案 | 「下载项目压缩包」 | 點選後開始下載 |

詳見 [專案](https://docs.aihubmix.com/zh-Hant/cloud/projects/projects.md) 和 [專案環境](https://docs.aihubmix.com/zh-Hant/cloud/projects/environment-setup.md)。

## 常見問題

### 專案和工作區裡都有同名變數，用哪個？

用專案裡的。「所有项目共用」的值只在專案裡沒有同名項時生效。

### AI 能看到我填的金鑰嗎？

不能。金鑰加密儲存，介面和對話裡只顯示名稱，執行時才提供給環境。

## 相關

* [專案](https://docs.aihubmix.com/zh-Hant/cloud/projects/projects.md)
* [專案環境](https://docs.aihubmix.com/zh-Hant/cloud/projects/environment-setup.md)
* [執行環境：本機與雲主機](https://docs.aihubmix.com/zh-Hant/cloud/projects/run-environment.md)
* [雲主機管理員許可權](https://docs.aihubmix.com/zh-Hant/cloud/cloud-host/admin-permission.md)
* [歸檔](https://docs.aihubmix.com/zh-Hant/cloud/settings/archived.md)


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