Files
MohZhuang 0d74a1097d feat(v1.3.0): 新增火山引擎语音合成 2.0 作为可选配音引擎
流水线开跑前先问用户用哪个 TTS。两引擎产出的 audio-manifest.json
结构完全一致,故 timeline_build / subs / 渲染器零改动。

新增
- scripts/tts_volcano.py  接口包,唯一读 tts.env 的地方。零第三方依赖
                          (只用标准库 urllib),HTTP Chunked 单向流式,
                          与 edge-tts「发一次收一串」形态同构
- scripts/tts_setup.py    向导:选方案 → 配密钥 → 测连接 → 选音色,
                          输出 NEXT_ACTION=… 供智能体识别
- tts.env.example         密钥模板(真实 tts.env 已 gitignore)
- references/volcano-tts.md  密钥纪律 / 配置步骤 / 接口规格 / 音色表 / 排查表

安全
- Key 只存 tts.env,只有 tts_volcano.py 读它;异常过脱敏,只抹本次实际
  加载的密钥值与 AKLT… 形态,刻意不用「长字符串即密钥」的宽规则
- check_integrity.py 新增密钥防线检查(含「疑似把模板改名」提示)
- package_skill.py 排除 .env / .key / .pem,修掉一个真实外泄口

修复(真机联调暴露,均只在实跑时复现)
- enable_subtitle 必须显式开启,否则 words 恒为空数组且完全不报错,
  下游会静默退回按字数插值、字幕开始飘
- usage 挂在结束标记那一行,提前 continue 导致计费恒为 0
- 缓存未存首裁量,命中缓存时 lead_cut_sec=0,重跑字幕比首跑晚一帧
- CLI 把中文音色名原样当 speaker 发出,服务端报 resource ID mismatched

文档
- README 中英双语新增「配音:两个引擎」章节,按用户要求不写命令
  (那是智能体的职责),只讲「会问你什么 / 你唯一要动手的地方」
- 疑难排查补 6 条火山症状;lessons 34 → 56 条;流水线图加 tts_setup 节点
2026-09-23 10:04:13 +08:00

57 lines
1.1 KiB
Plaintext

# ---------- Python ----------
__pycache__/
*.py[cod]
*.egg-info/
.pytest_cache/
.venv/
venv/
# ---------- Node ----------
# playwright-core is a dependency, not vendored source.
# Install it with: bash setup_env.sh --install
node_modules/
# ---------- Distribution bundles ----------
dist/
# ---------- Secrets ----------
# 火山引擎(豆包)TTS 的 API Key 只存在 tts.env 里,永不入库。
# ★ 这个文件是密钥的唯一入口;agent 不需要、也不应该读取它 ——
# scripts/tts_volcano.py 会自己读。模板见 tts.env.example(那个是入库的)。
tts.env
*.env
!*.env.example
secrets/
*.key
*.pem
# ---------- Per-project runtime artifacts ----------
# html-explainer generates these inside a *video project* directory.
# Ignored here so a demo project created inside the repo never gets committed.
out/
audio/
render/
research/
script/
qc_frames/
qc_report.md
qc_sheet.jpg
*.beats.js
*.mp4
*.mp3
*.wav
*.srt
*.vtt
*.log
# ---------- OS / editor ----------
.DS_Store
Thumbs.db
desktop.ini
.vscode/
.idea/
*.swp
# ---------- Local-only scratch ----------
.skilldev/