电子书批量格式转换

痛点：书库格式混乱与批处理缺失

随着电子书积累，手头的文件往往散落着 mobi、epub、azw3 等多种格式。当你想在新设备上阅读，或是需要转为 pdf 归档时，逐个手动拖拽到 Calibre 界面点击转换非常繁琐，尤其是面对几十本小说时。

这个技能旨在将 ebook-convert 命令行工具封装为自然语言指令，让你能对整个文件夹进行批量扫描与转换。

核心机制与工作流

该技能的核心逻辑分为三个步骤：环境检查、意图解析与逐本转换。

• 环境依赖：技能依赖本机安装的 Calibre。执行前会自动检查环境变量或默认路径（如 C:\Program Files\Calibre2\）下的 ebook-convert 可执行文件。
• 参数推断：它能理解类似“把 D:\books 里的 epub 转成 mobi，边距 40”这样的指令。默认情况下，它会扫描文件夹内所有匹配的文件，输出到原目录。
• 逐本同步处理：为了避免单本卡死导致批处理中断，技能采用同步执行策略，每本书独立处理，互不干扰。

此外，针对 PDF 归档需求，技能集成了 ima 知识库功能。它能扫描指定目录下的 PDF，生成结构化清单，并辅助你导入 ima 客户端。

细节与避坑指南

• 超时保护：大体积网文转换耗时较长。技能设置了 10 分钟的单文件超时阈值，一旦触达即判定失败并跳过，防止在无响应的文件上浪费时间。
• 格式特异性：注意 --pdf-page-margin-* 参数仅在生成 PDF 时生效。如果你转成 docx 或 mobi，该参数会被忽略。
• 跨平台限制：目前的路径检测逻辑主要针对 Windows 环境。Git Bash 下会将 Unix 风格路径转换为 Windows 原生路径，以确保子进程正常调用。

对于章节极多（>1000 章）的超长篇小说，脚本转换可能不如 Calibre 桌面端的图形界面稳定，建议此类特例仍手动处理。