Terminology

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

通用规则:

  • "中文"列为中文译文的正文默认用词。若该列为英文,则中文译文的正文中保留英文不翻译。
  • 首次出现按"首次出现"列书写(带括号注释);后续出现只写括号前的部分(可能为中文,也可能为英文),不出现括号内的注释。
  • "不要译作"列为严格禁止的译法。
  • 如果某术语已经作为另一个术语的组成部分被括注过(如 agent loop(智能体循环) 中已包含 agent 的括注),则该术语后续单独出现时无需再次括注。

缩写类(中英文文本中均使用缩写)

English 中文 首次出现 不要译作 备注
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 只指受支持的 Python 与 TypeScript SDK 所使用的 JSON-RPC 客户端/服务器协议;DeepSeek Harness 项目本身不是 SDK
SSE SSE SSE(Server-Sent Events)

英文类(中英文文本中均使用英文)

English 中文 首次出现 不要译作 备注
agent agent agent(智能体)
Agent Note Agent Note 智能体注记、智能体笔记 仓库定义的文档类型,涵盖提案、已实现决策和被否决提案;中文对侧 H1 保持固定前缀 # Agent Note: ,标题中不加术语括注
agent harness agent harness agent harness(智能体框架) agent 组合词(agent harness/workflow/loop/skill 等)整体保留英文;未括注过 agent 时首现按对应组合词或 agent 行处理
agent loop agent loop agent loop(智能体循环)
blob hash blob hash git hash-object 的结果
coding agent coding agent coding agent(编程智能体) agent 组合词,正文保留英文
Cordis Cordis
dispose dispose dispose(资源释放)
doc-sync doc-sync doc-sync(文档同步门禁)
fiber fiber
fixture fixture fixture(测试前置数据)
fork fork
Function Calling Function Calling Function Calling(函数调用)
harness harness
harness engineering harness engineering
KV Cache KV Cache 专有技术名称,保持大小写与空格
lint lint
mock mock 保留英文;指测试替身
loader loader
manifest manifest manifest(元数据清单)
monorepo monorepo
Round Round 回合、目标回合、Ralph 回合 外层策略使用 Round 时,领域层级为 Session > Round > Turn(轮次) > Step(步骤);Round 是可选的外层策略迭代,并非每个会话轮次都具有的通用层级。Goal Round 与 Ralph Round 均保留英文。一个 Round 承载一个轮次,步骤隶属于该轮次;明确的零步骤轮次仍保持原义。
schema schema
schema DSL schema DSL
seam seam 接缝 一个可替换能力的整体,包含 Service Definition / Service Provider / Consumer 三种角色;角色需要独立演化时才拆包,也可由同一包承担多个角色。以 packages/shell 为范例;Service Definition 是 Cordis Service(抽象类或具体 registry 服务),不是 TypeScript interface。任何单一角色、普通边界或扩展点都不能称为 seam。本仓库正文保留英文;与 extension point 是不同概念
Service Provider Service Provider Service provider 能力 seam 的命名角色;单数固定写作 Service Provider,复数写作 Service Providers。泛指提供服务的 provider 不适用本词条
skill skill skill(技能)
slot slot 坑位、孔位 客户端架构中的具名可注册位置,保留英文
spill spill 工具输出超限落盘机制;组合词写 spill 文件spill 路径
spawn spawn
steering steering steering(中途引导)
job id job id 任务 id 保留英文
subagent subagent
transcript transcript transcript(文本记录) 指会话渲染给用户或编辑器的完整文本,区别于事件日志
Typert Typert TypeRT、typeRT、Type RT DeepSeek Harness 类型图、生成器、loader 与运行时 registry 的产品拼写
waterfall waterfall waterfall(瀑布式事件)
wheel wheel 包 Python 打包格式
worktree worktree git 工作区概念
Zstandard Zstandard RFC 8878 compression format; zstd remains a code value.

双语类(中英文文本各自使用中英文)

