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

# Glossary

> Key terms and concepts in HeavenBase, including Chinese translation reference.

<Note>
  Canonical terminology for English docs and Chinese (`zh/`) translations. Translators should follow `_docs-guide/doc-trans.md` and `_docs-guide/terminology.md`.
</Note>

<br />

## 1. Core Concepts

| Term                   | Definition                                                                                 |
| ---------------------- | ------------------------------------------------------------------------------------------ |
| **Workspace**          | The `HeavenBase` container that holds schema, backends, routes, and data                   |
| **Entity**             | A logical schema class with typed fields; extends `hb.Entity`                              |
| **Backend**            | A physical storage provider (SQLite, Postgres, Milvus, in-memory, …)                       |
| **Routing**            | Field-level mapping from entity fields to backend instances and strategies                 |
| **Handler**            | An operation-specific execution unit compiled for a specific backend                       |
| **Strategy**           | A storage strategy within a backend (e.g., `InlineColumn`, `SideTable`, `VectorIndex`)     |
| **Catalog**            | The user-facing directory of concrete entity instances in a workspace                      |
| **MetaSchema**         | The internal workspace, entity, field, route, backend, and capability metadata catalog     |
| **Gateway (for LLMs)** | The transport adapter that sends LLM requests after preset, model, and provider resolution |
| **Endpoint**           | A provider base URL or API surface HeavenBase calls through a gateway                      |
| **Provider**           | The service that hosts a model (OpenRouter, OpenAI, Anthropic, …)                          |
| **Preset**             | A named LLM configuration bundle (model, gateway, default args)                            |
| **Model**              | A canonical model key or alias resolved through the LLM catalog                            |
| **Agent**              | An autonomous actor that uses workspace APIs, tools, and LLM presets                       |
| **Proxy**              | HTTP or environment proxy settings applied to outbound LLM or DB requests                  |
| **Router**             | Request routing layer (distinct from field-level storage routing)                          |
| **Prompt**             | A callable prompt entity backed by Capsule manifests and system prompt rows                |
| **Spec**               | A structured operation descriptor such as `QuerySpec` or `FieldSpec`                       |
| **Query**              | A typed data retrieval operation compiled from Python or JSON filters                      |
| **Embedding**          | A vector representation produced by an embedding model                                     |
| **Vector**             | A numeric array stored and searched by vector backends                                     |
| **Session**            | A persisted multi-turn LLM conversation record                                             |
| **Toolkit**            | An MCP tool collection generated from a workspace                                          |
| **Capsule**            | A serialized Python callable stored as a HeavenBase entity                                 |
| **ConfigManager**      | The HeavenBase-native configuration manager                                                |

<br />

## 2. Chinese Translation Reference

| English            | Chinese     | Keep English                                  |
| ------------------ | ----------- | --------------------------------------------- |
| Gateway (for LLMs) | 入口          | No                                            |
| Endpoint           | 端点          | No                                            |
| Preset             | 预设 / 预置     | Identifier in code                            |
| Provider           | 提供商         | Identifier in code                            |
| Model              | 模型          | Identifier in code                            |
| Agent              | 智能体 / Agent | Either; capitalize **Agent** when emphasizing |
| Proxy              | 代理          | No                                            |
| Router             | 路由          | No                                            |
| Prompt             | 提示 / 提示词    | Identifier in code                            |
| Workspace          | 工作区         | No                                            |
| Entity             | 实体          | No                                            |
| Spec               | 规范          | Type names stay English                       |
| Query              | 查询          | No                                            |
| Embedding          | 嵌入          | No                                            |
| Vector             | 向量          | No                                            |
| Session            | 会话          | No                                            |
| Toolkit            | 工具集         | Product name **Toolkit** in nav               |
| Backend            | 后端          | No                                            |
| Handler            | 处理器         | No                                            |
| Routing            | 路由          | No                                            |
| Catalog            | 目录          | No                                            |
| Caching            | 缓存          | No                                            |
| HeavenBase         | HeavenBase  | Yes                                           |
| Harness            | Harness     | Yes                                           |
| MCP                | MCP         | Yes                                           |
| Skill              | Skill       | Yes                                           |
| Hook               | Hook        | Yes                                           |
| LLM                | LLM         | Yes                                           |
| Capsule            | Capsule     | Yes                                           |
| Mintlify           | Mintlify    | Yes                                           |

<br />

## 3. Formatting Rules for Chinese Docs

* Use corner brackets 「」 for quoted phrases in Chinese prose.
* On first mention, in headings, emphasis, or when paired with code identifiers, append the English original in parentheses: 入口 (Gateway), 端点 (Endpoint), 预设 (Preset).
* Avoid casual "runtime" wording; prefer concrete terms. Use 执行 only when execution context is the intended meaning.
* Do not translate executable code, config keys, CLI flags, package names, file paths, or URLs inside code fences.

<br />