技能介绍

要解决的问题

从 PDF、笔记或其它学习资料手工制作闪卡时，既要梳理知识点，又要处理 WinkNotes 的内部格式：content.json 的字段结构、.rimg 附件、标签层级、文本跨度偏移、附件 ID、样式位掩码、Base64 RTF 等。手工编写不仅低效，还容易因字段位置或媒体清单出错，导致导入失败或内容不可用。

技能如何工作

该技能把内容创作与格式序列化分开：由模型负责阅读源文档、起草原子化卡片、选择卡片类型和标签，再由内置脚本生成并校验 .wink 产物，用户不需要理解内部卡片 JSON 或 .wink 格式。

支持两种产物：单张卡片（独立 .wink 文件，导入时由 WinkNotes 指定目标卡组）与卡片包（带卡组名、标签和多张卡片）。
卡片类型包括正背笔记卡（适合自由回忆、解释、图片）和选择题卡（单选/多选，支持干扰项与解析）。
图片能力覆盖普通行内图片和矩形原生遮挡；遮挡必须通过 richImage 段生成，不能把色块烤进 PNG，也不能用前后两张图模拟。
关键流程是：确定产物类型 → 完整阅读源文档 → 读取写作规范并起草原子卡片 → 读取输入 schema 写 UTF-8 JSON → 调用构建脚本 → 运行校验 → 交付并报告统计信息。

适用边界与注意点

不要添加源文档不支持的事实，也不要机械地按段落逐条转换；没有指定数量时优先覆盖高价值内容。
选择题卡必须包含 2–26 个唯一选项和至少一个正确项；正确项为一个即单选，多个即多选。选择题文本支持有限格式，但本版本不支持图片或 richImage 段。
每张卡片每面最多 15 张图片；输入 JSON 中只使用本地图片路径，相对路径从 JSON 所在目录解析，不要放远程 URL。
不要手工编写 content.json、.rimg 属性列表、内部标签路径、跨度偏移、附件 ID、样式位掩码或 Base64 RTF；这些由构建脚本计算。
验证失败时不要交付；不要覆盖已存在输出文件，需要先选新路径或获得明确许可。
Markdown 标记会被当作字面文本，受支持格式通过段字段表达；highlight 会被 WinkNotes 当作遮挡内容参与分析，应谨慎使用。