翻译规范手册 (Translation Guide)¶
本手册面向全部译者 agent。任何翻译动作前必须完整通读一次,违规产出将被主编 reject。 目标:20+ 译者协作时,读者感受到"像一个人写的"。 版本: v1.0 (2026-07-31) — 覆盖 Ch01-25 全部 25 章翻译规范
0. 项目背景速览¶
- 原书:Maths, CS & AI Compendium by Henry Ndubuaku
- 风格:直觉先行、大量口语化比喻、公式与代码密集、面向"想真正搞懂"的实践者 (不是应试)
- 面向读者:有基础 Python + 高中数学的 AI/ML 从业者与学生
- 中文版定位:不是学术翻译,是"让中文读者读得津津有味的技术散文"
1. 信达雅三原则 (硬核心)¶
1.1 信 (Fidelity) — 技术零失真¶
- 数学公式 100% 原样保留。
$...$$$...$$内的一切 LaTeX 源码不改一字符 - 变量名不改 (不要把 \(x\) 翻成 \(x_{中文}\))
- 符号不改 (\(\mathbb{R}^n\), \(\mathbf{a}\), \(\nabla\) 都保留)
- 公式内即使有英文单词 (如 \(\text{softmax}\)),也不动
- 代码块 100% 原样保留,变量名/函数名/字符串不译,仅可翻译代码内注释
- 数据/引用/公式编号保持一致
- 事实性内容 (人名、年份、机构、论文标题) 严格照原文对齐,不"美化"、不添油加醋
1.2 达 (Clarity) — 中文顺畅¶
- 长英文从句必须拆。一句英文 40+ 词的 relative clause,拆成 2-3 个短中文句
- 主动语态优先。"is called" → "叫做" / "被称为" 二选一,别用"其被称之为"
- 避免翻译腔 red flags:
- ❌ "作为一个 X,我们..." → ✅ "作为 X,我们..." (删多余的"一个")
- ❌ "这是一件非常重要的事情" → ✅ "这很重要"
- ❌ "对于 X 来说,它是..." → ✅ "X 是..."
- ❌ "让我们来看看..." → ✅ "来看..." / "我们看..."
- 一句一想法。原文一句里塞了三个概念,中文分三句
1.3 雅 (Register) — 保住"作者的声音"¶
- 原作口语化,中文也口语化。作者写 "Think of a Vector Space as a specific kind of playground",就要翻成"把向量空间想象成一个特别的乐园", 不要翻成"向量空间可被视为一种特定的数学游乐场"
- 常用亲切语气词:
- "我们..." (we) — 拉近距离,全书统一
- "想象一下..." / "把它想成..." — 对应 "Think of / Imagine"
- "现在..." — 对应 "Now" 起头
- "注意..." / "别忘了..." — 对应 "Note that"
- "就是..." / "无非就是..." — 对应 "just / simply"
- 允许保留原作个人化表达 (如 "我 14 岁时..." 这类叙事),用第一人称直译
- 谚语/比喻:优先保留原味,加译注;只有直译完全不懂时才意译
2. 格式硬约束 (Zero Tolerance)¶
违反以下任一条 = 主编直接打回重译。
| # | 约束 | 例子 |
|---|---|---|
| F1 | $...$ 与 $$...$$ 内一个字符都不能改 |
$\mathbf{a} = [a_1, a_2]$ 原样 |
| F2 | __PN_SENTINEL_0__ 代码块整块保留,只译代码内注释 |
Python # compute norm → # 计算范数 |
| F3 | 图片语法  路径不改, alt 文本译中文 |
 |
