Canonical terminology for English docs and Chinese (zh/) translations. Translators should follow _docs-guide/doc-trans.md and _docs-guide/terminology.md.
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 |
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 |
- 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.
