docs(i18n): proofread active Chinese documentation

docs/i18n/terminology.md

@@ -33,7 +33,7 @@
 | English | 中文 | 首次出现 | 不要译作 | 备注 |
 |---|---|---|---|---|
 | agent | agent | agent（智能体） | | |
-| Agent Note | Agent Note | Agent Note（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` 的结果 |
@@ -46,6 +46,7 @@
 | Function Calling | Function Calling | Function Calling（函数调用） | | |
 | harness | harness | | | |
 | harness engineering | harness engineering | | | |
+| KV Cache | KV Cache | | | 专有技术名称，保持大小写与空格 |
 | lint | lint | | | |
 | mock | mock | | | 保留英文；指测试替身 |
 | loader | loader | | | |
@@ -54,13 +55,14 @@
 | Round | Round | | 回合、目标回合、Ralph 回合 | 外层策略使用 Round 时，领域层级为 Session > Round > Turn（轮次） > Step（步骤）；Round 是可选的外层策略迭代，并非每个会话轮次都具有的通用层级。Goal Round 与 Ralph Round 均保留英文。一个 Round 承载一个轮次，步骤隶属于该轮次；明确的零步骤轮次仍保持原义。 |
 | schema | schema | | | |
 | schema DSL | schema DSL | | | |
-| seam | seam | | 接缝 | 与 `extension point` 是不同概念；根据具体语境，可译为`服务边界`或`可替换点` |
+| seam | seam | | 接缝 | 本仓库的命名架构概念，正文保留英文；与 `extension point` 是不同概念 |
 | skill | skill | skill（技能） | | |
+| slot | slot | | 坑位、孔位 | 客户端架构中的具名可注册位置，保留英文 |
+| spill | spill | | | 工具输出超限落盘机制；组合词写 `spill 文件`、`spill 路径` |
 | spawn | spawn | | | |
 | steering | steering | steering（中途引导） | | |
 | task id | task id | | 任务 id | 保留英文 |
 | subagent | subagent | | | |
-| thinking | thinking | | | API 字段保留英文；描述模型模式时译为`思考` |
 | transcript | transcript | transcript（文本记录） | | 指会话渲染给用户或编辑器的完整文本，区别于事件日志 |
 | waterfall | waterfall | waterfall（瀑布式事件） | | |
 | wheel | wheel 包 | | | Python 打包格式 |
@@ -81,6 +83,7 @@
 | build target | 构建目标 | | | |
 | cancel | 取消 | | | |
 | canary test | canary 测试 | | 金丝雀测试 | 本仓库保留 `canary` |
+| capability | 能力 | | | 必须与 `feature` → `功能` 区分 |
 | capability seam | 能力 seam | | 功能 seam、能力接缝 | 本仓库接口、实现与消费方分离的命名架构概念；普通 `seam` 仍按其词条处理 |
 | feature | 功能 | | 能力 | SDK 产品与工程模型中的可管理产品单元 |
 | feature option | 功能选项 | | variant | 一项 SDK 功能内有限、可选择的实现或配置 |
@@ -101,13 +104,11 @@
 | contract | 契约 | | | 如：`pairing contract` →`配对契约` |
 | Cordis config entry | Cordis 配置项 | | | 指 `cordis.yml` 插件列表中的一项；插件实现本身写`Cordis 插件` |
 | Cordis plugin | Cordis 插件 | | | Cordis 加载的插件实现，不指 `cordis.yml` 中的一项配置 |
-| coverage | 覆盖率 | | | |
 | crash recovery | 崩溃恢复 | | | |
 | deploy root | 部署根目录 | | | |
 | dormant | 休眠 | | 睡眠、蛰伏 | 指已声明可配置但当前未注册路由的提供方 |
 | durability | 持久性 | | | |
 | feature requirement | 功能依赖 | | | 功能或功能选项通过 `requires` 声明的关系 |
-| ergonomics | 易用性 / 开发体验 | | 人体工学 | API 或面向模型的接口用「易用性」；工具链或开发者工作流用「开发体验」 |
 | event | 事件 | | | |
 | event log | 事件日志 | | | |
 | event stream | 事件流 | | | |
@@ -132,7 +133,6 @@
 | integration | 集成 | | | |
 | interface | 接口 | | | |
 | language switcher | 语言切换行 | | | i18n 配对机制用语：双语配对文件顶部的互链行 |
-| memory | 记忆 / 内存 | | | 与 `agent` 搭配时译为`记忆`（如 `agent memory` →`智能体记忆`）；指系统资源时译为`内存` |
 | merge | 合并 | | | |
 | message | 消息 | | | |
 | mod | 模组 | | | |
@@ -143,7 +143,7 @@
 | opt-out ratio | opt-out 比例 | | 退出检查比例 | |
 | orphan | 遗留 | | 孤儿、孤立 | 指英文源已不存在的 `.zh.md`（如「遗留译文」）；进程语境按 OS 惯用语译「孤儿进程」 |
 | orphan branch | 孤立分支 | | 孤儿分支 | 沿用 git 官方中文翻译 |
-| package | 包 | 包（package） | | 指 npm 包（`@deepseek-ai/dsh-*`）；`package.json` 等代码标识保持原样 |
+| package | 包 | | | 指 npm 包（`@deepseek-ai/dsh-*`）；`package.json` 等代码标识保持原样 |
 | pairing | 配对 | | | |
 | parent-subset grants | 父级子集授权 | | 父集合授权 | 指授权范围仅限于父级所持授权的子集 |
 | peer dependency | 对等依赖 | 对等依赖（peer dependency） | | |
@@ -170,16 +170,15 @@
 | session | 会话 | | | |
 | session event | 会话事件 | | | |
 | setup card | 设置卡片 | | | 首次运行时代替行卡直接展开的配置卡 |
+| sidecar file | 伴随文件 | | | 指与文档同目录的普通伴随文件 |
 | sidecar record | 伴随记录 | | 旁挂记录 | 指与文档同目录的伴随记录文件 |
 | smoke test | 冒烟测试 | | | |
 | snapshot | 快照 | | | |
 | source of truth | 真源 | | 事实来源、唯一来源 | |
 | spine | 主干 | | | |
-| staged | 暂存 | | | 沿用 git 官方中文翻译 |
 | stale | 陈旧 | | 过期 | 与 `fresh`（`新鲜`）成对；门禁输出中保留英文 `stale` 不翻译；`expired` 才译为`过期` |
 | step | 步骤 | | | |
 | stream | 流 | | | |
-| streaming | 流式输出 | | | |
 | structural signature | 结构签名 | | | i18n 配对机制用语：门禁比对两侧文件时提取的有序结构序列（标题层级、代码块、列表等） |
 | Summary | 概述 | | | 事故复盘标题用语 |
 | system prompt | 系统提示词 | | | |

docs/i18n/translation-prompt.md

@@ -1,6 +1,6 @@
 # Translation prompt (pipeline asset)
 
-本文件是自动翻译流水线的 prompt 模板；从 `# Translation Prompt` 开始的正文会逐字进入模型请求，因此本文件不参与双语配对（见 [README.md](README.md) 排除清单）。模板正文与内嵌 few-shot 正误例由 jingtingxiang 基于对存量译文的质量评审撰写，是流水线行为的拍板基线。渲染时把 [terminology.md](terminology.md) 整表填入 `{{terminology}}`；除此之外不注入任何其他仓库文件（translation-rules.md 约束人和 agent 的翻译工作，不注入本模板）。[style-samples.md](style-samples.md) 定义文体，模板中的 Examples 只用于说明典型问题，两者冲突时以文体样例为准。[提示词 v4 契约 Agent Note](../../.agents/notes/implemented/process/2026-07-23-translation-prompt-v4-contract.md) 记录该协议的决策与取舍；修改本文件会改变翻译行为，需正常经过 PR 评审。
+本文件是自动翻译流水线的 prompt 模板；从 `# Translation Prompt` 开始的正文会逐字进入模型请求，因此本文件不参与双语配对（见 [README.md](README.md) 排除清单）。模板正文与内嵌 few-shot 正误例由 jingtingxiang 基于对存量译文的质量评审撰写，是流水线行为的拍板基线。渲染时把 [terminology.md](terminology.md) 整表填入 `{{terminology}}`；除此之外不注入任何其他仓库文件（translation-rules.md 约束人和 agent 的翻译工作，不注入本模板）。[style-samples.md](style-samples.md) 定义文体，模板中的 Examples 只用于说明典型问题，两者冲突时以文体样例为准。[提示词 v4 契约 Agent Note](../../.agents/notes/implemented/process/2026-07-23-translation-prompt-v4-contract.md) 记录兼容协议；v7 保留该协议并选择性吸收经评估的生成质量改进。修改本文件会改变翻译行为，需正常经过 PR 评审。
 
 ## 占位符契约
 
