Skip to content

docs: 明确术语必填字段与备份顺序 #6

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
ConanXu-math merged 1 commit into from
Nov 3, 2026
Merged

docs: 明确术语必填字段与备份顺序 #6

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions skills/math-glossary/NORMALIZATION.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down
8 changes: 4 additions & 4 deletions skills/math-glossary/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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问。**

Expand All @@ -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 连续无断层

扩充完成后展示操作指引。

Expand Down
8 changes: 4 additions & 4 deletions skills/math-glossary/references/user-manual.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -182,7 +182,7 @@ python3 scripts/glossary_web.py \
### 5.4 新增术语

1. 点击底部「+ 新增术语」按钮
2. 填写英文（必填）和中文（选填，可留空后补）
2. 填写英文和中文，两项均为必填
3. 系统自动查重：如果 `term_id` 已存在，弹出冲突提示，可选择覆盖或取消
4. 提交后自动排序 + 重新编号 + 尝试刷新 Excel + 记录日志；Excel 失败时显示
“JSON 已完成、Excel 待完成”
Expand Down Expand Up @@ -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 问（是否备份）是扩充流程的专属问题，初始构建不会出现。
Expand All @@ -241,7 +242,6 @@ python3 scripts/glossary_web.py \
1. JSON 按 en → cn 排序后重新连续分配 idx
2. 自动导出 Excel（删除旧版本，只保留最新）
3. 生成 `扩充记录.md`
4. 如果选择了"需要备份"，先用 `glossary_backup.py` 备份

---

Expand Down
Loading