> ## 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/cn/cloud/environments/cloud-host.md)上，包括从零新建、从 GitHub 导入和上传本地项目三种来源。需要 Plus。
* **本地项目**：关联你某台电脑上的文件夹，会话在那台电脑上执行，见[在本机执行](https://docs.aihubmix.com/cn/cloud/environments/your-device.md)。文件不上传，不需要云主机。

侧栏按这两类分区显示项目，项目建好后不会换区。在网页版或另一台电脑上，可以看到本地项目和它的会话，也能在里面新建会话，但看不到还没上云的文件和提交。

![项目列表](https://mintcdn.com/aihubmix/ADcIS2RBGw_ogRXt/images/cloud/cn/projects.png?fit=max\&auto=format\&n=ADcIS2RBGw_ogRXt\&q=85\&s=e5c9de520677923ac21473e6338aceb6)

项目页列出工作区里的全部项目

## 新建项目

点侧栏分区标题上的 **+**、项目页的 **新建项目**，或新会话输入框上方项目菜单里的 **新建项目**。新建云端项目时如果还没有 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/cn/new-project.png?fit=max\&auto=format\&n=ADcIS2RBGw_ogRXt\&q=85\&s=8b50d562895aff121c4c1e6ee4bae0f3)

从 GitHub 导入仓库

列表里找不到仓库时，点 **配置访问权限** 到 GitHub 调整授权，回来后点 **刷新**。还没连接 GitHub 的，见[连接器](https://docs.aihubmix.com/cn/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/cn/cloud/sessions/review-and-deliver.md)。

### 管理密钥与环境变量

在 **设置 › 工作区 › 密钥与环境变量** 里添加和编辑。每个项目有自己的一组，另有所有项目共用的一组；同名时项目的值优先。

* 密钥加密保存，AI 看不到原值。编辑时看不到原值，需要输入新值覆盖。
* 点 **批量添加** 可以直接粘贴 `.env` 内容，每行一个 `KEY=value`，名称里含 KEY、TOKEN、SECRET、PASSWORD 的会按密钥保存。
* 删除没有二次确认，已运行的环境需要重启才生效。
* 在本机执行时，设备设置决定哪些工作区密钥会提供给那台电脑，见[在本机执行](https://docs.aihubmix.com/cn/cloud/environments/your-device.md)。

### 导出项目

在项目设置里点 **导出…**，再点 **开始导出**，打包完成后点 **下载压缩包**。压缩包不含 `.env`、密钥、依赖与缓存。需要云主机正在运行，只有项目所有者可以导出。

## 删除项目

在项目菜单或项目设置里点 **删除项目…** 并确认。项目里的会话会被归档，可以在 **设置 › 工作区 › 已归档对话** 找回。有未推送的改动时会列出提示，需要输入项目名才能删除。

> [!WARNING]
>
> 删除会清除这个项目在云端的环境、文件和依赖缓存，无法恢复。本地项目在你电脑上的文件夹不受影响。


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