lovstudio 词库同步 · Vocabulary Sync
比对规范词库与目标 App 的词条，给出只读差异，用户确认后再执行写入。默认不覆盖对方已有词条，避免把用户攒下的命中数据或自定义词清掉。
Triggers
Activate when
- 用户要求把规范词库同步到某款 App。
- 用户想先看"哪些词没同步 / 哪些冲突"再决定。
- The user wants to diff and plan a vocabulary sync.
Do not activate when
- 用户只维护规范词库或只读某 App 词库（交给对应模块）。
Output classes
| class | 含义 | 处理 |
|---|---|---|
| add | canonical 有、App 没有 | 建议写入 |
| skip | 两边 phrase 相同且关键字段一致 | 无需处理 |
| conflict | phrase 相同但关键字段不同 | 需用户裁决，默认保留 App 侧 |
| app_only | App 有、canonical 没有 | 提示是否回填 canonical |
Workflow
- 读取规范词库与目标 App 词条（经 app-adapters）。
- 按 phrase 归一化后匹配，关键字段为
note、category、lang、enabled。 - 输出差异清单给用户，标注每类数量；先确认再执行。
- 执行时只做
add，绝不覆盖conflict或删除app_only，除非用户明确要求。
Diff example
python3 "$KIT_DIR/scripts/vocab_cli.py" diff \
--app openless \
--canonical vocabulary.json \
--app-file openless-dictionary.json
脚本输出纯文本差异，不写入任何 App。
Dependencies
- Python 3.9+，仅标准库。