配音
用来整理台词、语气和音色。打开 .peiyin
即可进入。编辑器本身不会生成语音；真正出声要发给助手，走「语音合成」。
功能目录
- 打开与新建：打开
.peiyin；新建配音文件 - 片段 / 代码：用卡片填写，或直接改文件原文
- 填写片段：语气、音色、正文
- 增删与多选：新增、删除、框选多段
- 试听音色：听预置样例；筛选、搜索、收藏
- 发送到 AI：把选中片段或原文交给助手；出声走语音合成
- 生成结果：回写路径后可播放，或在文件树中定位
- 阅读宽度：片段模式下两档宽度
- 自动保存、撤销与状态栏：改完自动写入；撤销重做；底栏计数与当前配置
- 代码模式的校验与外部更新：原文不合法时不能保存；助手回写时可能要选择保留或应用
功能介绍
打开与新建
在文件树中打开
.peiyin，会进入配音。打开后先在「片段」。
新建时，用文件树的新建菜单，选择「配音（.peiyin）」。默认文件名是「新建配音」；若开了「为新建文件/文件夹添加日期前缀」，会加上当天日期。创建后不会自动打开，再到文件树里点开即可。
新文件会带好一个空片段，可直接填写。如果打开的是空文件，画面提示「还没有配音片段」，点「新增片段」即可。
改动会自动写入当前文件。没有单独的「保存」按钮。
片段 / 代码
顶栏左侧可在「片段」和「代码」之间切换。两种模式改的是同一份文件。
片段用卡片填写每一段的正文、语气和音色，并查看生成结果。
代码显示文件原文。顶栏可以搜索。适合核对或批量改。切到「代码」前，会先写入当前片段里的修改。从「代码」回到「片段」时，原文必须合法，否则无法切换。
填写片段
每张卡片从上到下是：语气和音色、正文、「生成结果」。
语气：写语气、风格或场景提示。当前语音合成配置若不支持语气，这一格会禁用，并提示「当前音色配置不支持语气提示」。支持时，字数上限由当前配置决定；超出会立刻截断，并出现提示。
音色：未选时显示「请选择音色」。点名称打开列表。上方可搜索。列表先显示「收藏」，再显示「当前支持」。点左侧可试听该音色的样例；点右侧圆圈选定。当前配置里找不到已填的音色时，会标成「音色不可用，请重新选择」。选好后会立刻写入文件。
正文：占位是「输入需要配音的文字」。最多保留前 10000 字，超出同样截断并提示。输入区大约两行起，随内容增高，大约 25 行后在框内滚动。
音色列表和可用语气，都跟当前「语音合成」配置走。尚未配置时，底栏会提示未配置，列表也可能是空的。请看侧栏的「能力和能力开关」，以及「各项能力的配置」。
增删与多选
列表最下方的加号，或空文件时的「新增片段」，都会在末尾加一张空卡片。
点一张卡片即选中。只有一段时，不会画出选中高亮，但发送仍针对这一段。
有两段及以上时，可在卡片外的空白处拖出方框，框中的片段都会被选中。
删除：选中后按 Delete。没有正文时直接删；有正文时先确认「删除配音片段？」。不能删掉最后一段。同一次打开里，撤销可以收回刚删的片段。
试听音色
片段列表上方是「试听音色」。点开后，上方显示当前配置名称，可搜索，也可按「试听文案」切换样例句。
可按「性别」（全部、男、女）和「年龄」（全部、儿童、少年、青年、壮年、老年）筛选。左侧是音色卡片，右侧是「收藏」。点卡片播放预置样例，不是用你这段正文去合成。星标可收藏或取消收藏；收藏按当前配置分开记住。
没有样例时，会提示「暂无试听」或资源缺失。再点条上，或点关闭、点面板外，即可收起。
试听只用来挑声音。它不会把音频写入当前文件，也不会生成你的台词。
发送到 AI
顶栏「发送到 AI」把内容交给右侧对话。发送前会先写入文件。编辑器里没有「生成」按钮，也不会在本地直接出声。
片段模式：发给当前选中的片段。选了多段就一起交出去。每一段都必须有正文和可用音色，否则会提示文本不能为空、需要先选音色，或音色在当前配置里不可用。
代码模式：若原文里有选中的文字，按选区交给助手；没有选区则交给整份文件。原文不合法或写入失败时，无法发送。
没有打开文件、或暂时无法交给对话时，会提示发送失败。
助手要用「语音合成」才能真正出声。请确认这项能力已打开并已配置，见侧栏的「能力和能力开关」。
生成结果
卡片底部是「生成结果」。还没有回写时，显示「尚未生成配音」。左侧是去掉首尾空白后的正文字数。
助手合成成功后，音频会落到工作区，路径写回这一段。片段模式打开时，列表会跟着更新。之后可以：
- 播放：听这段已经生成的音频。播放中按钮变成「停止」。加载时显示「加载中…」。再点一次可停下。同一时刻只播一段。
- 查看：在文件树中定位该音频，不会在这里打开播放器。
路径必须落在工作区内。不合法时会提示「结果路径不可用」。
阅读宽度
仅在「片段」：顶栏宽度按钮在两档之间切换。选择会记住。
自动保存、撤销与状态栏
修改后会在短暂停顿后自动写入。离开应用、关闭编辑器或切换模式时，也会尽量先写完。
仅在「片段」：顶栏可撤销、重做。没有在改正文或语气时，也可用 ⌘Z、⇧⌘Z。正在输入时，这两键先作用于当前文字。
顶栏左侧可「关闭编辑器」。
底栏在片段模式显示「片段」数量；在代码模式显示「行数」。两种模式都会显示当前语音合成配置的名称。
代码模式的校验与外部更新
代码模式里的原文必须仍是合法的配音文件，才能保存、切换回片段，或发给 AI。不合法时会提示无法保存。
关闭编辑器时若原文不合法，会提示「无法关闭：JSON 不合法」。可先改好，或选「放弃本地修改」后关闭。
助手回写结果时，若你正在代码模式且有未保存的修改，会提示「外部写入冲突」：可「保留本地修改」或「应用外部内容」。保留后，上方可能出现「有更新的外部内容尚未应用。」若原文已经不合法，外部回写会先不应用，需要先修好或放弃本地修改。
片段模式收到回写时，会直接更新列表。
小技巧
- 配音编辑器只整理稿子，不会在里面点一下就出声。填好正文和音色后「发送到 AI」，并打开「语音合成」。
- 「试听音色」听的是样例，用来选声音；你的台词要等助手回写后，才能在「生成结果」里「播放」。
- 要一次交多段，先框选再发送。只要一段时，直接点「发送到 AI」即可。
- 语气能不能写，取决于当前语音合成配置。换了配置后，原来的音色可能变成「不可用」，需要再选一次。
- 「查看」只是在文件树里找到音频。要听，用「播放」。
- 最后一段删不掉。空文件请先「新增片段」。
- 代码模式改乱了，先改回合法再切换或关闭，否则写不进去，助手的回写也可能先进不来。
- 撤销、重做用 ⌘Z、⇧⌘Z。正在输入时，这两键先作用于当前文字。