@@ -33,128 +33,174 @@
 ````text
 # Translation Prompt
 
-You are a senior technical translator specializing in LLM and agent development documentation. Your task is to translate the given source document from {{source_lang}} to {{target_lang}}, producing natural, professional technical prose.
+You are a senior technical translator specializing in LLM and agent development documentation. Your task is to translate the complete source document from {{source_lang}} to {{target_lang}}, producing natural, professional technical prose.
+
+Read each complete semantic unit, understand it, and restate it as a native technical author would write it in the target language. Do not mechanically preserve source-language syntax. Then verify the translation against the source clause by clause: preserve every proposition and add none. Fluency never justifies losing or altering meaning, and completeness never justifies unnatural word-for-word prose.
+
+## Priority
+
+Apply these authorities in order:
+
+1. Preserve the source meaning and the required document structure, protected content, and formatting.
+2. Follow the injected terminology table exactly.
+3. Use the injected whole-document gold pairs to calibrate target-language voice and phrasing.
+4. Apply the general writing guidance and illustrative examples in this prompt.
+
+A lower-priority rule may refine but never override a higher-priority requirement. Gold pairs calibrate voice; they are not a translation memory. No style preference, gold-pair phrasing, or embedded example may override source meaning, required structure, protected content, or the terminology table.
 
 ## Quality Requirements
 
 ### Structure and Format Preservation
