知识卡片生成器

将知识内容转化为视觉化的知识卡片图片系列。支持从文章自动提取知识点拆分，也支持直接输入知识点。可选的卡通角色融合——有角色图片时自然融入卡片画面。

两个维度

维度	控制	示例
卡片类型（Layout）	信息结构与布局	要点清单、对比卡、问答卡、定义卡、步骤卡、矩阵卡
视觉风格（Style）

视觉美学 | 极简手绘、可爱、粉笔画、手写笔记、醒目 |

自由组合：INLINECODE0

或使用预设：--preset study-guide → 类型 + 风格一步到位。详见 预设快捷方式。

卡片类型（Layout）

类型	描述	适用内容
INLINECODE2（要点清单）	编号列表 + 图标，3-7 个要点	干货清单、注意事项、必备技能
INLINECODE3（对比卡）

左右分栏或上下对比 | 优缺点、新旧对比、A vs B | | definition（定义卡） | 大标题 + 核心解释 + 例子 | 概念科普、术语解释 | | steps（步骤卡） | 编号步骤 + 简要说明 | 教程、操作指南、流程 | | qa（问答卡） | 问题 + 答案结构 | FAQ、常见误区、面试题 | | matrix（矩阵卡） | 2×2 或多格矩阵 | 分类、象限分析、SWOT | | quote（金句卡） | 大字金句 + 出处/解读 | 名言、核心观点、启发 | | mindmap（脑图卡） | 中心主题 + 分支 | 知识脉络、概念关系 | | cover（封面卡） | 系列封面，标题 + 主视觉 | 系列首图 | | summary（总结卡） | 系列收尾，核心回顾 + CTA | 系列末图 |

详见 references/card-layouts.md。

风格（Style）

风格	描述	适用场景
INLINECODE12（极简手绘）	Notion 风格简笔画，知性简洁	知识分享、效率工具
INLINECODE13（手写笔记）

仿真手写，蓝笔 + 红批注 + 黄荧光笔 | 学习笔记、考试重点 | | chalkboard（粉笔画） | 黑板 + 彩色粉笔 | 课堂笔记、教学 | | cute（可爱） | 甜美柔和、圆润线条 | 生活分享、轻松内容 | | bold（醒目） | 高冲击力、大字体、强对比 | 避坑指南、重要提醒 | | warm（温暖） | 友好亲切、柔和色调 | 个人成长、教育 | | vector-illustration（矢量插画） | 扁平矢量、大胆几何 | 技术内容、教程 | | minimal（极简） | 极致简洁、大量留白 | 哲学、核心概念 | | screen-print（丝网印刷） | 海报艺术、半色调 | 观点、文化评论 |

详见 references/styles.md。

使用方式

CODEBLOCK0

选项

选项	描述
INLINECODE21	卡片类型（见上表）
INLINECODE22

视觉风格（见上表） | | --preset <name> | 预设快捷方式（见 presets.md） | | --platform <name> | 目标平台：xhs(3:4), wechat(16:9), weibo(16:9), general(16:9) | | --role <mode> | 角色融合模式：auto, narrator, participant, decorator, none | | --count <n> | 卡片数量（默认自动） | | --lang <code> | 卡片语言：auto, zh, en 等 |

工作流程

CODEBLOCK1

步骤 0: 预检查

0.1 加载偏好设置（EXTEND.md）⛔ 阻塞

CODEBLOCK2

结果	操作
找到	读取、解析、显示摘要
未找到

⛔ 运行 首次配置 |

0.2 加载角色配置

从 EXTEND.md 的"角色"区块读取角色信息。角色融合的详细规则引用 panda-article-illustrator 的 character-roles.md。

完整流程详见 references/workflow.md

步骤 1: 内容分析

文章提取模式：分析文章，提取核心知识点，自动拆分为卡片序列。详见 references/extraction-rules.md。

手动输入模式：结构化用户提供的知识点，确定适合的卡片类型。

完整流程详见 references/workflow.md

步骤 2: 确认设置 ⚠️

使用 AskUserQuestion，最多 4 个问题。

问题	选项
Q1: 预设或类型	[推荐预设], [备选预设], 或手动选择卡片类型
Q2: 风格

[推荐], notion, cute, bold, chalkboard, study-notes, 其他 |
| Q3: 张数 | 自动(推荐), 3张, 5张, 7张, 自定义 |
| Q4: 角色模式 | 自动推荐, 讲解者, 点缀, 无角色 — 仅在有角色配置时显示 |

完整流程详见 references/workflow.md

步骤 3: 生成大纲

保存 outline.md 到输出目录，包含每张卡片的标题、要点、布局类型、角色动作。

完整模板详见 references/workflow.md

步骤 4: 生成提示词 + 图片

⛔ 提示词文件必须在图片生成之前保存。

1. 1. 为每张卡片创建提示词文件，遵循 references/prompt-construction.md
2. 保存到 INLINECODE41
3. 有角色时注入角色区块，使用 --ref 传递角色参考图
4. 调用图片生成技能生成图片

完整流程详见 references/workflow.md

步骤 5: 完成报告

CODEBLOCK3

输出目录

INLINECODE43	输出路径
INLINECODE44（默认）	INLINECODE45
INLINECODE46

当前目录 | | imgs-subdir | {article-dir}/imgs/ |

CODEBLOCK4

Slug 规则：2-4 个词，kebab-case。冲突：追加 -YYYYMMDD-HHMMSS。

修改已有卡片

操作	步骤
编辑	更新提示词 → 重新生成 → 更新引用
添加

确定位置 → 创建提示词 → 生成 → 更新大纲 | | 删除 | 删除文件 → 更新大纲 |

参考文档

文件	内容
references/workflow.md	完整工作流程
references/card-layouts.md

10 种卡片类型详解 | | references/extraction-rules.md | 文章知识点提取规则 | | references/prompt-construction.md | 提示词构建指南 | | references/styles.md | 风格体系 | | references/presets.md | 预设快捷方式 | | references/config/first-time-setup.md | 首次配置流程 | | references/config/preferences-schema.md | EXTEND.md schema | | 角色融合模式 | 引用 article-illustrator | | 角色风格兼容性 | 引用 article-illustrator | | 社交平台预设 | 引用 article-illustrator |