From 9e357678708527b5fdc71383ad0a99a7205dc024 Mon Sep 17 00:00:00 2001
From: conanxu <1845830029@qq.com>
Date: Tue, 3 Nov 2026 13:09:40 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E6=98=8E=E7=A1=AE=E6=9C=AF=E8=AF=AD?=
 =?UTF-8?q?=E5=BF=85=E5=A1=AB=E5=AD=97=E6=AE=B5=E4=B8=8E=E5=A4=87=E4=BB=BD?=
 =?UTF-8?q?=E9=A1=BA=E5=BA=8F?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 skills/math-glossary/NORMALIZATION.md          | 2 ++
 skills/math-glossary/SKILL.md                  | 8 ++++----
 skills/math-glossary/references/user-manual.md | 8 ++++----
 3 files changed, 10 insertions(+), 8 deletions(-)

diff --git a/skills/math-glossary/NORMALIZATION.md b/skills/math-glossary/NORMALIZATION.md
index 77270de..9a843ad 100644
--- a/skills/math-glossary/NORMALIZATION.md
+++ b/skills/math-glossary/NORMALIZATION.md
@@ -56,6 +56,8 @@ changing their content meaning.
   literal text on import.
 - Added schema validation at script boundaries so invalid top-level JSON or
   missing required fields fail clearly before overwriting data.
+- Clarified that English and Chinese terms are both required and that an
+  optional backup must finish before glossary entries are merged or written.
 - Replaced automatic dependency installation instructions with explicit checks
   and user-approved installation commands.
 
diff --git a/skills/math-glossary/SKILL.md b/skills/math-glossary/SKILL.md
index 2fe9faa..a2da10c 100644
--- a/skills/math-glossary/SKILL.md
+++ b/skills/math-glossary/SKILL.md
@@ -247,8 +247,9 @@ options (multiSelect: false):
 
 1. 先问"请提供用于扩充的源文件路径"
 2. 验证路径存在后，询问第4问（是否备份）
-3. 走构建流程（解析→提取→冲突检测→合并）
-4. 完成后自动刷新 Excel 并生成扩充记录
+3. 用户选择备份时，先运行 `scripts/glossary_backup.py` 备份现有 `glossary.json`，确认备份成功后再继续
+4. 走构建流程（解析→提取→冲突检测→合并→写入）
+5. 完成后自动刷新 Excel 并生成扩充记录
 
 **注意：第4问是扩充流程专属问题，不在初始构建的四问交互流程中。初始构建的第3问之后直接进入构建流程，不需要第4问。**
 
@@ -275,8 +276,7 @@ options (multiSelect: false):
 1. JSON 按 en → cn 排序后重新连续分配 idx
 2. 调用 `glossary_export.py` 重新导出 Excel（删除旧 .xlsx，只保留新导出的）
 3. 生成 `扩充记录.md`（上述格式）
-4. 如果用户选择了"需要备份"，先用 `glossary_backup.py` 备份当前 glossary.json
-5. JSON 和 Excel 都要做排序+重编号，保证 idx 连续无断层
+4. JSON 和 Excel 都要做排序+重编号，保证 idx 连续无断层
 
 扩充完成后展示操作指引。
 
diff --git a/skills/math-glossary/references/user-manual.md b/skills/math-glossary/references/user-manual.md
index 98c67f4..6788e04 100644
--- a/skills/math-glossary/references/user-manual.md
+++ b/skills/math-glossary/references/user-manual.md
@@ -182,7 +182,7 @@ python3 scripts/glossary_web.py \
 ### 5.4 新增术语
 
 1. 点击底部「+ 新增术语」按钮
-2. 填写英文（必填）和中文（选填，可留空后补）
+2. 填写英文和中文，两项均为必填
 3. 系统自动查重：如果 `term_id` 已存在，弹出冲突提示，可选择覆盖或取消
 4. 提交后自动排序 + 重新编号 + 尝试刷新 Excel + 记录日志；Excel 失败时显示
    “JSON 已完成、Excel 待完成”
@@ -230,8 +230,9 @@ python3 scripts/glossary_web.py \
 1. 输入用于扩充的源文件路径
 2. 确认路径存在
 3. 是否备份？→ 需要（推荐）/ 不需要
-4. 执行构建流程（解析 → 提取 → 冲突检测 → 合并）
-5. 自动刷新 Excel 并生成扩充记录
+4. 选择备份时，先运行 scripts/glossary_backup.py 备份现有 glossary.json，确认备份成功后再继续
+5. 执行构建流程（解析 → 提取 → 冲突检测 → 合并 → 写入）
+6. 自动刷新 Excel 并生成扩充记录
 ```
 
 > **注意**：第 4 问（是否备份）是扩充流程的专属问题，初始构建不会出现。
@@ -241,7 +242,6 @@ python3 scripts/glossary_web.py \
 1. JSON 按 en → cn 排序后重新连续分配 idx
 2. 自动导出 Excel（删除旧版本，只保留最新）
 3. 生成 `扩充记录.md`
-4. 如果选择了"需要备份"，先用 `glossary_backup.py` 备份
 
 ---