SuperAPI AI 工具集

alterlab-citation-verifier

编程与开发

查看项目

更新于 10-15 19:56

技能介绍

用途:对参考文献列表做逐条存在性核验,判断每条引用是否真实、标识符是否指向该文献,并标记撤稿。以脚本查询权威 API 记录为准,不依赖模型记忆。

主要能力:自动识别 BibTeX、DOI/arXiv 列表或自由格式参考文献,提取标题、作者、年份、DOI、arXiv ID;解析 DOI/arXiv,并用 doi.org Handle API 判断 DOI 是否注册;按标题与首作者检索;模糊匹配标题(默认阈值 0.70)并计算作者姓氏重合度;标记撤稿(Crossref 撤稿/撤回通知、OpenAlex is_retracted)与关注声明;输出每条判定与仓库级结论(PASS、PASS_WITH_CONDITIONS、FAIL、UNVERIFIED)。判定类型包括 verified、TF(完全伪造)、PAC(部分属性错误)、IH(标识符劫持)、PH(占位符幻觉)、SH(语义幻觉,仅提示)、unverified。另有 claim_faithfulness.py 对(论断, DOI)做摘要级支持性筛查,返回 support/contradict/unsupported。

使用方式:运行 uv run python skills/core/alterlab-citation-verifier/scripts/verify_citations.py path/to/references.bib --mailto <contact-email> --threshold 0.70 --out citation_report.json;可用 - 读标准输入,--offline 跳过网络,省略 --out 输出到标准输出。可选设置 OPENALEX_API_KEY、S2_API_KEY。核查论断:uv run python .../claim_faithfulness.py --claim "<句子>" --doi <doi>,支持 --input pairs.json --json 与 --tier llm。

适用场景:核查引用是否存在、DOI 是否伪造、是否含撤稿、AI 生成的参考文献是否被幻觉、引用是否支持所引句子(摘要级)。

限制:仅凭 API 元数据无法确立语义幻觉;claim_faithfulness 只看摘要(abstract_only: true),unsupported 表示未覆盖而非反驳。无键时 OpenAlex 与 Semantic Scholar 易触发限流,arXiv 调用间隔 3 秒;源报错不视为不存在,相关条目记为 unverified。仓库级判定为 UNVERIFIED 不等于通过,需补网或补键重跑,或人工核查。来源状态与所用版本等信息见资料,未提供的费用与平台细节暂未提供。