| name | term-registration |
| description | 将已确认的英文术语→中文译名登记到 knowledge/01_terminology/_uncategorized.csv 的规范。翻译工作流确认术语清单后、或文中出现明确映射时使用。 |
术语登记规范
将已确认的 英文术语 → 中文译名 映射登记到项目术语库。本规范是术语入库的唯一权威来源。
写入范围
- 只写入
knowledge/01_terminology/_uncategorized.csv
- 不创建其他 CSV，不擅自归类（人工定期分拣到对应类别）
- 所有术语 CSV 共享
_example.csv 表头
触发条件
- 翻译工作流（最常见）：
translate-redstone Skill 阶段一确认术语清单后，自动将已确认术语入库
- 文中明确给出
英文术语 → 中文译名 映射
- 用户要求登记
同步步骤
- 筛选：排除
[待审核] 标记的术语，只保留已确认译名的条目
- 通用标准译名过滤（不入库）：对每条已确认术语做一次 通用标准译名判定——判定为通用学科公认标准译名的词，标
[通用词] 且不写入 knowledge/（仅保留标准译名作翻译参考；人工分拣不涉及此类词）
- 读表头：读
knowledge/01_terminology/_example.csv 获取表头
- 缓存命中拦截（不入库）：若该词在四级查找中已由 L1.5（
.cache/mojang/）或 L2（.cache/glossary/）命中——直接就地用缓存译名，不写入 knowledge/。缓存是"借来用"的；重复入库会让 L1 遮蔽刷新后的缓存、制造漂移，也污染项目库。只有两种情况允许入 _uncategorized.csv：
- 新词：四级查找全部未命中（含
scan 未覆盖的新机制/专有名词）
- 差异化译名：用户确认的、与缓存不同的项目标准（如
main storage→全物品仓库，缓存原译 全物品/全物品分类仓库）——此时 notes 必须写明「覆盖缓存译名：.cache/glossary/storage.csv 原译=…」
- 查重：读
knowledge/01_terminology/_uncategorized.csv，检查 term_en 是否已存在
- 追加：不存在则用 Python
csv.DictWriter 追加新行（term_en、term_zh、definition 从映射表获取，其余字段留空或填来源注释）；存在则跳过、不覆盖
- 来源格式：
notes/definition 中的来源必须写具体缓存文件路径——.cache/glossary/<分类>.csv、.cache/mojang/<文件>.csv、knowledge/01_terminology/<分类>.csv；禁止写笼统的 "TechMC Glossary" / "knowledge/"（呼应 use-glossary"用拆分缓存、不用源文件"规则）
- 索引：
_uncategorized.csv 词条变动不更新 indexes/knowledge/ 的具体词条（该条目只保留静态占位描述）；仅当新增非 _uncategorized 的稳定条目或类别描述实质变化时才更新索引，并同步更新索引文件的「最近更新/生成时间」时间戳（刷新判断依据，见 indexing-rules「索引时间戳与更新策略」）
通用标准译名判定
入库前对每条已确认术语做通用标准译名判定（agent 语义判断，不建清单文件）。命中的词标 [通用词] 且不写入 knowledge/（不入库，仅保留标准译名作翻译参考；人工分拣不涉及此类词）。
判定准则
同时满足以下特征的术语判定为通用标准译名：
- 通用学科领域：属于通用科学技术领域（算法/数据结构/数学/图形学/物理/化学/工程等），不是 Minecraft/红石专属（不属于本项目领域知识）
- 公认标准译名：有广泛公认的标准译名（或惯例保留英文原名），任何译者/任何语境翻译一致
- 语境无关：不因本项目（红石技术视频）语境产生特殊译法，不需要项目内做译名约定
示例
| 术语 | 判定 | 理由 |
|---|
| bilinear interpolation 双线性插值 | [通用词] | 通用图形学/数学算法，公认译名 |
| quicksort 快速排序 | [通用词] | 通用算法，公认译名 |
| Perlin noise Perlin 噪声 | [通用词] | 通用噪声算法，公认译名 |
反面（必须照常入库）
以下不属于通用标准译名，照常写入 _uncategorized.csv：
- 红石/游戏机制专属术语：如 红石比较器（Comparator）、活塞相位偏移（piston phase offset）、更新抑制（update suppression）
- 社区命名/专有名词：机器名、服务器名、人物、组织（如 Hermits、SciCraft）
- 视频特有指代/语境化译名：需本项目约定译法的词（如 main storage → 全物品仓库）
边界处理
- 判定核心 = 是否属于本项目领域知识：明确是通用学科公认词 → 标
[通用词] 不入库；拿不准是否红石/游戏专属 → 照常入库（宁多勿漏，人工分拣把关）
[通用词] 标记落点 = §1.3 确认清单/02_terms.md 来源列（也可由入库时判定后补标）；无论如何不写入 _uncategorized.csv- ⚠️ 与版本标注区分：
[通用词] 仅作确认清单/02_terms.md 来源列的决策标记（= 通用标准译名、不入库）；与 indexing-rules 的版本标注 [通用]（跨版本稳定）不同义——被标记词不入库、不会进入 CSV notes 列，两个语境不交汇，阅读时按所在位置辨义即可
ASR 映射登记（翻译工作流专用）
用户确认的 [ASR 推测] 条目，按归属分两层登记（去重后）：
- 跨视频通用（音近规律、高频词变体）→ 追加到
.github/experience/asr_fixes.md「已验证映射」表，按正确词聚合（正确词: 变体1 / 变体2），设 ~100 条规模上限
- 视频专属（人名、服务器、一次性语境）→ 追加到
_work/<视频名>/asr_fixes.md，不进全局表
相关规范
- CSV 编码/解析/写入细节见
csv-rules Skill
- 表头列含义见
csv-rules Skill「表头列含义」（唯一权威）
