calibre-catalog-read
由 nextaltair 提供
Web & Frontend Development简介
Read Calibre catalog data via calibredb over a Content server, and run one-book analysis workflow that writes HTML.
描述
该技能的功能
Reads book catalog data from a Calibre Content server using calibredb, supporting list, search, and ID lookups. Runs a one-book AI analysis pipeline that extracts text, generates a structured analysis via a subagent, and writes the result as an HTML block back to the book's comments field. Analysis state is cached in SQLite to avoid reprocessing unchanged books.
The two-turn async design and SQLite cache let long analysis jobs run without blocking the chat session or reprocessing books that have not changed.
何时使用
- Searching a remote Calibre library for books in a specific series
- Looking up full metadata for a single book by its Calibre ID
- Running AI analysis on a novel and saving the result to its Calibre comments
- Checking whether a book has already been analyzed before triggering a new pipeline run
- Listing all books from a Calibre Content server in structured JSON
示例工作流
User asks: analyze book ID 3 from my Calibre library in Japanese
- 1
Validate book ID and confirm subagent settings (model, thinking level, timeout) for the session
- 2
Run prepare_subagent_input.mjs to extract text and split it into chunked source files
- 3
Use subagent-spawn-command-builder to generate the sessions_spawn payload, then call sessions_spawn
- 4
Register the run in runs.json with runId, book_id, title, and status running, then reply to user that analysis is running in background
- 5
On completion event, call handle_completion.mjs to load the analysis JSON, apply HTML to Calibre comments via calibredb, and remove the run record
Structured AI analysis written to the book's Calibre comments field as HTML, with cache record stored in calibre_analysis.sqlite
前置要求
- CALIBRE_PASSWORD environment variable
- CALIBRE_USERNAME environment variable (optional, for authenticated servers)
- Calibre application installed with calibredb and ebook-convert on PATH
- Running Calibre Content server accessible at a known host and port with library ID
安装
clawhub install nextaltair/calibre-catalog-read运行 CLI 命令,或把这段提示词粘贴到 Claude Code、Cursor、Codex 或你在用的任意编程智能体里。