核心用法
calibre-metadata-apply 是一款面向 Calibre 电子书库的专业元数据管理技能，通过 calibredb 命令行工具与 Calibre Content Server 交互，实现批量、可控的图书信息更新。该 skill 采用"确认-提案-应用"三段式执行流，强制要求用户在正式修改前完成目标确认与 dry-run 验证。
主要功能模块：
- 目标确认：通过只读查询缩小候选范围，展示
id,title,authors,series,series_index供用户确认 - 提案合成：当元数据缺失时，从文件提取+网络来源收集证据，生成带置信度（high/medium/low）的候选方案
- 字段支持：涵盖 title、authors、series、tags、comments 等 10+ 标准字段，以及 comments_html、analysis 等辅助字段
- 批量应用：JSONL 格式输入，支持
--dry-run预览与--apply正式执行
显著优点：
1. 安全设计完善：强制 dry-run 先行、分阶段用户确认、支持 pending-review 标签隔离存疑项目
2. 置信度分级机制：明确标注证据来源与可信度，低置信度字段留空而非自动填充
3. 灵活认证：支持环境变量、显式参数、可选 auth 缓存多种凭证管理方式
4. 分阶段深度分析：Light pass → Page-1 pass → Deep pass 的渐进式处理，平衡效率与准确性
5. 多语言支持：内置日语/非拉丁语系 sorting 脚本配置（katakana/hiragana/latin）
潜在缺点与局限性：
- 依赖链复杂：需预装
calibredb、配置 Content Server、安装subagent-spawn-command-builder，部署门槛较高 - 交互式流程重：多轮用户确认可能导致大批量处理效率降低
- PDF 提取能力有限：依赖
ebook-convert/pdftotext外部工具，扫描版 PDF 识别效果差 - 网络依赖：深度分析阶段需要外部 web 证据搜索
适合人群：
- 拥有大型 Calibre 书库、需要批量规范化元数据的资深用户
- 对数据质量要求高、愿意投入时间审核的图书馆管理员或藏书整理者
- 具备一定技术背景、能配置 Calibre Content Server 及环境变量的用户
常规风险：
- 误操作风险：虽有 dry-run 保护，但用户确认环节若疏忽仍可能导致批量误改
- 数据一致性：comments_html 等辅助字段的 upsert 逻辑可能覆盖用户已有标记
- 依赖服务可用性：Content Server 中断或认证过期将导致操作失败
- 隐私考量：深度分析阶段的 web 证据搜索可能泄露查询内容至外部服务