致谢

灵感来源

QuantumAtlas 最初的三层知识库设计受 Karpathy's LLM Wiki 启发——把 LLM 知识库切成可读 + 可结构化的层。

fine-grained 权限 / scope 模型抄了 GitHub fine-grained PAT：

  • 强制过期

  • 显式 scope opt-in

  • "PAT 不能管理 PAT" 设计

上游数据源（学术 metadata）

QuantumAtlas 的论文 catalog / 引用图 / DOI 解析依赖以下开放学术数据源—— license 与归属义务详见 License & Attribution。

  • OpenAlex（OurResearch 非营利）— 论文 metadata 主源，含反向引用 cited_by 列表 / topics / 机构 ROR / 摘要倒排索引；license CC0 1.0。我们镜像 bulk dump 到 qatlas-openalex 桶做离线 join + 增量同步。

  • Crossref — DOI 注册中心，metadata 自 2017 起 CC0 1.0。负责正向 reference 列表（含 unstructured 引文文本，比 OpenAlex 更全）。

  • arXiv — preprint 源头。我们通过 OAI-PMH 镜像 metadata (arXiv ToU)；PDF 字节不通过 API 外发—— 用户自行到 arxiv.org 拉 PDF。

OpenAlex / Crossref 是 CC0 ⇒ 无强制归属，但作为非营利基础设施仍需要可见归属帮它 们持续争取资助。本项目除本节外，在 SPA 全局页脚、/api/* 响应 X-Attribution header、以及 README.md 均显式声明。

关键依赖（开源生态）

Server

  • Go — 主语言，工具链要求以根 go.mod 为准（当前 1.26.2）

  • PocketBase v0.38 — 内嵌 BaaS (SQLite + Auth + Realtime + Admin UI)

  • PostgreSQL + pgx — paper catalog / claim / DOI 状态

  • jackc/pgx v5 — PostgreSQL driver（paper registry + OpenAlex corpus）

  • minio-go v7 — S3 兼容存储 client

  • casbin/v2 — PAT scope enforcer

  • yaml.v3 — 严格 YAML 配置解析

  • kardianos/service — 跨平台 systemd / launchd / SCM 安装

  • modernc.org/sqlite — 纯 Go SQLite（CGO-free）

独立客户端

Python 客户端由 qatlas-cli 维护，其依赖、版本要求和许可证以该仓库为准，不是主仓的运行依赖。旧 quantum-atlas 包已退役；保留的迁移说明不是 Python 包发行入口。

Frontend

Tooling

备注

以下 MkDocs / Material 条目保留为这份正文迁移前使用的工具记录；当前所有正文统一由 Sphinx/MyST 构建，不再依赖 Material。

  • Go modules / npm — Go 与前端依赖

  • GoReleaser — 默认格式的 Go 预编译发布

  • Sphinx / Furo — 使用与开发文档

  • uv — 可选的隔离文档工具运行器（不是主仓包环境）

  • Go testing — 主仓单元、部署结构及生产冒烟测试

  • mkdocs + mkdocs-material — 这份文档

基础设施

学术参考

QuantumAtlas 的 Wiki 模板和 schema 受这几篇影响：

  • Karpathy 的 LLM Knowledge Base gist（前面已引用）

  • Material for MkDocs 的 Reference architecture

  • arXiv 的 bulk data layout（我们抄了它的 YYMM 前缀目录约定）

维护者

主要协作者（按提交量、按字母序）：

完整 contributor 列表见 GitHub graphs。

加入 contributors

提 PR + 合并即可——GitHub 自动算。也欢迎在 issue 里指出"这里不对/这里没说清楚"。

许可证

  • 代码：Apache-2.0 License

  • 文档：Apache-2.0（同 repo）

  • Wiki 内容：QuantumAtlas-Wiki repo 自己的 LICENSE（同样 Apache-2.0）

  • 第三方依赖：各自原 license（见 go.mod / go.sum、web/package.json 和独立文档 requirements）

构建量子算法的活文档，让知识持续增值。