textbook-to-notion-review
把教材 PDF(包括没有文字层的扫描件)整理成按章节分册的考试复习资料,包括知识点清单、核心内容、易错点和带解析的典型题,再导入 Notion,形成分册页、章节子页面、折叠答案和知识点进度数据库,之后可以在 Notion 里自测和问答。当用户要根据教材或指定参考书备考笔试、考研、资格考试、校招专业笔试,要整理知识点、出复习资料或题库,要把复习笔记或 Markdown 资料搬进 Notion,或者想在 Notion 里刷题、问答、追踪复习进度时,都应使用本技能,即使用户只说"帮我整理这几本书的考点""做成 Notion 方便复习""按教材出题",没有提到"技能"或"Notion 数据库"。
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/junlongmo384-crypto--textbook-to-notion-review)HTML
<a href="/listings/junlongmo384-crypto--textbook-to-notion-review"><img src="/api/listings/junlongmo384-crypto--textbook-to-notion-review/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
- **Claude Code**:把本目录放到 `~/.claude/skills/textbook-to-notion-review/`。 - **Claude.ai**:在技能设置里上传打包好的 `.skill` 文件。
导入 Notion 需要先连接 Notion 连接器。
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 96 lines
- ---
- name: textbook-to-notion-review
- description: 把教材 PDF(包括没有文字层的扫描件)整理成按章节分册的考试复习资料,包括知识点清单、核心内容、易错点和带解析的典型题,再导入 Notion,形成分册页、章节子页面、折叠答案和知识点进度数据库,之后可以在 Notion 里自测和问答。当用户要根据教材或指定参考书备考笔试、考研、资格考试、校招专业笔试,要整理知识点、出复习资料或题库,要把复习笔记或 Markdown 资料搬进 Notion,或者想在 Notion 里刷题、问答、追踪复习进度时,都应使用本技能,即使用户只说"帮我整理这几本书的考点""做成 Notion 方便复习""按教材出题",没有提到"技能"或"Notion 数据库"。
- ---
- # 教材 → 复习资料 → Notion 复习
- 这套流程是在为"泛模拟物理设计笔试"做了一整套资料后提炼出来的:用了 14 本扫描版教材,以其中两本为指定教材,写成 9 个分册、427 个知识点、约 300 道题,最后在 Notion 里建成 52 个章节页和一个进度数据库。下面的每一步都对应当时真实遇到的问题。
- 脚本在 `scripts/`,需要 Python 3 和 PyMuPDF(`pip install pymupdf`)。Windows 上如果默认 `python` 指向商店占位程序,先找一个真的解释器(如 Anaconda)。
- ## 第 0 步:弄清楚目标(缺什么问什么,已知的不要再问)
- - 考什么:考试名称、题型、各部分占比(如"半导体物理和器件物理占大头,少量工艺、电路、2–3 道数学,偶尔有 C")。
- - **指定教材**:哪几本是官方指定的(版次要准确)。指定教材决定概念、符号和页码以谁为准,其余书只作辅助。
- - 教材在哪个文件夹,资料输出到哪里,离考试还有多久(决定计划是 6 周标准版还是 2 周冲刺版)。
- ## 第 1 步:盘点教材 PDF
- ```bash
- python scripts/pdf_probe.py <教材目录> # 只扫这一层;加 --recursive 才扫子目录
- ```
- 脚本会报告每本书的页数、有没有文字层、书签情况。分三种情况处理:
- - **有文字层**:直接抽取文本,正文可以真正依据教材来写。
- - **扫描件、书签完整**:书签就是目录,记下各章的 PDF 起始页。
- - **扫描件、书签只有页码或没有书签**:渲染目录页后看图转写。书签是纯页码时,脚本会顺便算出页码偏移,并指出目录页的范围:
- ```bash
- python scripts/pdf_probe.py 某书.pdf --render 5-14 --out <临时目录>/toc
- ```
- 书多时每本书派一个子代理并行读图转写目录。
- **校准页码偏移**:渲染一两页正文,找到书上印的页码,算出偏移(如刘恩科"印刷页 = PDF 页 − 13",施敏"印刷页 = PDF 页 − 8")。每本书单独校准一次并记下来。资料里一律写印刷页码,因为用户是拿着纸书或按书上页码查的。当时就发生过把 PDF 页码当成书页写进资料、事后返工修正的情况。
- 扫描件不做 OCR 时,资料只能按目录组织结构和页码,正文要靠学科通识来写。这一点要主动告诉用户,并给出 OCR 核对的选项,由用户决定做不做。
- ## 第 2 步:规划分册
- - 按指定教材的章节顺序切册,一册 3–7 章。非指定教材的部分(工艺、电路、数学、编程等)按模块成册,模块标题注明参考书和章节。
- - 固定编号:`00_总览`、`01`…`08` 内容册、最后一册公式与常数速查。
- - 先把规划(册名、覆盖章节、星级权重、复习计划)写进 `00_总览`,再动笔写各册。计划分标准版和冲刺版两档,指定教材的课后习题列为必做。
- ## 第 3 步:撰写分册
- 格式和内容规则见 **`references/volume_format.md`**,写之前先读一遍。最关键的三点:
- 1. 每章固定四节:知识点清单 → 核心内容 → 易错点 → 典型题。后面的脚本靠这个格式解析。
- 2. 指定教材优先。两本教材取值或记法不同的地方要在正文写明,并汇总进总览的"教材差异表"。
- 3. 页码用印刷页码;计算题的数值写完用 Python 复算一遍。
- 分册多时,每册派一个子代理并行撰写。提示里给出:格式文件路径、该册覆盖的章节和对应页码、指定教材的符号约定、输出文件路径。
- ## 第 4 步:自检
- ```bash
- python scripts/lint_volumes.py <资料目录> # 结构、缺答案、缺页码
- python scripts/build_checklist.py <资料目录> <输出.md> # 汇总知识点总清单和星级分布
- ```
- lint 报出的结构问题要清零。总清单贴进 `00_总览`。抽查几册的公式和算例,有出入的地方写进"教材差异表"或在正文标注。
- ## 第 5 步:转换并导入 Notion
- ```bash
- python scripts/md_to_notion.py <资料目录> <临时目录>/notion --single 09 \
- --vol-label "01=01 半导体物理·刘恩科1–5" --vol-label "02=…"
- ```
- 脚本会生成以下内容:
- - 各册页面正文 `vNN_page.md`
- - 各章页面 `vNN_cMM.md`(过长的章会拆成 `_a`、`_b` 分段)
- - 上传计划 `plan.json`
- - 数据库行 `db_rows_K.json`,每批 90 行
- - 数据库结构 `db_schema.sql`
- 脚本已处理好这些事:答案装进绿色折叠块、`<` 转义、标题层级上移、引用块内表格修复。`--vol-label` 用来给数据库"分册"字段起短名,不传时自动从册标题截取。
- 上传顺序、并行策略、Notion Markdown 的坑和上传后的核对清单,见 **`references/notion_build.md`**。核对必须做,因为中断重试最容易造成缺页或重复页。
- ## 第 6 步:交付和复习用法
- 向用户汇报以下内容:
- - 入口链接
- - 结构:几册、几章页、数据库行数
- - 哪些内容核对过、哪些只是抽查
- - 已知的小瑕疵
- - 入口页目前是私人页面,需要时可以移动
- 再告诉用户怎么用(详见 `references/notion_build.md` 末节):
- - 先做题,再展开折叠块对答案。
- - 在数据库里拖动掌握状态。
- - 用"★★★ 且未掌握"的筛选视图冲刺。
- - 随时在对话里让 Claude 读取 Notion 页面来讲解、出新题或批改。
- 用户之后在对话里要求"出题"或"批改"时,先用 `notion-search` 或 `notion-fetch` 读取对应章节页,题型和难度与页面里的典型题对齐。出题时先不给答案,等用户作答后再批改。
README.md · README · 52 lines
- # textbook-to-notion-review
- 一个 Claude Code / Claude.ai 技能(skill)。它把教材 PDF 整理成按章节分册的考试复习资料,再导入 Notion,在 Notion 里自测、问答和追踪进度。扫描件也能处理。
- 每章固定四节:知识点清单 → 核心内容 → 易错点 → 典型题。典型题的答案放在 Notion 的折叠块里,先做题再展开。
- ## 能做什么
- - **盘点教材 PDF**:页数、有没有文字层、书签情况,以及书上印的页码和 PDF 页码之间的偏移。扫描件可以渲染目录页,看图转写目录。
- - **规划和撰写分册**:指定教材优先,资料里写书上印的页码,标出各书写法不同的地方,计算题的答案用 Python 复算。
- - **自检**:检查格式(缺小节、缺答案、缺页码),汇总知识点总清单。
- - **转换成 Notion 内容**:
- - 答案放进折叠块,自动转义 `<`,表格前后补空行,提示单元格里的竖线。
- - 过长的章自动拆成几段上传。
- - 生成知识点数据库的结构和数据行。
- - **上传 Notion 和上传后核对**:给出上传顺序、并行策略和上传后的核对清单。
- ## 安装
- - **Claude Code**:把本目录放到 `~/.claude/skills/textbook-to-notion-review/`。
- - **Claude.ai**:在技能设置里上传打包好的 `.skill` 文件。
- 导入 Notion 需要先连接 Notion 连接器。
- ## 依赖
- - Python 3
- - PyMuPDF:`pip install pymupdf`
- ## 目录结构
- ```
- SKILL.md 工作流程(第 0–6 步)
- references/
- volume_format.md 分册格式与写作规则(脚本按这个格式解析)
- notion_build.md Notion 页面结构、上传步骤、Markdown 坑、核对清单、复习用法
- scripts/
- pdf_probe.py 盘点 PDF / 渲染页面 / 推算页码偏移
- lint_volumes.py 分册格式检查
- build_checklist.py 汇总知识点总清单
- md_to_notion.py 转换为 Notion 页面内容、上传计划和数据库行
- ```
- ## 脚本用法
- ```bash
- python scripts/pdf_probe.py <教材目录> # 盘点(加 --recursive 扫子目录)
- python scripts/pdf_probe.py 某书.pdf --render 5-14 --out toc # 渲染目录页
- python scripts/lint_volumes.py <资料目录>
- python scripts/build_checklist.py <资料目录> 清单.md
- python scripts/md_to_notion.py <资料目录> <输出目录> --single 09 --vol-label "01=01 短名"
- ```
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.