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

# 核心概念

> 会话、项目、云主机、本机执行、Harness 与模型、模型来源、权限、需要你处理和子代理，以及界面各区域的作用。

这页解释使用云 Agent 时会反复遇到的概念。最核心的两个是**会话**和**云主机**：你在会话里给 Agent 布置工作，Agent 在云主机或你的电脑上把它做完。

## 会话

**会话**是你和 Agent 围绕一件工作的完整记录，包括你的消息、Agent 的操作步骤、回复和改动。会话可以属于某个项目，也可以不在任何项目中。点侧栏的 **新对话** 发起会话；用完的会话可以归档，需要另起思路时可以从某条消息分叉出新会话。见[发起会话](https://docs.aihubmix.com/cn/cloud/sessions/start-a-session.md)和[管理会话](https://docs.aihubmix.com/cn/cloud/sessions/manage-sessions.md)。

## 项目

**项目**是会话所属的代码目录或仓库，分两类：

* **云端项目**：在云端新建、从 GitHub 导入或上传本地项目得到，在云主机上运行，可以为它配置环境。
* **本地项目**：在桌面客户端关联的本机文件夹，会话在那台电脑上执行，文件夹不会同步到云端。

不在任何项目中的会话在一个临时工作目录里运行，之后可以移进项目。见[项目与环境配置](https://docs.aihubmix.com/cn/cloud/environments/projects.md)。

## 云主机与本机执行

**云主机**是 Plus 附带的专属 Linux 机器，带公网 IP。会话在上面运行时，关掉电脑也会继续；你可以打开远程桌面查看 Agent 的操作，或亲自接管。

**本机执行**（界面上叫 **在你的设备上执行**）是另一种运行方式：Agent 仍在云端，但读写文件、运行命令都在你选定的电脑上进行，效果和在本机运行一样。这台电脑需要登录桌面客户端，并打开 **允许执行**。

| | 云主机 | 本机执行 |
| - | - | - |
| 用谁的环境和文件 | 云主机上的项目副本和项目环境 | 那台电脑上的环境和项目文件夹 |
| 能用的项目 | 云端项目、不在任何项目中的会话 | 那台电脑上的本地项目、不在任何项目中的会话 |
| 支持的 Harness | 全部 | 目前只支持 Claude Code |
| 电脑关机或断网 | 不受影响 | 当前任务暂停，重新连上后自动继续 |

运行位置在新建会话时选定，之后不能更换。见[云主机](https://docs.aihubmix.com/cn/cloud/environments/cloud-host.md)和[在本机执行](https://docs.aihubmix.com/cn/cloud/environments/your-device.md)。

## Harness 与模型

**Harness** 是运行 Agent 的框架，例如 Claude Code、Codex CLI；**模型**是 Harness 调用的大模型。会话发出第一条消息后 Harness 不能更换，模型仍然可以换。**推理强度**（界面上叫智力）决定模型思考的深度，可选档位因模型而异。见[选择模型](https://docs.aihubmix.com/cn/cloud/models/choose-a-model.md)。

## 模型来源

**模型来源**决定模型由谁提供、用量记在哪里。

| | Plus 模型 | 自带订阅 | BYOK |
| - | - | - | - |
| 是什么 | Plus 套餐包含的模型 | 你自己的 ChatGPT、Claude 等订阅账号 | 你自己添加的 API Key |
| 用量记在哪里 | Plus 套餐，不另扣费 | 该订阅账号的额度 | 对应服务商，按其价格计费 |

AIHubMix 在 BYOK 里只是一个普通的网关服务商：你自己添加的 AIHubMix API Key 和其他 Key 一样计费，与 Plus 无关。见[模型来源](https://docs.aihubmix.com/cn/cloud/models/model-sources.md)。

## 权限

**权限**决定 Agent 执行操作前要不要先问你，在输入框左下角选择：

* **请求批准**：修改环境外的文件或联网前，总是先问你。
* **替我批准**：只在检测到可能不安全的操作时询问。
* **完全访问**：在云端环境内不受限制地联网和访问所有文件。新会话默认是这一档。

会话进行中也可以随时改权限。

## 需要你处理

Agent 停下来等你批准命令、回答问题、提供密钥，或亲自完成登录这类它无法代劳的操作时，这个会话就处于**需要你处理**。请求显示在输入框上方，侧栏里这条会话也会标出；你处理完后会话自动继续。见[与 Agent 协作](https://docs.aihubmix.com/cn/cloud/sessions/work-with-agent.md)。

## 子代理

**子代理**是 Agent 在同一个会话里派出的帮手，把能并行的部分分头处理，全部结束后结果汇合回主会话。你可以在右侧面板查看每个子代理的过程，但不能直接给它发消息。它和你手动分叉出来的会话不同，分叉得到的是一个独立的普通会话。见[子代理](https://docs.aihubmix.com/cn/cloud/sessions/subagents.md)。

## 界面一览

* **图标栏**：窗口最左侧的一列图标，在云端任务、定时任务、项目、云主机和操作记录之间切换；最底部的头像打开账户菜单。
* **侧栏**：会话列表，按已置顶、云端项目、本地项目和最近分组。
* **会话区**：窗口中间的主区域，显示你和 Agent 的消息、操作步骤和结果。
* **输入框**：会话区底部，用来发消息、添加附件，选择模型、推理强度和权限。
* **右侧面板**：改动、文件、网页预览、云主机远程桌面、侧聊和子代理都在这里打开。

> [!NOTE]
>
> 手机网页没有图标栏，同样的入口在侧栏底部；右侧面板打开后铺满整个页面。


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