书架系统
书架页面起到了串联Saber Translator各个功能的作用。Saber Translator的主要功能翻译,阅读,分析,都以书架页面作为入口。同时书架系统也可以作为您本地书籍的管理系统,我们制作了清晰且可视化的管理页面,以便于您整理书籍。

核心概念
层级结构

书架
├── 书籍 1
│ ├── 章节 1
│ │ └── 图片 1, 2, 3...
│ ├── 章节 2
│ └── 章节 3
├── 书籍 2
└── 书籍 3书籍
书籍是最顶层的组织单位:
- 代表一部完整的漫画作品
- 包含多个章节
- 可设置封面、标题、标签
章节
章节是书籍的子单位:
- 代表漫画的一话/一集
- 包含该章节的所有图片
- 关联独立的翻译会话
书籍管理
创建书籍

- 在书架页面点击"新建书籍"
- 填写书籍信息:
- 标题:书籍名称(必填)
- 封面:上传封面图片(可选)
- 标签:添加分类标签(可选)
- 点击"创建"完成
编辑书籍
- 点击书籍卡片的"编辑"按钮
- 修改书籍信息
- 保存更改
删除书籍
- 点击书籍卡片的"删除"按钮
- 确认删除操作
注意
删除书籍会同时删除其下所有章节和翻译数据,此操作不可恢复!
章节管理
创建章节
- 进入书籍详情页
- 点击"添加章节"
- 填写章节信息:
- 标题:章节名称
- 排序:章节顺序
- 上传章节图片
章节排序
调整章节顺序:
- 点击"排序"按钮进入排序模式
- 拖拽章节调整顺序
- 点击"完成"保存
删除章节
- 点击章节的"删除"按钮
- 确认删除
进入翻译
从书架进入

- 点击书籍卡片
- 在章节列表中选择要翻译的章节
- 点击"进入翻译"
继续翻译
如果之前有保存的翻译进度:
- 进入章节
- 系统自动加载保存的会话
- 继续之前的翻译工作
进入阅读
阅读翻译结果

翻译完成后,可以通过书架进入阅读模式:
- 点击书籍卡片
- 在章节列表中选择已翻译的章节
- 点击"进入阅读"
阅读模式功能
- 全屏阅读翻译后的漫画
- 阅读器使用竖向流式阅读
- 支持缩放查看细节
- 可通过局域网共享从而在手机上阅读
进入分析
漫画分析入口

从书架进入漫画分析功能:
- 点击书籍卡片
- 点击"漫画分析"
分析功能
漫画分析功能可以:
- 对漫画内容进行深度分析
- 提取角色、情节等信息
- 生成漫画内容摘要
- 对漫画情节进行智能问答
- 生成漫画时间线
详细使用方法请参考漫画分析章节。
数据存储
存储位置
书架数据存储在项目目录下:
data/
├── bookshelf/ # 书架数据目录
│ ├── books.json # 书籍列表摘要(标题、封面、章节数等)
│ ├── tags.json # 标签元数据
│ └── [book_id]/ # 单本书籍目录
│ ├── book_meta.json # 书籍详细元数据
│ ├── cover.b64 # 封面图片(Base64)
│ └── chapters/ # 章节目录
│ └── [chapter_id]/
│ └── chapter_meta.json # 章节元数据
└── sessions/
└── bookshelf/ # 章节翻译会话数据
└── [book_id]/
└── [chapter_id]/
├── session_meta.json # 会话元数据
├── image_0_original.png # 原图
├── image_0_translated.png # 译图
├── image_0_clean.png # 干净背景
└── ...数据说明
| 文件 | 说明 |
|---|---|
books.json | 所有书籍的摘要信息,用于书架列表快速加载 |
book_meta.json | 单本书的完整元数据(章节列表、标签、时间戳等) |
session_meta.json | 章节的翻译会话数据(UI设置、图片元数据等) |
image_*_*.png | 实际的图片文件(PNG 格式) |
数据备份
建议定期备份 data 目录,以防数据丢失:
- 备份整个
data目录即可保留所有书籍、章节和翻译数据 - 数据迁移时只需复制
data目录到新位置
搜索功能
搜索书籍
在书架页面的搜索框中输入关键词:
- 支持按标题搜索
- 支持按标签搜索
- 实时显示搜索结果
最佳实践
项目组织建议
- 按作品创建书籍:一部漫画对应一本书籍
- 按话数创建章节:每一话/集对应一个章节
- 使用标签分类:按类型、状态、优先级等分类
- 及时保存进度:翻译过程中定期保存会话
命名规范
| 类型 | 建议格式 | 示例 |
|---|---|---|
| 书籍标题 | 作品名称 | 咒术回战 |
| 章节标题 | 第X话/集 | 第1话 |
| 标签 | 分类名 | 少年漫画、进行中 |