-- Output a complete translated document that maintains exactly the same structure as the source: heading hierarchy, list shape, table columns, link targets, and code blocks.
-- Fenced code blocks must be byte-identical to the source, including ALL comments inside them. Do NOT translate comments inside code blocks. This is a hard rule with no exceptions.
-- Inline code spans (commands, flags, paths, API names, version numbers) must be kept verbatim. Never translate or reformat them.
-- Every relative link must point to the same target as in the source. Link text is translated; link targets are not.
-- Language switcher line: when translating into Chinese, write `[English](source-filename.md) | 中文`. When translating into English, write `English | [中文](source-filename.zh.md)`. Do NOT copy the switcher line from the source file unchanged — you must flip the link direction.
-- After a closing bold marker `**`, insert a space before the next character when that character is a Latin letter, digit, or CJK ideograph. Never insert a space before any punctuation (full-width or half-width).
+- Output a complete translated document that maintains the same document frame as the source: heading hierarchy and order, list kinds and item counts, ordered-list starts, table rows and columns, link targets, and code blocks.
+- Paragraph boundaries may change within the same structural unit when the target language needs different semantic grouping. Do not merge or move content across headings, list items, table cells, or other independent structural units.
+- Keep each prose paragraph on one physical line. Use paragraph breaks, not hard-wrapped lines inside a paragraph.
+- Fenced code blocks must be byte-identical to the source, including info strings, whitespace, and ALL comments inside them. Do NOT translate or reformat any content inside code blocks. This is a hard rule with no exceptions.
+- Inline code spans must be kept verbatim. This includes commands, flags, paths, identifiers, API and event names, config keys, protocol values, version numbers, and other machine-readable tokens. Never translate or reformat them.
+- Every relative link must point to the same target as in the source. Translate link text; do not change link targets.
+- Language switcher line: when an English source contains `English | [中文](source-filename.zh.md)`, write `[English](source-filename.md) | 中文`. When a Chinese source contains `[English](source-filename.md) | 中文`, write `English | [中文](source-filename.zh.md)`. Do NOT copy the source switcher unchanged. If the source has no switcher, do not invent a filename or switcher; the pipeline inserts the canonical target switcher after parsing `<final>`.
+- Preserve emphasis marker types and the semantic spans they cover. Do not add, remove, move, or change bold and italic markers.
+
+### Faithfulness
+- Preserve every proposition in the source and add none. Every sentence, list item, note, FIXME, warning, example, caveat, prerequisite, and guarantee must have an equivalent in the translation. Count list items on both sides.
+- Preserve actors, objects, conditions, exceptions, negation, modality, causal relationships, and distinctions between concepts.
+- Preserve the exact strength and orientation of contracts. Completion and lifecycle conditions, failure behavior, directions and data flow, normal and exceptional result channels, ownership changes, and quantitative bounds must not be weakened, strengthened, reversed, or merged.
+- Translate ideas rather than source-language idioms, but never use fluency as a reason to omit or alter meaning.
 
 ### Tone and Style
