CAJ 转 PDF

问题：CAJ 格式把文献锁在封闭工具里

中国知网（CNKI）下载的文献多为 .caj 格式，必须用官方 CAJViewer 才能打开。这意味着换设备要重装软件、分享给没有 CAJViewer 的人会失败、批注和摘录导出也受限。CAJViewer 没有提供便捷的无安装转换方案，而强行重命名扩展名并不能得到可被其他工具读取的 PDF。

核心能力与工作方式

该技能基于开源工具 caj2pdf，将 CAJ 文献转换为通用 PDF。支持 .caj、.c8、.kdh 以及 PDF/CAJ 等子格式，核心逻辑是解析 CAJ 内部结构并重建为标准 PDF 对象。

• 单文件转换：提供 CAJ 路径后，调用 convert 子命令执行转换。若未指定输出路径，PDF 与源文件同目录且扩展名改为 .pdf；加 -v 可在转换前显示格式类型、页数和大纲数。
• 目录批量转换：指定目录时，递归搜索所有 CAJ 文件，调用 batch 命令处理。输出路径可指定，默认在各 CAJ 文件同目录生成 PDF，批量结束会汇总成功与失败数量。
• 文件信息检查：使用 show 子命令查看 CAJ 文件的格式信息，确认可解析后再转换。
• 依赖处理：caj2pdf 库已打包在技能内，Python 依赖首次运行自动安装。但 mutool（用于修复 PDF xref 表）需手动通过 brew install mupdf 安装，缺失时脚本会报错提示。

适用边界与注意点

该工具基于逆向工程，不是知网官方方案，部分文件可能转换不完整或格式异常。遇到以下情况需注意：

• 若报 Unknown file type，可能是文件损坏、使用了新内部结构，或并非真正的 CAJ 格式，建议改用 CAJViewer 打印为 PDF。
• HN 格式转换失败时，需从 caj2pdf-extra-libs 下载编译共享库，放入 caj2pdf_lib 目录并赋予执行权限。
• 转换后的 PDF 若内容异常，可参考技能内 references/caj_format_reference.md 查看格式限制与依赖说明。