用途:把 RIS、BibTeX、纯文本或 CSL-JSON 格式的参考文献统一转换为目标期刊样式(如 NEJM、The Lancet、Nature 或自定义 .csl),也可生成指定 cite key/ID 的文内引用,适合投稿前统一文献格式、合并多来源文献、核对格式改动与缺失元数据。
主要能力:支持 ris、bibtex、plain、csljson 输入;输出兼容 CSL 样式的条目;可按期刊名自动检索 CSL(优先精确匹配,先下载再搜索回退);支持批量转换脚本 scripts/format_bibliography.py;支持文内引用模式;生成 Markdown Before/After 对比表(至少 2 个示例);对无法可靠解析的条目提示缺失字段。
使用方式:依赖 Python 3.10+ 与目标 .csl 样式文件。示例:python scripts/format_bibliography.py --input refs.bib --input-format bibtex --journal "Nature";或指定本地样式 --style "styles/nature.csl" --output formatted.txt;RIS 输入用 --input-format ris;文内引用模式加 --mode citations --cite-keys "ITEM-1,ITEM-2"。解析规则与字段映射见 references/input-formats.md。
限制:缺少输入文件、标识符或上下文时应先向用户索取,不继续执行;覆盖已有结果、高成本批量操作或扩大范围前需用户确认;无法可靠解析的条目需补齐作者、年份、期刊、卷期页码、DOI/URL 等字段;不承担超出声明范围的外部操作或推断。输出默认用稳定可复核的 Markdown 或 JSON,部分完成须标记 PARTIAL。