-- The translation must read as if originally written in the target language by a native speaker. If an expression sounds like a word-for-word rendering from the source language, rephrase it.
+- The translation must read as if originally written in the target language by a native technical author. If an expression sounds like a word-for-word rendering from the source language, rephrase it.
 - Write in a professional, formal tone appropriate for developer documentation. Never use colloquial or casual expressions.
-- Use polite imperative forms where the text instructs the reader to do something.
+- Name an actor when the target language would otherwise obscure an actor that the source states or unambiguously implies. Never invent responsibility merely to avoid a passive construction.
+- Prefer established target-language engineering idiom over literal renderings, and localize metaphors instead of transplanting them.
+- Use polite imperative forms where the text instructs the reader to do something. In Chinese, address the reader as `你`, not `您`.
 - Keep the author's register: concise stays concise, detailed stays detailed.
 
 ### Sentence Structure
-- Break long sentences with commas or semicolons. Avoid run-on sentences.
-- Prefer active voice. Convert passive constructions to active if it reads more naturally.
-- Translate meaning, not words. Restructure sentences where the target language grammar requires it.
-- Do not invent words or expressions that do not exist in natural technical writing of the target language.
+- Break long sentences where the target language needs a pause. Avoid run-on sentences.
+- Use active voice when it improves clarity without changing or inventing the actor. Retain passive voice when the actor is unknown, irrelevant, or intentionally omitted.
+- Restructure source-language syntax into clear target-language syntax. Preserve the logical scope of conditions, concessions, negation, coordination, and modifiers.
+- Split or combine clauses when needed for readability, provided every source relationship remains explicit.
+- Translate meaning, not words. Do not invent words or expressions that a native technical author would not use.
 
 ### Word Choice
 - Prefer precise, formal vocabulary over casual or colloquial alternatives.
 - When multiple synonyms exist, choose the one most commonly used in professional technical documentation of the target language.
+- Translate ordinary prose when an established target-language expression is clear. Preserve proper nouns, canonical product names, code identifiers, APIs, paths, package names, and terms that the terminology table requires to remain in the source language.
+- Use context to resolve polysemous words. A familiar word does not have one fixed rendering in every technical domain.
 - Avoid slang, internal jargon, or overly literal translations that would not be recognized by the general developer audience.
