> ## 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/cn/cloud/projects/run-environment.md)，已归档对话见 [归档](https://docs.aihubmix.com/cn/cloud/settings/archived.md)。

## 适用范围

桌面客户端、网页版、手机网页都支持；手机网页上设置导航改为分组列表，点进详情。

## 入口

账户菜单 ›「设置」，左侧导航「工作区」分组。

## 基本信息

| 行 | 显示 | 操作 |
| - | - | - |
| Workspace 名称 | 当前名称，没有时为「未命名」 | 「修改」 |
| 项目 | 「N 个项目」 | 「查看」打开「设置 › 工作区 › 项目」 |
| 成员 | 个人工作区显示「只有你 · 所有者」；团队工作区显示「团队工作区 · 成员管理暂未开放」 | 无 |

修改名称时，名称 1–64 个字符，不能为空。

### 云主机管理员权限

「基本信息」下方是「云主机管理员权限」开关（开启后 Agent 可以在云主机上安装软件、调整系统配置；默认开启）和它的实际状态，见 [云主机管理员权限](https://docs.aihubmix.com/cn/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/cn/cloud/projects/run-environment.md)。
* AI 配置环境时发现缺少的密钥和变量，会在 [环境检查](https://docs.aihubmix.com/cn/cloud/projects/environment-setup.md) 里请你填写，结果也保存在这里。

## 项目

「设置 › 工作区 › 项目」列出工作区的所有项目，每行显示名称、来源（GitHub 仓库或文件夹）、状态（如「待配置环境」「配置失败」「只在本机」）和变量数。点一行进入项目页，点行尾齿轮直接打开项目设置。状态含义见 [项目环境](https://docs.aihubmix.com/cn/cloud/projects/environment-setup.md) 和 [项目](https://docs.aihubmix.com/cn/cloud/projects/projects.md)。

## 项目设置

单个项目的设置可以从项目列表的齿轮、项目页右上角「项目设置」或项目菜单「编辑」进入：

| 区域 | 内容 | 生效方式 |
| - | - | - |
| 项目信息 | 名称、描述、仓库或来源文件夹、基础分支、提交方式、提交作者、额外克隆的仓库 | 点「保存」后生效，可「放弃」 |
| 环境 | 安装脚本、启动命令 | 重新运行并发布后生效 |
| 密钥与环境变量 | 项目级的项，以及「继承自 Workspace」的项 | 删除即时生效；添加和编辑在「设置 › 工作区 › 密钥与环境变量」里做 |
| 删除项目 | 「删除项目…」 | 确认后立即生效 |
| 导出项目 | 「下载项目压缩包」 | 点击后开始下载 |

详见 [项目](https://docs.aihubmix.com/cn/cloud/projects/projects.md) 和 [项目环境](https://docs.aihubmix.com/cn/cloud/projects/environment-setup.md)。

## 常见问题

### 项目和工作区里都有同名变量，用哪个？

用项目里的。「所有项目共用」的值只在项目里没有同名项时生效。

### AI 能看到我填的密钥吗？

不能。密钥加密保存，界面和对话里只显示名称，运行时才提供给环境。

## 相关

* [项目](https://docs.aihubmix.com/cn/cloud/projects/projects.md)
* [项目环境](https://docs.aihubmix.com/cn/cloud/projects/environment-setup.md)
* [运行环境：本机与云主机](https://docs.aihubmix.com/cn/cloud/projects/run-environment.md)
* [云主机管理员权限](https://docs.aihubmix.com/cn/cloud/cloud-host/admin-permission.md)
* [归档](https://docs.aihubmix.com/cn/cloud/settings/archived.md)


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