致谢

灵感来源

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 1.23+ — 主语言
• PocketBase v0.38 — 内嵌 BaaS (SQLite + Auth + Realtime + Admin UI)
• Neo4j Go driver v5 — 图数据库 client
• minio-go v7 — S3 兼容存储 client
• casbin/v2 — PAT scope enforcer
• godotenv — .env 加载
• kardianos/service — 跨平台 systemd / launchd / SCM 安装
• DuckDB — paperindex 索引引擎
• modernc.org/sqlite — 纯 Go SQLite（CGO-free）

Client

• Python 3.11+
• Pydantic v2 + pydantic-settings — 数据模型 / 配置
• Requests — HTTP client
• PyYAML — Wiki frontmatter
• Qiskit — 量子电路（codegen / validator）
• QPanda — 同上
• MinerU — PDF → Markdown 解析

Frontend

• React 19
• Vite — build tool
• TanStack Router — 路由
• Tailwind CSS v4
• shadcn/ui — 组件库
• PocketBase JS SDK — 浏览器登录 / realtime

Tooling

• uv / pixi — 包管理
• Commitizen — 版本管理 / Conventional Commits
• pytest + Go testing — 测试
• mkdocs + mkdocs-material — 这份文档

基础设施

• Caddy — 反向代理 / TLS 终结
• RustFS — 对象存储后端
• EasyTier — 跨地域 mesh networking
• Read the Docs — 文档托管
• GitHub Actions — CI / release pipeline
• PyPI — Python 包分发

学术参考

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

• Karpathy 的 LLM Knowledge Base gist（前面已引用）
• Material for MkDocs 的 Reference architecture
• arXiv 的 bulk data layout（我们抄了它的 YYMM 前缀目录约定）

维护者

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

• @Agony5757 (USTC)
• @TMYTiMidlY (USTC)
• @YunJ1e (USTC)
• @gausshj (USTC)
• @qsxustc
• @yowakkojay

完整 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.sum / pyproject.toml / package.json）

---

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