核心用法
book-reader 是一款专为 AI Agent 设计的命令行书籍阅读工具，支持从多个来源获取书籍并进行结构化阅读。用户可通过 ./book-reader.sh search 搜索书籍（对接 Project Gutenberg 的 gutendex.com API），使用 download 命令获取指定书籍文件，再通过 read 命令进行分块阅读。工具内置智能分块机制，默认每次阅读 50 页，支持 --from-page 和 --pages 参数灵活控制阅读范围。阅读进度自动持久化存储于 ~/.openclaw/workspace/memory/reading-state.json，包含当前书籍、已读页数、书签和笔记等元数据，实现跨会话的断点续读。
显著优点
多源整合能力：同时覆盖 Project Gutenberg（7 万+ 公共领域书籍，完全合法）、Anna's Archive（百万级资源，需自负法律风险）及本地文件三大来源，满足不同场景需求。格式兼容性强：原生支持 EPUB、PDF、TXT 三种主流电子书格式，通过 pandoc、pdftotext 及 Python 库（ebooklib、beautifulsoup4）实现可靠解析。AI 友好设计：智能分块阅读避免上下文窗口溢出，支持摘要生成与知识提取，专为 Agent 学习场景优化。隐私优先架构：所有阅读状态本地存储，无云端同步或数据上传，用户完全掌控个人数据。开源透明：MIT 许可证，代码完全可见，无混淆或隐藏逻辑。
潜在缺点与局限性
法律边界模糊：Anna's Archive 属于影子图书馆，其使用在多数司法管辖区处于法律灰色地带，用户需自行承担合规风险。DRM 明确不支持：设计层面拒绝处理 DRM 保护内容，无法阅读 Kindle、Apple Books 等平台的加密书籍。解析质量波动：PDF OCR 质量依赖源文件，扫描版 PDF 可能出现乱码；EPUB 转纯文本时格式信息丢失，复杂排版还原度有限。性能瓶颈：大型 PDF 解析速度较慢，未实现异步或流式处理。依赖管理负担：需手动安装 poppler-utils、pandoc、Python 库等系统依赖，跨平台配置成本较高。无社交功能：缺乏阅读统计可视化、书友互动或跨设备同步等现代阅读应用常见功能。
适合的目标群体
AI 研究者与开发者：需要为 Agent 构建知识库、进行书籍级 RAG 训练或自动化摘要生成的技术用户。学术研究者：从事人文社科研究，需批量处理公共领域文献、构建文献综述的研究人员。自驱型终身学习者：偏好开源工具、重视数据隐私、习惯命令行工作流的深度阅读者。法律与合规意识强的用户：能够辨识公共领域与受版权保护内容边界，主动选择合法书源的责任使用者。
使用风险
合规风险：误用 Anna's Archive 获取受版权保护书籍可能导致法律纠纷，建议优先使用 Project Gutenberg 并遵守当地版权法。依赖可用性：外部工具（pandoc、poppler-utils）的版本差异可能导致解析行为不一致，建议锁定依赖版本。数据丢失风险：阅读状态仅存储于本地单点文件，无备份机制，系统故障或误删将导致进度丢失。网络安全：下载阶段涉及网络请求，需确保 URL 来源可信，防范中间人攻击或恶意文件注入。性能风险：处理超大 PDF（数百 MB 级）可能触发内存压力，建议在资源充足环境中运行。