wimi321 · wimi321 · May 7, 2026 · May 7, 2026 · May 7, 2026
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
@@ -138,6 +138,16 @@ jobs:
       - name: Typecheck
         run: pnpm typecheck
 
+      - name: Prepare Kokoro TTS assets
+        shell: bash
+        env:
+          GOAGENT_TTS_ASSETS_STRICT: "1"
+          GOAGENT_TTS_SMOKE_STRICT: "1"
+        run: |
+          pnpm prepare:tts-assets
+          pnpm check:tts-assets
+          pnpm smoke:tts
+
       - name: Prepare KataGo assets
         shell: bash
         env:
@@ -333,6 +343,16 @@ jobs:
       - name: Typecheck
         run: pnpm typecheck
 
+      - name: Prepare Kokoro TTS assets
+        shell: bash
+        env:
+          GOAGENT_TTS_ASSETS_STRICT: "1"
+          GOAGENT_TTS_SMOKE_STRICT: "1"
+        run: |
+          pnpm prepare:tts-assets
+          pnpm check:tts-assets
+          pnpm smoke:tts
+
       - name: Prepare NVIDIA KataGo assets
         shell: bash
         env:

diff --git a/.gitignore b/.gitignore
@@ -5,6 +5,7 @@ release
 .DS_Store
 *.log
 .goagent
+.goagent-smoke
 __pycache__
 *.pyc
 coverage
