论文编号体系

每篇论文在 QuantumAtlas 中有三层标识:

标识

形式

说明

paper_id

qa_ + 26 位 ULID

全局唯一主键,收录时铸造(mint),终生不变

身份(identity)

arXiv ID / DOI / OpenAlex ID / 标题哈希

用于去重与跨来源合并;同一篇论文的多个身份归并到同一个 paper_id

asset_id

自增整数

论文资产编号,对应一份具体的 PDF 资产(某个 arXiv 版本或正式出版版本), 指向对象存储中的相对路径

论文状态(status):

下载任务执行时可经历 pending(资产抓取中)→ ready。 仅有元数据的论文也可使用注册表默认的 ready 状态,因此是否已有 PDF 应以资产记录为准,不能仅凭 status 判断。 MinerU 转换完成后,资产记录会带上 Markdown 路径与图片数。

搜索登记与按需下载

搜索命中一篇数据库里 没有见过 的论文时(例如一个陌生的 arXiv ID), 系统会为它铸造 paper_id、登记元数据,但不会自动抓取 PDF 或创建下载任务。 在搜索结果中勾选论文,再点击「下载所选」,主服务才为所选论文提交下载任务。

搜索响应中的 created: true 仅表示本次搜索新建了元数据记录,不代表已下载。 此策略适用于之后的搜索;升级前已排队的任务仍会继续执行,不会自动取消。

去重与合并

所有身份注册都经过唯一入口:同一篇论文无论从 arXiv ID、DOI 还是 OpenAlex ID 进入,都会归并到最早铸造的 paper_id 上,并发冲突时自动重查,不会产生重复记录。