操作指南

按"我想做什么"组织的 how-to 指南。每篇都是一个具体任务，从前置条件到完整命令再到常见错误。

论文与资产

• 从 arXiv 摄入论文

  ---

  qatlas ingest 让 server 自动抓 PDF + 元数据 + 可选解析。

• 上传 PDF / Markdown

  ---

  qatlas upload pdf/mineru 手动推送资产，sha256 dedup、冲突处理、--overwrite 语义；mineru 子命令一次提交 markdown + 全部图片（v0.8.0 替换原 upload markdown）。

• 用 MinerU 解析 PDF

  ---

  qatlas mineru 本地跑 MinerU 并推回。单篇 / 队列模式 / 多人并发 claim。

Wiki 内容

• 写 Wiki 页面

  ---

  统一 concept 模型下的页面模板与最小可行示例（concept + category，source 仅作引用）。

• 生成 Wiki 内容

  ---

  多 subagent 读 paper → 提炼 concept → 去重合并的可复用流水线（prompt + merge_concepts.py）。

• Lint 与 校验

  ---

  qatlas wiki lint 错误码 W001–W008 解释、典型修复模式。

• 贡献 Wiki 与 Raw

  ---

  Wiki 仓库 git 协作、server 端 fast-forward pull、ingest 鉴权与同步。

协作

• 管理凭据

  ---

  PAT 创建 / 撤销 / 轮换、qatlas auth login 多 host 切换、shell vs CI 配置。

电路 / 代码

• 电路工具链

  ---

  designer → codegen → validator → estimator 完整链路，含 IR 中间格式。