diff --git a/docs/glossary.i18n.yaml b/docs/glossary.i18n.yaml index 6352220975..9724877d71 100644 --- a/docs/glossary.i18n.yaml +++ b/docs/glossary.i18n.yaml @@ -3,4 +3,4 @@ # after editing either side, bring the other along and re-record with: # pnpm run verify-translation-pairing --write glossary.md: c1931c0e0c630d05f5bd4fc3f30720f858f1175e -glossary.zh.md: f8f3c9489a8be94de7fb3f021dd70bea7a399d73 +glossary.zh.md: 951abebc162e2456211437fcd5b27dd57783e9b6 diff --git a/docs/glossary.zh.md b/docs/glossary.zh.md index f8f3c9489a..951abebc16 100644 --- a/docs/glossary.zh.md +++ b/docs/glossary.zh.md @@ -20,9 +20,9 @@ FIXME(glossary-completeness): 首次发布前扩充本术语表,使其覆盖 S ## 目标 -- **目标**:附着在现有会话上的单个持久完成目标,带有按修订号演进的 `active` / `paused` / `blocked` / `complete` 阶段和目标回合上限;`blocked` 保留策略代码与说明。目标是一种状态,不是调度器,也不是一段独立对话;会话日志仍是其真源。 -- **目标回合**:为当前目标接纳的一次续行周期。同会话驱动器将目标回合具体化为一个来源为目标的[轮次](#turn),其中可以包含多个步骤;同一会话中无关的人类轮次不消耗目标回合上限。 -- **目标激活**:续行消费方接纳下一个目标回合的进程本地权限。激活态为 `armed` 或 `disarmed`;它有意不参与持久回放,因此恢复和 fork 后,必须由人类随后通过 `/goal` 或模型工具授权恢复变更,自动工作才可开始。 +- **目标**:附着在现有会话上的单个持久完成目标,带有按修订号演进的 `active` / `paused` / `blocked` / `complete` 阶段和 Goal Round 上限;`blocked` 保留策略代码与说明。目标是一种状态,不是调度器,也不是一段独立对话;会话日志仍是其真源。 +- **Goal Round**:为当前目标接纳的一次续行周期。同会话驱动器将 Goal Round 具体化为一个来源为目标的[轮次](#turn),其中包含一个或多个步骤;同一会话中无关的人类轮次不消耗 Goal Round 上限。 +- **目标激活**:续行消费方接纳下一个 Goal Round 的进程本地权限。激活态为 `armed` 或 `disarmed`;它有意不参与持久回放,因此恢复和 fork 后,必须由人类随后通过 `/goal` 或模型工具授权恢复变更,自动工作才可开始。 ## 人类命令 @@ -34,10 +34,10 @@ FIXME(glossary-completeness): 首次发布前扩充本术语表,使其覆盖 S - **轮次**:会话中一次对已接纳输入的排空过程,在模型及其工具停止工作或终止策略介入后结束。 - **步骤**:一次模型请求,以及由模型响应引发的工具执行;一个轮次包含一个或多个步骤。 -- **回合**:包含一个轮次的外层策略迭代,例如一个[目标回合](#goal-round)或一次全新 agent Ralph 尝试。回合计数器属于该策略,并不统计会话内的每个轮次。 +- **Round**:承载一个轮次的外层策略迭代,例如一个 [Goal Round](#goal-round) 或一次使用全新 agent 的 Ralph 尝试。Round 计数器归该策略所有,并不统计会话中的每个轮次。 ## Ralph - **Ralph 循环**:一次面向不可变目标的前台全新 agent 工作流运行。它是由工作流和 subagent 原语组合而成的面向模型的工具策略,不是同会话目标、agent loop(智能体循环)模式、调度器或通用工作流脚本功能。 -- **Ralph 回合**:[Ralph 循环](#ralph-loop)中的一个全新子会话。子会话不接收父会话或此前子会话的对话种子;共享工作区和一份有界的 [Ralph 交接](#ralph-handoff)承载跨回合状态。 -- **Ralph 交接**:从一个仍需继续的 Ralph 回合传给下一回合的规范化、有界结构化报告,包含状态、摘要、证据、后续步骤和阻塞说明。它补充共享工作区,而不取代工作区的权威地位。 +- **Ralph Round**:[Ralph 循环](#ralph-loop)中的一个全新子会话。子会话不接收父会话或此前子会话的对话种子;共享工作区和一份有界的 [Ralph 交接](#ralph-handoff)承载跨 Round 的状态。 +- **Ralph 交接**:从一个仍需继续的 Ralph Round 传给下一个 Ralph Round 的规范化、有界结构化报告,包含状态、摘要、证据、后续步骤和阻塞说明。它补充共享工作区,而不取代工作区的权威地位。 diff --git a/docs/i18n/terminology.md b/docs/i18n/terminology.md index 74ce7ad969..287fbbc572 100644 --- a/docs/i18n/terminology.md +++ b/docs/i18n/terminology.md @@ -52,6 +52,7 @@ | loader | loader | | | | | manifest | manifest | manifest(元数据清单) | | | | monorepo | monorepo | | | | +| Round | Round | | 回合、目标回合、Ralph 回合 | 领域层级为 Session > Round > Turn(轮次) > Step(步骤);Goal Round 与 Ralph Round 均保留英文。一个 Round 承载一个 Turn,一个 Turn 包含一个或多个 Step。 | | schema | schema | | | | | schema DSL | schema DSL | | | | | seam | seam | | | 与 `extension point` 是不同概念;根据具体语境,可译为`服务边界`或`可替换点` | diff --git a/docs/testing.i18n.yaml b/docs/testing.i18n.yaml index 8ef18d76b6..9d1553ebbe 100644 --- a/docs/testing.i18n.yaml +++ b/docs/testing.i18n.yaml @@ -3,4 +3,4 @@ # after editing either side, bring the other along and re-record with: # pnpm run verify-translation-pairing --write testing.md: 1de3a0754dadbad1f36a9fc8c19b8ba77071bd54 -testing.zh.md: c557dfd91bca436a9c969cde6e2a0b24237e3146 +testing.zh.md: f6ec709862879192bb513f4701227fedfa7ecb66 diff --git a/docs/testing.zh.md b/docs/testing.zh.md index c557dfd91b..f6ec709862 100644 --- a/docs/testing.zh.md +++ b/docs/testing.zh.md @@ -13,7 +13,7 @@ ## 带密钥策略:推理在这里很便宜 -我们是 DeepSeek,不要吝惜真实 API 测试。无密钥测试只能证明底层通路;只有带密钥运行才能证明 agent(智能体)能对接真实模型正常工作。覆盖文件写入提示词、多轮对话、工具使用和流中取消。价值最高的是**冒烟测试**:启动真实示例、发送一条提示词,并检查外部世界;它们能捕获「单元测试全绿、产品却坏了」这一类 mock 无法发现的问题([事故复盘 0001](postmortem/0001-acp-default-export-drops-inject.md))。自动跳过让无密钥 CI 和无密钥贡献者不受阻塞;它不是成本信号。每个示例都提供无密钥和带密钥冒烟测试([examples/AGENTS.md](../examples/AGENTS.md))。 +我们是 DeepSeek,不要吝惜真实 API 测试。无密钥测试只能证明底层通路;只有带密钥运行才能证明 agent(智能体)能对接真实模型正常工作。覆盖文件写入提示词、包含多个轮次的对话、工具使用和流中取消。价值最高的是**冒烟测试**:启动真实示例、发送一条提示词,并检查外部世界;它们能捕获「单元测试全绿、产品却坏了」这一类 mock 无法发现的问题([事故复盘 0001](postmortem/0001-acp-default-export-drops-inject.md))。自动跳过让无密钥 CI 和无密钥贡献者不受阻塞;它不是成本信号。每个示例都提供无密钥和带密钥冒烟测试([examples/AGENTS.md](../examples/AGENTS.md))。 ## 优先使用真实实现而非 mock