什么是Bookshelf
Bookshelf 是一款专为个人阅读管理设计的命令行工具，旨在帮助用户高效追踪阅读进度、记录读书心得并系统化地管理自己的书库。它通过简洁的命令行界面，让用户能够轻松添加书籍、设定阅读计划、记录每日阅读情况，并对已读作品进行评价和归档。所有数据均以本地日志文件形式存储，无需依赖网络或外部服务，确保了隐私与离线可用性。无论是构建个人书单、维持每日阅读习惯，还是撰写读书笔记和年度总结，Bookshelf 都能提供一套完整而灵活的解决方案。其设计注重实用性，适合那些偏好轻量级工具、希望通过自动化流程提升阅读效率的用户。 该工具的核心优势在于其模块化的命令结构，每个功能点都有独立的日志记录机制。例如，`add` 命令用于添加新书到书架，`track` 记录阅读页数或章节进展，`review` 则允许用户为已完成书籍打分并写下感想。此外，系统支持标签分类（如 #self-help、#sci-fi）、优先级排序、周度回顾以及生成统计报告等功能，使用户可以按主题、类型或情绪快速检索目标读物。值得一提的是，Bookshelf 还内置了阅读连续性追踪（streak）和提醒设置，帮助培养稳定的阅读节奏。整个系统基于纯文本日志，便于导出为 JSON、CSV 或 TXT 格式，方便与其他应用集成或长期存档。 作为一款完全离线的生产力工具，Bookshelf 不要求任何 API 密钥或第三方依赖，仅需 Bash 4.0+ 和常见 UNIX 命令即可运行。它的数据目录位于 `~/.local/share/bookshelf/`，包含多个 `.log` 文件分别对应不同操作类型，每条记录均带有精确的时间戳。这种设计不仅保证了数据的透明性和可追溯性，也极大地方便了后续的数据分析与迁移。无论是学生整理学术文献、职场人士规划专业书籍阅读，还是普通读者维护个人知识体系，Bookshelf 都能成为值得信赖的数字化伴侣。
核心功能特点
- 命令行驱动的阅读管理工具，支持添加书籍、设定阅读计划和追踪进度
- 支持标签分类、优先级排序和搜索功能，便于按主题或类型组织书库
- 内置阅读连续性追踪（streak）和周度回顾机制，助力养成稳定阅读习惯
- 可导出为 JSON、CSV 或文本格式，便于数据备份与分析
- 完全离线运行，所有数据存储在本地日志文件中，保障隐私与安全
适用场景
Bookshelf 特别适合那些希望系统化管理个人阅读生活的用户。对于经常面临海量待读书籍的读者而言，它可以作为智能书架使用——通过 `add` 命令快速录入新书来源（如朋友推荐、书单推荐），再用 `prioritize` 标记下一本要读的作品，避免陷入选择困难。当开始阅读后，`track` 命令能实时记录每日进度，比如‘完成第5章，共32页’，从而形成可视化的成长轨迹。一旦读完一本书，用户可通过 `review` 写下评分与核心收获，建立属于自己的数字书评档案，日后查阅时一目了然。 在目标驱动型阅读场景中，Bookshelf 同样表现出色。无论是制定年度阅读挑战（如‘一年内读完24本书’），还是季度专项计划（如‘Q2 完成6本非虚构类书籍’），都可以借助 `plan` 和 `report` 功能设定里程碑并定期复盘。配合 `stats` 查看整体统计数据，了解每月阅读量、完成率及各类别分布，有助于调整策略保持动力。对于喜欢深度思考的读者，每周使用 `weekly-review` 总结本周成果（如‘读完《原子习惯》，尝试了习惯叠加法’），不仅能巩固记忆，还能发现阅读模式中的规律与改进空间。 此外，Bookshelf 在日常碎片化阅读管理中也极具价值。例如，用 `remind` 设置归还图书馆书籍的截止日期，防止逾期罚款；通过 `tag` 给书籍打上情绪标签（如 #减压、#灵感），在疲惫时快速找到轻松读物；甚至可以在旅行前用 `search` 查找‘适合地铁上读的短篇小说’，让通勤时间更有意义。由于其轻量化设计和全本地化特性，它也适用于多设备同步场景——只需复制日志文件夹，即可在不同终端间无缝切换，真正实现‘随时随地掌控阅读’。