reading-manager

# Reading Manager - 阅读管家

个人阅读管理系统，帮助记录书籍、跟踪阅读进度、管理笔记并生成阅读报告。

## 功能特性

### 1. 书籍/文章管理
- 支持 ISBN、URL、手动输入录入书籍
- 自动获取书籍元数据（Google Books API / 豆瓣 API）
- 文章链接收藏与管理
- 多类型支持：书籍、文章、论文、文档

### 2. 阅读进度跟踪
- 页码进度记录
- 百分比进度计算
- 阅读时长统计
- 阅读速度分析

### 3. 阅读笔记
- 高亮记录
- 批注管理
- 标签分类
- Markdown 导出

### 4. 阅读清单
- 想读 (Want to Read)
- 在读 (Currently Reading)
- 已读 (Finished)
- 自定义书单

### 5. 阅读报告
- 月度/年度阅读统计
- 阅读趋势分析
- 书籍类型分布
- 阅读时长报告

### 6. 阅读目标
- 年度阅读目标设定
- 每日/每周阅读提醒
- 目标完成进度追踪

## 安装

```bash
cd ~/.openclaw/workspace/skills/reading-manager
pip install -e .
```

## 使用方法

### 书籍管理

```bash
# 添加书籍（通过 ISBN）
reading book add --isbn 9787115428028

# 添加书籍（手动输入）
reading book add --title "深入理解计算机系统" --author "Randal E. Bryant" --pages 800

# 通过 URL 添加文章
reading book add --url https://example.com/article --type article

# 列出所有书籍
reading book list

# 查看书籍详情
reading book show 1

# 更新书籍信息
reading book update 1 --status reading --rating 5

# 删除书籍
reading book delete 1
```

### 阅读进度

```bash
# 更新阅读进度
reading progress update 1 --page 150
reading progress update 1 --percent 25

# 查看阅读进度
reading progress show 1

# 阅读时长记录
reading progress time 1 --minutes 45

# 阅读历史
reading progress history 1
```

### 阅读笔记

```bash
# 添加笔记
reading note add 1 --content "这是一个重要的概念" --page 120 --tags "important,concept"

# 添加高亮
reading note highlight 1 --content "关键段落" --page 120 --color yellow

# 列出笔记
reading note list 1

# 按标签搜索笔记
reading note search --tag important

# 导出笔记为 Markdown
reading note export 1 --output notes.md
```

### 阅读清单

```bash
# 查看想读列表
reading list want

# 查看在读列表
reading list reading

# 查看已读列表
reading list finished

# 移动书籍到不同列...

# Reading Manager - 阅读管家

个人阅读管理系统，帮助记录书籍、跟踪阅读进度、管理笔记并生成阅读报告。

## 快速开始

```bash
# 安装
cd ~/.openclaw/workspace/skills/reading-manager
pip install -e .

# 初始化数据库
reading data path

# 添加一本书
reading book add --title "深入理解计算机系统" --author "Randal E. Bryant" --pages 800

# 查看书籍列表
reading book list

# 更新阅读进度
reading progress update 1 --page 150

# 添加笔记
reading note add 1 --content "内存层次结构的重要性" --page 120 --tags "important,memory"

# 查看阅读统计
reading report stats
```

## 示例数据

```bash
# 添加示例书籍
reading book add --title "Python编程：从入门到实践" --author "Eric Matthes" --pages 500
reading book add --title "算法导论" --author "Thomas H. Cormen" --pages 1300
reading book add --title "设计模式" --author "GoF" --pages 400

# 添加文章
reading book add --title "如何高效学习" --url "https://example.com/learning" --type article

# 创建书单
reading list create "技术书单" --description "编程技术相关书籍"
reading list add-book "技术书单" 1
reading list add-book "技术书单" 2

# 设置年度目标
reading goal set-yearly 24
```

## 测试命令

```bash
# 测试书籍管理
reading book list
reading book show 1
reading book search Python

# 测试进度管理
reading progress show 1
reading progress history 1

# 测试笔记管理
reading note list
reading note tags

# 测试书单
reading list show

# 测试目标
reading goal status
```