平台与运维参考¶
本部分完整收录平台、客户端集成、服务端运维、数据格式与架构决策正文，
与使用手册及开发指南互补。正文统一位于 docsite/manual/，
使用 Sphinx/MyST 构建，不再依赖 MkDocs / Material 的主题语法或构建 hooks。
架构决策与较早的运维记录按原文保留历史背景；迁移格式不代表旧接口、环境变量或 尚未实施的规划重新生效。执行操作前请核对对应版本的配置与 API 契约。
概览与入门¶
概念与架构¶
Python 客户端¶
Go 服务端¶
- Go 服务端
qatlasd - 安装与 service 注册
- Docker 部署
- 反向代理
- qatlasd 服务端配置（YAML）
- Robust Downloader（多范式论文抓取）
- Multi-worker downloader: master setup and operations
- Outbound downloader workers
- GitHub / Gitea OAuth 接入
- QuantumAtlas ↔ RustFS integration
- REST API 总览
- 论文内容：固定 PDF、完整解析包与可续读视图
- Upload API：冻结 PDF 与完整解析发布
- PostgreSQL 库设计（catalog + OpenAlex 语料）
- API Explorer（OpenAPI / Swagger）
qatlasd服务端 CLI 参考- 健康检查与监控
- 备份与升级
- Deployment
- 存储路径迁移
参考与数据格式¶
架构决策（ADR）¶
- 架构决策记录（ADR）
- 插件类型双轴命名：
kind（builtin/external）×transport（socket/stdio） - theorems / wiki 为 builtin 拉取插件，而不是 socket-push 守护进程
- 插件端到端 owning 自己领域，host 核心去领域词
- 本轮不引入 QA 侧 Claim 集合 / Claims 页
- Claim 起草走 localhost claim agent + WebUI
- PostgreSQL 中心化关系库（catalog + OpenAlex 语料），不用 MySQL
- Claim 的
references用kind:id，服务端通过/api/papers/lookup精确解析 - Claim 起草 + issue 提交迁回上游 lean 仓，退役 QA client claim 插件
- Paper catalog 重构：代理主键 papers + 子表 paper_assets
- OpenAlex works 内联引用（弃 work_referenced 边表）+ 审计
- 按 id 取资产：PDF 默认直链、md/JSON 默认字节流，均可复写
- 懒加载模块设计：singleflight + 持久 Store + 组合，不引框架
- OpenAlex 语料 schema 分两阶段：base 表启动即建，重索引 CONCURRENTLY 且可门控