核心功能
mycroft 是一款面向 EPUB 电子书的本地语义索引 CLI 工具，核心链路为：解析电子书 → 分块 → 生成 embedding → 本地存储 → 支持语义检索与 LLM 问答。
显著优点
- 本地优先：索引数据落盘，隐私可控，无需上传整书至云端服务。
- 成本优化：支持 OpenAI Batch API（
--batch），embedding 与摘要成本降低 50%，适合大规模书籍处理。 - 交互灵活：提供
book ask直接问答、book search精准片段检索、chat repl多轮会话三种交互模式。 - 断点续传：
ingest resume机制可应对网络中断或批量任务失败，提升可靠性。
潜在局限
- 强依赖 OpenAI：需
OPENAI_API_KEY，且 embedding 与聊天功能完全绑定 OpenAI 服务，无本地模型降级方案。 - 仅支持 EPUB：PDF、Markdown 等常见格式需额外转换。
- 摘要成本陷阱：
--summary会显著增加 token 消耗与处理时间，需按需启用。 - 批量延迟：Batch API 结果最长等待 24 小时，不适合即时需求。
适用人群
- 研究者、学生、知识管理者：需对多本专著建立可检索的语义索引。
- 隐私敏感用户：偏好本地存储而非 Notion/Readwise 等云端方案。
- 成本敏感的技术用户：能接受 CLI 操作，愿用 batch 模式换取费用优势。
常规风险
- API 密钥泄露风险：需妥善保管
OPENAI_API_KEY，避免硬编码或提交至版本控制。 - 数据持久化：需关注本地索引目录的备份策略，防止误删
mycroft book delete后数据不可恢复。 - 内容合规：上传至 OpenAI 的内容需遵守其使用政策，敏感资料需谨慎评估。