mirror of
https://github.com/deepseek-ai/deepseek-harness
synced 2026-08-15 21:04:50 +00:00
b49c37f83a
Add canonical Chinese bindings for build target, deploy root, peer dependency, serving surface, wheel, wrapper, and VFS so future translations have one source of truth. Apply the existing runtime, plugin, artifact, and pipeline bindings throughout every Chinese counterpart touched by this PR. Require the first Chinese use of peer dependency to retain the English term so readers can map it back to the package-manager concept without reintroducing mixed prose throughout the document. Rewrite mixed-language prose where the English term is not an identifier, while retaining package names, paths, flags, pkg, single-exe, and other literal names exactly. Explain VFS on first use and keep technical constraints readable without inventing compatibility terminology. Describe single-executable worker support as implemented behavior, including the filesystem-string entry contract and CommonJS worker artifact required by the pkg loader, and remove the obsolete bundled-but-unsupported limitation. Regenerate pairing fingerprints and the generated catalog reference so the mechanical documentation gates validate the revised English and Chinese pairs. This keeps the terminology table authoritative and prevents the two languages from drifting as the runtime documentation evolves.
6.4 KiB
6.4 KiB
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） |
| VFS | VFS | 首次出现写：虚拟文件系统（VFS） |
| 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 | 后端 | |
| build target | 构建目标 | |
| 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（释放资源）；正文优先保留英文 |
| deploy root | 部署根目录 | |
| 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 | 配对 | |
| peer dependency | 对等依赖 | 首次出现写：对等依赖（peer dependency） |
| permission | 权限 | |
| persistence | 持久化 | |
| pipeline | 流水线 | |
| plugin | 插件 | mod 对应“模组” |
| prompt | 提示词 | |
| provider | 提供方 | |
| provider-neutral | 提供方无关 | |
| quality gate | 质量门禁 | |
| registry | 注册表 | |
| reasoning | 推理（reasoning） | 需要和 inference 区分时保留英文括注；reasoning_content 译为“思考内容” |
| replay | 回放 | |
| resume | 恢复 | |
| runtime | 运行时 | |
| sandbox | 沙箱 | |
| service | 服务 | |
| serving surface | 对外服务接口 | |
| 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 | 词汇 | |
| wheel | wheel 包 | |
| workflow | 工作流 | |
| wrapper | 包装层 |