qatlas-cli — QuantumAtlas 的命令行客户端
QuantumAtlas 的
qatlas命令行客户端：面向用户侧的论文获取、贡献上传、 本地解析等工作流，通过 HTTP 与服务端 qatlasd 交互。本仓库是主仓 QuantumAtlas 拆出的独立私有仓库，只保留客户端与本地工具，不含服务端代码。
所有服务端通信都是 requests 直发的 HTTP 调用，无重量级 SDK 依赖。
安装
从 PyPI 安装为全局 CLI 工具（推荐，与拆分前 quantum-atlas 的安装方式一致）：
# 推荐：uv 全局工具（隔离环境 + 升级方便）
uv tool install qatlas-cli
# 或 pipx
pipx install qatlas-cli
# 或 plain pip
pip install qatlas-cli
qatlas --help
也可以直接从 GitHub 安装：
uv tool install --from git+ssh://git@github.com/IAI-USTC-Quantum/qatlas-cli.git qatlas-cli
本地 editable 安装（开发用）：
git clone git@github.com:IAI-USTC-Quantum/qatlas-cli.git
cd qatlas-cli
uv sync --extra dev # 项目内 .venv，editable 安装本包
# 或装入当前环境：
uv pip install -e .
命令概览
qatlas config # 管理用户级配置文件（~/.config/qatlas/config.yaml）
qatlas auth # 管理各 host 的 PAT / session token（login / status / token / logout）
qatlas paper # 从服务端拉取论文 PDF / markdown（静默 fetch + LRO 轮询）
qatlas contrib # 贡献者工作流：上传 PDF（contrib pdf）或本地跑 MinerU 再推送（contrib mineru）
qatlas parser # 抓取并解析 arXiv 论文（本地工作区命令）
别名：papers → paper，parse → parser。
qatlas auth login # 设备码 / PAT 登录
qatlas paper get markdown quant-ph/9508027 --output paper.md
qatlas contrib pdf quant-ph/9508027v1 --pdf paper.pdf
qatlas contrib mineru 2501.00010v1
search 命令由独立插件 qatlas-search 提供（仓库 IAI-USTC-Quantum/qatlas-search），
未安装时 qatlas search 会给出安装提示。
插件机制
第三方包可以通过 entry point 组 qatlas.plugins 注册插件，向 CLI 贡献
顶层命令或 contrib 子命令。插件协议（基类 QatlasPlugin 与
CommandSpec）定义在 qatlas/client/plugins/base.py：
# 插件包自己的 pyproject.toml
[project.entry-points."qatlas.plugins"]
myplugin = "my_package.qatlas_plugin:plugin"
内置命令优先于插件命令；插件不可用时会被静默跳过，不影响 CLI 本体。
配置
用户级配置位于 ~/.config/qatlas/config.yaml（首次运行非 config 命令时
自动创建），顶层 server_url / token 等字段供各客户端命令读取。环境变量
QATLAS_* 系列可覆盖对应配置；QATLAS_SKIP_DOTENV=1 跳过仓库 .env 加载。
开发与测试
uv sync --extra dev
uv run pytest -q # 默认全离线；真打外网的用例标了 network，需 -m network 显式开启
测试覆盖：CLI 命令分发与版本解析、auth（设备码登录 / token 存储，mock HTTP）、
paper / contrib / config 命令行为（mock 服务端）、parser 的 arXiv 抓取与
MinerU 客户端（固定 fixture / mock）。带 network 标记的 live 用例默认跳过。
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file qatlas_cli-0.22.0.tar.gz.
File metadata
- Download URL: qatlas_cli-0.22.0.tar.gz
- Upload date:
- Size: 127.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a7c484c78ce1938b816220c76bf0c9a330ca9a51b3d96ee6e5bccfbd97c35ba0
|
|
| MD5 |
4e94ca26124f16b847aad643163acf44
|
|
| BLAKE2b-256 |
7dfc49e98f2efce9f780e0ca0d8054ad9f448897efa44a7afa5ddd963f1eabdb
|
Provenance
The following attestation bundles were made for qatlas_cli-0.22.0.tar.gz:
Publisher:
release.yml on IAI-USTC-Quantum/qatlas-cli
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
qatlas_cli-0.22.0.tar.gz -
Subject digest:
a7c484c78ce1938b816220c76bf0c9a330ca9a51b3d96ee6e5bccfbd97c35ba0 - Sigstore transparency entry: 2583828902
- Sigstore integration time:
-
Permalink:
IAI-USTC-Quantum/qatlas-cli@a6b18f58ba979b57050562fdf81b0798071554fa -
Branch / Tag:
refs/tags/v0.22.0 - Owner: https://github.com/IAI-USTC-Quantum
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@a6b18f58ba979b57050562fdf81b0798071554fa -
Trigger Event:
push
-
Statement type:
File details
Details for the file qatlas_cli-0.22.0-py3-none-any.whl.
File metadata
- Download URL: qatlas_cli-0.22.0-py3-none-any.whl
- Upload date:
- Size: 73.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
55cb5cff49e4151a62c9878111397e94b0ef6a44ecff4fe40e6e322f883d6816
|
|
| MD5 |
16b64308cf5e773aae8ca1ab725d5079
|
|
| BLAKE2b-256 |
0a1d13ba26cf91f2e4121f67b1ab8387f7d221e98e0e2b137ed0f7fdf580cf8e
|
Provenance
The following attestation bundles were made for qatlas_cli-0.22.0-py3-none-any.whl:
Publisher:
release.yml on IAI-USTC-Quantum/qatlas-cli
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
qatlas_cli-0.22.0-py3-none-any.whl -
Subject digest:
55cb5cff49e4151a62c9878111397e94b0ef6a44ecff4fe40e6e322f883d6816 - Sigstore transparency entry: 2583829385
- Sigstore integration time:
-
Permalink:
IAI-USTC-Quantum/qatlas-cli@a6b18f58ba979b57050562fdf81b0798071554fa -
Branch / Tag:
refs/tags/v0.22.0 - Owner: https://github.com/IAI-USTC-Quantum
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@a6b18f58ba979b57050562fdf81b0798071554fa -
Trigger Event:
push
-
Statement type:
