Paper Manager · 论文精读管家

本地优先的论文管理与结构化精读工具——PDF 结构化标注、跨论文 Idea 综合、可核查的引用与导出。无账号、无云端,数据全部保存在本机。

功能特性

文献库管理:PDF 导入(论文/书籍)、SHA-256 内容级去重、元数据自动识别(PDF 内部 + CrossRef/arXiv)、文件夹/标签/星标/阅读状态、软删除回收站、全库统一搜索(FTS5)
引用导入:从 BibTeX/RIS 文件批量创建条目(如从 Zotero 迁移),之后导入对应 PDF 时按 DOI/arXiv/标题自动归属到已有条目
结构化精读:左侧 PDF + 右侧阅读笔记分屏;六类语义标注(要点/背景/方法/结果/局限/疑问)、高亮/下划线、Question 点锚气泡、图片笔记、章节自动识别(可手工覆盖)、笔记与 PDF 双向精确跳转
AI 辅助阅读:划词翻译/讲解/长难句分析、读前 AI 要点摘要、在线词典查词——任意 OpenAI 兼容接口(默认适配智谱 GLM Coding Plan),API Key 由系统安全存储加密
生词本:单词/句子分开管理、MDX 本地词典、TypeWords JSON 导出
跨论文 Idea 综合:把不同论文的笔记作为实时引用(带角色与桥接说明)组织进 Idea,Topic 分类,来源删除后仍有保护快照;My Synthesis 支持 Markdown 与 LaTeX 公式
引用与导出:GB/T 7714—2015 / APA 7 / IEEE / Chicago / MLA 9 / Vancouver 六种格式,文内引用/参考文献/BibTeX/RIS;笔记与 Idea 可导出 PDF/Markdown(保留公式,区分作者原文与用户写作)
数据安全:SQLite(STRICT)+ 每日自动快照 + 完整 .pmbak 备份 + 重启式安全恢复 + 健康检查
界面中英文切换(即时生效)

技术栈

Electron 43 · React 19 · pdfjs-dist 6 · SQLite(node:sqlite,STRICT + FTS5 trigram) · @citation-js · KaTeX · Milkdown · Vite(rolldown) · electron-builder(NSIS)

快速开始

环境要求:Windows x64 + Node.js ≥ 22(建议 24,需内置 node:sqlite)。

npm install        # 安装依赖
npm run seed       # 首次运行:生成合成测试数据(虚构样本条目,不含任何真实数据)
npm start          # 启动应用(自动使用隔离的 test-data 目录,不影响正式资料库)

AI 翻译/摘要功能:启动后在阅读器里选中文本点 Translate,在设置弹窗中填入任意 OpenAI 兼容接口的 Base URL、模型名与 API Key(默认预设为智谱 GLM Coding Plan)。

开发

npm run build:renderer   # 由 src/renderer-src 构建渲染器产物(vite → src/renderer)
npm run smoke            # 自动冒烟:主进程 ready + 渲染器加载 + schema 版本检查
npm run dist             # 打 Windows 安装包(electron-builder NSIS,输出 release/)
npm run smoke:pkg        # 打包产物冒烟
node scripts/seed-test-data.mjs [目录]   # 重新生成一份合成测试数据

目录结构

src/main/          主进程(CJS):sqliteStore 数据层、翻译/词典/导出服务、IPC 注册
src/preload/       预加载桥(78 个 IPC 方法的渲染端入口)
src/renderer-src/  渲染器可读源码(组件、i18n 词典、citation-js 封装)
src/renderer/      渲染器构建产物(build:renderer 生成,打包与直接运行依赖它)
src/shared/        主进程与渲染器共享的引用工具
scripts/           构建/冒烟/种子数据脚本
docs/              设计文档、数据库 schema、IPC 契约、用户指南、竞品分析
build-resources/   打包图标与随包文档

数据安全约定(协作者必读)

开发与测试一律使用 test-data/ 隔离目录(已被 .gitignore 排除),npm start 默认指向它;严禁把开发实例指向真实资料库
正式资料库位于 %APPDATA%\paper-manager\paper-manager-data,由打包版使用;卸载不会删除
不要提交任何真实论文、笔记或个人数据;需要测试数据时运行 npm run seed 生成合成样本
涉及数据库结构变更时,在 src/main/db/migrations.js 追加版本化迁移(参考 v6),并保持 docs/schema.sql 同步

IPC 与数据库契约

IPC 通道清单见 docs/API_CONTRACT.md;新增方法需同步更新 src/preload/index.js 与该文档
数据库结构见 docs/schema.sql

文档

协作约定

功能开发请在独立分支上进行,通过合并请求(Pull Request)合入 master;提交信息用中文简要描述变更
界面文案走 i18n 词典(src/renderer-src/renderer/src/i18n/zh-CN.js,key 为英文原文),不要在组件里硬编码新文案
改动渲染器源码后必须运行 npm run build:renderer 再验证,提交前跑通 npm run smoke

关于本仓库

本项目由个人长期使用的 v2.3.4 安装包逆向恢复重建而来(恢复方法与过程见 docs/RECOVERY_NOTES.md 与 scripts/ 下的切分/差分工具),当前为持续开发中的活跃版本。

License

MIT