数据来源与覆盖范围
本服务把三类公开来源汇总到同一个本地库（SQLite + FTS5 全文索引），统一用 id 前缀区分：cl: 来自 CourtListener，gi: 来自 GovInfo。
来源
| 来源 | 内容 | source 字段 |
许可 |
|---|---|---|---|
| CourtListener（Free Law Project） | 美国联邦与州法院意见的元数据与文本，覆盖近期新发布的判例 | courtlistener |
批量数据为公共领域（Public Domain） |
| GovInfo – USCOURTS（美国政府出版办公室） | 联邦法院意见（地区法院、上诉法院等） | govinfo |
美国政府作品，公有领域 |
| 法院官网原件 PDF | 作为判例全文的首选来源 | text_source=court_pdf |
法院意见本身属公共记录；本服务仅抽取文本 |
说明：判例文本通常属于公共领域，但各法院官网、CourtListener 的 API 服务条款以及 GovInfo 的 API 使用条款仍然适用。如需大规模再分发，请自行核对来源方的条款。
全文来源优先级
- 法院原件 PDF 抽取文本（不占上游额度，
text_source=court_pdf）。 - 失败时回落到 CourtListener 的
plain_text（cl_plain_text）或 HTML（cl_html），会消耗上游额度。
有些法院官网拦截自动下载（如返回 403 或 JavaScript 跳转页），这类判例的全文要等额度恢复后经 CourtListener 回落补齐，期间 text_status 为 pending 或 retry。
覆盖范围与更新频率
- 覆盖范围是“近期判例”，不是历史全集。 首次回填最近约 7 天，之后按增量滚动同步；库中法院列表见
GET /courts。 - 同步频率：后台默认每 2 小时一轮（CourtListener 增量页 → GovInfo → 补全文）。因上游额度有限，同步量受预算约束，新判例通常在数小时内入库，全文可能稍晚。
- GovInfo：撰写本文档时 GovInfo 尚未入库（共享演示 key 被上游限流，换用正式 key 后启用），
/govinfo/uscourts/recent可能暂时返回空；live=true可实时拉取。 - 数据新鲜度可从
GET /health的opinions、with_text、pending_text观察。 - 本服务不是法律意见，也不保证数据完整、无误；引用前请以法院原件为准。