AIhistory1012

把论文与专著的 PDF，
变成能逐页对回原书的 Markdown

MinerU 重建正文、脚注、多级标题与物理页锚点；AI 对照原页只改该改的地方；然后在 Obsidian 插件或网页工作台里，左边原件、右边正文，读到哪页跟到哪页。

打开演示 看仓库

给现代出版物：期刊论文、研究专著、教材、横排点校整理本。古籍刻本、抄本、竖排本不在范围内。

网页工作台：左边是 PDF 原件，右边是 Markdown 正文，按页跟随
网页工作台：左 PDF、右正文，按物理页锚点跟随。正文里选一句，PDF 上高亮同一处。

先试一下

演示站里是梁启超《新史學》（1902，文字据维基文库，CC BY-SA 4.0）的排印本，23 页，按真实流程导入后校读过。能翻页、左右对照、选中正文逐字高亮、全文搜索，设置也能改。

演示站只读：它读的是站点自带的这本样例书，没有你本机的文件夹，所以改不了、也存不了盘。要编辑，在本机跑网页工作台（命令见安装）。

进入演示 →

一个仓库，三样东西

东西干什么给谁用
三个 Claude skill
插件 aihistory1012		 lunzhu2md 导入、lunzhu2md-fix 按原页修订、lunzhu2md-audit 抽检通读 所有人；在 Claude Code（或 Codex）对话里用
Obsidian 插件
PDF Sync Markdown		 左 PDF、右正文对照，按页跟随，选字逐字高亮，按页校改 用 Obsidian 的人
网页工作台
web/		 同样的对照阅读与校改，在本机浏览器里打开一本书的文件夹 不用 Obsidian 的人

三样只靠一套约定连着：正文里的物理页锚点 <!--pdf-page.N-->、印刷页锚点 <!--p.M-->、frontmatter 里的 pdf，以及 _数据/book.json。阅读工具不识字、不改内容；改内容的是对话里的 AI。

怎么用

  1. 导入：在对话里说「把这份 PDF 导入成 Markdown」。MinerU 云端解析一次，重建正文、脚注、多级标题与页码锚点；可选 PaddleOCR 第二家识别交叉核对，拿不准的字列进疑字清单。
  2. 对照校读、手改小错：在插件或网页工作台里打开这本书，读到哪页跟到哪页。错一两个字，直接在正文里改。
  3. 大错交 AI 按原页修：整段丢了、脚注错位、表格坏了，点工具条「复制本页修订请求」，粘给 Claude Code。AI 对照 PDF 原页只改这一页，锚点不动。
  4. 可选：抽检通读：全书导入后让 AI 抽检或逐页通读，出一份问题报告（漏段、错字、锚点、脚注），再按报告逐页修。
按页跟随：正文滚到第 7 页，PDF 也翻到第 7 页
按页跟随：读到哪页，原件翻到哪页。
逐字高亮：正文里选一句，PDF 上高亮同一处
逐字高亮：正文里选一句，PDF 上高亮同一处。

安装

任何 agent：读 INSTALL.md 自己装

git clone https://github.com/1012-web/AIhistory1012
cd AIhistory1012
python install.py --list   # 探测平台，只读不写
python install.py          # 装（多个平台时用 --platform / --target 指定）

把仓库链接丢给 Claude Code、Codex 或别的 agent，说一句「读 INSTALL.md，按里面装」也行。MinerU 账号是唯一需要人做的事。

Obsidian 插件

正在提交 Obsidian 社区插件市场；上架前从 Releases 下载 main.js、manifest.json、styles.css，放进库里的 .obsidian/plugins/aihistory-pdf-sync/，在「设置 → 第三方插件」里启用。

网页工作台（本机）

cd web
npm install
npm run workbench -- "D:\书\某本书"

需要 Node.js 24 或更新。只监听 127.0.0.1，网址带令牌，不联网；编辑自动存回硬盘，硬盘上改了网页立刻刷新。

用之前要知道