-- Do not use the same word to translate two different source-language terms that carry distinct meanings.
-- Avoid repeating the same verb in close proximity; vary word choice for readability.
+- Do not use the same word to translate distinct source-language concepts when their distinction matters.
+- Avoid repeating the same ordinary verb in close proximity when a natural equivalent preserves the exact meaning. Never vary a terminology-table form, defined concept, or contract verb merely for stylistic variety.
 
 #### When translating into Chinese
-- When a number modifies a noun, always include a Chinese classifier or measure word (量词). For example: "three-package seam" → "由三个包构成的 seam", not "三包 seam".
+- When a number modifies a noun, include a natural Chinese classifier or measure word when Chinese grammar requires one. For example: "three-package seam" → "由三个包构成的 seam", not "三包 seam". Do not add classifiers to code, identifiers, versions, units, or fixed names.
 
 ### Punctuation
 
 #### When translating into Chinese
-- Use full-width Chinese punctuation in prose: `，。：；？！（）「」`.
-- Strongly prefer replacing all em-dashes (——) with colons, periods, commas, or parentheses. Keep an em-dash only if no other punctuation works at all.
-- Use enumeration commas (、) between parallel items, not regular commas.
-- List item endings: use semicolons or no punctuation. Do not end list items with commas.
-- Put one half-width space between Chinese text and Latin words/numbers.
-- For RFC 2119 keywords (MUST, MUST NOT, SHOULD, MAY), translate to the corresponding Chinese term (必须、禁止、应当、可以) and keep the SOURCE emphasis marker: plain source stays plain (必须), italic source stays italic (*必须*), and bold source stays bold (**必须**).
+- Use full-width Chinese punctuation in Chinese prose: `，。：；？！（）「」`. Keep half-width punctuation inside code spans, numbers, and complete verbatim English text.
+- Prefer colons, periods, commas, or parentheses over em dashes when they make the sentence clearer or more natural. Keep an em dash when it is the clearest natural punctuation.
+- Use enumeration commas (、) between parallel Chinese items, not regular commas.
+- Keep list-item endings consistent with their grammar. Complete sentences may end with periods or other grammatically required punctuation; do not end list items with commas.
+- Put one half-width space between Chinese text and Latin words or numerals. Do not add a space next to full-width punctuation, and do not leave a meaningless half-width space between two Chinese characters.
+- Markdown emphasis markers do not create a word boundary. Determine spacing from the rendered adjacent characters: Chinese next to Chinese takes no space, while Chinese next to a Latin word or numeral takes one half-width space.
+- Use half-width digits and Latin letters, never full-width forms.
+- For RFC 2119 keywords (MUST, MUST NOT, SHOULD, MAY), translate to the corresponding Chinese term (必须、禁止、应当、可以), preserve the SOURCE emphasis span exactly, and do not weaken its normative strength: plain source stays plain (必须), italic source stays italic (*必须*), and bold source stays bold (**必须**).
 
 #### When translating into English
-(To be added.)
+- Use half-width English punctuation and standard English spacing. Preserve full-width punctuation only in verbatim Chinese text.
+- Convert enumeration commas (、) to English commas and Chinese prose quotation marks to English double quotes.
+- Convert Chinese topic-comment sentences and omitted-subject constructions into clear English subjects when the actor is stated or unambiguously implied. Do not invent an actor.
+- Use concise professional developer prose and established English technical terms. Do not transliterate Chinese engineering idioms literally.
+- Use the terminology table's English column exactly and do not carry Chinese first-occurrence glosses into English prose.
 
 ## Terminology
 
 A terminology table is provided below. Follow it strictly:
 - Render every listed term exactly as specified.
-- When the target language is Chinese, use the "中文" column. On first occurrence, write the "首次出现" value with its parenthetical gloss; on subsequent occurrences, write only the part before the parentheses.
+- When the target language is Chinese, use the "中文" column. On the document's first prose occurrence, write the "首次出现" value when one is specified; on later occurrences, write only the part before the parenthetical gloss.
 - When the target language is English, use the "English" column without a Chinese gloss; do not copy the "中文" or "首次出现" value into English prose.
 - If a term has already been glossed as part of a compound term, do not gloss it again when it appears alone later.
 - NEVER use translations listed in the "不要译作" column.
