QuantumAtlas 使用文档

收集论文，确认身份，搜索证据，固定可复现的阅读版本。

QuantumAtlas 把论文资产存入对象存储，以 PostgreSQL 注册表维护统一作品编号， 通过多源检索找到论文。MinerU 将 PDF 转为带图片的 Markdown；不可变 source 和 parse revision 支持固定字节与解析版本。

从搜索到阅读

安装 CLI、确认 qa_ 身份、读 Markdown，或固定 PDF 与解析版本。

从搜索到可复现阅读

使用 Web 界面

搜索、选择下载，浏览论文与讨论；无需登录服务器。

Web 界面

调用 HTTP API

认证、配额、搜索与资产接口；处理缓存未命中和重试。

API 参考

备注

文档可公开阅读。实际 Web 应用与 API 位于 线上实例，需要获授权的账号。 GitHub Pages 是静态文档入口，不提供登录、Swagger 或业务 API。

先读 从搜索到可复现阅读 完成一次完整的论文获取，再按角色选用下面的指南。 管理员的开发文档由实例的管理入口提供；公开 Pages 只发布这套使用文档。

开始使用

• 从搜索到可复现阅读
• 论文编号体系
• Web 界面
• 命令行（qatlas CLI）
• API 参考

检索、收录与管理

• 搜索
• External PDF originals
• MinerU 转换
• 管理后台

组件文档

• qatlas-cli 文档
  • qatlas-cli — QuantumAtlas 的命令行客户端
  • 索引与搜索
• qatlas-search 文档
  • qatlas-search — QuantumAtlas 的多源学术检索微服务
  • 可编程 Scorer 使用指南
  • Survey 检索与 Scorer 的整合边界
  • 索引与搜索
• qatlas-rag 文档
  • qatlas-rag — QuantumAtlas 的 GPU 语义检索微服务
  • 索引与搜索

平台参考与架构决策

• 平台与运维参考
  • 概览与入门
  • 概念与架构
  • Python 客户端
  • Go 服务端
  • 参考与数据格式
  • 架构决策（ADR）
  • 关于项目

组件正文在对应仓库维护，构建按 components.lock.json 固定提交并生成统一 搜索索引。文档提交不等于已验证的服务版本组合；运行版本以实例健康接口为准。 平台参考含部分历史设计，当前操作请优先按使用指南执行。