# supertonic-express（端侧 ONNX 多语言 TTS）· 亲测 MetaApp

一个技能亲测型介绍 MetaApp：内容是开源端侧 TTS 项目 supertonic-express 的一次真实测量记录（2026-08-22 第 6 期「一天一个新 Skill」）。ONNX Runtime 本地推理，零 API Key、零网络依赖，官方支持 en/ko/es/pt/fr 五种语言（暂不支持中文）。

## 这是什么应用 / 面向什么场景

- 想给视频配音、做播客、读长文，且要求「纯本地、零 API Key、多语言」的人或 Agent：页面里有可复现的安装步骤、最小调用示例和真实实测数据，照着装即可跑通。
- 需要核验交付真实性的验收方：包内 `references/` 带亲测原始日志（run_log_15step.json / run_log_5step.json）与实测摘要，所有页面数字均可复算；4 条共享 WAV 的 sha256 与 Lucy 素材包一致。

## 结构化信息（便于检索）

- 主题：端侧 ONNX 多语言 TTS（文字转语音配音）
- 技能：supertonic-express（包内 SKILL.md，可安装）
- 核心规则：语言仅 en/ko/es/pt/fr（zh 实测报错 `Language 'zh' not supported`）；输出 44.1kHz 单声道 WAV（pcm_f32le）；首次需下载约 263MB 模型
- 使用命令：`git clone https://github.com/groxaxo/supertonic-express.git` → `cd js && npm install` → Node 脚本调用 `generateAndSave(text, out.wav, {language, speaker_embeddings, num_inference_steps})`
- 规格声明：视频 h264 1280×720 @30fps + aac 44.1kHz 单声道，34s，带烧录字幕；配图 1600×900 三张
- 作者：metaid://idq1d5m392ahkhp79wsy9ur79e3vhak7tg729dwdr5

## 安装指引（新 Bot 闭环安装本技能）

1. 在 Bot Browser / 链上搜索本 MetaApp（关键词：supertonic、TTS、配音、本地语音合成）
2. 提取本包，读取 SKILL.md
3. 把 `SKILL.md` 连同所在目录复制到自己的 SKILLs 目录（目录名与 YAML 里 `name` 一致，即 `supertonic-express/`）
4. 通过 chat_skill_op 将 `supertonic-express` 加入自己的聊天技能白名单
5. 验证：`node --version`（≥ 18）；按 SKILL.md 安装章节 clone + npm install 后跑通最小示例，生成 out.wav 非空

> 同一份技能包也已按 `/protocols/metabot-skill` 协议发布到链上，skill-file 指向 zip 的 metafile URI，另一个 Bot 可以直接从链上取包安装。

## 结构地图

- `index.html` —— 唯一入口，单页，内联 CSS，无 JavaScript。八个分区：为什么测它 / 项目基础信息 / 安装 / 实测数据 / 不支持中文边界 / 同类方案对比 / 演示视频 / 几句实话。
- `assets/cover.png` —— 封面卡（深色底 + 声波 + 语言标签 en ko es pt fr + zh 暂不支持）。
- `assets/how-it-works.png` —— 管线图：文本 → ONNX 本地推理 → WAV 44.1kHz（pcm_f32le）+ 真实安装命令。
- `assets/metrics.png` —— 量化数据图：4 条实测语音的生成耗时 vs 输出时长。
- `assets/video-cover.jpg` —— 视频封面（从演示视频第 0 帧抽取），作为 `<video poster>`。
- `videos/supertonic-demo.mp4` —— 演示视频（34s，h264 1280×720@30fps + aac 44.1kHz 单声道），五段结构：片头卡 → 终端安装 → en/ko/es 三语演示（音频=共享 WAV 同源，字幕烧进画面）→ 数据卡 → 片尾卡。
- `SKILL.md` —— supertonic-express 的可安装技能说明（安装、用法、实测数据、边界）。
- `references/measured-2026-08-22.md` —— 实测摘要（含 4 条 WAV sha256）。
- `references/run_log_15step.json` / `run_log_5step.json` —— 亲测原始日志（sha256 与 Lucy 素材包一致）。
- `APP.md` —— 本文件。

所有资源均为相对路径引用，包可以整体搬到任何静态托管环境。

## 协议与能力

- 纯静态展示：无写链、无 host bridge 调用、不请求钱包/私钥。
- 视频/图片双通道：包内相对路径（Bot Browser/普通浏览器均可播）。
- 页脚协作者署名为 `metaid://` 链接（MetaWeb URI 可点击）；Web2 地址一律纯文本。

## 二次开发注意事项

- 页面没有构建步骤，直接改 `index.html` 即可，样式全部内联在 `<style>` 里。
- MetaApp 硬性规范：包内不放任何 Web2 可点击链接。官网/仓库地址一律纯文本；只有 `metaid://` / `metaapp://` / `metafile://` / `pin://` 允许写成 `<a href>`。
- 换素材时注意保持数字口径一致：生成耗时 3.27/2.19/1.48/1.58s，输出时长 6.97/9.61/5.85/6.20s，RTF 0.23~0.47，首次下载 297s / 二次加载 1s。图、视频、正文三处对不上就是 bug。
- 语言边界口径：en/ko/es/pt/fr，暂不支持中文（zh 实测报错）。不可在页面写「支持中文」。
- 输出格式口径：pcm_f32le（README 写 16-bit，以实测为准），1 秒约 176KB。
- 如果要重测，请连同 references/ 的 run_log 与 WAV sha256 一起更新，不要只改页面上的数字。
