deepseek-harness/docs/i18n/terminology.md

Terminology

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

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 loop	agent loop
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
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	消息
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	会话事件
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	工作流