- name
- panda-knowledge-card
- description
- >-
- version
- 1.0.0
- metadata
- openclaw
- homepage
- https://github.com/hash-panda/panda-skills#panda-knowledge-card
知识卡片生成器
将知识内容转化为视觉化的知识卡片图片系列。支持从文章自动提取知识点拆分，也支持直接输入知识点。可选的卡通角色融合——有角色图片时自然融入卡片画面。
两个维度
| 维度 | 控制 | 示例 |
|---|---|---|
| 卡片类型（Layout） | 信息结构与布局 | 要点清单、对比卡、问答卡、定义卡、步骤卡、矩阵卡 |
| 视觉风格（Style） | 视觉美学 | 极简手绘、可爱、粉笔画、手写笔记、醒目 |
自由组合：--layout tips --style notion
或使用预设：--preset study-guide → 类型 + 风格一步到位。详见 预设快捷方式。
卡片类型（Layout）
| 类型 | 描述 | 适用内容 |
|---|---|---|
tips（要点清单） | 编号列表 + 图标，3-7 个要点 | 干货清单、注意事项、必备技能 |
comparison（对比卡） | 左右分栏或上下对比 | 优缺点、新旧对比、A vs B |
definition（定义卡） | 大标题 + 核心解释 + 例子 | 概念科普、术语解释 |
steps（步骤卡） | 编号步骤 + 简要说明 | 教程、操作指南、流程 |
qa（问答卡） | 问题 + 答案结构 | FAQ、常见误区、面试题 |
matrix（矩阵卡） | 2×2 或多格矩阵 | 分类、象限分析、SWOT |
quote（金句卡） | 大字金句 + 出处/解读 | 名言、核心观点、启发 |
mindmap（脑图卡） | 中心主题 + 分支 | 知识脉络、概念关系 |
cover（封面卡） | 系列封面，标题 + 主视觉 | 系列首图 |
summary（总结卡） | 系列收尾，核心回顾 + CTA | 系列末图 |
详见 references/card-layouts.md。
风格（Style）
| 风格 | 描述 | 适用场景 |
|---|---|---|
notion（极简手绘） | Notion 风格简笔画，知性简洁 | 知识分享、效率工具 |
study-notes（手写笔记） | 仿真手写，蓝笔 + 红批注 + 黄荧光笔 | 学习笔记、考试重点 |
chalkboard（粉笔画） | 黑板 + 彩色粉笔 | 课堂笔记、教学 |
cute（可爱） | 甜美柔和、圆润线条 | 生活分享、轻松内容 |
bold（醒目） | 高冲击力、大字体、强对比 | 避坑指南、重要提醒 |
warm（温暖） | 友好亲切、柔和色调 | 个人成长、教育 |
vector-illustration（矢量插画） | 扁平矢量、大胆几何 | 技术内容、教程 |
minimal（极简） | 极致简洁、大量留白 | 哲学、核心概念 |
screen-print（丝网印刷） | 海报艺术、半色调 | 观点、文化评论 |
使用方式
# 从文章提取知识点生成卡片系列
/panda-knowledge-card article.md
# 指定风格
/panda-knowledge-card article.md --style notion
# 直接输入知识点
/panda-knowledge-card
[粘贴内容或描述知识点]
# 指定卡片类型 + 风格
/panda-knowledge-card --layout tips --style bold
# 使用预设
/panda-knowledge-card article.md --preset study-guide
# 指定平台
/panda-knowledge-card article.md --platform xhs
# 指定角色模式
/panda-knowledge-card article.md --role narrator选项
| 选项 | 描述 |
|---|---|
--layout <name> | 卡片类型（见上表） |
--style <name> | 视觉风格（见上表） |
--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 等 |
工作流程
- [ ] 步骤 0: 预检查（EXTEND.md、角色配置）
- [ ] 步骤 1: 内容分析（文章提取 或 手动输入）
- [ ] 步骤 2: 确认设置（AskUserQuestion）
- [ ] 步骤 3: 生成大纲
- [ ] 步骤 4: 生成提示词 + 图片
- [ ] 步骤 5: 完成报告步骤 0: 预检查
0.1 加载偏好设置（EXTEND.md）⛔ 阻塞
test -f .panda-skills/panda-knowledge-card/EXTEND.md && echo "project"
test -f "${XDG_CONFIG_HOME:-$HOME/.config}/panda-skills/panda-knowledge-card/EXTEND.md" && echo "xdg"
test -f "$HOME/.panda-skills/panda-knowledge-card/EXTEND.md" && echo "user"| 结果 | 操作 |
|---|---|
| 找到 | 读取、解析、显示摘要 |
| 未找到 | ⛔ 运行 首次配置 |
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: 生成提示词 + 图片
⛔ 提示词文件必须在图片生成之前保存。
- 为每张卡片创建提示词文件，遵循 references/prompt-construction.md
- 保存到
prompts/NN-{layout}-{slug}.md - 有角色时注入角色区块，使用
--ref传递角色参考图 - 调用图片生成技能生成图片
完整流程详见 references/workflow.md
步骤 5: 完成报告
知识卡片生成完成！
主题：[topic]
风格：[style] | 平台：[platform] | 比例：[ratio]
角色：[名称] / [融合模式] 或 "无角色"
卡片：X 张已生成
文件列表：
✓ outline.md
✓ 01-cover-[slug].png
✓ 02-tips-[slug].png
✓ ...
✓ NN-summary-[slug].png输出目录
默认输出目录 | 输出路径 |
|---|---|
knowledge-cards（默认） | knowledge-cards/{topic-slug}/ |
same-dir | 当前目录 |
imgs-subdir | {article-dir}/imgs/ |
{output-dir}/
├── source-{slug}.md # 源内容（如有）
├── outline.md # 大纲
├── prompts/
│ └── NN-{layout}-{slug}.md
├── 01-cover-{slug}.png
├── 02-{layout}-{slug}.png
└── NN-summary-{slug}.pngSlug 规则：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 |