# 智能配音系统用户操作手册

## 目录

1. [文档说明](#文档说明)
2. [系统概览](#系统概览)
3. [登录与注册](#登录与注册)
4. [首页（书架）](#首页书架)
5. [新建与编辑项目](#新建与编辑项目)
6. [阅读器（核心制作页）](#阅读器核心制作页)
7. [片段合并管理页](#片段合并管理页)
8. [音频库](#音频库)
9. [声音复刻](#声音复刻)
10. [API Token 管理](#api-token-管理)
11. [角色管理与音色配置](#角色管理与音色配置)
12. [常见操作路径（推荐流程）](#常见操作路径推荐流程)
13. [常见问题与排查](#常见问题与排查)
14. [操作建议与注意事项](#操作建议与注意事项)

## 文档说明

本手册用于指导业务用户完成从“创建项目”到“生成、试听、合并、导出音频”的全流程操作，覆盖当前系统已上线的主要功能模块。

适用对象：
- 内容制作人员
- 配音运营人员
- 复刻音色管理人员

## 系统概览

系统围绕“小说/文本转配音”设计，核心能力如下：

- 账号体系：登录、注册、鉴权访问。
- 项目管理：新建项目、编辑项目、删除项目。
- 章节处理：上传文稿并生成章节。
- 片段制作：在阅读器中进行拆分、配置、生成。
- AI 能力：AI 智能拆分章节片段。
- 音频能力：单片段生成、批量生成、合并音频、试听与下载。
- 角色音色：角色配置、音色试听、声音复刻。
- 安全配置：每个用户独立管理 API Token。

## 登录与注册

### 注册

入口：`/register`

操作步骤：
1. 输入用户名。
2. 输入密码（至少 6 位）。
3. 可选填写昵称。
4. 点击“注册”。

结果：
- 注册成功后自动跳转登录页。

### 登录

入口：`/login`

操作步骤：
1. 输入用户名与密码。
2. 点击“登录”。

结果：
- 登录成功后进入首页（书架）。
- 登录态基于浏览器本地 Token 保存。

## 首页（书架）

入口：`/bookshelf`

### 功能列表

- 查看项目卡片列表。
- 按“项目名/作者”搜索。
- 按项目状态筛选（草稿、制作中、已完成）。
- 新建项目。
- 编辑项目（卡片上的编辑按钮）。
- 删除项目（卡片上的删除按钮）。

### 关键操作

1. 点击项目卡片：进入该项目阅读器页面。
2. 点击“新建项目”：进入项目创建流程。
3. 点击删除：会弹出强确认，确认后删除项目及其关联内容。

### 状态说明

- 草稿：项目已建但内容处理未完成。
- 制作中：章节/片段正在制作流程中。
- 已完成：主要音频内容已处理完成。

## 新建与编辑项目

入口：`/project/create`（新建）

入口：`/project/create?id={项目ID}`（编辑）

页面采用 3 步流程。

### 第一步：基本信息

填写项：
- 项目名称（必填）
- 作者（必填）
- 章节总数（必填）

点击“下一步”后会保存项目信息。

### 第二步：上传文件

支持格式：`.txt`、`.md`、`.doc`、`.docx`

大小限制：不超过 50MB。

操作说明：
1. 上传小说文件。
2. 点击“上传并下一步”或“直接下一步”（存在已上传文件时）。

注意：
- 已有文件时重新上传，系统会提示覆盖风险。

### 第三步：生成章节

点击“开始生成章节”，系统会：
- 调用章节拆分能力。
- 展示进度与章节数量。
- 完成后可自动跳转阅读器。

## 阅读器（核心制作页）

入口：`/project/{projectId}/reader`

阅读器采用三栏结构：
- 左侧：章节目录。
- 中间：正文与播放区。
- 右侧：片段配置面板。

### 左侧章节目录

支持操作：
- 点击章节切换。
- 查看章节片段进度。
- 分页/加载更多章节。

### 中间正文区

支持操作：
1. 鼠标框选文本自动创建片段。
2. 点击已有片段进入编辑。
3. 颜色与线型区分片段状态。
4. 播放时自动高亮当前片段。

约束：
- 单次框选最多 600 字。
- 不允许与已有片段重叠。

### 顶部工具栏能力

- AI 拆分：基于当前章节智能切片。
- 角色管理：维护角色与音色映射。
- 合并管理：进入片段管理页。
- 文本编辑：切换编辑模式（插入/删除文本）。
- 音频库：跳转项目音频列表。
- 批量生成：生成当前章节片段音频。
- 试听：从头播放。
- 从当前播放：从选中片段开始播放。
- 删除章节：删除当前章节及关联数据。
- 刷新：刷新当前页面数据。

### 右侧配音配置面板

对当前片段可配置：
- 片段类型（旁白/对话）
- 角色
- 语音指令（如语速、情绪风格等）
- 停顿时长（用于合并时控制段间停顿）

并支持：
- 生成当前片段音频
- 试听已生成音频
- 上传本地音频并绑定当前片段
- 使用历史音频

### AI 拆分说明

执行前会进行确认，执行中会防止重复任务。

执行结果可能包含：
- 拆分成功数量
- 跳过数量
- 新增角色数量（若有新增，建议立即去角色管理完成配置）

## 片段合并管理页

入口：`/project/{projectId}/segments?chapterId={chapterId}`

主要能力：

- 片段表格查看（序号、类型、角色、状态、内容）。
- 条件筛选（类型、状态、关键词）。
- 单片段配置与播放。
- 多选片段后批量生成。
- 多选片段后合并音频。
- 合并后展示结果卡片并支持试听。

操作前置：
- 合并要求所选片段均为“已完成”状态。
- 若有未完成片段，需先生成。

## 音频库

入口：`/project/{projectId}/audio`

### 功能列表

- 查看项目音频文件。
- 统计信息：文件数、合并音频数、总大小、总时长。
- 按文件名或章节名搜索。
- 播放音频。
- 下载音频。
- 删除音频（移入回收站）。

### 使用建议

- 定期清理无效音频，减少存储占用。
- 合并结果建议命名后归档，便于后续复用。

## 声音复刻

入口：`/voice-clone`

### 创建复刻音色

填写项与校验：
- 上传语音样本（WAV/MP3/M4A）
- 文件大小 < 10MB
- 时长 10~60 秒（推荐 10~20 秒）
- 输入音色名称

创建成功后可在下方列表管理。

### 复刻音色管理

支持：
- 查看音色名称、复刻 ID、状态、创建时间。
- 删除音色（不可恢复）。

## API Token 管理

入口：顶部右上角用户菜单 -> “API Token 管理”

页面能力：
- 查看当前 Token 脱敏值。
- 修改/配置 Token。
- 查看 Token 使用说明。
- 点击“API Token获取教程”可在新标签页打开教程链接。

输入规则：
- 必须以 `sk-` 开头。
- 后续应为足够长度的字母数字字符串。

## 角色管理与音色配置

入口：阅读器顶部“角色管理”。

使用逻辑：
1. 先维护角色列表与角色基础信息。
2. 为每个角色绑定合适音色。
3. 回到片段配置时，直接按角色快速选择。

提示：
- 若片段中角色未配置音色，会提示先去角色管理完善。

## 常见操作路径（推荐流程）

### 路径 A：从零开始制作

1. 注册/登录。
2. 新建项目并填写基本信息。
3. 上传小说文件并生成章节。
4. 进入阅读器，先执行 AI 拆分。
5. 在角色管理中补齐角色音色。
6. 回到阅读器检查片段并微调。
7. 批量生成音频。
8. 在合并管理页合并章节音频。
9. 在音频库试听并下载成果。

### 路径 B：人工精细制作

1. 新建项目并导入文本。
2. 不用 AI 拆分，直接在阅读器手工框选片段。
3. 逐段配置角色与指令。
4. 单段生成后试听。
5. 完成后批量生成剩余片段。
6. 合并并导出。

## 常见问题与排查

### 1. 刷新页面出现 404

现象：在某些页面按 F5 后 404。

处理建议：
- 打开首页重新进入。

### 2. 片段无法生成

排查点：
- 是否已配置 API Token。
- 阿里云百炼后台账号是否已欠费。
- 角色是否已绑定可用音色。
- 网络连接与后端服务状态是否正常。

### 3. AI 拆分提示任务执行中

说明：当前章节已有任务在跑。

处理：
- 等待任务完成后再发起下一次。
- 避免连续重复点击。

### 4. 音频无法播放

排查点：
- 音频是否已生成完成。
- 文件是否已被删除或过期。
- 浏览器是否拦截自动播放。

### 5. 合并失败

排查点：
- 所选片段是否全部为“已完成”。
- 是否存在缺失音频文件的片段。

## 操作建议与注意事项

- 建议先配置 API Token，再进入生产流程。
- 大章节建议先 AI 拆分，再人工校正，效率更高。
- 关键角色音色先定版，避免后续大规模返工。
- 批量生成前先抽样试听 3~5 条，确认风格一致。
- 删除项目/章节前务必确认，删除后不可恢复。
- 建议按章节完成后立即合并并备份下载。