SuperAPI AI 工具集

cite-check

通用与其它

查看项目

更新于 10-15 21:37

技能介绍

用途:扫描 pandoc 风格 Markdown 草稿中的引用,把来源 PDF 上传到 Gemini File Search 存储,逐条核查引用是否真正被来源支持,并输出 REVIEW-CITES.md 报告。

主要能力:提取 [@bibkey] 及正文 @key 引用,支持定位符([@key, p. 42])、复合引用 [@a; @b]、脚注内引用和 Bluebook 信号词;将每个引用分类为 SUPPORTED/PARTIAL/UNSUPPORTED/NOT_IN_STORE/ERROR;对 SUPPORTED/PARTIAL 结果做 passage grounding,用 token 级 LCS 对齐确认 Gemini 引用的段落确实存在于来源 PDF,未通过标记 [UNGROUNDED]。默认以 Gemini Batch API 批量查询,可用 --sequential 逐条查询;ask 模式可针对单一来源提问;audit 模式在不查询的情况下检查来源 PDF 是否齐备。

使用方式:需设置 GOOGLE_API_KEY,并具备 Bun、rclone(配置 google-drive: 远程)、python3 + pymupdf4llm、readwise CLI 及带 file 字段的 .bib 文件。先运行 bun materialize-sources.ts 将来源本地化,再执行 bun cite-check.ts --bib ....bib --drafts ./drafts;可选 --store、--out、--limit、--dry-run、--retry-model、--audit、--debug。

限制:仅处理带 file 字段的 .bib 条目;来源缺失或不可读会标记并单独报告;grounding 依赖 PDF 文本提取;Google Drive FUSE 路径需经 rclone 绕行。其余细节暂未提供。