README
实时翻译麦克风与系统语音，译文可写入 VRChat Chatbox 或经虚拟声卡送入游戏麦克风；默认可用本地 Whisper。
特性
- 双向实时翻译：麦克风与系统回环分路识别；支持文字模式（Chatbox）和 VRChat 语音模式（TTS 经虚拟声卡输出）
- 麦克风语音增强：对用户输入语音做降噪与自动增益（AGC），提升语音识别准确率；可在「音频设备」页切换 WebRTC / RNNoise / 关闭；实现与开源选型说明见 docs/speech-preprocessing.md
- 多服务可选：翻译、语音识别、语音合成均可选择公共免费、云端或本地模型，并支持 OpenAI 兼容接口
- 本地模型：Whisper、MiniCPM5-1B、Kokoro-82M 等常用模型软件内一键安装、删除和测试；下载均校验大小与 SHA-256
- 桌面与 VR 字幕：桌面悬浮窗支持拖动、拉伸、置顶或固定，可永久显示或按设定秒数自动隐藏；可选用 SteamVR 头显字幕
- 说话人标签：本地聚类或云端 speaker ID
- VRChat 集成：Chatbox、MuteSelf 联动
- 隐私与安全：API Key 与自定义请求头经 DPAPI 加密；云端 ASR 明确授权后才会上传音频
- 日志：应用内查看，并写入磁盘
快速开始
自 Releases 获取安装包或便携包：
| 类型 | 文件 | 说明 |
|---|---|---|
| 安装包 | Setup-VoxLink-x.x.x.exe | 安装至 %LOCALAPPDATA%\Programs\VoxLink（当前用户，无需管理员） |
| 便携包 | VoxLink-win-x64.zip | 解压后运行 VoxLink.exe |
均含 .NET 运行时与 Windows App SDK。未代码签名，首次运行可能触发 SmartScreen。
默认仅采集麦克风，系统回环关闭，以免 TTS 回灌。需识别其他玩家语音时，在「音频设备」启用系统回环。
虚拟声卡（语音模式）
VRChat OSC 不承载音频，语音模式需第三方虚拟声卡：
- 安装 VB-CABLE 或 Voicemeeter
- VoxLink「VRChat」页：「语音输出」选
CABLE Input等播放设备 - VRChat
Settings > Audio > Microphone：选对应录音端（如CABLE Output）
设置页
| 页面 | 内容 |
|---|---|
| 实时翻译 | 模式、语言、第二目标语言、最新消息、手动输入 |
| 会话记录 | 本次运行期间的全部实时翻译与手动输入 |
| 音频设备 | 采集源、设备路由、断句、麦克风语音增强（WebRTC / RNNoise 可切换） |
| VRChat | Chatbox、语音路由、MuteSelf、字幕 |
| 模型服务 | 翻译、语音识别、语音合成各选一个服务；设置弹窗与下拉选择一一对应（标题带服务名），密钥、协议和高级参数按需打开 |
| 本地模型 | 按语音识别、翻译、语音合成分类的常用模型一键安装列表；实验性模型收进「更多模型」折叠区；安装后即可「测试」 |
| 高级设置 | 会话行为（仅转写说明）、快捷键、窗口外观、本地模型存储位置（可用系统文件夹选择器） |
| 关于 | 版本、更新、运行状态 |
| 日志 | 运行日志 |
快捷键：Ctrl+Alt+Space 开始/停止，Ctrl+Alt+Enter 翻译当前输入。变更采集设备后需重新开始会话。
本地模型支持
VoxLink 内置常用模型的一键部署：Whisper base / large-v3-turbo、SenseVoice、FireRedASR2-CTC（中英混合准确率最高）、MiniCPM5-1B、Kokoro-82M。安装后会校验文件大小与 SHA-256；模型与运行时默认保存在 %LOCALAPPDATA%\VoxLink，可在「高级设置」中通过系统文件夹选择器改为其他磁盘位置，以减少 C 盘空间占用。
构建
环境：Windows 10 2004+ x64、.NET 10 SDK。
dotnet build VoxLink.slnx -c Release
dotnet test tests/VoxLink.Tests/VoxLink.Tests.csproj -c Release
依赖真实 Whisper / WASAPI / VRChat / SteamVR / 云服务的测试需 VOXLINK_RUN_LIVE_TESTS=1（默认 mock，无需 API Key）。
发布：
powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts/publish.ps1
输出目录 artifacts/release/（含 ZIP、安装包及校验和；首次执行会下载 Inno Setup 便携版）。
贡献
Issue 与 Pull Request 均可。较大改动请先开 Issue。
- 提交：
类型(范围): 描述（feat / fix / docs / refactor / test / chore） - 版本：有发布意义时更新
Directory.Build.props中的<Version> - 发布：标签
vX.Y.Z触发 CI 构建 Release（标签必须与项目版本一致，否则 CI 拒绝发布）
技术栈
WinUI 3、Windows App SDK 2.3.1；独立 Engine（.NET 10、WASAPI、Whisper.net、sherpa-onnx、多路 ASR/翻译/TTS、VRChat OSC、OpenVR 字幕）。见 docs/architecture.md。
限制
- 免密翻译与在线 TTS 无 SLA，受网络与配额影响
- 系统回环为混音，说话人 ID 无法对应 VRChat 用户名
- Chatbox 有长度与发送频率限制；语音模式依赖虚拟声卡，不经 OSC 传音频
- 桌面字幕为无边框悬浮窗，可置顶或关闭置顶；头显字幕仅 SteamVR / OpenVR
许可证
MIT License。第三方组件见 THIRD-PARTY-NOTICES.md。
Similar repos
Languages
C#
93.3%
Python
2.0%
HTML
1.7%
PowerShell
1.3%
CSS
1.1%
README
实时翻译麦克风与系统语音，译文可写入 VRChat Chatbox 或经虚拟声卡送入游戏麦克风；默认可用本地 Whisper。
特性
- 双向实时翻译：麦克风与系统回环分路识别；支持文字模式（Chatbox）和 VRChat 语音模式（TTS 经虚拟声卡输出）
- 麦克风语音增强：对用户输入语音做降噪与自动增益（AGC），提升语音识别准确率；可在「音频设备」页切换 WebRTC / RNNoise / 关闭；实现与开源选型说明见 docs/speech-preprocessing.md
- 多服务可选：翻译、语音识别、语音合成均可选择公共免费、云端或本地模型，并支持 OpenAI 兼容接口
- 本地模型：Whisper、MiniCPM5-1B、Kokoro-82M 等常用模型软件内一键安装、删除和测试；下载均校验大小与 SHA-256
- 桌面与 VR 字幕：桌面悬浮窗支持拖动、拉伸、置顶或固定，可永久显示或按设定秒数自动隐藏；可选用 SteamVR 头显字幕
- 说话人标签：本地聚类或云端 speaker ID
- VRChat 集成：Chatbox、MuteSelf 联动
- 隐私与安全：API Key 与自定义请求头经 DPAPI 加密；云端 ASR 明确授权后才会上传音频
- 日志：应用内查看，并写入磁盘
快速开始
自 Releases 获取安装包或便携包：
| 类型 | 文件 | 说明 |
|---|---|---|
| 安装包 | Setup-VoxLink-x.x.x.exe | 安装至 %LOCALAPPDATA%\Programs\VoxLink（当前用户，无需管理员） |
| 便携包 | VoxLink-win-x64.zip | 解压后运行 VoxLink.exe |
均含 .NET 运行时与 Windows App SDK。未代码签名，首次运行可能触发 SmartScreen。
默认仅采集麦克风，系统回环关闭，以免 TTS 回灌。需识别其他玩家语音时，在「音频设备」启用系统回环。
虚拟声卡（语音模式）
VRChat OSC 不承载音频，语音模式需第三方虚拟声卡：
- 安装 VB-CABLE 或 Voicemeeter
- VoxLink「VRChat」页：「语音输出」选
CABLE Input等播放设备 - VRChat
Settings > Audio > Microphone：选对应录音端（如CABLE Output）
设置页
| 页面 | 内容 |
|---|---|
| 实时翻译 | 模式、语言、第二目标语言、最新消息、手动输入 |
| 会话记录 | 本次运行期间的全部实时翻译与手动输入 |
| 音频设备 | 采集源、设备路由、断句、麦克风语音增强（WebRTC / RNNoise 可切换） |
| VRChat | Chatbox、语音路由、MuteSelf、字幕 |
| 模型服务 | 翻译、语音识别、语音合成各选一个服务；设置弹窗与下拉选择一一对应（标题带服务名），密钥、协议和高级参数按需打开 |
| 本地模型 | 按语音识别、翻译、语音合成分类的常用模型一键安装列表；实验性模型收进「更多模型」折叠区；安装后即可「测试」 |
| 高级设置 | 会话行为（仅转写说明）、快捷键、窗口外观、本地模型存储位置（可用系统文件夹选择器） |
| 关于 | 版本、更新、运行状态 |
| 日志 | 运行日志 |
快捷键：Ctrl+Alt+Space 开始/停止，Ctrl+Alt+Enter 翻译当前输入。变更采集设备后需重新开始会话。
本地模型支持
VoxLink 内置常用模型的一键部署：Whisper base / large-v3-turbo、SenseVoice、FireRedASR2-CTC（中英混合准确率最高）、MiniCPM5-1B、Kokoro-82M。安装后会校验文件大小与 SHA-256；模型与运行时默认保存在 %LOCALAPPDATA%\VoxLink，可在「高级设置」中通过系统文件夹选择器改为其他磁盘位置，以减少 C 盘空间占用。
构建
环境：Windows 10 2004+ x64、.NET 10 SDK。
dotnet build VoxLink.slnx -c Release
dotnet test tests/VoxLink.Tests/VoxLink.Tests.csproj -c Release
依赖真实 Whisper / WASAPI / VRChat / SteamVR / 云服务的测试需 VOXLINK_RUN_LIVE_TESTS=1（默认 mock，无需 API Key）。
发布：
powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts/publish.ps1
输出目录 artifacts/release/（含 ZIP、安装包及校验和；首次执行会下载 Inno Setup 便携版）。
贡献
Issue 与 Pull Request 均可。较大改动请先开 Issue。
- 提交：
类型(范围): 描述（feat / fix / docs / refactor / test / chore） - 版本：有发布意义时更新
Directory.Build.props中的<Version> - 发布：标签
vX.Y.Z触发 CI 构建 Release（标签必须与项目版本一致，否则 CI 拒绝发布）
技术栈
WinUI 3、Windows App SDK 2.3.1；独立 Engine（.NET 10、WASAPI、Whisper.net、sherpa-onnx、多路 ASR/翻译/TTS、VRChat OSC、OpenVR 字幕）。见 docs/architecture.md。
限制
- 免密翻译与在线 TTS 无 SLA，受网络与配额影响
- 系统回环为混音，说话人 ID 无法对应 VRChat 用户名
- Chatbox 有长度与发送频率限制；语音模式依赖虚拟声卡，不经 OSC 传音频
- 桌面字幕为无边框悬浮窗，可置顶或关闭置顶；头显字幕仅 SteamVR / OpenVR
许可证
MIT License。第三方组件见 THIRD-PARTY-NOTICES.md。
Similar repos
Languages
C#
93.3%
Python
2.0%
HTML
1.7%
PowerShell
1.3%
CSS
1.1%