📚 Ecliptic Pathfinder — 个人图书阅读管理
轻量级命令行图书管理工具，零依赖，纯 Python 标准库。
快速开始
# 添加书目
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，浏览器直接打开）