obsidian-plugin/panatgithub_AnkiHeadingSync
1
0
Fork 0
mirror of https://github.com/panatgithub/AnkiHeadingSync.git synced 2026-07-22 17:10:28 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
panatgithub_AnkiHeadingSync/docs/qa-group-mapping-parser-gap-report.md
Dusk 8357992ee3 feat(sync): refine QA mappings and cloze output 
中文: 优化问答题多级列表字段映射与解析，移除填空题兼容性误判，并调整填空题正文分隔符和设置页展示。

English: Refine QA group field mapping and parser behavior, remove stale cloze compatibility assumptions, and update cloze body separator plus settings UI copy.
2026-04-26 16:55:31 +08:00

2.2 KiB
Raw Blame History

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