docs(i18n): adopt jingtingxiang's calibrated terminology table and five gold pairs
术语表整体采用 jingtingxiang 的重构版（PR #244）：按缩写类/英文类/ 双语类分节、通用规则前置、首次出现与不要译作独立列；保留本 stack 的 mock/package/counterpart 与 agent 组合词裁定行。五组金标译文按 其定稿采用（development、i18n README、translation-rules、双语 RFC、 根 README），README.zh 吸收 PR #249 的两处措辞（「智能体辔架」括注 与其自身新表冲突，未采用）。translation-prompt.md 增补 Few-shot 金 标一节：声明这 5 组配对即流水线的整文档级 few-shot，注入方式为多轮 示例对话。style-samples 的 blob hash 译法按新表回改为保留英文。 Supersedes the .zh.md content of #244/#249/#264.
This commit is contained in:
Ziya
@@ -1,148 +1,165 @@
|
||||
# Terminology
|
||||
|
||||
本表约定本仓库的中英术语统一译法。各列语义：
|
||||
本表约定本仓库的中英术语统一译法。
|
||||
|
||||
- **中文** — 正文中的固定译法；写「保留英文」表示不译。
|
||||
- **首次出现** — 术语在一篇文档中第一次出现时的完整写法（含括注）；之后只写「中文」列的形式。组合词已括注过的成分，单独出现时不再括注。
|
||||
- **不要译作** — 禁用译法，逐项列出；出现任何一项即评审阻断。
|
||||
- **备注** — 语境区分、裁定出处等自由说明；不承载可执行规则。
|
||||
**通用规则：**
|
||||
- "中文"列为中文译文的正文默认用词。若该列为英文，则中文译文的正文中保留英文不翻译。
|
||||
- 首次出现按"首次出现"列书写（带括号注释）；后续出现只写括号前的部分（可能为中文，也可能为英文），不出现括号内的注释。
|
||||
- "不要译作"列为严格禁止的译法。
|
||||
- 如果某术语已经作为另一个术语的组成部分被括注过（如 `agent loop（智能体循环）` 中已包含 `agent` 的括注），则该术语后续单独出现时无需再次括注。
|
||||
|
||||
## 缩写类（中英文文本中均使用缩写）
|
||||
|
||||
| English | 中文 | 首次出现 | 不要译作 | 备注 |
|
||||
|---|---|---|---|---|
|
||||
| ACP | ACP | ACP（Agent Client Protocol） | | |
|
||||
| AI | AI | 人工智能（AI） | | |
|
||||
| API | API | | | real-API 作定语时可译「真实接口」（如 real-API tests → 真实接口测试） |
|
||||
| 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 单独首现处；组合词见下行 |
|
||||
| agent harness, agent workflow, agent loop, agent skill | 保留英文 | | | agent 组合词整体保留英文、不括注；其中的 workflow/loop/skill 不单独拆译；未列出的 agent 组合词同此处理 |
|
||||
| backlog | backlog | | | 双语翻译语境指待翻清单 |
|
||||
| blob hash | blob 哈希 | | | git 对象哈希；`git hash-object` 的结果 |
|
||||
| commit hash | 提交哈希 | | | |
|
||||
| hash | 哈希 | | | 代码与命令中保留英文（如 `git hash-object`、`<hash>` 占位符） |
|
||||
| doc-sync | doc-sync | | | 仓库门禁名，保留英文 |
|
||||
| e2e | e2e | | | |
|
||||
| fiber | fiber | fiber（插件运行时） | | |
|
||||
| fixture | fixture | | | 指测试前置数据或环境 |
|
||||
| fork | fork | | | 保留英文 |
|
||||
| harness | harness | | | 保留英文 |
|
||||
| manifest | manifest | | | 描述模块或工具元数据的文件 |
|
||||
| monorepo | monorepo | | | |
|
||||
| package | package | | | 保留英文；指 npm 包（`@deepseek-ai/dsh-*`） |
|
||||
| schema DSL | schema DSL | | | |
|
||||
| schema | schema | | | 保留英文 |
|
||||
| seam | seam | seam（扩展点） | | 同句已出现「扩展点」（extension point）时不加括注，直接写 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 | 消费方 | | | |
|
||||
| counterpart | 对侧文件 | | 对应物、配对物 | 双语配对语境；泛指“另一侧”时可写「另一侧」 |
|
||||
| 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 | 消息 | | | |
|
||||
| mock | mock | | | 保留英文；指测试替身 |
|
||||
| mod | 模组 | | | 区别于 module（模块）；plugin 译作「插件」 |
|
||||
| model provider | 模型提供方 | | | |
|
||||
| module | 模块 | | | |
|
||||
| orphan | 孤立 | | 孤儿 | git 官方中文同译（如「孤立分支」）；指英文源已不存在的 `.zh.md`；进程语境按 OS 惯用语译「孤儿进程」 |
|
||||
| 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 | 会话事件 | | | |
|
||||
| sidecar record | 伴随记录 | | 旁挂记录 | 指 `.i18n.yaml` 这类随主文件存放的记录文件 |
|
||||
| smoke test | 冒烟测试 | | | |
|
||||
| snapshot | 快照 | | | |
|
||||
| source of truth | 真源 | 真源（source of truth） | | 评审裁定译法；如后续裁定调整，改此表即可 |
|
||||
| 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 | 工作流 | | | |
|
||||
| ACP | ACP | ACP（Agent Client Protocol） | | |
|
||||
| AI | AI | AI（人工智能） | | |
|
||||
| API | API | | | |
|
||||
| CI | CI | | | |
|
||||
| CLI | CLI | CLI（命令行界面） | | |
|
||||
| e2e | e2e | | | |
|
||||
| HMR | HMR | HMR（热模块替换） | | |
|
||||
| JSON Schema | JSON Schema | | | |
|
||||
| JSONL | JSONL | | | |
|
||||
| LLM | LLM | LLM（大语言模型） | | |
|
||||
| MCP | MCP | | | |
|
||||
| PR | PR | PR（Pull Request） | | |
|
||||
| RAG | RAG | RAG（检索增强生成） | | |
|
||||
| SDK | SDK | | | |
|
||||
| SSE | SSE | SSE（Server-Sent Events） | | |
|
||||
|
||||
## 英文类（中英文文本中均使用英文）
|
||||
|
||||
| English | 中文 | 首次出现 | 不要译作 | 备注 |
|
||||
|---|---|---|---|---|
|
||||
| agent | agent | agent（智能体） | | |
|
||||
| agent harness | agent harness | | | agent 组合词（agent harness/workflow/loop/skill 等）整体保留英文；未括注过 agent 时首现按 agent 行处理 |
|
||||
| agent loop | agent loop | agent loop（智能体循环） | | |
|
||||
| backlog | backlog | backlog（待翻清单） | | 仅在双语翻译语境里括注`待翻清单` |
|
||||
| blob hash | blob hash | | | `git hash-object` 的结果 |
|
||||
| Cordis | Cordis | | | |
|
||||
| dispose | dispose | dispose（资源释放） | | |
|
||||
| doc-sync | doc-sync | doc-sync（文档同步门禁） | | |
|
||||
| fiber | fiber | fiber（插件运行时） | | |
|
||||
| fixture | fixture | fixture（测试前置数据） | | |
|
||||
| fork | fork | | | |
|
||||
| Function Calling | Function Calling | Function Calling（函数调用） | | |
|
||||
| harness | harness | | | |
|
||||
| harness engineering | harness engineering | | | |
|
||||
| lint | lint | | | |
|
||||
| mock | mock | | | 保留英文；指测试替身 |
|
||||
| loader | loader | | | |
|
||||
| manifest | manifest | manifest（元数据清单） | | |
|
||||
| monorepo | monorepo | | | |
|
||||
| package | package | | | 保留英文；指 npm 包（`@deepseek-ai/dsh-*`） |
|
||||
| schema | schema | | | |
|
||||
| schema DSL | schema DSL | | | |
|
||||
| seam | seam | | | 与 `extension point` 是不同概念；根据具体语境，可译为`服务边界`或`可替换点` |
|
||||
| skill | skill | skill（技能） | | |
|
||||
| spawn | spawn | | | |
|
||||
| steering | steering | steering（中途引导） | | |
|
||||
| subagent | subagent | | | |
|
||||
| thinking | thinking | | | API 字段保留英文；描述模型模式时译为`思考` |
|
||||
| transcript | transcript | transcript（文本记录） | | 指会话渲染给用户或编辑器的完整文本，区别于事件日志 |
|
||||
| waterfall | waterfall | waterfall（瀑布式事件） | | |
|
||||
| worktree | worktree | | | git 工作区概念 |
|
||||
|
||||
## 双语类（中英文文本各自使用中英文）
|
||||
|
||||
| English | 中文 | 首次出现 | 不要译作 | 备注 |
|
||||
|---|---|---|---|---|
|
||||
| adapter | 适配器 | | | |
|
||||
| adapter contract | 适配器契约 | 适配器契约（adapter contract） | | |
|
||||
| append-only | 仅追加 | | | |
|
||||
| artifact | 产物 | | | |
|
||||
| backend | 后端 | | | |
|
||||
| background task | 后台任务 | | | |
|
||||
| block | 块 | | | |
|
||||
| cancel | 取消 | | | |
|
||||
| capability | 能力 | | | |
|
||||
| checkpoint | 检查点 | | | |
|
||||
| chunk | 分片 | | | |
|
||||
| compaction | 压缩 | 压缩（compaction） | | |
|
||||
| config | 配置 | | | |
|
||||
| consumer | 消费方 | | | |
|
||||
| content block | 内容块 | | | |
|
||||
| context | 上下文 | | | |
|
||||
| counterpart | 对侧文件 | | 对应物、配对物 | 双语配对语境；泛指"另一侧"时可写「另一侧」 |
|
||||
| context compaction | 上下文压缩 | 上下文压缩（context compaction） | | |
|
||||
| contract | 契约 | | | 如：`pairing contract` →`配对契约` |
|
||||
| coverage | 覆盖率 | | | |
|
||||
| crash recovery | 崩溃恢复 | | | |
|
||||
| durability | 持久性 | | | |
|
||||
| enforcement frontier | 强制边界 | | | i18n 配对机制用语：manifest `required` 清单所划的门禁生效范围 |
|
||||
| event | 事件 | | | |
|
||||
| event log | 事件日志 | | | |
|
||||
| event stream | 事件流 | | | |
|
||||
| event-sourced | 事件溯源 | | | 沿用 DDD 社区通行译法 |
|
||||
| executor | 执行器 | | | |
|
||||
| extension | 扩展 | | | |
|
||||
| extension point | 扩展点 | | | 注意与 `seam` 区分 |
|
||||
| fail-fast | 快速失败 | | | |
|
||||
| fenced code block | 围栏代码块 | | | 沿用 MDN 中文翻译 |
|
||||
| fingerprint | 指纹 | | | i18n 配对机制用语：`.zh.md` 首行记录英文源 blob hash 的注释 |
|
||||
| finish reason | 结束原因 | | | |
|
||||
| foreground run | 前台运行 | | | |
|
||||
| freshness | 新鲜度 | | | 沿用 MDN 中文翻译；在本项目中指译文相对源文的同步状态 |
|
||||
| hook | 钩子 | | | |
|
||||
| implementation | 实现 | | | |
|
||||
| inference | 推理 | 推理（inference） | | 需要和 `reasoning` 区分时保留英文括注 |
|
||||
| info string | 信息字符串 | | | 沿用 CommonMark 中文翻译；指代码围栏 ``` 之后的语言标注 |
|
||||
| injection | 注入 | | | |
|
||||
| integration | 集成 | | | |
|
||||
| interface | 接口 | | | |
|
||||
| language switcher | 语言切换行 | | | i18n 配对机制用语：双语配对文件顶部的互链行 |
|
||||
| memory | 记忆 / 内存 | | | 与 `agent` 搭配时译为`记忆`（如 `agent memory` →`智能体记忆`）；指系统资源时译为`内存` |
|
||||
| merge | 合并 | | | |
|
||||
| message | 消息 | | | |
|
||||
| mod | 模组 | | | |
|
||||
| model provider | 模型提供方 | | | |
|
||||
| module | 模块 | | | |
|
||||
| orphan | 孤立 | | 孤儿 | 指英文源已不存在的 `.zh.md` |
|
||||
| orphan branch | 孤立分支 | | 孤儿分支 | 沿用 git 官方中文翻译 |
|
||||
| pairing | 配对 | | | |
|
||||
| permission | 权限 | | | |
|
||||
| persistence | 持久化 | | | |
|
||||
| pipeline | 流水线 | | | |
|
||||
| plugin | 插件 | | | |
|
||||
| prompt | 提示词 | | | |
|
||||
| provider | 提供方 | | | |
|
||||
| provider-neutral | 提供方无关 | | | |
|
||||
| quality gate | 质量门禁 | | | |
|
||||
| reasoning | 推理 | 推理（reasoning） | | 需要和 `inference` 区分时保留英文括注 |
|
||||
| reasoning_content | 思考内容 | | | |
|
||||
| registry | 注册表 | | | |
|
||||
| replay | 回放 | | | |
|
||||
| resume | 恢复 | | | |
|
||||
| runtime | 运行时 | | | |
|
||||
| sandbox | 沙箱 | | | |
|
||||
| service | 服务 | | | |
|
||||
| session | 会话 | | | |
|
||||
| session event | 会话事件 | | | |
|
||||
| sidecar record | 伴随记录 | | 旁挂记录 | 指与文档同目录的伴随记录文件 |
|
||||
| smoke test | 冒烟测试 | | | |
|
||||
| snapshot | 快照 | | | |
|
||||
| source of truth | 真源 | | | |
|
||||
| spine | 主干 | | | |
|
||||
| staged | 暂存 | | | 沿用 git 官方中文翻译 |
|
||||
| stale | 陈旧 | | 过期 | 与 `fresh`（`新鲜`）成对；门禁输出中保留英文 `stale` 不翻译；`expired` 才译为`过期` |
|
||||
| step | 步骤 | | | |
|
||||
| stream | 流 | | | |
|
||||
| streaming | 流式输出 | | | |
|
||||
| structural signature | 结构签名 | | | i18n 配对机制用语：门禁比对两侧文件时提取的有序结构序列（标题层级、代码块、列表等） |
|
||||
| system prompt | 系统提示词 | | | |
|
||||
| taxonomy | 分类体系 | | | |
|
||||
| token usage | token 用量 | | | |
|
||||
| tool | 工具 | | | |
|
||||
| tool call | 工具调用 | | | |
|
||||
| tool result | 工具结果 | | | |
|
||||
| tool schema | 工具 schema | | | |
|
||||
| toolkit | 工具包 | | | |
|
||||
| turn | 轮次 | | | |
|
||||
| typecheck | 类型检查 | | | |
|
||||
| vocabulary | 词汇 | | | |
|
||||
| wire format | 协议格式 | 协议格式（wire format） | | |
|
||||
| workflow | 工作流 | | | |
|
||||
|
||||
Reference in New Issue
Block a user