A3Boy/codex-voice-input
GitHub: A3Boy/codex-voice-input
一款非官方的 Windows 浮动语音输入工具，复用本地 Codex 登录凭证实现无需 API Key 的语音转文字功能。
Stars: 2 | Forks: 0
Codex Voice Input
Windows 原生浮动语音输入工具，复用本机 Codex 登录进行语音转文字。
中文 · English
# 中文
Codex Desktop 会把语音录音发送到 `https://chatgpt.com/backend-api/transcribe` 并返回文本。Codex Voice Input 将这个流程实现为一个 Windows 浮动输入胶囊：按下全局快捷键开始录音，再次按下完成识别，然后把结果写入当前光标位置。
## 适合谁用
- 已在 Codex Desktop 或 Codex CLI 登录 ChatGPT
- 希望在任意 Windows 输入框中使用 Codex 语音转文字
- 不想配置 OpenAI API Key 或单独购买转写 API
- 接受逆向接口可能变化，需要跟随 Codex 更新
## 安装
### PowerShell 一行安装
```
powershell -ExecutionPolicy Bypass -c "irm https://github.com/A3Boy/codex-voice-input/releases/latest/download/install.ps1 | iex"
```
安装脚本会下载 Windows x64 ZIP、校验 `SHA256SUMS.txt`，安装到 `%LOCALAPPDATA%\Programs\CodexVoiceInput`，创建桌面快捷方式并启动应用。
### 直接下载
从 [最新 GitHub Release](https://github.com/A3Boy/codex-voice-input/releases/latest) 下载 `CodexVoiceInput-win-x64.zip`，解压后运行 `CodexVoiceInput.exe`。
## 快速上手
1. 安装并登录 Codex Desktop/CLI，确认 `%USERPROFILE%\.codex\auth.json` 存在。
2. 启动 Codex Voice Input。
3. 按 `Ctrl+Alt+Space` 开始录音，再按一次停止并转写。
4. 预览识别结果后点击输入，或点击复制按钮。
设置页可以即时切换麦克风、全局快捷键和深色模式。快捷键必须包含至少一个修饰键和一个普通按键，例如 `Ctrl+Alt+K`。
## 功能
- WinUI 3 + Win32 透明分层胶囊窗口
- 实时麦克风音量驱动的多层动态波形
- Codex 自动语言识别，无需 OpenAI API Key
- 识别结果预览、复制、历史记录与当前焦点输入
- 左右屏幕边缘吸附和竖向折叠
- 麦克风与全局快捷键即时切换
- 完成、失败或取消后自动删除临时录音
- 深色模式、托盘菜单和开机启动脚本
## 认证模型与隐私
应用默认读取 `%USERPROFILE%\.codex\auth.json` 中当前用户的 Codex 登录令牌，并直接向 ChatGPT 转写端点发送录音。
- 不会把令牌复制到应用配置、日志、历史或 Release 包
- 不会把录音发送到项目作者控制的服务器
- 临时 WAV 在完成、失败或取消后自动删除
- 不要在 Issue 中上传 `auth.json`、个人录音或未经清理的日志
完整说明见 [SECURITY.md](SECURITY.md)。
## 已知边界
- 仅支持 Windows 10 2004+ / Windows 11 x64
- 需要 .NET 8 Desktop Runtime
- 需要本机有效的 Codex 登录与可用订阅
- 转写端点、认证格式或请求头可能无预告变化
- 当前不是完整 TSF 输入法，文本通过 Win32 `SendInput` 写入当前焦点
## 从源码构建
需要 Visual Studio 2022 或 Build Tools，安装 `.NET desktop development`、`Desktop development with C++`、Windows SDK 和 .NET 8 SDK。
```
.\build.ps1 -Configuration Debug
.\run.ps1
```
运行测试与打包：
```
dotnet run --project .\tests\HotkeyContract\HotkeyContract.csproj
Get-ChildItem .\scripts\test-*-contract.ps1 | ForEach-Object { & $_.FullName }
.\package.ps1
```
本地数据：
- 配置：`%LOCALAPPDATA%\CodexVoiceInput\config.json`
- 识别历史：`%LOCALAPPDATA%\CodexVoiceInput\history.json`
- 日志：`%LOCALAPPDATA%\CodexVoiceInput\codex-voice-input.log`
- 临时录音：`%TEMP%\CodexVoiceInput`
## 技术来源
认证与转写技术路线参考并致谢 [Wangnov/codex-asr](https://github.com/Wangnov/codex-asr)。本项目不是 Rust 包装器，也不依赖 `codex-asr` 可执行文件；桌面应用和请求逻辑使用 C# 独立实现。许可证信息见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。
# English
Codex Voice Input 是一款非官方的 Windows 浮动语音输入胶囊。它复用当前用户的本地 Codex 认证，录制麦克风音频，调用逆向工程的 Codex Desktop 转写端点，预览结果，并将其输入到当前聚焦的控件中。
## 环境要求
- Windows 10 2004+ 或 Windows 11 x64
- .NET 8 Desktop Runtime
- 位于 `%USERPROFILE%\.codex\auth.json` 的本地 Codex Desktop/CLI 登录凭证
- 有效的 Codex 订阅以及对 `chatgpt.com` 的网络访问权限
## 安装
```
powershell -ExecutionPolicy Bypass -c "irm https://github.com/A3Boy/codex-voice-input/releases/latest/download/install.ps1 | iex"
```
安装程序在替换 `%LOCALAPPDATA%\Programs\CodexVoiceInput` 之前会校验 Release 的 SHA-256 校验和。
## 安全边界
认证信息保留在本地机器上，并且仅发送至 ChatGPT 转写端点。本项目不运营任何中继服务器。请勿在 GitHub Issue 中附带 Codex 认证文件、私人音频、识别历史或原始日志。
## 免责声明
这不是官方的 OpenAI API 或产品。端点和认证行为可能会随时更改。Codex Voice Input 不隶属于 OpenAI，也未获得其认可或赞助。
## 许可证
[MIT](LICENSE)。有关上游归属，请参见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。
标签：云资产清单, 桌面应用, 语音转文字, 辅助输入工具, 逆向工程