Skip to content
Skills Library
Documents & office · Writing

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.

Licence
MIT
Last repository change
30.10.2026

Assessment and security

95/ 100Class: good
Format20 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
16
Scripts
6
HTML comments
1
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 30.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What to check before installing
  • 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. 1. 最小可用示例
  2. 2. 文件级规则
  3. 3. 说话人写法(任选一种)
  4. 4. 编号、时间码与文件名
  5. 5. 注释、代码块与 Markdown
  6. 6. 不要这样写
  7. 7. Agent 写脚本时的检查清单
  8. 8. 转换示例
  9. 9. 相关文件
Original SKILL.md headings · 134 lines, 318 words
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…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.