Collect. Cite. Create.
CiteBox 是一个面向论文整理与图片阅读的本地优先工作台，基于 Go、SQLite 和原生 HTML/CSS/JavaScript 构建，同时提供 Web 服务端和桌面客户端两种运行方式。
它的核心目标不是“做一个通用文献管理器”，而是围绕 PDF、正文、图片、笔记和 AI 阅读建立一条紧凑工作流：
- 导入论文 PDF，或通过 DOI 导入可获取的 Open Access PDF。
- 自动或手工提取正文与图片。
- 围绕文献、图片、标签、分组和笔记持续整理。
- 在 AI 助手页继续问答、翻译、总结和沉淀结果。
- 文献导入：支持本地 PDF 上传，也支持基于 DOI 导入 Open Access PDF。
- 多种提取模式：支持外部自动提取、内置多模态坐标识别和纯手工标注三种流程。
- 文献工作台：文献库、图片库、分组、标签、笔记、配色和手工补图页面均已内置。
- AI 阅读：支持围绕正文和图片做问答、图片解读、Tag 建议、流式输出和导出。
- 集成能力：支持 Wolai 笔记写回、微信 IM 桥接、TTS 配置和版本检查。
- 双端运行：既可作为本地 Web 服务运行，也可作为嵌入式桌面应用运行。
/research 提供基于 Semantic Scholar Graph API 的单跳文献拓展能力：搜索关键词、查看 references / citations / recommendations、把感兴趣的论文加入"调研篮"，再一键导入文献库。
Semantic Scholar API key 可在 设置 → 外部 API 里填写，或通过 S2_API_KEY 环境变量提供。未填写时使用匿名速率（约 1 req/s）。
- Go 1.21+
- SQLite
- 原生 HTML / CSS / JavaScript
webview_go桌面壳
make run默认地址：
http://localhost:8080- 默认账号：
citebox - 默认密码：
citebox123
如果只想在本地快速调试并关闭登录鉴权：
make devmake run-desktop桌面模式会在本机随机端口启动内置服务，并通过原生窗口加载界面；默认数据目录会切到系统用户配置目录，例如：
- Linux：
~/.config/CiteBox/ - macOS：
~/Library/Application Support/CiteBox/ - Windows：
%AppData%/CiteBox/
make build
make build-desktop
make test
make prepare-web-assets大部分功能都可以在应用内的“设置”页完成配置；如果需要通过环境变量启动，最常用的是这些：
| 变量 | 默认值 | 说明 |
|---|---|---|
SERVER_PORT |
8080 |
Web 服务端口 |
DATABASE_PATH |
./data/library.db |
SQLite 数据库路径 |
STORAGE_DIR |
./data/library |
PDF 与提取图片的存储目录 |
ADMIN_USERNAME |
citebox |
登录用户名 |
ADMIN_PASSWORD |
citebox123 |
初始登录密码 |
DISABLE_AUTH |
false |
设为真后关闭登录鉴权，适合本地开发 |
OA_CONTACT_EMAIL |
空 | DOI 导入时用于增强 Open Access 检索覆盖 |
PDF_EXTRACTOR_PROFILE |
自动提取 | 提取模式，可在设置页切换自动提取、内置多模态识别或手工模式 |
PDF_EXTRACTOR_URL |
空 | 外部提取服务地址 |
PDF_EXTRACTOR_TOKEN |
空 | 外部提取服务的 Bearer Token |
WEIXIN_BRIDGE_ENABLED |
false |
微信 IM 桥接默认开关，首次保存设置后以数据库配置为准 |
- 外部自动提取：对接外部提取服务，适合标准自动提图流程。
- 内置多模态识别：使用已配置的多模态模型识别图片坐标，正文优先由
pdf.js提取。 - 手工模式：不自动提图，但仍支持保存 PDF 全文，之后可进入手工标注页补录图片。
README 只保留高层概览。接口、表结构和迁移细节请以 docs/ 下文档以及当前代码实现为准。
.
├── cmd/
│ ├── server/
│ └── desktop/
├── internal/
│ ├── app/
│ ├── config/
│ ├── handler/
│ ├── repository/
│ ├── service/
│ └── ...
├── web/
│ ├── *.html
│ └── static/
├── docs/
├── scripts/
└── Makefile