term-registration

name	term-registration
description	将已确认的英文术语→中文译名登记到 knowledge/01_terminology/_uncategorized.csv 的规范。翻译工作流确认术语清单后、或文中出现明确映射时使用。

术语登记规范

将已确认的 英文术语 → 中文译名 映射登记到项目术语库。本规范是术语入库的唯一权威来源。

写入范围

• 只写入 knowledge/01_terminology/_uncategorized.csv
• 不创建其他 CSV，不擅自归类（人工定期分拣到对应类别）
• 所有术语 CSV 共享 _example.csv 表头

触发条件

• 翻译工作流（最常见）：translate-redstone Skill 阶段一确认术语清单后，自动将已确认术语入库
• 文中明确给出 英文术语 → 中文译名 映射
• 用户要求登记

同步步骤

1. 筛选：排除 [待审核] 标记的术语，只保留已确认译名的条目
2. 通用标准译名过滤（不入库）：对每条已确认术语做一次 通用标准译名判定——判定为通用学科公认标准译名的词，标 [通用词] 且不写入 knowledge/（仅保留标准译名作翻译参考；人工分拣不涉及此类词）
3. 读表头：读 knowledge/01_terminology/_example.csv 获取表头
4. 缓存命中拦截（不入库）：若该词在四级查找中已由 L1.5（.cache/mojang/）或 L2（.cache/glossary/）命中——直接就地用缓存译名，不写入 knowledge/。缓存是"借来用"的；重复入库会让 L1 遮蔽刷新后的缓存、制造漂移，也污染项目库。只有两种情况允许入 _uncategorized.csv：
   • 新词：四级查找全部未命中（含 scan 未覆盖的新机制/专有名词）
   • 差异化译名：用户确认的、与缓存不同的项目标准（如 main storage→全物品仓库，缓存原译 全物品/全物品分类仓库）——此时 notes 必须写明「覆盖缓存译名：.cache/glossary/storage.csv 原译=…」
5. 查重：读 knowledge/01_terminology/_uncategorized.csv，检查 term_en 是否已存在
6. 追加：不存在则用 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"用拆分缓存、不用源文件"规则）
7. 索引：_uncategorized.csv 词条变动不更新 indexes/knowledge/ 的具体词条（该条目只保留静态占位描述）；仅当新增非 _uncategorized 的稳定条目或类别描述实质变化时才更新索引，并同步更新索引文件的「最近更新/生成时间」时间戳（刷新判断依据，见 indexing-rules「索引时间戳与更新策略」）

通用标准译名判定

入库前对每条已确认术语做通用标准译名判定（agent 语义判断，不建清单文件）。命中的词标 [通用词] 且不写入 knowledge/（不入库，仅保留标准译名作翻译参考；人工分拣不涉及此类词）。

判定准则

同时满足以下特征的术语判定为通用标准译名：

1. 通用学科领域：属于通用科学技术领域（算法/数据结构/数学/图形学/物理/化学/工程等），不是 Minecraft/红石专属（不属于本项目领域知识）
2. 公认标准译名：有广泛公认的标准译名（或惯例保留英文原名），任何译者/任何语境翻译一致
3. 语境无关：不因本项目（红石技术视频）语境产生特殊译法，不需要项目内做译名约定

示例

术语	判定	理由
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「表头列含义」（唯一权威）