SuperAPI AI 工具集

journal-abbrev

写作与研究

查看项目

更新于 10-15 18:45

技能介绍

用途:查找期刊/杂志名称缩写,在全称与 ISO 4、MEDLINE 缩写之间转换,并批量规范化 BibTeX 文件中的期刊名。

主要能力:通过多源级联查询——本地 JabRef 数据库(约 2.5 万种期刊)、AbbrevISO API(ISO 4,仅正向)、NLM Catalog(生物医学期刊,双向)。支持缩写、展开、自动判别方向、模糊分页搜索、处理 .bib 文件(含 --dry-run 预览、--output 指定输出、--expand 展开、--idempotency-key 幂等重放)、批量文本处理(含 --stream 输出 NDJSON)、缓存状态查看与更新/重建。非终端运行时 stdout 输出稳定 JSON 信封,终端下输出表格或缩进视图,可用 --format json|table|human|auto 强制格式。

必要用法:命令统一为 python3 jabbrv.py 加子命令,例如 python3 jabbrv.py abbrev "Nature Medicine"、python3 jabbrv.py expand "Nat. Med."、python3 jabbrv.py lookup "J. Am. Chem. Soc."、python3 jabbrv.py bib refs.bib、python3 jabbrv.py batch journals.txt。首次运行会自动下载 JabRef CSV 缓存(约 2-5 MB)。可用 python3 jabbrv.py schema 查看机器可读契约。

环境与限制:环境变量 JABBRV_CACHE_DIR 可覆盖缓存目录,JABBRV_OFFLINE 为真时仅查本地缓存、未命中即为不可重试的 not_found,NO_COLOR 禁用颜色;这些变量由宿主环境设定,调用方无法通过参数覆盖。退出码 0 成功(含部分成功)、1 运行时或上游错误、2 校验/输入错误、3 未找到;应基于 error.code 与 error.retryable 分支。ISO 4 带句点(如 Nat. Med.),MEDLINE 不带句点(如 Nat Med)。按 ISO 4 规则,单词标题(如 Nature、Science、Cell)不缩写。查找时不应猜测缩写,需使用该脚本。

适用场景:学术写作中规范化参考文献期刊名、Zotero 导出 BibTeX 后处理、LaTeX 编译前的期刊名统一。缺失信息:安装方式、收费与价格、平台支持等暂未提供。