| name | avd/source |
| description | 【AI视觉导演】输入源读取。支持 Obsidian、Markdown、粘贴和批处理；draft 输出解析结果，用户确认后写入 state/variable-registry。 |
Source — 输入源 / 项目读取
/avd/source 负责把外部内容整理成统一故事结构，再交给 /avd/create 或其他目标入口。
触发方式
/avd/source [路径/项目名]- 直接说 "读取项目"、"导入"、"从 Obsidian"
⚠️ 路由规则
| 用户说法 | 行为 |
|---|
/avd/source（未指定来源） | 展示输入源选单，等用户选来源类型 |
/avd/source Obsidian / /avd/source 从 Obsidian | 读取配置 OBSIDIAN_VAULT_PATH，扫描 Vault 目录，列出项目供用户选 |
/avd/source 文件 [路径] | 直接读取指定 Markdown 文件 |
/avd/source 粘贴 | 提示用户粘贴故事内容 |
/avd/source 批处理 [章节范围] | 批量处理，调用 engines/batch-chapter.md |
输入源选单：
| 编号 | 来源 | 说明 |
|---|
| 1 | Obsidian Vault | 从 OBSIDIAN_VAULT_PATH 扫描项目 |
| 2 | Markdown 文件 | 直接读取 .md 文件 |
| 3 | 直接粘贴 | 粘贴故事/剧本到对话 |
| 4 | 批处理章节 | 批量处理整章小说 |
回复编号选择来源。
支持来源
| 来源 | 处理文件 |
|---|
| 直接粘贴 | sources/paste-input.md |
| Obsidian Vault | sources/obsidian-ingest.md |
| Markdown 文件 | sources/obsidian-ingest.md 或 sources/frontmatter-parser.md |
| YAML frontmatter | sources/frontmatter-parser.md |
| 批量章节 | sources/obsidian-ingest.md + engines/batch-chapter.md |
输出
统一输出为：
输入源处理结果
→ 故事正文
→ 项目结构
→ 角色笔记
→ 场景笔记
→ frontmatter 元数据
→ 建议处理方式
→ draft 阶段只输出建议写入项；用户确认后再写入 state/variable-registry（project.title, project.genre, characters, scene）
之后按用户目标路由：
- 要完整视频包 →
/avd/create
- 只要分镜 →
/avd/storyboard
- 只要角色 →
/avd/character
- 只要场景 →
/avd/scene
Obsidian 支持的笔记结构
| 结构类型 | 说明 | 自动行为 |
|---|
| 单文件小说 | 一个笔记 = 整个故事 | 读取全文 → 提取信息 → 生成 |
| 章节文件夹 | 小说名/第1章.md 小说名/第2章.md... | 读取指定章节 |
| 带 frontmatter 的笔记 | 笔记顶部 YAML 元数据标注了角色/场景/类型 | 自动解析元数据，跳过部分提取步骤 |
| 角色独立笔记 | 角色/张三.md 含角色描述 | 自动读取角色笔记作为 DNA 初始值 |
| 场景独立笔记 | 场景/昆仑山.md 含场景描述 | 自动读取场景笔记作为场景参考 |
| 全项目模式 | 一个文件夹里「小说.md + 角色/.md + 场景/.md」 | 一键读取全部关联笔记，交叉引用 |
frontmatter 自动解析
如果笔记有 YAML 头，字段直接映射到 Step 1 提取字段：
---
title: 剑道独尊
genre: 玄幻
style: 东方玄幻
characters: [["张三", "主角", "剑修"], ["李四", "反派", "魔修"]]
scene: 昆仑山剑冢
emotion: 悲壮
structure: 三幕
target_platform: Seedance
---
长篇读取交互流程
用户说「从 Obsidian 读取 [目录名]」后，AI 先扫描，不直接生成：
【Obsidian 项目扫描结果】
📁 剑道独尊/
├── 第1章·剑冢觉醒.md (3200字)
├── 第2章·下山试剑.md (2800字)
├── ...
├── 角色/ (3个角色笔记)
└── 场景/ (2个场景笔记)
请选择：
1. 要处理哪些章节？回复编号，如「1-3」或「全部」
2. 每章做成多少秒的视频？回复秒数，如「15s」
（建议：由 video-director 多维度决策）
3. 每章需要多少分镜？回复镜数，如「7镜」
（建议：由 video-director 多维度决定）
快捷指令（跳过选择）
- 「Obsidian 读取 剑道独尊 全部 15s 7镜」 → 全章批量
- 「Obsidian 读取 第1章 30s」 → 单章，自动匹配镜数
交互规则
Obsidian 或批量章节只允许最多 1 次确认：章节范围、每章时长、每章镜数合并成一个问题。用户已经给出 全部 15s 7镜 时，不再追问。
