# Terminology

本表约定本仓库的中英术语统一译法。

| English | 中文 | 备注 |
|---|---|---|
| ACP | ACP | 首次出现可写：ACP（Agent Client Protocol） |
| AI | AI | 首次出现可写：人工智能（AI） |
| API | API | |
| CI | CI | |
| CLI | CLI | 首次出现可写：命令行界面（CLI） |
| Cordis | Cordis | 保留英文 |
| Function Calling | Function Calling | 首次出现可写：Function Calling（函数调用） |
| HMR | HMR | 首次出现可写：热模块替换（HMR） |
| JSON Schema | JSON Schema | |
| JSONL | JSONL | |
| lint | lint | |
| loader | loader | |
| LLM | LLM | 首次出现可写：大语言模型（LLM） |
| MCP | MCP | |
| PR | PR | 首次出现可写：PR（pull request） |
| RAG | RAG | 首次出现可写：检索增强生成（RAG） |
| SDK | SDK | |
| SSE | SSE | 首次出现可写：SSE（Server-Sent Events） |
| agent | agent | 首次出现可写：agent（智能体） |
| agent loop | agent loop | |
| backlog | backlog | 双语翻译语境指待翻清单 |
| blob hash | blob hash | git 对象哈希；`git hash-object` 的结果 |
| doc-sync | doc-sync | 仓库门禁名，保留英文 |
| e2e | e2e | |
| fiber | fiber | 首次出现可写：fiber（插件运行时） |
| fixture | fixture | 指测试前置数据或环境 |
| fork | fork | 保留英文 |
| harness | harness | 保留英文 |
| manifest | manifest | 描述模块或工具元数据的文件 |
| monorepo | monorepo | |
| schema DSL | schema DSL | |
| schema | schema | 保留英文 |
| seam | seam | 首次出现可写：seam（扩展点） |
| skill | skill | 首次出现可写：skill（技能） |
| spawn | spawn | 保留英文 |
| steering | steering | 首次出现可写：steering（中途引导） |
| subagent | subagent | 首次出现可写：subagent（子 agent） |
| transcript | transcript | 首次出现可写：transcript（文本记录）；指会话渲染给用户或编辑器的完整文本，区别于事件日志（event log） |
| waterfall | waterfall | 首次出现可写：waterfall（瀑布式事件） |
| worktree | worktree | git 工作区概念，保留英文 |
| wire format | 协议格式 | 首次出现可写：协议格式（wire format） |
| adapter contract | 适配器契约 | 首次出现可写：适配器契约（adapter contract） |
| adapter | 适配器 | |
| append-only | 仅追加 | |
| artifact | 产物 | |
| block | 块 | |
| background task | 后台任务 | |
| backend | 后端 | |
| capability | 能力 | |
| cancel | 取消 | |
| checkpoint | 检查点 | |
| chunk | 分片 | |
| compaction | compaction | 首次出现可写：compaction（上下文压缩）；正文优先保留英文 |
| consumer | 消费方 | |
| content block | 内容块 | |
| config | 配置 | |
| context | 上下文 | |
| context compaction | 上下文压缩 | 首次出现可写：上下文压缩（context compaction） |
| contract | 契约 | 如：配对契约（pairing contract）；另见 adapter contract |
| coverage | 覆盖率 | |
| crash recovery | 崩溃恢复 | |
| dispose | dispose | 首次出现可写：dispose（释放资源）；正文优先保留英文 |
| durability | 持久性 | |
| enforcement frontier | 强制边界 | i18n 机制词：manifest `required` 清单所划的门禁生效范围 |
| event log | 事件日志 | |
| event | 事件 | |
| event stream | 事件流 | |
| event-sourced | 事件溯源 | DDD 社区通行译法 |
| executor | 执行器 | |
| extension | 扩展 | |
| fail-fast | 快速失败 | |
| fenced code block | 围栏代码块 | MDN 中文同译 |
| finish reason | 结束原因 | |
| fingerprint | 指纹 | i18n 机制词：`.zh.md` 首行记录英文源 blob hash 的 `i18n-source` 注释 |
| foreground run | 前台运行 | |
| freshness | 新鲜度 | MDN HTTP 缓存中文同译（freshness lifetime → 新鲜度生命周期）；指译文相对英文源的同步状态 |
| hook | 钩子 | |
| implementation | 实现 | |
| inference | 推理（inference） | 每次提及时保留英文括注，避免与 reasoning 混淆 |
| info string | 信息字符串 | CommonMark 中文同译；代码围栏 ``` 之后的语言标注 |
| injection | 注入 | |
| interface | 接口 | |
| integration | 集成 | |
| language switcher | 语言切换行 | i18n 机制词：双语配对文件顶部的互链行 |
| memory | memory / 记忆 / 内存 | 按上下文区分：agent memory 译为“记忆”；resource/memory usage 译为“内存” |
| message | 消息 | |
| mod | 模组 | 区别于 module（模块）；plugin 译作「插件」 |
| model provider | 模型提供方 | |
| module | 模块 | |
| orphan | 孤立 | git 官方中文同译（如「孤立分支」）；指英文源已不存在的 `.zh.md`；不要译作：孤儿 |
| pairing | 配对 | |
| permission | 权限 | |
| persistence | 持久化 | |
| pipeline | 流水线 | |
| plugin | 插件 | mod 对应“模组” |
| prompt | 提示词 | |
| provider | 提供方 | |
| provider-neutral | 提供方无关 | |
| quality gate | 质量门禁 | |
| registry | 注册表 | |
| reasoning | 推理（reasoning） | 需要和 inference 区分时保留英文括注；`reasoning_content` 译为“思考内容” |
| replay | 回放 | |
| resume | 恢复 | |
| runtime | 运行时 | |
| sandbox | 沙箱 | |
| service | 服务 | |
| session | 会话 | |
| session event | 会话事件 | |
| smoke test | 冒烟测试 | |
| snapshot | 快照 | |
| spine | 主干 | |
| staged | 暂存 | git 官方中文同译 |
| stale | 陈旧 | MDN HTTP 缓存中文同译，与「新鲜（fresh）」成对；门禁输出保留英文 `stale`；expired 才译「过期」 |
| step | 步骤 | |
| stream | 流 | |
| streaming | 流式输出 | |
| structural signature | 结构签名 | i18n 机制词：配对门禁比对的有序结构序列 |
| system prompt | 系统提示词 | |
| taxonomy | 分类体系 | |
| token usage | token 用量 | |
| thinking | thinking | API 字段保留；模型模式译为“思考” |
| tool | 工具 | |
| tool call | 工具调用 | |
| tool result | 工具结果 | |
| tool schema | 工具 schema | |
| toolkit | 工具包 | |
| turn | 轮次 | |
| typecheck | 类型检查 | |
| vocabulary | 词汇 | |
| workflow | 工作流 | |
