BZJZ_Material/文档润色流和知识库构建流/claude-scholar/skills/citation-verification/scripts/README.md

Citation Verification Scripts

状态说明

这些脚本是参考实现，不是主要工作流的一部分。

本目录中的Python脚本提供了基于API的引用验证实现，但实际的引用验证工作流使用WebSearch和Google Scholar，而不是这些脚本。

为什么保留这些脚本？

这些脚本作为参考实现保留，用于：

1. 理解验证逻辑 - 展示引用验证的完整逻辑和步骤
2. 学习API使用 - 了解如何使用CrossRef、arXiv、Semantic Scholar等API
3. 高级用例 - 对于需要批量验证或自动化的场景，可以参考这些实现

主要工作流

实际的引用验证应该使用 ml-paper-writing skill 中的 Citation Workflow：

1. 使用 WebSearch 查找论文
2. 在 Google Scholar 上验证
3. 从 Google Scholar 获取 BibTeX
4. 验证声明（如需要）
5. 添加到 bibliography

详见 ml-paper-writing skill 的 "Citation Workflow (Hallucination Prevention)" 部分。

脚本说明

verify-citations.py

完整的引用验证脚本，包含：

• 四层验证机制（格式、存在性、信息匹配、内容验证）
• 多API支持（CrossRef、arXiv、Semantic Scholar）
• 报告生成

用途: 参考实现，了解完整的验证逻辑

api-clients.py

API客户端库，包含：

• CrossRefClient - DOI验证
• ArXivClient - arXiv论文验证
• SemanticScholarClient - 通用学术搜索
• CitationAPIManager - 统一API管理

用途: 参考实现，了解如何使用学术API

format-checker.py

BibTeX和LaTeX格式检查工具，包含：

• BibTeX格式验证
• LaTeX引用检查
• 格式错误报告

用途: 参考实现，了解格式检查逻辑

使用建议

对于日常论文写作:

• ✅ 使用 ml-paper-writing skill 的 Citation Workflow
• ✅ 使用 WebSearch 和 Google Scholar
• ❌ 不要使用这些Python脚本

对于批量验证或自动化:

• 可以参考这些脚本的实现
• 根据需要修改和使用
• 注意API速率限制

依赖安装

如果需要运行这些脚本（仅用于参考或高级用例）：

pip install bibtexparser requests semanticscholar arxiv

更多信息

详见 citation-verification skill 的 SKILL.md 文件。