Skip to content
Back to search

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/junlongmo384-crypto--textbook-to-notion-review/badge.svg)](/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

i

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
  1. ---
  2. name: textbook-to-notion-review
  3. description: 把教材 PDF(包括没有文字层的扫描件)整理成按章节分册的考试复习资料,包括知识点清单、核心内容、易错点和带解析的典型题,再导入 Notion,形成分册页、章节子页面、折叠答案和知识点进度数据库,之后可以在 Notion 里自测和问答。当用户要根据教材或指定参考书备考笔试、考研、资格考试、校招专业笔试,要整理知识点、出复习资料或题库,要把复习笔记或 Markdown 资料搬进 Notion,或者想在 Notion 里刷题、问答、追踪复习进度时,都应使用本技能,即使用户只说"帮我整理这几本书的考点""做成 Notion 方便复习""按教材出题",没有提到"技能"或"Notion 数据库"。
  4. ---
  5. # 教材 → 复习资料 → Notion 复习
  6. 这套流程是在为"泛模拟物理设计笔试"做了一整套资料后提炼出来的:用了 14 本扫描版教材,以其中两本为指定教材,写成 9 个分册、427 个知识点、约 300 道题,最后在 Notion 里建成 52 个章节页和一个进度数据库。下面的每一步都对应当时真实遇到的问题。
  7. 脚本在 `scripts/`,需要 Python 3 和 PyMuPDF(`pip install pymupdf`)。Windows 上如果默认 `python` 指向商店占位程序,先找一个真的解释器(如 Anaconda)。
  8. ## 第 0 步:弄清楚目标(缺什么问什么,已知的不要再问)
  9. - 考什么:考试名称、题型、各部分占比(如"半导体物理和器件物理占大头,少量工艺、电路、2–3 道数学,偶尔有 C")。
  10. - **指定教材**:哪几本是官方指定的(版次要准确)。指定教材决定概念、符号和页码以谁为准,其余书只作辅助。
  11. - 教材在哪个文件夹,资料输出到哪里,离考试还有多久(决定计划是 6 周标准版还是 2 周冲刺版)。
  12. ## 第 1 步:盘点教材 PDF
  13. ```bash
  14. python scripts/pdf_probe.py <教材目录> # 只扫这一层;加 --recursive 才扫子目录
  15. ```
  16. 脚本会报告每本书的页数、有没有文字层、书签情况。分三种情况处理:
  17. - **有文字层**:直接抽取文本,正文可以真正依据教材来写。
  18. - **扫描件、书签完整**:书签就是目录,记下各章的 PDF 起始页。
  19. - **扫描件、书签只有页码或没有书签**:渲染目录页后看图转写。书签是纯页码时,脚本会顺便算出页码偏移,并指出目录页的范围:
  20. ```bash
  21. python scripts/pdf_probe.py 某书.pdf --render 5-14 --out <临时目录>/toc
  22. ```
  23. 书多时每本书派一个子代理并行读图转写目录。
  24. **校准页码偏移**:渲染一两页正文,找到书上印的页码,算出偏移(如刘恩科"印刷页 = PDF 页 − 13",施敏"印刷页 = PDF 页 − 8")。每本书单独校准一次并记下来。资料里一律写印刷页码,因为用户是拿着纸书或按书上页码查的。当时就发生过把 PDF 页码当成书页写进资料、事后返工修正的情况。
  25. 扫描件不做 OCR 时,资料只能按目录组织结构和页码,正文要靠学科通识来写。这一点要主动告诉用户,并给出 OCR 核对的选项,由用户决定做不做。
  26. ## 第 2 步:规划分册
  27. - 按指定教材的章节顺序切册,一册 3–7 章。非指定教材的部分(工艺、电路、数学、编程等)按模块成册,模块标题注明参考书和章节。
  28. - 固定编号:`00_总览`、`01`…`08` 内容册、最后一册公式与常数速查。
  29. - 先把规划(册名、覆盖章节、星级权重、复习计划)写进 `00_总览`,再动笔写各册。计划分标准版和冲刺版两档,指定教材的课后习题列为必做。
  30. ## 第 3 步:撰写分册
  31. 格式和内容规则见 **`references/volume_format.md`**,写之前先读一遍。最关键的三点:
  32. 1. 每章固定四节:知识点清单 → 核心内容 → 易错点 → 典型题。后面的脚本靠这个格式解析。
  33. 2. 指定教材优先。两本教材取值或记法不同的地方要在正文写明,并汇总进总览的"教材差异表"。
  34. 3. 页码用印刷页码;计算题的数值写完用 Python 复算一遍。
  35. 分册多时,每册派一个子代理并行撰写。提示里给出:格式文件路径、该册覆盖的章节和对应页码、指定教材的符号约定、输出文件路径。
  36. ## 第 4 步:自检
  37. ```bash
  38. python scripts/lint_volumes.py <资料目录> # 结构、缺答案、缺页码
  39. python scripts/build_checklist.py <资料目录> <输出.md> # 汇总知识点总清单和星级分布
  40. ```
  41. lint 报出的结构问题要清零。总清单贴进 `00_总览`。抽查几册的公式和算例,有出入的地方写进"教材差异表"或在正文标注。
  42. ## 第 5 步:转换并导入 Notion
  43. ```bash
  44. python scripts/md_to_notion.py <资料目录> <临时目录>/notion --single 09 \
  45. --vol-label "01=01 半导体物理·刘恩科1–5" --vol-label "02=…"
  46. ```
  47. 脚本会生成以下内容:
  48. - 各册页面正文 `vNN_page.md`
  49. - 各章页面 `vNN_cMM.md`(过长的章会拆成 `_a`、`_b` 分段)
  50. - 上传计划 `plan.json`
  51. - 数据库行 `db_rows_K.json`,每批 90 行
  52. - 数据库结构 `db_schema.sql`
  53. 脚本已处理好这些事:答案装进绿色折叠块、`<` 转义、标题层级上移、引用块内表格修复。`--vol-label` 用来给数据库"分册"字段起短名,不传时自动从册标题截取。
  54. 上传顺序、并行策略、Notion Markdown 的坑和上传后的核对清单,见 **`references/notion_build.md`**。核对必须做,因为中断重试最容易造成缺页或重复页。
  55. ## 第 6 步:交付和复习用法
  56. 向用户汇报以下内容:
  57. - 入口链接
  58. - 结构:几册、几章页、数据库行数
  59. - 哪些内容核对过、哪些只是抽查
  60. - 已知的小瑕疵
  61. - 入口页目前是私人页面,需要时可以移动
  62. 再告诉用户怎么用(详见 `references/notion_build.md` 末节):
  63. - 先做题,再展开折叠块对答案。
  64. - 在数据库里拖动掌握状态。
  65. - 用"★★★ 且未掌握"的筛选视图冲刺。
  66. - 随时在对话里让 Claude 读取 Notion 页面来讲解、出新题或批改。
  67. 用户之后在对话里要求"出题"或"批改"时,先用 `notion-search` 或 `notion-fetch` 读取对应章节页,题型和难度与页面里的典型题对齐。出题时先不给答案,等用户作答后再批改。
README.md · README · 52 lines
  1. # textbook-to-notion-review
  2. 一个 Claude Code / Claude.ai 技能(skill)。它把教材 PDF 整理成按章节分册的考试复习资料,再导入 Notion,在 Notion 里自测、问答和追踪进度。扫描件也能处理。
  3. 每章固定四节:知识点清单 → 核心内容 → 易错点 → 典型题。典型题的答案放在 Notion 的折叠块里,先做题再展开。
  4. ## 能做什么
  5. - **盘点教材 PDF**:页数、有没有文字层、书签情况,以及书上印的页码和 PDF 页码之间的偏移。扫描件可以渲染目录页,看图转写目录。
  6. - **规划和撰写分册**:指定教材优先,资料里写书上印的页码,标出各书写法不同的地方,计算题的答案用 Python 复算。
  7. - **自检**:检查格式(缺小节、缺答案、缺页码),汇总知识点总清单。
  8. - **转换成 Notion 内容**:
  9. - 答案放进折叠块,自动转义 `<`,表格前后补空行,提示单元格里的竖线。
  10. - 过长的章自动拆成几段上传。
  11. - 生成知识点数据库的结构和数据行。
  12. - **上传 Notion 和上传后核对**:给出上传顺序、并行策略和上传后的核对清单。
  13. ## 安装
  14. - **Claude Code**:把本目录放到 `~/.claude/skills/textbook-to-notion-review/`。
  15. - **Claude.ai**:在技能设置里上传打包好的 `.skill` 文件。
  16. 导入 Notion 需要先连接 Notion 连接器。
  17. ## 依赖
  18. - Python 3
  19. - PyMuPDF:`pip install pymupdf`
  20. ## 目录结构
  21. ```
  22. SKILL.md 工作流程(第 0–6 步)
  23. references/
  24. volume_format.md 分册格式与写作规则(脚本按这个格式解析)
  25. notion_build.md Notion 页面结构、上传步骤、Markdown 坑、核对清单、复习用法
  26. scripts/
  27. pdf_probe.py 盘点 PDF / 渲染页面 / 推算页码偏移
  28. lint_volumes.py 分册格式检查
  29. build_checklist.py 汇总知识点总清单
  30. md_to_notion.py 转换为 Notion 页面内容、上传计划和数据库行
  31. ```
  32. ## 脚本用法
  33. ```bash
  34. python scripts/pdf_probe.py <教材目录> # 盘点(加 --recursive 扫子目录)
  35. python scripts/pdf_probe.py 某书.pdf --render 5-14 --out toc # 渲染目录页
  36. python scripts/lint_volumes.py <资料目录>
  37. python scripts/build_checklist.py <资料目录> 清单.md
  38. python scripts/md_to_notion.py <资料目录> <输出目录> --single 09 --vol-label "01=01 短名"
  39. ```

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.