用途
plaud-ingestion 用于把 PLAUD 云端的录音内容镜像为 Obsidian 仓库中的永久笔记。PLAUD 录音设备（NotePin、plaud.ai 应用）负责录音、转录、说话人分离并生成 AI 总结笔记；本技能负责把这些内容整理成结构固定、归类清晰的笔记，写入仓库的 raw/Plaud/ 目录。PLAUD 是内容的权威来源，仓库是最终归档。
同步规则
- 单向同步：只从 PLAUD 读取并写入仓库，任何情况下都不向 PLAUD 写回内容。MCP 工具只提供 list 和 get 等读取能力，不应尝试创建、编辑或删除 PLAUD 侧的任何数据。
- 删除只追加、不删除：如果 PLAUD 中的录音被删除（例如释放云端空间），仓库笔记保持原样，只把状态文件中该条目的状态改为 source_deleted，绝不删除、截断或标记仓库笔记。
- 更新以覆盖方式写回原笔记：如果用户在 PLAUD 应用中重命名说话人，或转录被重新处理，仓库笔记中的转录、说话人列表和 PLAUD AI 笔记等内容会在同一文件内重建；文件名、H1 标题和日期 frontmatter 保持不变。
- 不存档音频：仓库只保存转录文本。get_file 返回的音频预签名 URL 有效期为 24 小时，不下载也不存储音频；如果用户之后需要某段录音的音频，可在交互式会话中获取链接并交给用户。
运行方式
- 定时运行：由 plaud-sync 调度任务触发（每日 07:30 America/New_York，工作目录为仓库根目录）。
- 交互式运行：当用户在已加载 plaud MCP 工具的会话中要求同步或补录时触发。
- 两种方式的处理流程一致，只有每批处理数量上限不同：定时运行每次最多处理 10 个文件，先处理需要重新同步的，再处理新文件，并按录制日期从旧到新排序；交互式补录可按用户要求提高上限。未处理完的文件会在运行摘要中标注，下次运行继续。
主要流程
- 预检：调用 get_current_user 验证登录状态，再通过 list_files 分页获取录音列表（最多扫描最近 500 条）。若未通过认证，只记录日志并回复 “plaud not authenticated”，不重试、不改动状态；登录需在交互式会话中完成（login 工具会打开浏览器）。
- 比对状态：依据 .plaud/state/sync-state.json 判断每个录音是新增、需要重新同步还是可能已删除。判断重新同步的依据是来源更新时间字段变化，或（无更新字段时）首选转录块首页哈希变化。仅当本次扫描结果完整时，才把缺失的录音标记为 source_deleted。
- 抓取内容：获取元数据、AI 总结、模板标签页和高亮笔记（高亮须包含每个标记时刻的标题与完整正文），再分页获取转录（优先 transaction_polish，缺失时回退 transaction）。
- 写入笔记：新文件按约定格式生成；重新同步时重建 Summary、Plaud AI notes、Transcript、Action items 等段落，保留文件名、H1、日期和 Related 链接，并刷新说话人列表与同步时间。
- 校验与记录：确认笔记包含转录、PLAUD AI 笔记原文、完整高亮正文和智能体撰写的摘要四个内容块后，再原子更新状态文件（先写临时文件再重命名），并向 .plaud/logs/sync.log 追加一行运行摘要。
笔记格式
笔记路径为 raw/Plaud/YYYY-MM-DD-HHMM-kebab-slug.md，slug 根据内容生成，而不是采用 PLAUD 的通用自动标题。frontmatter 包含日期、录制时间（带时区偏移）、时长、来源、plaud_id、原始标题、更新时间、转录块类型、说话人列表、状态和标签。正文依次包含：Summary（智能体综合转录、高亮和 PLAUD AI 总结撰写，其中转录权重最高）、Plaud AI notes（应用生成内容原文，明确标注）、Highlights（完整高亮正文）、Transcript（按说话人合并连续发言并标注时间戳）、Action items（仅在确实存在具体行动项时出现）和 Related 链接。无效录音（误触、静音、不足 10 秒的测试）也会生成笔记，但摘要如实写一行且不含 Related 段。
归类
只为真正可复用的概念创建常青笔记，一篇录音最多一到三篇，很多录音为零篇；将笔记或最佳常青笔记双向挂接到对应 wiki/MOCs 文件的相应章节；不虚构 wikilink，链接前先确认目标笔记存在。每次写入后从仓库根目录运行 markdownlint。
适用场景
适合已使用 PLAUD 录音设备、希望在 Obsidian 仓库中长期保存转录与 AI 笔记的用户，尤其是需要每日自动归档、按概念整理笔记并与 MOC 关联的工作流。
限制与边界
依赖 plaud MCP 工具在会话中加载，未加载时无法运行；MCP 不可用时不提供 REST 替代方案。定时任务无法登录，认证失效时只记录并跳过。分页抓取中途失败时不写部分转录，留待下次重试。PLAUD 应用中的图片以 plaud:// 占位符出现在笔记里，但没有获取图片的路径，合成笔记时会被清除；用户若手动把高亮图片存入仓库附件目录，可嵌入对应高亮标题下。与 Apple 语音备忘录管线互不干扰，同一录音经两条路径可能产生两篇笔记，这种重复被接受，不做跨管线合并。