中文 | English
把一份课件变成可以沿页学习、也可以沿概念探索的离线学习网页。
slide-study 是一个 Codex skill。它先理解全篇，再按原页序解释“讲了什么、为什么在这里讲、如何承接前后”，最后建立带来源页与关联理由的知识图。适合已有学科基础、首次学习这门课的读者。
- 逐页串讲：先给课程总览与阅读主线，再解释每页的机制、例子、推导和应记住的内容。封面简写，关键内容展开，渐进演示页说明新增部分。
- 有依据的知识图：合并同义概念，组织前置依赖、推导、应用、对比、问题与解决方案、证据支持等关系。每条关系说明理由，并可回到原页。
- 区分解释依据：分别标注课件内容（
source）、补充解释（supplement）、推断（inference）和不确定内容（uncertain）。 - 原页与讲义对照：桌面并排、窄屏上下排列；支持图片放大、搜索、目录、页码跳转和上一页／下一页。
- 交互探索：知识图支持缩放、平移、搜索和邻接高亮；讲义、概念与来源页双向跳转。
- 完整交付：一次覆盖整份课件，保留原件，交付独立网页目录、ZIP 和可编辑的课程数据。
支持 PPTX、课件 PDF，以及经本机 LibreOffice 转换的旧版 PPT。一次处理一份课件；PPTX 按实际演示顺序关联页面与讲者备注。
生成的目录包含：
my-course/
├── index.html # 学习入口
├── lesson.json # 可编辑的逐页讲义、概念与关系
├── source.json # 原页信息与来源记录
├── pages/ # 原页图像
└── assets/ # 本地脚本、样式、公式字体
my-course.zip
解压 ZIP 后打开 index.html 即可阅读。成品无需账户、服务器、模型 API 或 CDN，课程数据直接嵌入网页；生成过程需要 AI 阅读课件、撰写讲义并审查内容。脚本负责提取、渲染、校验与打包。
README 可切换中英文；学习网页界面目前为中文，讲解默认中文。 可以在任务中指定讲解语言，网页界面没有语言切换按钮。
先克隆仓库，再把完整技能目录复制到本机 skills 目录。以下命令不会覆盖已有的 slide-study：
git clone https://github.com/tzm224/skill.git
cd skill
skill_install_dir="${CODEX_HOME:-$HOME/.codex}/skills"
mkdir -p "$skill_install_dir"
if [ -e "$skill_install_dir/slide-study" ]; then
printf '%s\n' 'slide-study 已存在；请先备份或移走旧版本，再安装。'
else
cp -R skills/slide-study "$skill_install_dir/slide-study"
fi默认安装位置为 ~/.codex/skills/slide-study；设置了 CODEX_HOME 时使用其下的 skills/slide-study。按运行环境说明准备依赖后，在支持技能的 Codex 环境中调用。
把课件提供给 Codex，并指定技能，例如：
使用 $slide-study 处理这份 lecture.pdf。
请先理解全篇，再按原页序讲解每页内容、作用和前后衔接，
补齐必要的背景、例子与推导，建立可回溯来源页的知识图，
一次交付完整的本地离线学习网页和 ZIP。默认用中文讲解。
也可以说明自己的基础、想重点理解的章节、讲解语言或输出位置。长课件会在内部按章节处理，再统一术语、衔接与跨章关系。
| 用途 | 依赖 |
|---|---|
| Python 脚本 | Python 3.10+、pypdf、Pillow；版本见 requirements.txt |
| PDF 页面渲染 | Poppler 的 pdftoppm |
| 公式校验与网页打包 | Node.js；使用随包 KaTeX，无需 npm install |
| PPTX 渲染 | 已安装的 Codex Presentations 渲染器；不可用时使用 LibreOffice soffice + Poppler |
| 旧版 PPT 转换 | LibreOffice soffice |
| 成品阅读 | 现代浏览器，无需上述生成工具 |
依赖安装、工具路径配置和脚本命令见运行环境说明。
页面覆盖、图片资源、概念双向引用、来源与公式由脚本校验；教学机制、推导与关系依据仍需对照原页审查。扫描 PDF 需要视觉阅读；静态页面不能完整保留动画或视频；转换器可能替换字体或改变布局。无法辨认的内容应标明具体页码。
开发时使用过 47 页与 134 页真实课件，以及包含非平凡页序、隐藏页和备注的 PPTX 材料进行验证；另有 17 项自动化测试。浏览器交互已通过本机 HTTP 预览检查，但当时浏览器工具禁止 file://，因此未实测双击本地文件与断网打开。未来生成任务应在允许的环境中验证，并如实报告未完成的检查。
skills/slide-study/
├── SKILL.md # 技能入口与工作流程
├── agents/ # Codex 界面元数据
├── references/ # 教学标准、内容契约与环境说明
├── scripts/ # 预处理、校验、构建与测试
├── assets/ # 网页模板与本地 KaTeX 资源
└── requirements.txt
公式渲染使用随包保存的 KaTeX 0.19.1，其第三方许可见 KaTeX LICENSE，来源见 provenance.json。该许可适用于 KaTeX，不代表整个仓库的许可。