docs: refresh docs to match the current state, add GUI/CLI/troubleshooting

The README still listed the settings UI as "todo" and its quick start told
users to download models into the working directory; phase 3 still described
the caption window's close button as "quit" and used the wrong binary name.
Bring the docs up to date and fill the gaps: a GUI guide (first run, settings
tabs, tray, download, verify), a full CLI option reference marking the
test-only flags, a troubleshooting page, the model registry's size/sha256
fields plus a licence/size table, the RTF measurement caveat (llama-cli 0.19
vs the in-process 0.56), and a note that the streaming-ONNX backend has its
own code path. phase0/phase1 experiment docs are marked as historical.

文档与现状对齐:README 的 Phase 4 从「待做」改为完成、快速开始不再让人把模型下到当前
目录;phase3 的 ✕ 说明改为「隐藏到托盘」、用法改用 live-caption;新增 GUI/CLI/排错三份
文档;asr-backends 补上注册表的 size/sha256 字段与模型许可/体积表;phase0 补上 RTF 口径
说明(llama-cli 的 0.19 与程序内的 0.56);phase2 补上「流式 ONNX 走另一条分支」的说明。
This commit is contained in:
blumia committed 2026-10-12 17:29:45 +08:00
1 parent 370c869ad0
commit d234b9658d
12 files changed
+512 -57

No files matched your search

+4
View File
@@ -1,5 +1,9 @@
# Phase 0 验证实验
> **历史文档**:Phase 0 的结论仍然有效(本页的数字与 [docs/phase0-verification.md](../../docs/phase0-verification.md) 一致),
> 但当时的脚本是临时实验脚本,现行入口是 GUI(`./build/live-caption`)与
> `./build/live-caption-cli`;模型由注册表 `data/models.json` 管理,见 [docs/cli.md](../../docs/cli.md)。
目标:在动手写 C++/Qt 之前,先证实三个关键假设。
1. **系统播放音频可采集**:默认 sink 的 `monitor` 源能被读到。
+6
View File
@@ -3,6 +3,12 @@
目标:把 `docs/phase0-verification.md` 验证过的链路写成一个真正的 C++/Qt/CMake 项目骨架,并在命令行跑通「采集系统输出 → 实时转写 → 打印」。
UI 悬浮窗留到 Phase 2。
> **历史文档**:这里记的是 Phase 1 当时的样子。代码后来重排成了 `src/core` + `src/ui` +
> `src/models` + `apps/{gui,cli}`,入口是 `./build/live-caption`(图形界面)和
> `./build/live-caption-cli`(命令行);模型改成按注册表 `data/models.json` 取,不再是手工
> 传 `--model`/`--mmproj`。现行用法见 [README](../../README.md) 与
> [docs/cli.md](../../docs/cli.md)。
## 目录
```