> ## Documentation Index
> Fetch the complete documentation index at: https://ahvn.top/llms.txt
> Use this file to discover all available pages before exploring further.

# 术语表

> HeavenBase 的关键术语与概念，含中文翻译对照。

<Note>
  英文文档与中文（`zh/`）翻译的规范术语。译者应遵循 `_docs-guide/doc-trans.md` 与 `_docs-guide/terminology.md`。
</Note>

<br />

## 1. 核心概念

| 术语                   | 定义                                                   |
| -------------------- | ---------------------------------------------------- |
| **工作区 (Workspace)**  | 承载 schema、后端、路由与数据的 `HeavenBase` 容器                  |
| **实体 (Entity)**      | 带类型字段的逻辑 schema 类；继承 `hb.Entity`                     |
| **后端 (Backend)**     | 物理存储提供商（SQLite、Postgres、Milvus、内存等）                  |
| **路由 (Routing)**     | 实体字段到后端实例与策略的字段级映射                                   |
| **处理器 (Handler)**    | 为特定后端编译的操作级执行单元                                      |
| **策略 (Strategy)**    | 后端内的存储策略（如 `InlineColumn`、`SideTable`、`VectorIndex`） |
| **目录 (Catalog)**     | 工作区中具体实体实例的用户可见目录                                    |
| **MetaSchema**       | 内部的工作区、实体、字段、路由、后端与能力元数据目录                           |
| **入口 (Gateway，LLM)** | 在 preset、model、provider 解析后发送 LLM 请求的传输适配器           |
| **端点 (Endpoint)**    | HeavenBase 通过 gateway 调用的 provider 基础 URL 或 API 面    |
| **提供商 (Provider)**   | 托管模型的服务（OpenRouter、OpenAI、Anthropic 等）               |
| **预设 (Preset)**      | 命名的 LLM 配置包（model、gateway、默认参数）                      |
| **模型 (Model)**       | 通过 LLM 目录解析的规范模型键或别名                                 |
| **智能体 (Agent)**      | 使用工作区 API、工具与 LLM preset 的自主执行者                      |
| **代理 (Proxy)**       | 应用于出站 LLM 或 DB 请求的 HTTP 或环境代理设置                      |
| **路由 (Router)**      | 请求路由层（区别于字段级存储路由）                                    |
| **提示 (Prompt)**      | 由 Capsule 清单与系统提示行支撑的 callable 提示实体                  |
| **规范 (Spec)**        | 结构化操作描述符，如 `QuerySpec` 或 `FieldSpec`                 |
| **查询 (Query)**       | 由 Python 或 JSON 过滤器编译的类型化数据检索操作                      |
| **嵌入 (Embedding)**   | 嵌入模型产生的向量表示                                          |
| **向量 (Vector)**      | 由向量后端存储与检索的数值数组                                      |
| **会话 (Session)**     | 持久化的多轮 LLM 对话记录                                      |
| **工具集 (Toolkit)**    | 从工作区生成的 MCP 工具集合                                     |
| **Capsule**          | 作为 HeavenBase 实体存储的可序列化 Python callable              |
| **ConfigManager**    | HeavenBase 原生配置管理器                                   |

<br />

## 2. 中文翻译对照

| 英文                 | 中文          | 保留英文                |
| ------------------ | ----------- | ------------------- |
| Gateway (for LLMs) | 入口          | 否                   |
| Endpoint           | 端点          | 否                   |
| Preset             | 预设 / 预置     | 代码标识符保留             |
| Provider           | 提供商         | 代码标识符保留             |
| Model              | 模型          | 代码标识符保留             |
| Agent              | 智能体 / Agent | 均可；强调时用 **Agent**   |
| Proxy              | 代理          | 否                   |
| Router             | 路由          | 否                   |
| Prompt             | 提示 / 提示词    | 代码标识符保留             |
| Workspace          | 工作区         | 否                   |
| Entity             | 实体          | 否                   |
| Spec               | 规范          | 类型名保留英文             |
| Query              | 查询          | 否                   |
| Embedding          | 嵌入          | 否                   |
| Vector             | 向量          | 否                   |
| Session            | 会话          | 否                   |
| Toolkit            | 工具集         | 导航中的 **Toolkit** 保留 |
| Backend            | 后端          | 否                   |
| Handler            | 处理器         | 否                   |
| Routing            | 路由          | 否                   |
| Catalog            | 目录          | 否                   |
| Caching            | 缓存          | 否                   |
| HeavenBase         | HeavenBase  | 是                   |
| Harness            | Harness     | 是                   |
| MCP                | MCP         | 是                   |
| Skill              | Skill       | 是                   |
| Hook               | Hook        | 是                   |
| LLM                | LLM         | 是                   |
| Capsule            | Capsule     | 是                   |
| Mintlify           | Mintlify    | 是                   |

<br />

## 3. 中文文档格式规则

* 中文正文中引用短语时使用直角引号「」。
* 首次提出、标题、强调或与代码标识符并列时，在中文后追加英文原名括号：入口 (Gateway)、端点 (Endpoint)、预设 (Preset)。
* 避免随意使用「运行时」类表述；优先用具体术语。仅当明确指执行语境且无更清晰词时，用「执行」。
* 不要翻译代码围栏内的可执行代码、配置键、CLI 标志、包名、文件路径或 URL。

<br />