# AI + E书 · 电子阅览室

> 用 AI 生成或转换喜欢的电子书，以便随时随地阅读。

<details>
<summary>这里有什么</summary>

## 电子阅览室使用说明

本阅览室支持以下电子书格式的在线阅读：

### 支持格式一览

| 格式 | 状态 | 阅读方式 | 目录 | 翻章 | 移动端说明 |
|:---:|---|---|---|---|---|
| **EPUB** | ✅  | epub.js 在线渲染，左侧章节目录 | ✅ | ✅ 按钮 + 键盘←→ | 目录浮层弹出，桌面端固定侧栏 |
| **MD** | ✅  | 服务端 Parsedown 解析，自动按标题分节，iframe 阅读窗口 | ✅ 按 H1-H3 标题层级生成 | ✅ 按钮 + 键盘←→ + 页码 | 全平台触摸滚动正常 |
| **TXT** | ✅  | 服务端按章节标题分节（第X章/楔子/尾声等），iframe 阅读窗口，自动编码检测（GBK/GB18030/BIG5→UTF-8） | ✅ 自动识别章节标题 | ✅ 按钮 + 键盘←→ + 页码 | 全平台触摸滚动正常 |
| **PDF** | ⚠️  | iframe 内嵌浏览器原生阅读器 | ❌ | 桌面端自带工具栏 | **移动端仅显示第一页**，请点下方「在新窗口打开」按钮用系统阅读器翻页 |
| **MOBI/AZW3** | ❌ | — | — | — | Kindle 私有二进制格式 |
| **CHM** | ❌  | — | — | — | 微软 LZX 压缩二进制格式 |

### 格式差异说明

- **EPUB**：首选格式，epub.js 引擎提供最完整的阅读体验（目录、翻章、键盘快捷键、深色模式）
- **MD/TXT**：服务端自动解析章节结构，转换为分节阅读。TXT 文件自动检测中文编码（GBK / GB18030 / BIG5 → UTF-8），老旧 TXT 小说不会乱码
- **PDF**：浏览器原生阅读器在桌面端可正常翻页；移动端因系统限制仅渲染第一页，需点击按钮跳转新窗口

### 添加电子书

将文件上传至服务器的 `/usr/share/nginx/html/upload/ebooks/` 目录（或其中的子目录），页面自动扫描显示。支持按文件名搜索过滤，按目录分组展示。

### 格式不支持怎么办

**MOBI / AZW3 / CHM** 等格式当前无法直接阅读，推荐使用 [Calibre](https://calibre-ebook.com/)（免费开源）将电子书转换为 **EPUB** 格式后上传：

1. 下载安装 Calibre
2. 将 MOBI/AZW3/CHM 文件拖入 Calibre 书库
3. 选中书籍 → 转换书籍 → 输出格式选择 EPUB → 确定
4. 将转换后的 EPUB 文件上传至服务器 ebooks 目录

### 文件编码说明（TXT 重要）

TXT 文件如果打开后乱码，说明文件编码不是 UTF-8。系统已内置自动编码检测，覆盖常见中文编码：
- GBK / GB18030（简体中文 Windows 系统默认编码）
- BIG5（繁体中文）
- UTF-8（推荐）

无需手动转换编码，系统会自动处理。

---

*本页文字说明可通过编辑 `manual/Sys/电子阅览室说明.md` 自由修改，支持 GitHub / Batata 两种文档样式。*
</details>