# 术语表

文档中反复出现的术语，每个用一句话定义，并链接到讲解它的页面。

| 术语 | 定义 | 详见 |
| --- | --- | --- |
| Space | 权限和路径的边界，成员、角色和文件树都按 Space 划分，每个账户有一个默认 Space。 | [核心概念](https://mirabase.io/zh/developers/concepts.md#space) |
| Entry | 一份来源的稳定身份，可以是文件、网址或一段文本。 | [核心概念](https://mirabase.io/zh/developers/concepts.md#entry-version) |
| 版本 | Entry 内容的一次不可变记录，内容每变化一次产生一个新版本。 | [核心概念](https://mirabase.io/zh/developers/concepts.md#entry-version) |
| 知识状态 | Entry 的处理进度，报告在 `knowledge.state` 上。 | [核心概念](https://mirabase.io/zh/developers/concepts.md#knowledge) |
| 记忆 | 一条有范围、状态和来源的陈述，可以是账户记忆、以 Entry 写入的记忆，或从 Entry 提炼的事实。 | [记忆](https://mirabase.io/zh/developers/memory.md#model) |
| 记忆范围 | 记忆归属的对象：`project` 属于一个 Space，`agent` 属于一个 Agent，`account` 属于账户。 | [记忆](https://mirabase.io/zh/developers/memory.md#model) |
| 记忆状态 | 记忆在审核中的位置：`candidate`、`confirmed`、`rejected` 或 `superseded`。 | [记忆](https://mirabase.io/zh/developers/memory.md#model) |
| 主体 | 请求以其身份执行的人（`kind: human`）或 Agent（`kind: agent`），API Key 属于主体但本身不是主体。 | [权限](https://mirabase.io/zh/developers/permissions.md#principals) |
| 能力 | 对一类操作的许可，例如 `knowledge:read` 或 `knowledge:write`。 | [权限](https://mirabase.io/zh/developers/permissions.md#capabilities) |
| API Key | 每个请求以 `Authorization: Bearer mb_live_...` 发送的凭据，只能收窄其主体的权限。 | [认证与 API Key](https://mirabase.io/zh/developers/authentication.md#bearer) |
| Agent | `kind: agent` 的主体，有自己的权限、记忆和审计身份。 | [权限](https://mirabase.io/zh/developers/permissions.md#principals) |
| 上下文包 | `context` 为一个任务返回的结果：服务挑选来源，在 token 预算内打包，并在 `route` 中说明取舍。 | [检索与上下文](https://mirabase.io/zh/developers/retrieval.md#context) |
| 引用 | 上下文包中一条来源的 `[cN]` 编号，回答用它标注出处。 | [检索与上下文](https://mirabase.io/zh/developers/retrieval.md#answer) |
| 分支 | 叠在 Space 主线上的写时复制层，用作 Agent 的工作区，合并后才在主线产生版本。 | [分支与挂载](https://mirabase.io/zh/developers/branches.md#branches) |
| 检查点 | 分支自身改动在某一时刻的记录，分支可以回滚到这个检查点。 | [分支与挂载](https://mirabase.io/zh/developers/branches.md#checkpoints) |
| 快照 | 某一时刻 Space 里每个文件的路径和版本的记录，不复制任何字节。 | [同步、快照与导出](https://mirabase.io/zh/developers/sync.md#snapshots) |
| 提案 | Agent 对他人文件提交的待审核写入，审核人批准后才写成新版本。 | [文件与版本](https://mirabase.io/zh/developers/files.md#proposals) |
| 任务 | 单次请求内无法完成的工作，返回 202 和 `job_id`，可轮询任务直至进入终态。 | [API 约定](https://mirabase.io/zh/developers/conventions.md#jobs) |
| 读取根路径 | Space 所有者为成员设定的 `read_root`，成员只能读取这个目录及其下的内容，其外的路径返回 404。 | [权限](https://mirabase.io/zh/developers/permissions.md#roots) |
| 写入根路径 | Space 所有者为成员设定的 `write_root`，成员只能在这个目录下写入。 | [权限](https://mirabase.io/zh/developers/permissions.md#roots) |
| 幂等键 | 写请求上的 `Idempotency-Key` 请求头，带相同的键重发不会再执行一遍。 | [API 约定](https://mirabase.io/zh/developers/conventions.md#idempotency) |
| 游标 | 列表或变更流返回的不透明字符串，用于读取下一页或继续读取。 | [API 约定](https://mirabase.io/zh/developers/conventions.md#pagination) |
| ETag | 文件最新版本的 id，用于条件写入和条件读取。 | [API 约定](https://mirabase.io/zh/developers/conventions.md#conditional) |
| 离线整理 | 部署可选的功能，在没有 Agent 工作时整理已有的记忆、不生成新内容，API 把一次运行称为 dream。 | [记忆](https://mirabase.io/zh/developers/memory.md#dreams) |

## 下一步

- [文件与版本](https://mirabase.io/zh/developers/files.md)：从写入一个文件开始。
- [权限](https://mirabase.io/zh/developers/permissions.md)：主体、能力、角色和根路径如何共同决定一次请求。
- [API 参考](https://mirabase.io/zh/developers/api.md)：每个接口的参数和响应。
