已集成懒猫OIDC登录。 ## 功能特性 - 多用户书库：支持管理员和普通用户，每个用户拥有独立书单、进度和偏好设置。 - 四种阅读状态：可管理 `Want to Read`、`Currently Reading`、`Read`、`Did Not Finish` 四类阅读清单。 - 阅读轨迹：图书详情抽屉内可直接更新页码、查看 `Progress Over Time` 进度曲线；`Timeline` 页面专门展示已读完图书的时间顺序。 - 统计分析：提供 `Avg Pages/Book`、`Most Popular Language`、`Books by Status`、`Pages Read Per Month`、`Books Finished Per Month` 等统计卡片与图表。 - 图书录入：支持 `Manual（手动录入）`、`Search & Import（搜索导入）`、ISBN 扫码、封面上传和封面 URL。 - 数据导出与备份：支持在 `Data Management` 中按数据集导出 `Books`、`Reading progress`、`Tags`、`Cover files`，并在 `Administration` 中执行整库 `Backup & Restore`。 - 封面管理：支持自动抓取封面、手动上传封面和通过 URL 指定封面。 ### 日常使用方式 1. 在 `Dashboard（仪表盘）` 查看 `Total in Library`、`Books Read`、`Books to Read`、`Currently Reading`，并快速跳转到当前阅读或待读列表。 2. 在 `Library（书库）` 中新增图书、编辑元数据、切换阅读状态、设置评分和标签；打开图书详情后可直接更新 `Reading Progress`，并查看 `Progress Over Time` 曲线。 3. 在 `Timeline（时间线）` 中查看已经读完的图书时间顺序；如果还没有完读图书，会显示 `No finished books in your library yet.` 空状态。 4. 在 `Statistics（统计）` 中查看平均页数、语言分布、阅读状态分布，以及按月份汇总的页数和完读趋势。 5. 管理员可在 `Administration（管理）` 中切换 `Users` 与 `Backup & Restore` 两个分页，维护用户并执行整库备份与恢复。 ### 可选配置 1. `GOOGLE_BOOKS_API_KEY` 获取方式：进入 Google Cloud Console，创建或选择项目后，在 `APIs & Services` → `Library` 启用 `Books API`，再到 `Credentials` → `Create Credentials` → `API Key` 生成密钥。 配置方式：进入应用详情，在环境变量里对应填写。建议配合小猪佩奇使用 影响功能：启用 `Search & Import（搜索导入）` 里的 Google Books 回退搜索源；当 Open Library / Hardcover 结果不足时，可补充更多书目结果、出版信息和更高分辨率的封面。 2. `HARDCOVER_APP_API_TOKEN` 获取方式：登录 [hardcover.app](https://hardcover.app)，进入 `Profile` → `Settings` → `API`，创建新的 API Token。 配置方式：进入应用详情，在环境变量里对应填写。不要带上“Bearer”开头字段，建议配合小猪佩奇使用。 影响功能：启用 `Search & Import（搜索导入）` 里的 Hardcover 搜索源，并参与 `Manage Missing Covers（缺失封面管理）`、图书详情自动搜封面的候选结果补充。 3. `DASHBOARD_QUOTE_ENABLED` 如需启用首页随机语录卡片，可将 `DASHBOARD_QUOTE_ENABLED` 改为 `true`。 配置方式：进入应用详情，在环境变量里对应填写。