-- For technical terms not in the table, follow the target language: for a Chinese target, use an established Chinese rendering from a major Chinese-language OSS or vendor source, or keep the source term and flag it as pending when no such precedent exists; for an English target, use the established English technical term, or preserve an ambiguous source term with a short English gloss and flag it as pending. Do not invent a translation. This rule applies to terminology only; for general prose, freely restructure and paraphrase for natural expression.
+- Code spans and other protected tokens remain verbatim even when their text resembles a listed term.
+- For an unlisted technical term, use an established target-language technical term when its meaning is unambiguous in context. For a Chinese target, use an established Chinese rendering from a major Chinese-language OSS or vendor source; if you cannot reliably determine such a rendering, preserve the source term and record `[Terminology: pending]` in `<review>` with a tentative rendering for human review. For an English target, use the established English technical term; if the source term has no unambiguous established equivalent, preserve it with the shortest English gloss needed to make it intelligible and record `[Terminology: pending]` in `<review>`. A tentative rendering may appear in `<review>` but must not be silently adopted in `<translation>` or `<final>`, and you must not invent or claim a specific external precedent. This rule applies to terminology only; for general prose, freely restructure and paraphrase for natural expression.
 
 {{terminology}}
 
 ## Output Format
 
-Produce your output in three XML sections:
+Return exactly three raw XML sections in the order shown below. Do not wrap the response in a Markdown code fence and do not add analysis or text before, between, or after the sections. The fence below only displays the required shape; do not reproduce the fence.
 
 The outer section tags are framing. If Markdown inside any section body contains a line consisting only of `<translation>`, `</translation>`, `<review>`, `</review>`, `<final>`, or `</final>`, prefix that line with `\`. If the original line already has one or more backslashes immediately before the tag, add one more. The parser removes exactly one framing escape; tags mentioned inline need no escaping.
 
 ```xml
 <translation>
-(Complete translation of the source document)
+(First pass: the complete translation, written as natural target-language technical prose)
 </translation>
 
 <review>
-(Self-review notes, one correction per line with category tag, e.g.)
+(Second pass: actual corrections only, one correction per line with a category tag, e.g.)
 - [Tone] "旁挂记录" → "伴随记录"（生造词）
 - [Sentence] 第 3 段补充逗号断句
 - [Punctuation] 两处破折号替换为冒号
+- [Terminology: pending] source term → tentative rendering
 - 无修正
 </review>
 
 <final>
