把课件讲清楚,把重点整理成能打印的参考资料。
English · 看成品 · 快速开始 · 复制请求 · 常见问题 · Skill 入口
fuxi-pdf 是一个 Codex skill,把你提供的课件、教材和考试说明,做成逐页教学 PDF、紧凑 cheatsheet 或详细复习资料。它把原页、讲解、公式条件和来源对应起来,并保留可编辑稿,方便继续修改。
适合从零补课、整理一学期材料、把英文课程讲明白,以及按实际纸张限制准备参考资料。页数和语言由你选:英文为主、中文解释较多、完整中英双语,都可以。
| 你现在需要什么 | 成品 | 排版与内容 |
|---|---|---|
| 每张课件到底在讲什么 | 逐页精讲 | 原课件在上,分节解释在下;讲机制、图示、例子与易错点 |
| 把公式和方法压进指定页数 | 紧凑 Cheatsheet | 多栏、窄边距、三色区分;公式、条件、解题步骤与短例密排 |
| 系统复习并快速查阅 | 详细考场资料 | 按概念组织,保留推理、比较、例子与答题表述;长册可附目录和索引 |
只要其中一种,就只做那一种;需要学习册和参考册,可以一起准备。三种成品均可按语言偏好调整,示例里的中英文比例不代表所有人的默认设置。
21 份公开讲义摘要 → 20 个检索主题 → 1 个 Letter 横向打印面。
取材自 MIT OpenCourseWare 18.06SC Linear Algebra(Fall 2011,Gilbert Strang),涵盖线性方程组、消元、子空间、投影、最小二乘、QR 与行列式。这个示例选择了英文为主,仅 4 处难点补中文,四栏三色、3.5 mm 边距,无底部页脚。
打开单页 PDF · 可编辑源稿与复现 · 来源清单 · 核验记录
这是接近半学期的主题选段,不是官方期中考试范围;完整证明和多数原例已省略,具体取舍有台账。来源共 85 个 PDF 页面,其中 21 页为署名/许可页。
下面是另一份示例:MIT OCW 6.033 Computer System Engineering(Spring 2018,Katrina LaCurts)第 14 讲。全讲 15 页,生成 15 页中文逐页精讲和 10 页中英双语详细考场册。
展开预览:原页在上、讲解在下,以及详细双语参考册
| 逐页精讲 · 原页 12:RAID 4 | 不限页双语详细册 · 第 3 页:可用性 |
|---|---|
![]() |
![]() |
| 打开 15 页学习册 | 打开 10 页详细参考册 |
详细册含 7 个考点、14 道自编英文短答、印刷目录、英文索引和原页定位。这是独立的详细版,和上面的单页公式纸展示不同密度与语言选择。
课件公开适配版保留全讲顺序:原第 9 页中不在开放许可内的厂商图片替换为明确标注的文字适配,其余 14 页保留原图。出处、改编与许可见 演示说明 和 课程素材许可。
需要支持本地 skills 的 Codex 环境,以及 Git。仓库根目录就是 skill,目录名保留为 fuxi-pdf。
macOS / Linux
mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
git clone https://github.com/stevensun1005/fuxi-pdf.git \
"${CODEX_HOME:-$HOME/.codex}/skills/fuxi-pdf"Windows PowerShell
$skillRoot = if ($env:CODEX_HOME) { Join-Path $env:CODEX_HOME 'skills' } else { Join-Path $env:USERPROFILE '.codex\skills' }
New-Item -ItemType Directory -Force -Path $skillRoot | Out-Null
git clone https://github.com/stevensun1005/fuxi-pdf.git (Join-Path $skillRoot 'fuxi-pdf')已有同名目录时,先备份自己的修改,再更新;不要直接覆盖。界面显示名是 复习pdf,调用名是 $fuxi-pdf。新安装尚未在当前会话出现时,可新开会话再使用。
附上 PDF/PPTX 课件、教材或已提取的文本。有 syllabus、Revision、考试范围、纸张规则、Quiz 或往年题时一并提供,便于确定顺序与重点。
生成 PDF 还需要宿主具备读取、编译和渲染能力,以及合适字体。Skill 会检查环境;LaTeX 优先,也可使用 Typst,或遵从明确的 Markdown 输出要求。安装 skill 不等于安装完整的 PDF 工具链。
使用 $fuxi-pdf,帮我把这些课件做成复习 PDF 和 cheatsheet。
不必记模式名。未明确的页数与语言会先问;已有答案会沿用。你也可以一次把要求说完整,直接开始制作。
| 选择 | 可选项 | 会怎样处理 |
|---|---|---|
| Cheatsheet 页数 | 一页 / 两页 / 不限页,或其他明确预算 | 一页按一个打印面计算;一张纸双面是两页;限页内保留关键条件并说明取舍 |
| 语言偏好 | 英文为主 / 中文解释较多 / 完整中英双语 | 不从聊天语言、课件语言或考试语言推断整份资料的语言比例 |
两项都没说,就一次问齐;只缺一项,就只问缺的;已经明确的,不重复问。学习册和 cheatsheet 可以分别选语言,一页不等于必须英文,不限页也不等于必须双语。
一页公式纸通常采用横向 A4/Letter、多栏、窄边距和黑蓝红三色:正文与条件、核心公式、关键陷阱分层显示。已有样式参考或考试规定时,按你的要求调整。
使用 $fuxi-pdf,把这些线性代数材料整理成一页 Letter 横向 cheatsheet。
英文标题、公式条件、方法和答题句为主,只有繁琐或易混处补中文。
用多栏、窄边距、黑蓝红三色,不要页脚,保留必要公式条件和来源定位。
使用 $fuxi-pdf,做两页 A4 cheatsheet,中文解释较多。
保留标准英文术语、公式和考试需要的英文答题短句。
优先放机制、选择方法的条件和易错点,不要逐句双语重复。
使用 $fuxi-pdf,准备学习册和考场参考册,我需要从零理解。
学习册:原课件在上,中文精讲在下,每页都解释,加入具体例子。
参考册:不限页数,完整中英双语,先中文机制,再英文答题表述。
保留可编辑源文件、来源页码和覆盖台账。
使用 $fuxi-pdf,逐页解释这份课件,只要学习册。
用中文讲清每个图、公式、代码和例子,保留英文术语,不需要英文复述。
逐页有去向。 每张源页登记为覆盖、重复、行政、空白或未决;限页版会记录压缩与省略,不用“覆盖了”暗示所有细节都在一张纸里。
公式带条件。 保留符号、单位、适用前提和边界;图表与推导回到原页核对,自编例子和练习明确标注。
PDF 真正查看。 编译后重新打开、渲染并看成品,检查中文缺字、分式、上下标、表格、重叠、截断和打印尺寸。文件存在、自动测试通过,都不替代视觉与内容复核。
重点有依据。 区分教师明确说明、题目中观察到的重点和整理者推断;自编短答不冒充官方答案或考试预测。
当前仓库的实际检查范围见 验证记录。演示来自公开真实课程,不使用用户的私人课程文件。
| 模式 | 用途 |
|---|---|
study-pack |
学习册 + 考场参考册,同源核验,语言分别选择 |
slide-walkthrough |
原页在上,逐页讲解在下,保留原页顺序 |
exam-reference |
按概念组织的打印参考资料,篇幅与语言按选择确定 |
summary |
简短总结、重点速查或明确限页的 cheatsheet |
full |
完整复习、速查、易错三册,以及课程图与覆盖报告 |
notes |
概念引入、公式、方法、例题、练习与复盘的七步笔记 |
practice |
练习题与独立答案册;足够依据下可按请求准备模拟卷 |
按请求选择合适模式,不强制扩展任务。只要一份 cheatsheet,就不会因为有 full 模式而额外生成一整套资料。
按你选择的成品交付 PDF,并保留可编辑源稿和来源记录。例如请求学习册与参考册时:
outputs/复习pdf-课程名/
├── slide-walkthrough.pdf # 逐页精讲
├── exam-reference.pdf # 可打印参考资料
├── … .tex / .typ # 对应可编辑源稿
├── coverage.csv # 源页到主题/成品位置的映射
└── coverage-report.md # 压缩、排除、核验与限制
实际名称与格式可按要求调整。屏幕逐页册可能使用加长页面;打印册使用标准纸张,二者会明确区分。详细字段与模式结构见 Skill 说明 和 输出结构。
它是独立软件、网页服务,还是 Skill?
它是供 Codex 读取的指令、模板与素材包。内容理解和写作由宿主代理完成;仓库里的脚本负责特定验证与演示构建,不是一个安装后即可离线自动总结所有课程的 CLI。
一页装不下所有内容怎么办?
按全范围主题分配空间,保留有依据的重点、公式条件和高价值方法,说明省略内容。不会悄悄加背面、增加页数,或用截断公式和无限缩字换取“塞下了”。完整讲解可以另做学习册。
可以全英文、中文偏多,或两本资料用不同语言吗?
可以。未明确时先问;已有要求直接遵从。示例中的英文公式纸、中文精讲和双语长册,是具体选择,不是固定语言限制。
扫描件、公式密集的材料能处理吗?
取决于宿主可用的 OCR、读取与渲染工具。文字提取可用于检索,公式、图形和空间关系仍需看原页;无法可靠识别的内容会保留未决说明,不凭空补全。没有原件时也不会声称已完成原页视觉核验。
这些演示能作为官方答案或直接带进考试吗?
演示是独立编写的学习资料,不是官方答案。是否可携带、允许几页及单双面,以你提供的考试规定为准;“我想做不限页资料”本身不等于考试允许不限页。
Python 依赖用于仓库开发、演示检查与验证,不代表完整的 PDF 编译环境。
python -m pip install -r requirements-dev.txt
python tools/check_package.py
python -m unittest discover -s tests -v
python scripts/validate_coverage.py examples/coverage.csv --inventory examples/inventory.json
python scripts/validate_coverage.py examples/compact-math/coverage.csv --inventory examples/compact-math/inventory.jsonGitHub Actions 在 Python 3.11、3.13 上检查元数据、本地链接、覆盖脚本与演示 PDF。传入真实页数 inventory 后,覆盖验证器能发现整页漏记、未知来源与越界页码;不传 inventory 时只检查现有 CSV,不声称完整覆盖。
欢迎通过 Issues 提交排版问题、复现失败、公式勘误或使用体验,也欢迎 Pull Request。报告问题时,说明操作系统、输出类型、页数/语言选择、复现步骤,以及可公开的最小样例。
修改 Skill 或文档时保持中英文说明一致;修改演示时同步源稿、PDF、预览和来源/许可说明,并检查最终渲染。具体结构见 SKILL.md、references/ 与 tests/。
如果它帮你把一门课整理清楚了,欢迎点一个 Star,让更多有同样需求的人找到它。
| 内容 | 许可 |
|---|---|
| Skill 指令与构建/验证代码 | MIT License |
| MIT 6.033 课件公开适配版、讲解、派生 PDF 与预览 | CC BY-NC-SA 4.0 · 作者与改编说明 |
| MIT 18.06SC 数学 cheatsheet、源稿与预览 | CC BY-NC-SA 4.0 · 作者与改编说明 |
第三方课程素材不会因仓库代码采用 MIT 而被重新许可。项目与 MIT 或课程教师无隶属或背书关系;字体文件不随仓库分发。完整素材声明见 许可说明。


