تخطَّ إلى المحتوى
TakoAPI
العودة إلى المهارات

calibre-catalog-read

بواسطة nextaltair

Web & Frontend Development
918التنزيلات وفق ما يذكره clawskills.sh
0المشاهدات
لا إعجاباتسجّل الدخول للإعجاب بهذه المهارة
—لم يُقيَّم بعد
تقييمك

موجز

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. 1

    Validate book ID and confirm subagent settings (model, thinking level, timeout) for the session

  2. 2

    Run prepare_subagent_input.mjs to extract text and split it into chunked source files

  3. 3

    Use subagent-spawn-command-builder to generate the sessions_spawn payload, then call sessions_spawn

  4. 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. 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

شغّل أمر واجهة سطر الأوامر، أو الصق النص في Claude Code أو Cursor أو Codex أو أي وكيل برمجة تستخدمه.

الروابط