54 lines
1.6 KiB
Markdown
54 lines
1.6 KiB
Markdown
# 📚 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，浏览器直接打开）
|