Initial commit

2026-03-25 13:20:39 +08:00
commit c1ecce9719
8 changed files with 992 additions and 0 deletions
@@ -0,0 +1,53 @@
+# 📚 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，浏览器直接打开）