Skip to content

HughYau/Paperism

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Paperism | 棱镜

License Node PRs Welcome

为论文提供优雅的视觉体验

English | 简体中文

功能特性快速开始使用指南技术架构贡献Buy me a coffee!


📖 项目简介

Paperism(棱镜) 专为研究者和学生设计,它将晦涩难懂的学术论文转化为交互式、可视化网页的阅读工具。

如同棱镜一样,Paperism 将复杂的学术内容分解为清晰、易懂、美观的结构化展示。

为什么选择 Paperism?

  • 🎨 现代化设计美学:现代化界面,流畅的动画和精致的交互体验
  • 🤖 AI 驱动解析:支持 GPT-5.1 和 Gemini 3.0 pro,自动将 PDF 论文转换为结构化 HTML 网页
  • 📚 智能内容管理:自动索引、分类标签、全文搜索,让论文管理变得简单
  • 🔄 多格式导出:支持将网页导出为 Markdown 和 LaTeX Beamer 格式,适配不同使用场景
  • 本地优先:所有数据存储在本地,保护您的学术隐私
  • 🎯 学术导向:专注于论文的核心要素:动机、方法、实验、结论和批判性评论

🌐 在线演示

访问我们的在线演示页面,体验 Paperism: https://hughyau.com/Paperism/

注意:演示版为静态页面,仅展示预置的示例文献及转换结果,不支持上传 PDF 和 AI 解析功能。


✨ 功能特性

🎨 现代化界面

  • 响应式设计:完美适配桌面和移动设备
  • 明暗主题:支持日间和夜间模式切换
  • 流畅交互:侧边栏折叠、实时预览、拖拽上传

亮色主题

亮色主题

暗色主题

暗色主题

🚀 AI 智能论文解析

上传 PDF 论文,Paperism 将自动生成一个完整的交互式网页,深度解析:

  • 研究动机:问题背景、研究意义
  • 数学建模:公式推导、算法流程(支持 KaTeX 渲染)
  • 实验设计:模型、数据、超参数等实验细节
  • 核心结论:实验结果、对比分析、关键洞见
  • 批判性评论:优势、不足、改进方向
  • 扩展内容:AI 自由发挥的其他重要内容

📂 智能库管理

  • 自动索引:扫描 archive 目录,自动提取元数据
  • 层级分类:基于文件夹结构的自动分类
  • 标签系统:灵活的标签管理,支持手动编辑
  • 实时搜索:按标题、关键词、标签快速检索
  • 统计信息:论文数量、分类统计一目了然

🔄 格式转换

  • HTML → Markdown:基于规则(无AI),使用 Cheerio 进行快速准确的转换
  • HTML → LaTeX Beamer:AI 辅助生成学术演讲幻灯片
  • 保真转换:保留数学公式、表格、代码块等复杂结构

HTML 演示

HTML 演示

Markdown 转换效果

Markdown 演示

Beamer 转换效果

Beamer 演示

🔧 灵活配置

  • 多 AI 提供商:支持 OpenAI GPT-5.1 和 Google Gemini 3.0 pro
  • 自定义 Prompt:完全控制 AI 生成的内容风格和深度
  • 元数据编辑:标题、分类、标签手动微调
  • 批量操作:批量导入、转换、删除

🚀 快速开始

环境要求

  • Node.js >= 20.0.0
  • npmyarn

安装步骤

  1. 克隆项目
git clone https://github.com/HughYau/Paperism.git
cd Paperism
  1. 安装依赖
npm install
  1. 配置 API 密钥

创建 .env 文件并添加您的 API 密钥:

# OpenAI API Key (用于 GPT)
OPENAI_API_KEY=your_openai_api_key_here

# Google Gemini API Key (用于 Gemini 3.0 pro)
GEMINI_API_KEY=your_gemini_api_key_here
  1. 启动服务
npm start
  1. 访问应用

打开浏览器访问:http://localhost:3000


📖 使用指南

方法一:AI 解析 PDF(推荐)

  1. 点击左下角 "+" 按钮打开导入对话框
  2. 切换到 "AI 解析" 标签页
  3. 选择 AI 提供商(GPT 或 Gemini)
  4. 上传 PDF 论文文件
  5. (可选)自定义解析提示词
  6. 点击 "开始解析",等待 AI 生成结果
  7. 预览生成的 HTML 网页
  8. 编辑元数据(标题、标签)
  9. 点击 "确认保存" 添加到库

方法二:直接粘贴 HTML

  1. 点击左下角 "+" 按钮
  2. "HTML 源码" 标签页粘贴 HTML 代码
  3. 输入文件名(如 my-paper.html
  4. 点击 "导入"

管理论文

  • 查看论文:点击侧边栏论文标题即可查看
  • 搜索论文:在顶部搜索框输入关键词
  • 编辑属性:右键点击论文 → 选择 "属性"
  • 转换格式:右键点击论文 → 选择 "转为 Markdown""转为 Beamer"
  • 删除论文:在属性面板中点击 "删除"

格式转换

转换为 Markdown

  • 无需 AI,快速转换
  • 保留文本、公式、表格、代码块
  • 结果保存在 data/converted/ 目录

转换为 LaTeX Beamer

  • 使用 AI 生成学术演讲幻灯片
  • 自动提炼重点内容
  • 适合会议报告和课堂展示

🏗️ 技术架构

数据存储

  • 文件系统:论文 HTML 存储在 archive/ 目录
  • JSON 索引public/library.json 存储论文元数据
  • 手动元数据data/metadata.json 存储用户自定义标签和分类
  • 转换结果data/converted/ 存储 Markdown 和 Beamer 输出

项目结构

Paperism/
├── archive/              # 论文 HTML 文件存储
├── data/
│   ├── metadata.json     # 用户自定义元数据
│   └── converted/        # 转换结果(MD/TEX)
├── public/
│   └── library.json      # 自动生成的索引
├── src/
│   ├── converter.js      # HTML → Markdown 转换器
│   ├── indexer.js        # 文件索引器
│   ├── server.js         # Express 服务器
│   └── ui/
│       ├── app.js        # 前端应用逻辑
│       ├── style.css     # 样式表
│       └── prism-anim.css # 棱镜动画
├── uploads/tmp/          # 临时文件上传目录
├── index.html            # 应用入口
└── package.json          # 项目配置

🤝 贡献

欢迎贡献代码、报告问题或提出建议!

贡献方式

  1. Fork 本仓库
  2. 创建特性分支 (git checkout -b feature/AmazingFeature)
  3. 提交更改 (git commit -m 'Add some AmazingFeature')
  4. 推送到分支 (git push origin feature/AmazingFeature)
  5. 提交 Pull Request

📄 许可证

本项目采用 AGPL-3.0 许可证。详见 LICENSE 文件。


💝 打赏支持

如果 Paperism 对您的学习和研究有所帮助,欢迎打赏支持项目持续开发!

微信赞赏码

Buy Me a Coffee

您的支持是我最大的动力!


万卷归镜

Made by Hugh Qiu

About

Paperism专为研究者和学生设计,它将晦涩难懂的学术论文转化为交互式、可视化网页的阅读工具。 Paperism is designed specifically for researchers and students, transforming dense academic papers into interactive, visually appealing web pages.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages