diff --git a/docs/i18n/terminology.md b/docs/i18n/terminology.md
new file mode 100644
index 0000000000..f9baa40adc
--- /dev/null
+++ b/docs/i18n/terminology.md
@@ -0,0 +1,113 @@
+# Terminology
+
+本表约定本仓库的中英术语统一译法。
+
+| English | 中文 | 备注 |
+|---|---|---|
+| ACP | ACP | 首次出现可写：ACP（Agent Client Protocol） |
+| AI | AI | 首次出现可写：人工智能（AI） |
+| API | API | |
+| 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 | |
+| RAG | RAG | 首次出现可写：检索增强生成（RAG） |
+| SDK | SDK | |
+| SSE | SSE | 首次出现可写：SSE（Server-Sent Events） |
+| agent | agent | 首次出现可写：agent（智能体） |
+| agent loop | agent loop | |
+| fiber | fiber | 首次出现可写：fiber（插件运行时） |
+| fixture | fixture | 指测试前置数据或环境 |
+| fork | fork | 保留英文 |
+| harness | harness | 保留英文 |
+| manifest | manifest | 描述模块或工具元数据的文件 |
+| 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（瀑布式事件） |
+| 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） |
+| coverage | 覆盖率 | |
+| crash recovery | 崩溃恢复 | |
+| dispose | dispose | 首次出现可写：dispose（释放资源）；正文优先保留英文 |
+| durability | 持久性 | |
+| event log | 事件日志 | |
+| event | 事件 | |
+| event stream | 事件流 | |
+| executor | 执行器 | |
+| extension | 扩展 | |
+| finish reason | 结束原因 | |
+| foreground run | 前台运行 | |
+| hook | 钩子 | |
+| implementation | 实现 | |
+| inference | 推理（inference） | 每次提及时保留英文括注，避免与 reasoning 混淆 |
+| injection | 注入 | |
+| interface | 接口 | |
+| integration | 集成 | |
+| memory | memory / 记忆 / 内存 | 按上下文区分：agent memory 译为“记忆”；resource/memory usage 译为“内存” |
+| message | 消息 | |
+| mod | 模组 | 区别于 module（模块）；plugin 译作「插件」 |
+| model provider | 模型提供方 | |
+| module | 模块 | |
+| 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 | 会话事件 | |
+| snapshot | 快照 | |
+| spine | 主干 | |
+| step | 步骤 | |
+| stream | 流 | |
+| streaming | 流式输出 | |
+| system prompt | 系统提示词 | |
+| taxonomy | 分类体系 | |
+| token usage | token 用量 | |
+| thinking | thinking | API 字段保留；模型模式译为“思考” |
+| tool | 工具 | |
+| tool call | 工具调用 | |
+| tool result | 工具结果 | |
+| tool schema | 工具 schema | |
+| toolkit | 工具包 | |
+| turn | 轮次 | |
+| typecheck | 类型检查 | |
+| vocabulary | 词汇 | |
+| workflow | 工作流 | |