bookshelf/README.md

📚 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，浏览器直接打开）