knowledge-digest

将学习资料（PDF/教材/话题）转换为个性化、多模态的学习材料：手写笔记PDF、极简交互测验HTML、幻灯片PDF+PPTX、思维导图、音频课程。触发词：知识消化、学习材料、笔记生成、测验、幻灯片、思维导图、音频课程、课件、教材转换

yinin2005@yinin2005

Install

openclaw skills install @yinin2005/knowledge-digest

知识消化助手

Overview

将教材、PDF 或话题转换为个性化、多模态的学习材料。根据年级水平（小学/初中/高中/大学/专业）自动调整内容深度和表达方式。

支持的输出格式

格式	关键词	说明
notes	笔记/手写笔记	手写风格笔记 PDF
quiz	测验/测试	极简 HTML 交互测验
slides	幻灯片/PPT	PDF + PPTX 双版本
mindmap	思维导图	PNG + Mermaid 文本
audio	音频课程	师生对话 mp3，约15分钟
all	全部	生成所有格式

默认：mindmap + slides(PDF) + quiz

Workflow

阶段1：获取用户输入

用户上传 PDF/教材（可选）
或指定话题/方向
年级水平（小学/初中/高中/大学/专业）
期望输出格式

无资料时：询问用户选择"上传资料"或"帮我搜索并生成"。

阶段2：内容解析

提取章节结构、核心概念、关键术语、学习目标、知识点依赖关系，输出 JSON 结构供后续生成使用。

阶段3：按格式生成（见各格式指南）

阶段4：统一交付

text

<deliver_assets>
<item><path>文件路径</path></item>
</deliver_assets>

规则：只返回文件路径，禁止在对话中内嵌展示任何文件。

年级适配

年级	语言风格	内容深度
小学	活泼、故事化、鼓励性	生活化、简单
初中	引导式提问、基础术语	日常场景、适中难度
高中	逻辑推理、学术性	专业术语、高难度
大学/专业	研讨式、批判性思维	学术语言、专业深度

格式1：手写风格笔记（notes）

类型A（原文PDF → 叠加手写标注）：

逐页分析 PDF 内容，识别章节/概念/公式/问题
规划每页3-8处标注（蓝色：结构标注/概念解释；粉色：重点提问/解决方案）
生成带手写标注的页面图像
编译为 PDF（150 DPI，90%质量）

类型B（从零生成手写笔记）：

整理内容为层级结构（标题→章节→核心概念→要点→示例）
设计手写风格版式（标题大、正文手写要点、有图解和标注）
逐页生成手写风格图像
编译为 PDF

颜色规则：全 PDF 统一不超过2种颜色（默认蓝+粉）

格式2：交互测验（quiz）

每节至少5道题：选择题2-3道、判断题1-2道、填空题1-2道
难度：40%简单、40%中等、20%困难
每题含正确答案+有教学价值的解析
生成单个 HTML 文件，视觉极简（纯白背景、无装饰）
交互：点击选项→选中→提交→即时反馈对错+解析→显示总分

格式3：幻灯片（slides）

创建 content_script.md：每张幻灯片用50-80字描述信息内容，专注信息架构，不描述视觉细节
逐张生成图像：第一张用 gen_images，后续用 edit_images 以上一张为 base
编译：生成 PDF（150 DPI）+ PPTX

视觉原则：

图表/插图是信息的主要载体，不是装饰背景
拒绝"大面积留白+居中文字"的低效模式
信息密度匹配专业信息图

格式4：思维导图（mindmap）

层级不超过4层，根节点=主题，一级=核心概念，二级=细节要点
每节点不超过10字
输出 PNG + Mermaid 文本

格式5：音频课程（audio）

师生对话形式，约15分钟，约150-180字/分钟
所有例子从用户兴趣领域取材
老师声音温和专业，学生声音好奇活泼
输出 mp3

通用约束

内容必须基于原教材，不添加未经验证的信息
测验HTML保持极简：不使用 UI 框架、渐变、阴影
笔记全 PDF 严格限制不超过2种颜色
禁止在对话中预览/内嵌展示任何生成文件
音频文件禁止自动播放

Common Mistakes

内容偏离原教材，自行发挥
忽略年级适配，语言深度不当
笔记颜色过多
测验HTML过度设计
幻灯片文字主导、视觉无信息价值
幻灯片使用蓝色/紫色作为主题色（除非用户指定）
预览/内嵌展示生成文件
思维导图层级过深

文件命名与交付

格式	文件名
笔记	`{topic}_notes.pdf`
测验	`{topic}_quiz.html`
幻灯片	`{topic}_slides.pdf` + `{topic}_slides.pptx`
思维导图	`{topic}_mindmap.png`
音频	`{topic}_audio.mp3`

交付统一用 <deliver_assets> 标签。