核心功能
calibre-catalog-read 是一个面向 Calibre 电子图书馆的只读目录查询与单本书深度分析工作流技能。它通过连接运行中的 Calibre Content Server，提供轻量级的图书列表、搜索、ID 查询等只读操作，同时支持完整的 AI 阅读分析管道（导出 → 分析 → 缓存 → 评论 HTML 应用）。
显著优点
1. 只读安全设计：严格限定为目录查询与分析工作流，元数据编辑（书名、作者、系列等）强制路由至 calibre-metadata-apply，避免误操作
2. 异步非阻塞架构：采用主代理 + 子代理分离模式，Turn A 快速启动、Turn B 异步完成，避免长时阻塞聊天监听器
3. 智能连接管理：支持多主机故障转移、环境变量自动解析、认证缓存，减少用户配置负担
4. 精细化运行状态管理：单文件 JSON 状态追踪，自动清理成功记录，失败保留便于调试
5. 多语言支持：分析文本生成由子代理控制，支持用户指定的 lang 参数，不硬编码语言
潜在局限
- 依赖预运行服务：必须已有 Calibre Content Server 运行，禁止从此技能启动 calibre-server
- 单书单任务：一次仅处理一本书，不支持批量并行分析
- 漫画/图像书排除：标题或标签含漫画特征时自动跳过文本管道
- 文本长度阈值：提取文本过短时需用户确认，避免低质量分析
- Node/uv/Python 混合依赖：需要完整的运行时环境（node、uv、calibredb、ebook-convert）
适用人群
- 拥有自托管 Calibre 书库的技术用户
- 需要通过 AI 为电子书生成结构化评论/分析的个人图书馆管理员
- 追求自动化元数据增强、同时要求只读查询安全边界的用户
常规风险
- 认证信息泄露：支持明文密码缓存（
--save-plain-password），默认不推荐 - 远程数据修改：
modifiesRemoteData声明包含calibre:comments-metadata，分析结果会回写至 Calibre 评论字段 - 子代理超时配置：需会话级确认
model/thinking/runTimeoutSeconds，配置不当可能导致任务堆积 - 状态文件竞争：
runs.json单文件设计在极端并发下可能存在竞态