feat: add PaperReader v0.2 plugin — 超文本递归阅读器

[Andyduck-ops]

PaperReader v0.2 — 超文本递归阅读插件

功能概述

将超长 PDF/文档转为可递归阅读的分块工件，适用于学术论文、技术报告、书籍章节、法律文书等各类长文档。

架构

• L0 解析层：MinerU 云端 API 高保真解析（公式/表格/图片/多栏/扫描OCR），不可用时自动降级到 pdf-parse
• L1 切分层：章节感知切分 + Meta-Header 注入 + 10-20% overlap + tiktoken 精确计数
• L2 递归逻辑层：Skeleton 骨架提取 / Rolling Context 深度阅读 / 合并综合
• L3 存储层：Obsidian 友好的 Markdown 目录结构

命令

命令	功能
IngestPDF	PDF → Markdown → 章节感知 chunks
ReadSkeleton	从目录/摘要/关键章节生成 Global Map
ReadDeep	带 Rolling Context 的递归摘要 → Round-1 笔记
Query	检索式问答（关键词匹配 + 章节权重）

文件清单

Plugin/PaperReader/
├── PaperReader.js          # 主入口（stdin JSON → 路由 → stdout JSON）
├── plugin-manifest.json    # VCP 插件清单
├── config.env.example      # 配置示例
├── README.md               # 使用说明
└── lib/
    ├── mineru-client.js     # MinerU 云端 API 适配器
    ├── pdf-parse-fallback.js # pdf-parse 降级封装
    ├── ingest.js            # 统一解析入口（优先 MinerU，自动降级）
    ├── chunker.js           # 章节感知切分器
    ├── llm.js               # LLM 调用封装
    ├── skeleton.js          # 骨架提取（Global Map 生成）
    ├── deep-reader.js       # Rolling Context 深度阅读
    └── query.js             # 检索式问答

依赖

• adm-zip（新增，用于解压 MinerU 返回的 zip）
• axios、pdf-parse、@dqbd/tiktoken、dotenv（已有）

配置

复制 config.env.example 为 config.env，填入 MINERU_API_TOKEN（可选，不填自动降级）和 PaperReaderModel。

[Andyduck-ops]

Hotfix: LLM URL 解析 + 真并发 + 三层缓存

本次 push 修复了以下问题：

🔧 Bug Fix: LLM 429 错误（根因）

• lib/llm.js 的 API_URL=http://127.0.0.1:3000 指向 VCP 管理面板，不是 API 端点
• 新增 resolveApiUrl() 自动修正为 http://127.0.0.1:{PORT}/v1/chat/completions
• API Key 优先级链：PaperReaderApiKey > Key > API_Key

⚡ 性能: 真并发

• batchSize=10 现在是真正的 10 路并发（Promise.all），不再是串行
• batch 间按序合并 rolling context 保持连贯性

💾 缓存机制

• IngestPDF 缓存：已解析的 PDF 不重复调用 MinerU
• ReadDeep 全量缓存：已完成的深度阅读零 LLM 调用直接返回
• ReadDeep 增量缓存：中断恢复时跳过已完成 chunk
• 支持 forceReparse / forceReread 参数强制刷新

📊 可观测性

• 请求入口 / 路由命中 / chunk 进度 / 错误分类日志
• 错误分层：rate_limit / auth / timeout / upstream_5xx / network / unknown

✅ 测试通过

• ReadDeep 并发 ✅ | 缓存命中 ✅ | 缺参校验 ✅ | URL 自动修正 ✅