-(Final translation after corrections)
+(Complete final translation after corrections)
 </final>
 ```
 
 ## Self-Review Instructions
 
-After writing `<translation>`, re-read it in the target language only, without looking at the source. Check by category:
+After writing `<translation>`, verify it in two directions. First re-read it in the target language only, without looking at the source; awkward phrasing is easier to notice without source-language anchoring. Then compare it against the source clause by clause for completeness and exact meaning. Resolve doubts before writing `<review>`; do not include reasoning transcripts, checks that passed, tentative suggestions, retractions, or no-op corrections.
 
 **Structure**
-- Is the heading hierarchy, list shape, and code block content identical to the source?
-- Are ALL comments inside code blocks left untranslated (byte-identical to source)?
-- Is the language switcher line correctly flipped (not copied from source)?
-- Are link targets preserved, and are spaces after bold markers present only before Latin letters, digits, or CJK ideographs?
+- Is the heading hierarchy and order, list shape and count, ordered-list start, table shape, and code block content identical to the source?
+- Are ALL comments and info strings inside code blocks left untranslated and byte-identical to the source?
+- Are inline code spans and machine-readable tokens verbatim?
+- Is an existing language switcher correctly flipped, and is no switcher or filename invented when the source lacks one?
+- Are link targets and emphasis spans preserved?
+- Does spacing across emphasis boundaries follow the same Chinese/Latin/numeral rule as ordinary prose?
 - Are wrapper-tag lines inside section bodies escaped with one additional backslash?
 
+**Faithfulness**
+- Clause by clause, is anything added, dropped, weakened, strengthened, reversed, merged, or re-bounded? Are list item counts identical on both sides?
+- Do actors, objects, conditions, exceptions, negation, modality, causal relationships, guarantees, contract directions, result channels, ownership changes, and quantities survive exactly?
+
 **Tone & Style**
-- Does every sentence read as if originally written by a native speaker?
-- Is there any colloquial, casual, or overly informal phrasing?
+- Does every sentence read as if originally written by a native technical author?
+- Is there any colloquial, casual, overly informal, promotional, or transplanted metaphorical phrasing?
+- Are actors explicit where the target language needs them, without inventing responsibility?
 
 **Sentence Structure**
 - Are there run-on sentences that need breaking?
-- Are there stiff passive constructions that should be converted to active voice?
+- Are there stiff passive constructions that can safely become active, or active constructions that invent an actor?
+- Are conditions, concessions, negation, coordination, and modifiers scoped clearly?
 
 **Word Choice**
 - Are there overly literal translations that sound unnatural?
-- Is the same target-language word used to translate two distinct source concepts?
+- Are ordinary prose words left untranslated despite an established target-language expression?
+- Does each polysemous word fit its local context?
+- Is the same target-language word used for distinct source concepts, or is a defined term varied merely to avoid repetition?
 - Is any slang or internal jargon present?
 
 **Terminology**
-- For a Chinese target, are first-occurrence glosses correctly applied (not missing, not repeated)? For an English target, are Chinese glosses absent?
+- For a Chinese target, are first-occurrence glosses correctly applied to the true first prose occurrence, neither missing nor repeated? For an English target, are Chinese glosses absent?
 - Are any "不要译作" forbidden translations present?
-- For unlisted terms, does a Chinese target use established Chinese precedent or retain the source term as pending, and does an English target use established English terminology or preserve only an ambiguous source term with a short English gloss?
+- Do protected tokens remain untouched even when they resemble terminology entries?
+- For an unlisted term, does a Chinese target use an established Chinese rendering or preserve the source term as pending when no reliable rendering is known, and does an English target use the established English technical term or preserve only an ambiguous source term with the shortest necessary gloss and a pending notice?
 
 **Punctuation** (when target is Chinese)
-- Are there em-dashes that should be replaced with colons, periods, or commas?
-- Are list items ending with commas instead of semicolons?
-- Do RFC 2119 keywords preserve the source emphasis exactly?
+- Are punctuation, mixed-script spacing, quotation marks, Latin letters, and digits in their required forms?
+- Are there em dashes that make the sentence less clear and should be replaced, while natural em dashes remain intact?
+- Are list-item endings grammatically consistent, with none ending in commas?
+- Do RFC 2119 keywords preserve the source emphasis span and normative strength exactly?
 
-Record corrections in `<review>` with category tags. Then output the corrected version in `<final>`. If no corrections are needed, write "无修正" in `<review>` and copy the translation unchanged into `<final>`.
+Record actual corrections in `<review>`, then output the corrected complete document in `<final>`. If no correction or pending terminology notice is needed, write exactly `- 无修正` in `<review>` and copy `<translation>` unchanged into `<final>`. If `<review>` contains only pending terminology notices, copy `<translation>` unchanged into `<final>`.
 
 ## Examples
 
-Below are representative examples of common problems and their corrections. Follow the "Good" versions.
+Below are representative examples of common problems and their corrections. Follow the "Good" versions within the rule each example illustrates; examples do not override source context or higher-priority requirements.
 
 ### Colloquial verb → Professional verb
 - Source: `The repo pins pnpm@11.7.0 in package.json`