# reader

**Repository Path**: madalin/reader

## Basic Information

- **Project Name**: reader
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-17
- **Last Updated**: 2026-09-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ebook-reader

图片型电子书在线阅读器（内部自用）。实现规范见 `ebook-reader-PRD.md`。

## 开发环境

```powershell
python -m venv .venv
.venv\Scripts\python -m pip install -e .
```

> 所有命令都从仓库根目录运行（`data/` 路径是相对路径）。

## 阶段 1：入库 CLI

```powershell
# 入库一个 PDF，成功时打印 book_id 与页数
.venv\Scripts\python -m ingest.cli add C:\path\to\book.pdf

# 可选元数据覆盖
.venv\Scripts\python -m ingest.cli add book.pdf --title "书名" --author "作者" --subtitle "副标题"

# 列出书库
.venv\Scripts\python -m ingest.cli list
```

入库产物：

```
data/
├── library.db
└── books/{book_id}/
    ├── page/{n}@1200.webp, {n}@1800.webp
    └── thumb/{n}.webp
```

生成测试用样例 PDF：

```powershell
.venv\Scripts\python scripts\make_sample_pdf.py
```