核心用法
mycroft 是一款面向 EPUB 电子书的专业级本地知识库 CLI 工具，通过将书籍内容转化为向量索引，实现语义化检索与 AI 问答。其工作流程分为三步：配置初始化（config onboard/resolve）→ 书籍摄取（book ingest）→ 交互查询（ask/search/chat）。
关键功能特性：
- 灵活摄取模式：支持标准实时处理（即时可用）或
--batch批量模式（延迟 24 小时但成本降低 50%） - 分层摘要策略：可选
--summary生成章节摘要，显著增加处理时间与成本，建议按需启用 - 多形态交互：单次问答（
book ask）、段落检索（book search）、多轮会话（chat start/repl）三种查询方式 - 容错恢复机制：中断后可
resume续传，批量失败自动重提交
显著优点
- 本地化向量存储保障数据隐私，源码透明可审计
- 批量 API 深度整合，为高频使用者提供实质性成本优化
- 会话式 REPL 支持渐进式探索复杂文本主题
潜在局限与风险
- 强制依赖 OpenAI：所有嵌入与对话功能锁定单一供应商，存在服务中断与 API 成本波动风险
- Node/npm 生态：依赖 npm 包管理，跨平台兼容性不及独立二进制分发
- 延迟权衡：批量模式节省费用但牺牲即时性，不适合紧急查询场景
- Token 成本累积：摘要+嵌入双重处理可能产生意外账单，需严格监控
status
适合人群
学术研究者、深度阅读者、编辑审校人员及需要构建私有书籍知识库的专业用户；不适合追求零配置开箱体验或完全离线运行的用户。
常规风险提示
- API 密钥需妥善保管，避免硬编码或误提交至版本控制
- 批量任务建议设置完成通知，防止 24 小时窗口内重复提交
- 大文件摄取前建议使用
search先行验证嵌入质量，再投入完整问答流程