Calibre Ebooks

查询和操作本地Calibre图书馆的AI技能

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:Calibre Ebooks。
它的用途是:查询和操作本地Calibre图书馆的AI技能
完整的 Skill 内容见:https://321skill.com/skills/calibre-ebooks-x-4/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“帮我搜索Calibre图书馆中所有作者为‘刘慈欣’的科幻小说”,它会调用本地API查询并返回书名、评分、格式等详细信息。或者:“列出过去一年添加的关于深度学习的书籍”,AI会按时间筛选并整理成列表。

介绍

Calibre Ebooks 是一个专为拥有本地 Calibre 电子书库用户设计的 AI 技能。它通过本地 Books API 和辅助脚本,让你能用自然语言直接查询、搜索和管理 Calibre 图书馆中的图书元数据、标签、作者等信息,而无需手动打开 Calibre 界面。该技能仅操作你已配置好的本地图书馆,不涉及任何外部下载或搜索,确保数据安全与隐私。

使用方式非常简单:你需要先配置好本地的 Calibre 图书馆,并启动配套的 FastAPI 服务器(项目提供了本地环境配置指导和 systemd 服务)。之后,在支持 OpenClaw 的 AI 对话界面中,直接说出你的需求,比如“帮我找到 Calibre 里所有关于机器学习的书”,AI 就会自动调用本地 API 返回结果。项目还支持语义 RAG 搜索,能实现更智能的图书检索。

这个技能最适合拥有大量本地电子书并希望快速检索、整理图书的个人用户,尤其是学术研究者、高校学生和内容创作者。它可以帮助你快速定位参考文献、整理专题书单、查询书籍详情,极大提升知识管理效率。同时,它也适合需要将 Calibre 图书馆集成到自动化工作流中的开发者,因为项目提供了 Python API 客户端和完整的 Agent 工作流指南。

使用前请确保本地 Calibre 图书馆已正常启动,并且已按文档配置好环境变量和 API 端口。注意,该技能不会自动下载或添加新书,仅对已有图书进行操作。如果你需要从外部来源搜索数字图书,请使用其他专用工具。另外,建议定期备份 Calibre 数据库,以防意外操作。

核心特点

与同类 Calibre 操作工具相比,本技能专为 AI Agent 场景设计,提供语义 RAG 搜索和完整的 API 客户端,能直接通过自然语言交互,而无需手动编写查询脚本或切换界面。

注意事项

不适用于需要从外部搜索、下载或添加新图书的场景,且需要预先配置好本地 Calibre 图书馆和 FastAPI 服务器。

常见问题

是否需要联网才能使用?

不需要,所有操作都在本地完成,仅需确保本地 Calibre 图书馆和 API 服务器正常运行即可。

支持哪些格式的电子书?

支持 Calibre 图书馆中已索引的所有格式,如 EPUB、MOBI、PDF 等,但具体取决于你的 Calibre 配置。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/calibre-ebooks-x-4/raw/index.md 读取 Calibre Ebooks 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。