# PDF ↔ 思维导图集成实施计划（基于 Grok 方案）

## 阶段 0：准备

- 明确依赖：`@pdfme/pdfjs-dist`（或 `pdfjs-dist`）、simple-mind-map、自研事件总线、Yjs/Supabase 持久化。
- 输出数据结构草案：`PDFQuote`、`app://pdf/{fileId}?page=&range=` 协议、Yjs/Supabase 存储字段。
- 收集 MinerU OCR 样例，定义图片型 PDF 的转换策略。

### 阶段 0 Checklist

- [x] 依赖/许可确认（pdf.js、simple-mind-map、矿U OCR）
- [x] `PDFQuote`/URI schema 初稿
- [x] MinerU OCR 样例与坐标规范

## 阶段 1：基础 Viewer 与选区

- 开发 `PDFViewerWithQuote` 组件：基于 pdf.js，监听 `selectionchange`，生成 `rects` 并绘制 overlay。
- 提供 `onQuoteCreate` 回调与 `activeQuote` 反向高亮，实现跨页滚动定位。

### 阶段 1 Checklist

- [x] 初始化 pdf.js viewer + text layer
- [x] 选区捕获逻辑（支持跨页、多 range）
- [x] 高亮 overlay 渲染/清理
- [x] `PDFQuote` 对象结构与类型定义
- [x] 反向滚动 + 高亮入口

## 阶段 2：思维导图节点接入

- 在 simple-mind-map 注册 `pdfQuote` 节点，封装渲染样式与点击事件。
- 建立全局事件：`pdf:quote-created`、`mindmap:jump-to-pdf`，实现双向联动。

### 阶段 2 Checklist

- [x] 自定义节点 renderer（UI/交互）
- [x] PDF→mindmap 插入流程
- [x] mindmap→PDF 因点击触发跳转
- [x] Slash/工具栏入口（浮动工具栏 “打开 PDF 引用”）

## 阶段 3：持久化与 URI 协议

- 将 `PDFQuote`/节点引用写入 Yjs + Supabase，统一 `app://pdf/{fileId}?page=&range=` 协议。
- 页面加载解析 URI，完成跳转与权限校验。

### 阶段 3 Checklist

- [x] Supabase `pdf_quotes` Schema / 迁移（含 API）
- [x] Yjs 引用同步 schema
- [x] URI 解析器 + 跳转钩子
- [x] 权限/安全校验（RLS + API 鉴权）

## 阶段 4：图片型 PDF（MinerU 支持）

- 调用 MinerU OCR，生成虚拟 TextLayer 供前端选择/高亮。
- 统一文本/图片型 PDF 的渲染与编辑接口。

### 阶段 4 Checklist

- [x] OCR 数据解析 & 坐标转换
- [x] 自定义 TextLayer（基于 OCR）
- [x] 高亮 overlay 兼容
- [x] 失败回退/提示

## 阶段 5：性能与体验

- 虚拟滚动、懒加载、移动端选区、暗色主题适配。

### 阶段 5 Checklist

- [ ] 大文档性能基线
- [ ] 移动端/触屏交互
- [ ] UI 适配（暗色、缩放）
- [ ] 错误兜底

## 阶段 6：QA 与文档

- Playwright/Storybook 覆盖“选区 → 节点 → 跳转”闭环。
- 输出使用指南、API 文档、发布说明。

### 阶段 6 Checklist

- [ ] 自动化测试脚本
- [ ] 开发/运营文档
- [ ] 发布与观察项