# 📚 Ecliptic Pathfinder — 个人图书阅读管理

轻量级命令行图书管理工具，零依赖，纯 Python 标准库。

## 快速开始

```bash
# 添加书目
python bookshelf.py add "深度工作" --author "卡尔·纽波特" --format paper --status reading --tags "效率,自我管理"

# 列出所有书
python bookshelf.py list

# 按状态/格式/标签筛选
python bookshelf.py list --status reading
python bookshelf.py list --format ebook
python bookshelf.py list --tag "哲学"

# 更新书目
python bookshelf.py update 1 --status read --rating 5 --finish-date 2026-03-25

# 删除书目
python bookshelf.py delete 1

# 生成展示网页
python bookshelf.py build
# 然后用浏览器打开 output/index.html
```

## 完整字段

| 参数 | 说明 | 示例 |
|------|------|------|
| `title` (必填) | 书名 | `"深度工作"` |
| `--author` | 作者 | `"卡尔·纽波特"` |
| `--translator` | 译者 | `"宋伟"` |
| `--publisher` | 出版社 | `"后浪出版"` |
| `--pub-date` | 出版日期 | `"2017-09"` |
| `--cover-url` | 封面 URL | `"https://..."` |
| `--format` | `paper` / `ebook` | `paper` |
| `--status` | `to-read` / `reading` / `read` | `reading` |
| `--rating` | 个人评分 1-5 | `5` |
| `--douban-score` | 豆瓣评分 | `7.9` |
| `--goodreads-score` | GR 评分 | `4.18` |
| `--tags` | 逗号分隔标签 | `"哲学,认知科学"` |
| `--notes` | 简评 | `"值得反复阅读"` |
| `--start-date` | 开始日期 | `"2026-03-01"` |
| `--finish-date` | 完成日期 | `"2026-03-20"` |

## 数据存储

- 数据库：`books.db`（SQLite，自动创建）
- 网页输出：`output/index.html`（静态 HTML，浏览器直接打开）