| F4 | Markdown 标题层级 #/##/### 完全对齐原文数量(排除 F12 认可的学习增强块) |
原文 ## Overview → 译文 ## 概览 (仍两个 #);增强块中的标题不参与结构计数 |
| F5 | Admonition !!! note / !!! warning / !!! tip 标记保留,只译标题与内容 |
!!! note "关键点" |
| F6 | 列表符号 - / * / 1. 与缩进层级严格保持(排除 F12 认可的学习增强块) |
原缩进 4 空格,译文也 4 空格;增强块中的列表不参与结构计数 |
| F7 | 行内代码 `variable_name` 保留原文,不译 |
`numpy.dot()` |
| F8 | 链接 [text](url) 中 URL 不改,文字可译 |
[点这里](https://example.com) |
| F9 | 表格结构 (行数列数分隔线) 保持一致,仅译单元格内容 | |
| F10 | 空行数量与段落结构对齐原文 (影响 markdown 渲染) | |
| F11 | 章节文件名 (中文目录) 已按主编约定,译者不新建/改名 |
F12 原文覆盖与中文扩展 — 一一对应是底线¶
中文版可以比原文更丰富:可增加帮助理解的解释、例子、章节导览、总结、要点与译注;但每个原文信息单元必须在译文中保留可追溯的一一对应。
- 原文标题、正文段落、列表项、表格项、admonition、公式、代码、图片与链接不得漏译、以概述替代、倒置或改变原意。
- 新增内容不得无依据杜撰事实,也不得伪装成原作译文。
一句话总结、本章导览、本节要点是本手册规定的学习增强块。- 其他新增解释、例子或断言必须以
> **补充说明**:或[译注:]标记。 - 验收以“增强块之外的原文信息单元按顺序一一对应、增强块内新增内容不替代原文”为准;标题和列表结构比较排除 F12 认可的学习增强块,不以中文与原文的行数、标题数或列表数完全相等为准。
Verifier 规则 ID:P0 阻断项为 P0-FILE-MAP、P0-SOURCE-COVERAGE、P0-MATH、P0-CODE、P0-ASSET、P0-STRUCTURE;P1 项为 P1-SEMANTIC、P1-UNLABELLED-EXPANSION;P2 项为 P2-PUNCTUATION、P2-SPACING。交付证据必须逐项报告这些 ID。
3. 术语一致性¶
3.1 必读:zh/GLOSSARY.md¶
- 翻译前先
cat zh/GLOSSARY.md查已有术语约定 - 遇到新术语 → 追加到 GLOSSARY.md (格式
| English | 中文 | 首次出现章节 |) - 同一术语全书必须用同一中文译法,冲突时以 GLOSSARY.md 为准
- 如 GLOSSARY.md 尚不存在,创建之,使用下列表头:
3.2 首次出现规则¶
- 首次出现:
中文译名 (English),例:"梯度下降 (gradient descent)" - 之后统一用中文,除非:(a) 极短的缩写更通用 (如
MoE/SVD/GPU); (b) 代码/公式里 - 无标准中文译法 → 保留英文,段末加译注脚注
[译注: xxx 尚无统一中译, 保留原文]
3.3 常见术语参考 (与 GLOSSARY.md 互补,后者为准)¶
| English | 中文 (推荐) | 语境提醒 |
|---|---|---|
| vector space | 向量空间 | |
| scalar | 标量 | |
| dot product | 点积 | 不用"内积" (inner product 另用) |
| inner product | 内积 | 抽象空间 |
| norm | 范数 | |
| gradient descent | 梯度下降 | |
| loss function | 损失函数 | 不用"代价函数" |
| feature | 特征 | ML 语境 |
| feature vector | 特征向量 | ⚠️ 数学的 eigenvector 也叫特征向量,见 §8 |
| eigenvector / eigenvalue | 特征向量 / 特征值 | 与 ML feature 同名,用上下文区分,必要时加原文 |
| embedding | 嵌入 | 名词;embedding vector = 嵌入向量 |
| attention | 注意力 | self-attention = 自注意力 |
| transformer | Transformer | 不译,首字母大写 |
| convolution | 卷积 | |
| kernel (CNN) | 卷积核 | |
| kernel (OS) | 内核 | |
| kernel (SVM/method) | 核 (kernel) | 首次出现附原文 |
| pooling | 池化 | |
| backpropagation | 反向传播 | |
| overfitting | 过拟合 | |
| regularisation | 正则化 | |
| MoE (Mixture of Experts) | MoE (专家混合) | MoE 不译;内部 "expert" 译"专家" |
| SSM (State Space Model) | 状态空间模型 (SSM) | |
| RNN / CNN / LLM / VLM | 保留缩写 | 首次出现给全称中文 |
| tensor | 张量 | |
| batch | 批 / 批次 | batch size = 批大小 |
| epoch | epoch | 不译,已成技术黑话 |
| pipeline | 流水线 | 分布式训练语境 |
| playground (数学) | 乐园 | |
| playground (代码调试) | 沙盒 | |
| ablation | 消融 (ablation) | 首次加英文 |
4. 中文标点规范¶
4.1 正文用全角¶
| 用法 | 用 | 不用 |
|---|---|---|
| 句号 | 。 | . |
| 逗号 | , | , (半角) ← ⚠️注意,本手册作者习惯半角,译者一律用全角 , |
| 冒号 | : | : (半角) → 正文用全角 : |
| 分号 | ; → ; |
|
| 问号 | ? → ? |
|
| 感叹号 | ! → ! |
|
| 引号 | "..." "..." (中文弯引号) | "..." |
| 括号 | (行文) 用半角 () 更整齐;但整段中文括号可 () |
团队统一:半角 () 前后加空格 |
| 破折号 | —— (双 em dash) | -- / – |
| 省略号 | …… | ... (若原文强调技术省略如代码则保留 ...) |
例外 — 保留英文标点的位置: - LaTeX 公式内部一切标点 (逗号句号等) - 代码块 / 行内代码
`...`内部 - 文件路径 / URL / 命令行 - 数字序列 (1,000 vs 1000;本书统一不加千分位)
4.2 中英文/数字混排 — 加半角空格¶
- ✅ "梯度下降 gradient descent 是一种优化方法"
- ✅ "我们训练了 100 个 epoch"
- ✅ "使用 PyTorch 2.0 版本"
- ❌ "梯度下降 gradient descent 是一种..."
- ❌ "训练 100 个 epoch"
规则:中文字符 与 (英文单词 / 阿拉伯数字 / 行内代码) 相邻时,加一个半角空格。
例外:全角标点前后不加空格 (中文标点已含视觉空间)。
5. 专有名词处理¶
5.1 人名¶
- 首次:
中文译名 (English Full Name) - Charles Darwin → 查尔斯·达尔文 (Charles Darwin)
- Henry Ndubuaku → 亨利·恩杜布阿库 (Henry Ndubuaku)
- 之后:仅用中文
- 姓名之间的分隔用中间点
·,不用小圆点或半角句号 - 知名度极高且中文圈更常直接用英文的,可保留英文:Alan Turing (可译"艾伦·图灵",也可保留),团队约定保留英文形式减少误译,除非有绝对通用中译 (如爱因斯坦、达尔文、牛顿)
5.2 机构 / 产品 / 公司¶
- 一般保留原文: DeepMind, OpenAI, Nvidia, Y Combinator, Google, Meta, Anthropic, GitHub
- 通用中译已牢固的可用中文:谷歌 (Google) — 首次给英文即可,但技术书籍中建议全书保留英文以避免歧义
- 硬件/框架名保留原文:PyTorch, TensorFlow, CUDA, Triton, ARM NEON, AVX
5.3 创始人 / 名人引言¶
- 直接引言 (带引号 "..."),中文译文 + 译注 (脚注) 附原文:
6. 文化梗 / 隐喻 / 幽默处理¶
- 默认策略:直译 → 若不通再意译 → 段末加脚注说明原文
- 常见坑:
playground— 数学语境 = "乐园" (原作反复用);编程 = "沙盒";儿童场景 = "游乐场"dark magic/black box— 直译 "黑魔法" / "黑箱" 中文都通just/merely— 常译"不过是" / "无非" / "就是",保留轻描淡写口吻hand-waving— "含糊带过" / "拍脑袋",加脚注解释亦可soak in(作者原句) — "慢慢吸收",保留生活化感- 文化梗 (梗如美国电视剧、体育、政治笑话):意译 + 脚注
- 谚语:若中文有对应,用中文谚语 + 脚注附原文
脚注格式 (统一 [^tag] + 段尾定义,每章脚注 tag 独立编号):
7. 每章翻译流程 Checklist (Translator Agent 必执行)¶
按顺序执行,每一步都是硬门。
步骤 1:预读 (5-10 min)¶
- [ ]
cat zh/TRANSLATION_GUIDE.md(本文件,每次都要重读一遍) - [ ]
cat zh/GLOSSARY.md(查已有术语) - [ ] 通读整章原文一次,标出所有:
- 未在 GLOSSARY 的新术语
- 数学公式 / 代码块 / 图片位置 (确认不动)
- 文化梗 / 隐喻 / 引言
步骤 2:术语落地¶
- [ ] 新术语先追加到
zh/GLOSSARY.md(若已有条目则复用) - [ ] 若与已有译法冲突,停止翻译,到 GLOSSARY 讨论区留 issue 待主编裁定
步骤 3:逐段翻译¶
- [ ] 逐段处理,不跳段,不合并段
- [ ] 每段翻完立刻自检:公式动了没?代码动了没?图片路径动了没?
- [ ] 长句 (> 30 中文字) 考虑拆句
- [ ] 保持原文空行 / 缩进
步骤 4:自检 (硬门)¶
- [ ]
diff结构:增强块之外的标题层级/数量、列表符号/缩进、代码块数量、公式数量、图片数量与原文完全一致;F12 认可的学习增强块不计入标题和列表结构比较 - 可用:
grep -c '^#' src.md与grep -c '^#' zh/dst.md grep -c '```' src.md计数代码块围栏 (应为偶数且相等)grep -oc '!\[' src.md计数图片grep -oc '\$\$' src.md计数块公式围栏- [ ] 中英文/数字之间是否加空格?(spot check 5 处)
- [ ] 中文标点是否全角?(
grep -n ' , ' zh/dst.md检查游离半角逗号) - [ ] 术语是否统一?(grep 新术语关键词,确认全章唯一译法)
- [ ] 首次出现术语是否带英文原文?
- [ ] 脚注是否闭合?(
[^tag]与[^tag]:数量相等) - [ ] 按原文顺序核对每个原文信息单元,确认增强块之外仍按顺序一一对应;增强块只能新增内容,不得替代、重排或省略原文信息单元;不得以行数、标题数或列表数相等代替覆盖核验
- [ ] 所有新增解释、例子或断言均有可见的
> **补充说明**:或[译注:]标记;一句话总结、本章导览、本节要点可作为本手册规定的学习增强块 - [ ] 记录 Translation QA verifier 的 P0/P1/P2 结果;任一 P0 失败不得交付,P1/P2 结果必须随交付证据保留
步骤 5:交付¶
- [ ] 输出文件命名规则:
zh/第XX章 - 中文章节名/序号. 中文小节名.md(与已建目录结构对齐) - [ ] 提交前跑 markdown lint (若配置)
- [ ] 在 commit message 注明:
translate(chXX): <小节名>
8. 常见坑清单 (Recurring Traps)¶
| 坑 | 说明 | 正解 |
|---|---|---|
| MoE 里的 expert | "expert" 在 MoE 上下文是术语 | 译"专家" (专家网络 / 专家路由) |
| kernel 三义 | CNN / OS / kernel method | CNN=卷积核,OS=内核,method=核 (首次加英文) |
| feature 两义 | ML 特征 vs 数学 eigen-* | 严格区分,eigen-* 加原文 |
| normal 三义 | 正态分布 / 法向量 / 一般的 | 分布 → 正态;几何 → 法;日常 → 普通/一般 |
| regular | regularisation vs regular expression | 前者 = 正则化,后者 = 正则表达式 |
| model | 数学模型 / ML 模型 / 建模 | 统一"模型";动词 "modeling" 译"建模" |
| training | 训练 (ML),不译"培训" | |
| inference | 推理 (ML),不译"推断";但概率统计的 statistical inference = 统计推断 | 区分领域 |
| prior/posterior | 先验/后验 (概率) | 别译"前置/后置" |
| greedy | 贪心 (算法),不译"贪婪的" | |
| naive | 朴素 (如 Naive Bayes = 朴素贝叶斯) | 别译"天真的" |
| online/offline | 上下文相关 | ML=在线/离线学习;网页=线上/线下 |
| channel | CNN=通道;通信=信道 | |
| stream | 数据流 / 流式 | 别混用 |
| head (attention) | 注意力头 | 不译"头部" |
| layer | 层 | Transformer 一层 = 一个 block |
| block | 块 / 模块 | 视上下文 |
| just / simply | 不过是 / 无非 / 就是 | 保留轻语气 |
| note / notice | 注意 / 请注意 | 不用"值得注意的是" (太正式) |
| for instance / e.g. | 例如 / 比如 | 别用"举个例子来说" |
| so-called | 所谓 (中性) | 别用"所谓的" (含贬义) |
| arbitrary | 任意 (数学) | 别译"随意" |
| almost surely | 几乎必然 (概率) | 术语,别口语化 |
| 一/1 | 数字上下文用阿拉伯数字,成语/俗语用中文 | "1 维空间" vs "一举两得" |
| 单位 | cm/kg/GB/GHz 前后加空格 | "185 cm" 而非 "185cm" |
| 括号内的英文原文 | 首次:中文 (English),括号内不加空格 | ✅ "梯度下降 (gradient descent)"; ❌ "梯度下降 ( gradient descent )" |
| ~ 与 ~ 的破折号 | 数值范围 (1~10) 用 ~ 或 –;语义停顿用 —— |
别混 |
版式微坑¶
- Alt 文本内不要放公式 (屏幕阅读器不友好),用自然语言描述
- 中文冒号后紧跟英文/公式时不加空格: ✅
例如:$x = 1$ - 表格内单元格不加末尾句号,保持简洁
- Admonition 内部块级公式仍用
$$(不能缩进破坏渲染)
9. 主编终审要点 (Reviewer Cheatsheet)¶
主编 review 时按以下清单快速扫描:
- 公式/代码/图片路径未动
- 增强块之外的标题/列表/空行结构对齐;增强块不计入标题与列表结构比较
- 中英文空格规范,全角标点
- 术语与 GLOSSARY 一致,首次出现带英文
- 语气亲切 (读起来像作者本人在讲,不像论文摘要)
- 长句已拆,无翻译腔
- 脚注闭合,引言原文可追溯
- 目录结构与命名合规
- 按原文顺序逐单元核对覆盖,确认每个原文信息单元均有可追溯的一一对应;不得以行数、标题数或列表数相等作为替代
- 新增内容均有可见标记:
一句话总结、本章导览、本节要点,或> **补充说明**:、[译注:] - 附 Translation QA verifier 的完整 P0/P1/P2 结果与 JSON 证据;重点确认
P0-SOURCE-COVERAGE、P1-UNLABELLED-EXPANSION
11. 缩写处理 (v1.1 强化)¶
11.1 缩写首现三段式¶
任何缩写 (MLP / CNN / RNN / BPE / NER / POS / SVD / PCA / GAN / VAE / RLHF / MoE / SSM / DP / BFS / DFS / SIMD / CUDA / TPU / GPU / LLM / VLM / TF-IDF / NFC / NFD / OCR / ASR / TTS / SLAM / RTX ...) 首次出现时必须给出:
格式: 中文常见译法 (English Full Name, ABBR)
- ✅ "字节对编码 (Byte-Pair Encoding, BPE)"
- ✅ "循环神经网络 (Recurrent Neural Network, RNN)"
- ✅ "命名实体识别 (Named Entity Recognition, NER)"
- ✅ "混合专家 (Mixture of Experts, MoE)"
- ✅ "自动语音识别 (Automatic Speech Recognition, ASR)"
- ❌ "BPE" (直接用,无全称)
- ❌ "字节对编码 (BPE)" (缺 Full Name)
之后:仅用缩写 ABBR (如 "BPE 算法…"),不重复全称。
11.2 无中文常见译法的处理¶
- 若技术圈约定俗成不译 (SIMD / CUDA / GPU / TPU):首现仍要给全称
- ✅ "单指令多数据 (Single Instruction Multiple Data, SIMD)"
- ✅ "统一计算设备架构 (Compute Unified Device Architecture, CUDA)"
- 之后正文用 SIMD / CUDA
- 若中文有多种译法,取 GLOSSARY.md 首选:
- GPU:图形处理器 (Graphics Processing Unit, GPU)
- TPU:张量处理单元 (Tensor Processing Unit, TPU)
11.3 章内首现 vs 全书首现¶
- 每一节 (即每一个 .md 文件) 各自独立处理:该节首次出现的缩写都要展开
- 理由:读者可能从任一节切入,不能假设已读上文
- GLOSSARY.md 记录全书统一译法,但正文按节展开
11.4 缩写全称核对清单 (常见错案例)¶
| 常见错 | 正确全称 |
|---|---|
| CNN = "Convolutional Neural Networks" | ✅ Convolutional Neural Network (单数) |
| RNN | Recurrent Neural Network |
| LSTM | Long Short-Term Memory |
| GRU | Gated Recurrent Unit |
| GAN | Generative Adversarial Network |
| VAE | Variational Autoencoder |
| BERT | Bidirectional Encoder Representations from Transformers |
| GPT | Generative Pre-trained Transformer |
| T5 | Text-to-Text Transfer Transformer |
| BPE | Byte-Pair Encoding |
| POS | Part-of-Speech |
| NER | Named Entity Recognition |
| TF-IDF | Term Frequency-Inverse Document Frequency |
| SVD | Singular Value Decomposition |
| PCA | Principal Component Analysis |
| ICA | Independent Component Analysis |
| MoE | Mixture of Experts |
| SSM | State Space Model |
| RLHF | Reinforcement Learning from Human Feedback |
| DPO | Direct Preference Optimization |
| KL | Kullback-Leibler (divergence) |
| MLE | Maximum Likelihood Estimation |
| MAP | Maximum A Posteriori |
| MSE | Mean Squared Error |
| CE | Cross-Entropy |
| SGD | Stochastic Gradient Descent |
| BFS / DFS | Breadth-First Search / Depth-First Search |
| DP | Dynamic Programming |
| SIMD | Single Instruction Multiple Data |
| CUDA | Compute Unified Device Architecture |
| GPU / TPU / CPU | Graphics / Tensor / Central Processing Unit |
| ARM | Advanced RISC Machine |
| AVX | Advanced Vector Extensions |
| ASR | Automatic Speech Recognition |
| TTS | Text-to-Speech |
| OCR | Optical Character Recognition |
| SLAM | Simultaneous Localization and Mapping |
| GNN | Graph Neural Network |
| GAT | Graph Attention Network |
| VLM | Vision-Language Model |
| VLA | Vision-Language-Action model |
| CLIP | Contrastive Language-Image Pre-training |
| LoRA | Low-Rank Adaptation |
| MLP | Multi-Layer Perceptron |
| ReLU | Rectified Linear Unit |
| GELU | Gaussian Error Linear Unit |
| BN / LN | Batch Normalization / Layer Normalization |
| API | Application Programming Interface |
| OS | Operating System |
| IPC | Inter-Process Communication |
| RTOS | Real-Time Operating System |
| NFC / NFD | Normalization Form Canonical Composition / Decomposition |
⚠️ 若不确定全称,查 Wikipedia 或 GLOSSARY.md,不要凭记忆。
12. 括号对齐规范 (v1.1 强化)¶
12.1 括号类型对照¶
| 场景 | 用哪种括号 | 前后空格 | 内部空格 |
|---|---|---|---|
术语首现 中文 (English) |
半角 () |
中文与 ( 之间 1 空格 |
内部紧贴,无空格 |
缩写全称 中文 (Full Name, ABBR) |
半角 () |
中文与 ( 之间 1 空格 |
内部无空格 |
| 公式内部 | 保持 LaTeX 原样 | — | — |
| 代码/URL | 保留原样 | — | — |
| 中文补充说明(纯中文) | 全角 () |
无空格 | — |
| 单位/数字附注 | 半角 () |
数字前有空格 | 内部无空格 |
12.2 例¶
- ✅ 反向传播 (backpropagation) 是训练神经网络的核心算法
- ✅ 循环神经网络 (Recurrent Neural Network, RNN) 处理序列数据
- ✅ 我们训练了 100 个 epoch (相当于遍历数据集 100 遍)
- ✅ 张三(作者本人)在书中提到 ← 纯中文补充说明用全角
- ❌ 反向传播( backpropagation )是... ← 括号内有多余空格
- ❌ 反向传播 (backpropagation)是... ← 右括号后缺空格
- ❌ 反向传播(backpropagation) 是... ← 左括号前缺空格
12.3 嵌套括号¶
- 术语 + 附加缩写:
中文 (English Full Name, ABBR)— 用逗号分隔,不要嵌套 - ❌ "字节对编码 (Byte-Pair Encoding (BPE))"
- ✅ "字节对编码 (Byte-Pair Encoding, BPE)"
12.4 自动检查¶
grep 排查常见错误:
# 找中文与半角左括号紧贴(缺空格)
grep -nP '[\p{Han}]$' zh/**/*.md
# 找半角右括号后紧跟中文(缺空格)
grep -nP '$[\p{Han}]' zh/**/*.md
# 找括号内首尾空格
grep -nP '$ | $' zh/**/*.md
13. 章节结构规范 (v1.1 新增) — 一句话总结 + 重点归纳¶
本节规定的 一句话总结、本章导览、本节要点 均是 F12 认可的学习增强块:它们可不计入 F4/F6 的标题与列表结构比较,但不得替代、重排或省略增强块之外的原文信息单元;增强块之外仍须按原文顺序一一对应。
每一节 .md 文件的输出结构 (硬性):
# <节标题>
> **一句话总结**: <1 句, 30-50 字, 高度浓缩本节讲什么>
*<原作 italic 引言的中文翻译, 若原作有 italic 概述则保留>*
<正文...>
---
## 📌 本节要点
- **<关键概念 1>**: <10-20 字解释>
- **<关键概念 2>**: <10-20 字解释>
- ...
- (5-8 条为宜, 覆盖本节所有需要读者记住的东西)
<可选: 与下一节的衔接>
13.1 "一句话总结" 规则¶
- 位置:标题正下方 blockquote 形式
> **一句话总结**: xxx - 长度:30-50 中文字
- 内容:回答"这一节到底讲什么,为什么重要"
- 例:
-
一句话总结:向量空间是一切 AI/ML 表示的数学舞台,它保证向量间的加法与缩放不会"逃出空间",由此支撑起线性代数的整套理论。
-
一句话总结:分词是把连续文本切成模型能处理的离散 token 的关键预处理步骤;BPE / WordPiece / Unigram 是三种主流子词切分算法。
13.2 "本节要点" 规则¶
- 位置:文件末尾,用
---与正文分隔,用## 📌 本节要点作二级标题 - 条目:5-8 条,每条一行
- **术语**: 解释 - 目的:读者读完后只看要点就能回忆全节
- 若原节内容极短 (< 100 行 markdown): 3-5 条即可
- 若极长 (> 500 行):可扩到 10 条
- 术语部分用中文加粗,解释用陈述句,不用问号
13.3 章首页 (每章第一个 .md 文件) 额外要求¶
- 除本节的"一句话总结"与"本节要点"之外,额外在顶部加一段
## 🗺️ 本章导览, 5-8 行 bullet,概述整章 5 节的关系与阅读顺序建议 - 例 (Chapter 01 - Vectors 首节):
# 向量空间
> **一句话总结**: ...
## 🗺️ 本章导览
- 本章覆盖向量的一切: 空间 → 性质 → 度量 → 运算 → 高级结构
- **01. 向量空间** (本节): 定义向量与它们生活的空间, 引入公理
- **02. 向量的性质**: 长度、方向、单位化、正交
- **03. 范数与度量**: 各种距离与相似度
- **04. 向量积**: 点积、叉积、外积
- **05. 基与对偶**: 换基、对偶空间, 通往矩阵一章的桥梁
*<原作 italic 引言中译>*
<正文>
13.4 空章节处理¶
若原文文件为空 (如 Ch20 若干节),中文版同样保留空文件,内容为:
14. 联系与升级¶
- 手册版本:v1.1 (2026-07 update:缩写全称、括号对齐、章节归纳)
- 遇到手册未覆盖的新问题 → 在
zh/TRANSLATION_QA.md追加 (若无则创建),主编周期性合并到本手册 - 不要擅自修改本手册主体,手册变更由主编统一 gate
一句话:保住公式与代码,保住作者的语气,剩下的就是"让一个懂技术的中文朋友,用中文把这段讲明白"。