calibre-metadata-apply
安全编辑 Calibre 电子书元数据
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:calibre-metadata-apply。 它的用途是:安全编辑 Calibre 电子书元数据 完整的 Skill 内容见:https://321skill.com/skills/calibre-metadata-apply-x-2/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'请使用 calibre-metadata-apply 将我的 Calibre 数据库中所有出版年份为空的书籍的出版年份设为 2020,先 dry-run 查看影响。' 它会调用 calibredb 执行 dry-run,列出所有待修改的书籍及其当前年份和目标年份,并询问你是否继续。确认后执行 apply 完成修改。
介绍
Calibre 是管理电子书的强大工具,但批量修改元数据(如书名、作者、标签)时容易误操作,导致数据混乱。本 Skill 通过“dry-run(试运行)→ 审核 → apply(应用)”的验证门控机制,确保每次修改都在你确认无误后才生效,避免批量改错后无法回滚的尴尬。
使用方式非常直接:提供要修改的元数据规则(例如“将所有作者为空的书籍设为‘佚名’”、“给所有 2023 年出版的书籍添加标签‘2023’”、“将某系列书籍的系列名统一为‘XX 系列’”),Skill 会先执行 dry-run 生成变更预览,列出每本书的原始值和目标值。你确认无误后,再执行 apply 真正写入 Calibre 数据库。
适合需要频繁管理电子书库的内容创作者、学术研究者以及高校学生,尤其是那些收集了大量 PDF、EPUB、MOBI 等格式电子书,希望统一整理元数据以便检索和分类的人群。如果你有数千本电子书,手动挨个编辑元数据会非常耗时,这个 Skill 可以一次批量处理,且安全可靠。
使用前请确保已安装 Calibre 并配置好 calibredb 命令行工具(可通过 calibre 的“首选项→共享→允许通过 calibredb 访问”开启)。建议先在小范围(如一个文件夹)测试 dry-run 流程,确认规则无误后再全库应用。注意:本 Skill 只能修改 Calibre 数据库中的元数据,不会直接修改电子书文件本身。
核心特点
同类工具通常直接修改元数据,无法预览变更影响;本 Skill 强制要求先 dry-run 再 apply,用户可逐条核对修改内容,大幅降低误操作风险。
注意事项
需要预先安装 Calibre 并配置 calibredb 工具,且只能处理 Calibre 数据库中的电子书格式(如 EPUB、MOBI、PDF 等),对纯文件目录不支持。
常见问题
dry-run 和 apply 有什么区别?
dry-run 只模拟修改并列出变更清单,不会实际写入数据库;apply 才是真正执行修改。建议先 dry-run 确认无误后再 apply。
需要安装 Calibre 吗?
是的,本 Skill 依赖 Calibre 的 calibredb 命令行工具,请先安装 Calibre 并开启 calibredb 访问权限。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/calibre-metadata-apply-x-2/raw/index.md 读取 calibre-metadata-apply 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/calibre-metadata-apply-x-2/raw/index.md(查看排版版本)