用途：oma-scholar 用于学术文献检索、获取、生成、校验、分析与比较论文 sidecar。sidecar 基于 Knows .knows.yaml 规范，适合低 token 研究流程，例如仅读取 statements 约 700 tokens，而完整 PDF 约 10K。
主要能力与模式：Generate 从论文、摘要、草稿、LaTeX 或笔记生成 {paper}.knows.yaml，再由 lint 校验；Validate 输出带 file:line 问题的通过/失败报告；Review 产出 {paper}.review.knows.yaml；Analyze 以自然语言总结 sidecar 的论点；Compare 生成论点/方法/证据的差异表；Remote 支持检索、按 id 获取或仅取某 section（statements|evidence|relations|artifacts|citation）。
使用方式：命令行子命令为 oma scholar search "<query>"、oma scholar resolve "<title-or-doi>"、oma scholar get "<record-id-or-doi>"、oma scholar lint "<paper.knows.yaml>"。lint 支持 --lenient（第三方 sidecar）与 --fail-on-warning（CI）。无 CLI 时可调用公开 API，如 https://knows.academy/api/proxy/search?q=... 与 /partial?record_id=<id>§ion=statements。数据源回退顺序为 knows.academy → OpenAlex → Semantic Scholar；OpenAlex 与 S2 的密钥可选。
限制：knows.academy 目前仅索引 2026 年论文（多为 arXiv）；提交 sidecar 回平台、完整同行评审编辑流程、翻译与纯 PDF 解析均不在范围内。本地生成面向 v0.9.0 / paper@1 兼容性，并非完整规范一致性。禁止编造：无法从来源确认的 DOI、venue、year 应省略而非猜测。sidecar 内容保持英文。