mirror of
https://github.com/panatgithub/AnkiHeadingSync.git
synced 2026-07-22 17:10:28 +00:00
8357992ee3
中文: 优化问答题多级列表字段映射与解析，移除填空题兼容性误判，并调整填空题正文分隔符和设置页展示。 English: Refine QA group field mapping and parser behavior, remove stale cloze compatibility assumptions, and update cloze body separator plus settings UI copy.
38 lines
2.2 KiB
Markdown
38 lines
2.2 KiB
Markdown
# QA Group Mapping / Parser Gap Report
|
|
|
|
## Audit Baseline
|
|
|
|
- Sync-side authority for QA Group was already correct before this change: sync used saved slots and only validated field existence.
|
|
- Settings UI was still under-specified: users could only change the title field and see an auto-detected slot summary.
|
|
- QA Group field detection still depended on fixed question/answer naming heuristics and could not persist a user-selected first pair.
|
|
- QA Group parsing still truncated answers to the first direct second-level list item label.
|
|
- Stale Cloze compatibility remnants still existed in `NoteModelDetails.isCloze` and the unused `clozeIncompatible` i18n copy.
|
|
|
|
## Closed Gaps
|
|
|
|
- Added optional QA Group derivation metadata so settings can persist the first selected question/answer pair while keeping concrete slots as sync authority.
|
|
- Refactored QA Group field derivation to support “choose the first pair once, derive the rest automatically”.
|
|
- Updated the QA Group settings UI to expose:
|
|
- title field
|
|
- first question field
|
|
- first answer field
|
|
- configured pair count with first/last example
|
|
- Changed field refresh behavior so only mappings with derivation metadata are regenerated from the latest Anki fields.
|
|
- Preserved old explicit QA Group slot mappings when no derivation metadata exists.
|
|
- Updated the QA Group parser so answers now keep the full child block markdown, including multiline text, nested lists, and code fences.
|
|
- Removed stale `NoteModelDetails.isCloze` metadata and deleted the dead `clozeIncompatible` copy.
|
|
|
|
## Intentional Compatibility Rules
|
|
|
|
- Old QA Group mappings with explicit slots and no derivation metadata continue to work unchanged.
|
|
- New QA Group mappings no longer emit incomplete-tail warnings during suggestion; they derive continuous pairs from the selected first pair and stop at the first missing complete pair.
|
|
- Simple QA Group answers that were previously represented as a single nested bullet still serialize to the same plain-text answer where practical.
|
|
|
|
## Validation Status
|
|
|
|
- Focused tests passed for:
|
|
- QA Group field derivation service
|
|
- plugin settings normalization / validation
|
|
- settings UI behavior
|
|
- QA Group parser behavior
|
|
- sync / gateway / batch executor slices touched by `NoteModelDetails`
|