有声书源管理使用说明

入口

有声书源管理：源管理 - 有声书源 - 有声书源列表

功能概述

有声书源管理用于将书籍与书源、声源进行关联，配置有声书的生成参数，并监控生成进度。通过有声书源可以将文本内容转换为音频内容，为用户提供听书服务。

页面功能

1. 有声书源列表

筛选功能

• 书籍ID： 按书籍ID筛选
• 声源： 按声源筛选
• 搜索： 执行筛选查询
• 新增： 创建新的有声书源

列表字段

• ID： 有声书源唯一标识
• 书籍： 书籍ID和书籍名称
• 声源： 关联的声源名称
• 最后章节： 当前最后生成的章节名称（加密显示）
• 排序： 显示排序值
• 生成进度： 显示已生成章节数/总章节数和进度百分比，进度条颜色：
  • 绿色渐变：正常进度（1-99%）
  • 蓝色渐变：已完成（100%）
  • 橙色渐变：未开始（0%）
• 状态： 开启/关闭状态
• 优先章节： 优先生成的章节索引（从0开始，逗号分隔）
• 更新时间： 最后更新时间

操作功能

• 查看任务： 跳转到该有声书源的章节生成任务列表
• 编辑： 编辑有声书源配置
• 删除： 删除有声书源（删除前需确认）

2. 新增/编辑有声书源

基本信息配置

• 书籍ID： 目标书籍ID（必填，编辑时只读）
• 刷新书源： 根据书籍ID刷新可选书源列表
• 书源ID： 选择对应的书源（必填），从书籍的可开启书源中选择
• 优先章节： 优先生成的章节索引（可选），格式：10,11,12（章节索引从0开始，逗号分隔）
• 书源路径： 系统自动生成的路径（只读）
• 声源： 选择用于生成的声源（必填）
• 最后章节： 系统自动更新的最后生成章节（只读）
• 排序： 显示排序值（默认0）
• 已生成章节数： 当前已生成的章节数量（只读），显示格式：已生成数 / 总章节数
• 状态： 开启/关闭状态，控制是否生成新的章节任务
• 队列类型： 仅新增时可设置（必填），选择任务使用的队列：
  • 运维队列（ops）：高优先级队列，用于运维手动触发的任务
  • 用户队列（user）：普通队列，用于常规生成任务

生成进度显示

编辑页面会显示当前生成进度条，包括：

• 已生成章节数 / 总章节数
• 百分比进度
• 可视化进度条（颜色规则与列表一致）

使用流程

1. 新增有声书源

1. 进入有声书源列表，点击”新增”，或者在书籍管理找到对应书籍选择添加有声源
2. 输入书籍ID，点击”刷新书源”按钮获取可选书源
3. 从下拉列表中选择书源ID，优先选择AI源，没有AI源建议使用最新更新的书源
4. 可选填写优先章节（如：0,1,2 表示优先生成前3章）
5. 选择声源
6. 设置排序值（默认0）
7. 设置状态（默认开启）
8. 选择队列类型
9. 点击”保存”完成创建
   
   

2. 编辑有声书源

1. 在列表中找到目标有声书源，点击”编辑”
2. 查看生成进度（进度条会显示当前完成情况）
3. 可修改声源、排序、状态、优先章节等配置
4. 书籍ID和书源ID在编辑模式下不可修改
5. 点击”保存”完成更新

3. 查看生成进度

1. 在列表中通过进度条查看大致进度
2. 点击”查看任务”进入详细的章节任务列表
3. 编辑页面顶部会显示详细的进度信息

4. 管理有声书源

1. 通过筛选功能查找特定的有声书源
2. 通过状态控制开启/关闭自动生成
3. 通过删除功能移除不需要的有声书源

配置说明

优先章节机制

• 优先章节字段用于指定需要优先生成的章节索引
• 格式：逗号分隔的数字，从0开始（如：0,1,2 表示第1-3章）
• 系统会优先为这些章节创建生成任务
• 不设置则按正常顺序生成

队列类型说明

• 运维队列： 用于紧急生成或重要书籍，优先级高
• 用户队列： 常规生成任务，按正常优先级处理

状态控制

• 开启： 系统会自动为新的章节创建生成任务
• 关闭： 暂停自动生成，已有任务不受影响

进度显示说明

• 进度条颜色会根据完成情况变化
• 100%完成显示蓝色，0%显示橙色，中间进度显示绿色
• 进度更新可能有延迟，属于正常现象

注意事项

1. 书源选择： 只能选择已开启状态的书源，确保书源可用
2. 优先章节： 优先章节索引从0开始，需正确填写，格式错误可能导致解析失败
3. 队列选择： 新增时必须选择队列类型，编辑时不可修改
4. 进度更新： 生成进度会实时更新，但可能有延迟
5. 状态控制： 关闭状态不会停止已有任务，只会阻止新任务创建
6. 书源刷新： 修改书籍ID后需要点击”刷新书源”按钮才能看到可选书源

常见问题

Q: 如何创建有声书源？
A: 进入有声书源列表，点击”新增”，填写书籍ID、选择书源和声源，设置队列类型等参数后保存。也可在对应书籍选择添加有声源。

Q: 如何刷新书源列表？
A: 在新增或编辑页面，输入书籍ID后点击”刷新书源”按钮，系统会加载该书籍的所有可用书源。

Q: 优先章节如何设置？
A: 格式为逗号分隔的数字，从0开始。例如：0,1,2 表示优先生成第1-3章。不设置则按正常顺序生成。

Q: 如何查看生成进度？
A: 在列表页面可以看到进度条和百分比，点击”查看任务”可以查看详细的章节任务列表。

Q: 关闭有声书源会影响正在生成的任务吗？
A: 不会。关闭状态只会阻止新任务的创建，已有任务会继续处理。

Q: 可以修改队列类型吗？
A: 队列类型只能在新增时设置，编辑时不可修改。如需修改，需要删除后重新创建。

Q: 为什么书源列表中看不到可选书源？
A: 需要先输入书籍ID，然后点击”刷新书源”按钮，系统才会加载该书籍的可用书源。

Q: 优先章节的作用是什么？
A: 设置优先章节后，系统会优先为这些章节创建生成任务，适合需要快速生成特定章节的场景。