热词管理

1. 新建热词库

1. 点击右上角的 新建热词库 按钮

2. 在弹窗中填写：

   • 名称（必填）——不超过 25 个字符，例如「产品专有名词」

   • 描述（选填）——说明该热词库的用途，方便团队成员识别

3. 在 替换规则 区填写规则，每行一条：左侧为 原词，右侧为 替换文本。点击 添加规则 追加新行，点击行尾垃圾桶图标删除该行

4. 点击 创建

规则较多时，可以用 批量导入 一次性粘贴，见下文「批量导入与备份」。

原词 区分大小写、精确匹配。GitHub 和 github 是两条不同的规则，如需同时覆盖请分别添加。

2. 在代码中使用热词库

创建成功后，悬停在卡片上点击右下角的 复制热词库 ID（形如 3f9a2c1e-7b4d-4e8a-9c0f-1d2e3f4a5b6c），在实时语音合成 WebSocket 的 run-task 指令中通过 parameters.vocabulary_id 引用它：

{
  "header": {
    "action": "run-task",
    "task_id": "<你的任务 ID>",
    "streaming": "duplex"
  },
  "payload": {
    "task_group": "audio",
    "task": "tts",
    "function": "SpeechSynthesizer",
    "model": "<模型名>",
    "parameters": {
      "voice": "<音色 ID>",
      "format": "mp3",
      "vocabulary_id": "3f9a2c1e-7b4d-4e8a-9c0f-1d2e3f4a5b6c"
    },
    "input": {}
  }
}

完整的协议说明见《实时语音合成 WebSocket API》。

如果某次任务需要临时追加或覆盖几条规则，可以同时传入任务级的 parameters.hot_fix.replace：

"parameters": {
  "vocabulary_id": "3f9a2c1e-7b4d-4e8a-9c0f-1d2e3f4a5b6c",
  "hot_fix": {
    "replace": [
      { "Qwen": "通义千问" }
    ]
  }
}

两者按原词合并：同一原词以 hot_fix.replace 为准，其余规则照常生效。

vocabulary_id 只能在 run-task 中指定，任务开始后不能通过 continue-task 更换；continue-task 只能更新 hot_fix.replace 临时规则。

3. 查看详情

点击卡片打开详情面板，可以看到热词库 ID、规则条数、创建与更新时间、描述，以及完整的规则列表（每页 20 条）。面板顶部支持按原词或替换文本搜索；点击右上角 编辑 可直接进入编辑。

4. 编辑

悬停在卡片上点击 编辑，或在详情面板中点击 编辑。可以修改名称、描述和规则，点击 保存 生效。

保存会整体覆盖原有规则，平台不保留历史版本，也无法回滚。规则较多或改动较大时，建议先在详情面板点击 复制全部规则 做一份备份。

保存后，新发起的合成任务会使用新规则（通常在 30 秒内生效）；已经在进行中的任务继续使用开始时的规则，不受影响。

5. 批量导入与备份

在新建 / 编辑弹窗中点击 批量导入，在文本框中粘贴规则，每行一条，格式为：

GitHub=吉特哈布
API=A P I

也可以直接从 Excel 复制两列（原词、替换文本）粘贴进来，系统会按 Tab 自动识别。导入规则：

• 分隔符两侧的空白会被去除，空行自动忽略

• 粘贴内容里同一原词出现多次，以 最后一次 为准

• 与弹窗里已有的规则合并：同原词覆盖替换文本，新原词追加到末尾

• 格式不正确的行会被跳过，并提示具体行号

导入只是填入弹窗，点击 创建 / 保存 后才会真正写入。

需要备份或迁移时，在详情面板点击 复制全部规则，复制出来的内容就是上面的 原词=替换文本 格式，可以原样粘贴回批量导入。

6. 删除

悬停在卡片上点击 删除，二次确认后该热词库 永久删除，不可恢复。

删除后，仍在请求中引用该 ID 的合成任务 不会报错，而是按「没有热词规则」继续合成，因此读音会回到默认效果。请在删除前确认业务侧已不再依赖它。