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-5/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'对Calibre中《Python编程》这本书,把作者改为'张三',先运行dry-run。' 它会显示当前作者和修改后的作者对比,并询问是否确认。用户回复'确认,apply'后,技能会执行修改并返回成功信息。
介绍
该技能解决用户在编辑Calibre电子书库元数据(如书名、作者、标签、封面等)时担心误操作导致数据丢失或混乱的问题。它提供类似Git的dry-run(试运行)和apply(提交)两种门控机制,让修改过程可预览、可确认、可回退,避免意外覆盖。
使用方式非常简单:先向AI发送dry-run指令,技能会读取Calibre数据库并显示将要修改的元数据差异(如新增、删除、变更字段),用户确认无误后,再发送apply指令,技能才会实际写入修改。整个过程完全在AI对话中完成,无需手动操作Calibre界面。
适合需要批量管理电子书元数据的用户,例如整理个人数字图书馆的爱好者、学术研究者(统一论文/书籍的元数据格式)、内容创作者(为电子书设定一致的封面和描述)。尤其适合对元数据准确性要求高、或需要频繁调整书籍信息的场景。
使用建议:在首次使用前建议备份Calibre数据库(通常为metadata.db文件),并先在小批量书籍上测试dry-run,确认技能对元数据字段的解析和修改逻辑符合预期。注意,该技能无法处理Calibre自定义列或插件扩展的元数据字段,仅支持标准字段。
核心特点
同类技能通常直接修改元数据(如Calibre的内置编辑功能),缺乏预览和确认步骤;该技能强制要求先dry-run再apply,类似Git的提交流程,避免不可逆的误操作,特别适合对数据安全敏感的批量修改场景。
注意事项
不适合需要实时同步或频繁修改元数据的场景,因为每次修改都需要两步确认,且不支持Calibre自定义列和插件扩展字段。
常见问题
如何安装这个技能?
请参考仓库README中的安装说明,通常需要将技能文件放入Calibre插件目录或通过MCP服务器配置加载。
dry-run后没有变化怎么办?
表示当前元数据与要修改的内容一致,无需提交。请检查你的修改指令是否正确。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/calibre-metadata-apply-x-5/raw/index.md 读取 calibre-metadata-apply 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/calibre-metadata-apply-x-5/raw/index.md(查看排版版本)