gptsovits-auto-script-format
/gptsovits-auto-script-format
编写或校验 GPT-SoVITS Auto 使用的 Markdown/TXT 台本文档。Use when creating, converting, or validating a dialogue script for GPT-SoVITS Auto so any agent can produce a file the app can parse safely.
- Author
- waterpro ↗
- Repository
- GPT-SoVITS-Auto ↗
- Licence
- MIT
- Last repository change
- 30.10.2026
Assessment and security
- Files in this package
- 16
- Scripts
- 6
- HTML comments
- 1
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 30.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
- 6 scripts in this package. Review them before installing, as Claude may execute them.
- SKILL.md zawiera komentarze HTML (1). Nie widać ich w podglądzie Markdown, a model je czyta.
Scripts: add_voice.bat, gptsovits_auto.py, run.bat, run.ps1, run_ui.bat, ui_main.py
What it does and when to use it
编写或校验 GPT-SoVITS Auto 使用的 Markdown/TXT 台本文档。Use when creating, converting, or validating a dialogue script for GPT-SoVITS Auto so any agent can produce a file the app can parse safely.
Original author description
编写或校验 GPT-SoVITS Auto 使用的 Markdown/TXT 台本文档。Use when creating, converting, or validating a dialogue script for GPT-SoVITS Auto so any agent can produce a file the app can parse safely.
How it works
- 1. 最小可用示例
- 2. 文件级规则
- 3. 说话人写法(任选一种)
- 4. 编号、时间码与文件名
- 5. 注释、代码块与 Markdown
- 6. 不要这样写
- 7. Agent 写脚本时的检查清单
- 8. 转换示例
- 9. 相关文件
SKILL.md preview
---
name: gptsovits-auto-script-format
description: 编写或校验 GPT-SoVITS Auto 使用的 Markdown/TXT 台本文档。Use when creating, converting, or validating a dialogue script for GPT-SoVITS Auto so any agent can produce a file the app can parse safely.
---
# GPT-SoVITS Auto 台本文档格式
这个文件是给人和 agent 读的“脚本文案格式规范”。GPT-SoVITS Auto 读取
`.md` / `.txt` 后,会按这里的规则拆出每一句台词、角色、编号和输出文件名。
本文件不涉及任何具体语音模型;音色由使用者自己在软件的“音色库”里添加。
## 1. 最小可用示例
```markdown
---
project: 雨后的公交站
---
A:雨好像停了,我们还要继续等吗?
B:你们看,云缝里透出阳光了。
C:[0001] 那家咖啡店已经开门了。
D:[04:25] 我请客,庆祝今天没有迟到。
```
默认输出(输出根目录由软件设置决定):
```text
<输出根目录>/A/雨后的公交站/0001_雨好像停了,我们还要继续等吗?.wav
<输出根目录>/B/雨后的公交站/0002_你们看,云缝里透出阳光了。.wav
<输出根目录>/C/雨后的公交站/0001_那家咖啡店已经开门了。.wav
<输出根目录>/D/雨后的公交站/0425_我请客,庆祝今天没有迟到。.wav
```
角色名必须出现在软件的 `voices/voices.yaml` 中(或写成它的别名);否则解析会报错并指出行号。
## 2. 文件级规则
- 编码:UTF-8(可带 BOM)优先;读不了时回退 GB18030。
- 一行一句台词;空行、注释行不参与生成。
- 支持 `.md`、`.txt`、`.markdown`。
- 文件可以带 YAML frontmatter,只读取以下键:
- `project`:项目名,决定输出子目录。
- `default_voice`:没有写说话人的行的默认角色。
- `text_lang`:整份文档的默认语言(`zh` / `ja` / `en` / `ko` / `yue` / `auto`)。
- frontmatter 必须放在文件最开头,用两行 `---` 包住。
## 3. 说话人写法(任选一种)
| 写法 | 例子 | 说明 |
| --- | --- | --- |
| 全角冒号 | `A:台词` | 最常用 |
| 半角冒号 | `A: 台词` | 也支持 |
| 方括号 | `【A】台词` | 适合剧本 |
| 竖线 | `A|台词` | 适合表格导出 |
| 带编号 | `[0001] A:台词` | 编号会进入文件名 |
| 编号+时间 | `[0001] [04:25] A:台词` | 显式编号优先 |
| 时间码 | `[04:25] A:台词` | 转为 `0425` |
| 时间范围 | `[09:02-07:43] A:台词` | 转为 `0902_0743` 的紧凑形式 |
| 标题分组 | `## A` 下面直接写台词 | 标题设置当前角色 |
| Markdown 列表/引用 | `- A:台词`、`> A:台词` | 前缀会被去掉 |
| 表格 | `| A | 台词 |` | 表头/分隔行会被跳过 |
角色名后面可以带情绪/变体括号,例如 `A(开心):台词`。这会被当成一个完整角色名,
需要在 `voices.yaml` 里有对应条目或别名;没有配置时会报“未知角色”。
## 4. 编号、时间码与文件名
优先级:显式编号 > 时间码 > 行序号(4 位,如 `0007`)。
- 显式编号:`[0001]`、`[5931]`、`5931|A|台词`。
- 时间码:`[04:25]` → `0425`;`[09:02-07:43]` → `0902_0743`(去掉冒号)。
- 没有编号时用解析后的序号,从 `0001` 开始。
- 文件名默认 `{id}_{台词}.wav`;Windows 禁用字符会替换为 `_`,过长会截断。
- 输出目录默认 `{输出根目录}/{角色}/{项目}/`。
## 5. 注释、代码块与 Markdown
- 整行 `# 注释`、`// 注释` 会被跳过。
- 三个反引号包住的代码块会被跳过,避免误读示例代码。
- HTML 注释 `<!-- ... -->`、图片、链接、粗体/斜体标记会被清理。
- 表格的表头行和 `---` 分隔行会被跳过。
- 台词开头若带已知情绪标签(如 `【开心】`、`(生气)`),会被去掉,避免读出来;
正文中间的情绪词不会删除。
## 6. 不要这样写
```markdown
# 这是注释,不会生成
随便写一句没有角色的话
```
上面的第二行只有在 frontmatter 设置了 `default_voice` 时才会生成,否则报错。
建议始终写清楚角色,避免依赖默认值。
## 7. Agent 写脚本时的检查清单
1. 只使用目标软件 `voices.yaml` 中已有的角色名/别名;不确定就先问使用者,不要猜。
2. 一句一行,不要把两句合并;不要把舞台说明写成台词。
3. 需要固定文件名时用 `[编号]`;不需要时让软件按行号编号。
4. 文档头写 `project`,避免输出到临时项目名。
5. 不要写具体模型、角色版权素材或参考音频路径;这些由使用者在音色库中配置。
6. 写完用软件的“解析预览”检查:角色、编号、输出文件是否符合预期。
## 8. 转换示例
从普通剧本:
```text
A:第一句。
B:第二句。
```
转换为带项目和编号:
```markdown
---
project: 示例项目
---
[0001] A:第一句。
[0002] B:第二句。
```
从表格数据(CSV/TSV)转换时,建议输出为:
```text
0001|A|第一句。
0002|B|第二句。
```
`ID|角色|台词` 的竖线格式会被直接识别。
## 9. 相关文件
- 可直接运行的示例:`examples/example.md`
- 音色配置示例:`voices/voices.example.yaml`
- 软件使用说明:`README.md`(中文)、`README.en.md`(English)
Files in this package (16)
- .gitattributes 1 KB
- .gitignore 1 KB
- CONTRIBUTING.md 2 KB
- LICENSE 1 KB
- README.en.md 8 KB
- README.md 24 KB
- SKILL.md 5 KB
- add_voice.bat 1 KB
- gptsovits_auto.py 36 KB
- requirements.txt 1 KB
- run.bat 1 KB
- run.ps1 1 KB
- run_ui.bat 1 KB
- ui_main.py 2 KB
- examples/example.md 1 KB
- voices/voices.example.yaml 1 KB
Versions
The database has no other skills named gptsovits-auto-script-format.
Database snapshot: 13.11.2026 · package version 2ee54499b41c (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 98qianxia
操作「千夏」项目:DSH 的 QQ 机器人插件、GPT-SoVITS 语音适配层、蓝底视频流水线、B 站投稿。当需要起语音服务、合成一句话、出一支视频、投稿,或改动机器人能力(记忆/好感/日记/周报/斗图/小游戏/情绪)时使用。 - 100text
Use this skill when the user wants to create, generate, save, export, download, convert, format, clean, or localize plain text, TXT, Markdown/MD, or HTML file deliverables. This skill produces text-family artifacts such as .txt, .text, .md, .markdown, or .html files and exposes…