Book-to-Course Skill 技能

技能简介

Book-to-Course 是一个把书籍转成交互式课程的 Claude Code 插件技能，支持 EPUB、PDF、HTML、DOCX、Markdown 与纯文本输入。它读取书籍内容生成初学者友好的分步课程，再叠加练习与检验环节——动画讲解、互动测验、章节测试、闪卡、带单元测试的编程练习，并把学习进度保存在本地。生成的课程是一套自包含的本地网页文件夹，浏览器直接打开即可学习；插件还附带两个打包技能，可把课程一键封装成离线 Android 应用或 Linux 桌面 AppImage。项目采用 MIT 许可。

核心功能

• 分步课程与动画演示：按章节规划短课时，包含逐步讲解、示例、图表与动画走查；数学类书籍的 LaTeX 公式可在课文中正常渲染
• 多层检验体系：互动测验带提示与解析、章节测试、闪卡，学习者在课程页面内即可完成自测
• 真实编程练习：练习附起始代码与单元测试，学习者在自己的编辑器里写代码，从课程页面点 Run tests 按钮直接运行测试查看通过与否；技能在打包前会验证"起始代码测试失败、参考解测试通过"
• 进度本地追踪：课程、测验与练习进度写入本地 progress/progress.json，关闭后重开可继续
• Android 打包（course-to-apk）：把课程封装为离线 APK——轻量 WebView 壳、无需联网、进度保留在设备上，支持 Android 7.0+；直接用 Android SDK 工具构建（无需 Gradle/Android Studio），用调试密钥或自备密钥签名
• Linux 桌面打包（course-to-appimage）：封装为约 115MB 的单文件 AppImage（内置官方 Electron Chromium 与 Node.js、彩色 Emoji 字体），拷到任意桌面 Linux 即开即用；编程练习在桌面版照常运行测试，每个练习带 Open folder 按钮直达文件

安装配置

• 在 Claude Code 中添加插件市场并安装：/plugin marketplace add sebastianhaba/book-to-course-skill，然后 /plugin install book-to-course@book-to-course
• 后续更新：/plugin marketplace update book-to-course
• 运行环境：启动课程本地服务器需要 Python 3；编程练习需要对应语言与测试工具（如 Go 课程需安装 Go）
• Android 打包需要 JDK 17+ 与 Android SDK build-tools 及平台包；AppImage 打包需要 appimagetool、Electron（首次下载约 115MB）与 Noto Color Emoji 字体，技能会先检查依赖，缺失时说明下载位置并可在你同意后代为下载（免 sudo、校验和验证）

使用步骤

1. 安装插件，把书籍或文档附给 Claude，并提出"把这本书转成交互式课程"，可指定课程语言与范围
2. 技能提取源材料、按章规划课时，生成一套本地网页课程文件夹
3. 运行 start.sh（macOS/Linux）或 start.bat（Windows）启动本地服务器打开课程；也可以直接开 index.html（测验与课程可用，但进度留在浏览器、测试需手动在终端跑）
4. 逐课学习：看动画讲解、做测验与闪卡、写编程练习并点 Run tests 验证，进度自动保存
5. 需要分发时让技能打包：Android 平板用"Make an APK of this course"，Linux 桌面用"Make an AppImage of this course"

适用场景

• 自学者把技术书快速转成可练习的学习路径
• 教师与培训师将教材改造为带测验与进度跟踪的互动课程
• 企业内训材料的标准化与离线分发（APK/AppImage）
• 编程教学：随书代码练习配单元测试即时反馈

适用人群

自学者、教师、培训师、内容创作者，以及希望把静态书籍变成可交互、可分享学习产品的任何人。

工作原理

技能接收书籍后先提取源材料并按章节规划课时，随后把课程构建为自包含的本地网页文件夹（模板与参考文件随插件附带）。本地服务器承担两件事：把学习进度持久化到 progress/progress.json，以及响应 Run tests 按钮在本机执行练习的测试命令。打包链路上，course-to-apk 生成纯 WebView 的离线应用，course-to-appimage 用 Electron 内核封装课程并把练习复制到用户目录以便在桌面运行测试。生成的课程文件夹可整体复制分享，进度与内容均不依赖云端。

官方链接

GitHub 仓库：https://github.com/sebastianhaba/book-to-course-skill