{"skill":{"slug":"reading-manager","displayName":"Reading Manager","summary":"Personal reading management system for tracking books, articles, reading progress, notes, and generating reading reports. Use when: (1) recording books and a...","description":"---\nname: reading-manager\ndescription: \"Personal reading management system for tracking books, articles, reading progress, notes, and generating reading reports. Use when: (1) recording books and articles to read, (2) tracking reading progr\"\nversion: \"1.0.0\"\n---\n\n# Reading Manager - 阅读管家\n\n个人阅读管理系统，帮助记录书籍、跟踪阅读进度、管理笔记并生成阅读报告。\n\n## 功能特性\n\n### 1. 书籍/文章管理\n- 支持 ISBN、URL、手动输入录入书籍\n- 自动获取书籍元数据（Google Books API / 豆瓣 API）\n- 文章链接收藏与管理\n- 多类型支持：书籍、文章、论文、文档\n\n### 2. 阅读进度跟踪\n- 页码进度记录\n- 百分比进度计算\n- 阅读时长统计\n- 阅读速度分析\n\n### 3. 阅读笔记\n- 高亮记录\n- 批注管理\n- 标签分类\n- Markdown 导出\n\n### 4. 阅读清单\n- 想读 (Want to Read)\n- 在读 (Currently Reading)\n- 已读 (Finished)\n- 自定义书单\n\n### 5. 阅读报告\n- 月度/年度阅读统计\n- 阅读趋势分析\n- 书籍类型分布\n- 阅读时长报告\n\n### 6. 阅读目标\n- 年度阅读目标设定\n- 每日/每周阅读提醒\n- 目标完成进度追踪\n\n## 安装\n\n```bash\ncd ~/.openclaw/workspace/skills/reading-manager\npip install -e .\n```\n\n## 使用方法\n\n### 书籍管理\n\n```bash\n# 添加书籍（通过 ISBN）\nreading book add --isbn 9787115428028\n\n# 添加书籍（手动输入）\nreading book add --title \"深入理解计算机系统\" --author \"Randal E. Bryant\" --pages 800\n\n# 通过 URL 添加文章\nreading book add --url https://example.com/article --type article\n\n# 列出所有书籍\nreading book list\n\n# 查看书籍详情\nreading book show 1\n\n# 更新书籍信息\nreading book update 1 --status reading --rating 5\n\n# 删除书籍\nreading book delete 1\n```\n\n### 阅读进度\n\n```bash\n# 更新阅读进度\nreading progress update 1 --page 150\nreading progress update 1 --percent 25\n\n# 查看阅读进度\nreading progress show 1\n\n# 阅读时长记录\nreading progress time 1 --minutes 45\n\n# 阅读历史\nreading progress history 1\n```\n\n### 阅读笔记\n\n```bash\n# 添加笔记\nreading note add 1 --content \"这是一个重要的概念\" --page 120 --tags \"important,concept\"\n\n# 添加高亮\nreading note highlight 1 --content \"关键段落\" --page 120 --color yellow\n\n# 列出笔记\nreading note list 1\n\n# 按标签搜索笔记\nreading note search --tag important\n\n# 导出笔记为 Markdown\nreading note export 1 --output notes.md\n```\n\n### 阅读清单\n\n```bash\n# 查看想读列表\nreading list want\n\n# 查看在读列表\nreading list reading\n\n# 查看已读列表\nreading list finished\n\n# 移动书籍到不同列表\nreading list move 1 --to finished\n\n# 创建自定义书单\nreading list create \"技术书单\" --description \"编程技术相关书籍\"\nreading list add-book \"技术书单\" 1\n```\n\n### 阅读报告\n\n```bash\n# 生成月度报告\nreading report monthly 2024-01\n\n# 生成年度报告\nreading report yearly 2024\n\n# 阅读统计概览\nreading report stats\n\n# 阅读趋势\nreading report trend --days 30\n```\n\n### 阅读目标\n\n```bash\n# 设置年度目标\nreading goal set-yearly 50\n\n# 设置月度目标\nreading goal set-monthly 4\n\n# 查看目标进度\nreading goal status\n\n# 查看历史目标完成情况\nreading goal history\n```\n\n### 搜索与发现\n\n```bash\n# 搜索书籍（在线）\nreading search \"计算机系统\" --source douban\nreading search \"Clean Code\" --source google\n\n# 本地搜索\nreading search-local \"计算机\"\n\n# 按作者搜索\nreading search --author \"刘瑜\"\n```\n\n## 数据存储\n\n数据库位置：`~/.config/reading-manager/reading.db`\n\n```bash\n# 查看数据库路径\nreading data path\n\n# 导出数据\nreading data export --format json --output backup.json\n\n# 导入数据\nreading data import backup.json\n```\n\n## 技术栈\n\n- Python 3.8+\n- SQLite 数据存储\n- Click (CLI 框架)\n- Rich (终端美化)\n- requests (API 调用)\n\n## 数据模型\n\n### 书籍表 (books)\n```python\n{\n    id: int\n    title: str              # 书名\n    subtitle: str           # 副标题\n    authors: str            # 作者（JSON 数组）\n    isbn10: str\n    isbn13: str\n    publisher: str          # 出版社\n    published_date: str     # 出版日期\n    page_count: int         # 总页数\n    description: str        # 简介\n    cover_url: str          # 封面图片 URL\n    categories: str         # 分类（JSON 数组）\n    source_type: str        # 来源：book, article, paper\n    source_url: str         # 来源 URL\n    status: str             # 状态：want, reading, finished\n    rating: int             # 评分 1-5\n    started_at: str         # 开始阅读时间\n    finished_at: str        # 完成时间\n    created_at: str\n    updated_at: str\n}\n```\n\n### 阅读进度表 (reading_progress)\n```python\n{\n    id: int\n    book_id: int\n    current_page: int       # 当前页\n    total_pages: int        # 总页数\n    percent: float          # 百分比\n    minutes_read: int       # 阅读时长（分钟）\n    recorded_at: str\n    notes: str\n}\n```\n\n### 笔记表 (notes)\n```python\n{\n    id: int\n    book_id: int\n    content: str            # 笔记内容\n    page: int               # 页码\n    note_type: str          # 类型：note, highlight\n    highlight_color: str    # 高亮颜色\n    tags: str               # 标签（JSON 数组）\n    created_at: str\n}\n```\n\n### 书单表 (lists)\n```python\n{\n    id: int\n    name: str               # 书单名称\n    description: str        # 描述\n    book_ids: str           # 书籍 ID 列表（JSON）\n    created_at: str\n}\n```\n\n### 阅读目标表 (goals)\n```python\n{\n    id: int\n    year: int               # 年份\n    month: int              # 月份（可选，年度目标为 null）\n    target_count: int       # 目标数量\n    completed_count: int    # 已完成数量\n    created_at: str\n}\n```\n","tags":{"latest":"1.0.0"},"stats":{"comments":0,"downloads":669,"installsAllTime":25,"installsCurrent":4,"stars":0,"versions":1},"createdAt":1773112768599,"updatedAt":1780693868250},"latestVersion":{"version":"1.0.0","createdAt":1773112768599,"changelog":"Initial release of Reading Manager – a personal reading management system.\n\n- Track books, articles, papers, and documents (with ISBN, URL, or manual entry)\n- Monitor reading progress, including page numbers, percentages, time spent, and speed analytics\n- Record and manage reading notes and highlights, with support for tagging and Markdown export\n- Organize works in lists: want to read, currently reading, finished, and custom lists\n- Generate reading reports (monthly, yearly, stats, and trends)\n- Set and view reading goals, with progress tracking and reminders\n- Data stored locally in SQLite; supports export/import (JSON); Python CLI with rich terminal UI","license":"MIT-0"},"metadata":null,"owner":{"handle":"harrylabsj","userId":"s17a8m9q4jybb46cv60h4fxard83hmsn","displayName":"haidong","image":"https://avatars.githubusercontent.com/u/144880725?v=4"},"moderation":null}