English 中文 首次出现 不要译作 备注
adapter 适配器
adapter contract 适配器约定 适配器约定(adapter contract)
append-only 仅追加
artifact 产物 制品
backend 后端
binder 绑定器 命名角色:把已声明接口绑定到调用方 context 或生命周期
config 配置 命名角色:一个已解析配置值或边界严格的配置记录
controller 控制器 命名角色:接受意图并改变一项既有领域或展示状态
directory 目录 命名角色:暴露供发现或选择的条目及元数据
engine 引擎 命名角色:实现领域算法或有状态执行模型
gateway 网关 命名角色:适配进程、网络、RPC 或 API 边界
handle 句柄 命名角色:引用并控制或观察一个实时资源
policy 策略 命名角色:决定允许、选择、限制或观察什么
presenter 展示转换器 命名角色:把领域值纯转换为渲染意图
resolver 解析器 命名角色:根据输入计算或定位一个答案
store 存储 命名角色:拥有一组数据并主要提供数据操作
background job 后台任务
block
build target 构建目标
cancel 取消
canary test canary 测试 金丝雀测试 本仓库保留 canary
capability 能力 必须与 feature功能 区分
capability seam 能力 seam 功能 seam、能力接缝 本仓库 Service Definition、Service Provider 与 Consumer 三种角色组成完整可替换能力的命名架构概念;普通 seam 仍按其词条处理
feature 功能 能力 SDK 产品与工程模型中的可管理产品单元
feature option 功能选项 variant 一项 SDK 功能内有限、可选择的实现或配置
checkpoint 检查点
chunk 分片
compaction 压缩 压缩(compaction)
companion tool 配套工具
composition bundle 组合包 只约束应用或插件的组合语境,不约束所有 bundle
Cordis plugin config Cordis 插件配置 Cordis 插件公开的 Config 对象或配置结构
config key 配置键 Cordis 插件配置中的单个字段
consumer 消费方 消费者
content block 内容块
Cookbook 实操手册 文档标题用语
context 上下文
counterpart 对侧文件 对应物、配对物 双语配对语境;泛指"另一侧"时可写「另一侧」
configurable-provider directory 可配置提供方目录 llm seam 中 registerConfigurableProviders() 维护的目录;沿用 Service Catalog →「服务目录」先例
context compaction 上下文压缩 上下文压缩(context compaction)
contract 约定 如:pairing contract配对约定
Cordis config entry Cordis 配置项 cordis.yml 插件列表中的一项;插件实现本身写Cordis 插件
Cordis plugin Cordis 插件 Cordis 加载的插件实现,不指 cordis.yml 中的一项配置
crash recovery 崩溃恢复
deploy root 部署根目录
dormant 休眠 睡眠、蛰伏 指已声明可配置但当前未注册路由的提供方
durability 持久性
feature requirement 功能依赖 功能或功能选项通过 requires 声明的关系
event 事件
event log 事件日志
event stream 事件流
event-sourced 事件溯源 沿用 DDD 社区通行译法
Executive summary 摘要 事故复盘标题用语
executor 执行器
expected output 预期输出 金标 指 snapshot 比较产物;翻译语料的人工校准样例不在此列
extension 扩展
extension point 扩展点 注意与 seam 区分
fail-fast 快速失败
fenced code block 围栏代码块 沿用 MDN 中文翻译
fingerprint 指纹 通用内容指纹;双语配对机制使用 sidecar record 记录两侧 blob hash
finish reason 结束原因
fold 折叠区 配置界面语境:默认收起的字段分区(collapsed →「收起」)
foreground run 前台运行
freshness 新鲜度 沿用 MDN 中文翻译;在本项目中指译文相对源文的同步状态
hook 钩子
implementation 实现
inference 推理 推理(inference) 需要和 reasoning 区分时保留英文括注
info string 信息字符串 沿用 CommonMark 中文翻译;指代码围栏 ``` 之后的语言标注
injection 注入
integration 集成
interface 接口
language switcher 语言切换行 i18n 配对机制用语:双语配对文件顶部的互链行
merge 合并
message 消息
mod 模组
model provider 模型提供方
model selection 模型选择 模型目标 面向 Agent 的提供方、模型和可选推理强度选择。
module 模块
non-escalation 非升权 非升级、不可升级 仅用于安全与权限语境,指主体不得获得超出既有授权的权限;普通升级不适用此行
npm dependency NPM 依赖 package.json 中的包关系;dependenciesdevDependencies 等字段保持原样
opt-out ratio opt-out 比例 退出检查比例
orphan 遗留 孤儿、孤立 指英文源已不存在的 .zh.md(如「遗留译文」);进程语境按 OS 惯用语译「孤儿进程」
orphan branch 孤立分支 孤儿分支 沿用 git 官方中文翻译
package 指 npm 包(@deepseek-ai/dsh-*);package.json 等代码标识保持原样
pairing 配对
parent-subset grants 父级子集授权 父集合授权 指授权范围仅限于父级所持授权的子集
peer dependency 对等依赖 对等依赖(peer dependency)
permission 权限
persistence 持久化
pipeline 流水线
plugin 插件
postmortem 事故复盘 事故复盘(postmortem) 事后分析、事故记录 事故记录与分析文档;目录或路径中的 postmortem 保持代码形式
prompt 提示词
provider 提供方
provider-neutral 提供方无关 提供方中立
quality gate 质量门禁
quiescence 完全停稳 静默、静止状态 指生命周期工作全部结算后的状态
reasoning 推理 推理(reasoning) 需要和 inference 区分时保留英文括注
reasoning_content 思考内容
registry 注册表
replay 回放
resume 恢复
runtime 运行时
same-world subprocess 与宿主共享文件系统和内核的子进程 同世界子进程
sandbox 沙箱
service 服务
serving interface 对外服务接口
session 会话
session event 会话事件
setup card 设置卡片 首次运行时代替行卡直接展开的配置卡
sidecar file 伴随文件 指与文档同目录的普通伴随文件
sidecar record 伴随记录 旁挂记录 指与文档同目录的伴随记录文件
smoke test 冒烟测试
snapshot 快照
source of truth 真源 事实来源、唯一来源
spine 主干
stale 陈旧 过期 fresh新鲜)成对;门禁输出中保留英文 stale 不翻译;expired 才译为过期
step 步骤
stream
structural signature 结构签名 i18n 配对机制用语:门禁比对两侧文件时提取的有序结构序列(标题层级、代码块、列表等)
Summary 概述 事故复盘标题用语
system prompt 系统提示词
taxonomy 分类体系
token usage token 用量
tool 工具
tool call 工具调用
tool result 工具结果
tool schema 工具 schema
toolkit 工具包
turn 轮次
VFS VFS 虚拟文件系统(VFS)
typecheck 类型检查
vocabulary 词汇
wire format 协议格式 协议格式(wire format)
workflow 工作流
wrapper 包装层 软件层或 SDK 包装层
wrapper script 包装脚本 可执行脚本包装层
This page has no Chinese translation yet; showing the English source.本页暂无中文版,以下为英文原文。

Terminology

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

通用规则:

  • "中文"列为中文译文的正文默认用词。若该列为英文,则中文译文的正文中保留英文不翻译。
  • 首次出现按"首次出现"列书写(带括号注释);后续出现只写括号前的部分(可能为中文,也可能为英文),不出现括号内的注释。
  • "不要译作"列为严格禁止的译法。
  • 如果某术语已经作为另一个术语的组成部分被括注过(如 agent loop(智能体循环) 中已包含 agent 的括注),则该术语后续单独出现时无需再次括注。

缩写类(中英文文本中均使用缩写)

English 中文 首次出现 不要译作 备注
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 只指受支持的 Python 与 TypeScript SDK 所使用的 JSON-RPC 客户端/服务器协议;DeepSeek Harness 项目本身不是 SDK
SSE SSE SSE(Server-Sent Events)

英文类(中英文文本中均使用英文)

English 中文 首次出现 不要译作 备注
agent agent agent(智能体)
Agent Note Agent Note 智能体注记、智能体笔记 仓库定义的文档类型,涵盖提案、已实现决策和被否决提案;中文对侧 H1 保持固定前缀 # Agent Note: ,标题中不加术语括注
agent harness agent harness agent harness(智能体框架) agent 组合词(agent harness/workflow/loop/skill 等)整体保留英文;未括注过 agent 时首现按对应组合词或 agent 行处理
agent loop agent loop agent loop(智能体循环)
blob hash blob hash git hash-object 的结果
coding agent coding agent coding agent(编程智能体) agent 组合词,正文保留英文
Cordis Cordis
dispose dispose dispose(资源释放)
doc-sync doc-sync doc-sync(文档同步门禁)
fiber fiber
fixture fixture fixture(测试前置数据)
fork fork
Function Calling Function Calling Function Calling(函数调用)
harness harness
harness engineering harness engineering
KV Cache KV Cache 专有技术名称,保持大小写与空格
lint lint
mock mock 保留英文;指测试替身
loader loader
manifest manifest manifest(元数据清单)
monorepo monorepo
Round Round 回合、目标回合、Ralph 回合 外层策略使用 Round 时,领域层级为 Session > Round > Turn(轮次) > Step(步骤);Round 是可选的外层策略迭代,并非每个会话轮次都具有的通用层级。Goal Round 与 Ralph Round 均保留英文。一个 Round 承载一个轮次,步骤隶属于该轮次;明确的零步骤轮次仍保持原义。
schema schema
schema DSL schema DSL
seam seam 接缝 一个可替换能力的整体,包含 Service Definition / Service Provider / Consumer 三种角色;角色需要独立演化时才拆包,也可由同一包承担多个角色。以 packages/shell 为范例;Service Definition 是 Cordis Service(抽象类或具体 registry 服务),不是 TypeScript interface。任何单一角色、普通边界或扩展点都不能称为 seam。本仓库正文保留英文;与 extension point 是不同概念
Service Provider Service Provider Service provider 能力 seam 的命名角色;单数固定写作 Service Provider,复数写作 Service Providers。泛指提供服务的 provider 不适用本词条
skill skill skill(技能)
slot slot 坑位、孔位 客户端架构中的具名可注册位置,保留英文
spill spill 工具输出超限落盘机制;组合词写 spill 文件spill 路径
spawn spawn
steering steering steering(中途引导)
job id job id 任务 id 保留英文
subagent subagent
transcript transcript transcript(文本记录) 指会话渲染给用户或编辑器的完整文本,区别于事件日志
Typert Typert TypeRT、typeRT、Type RT DeepSeek Harness 类型图、生成器、loader 与运行时 registry 的产品拼写
waterfall waterfall waterfall(瀑布式事件)
wheel wheel 包 Python 打包格式
worktree worktree git 工作区概念
Zstandard Zstandard RFC 8878 compression format; zstd remains a code value.

双语类(中英文文本各自使用中英文)

English 中文 首次出现 不要译作 备注
adapter 适配器
adapter contract 适配器约定 适配器约定(adapter contract)
append-only 仅追加
artifact 产物 制品
backend 后端
binder 绑定器 命名角色:把已声明接口绑定到调用方 context 或生命周期
config 配置 命名角色:一个已解析配置值或边界严格的配置记录
controller 控制器 命名角色:接受意图并改变一项既有领域或展示状态
directory 目录 命名角色:暴露供发现或选择的条目及元数据
engine 引擎 命名角色:实现领域算法或有状态执行模型
gateway 网关 命名角色:适配进程、网络、RPC 或 API 边界
handle 句柄 命名角色:引用并控制或观察一个实时资源
policy 策略 命名角色:决定允许、选择、限制或观察什么
presenter 展示转换器 命名角色:把领域值纯转换为渲染意图
resolver 解析器 命名角色:根据输入计算或定位一个答案
store 存储 命名角色:拥有一组数据并主要提供数据操作
background job 后台任务
block
build target 构建目标
cancel 取消
canary test canary 测试 金丝雀测试 本仓库保留 canary
capability 能力 必须与 feature功能 区分
capability seam 能力 seam 功能 seam、能力接缝 本仓库 Service Definition、Service Provider 与 Consumer 三种角色组成完整可替换能力的命名架构概念;普通 seam 仍按其词条处理
feature 功能 能力 SDK 产品与工程模型中的可管理产品单元
feature option 功能选项 variant 一项 SDK 功能内有限、可选择的实现或配置
checkpoint 检查点
chunk 分片
compaction 压缩 压缩(compaction)
companion tool 配套工具
composition bundle 组合包 只约束应用或插件的组合语境,不约束所有 bundle
Cordis plugin config Cordis 插件配置 Cordis 插件公开的 Config 对象或配置结构
config key 配置键 Cordis 插件配置中的单个字段
consumer 消费方 消费者
content block 内容块
Cookbook 实操手册 文档标题用语
context 上下文
counterpart 对侧文件 对应物、配对物 双语配对语境;泛指"另一侧"时可写「另一侧」
configurable-provider directory 可配置提供方目录 llm seam 中 registerConfigurableProviders() 维护的目录;沿用 Service Catalog →「服务目录」先例
context compaction 上下文压缩 上下文压缩(context compaction)
contract 约定 如:pairing contract配对约定
Cordis config entry Cordis 配置项 cordis.yml 插件列表中的一项;插件实现本身写Cordis 插件
Cordis plugin Cordis 插件 Cordis 加载的插件实现,不指 cordis.yml 中的一项配置
crash recovery 崩溃恢复
deploy root 部署根目录
dormant 休眠 睡眠、蛰伏 指已声明可配置但当前未注册路由的提供方
durability 持久性
feature requirement 功能依赖 功能或功能选项通过 requires 声明的关系
event 事件
event log 事件日志
event stream 事件流
event-sourced 事件溯源 沿用 DDD 社区通行译法
Executive summary 摘要 事故复盘标题用语
executor 执行器
expected output 预期输出 金标 指 snapshot 比较产物;翻译语料的人工校准样例不在此列
extension 扩展
extension point 扩展点 注意与 seam 区分
fail-fast 快速失败
fenced code block 围栏代码块 沿用 MDN 中文翻译
fingerprint 指纹 通用内容指纹;双语配对机制使用 sidecar record 记录两侧 blob hash
finish reason 结束原因
fold 折叠区 配置界面语境:默认收起的字段分区(collapsed →「收起」)
foreground run 前台运行
freshness 新鲜度 沿用 MDN 中文翻译;在本项目中指译文相对源文的同步状态
hook 钩子
implementation 实现
inference 推理 推理(inference) 需要和 reasoning 区分时保留英文括注
info string 信息字符串 沿用 CommonMark 中文翻译;指代码围栏 ``` 之后的语言标注
injection 注入
integration 集成
interface 接口
language switcher 语言切换行 i18n 配对机制用语:双语配对文件顶部的互链行
merge 合并
message 消息
mod 模组
model provider 模型提供方
model selection 模型选择 模型目标 面向 Agent 的提供方、模型和可选推理强度选择。
module 模块
non-escalation 非升权 非升级、不可升级 仅用于安全与权限语境,指主体不得获得超出既有授权的权限;普通升级不适用此行
npm dependency NPM 依赖 package.json 中的包关系;dependenciesdevDependencies 等字段保持原样
opt-out ratio opt-out 比例 退出检查比例
orphan 遗留 孤儿、孤立 指英文源已不存在的 .zh.md(如「遗留译文」);进程语境按 OS 惯用语译「孤儿进程」
orphan branch 孤立分支 孤儿分支 沿用 git 官方中文翻译
package 指 npm 包(@deepseek-ai/dsh-*);package.json 等代码标识保持原样
pairing 配对
parent-subset grants 父级子集授权 父集合授权 指授权范围仅限于父级所持授权的子集
peer dependency 对等依赖 对等依赖(peer dependency)
permission 权限
persistence 持久化
pipeline 流水线
plugin 插件
postmortem 事故复盘 事故复盘(postmortem) 事后分析、事故记录 事故记录与分析文档;目录或路径中的 postmortem 保持代码形式
prompt 提示词
provider 提供方
provider-neutral 提供方无关 提供方中立
quality gate 质量门禁
quiescence 完全停稳 静默、静止状态 指生命周期工作全部结算后的状态
reasoning 推理 推理(reasoning) 需要和 inference 区分时保留英文括注
reasoning_content 思考内容
registry 注册表
replay 回放
resume 恢复
runtime 运行时
same-world subprocess 与宿主共享文件系统和内核的子进程 同世界子进程
sandbox 沙箱
service 服务
serving interface 对外服务接口
session 会话
session event 会话事件
setup card 设置卡片 首次运行时代替行卡直接展开的配置卡
sidecar file 伴随文件 指与文档同目录的普通伴随文件
sidecar record 伴随记录 旁挂记录 指与文档同目录的伴随记录文件
smoke test 冒烟测试
snapshot 快照
source of truth 真源 事实来源、唯一来源
spine 主干
stale 陈旧 过期 fresh新鲜)成对;门禁输出中保留英文 stale 不翻译;expired 才译为过期
step 步骤
stream
structural signature 结构签名 i18n 配对机制用语:门禁比对两侧文件时提取的有序结构序列(标题层级、代码块、列表等)
Summary 概述 事故复盘标题用语
system prompt 系统提示词
taxonomy 分类体系
token usage token 用量
tool 工具
tool call 工具调用
tool result 工具结果
tool schema 工具 schema
toolkit 工具包
turn 轮次
VFS VFS 虚拟文件系统(VFS)
typecheck 类型检查
vocabulary 词汇
wire format 协议格式 协议格式(wire format)
workflow 工作流
wrapper 包装层 软件层或 SDK 包装层
wrapper script 包装脚本 可执行脚本包装层