mirror of
https://github.com/panatgithub/AnkiHeadingSync.git
synced 2026-07-22 06:51:43 +00:00
77 lines
No EOL
2.2 KiB
Markdown
77 lines
No EOL
2.2 KiB
Markdown
# Module 5 Decisions
|
||
|
||
## 1. 配置模型
|
||
|
||
新增并持久化以下字段：
|
||
|
||
1. `fileDeckEnabled`
|
||
2. `fileDeckMarker`
|
||
3. `fileDeckTemplate`
|
||
4. `fileDeckInsertLocation`
|
||
5. `folderDeckMode`
|
||
|
||
默认值严格按计划：
|
||
|
||
1. `fileDeckEnabled = false`
|
||
2. `fileDeckMarker = "TARGET DECK"`
|
||
3. `fileDeckTemplate = "obsidian::filename"`
|
||
4. `fileDeckInsertLocation = "body"`
|
||
5. `folderDeckMode = "off"`
|
||
|
||
## 2. 文件级 deck 解析
|
||
|
||
`DeckExtractionService` 改为接收 `fileDeckMarker` 参数，而不是写死：
|
||
|
||
1. YAML key 使用同一个 marker
|
||
2. 正文单行 / 双行语法也使用同一个 marker
|
||
3. 当 `fileDeckEnabled = false` 时，索引阶段完全跳过显式 deck 提取
|
||
|
||
## 3. 文件夹映射
|
||
|
||
`FolderDeckMappingService` 改为显式接收 `folderDeckMode`：
|
||
|
||
1. `off` 不参与映射
|
||
2. `folder` 使用父文件夹
|
||
3. `folder-and-file` 使用父文件夹 + 当前文件名
|
||
|
||
非法路径片段包含 `::` 时：
|
||
|
||
1. 不抛错中断
|
||
2. 产出 `deck_invalid_folder_segment` warning
|
||
3. 丢弃映射结果
|
||
4. 继续回退到 `defaultDeck`
|
||
|
||
## 4. 模板插入能力
|
||
|
||
新增单独的 deck 模板插入服务：
|
||
|
||
1. 负责 `filename` 变量展开
|
||
2. 负责 YAML / 正文两种插入模式
|
||
3. 负责在已有 YAML key 或正文 deck 声明存在时进行就地替换，避免重复声明
|
||
|
||
该能力通过设置页按钮触发，目标固定为当前活动 Markdown 文件。
|
||
|
||
## 5. manual-sync 接入
|
||
|
||
继续沿用当前 manual-sync 主链路：
|
||
|
||
1. `CardIndexingService` 只提取“文件级显式 deck 线索”
|
||
2. `RenderConfigService` 调用 `DeckResolutionService` 解析最终 deck
|
||
3. `DiffPlannerService` 分离字段更新与 deck 迁移计划
|
||
4. `AnkiBatchExecutor` 让 `toCreate` 使用 `resolvedDeck`，并在普通同步中执行 `changeDecks`
|
||
|
||
## 6. warnings
|
||
|
||
继续使用结构化 warning 结果对象，不把 notice 当作唯一载体。
|
||
|
||
模块 5 需要继续保证：
|
||
|
||
1. `deck_conflict_yaml_body`
|
||
2. `deck_multiple_body_declarations`
|
||
3. `deck_invalid_folder_segment`
|
||
4. `deck_fallback_default`
|
||
|
||
## 7. UI 选择
|
||
|
||
为保持改动聚焦，本轮设置页的“单选”使用 dropdown 实现，而不是新增自定义 radio 组件。
|
||
语义仍然是互斥单选，不扩展复杂交互。 |