@@ -24,3 +25,7 @@ data/katago/bin/**
 data/katago/models/**
 data/katago/edition.json
 !data/katago/README.md
+
+# Large local Kokoro TTS model files are prepared by scripts for release packaging.
+# Voices and metadata are small enough to version; the ONNX model is not.
+data/tts/kokoro/**/onnx/*.onnx
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -4,6 +4,20 @@ All notable changes to GoAgent will be documented here.
 
 This project follows semantic versioning once public releases begin.
 
+## 0.3.16 - Strict Offline Kokoro TTS
+
+### Added
+
+- Added a strict selected-provider TTS system with bundled Kokoro zh-CN offline synthesis as the default provider.
+- Added teacher answer playback controls and a TTS settings panel.
+- Added custom OpenAI-compatible, HTTP JSON, and local-service TTS providers that only run when explicitly selected.
+- Added Kokoro asset preparation, validation, provider-policy checks, and real strict offline synthesis smoke testing.
+
+### Changed
+
+- Updated release packaging so GitHub Release builds prepare Kokoro ONNX assets before packaging installers.
+- Kept the no-fallback policy: no system voice, no Web Speech, no provider chain, and no automatic provider switching.
+
 ## 0.3.15 - GoAgent Brand Identity
 
 ### Changed

diff --git a/README.md b/README.md
@@ -49,16 +49,16 @@ KataGo 是事实裁判，LLM 是讲棋老师。GoAgent 的目标是让学生不
 
 当前发布版本：
 
-[GoAgent v0.3.15](https://github.com/wimi321/GoAgent/releases/tag/v0.3.15)
+[GoAgent v0.3.16](https://github.com/wimi321/GoAgent/releases/tag/v0.3.16)
 
 | 平台 | 下载 |
 | --- | --- |
-| macOS Apple Silicon | [GoAgent-0.3.15-mac-arm64.dmg](https://github.com/wimi321/GoAgent/releases/download/v0.3.15/GoAgent-0.3.15-mac-arm64.dmg) |
-| macOS Intel | [GoAgent-0.3.15-mac-x64.dmg](https://github.com/wimi321/GoAgent/releases/download/v0.3.15/GoAgent-0.3.15-mac-x64.dmg) |
-| Windows x64 免安装 ZIP | [GoAgent-0.3.15-win-x64-portable.zip](https://github.com/wimi321/GoAgent/releases/download/v0.3.15/GoAgent-0.3.15-win-x64-portable.zip) |
-| Windows x64 安装版 | [GoAgent-0.3.15-win-x64.exe](https://github.com/wimi321/GoAgent/releases/download/v0.3.15/GoAgent-0.3.15-win-x64.exe) |
-| Windows NVIDIA 免安装 ZIP | [GoAgent-0.3.15-win-x64-nvidia-portable.zip](https://github.com/wimi321/GoAgent/releases/download/v0.3.15/GoAgent-0.3.15-win-x64-nvidia-portable.zip) |
-| Windows NVIDIA 安装版 | [GoAgent-0.3.15-win-x64-nvidia.exe](https://github.com/wimi321/GoAgent/releases/download/v0.3.15/GoAgent-0.3.15-win-x64-nvidia.exe) |
+| macOS Apple Silicon | [GoAgent-0.3.16-mac-arm64.dmg](https://github.com/wimi321/GoAgent/releases/download/v0.3.16/GoAgent-0.3.16-mac-arm64.dmg) |
+| macOS Intel | [GoAgent-0.3.16-mac-x64.dmg](https://github.com/wimi321/GoAgent/releases/download/v0.3.16/GoAgent-0.3.16-mac-x64.dmg) |
+| Windows x64 免安装 ZIP | [GoAgent-0.3.16-win-x64-portable.zip](https://github.com/wimi321/GoAgent/releases/download/v0.3.16/GoAgent-0.3.16-win-x64-portable.zip) |
+| Windows x64 安装版 | [GoAgent-0.3.16-win-x64.exe](https://github.com/wimi321/GoAgent/releases/download/v0.3.16/GoAgent-0.3.16-win-x64.exe) |
+| Windows NVIDIA 免安装 ZIP | [GoAgent-0.3.16-win-x64-nvidia-portable.zip](https://github.com/wimi321/GoAgent/releases/download/v0.3.16/GoAgent-0.3.16-win-x64-nvidia-portable.zip) |
+| Windows NVIDIA 安装版 | [GoAgent-0.3.16-win-x64-nvidia.exe](https://github.com/wimi321/GoAgent/releases/download/v0.3.16/GoAgent-0.3.16-win-x64-nvidia.exe) |
 
 发布说明：
 

diff --git a/README_EN.md b/README_EN.md
@@ -49,14 +49,14 @@ KataGo is the source of truth. The LLM is the teacher that turns those facts int
 
 Current release:
 
-[GoAgent v0.3.15](https://github.com/wimi321/GoAgent/releases/tag/v0.3.15)
+[GoAgent v0.3.16](https://github.com/wimi321/GoAgent/releases/tag/v0.3.16)
 
 | Platform | Download |
 | --- | --- |
-| macOS Apple Silicon | [GoAgent-0.3.15-mac-arm64.dmg](https://github.com/wimi321/GoAgent/releases/download/v0.3.15/GoAgent-0.3.15-mac-arm64.dmg) |
-| macOS Intel | [GoAgent-0.3.15-mac-x64.dmg](https://github.com/wimi321/GoAgent/releases/download/v0.3.15/GoAgent-0.3.15-mac-x64.dmg) |
-| Windows x64 portable ZIP | [GoAgent-0.3.15-win-x64-portable.zip](https://github.com/wimi321/GoAgent/releases/download/v0.3.15/GoAgent-0.3.15-win-x64-portable.zip) |
-| Windows x64 installer | [GoAgent-0.3.15-win-x64.exe](https://github.com/wimi321/GoAgent/releases/download/v0.3.15/GoAgent-0.3.15-win-x64.exe) |
+| macOS Apple Silicon | [GoAgent-0.3.16-mac-arm64.dmg](https://github.com/wimi321/GoAgent/releases/download/v0.3.16/GoAgent-0.3.16-mac-arm64.dmg) |
+| macOS Intel | [GoAgent-0.3.16-mac-x64.dmg](https://github.com/wimi321/GoAgent/releases/download/v0.3.16/GoAgent-0.3.16-mac-x64.dmg) |
+| Windows x64 portable ZIP | [GoAgent-0.3.16-win-x64-portable.zip](https://github.com/wimi321/GoAgent/releases/download/v0.3.16/GoAgent-0.3.16-win-x64-portable.zip) |
+| Windows x64 installer | [GoAgent-0.3.16-win-x64.exe](https://github.com/wimi321/GoAgent/releases/download/v0.3.16/GoAgent-0.3.16-win-x64.exe) |
 
 Release caveats:
 

diff --git a/README_JA.md b/README_JA.md
@@ -39,14 +39,14 @@ GoAgent は、KataGo、棋盤スクリーンショット、ローカル知識カ
 
 公開リリース：
 
-[GoAgent v0.3.15](https://github.com/wimi321/GoAgent/releases/tag/v0.3.15)
+[GoAgent v0.3.16](https://github.com/wimi321/GoAgent/releases/tag/v0.3.16)
 
 | プラットフォーム | ダウンロード |
 | --- | --- |
-| macOS Apple Silicon | [DMG](https://github.com/wimi321/GoAgent/releases/download/v0.3.15/GoAgent-0.3.15-mac-arm64.dmg) |
-| macOS Intel | [DMG](https://github.com/wimi321/GoAgent/releases/download/v0.3.15/GoAgent-0.3.15-mac-x64.dmg) |
-| Windows x64 portable ZIP | [ZIP](https://github.com/wimi321/GoAgent/releases/download/v0.3.15/GoAgent-0.3.15-win-x64-portable.zip) |
-| Windows x64 installer | [EXE](https://github.com/wimi321/GoAgent/releases/download/v0.3.15/GoAgent-0.3.15-win-x64.exe) |
+| macOS Apple Silicon | [DMG](https://github.com/wimi321/GoAgent/releases/download/v0.3.16/GoAgent-0.3.16-mac-arm64.dmg) |
+| macOS Intel | [DMG](https://github.com/wimi321/GoAgent/releases/download/v0.3.16/GoAgent-0.3.16-mac-x64.dmg) |
+| Windows x64 portable ZIP | [ZIP](https://github.com/wimi321/GoAgent/releases/download/v0.3.16/GoAgent-0.3.16-win-x64-portable.zip) |
+| Windows x64 installer | [EXE](https://github.com/wimi321/GoAgent/releases/download/v0.3.16/GoAgent-0.3.16-win-x64.exe) |
 
 注意：現在のリリースは未署名です。macOS Gatekeeper や Windows SmartScreen の警告が表示される場合があります。
 

diff --git a/README_KO.md b/README_KO.md
@@ -39,14 +39,14 @@ GoAgent는 KataGo, 바둑판 스크린샷, 로컬 지식 카드, 학생 프로
 
 공개 릴리스:
 
-[GoAgent v0.3.15](https://github.com/wimi321/GoAgent/releases/tag/v0.3.15)
+[GoAgent v0.3.16](https://github.com/wimi321/GoAgent/releases/tag/v0.3.16)
 
 | 플랫폼 | 다운로드 |
 | --- | --- |
-| macOS Apple Silicon | [DMG](https://github.com/wimi321/GoAgent/releases/download/v0.3.15/GoAgent-0.3.15-mac-arm64.dmg) |
-| macOS Intel | [DMG](https://github.com/wimi321/GoAgent/releases/download/v0.3.15/GoAgent-0.3.15-mac-x64.dmg) |
-| Windows x64 portable ZIP | [ZIP](https://github.com/wimi321/GoAgent/releases/download/v0.3.15/GoAgent-0.3.15-win-x64-portable.zip) |
-| Windows x64 installer | [EXE](https://github.com/wimi321/GoAgent/releases/download/v0.3.15/GoAgent-0.3.15-win-x64.exe) |
+| macOS Apple Silicon | [DMG](https://github.com/wimi321/GoAgent/releases/download/v0.3.16/GoAgent-0.3.16-mac-arm64.dmg) |
+| macOS Intel | [DMG](https://github.com/wimi321/GoAgent/releases/download/v0.3.16/GoAgent-0.3.16-mac-x64.dmg) |
+| Windows x64 portable ZIP | [ZIP](https://github.com/wimi321/GoAgent/releases/download/v0.3.16/GoAgent-0.3.16-win-x64-portable.zip) |
+| Windows x64 installer | [EXE](https://github.com/wimi321/GoAgent/releases/download/v0.3.16/GoAgent-0.3.16-win-x64.exe) |
 
 현재 릴리스 패키지는 서명되지 않았으므로 macOS Gatekeeper 또는 Windows SmartScreen 경고가 표시될 수 있습니다.
 

diff --git a/README_TH.md b/README_TH.md
@@ -39,14 +39,14 @@ GoAgent เป็นแอปเดสก์ท็อปแบบ local-first
 
 รุ่นเผยแพร่สาธารณะ:
 
-[GoAgent v0.3.15](https://github.com/wimi321/GoAgent/releases/tag/v0.3.15)
+[GoAgent v0.3.16](https://github.com/wimi321/GoAgent/releases/tag/v0.3.16)
 
 | แพลตฟอร์ม | ดาวน์โหลด |
 | --- | --- |
-| macOS Apple Silicon | [DMG](https://github.com/wimi321/GoAgent/releases/download/v0.3.15/GoAgent-0.3.15-mac-arm64.dmg) |
-| macOS Intel | [DMG](https://github.com/wimi321/GoAgent/releases/download/v0.3.15/GoAgent-0.3.15-mac-x64.dmg) |
-| Windows x64 portable ZIP | [ZIP](https://github.com/wimi321/GoAgent/releases/download/v0.3.15/GoAgent-0.3.15-win-x64-portable.zip) |
-| Windows x64 installer | [EXE](https://github.com/wimi321/GoAgent/releases/download/v0.3.15/GoAgent-0.3.15-win-x64.exe) |
+| macOS Apple Silicon | [DMG](https://github.com/wimi321/GoAgent/releases/download/v0.3.16/GoAgent-0.3.16-mac-arm64.dmg) |
+| macOS Intel | [DMG](https://github.com/wimi321/GoAgent/releases/download/v0.3.16/GoAgent-0.3.16-mac-x64.dmg) |
+| Windows x64 portable ZIP | [ZIP](https://github.com/wimi321/GoAgent/releases/download/v0.3.16/GoAgent-0.3.16-win-x64-portable.zip) |
+| Windows x64 installer | [EXE](https://github.com/wimi321/GoAgent/releases/download/v0.3.16/GoAgent-0.3.16-win-x64.exe) |
 
 หมายเหตุ: รุ่นนี้ยังไม่ได้ signed/notarized บน macOS และยังไม่ได้ code-signed บน Windows จึงอาจมีคำเตือนจากระบบปฏิบัติการ
 

diff --git a/README_VI.md b/README_VI.md
@@ -39,14 +39,14 @@ GoAgent là ứng dụng desktop local-first cho người học và giáo viên
 
 Bản phát hành công khai:
 
-[GoAgent v0.3.15](https://github.com/wimi321/GoAgent/releases/tag/v0.3.15)
+[GoAgent v0.3.16](https://github.com/wimi321/GoAgent/releases/tag/v0.3.16)
 
 | Nền tảng | Tải xuống |
 | --- | --- |
-| macOS Apple Silicon | [DMG](https://github.com/wimi321/GoAgent/releases/download/v0.3.15/GoAgent-0.3.15-mac-arm64.dmg) |
-| macOS Intel | [DMG](https://github.com/wimi321/GoAgent/releases/download/v0.3.15/GoAgent-0.3.15-mac-x64.dmg) |
-| Windows x64 portable ZIP | [ZIP](https://github.com/wimi321/GoAgent/releases/download/v0.3.15/GoAgent-0.3.15-win-x64-portable.zip) |
-| Windows x64 installer | [EXE](https://github.com/wimi321/GoAgent/releases/download/v0.3.15/GoAgent-0.3.15-win-x64.exe) |
+| macOS Apple Silicon | [DMG](https://github.com/wimi321/GoAgent/releases/download/v0.3.16/GoAgent-0.3.16-mac-arm64.dmg) |
+| macOS Intel | [DMG](https://github.com/wimi321/GoAgent/releases/download/v0.3.16/GoAgent-0.3.16-mac-x64.dmg) |
+| Windows x64 portable ZIP | [ZIP](https://github.com/wimi321/GoAgent/releases/download/v0.3.16/GoAgent-0.3.16-win-x64-portable.zip) |
+| Windows x64 installer | [EXE](https://github.com/wimi321/GoAgent/releases/download/v0.3.16/GoAgent-0.3.16-win-x64.exe) |
 
 Lưu ý: bản phát hành hiện chưa được ký và notarize trên macOS, cũng chưa được code-sign trên Windows, vì vậy hệ điều hành có thể hiển thị cảnh báo bảo mật.
 

diff --git a/data/tts/kokoro/zh-CN/LICENSE b/data/tts/kokoro/zh-CN/LICENSE
@@ -0,0 +1,9 @@
+Kokoro-82M-v1.1-zh-ONNX source notice
+
+Model repository: onnx-community/Kokoro-82M-v1.1-zh-ONNX
+License stated by upstream model card: Apache-2.0
+Default model file: onnx/model_int8.onnx
+
+This directory is a release asset target. The large ONNX and voice files are
+prepared by scripts/prepare_tts_assets.mjs and should be verified by
+scripts/check_tts_assets.mjs before release packaging.
diff --git a/data/tts/kokoro/zh-CN/MODEL_CARD.md b/data/tts/kokoro/zh-CN/MODEL_CARD.md
@@ -0,0 +1,15 @@
+# Kokoro Chinese ONNX bundle
+
+GoAgent bundles a local Kokoro Chinese ONNX voice pack for offline teacher speech.
+
+- Upstream model: `onnx-community/Kokoro-82M-v1.1-zh-ONNX`
+- License: Apache-2.0 as stated by the upstream model card
+- Default quantized model: `onnx/model_int8.onnx`
+- Expected model SHA256: `58b9b997faeaf42b427bac24c8a6246b236b0561311f6b118318cd9d2f47acb1`
+
+Large binary assets are not stored in ordinary source patches. Run:
+
+```bash
+pnpm prepare:tts-assets
+pnpm check:tts-assets
+```
diff --git a/data/tts/kokoro/zh-CN/config.json b/data/tts/kokoro/zh-CN/config.json
@@ -0,0 +1,3 @@
+{
+  "model_type": "style_text_to_speech_2"
+}
diff --git a/data/tts/kokoro/zh-CN/manifest.json b/data/tts/kokoro/zh-CN/manifest.json
@@ -0,0 +1,21 @@
+{
+  "id": "kokoro-zh-cn-int8",
+  "provider": "kokoro-bundled",
+  "language": "zh-CN",
+  "modelRepo": "onnx-community/Kokoro-82M-v1.1-zh-ONNX",
+  "modelRevision": "6cc0f0d2ebe369a68b0df87c2b65c1af8c0ac3e3",
+  "modelFile": "onnx/model_int8.onnx",
+  "modelSha256": "58b9b997faeaf42b427bac24c8a6246b236b0561311f6b118318cd9d2f47acb1",
+  "runtimeModelFile": "onnx/model_quantized.onnx",
+  "runtimeModelSha256": "a39469be791eeaa3089c1ed5e58b8731d1f2462ea0e7dae2bc44388e58f973d8",
+  "modelSizeMb": 127,
+  "license": "Apache-2.0",
+  "offline": true,
+  "bundled": true,
+  "defaultVoiceId": "zf_001",
+  "voices": [
+    { "id": "zf_001", "label": "中文女声 001", "file": "voices/zf_001.bin", "sha256": "0a89ec12bb93fb9c74077924daf02568baad64e1f869389f5aaee01a386035f8" },
+    { "id": "zm_009", "label": "中文男声 009", "file": "voices/zm_009.bin", "sha256": "7b74d6ed22f201e2fa28758e78ce6197082779f2b80e69ea1bf877908609514a" }
+  ],
+  "sourcePolicy": "Bundled Kokoro provider must use this selected local asset only. No automatic provider switch is allowed."
+}
diff --git a/data/tts/kokoro/zh-CN/onnx/.gitkeep b/data/tts/kokoro/zh-CN/onnx/.gitkeep