# 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 组件。
语义仍然是互斥单选，不扩展复杂交互。