用途:为法律评论稿件的脚注补全页码(pincite),并核验已有页码是否正确。核心原则是模型给出的页码不被采信,只机械核验引文。
主要能力:candidates 解析 .typ 文件,为每条脚注判定类型(kind),并对 pdf 类解析其支持的论断与来源 PDF;triage 按类型给出作者实际需要做的事(含“无需处理”);run 通过 Gemini Files API 为候选请求页码与逐字引文;verify 在 PDF 中重新找到引文,据文档自身编号推导印刷页码并比对;report 输出已确认的 pincite 与单独的 CONFLICTS 段。另有手工复核流程:review_build.py 生成逐引用位置的复核页面,apply 将 pincites.json 导出结果写回稿件(set 插入“, at N”,keep/skip 不改动,默认 DRY RUN)。
类型与处置:pdf 走 Gemini 流程;legislative 可从 govinfo 取 PDF 后重跑;case 超出范围(需 Westlaw/Lexis 星号分页);book 用 scripts/gbooks.py 依逐字引文读取 Google Books 印刷分页;web、statute、regulation、short-form、none 均无需处理。
用法:CLI 为 python3 "$P" candidates/triage/run/verify/report,均读写同一 --state 文件以便续跑;run 需要 GOOGLE_API_KEY。路径均为参数(--body、--bib、--pdf-dir、--fedreg-dir),--bio-offset 默认 3,--only、--limit、--redo 可限定范围。apply 以 (fn, citekey, occurrence) 定位,断言匹配串在脚注范围内仅出现一次,任一断言失败则整轮拒绝。
限制:case 类不支持;verify --vision-fallback 为可选且消耗 API 调用;Google Books 传输经 CDP 驱动真实浏览器并限速,突发搜索会导致主机被临时封禁;测试夹具受付费墙限制未随附。资料未提供收费、价格与平台支持等更多信息。