# PrivateVoice

PrivateVoice 是一款离线语音转文字桌面 App：按住快捷键说话，松开后本地识别并输入到当前应用。当前源码位于 `C1.source/privatevoice.src`。

![PrivateVoice](K3.运营与发布资料/screenshot.png)

## 当前迁移基线

- 分支：`codex/x-asr-experiment-2.1.29`
- Commit：`0ffbf1935c9d091cce22a5583275ac0902f7a693`
- Tag：`v2.2.0-build20260702.0303-real-user-test`
- 包类型：真实用户测试候选包，不是 notarized 官网正式发布包。
- 迁移后源码根：`C1.source/privatevoice.src`
- 最新候选包本地路径：`C2.builds/PrivateVoice-Dictation-2.2.0-build20260702.0303/`

## 核心能力

- 完全离线识别，模型本地推理。
- 长按说话与短按自由说话两种输入模式。
- 自定义快捷键、麦克风选择、录音音效、录音计时、Esc 取消。
- 剪贴板保护、识别历史、用户词库、语气词过滤和中英混合文本后处理。
- macOS 本地签名 DMG、Windows amd64 preview ZIP。
- 当前 Round 6 已新增独立 `粤语` 语言选项，默认模型为 `SenseVoice Yue 2025-09-09`。

## 语言与模型状态

| 输入语言 / 场景 | 当前支持状态 | 默认 / 可选模型 | 说明 |
| --- | --- | --- | --- |
| 中文 | 正式支持 | 默认 SenseVoice；可选 Qwen3-ASR；实验 X-ASR zh-en 960ms | 中文听写和中英混输主路径。 |
| 粤语 | 真实用户测试候选 | 默认 SenseVoice Yue 2025-09-09 | 独立语言 profile：`yue-HK`，engine 参数固定 `yue`。 |
| English | 正式支持 | 默认 Moonshine English；可选 Parakeet English；实验 X-ASR zh-en 960ms | 英文听写主路径。 |
| French / German / Spanish / Italian / Portuguese | 正式支持 | Parakeet TDT v3 | 欧洲五语离线识别。 |
| Japanese | 正式支持 | Zipformer Japanese | 日语专项模型。 |
| Korean | 正式支持 | Zipformer Korean | 韩语专项模型。 |
| Windows preview | 技术预览 | SenseVoice only | 非 SenseVoice 模型可见但禁用；Windows 包未签名。 |

## 开发入口

```bash
cd /Users/ar/Projects/PrivateVoice2/03-O/C1.source/privatevoice.src
npm --prefix frontend run build
go test ./...
```

常用打包和 QA 命令见 `CODEGRAPH.md`、`K2.项目管理/QA地图.md` 和 `K2.项目管理/发布地图.md`。

## 目录

```text
03-O/
├── C1.source/privatevoice.src/   源码根
├── C2.builds/                    本地迁移的最新候选包，二进制包不纳入 Git 提交
├── C3.tools/                     工具索引
├── K1.业务知识/                  成果地图和长期业务/技术知识
├── K2.项目管理/                  QA、发布、迁移、handoff、legacy 资料
├── K3.运营与发布资料/            当前运营资料索引和本地素材
└── CODEGRAPH.md                  人工工程地图
```