本地语音输入模式无需账号或订阅。支持简体中文 / English 界面、语音转文字、可选 AI 润色、翻译和语音问答。
1.3.0 源码预览版：支持 Windows x64 和 Apple Silicon Mac。 Windows 输入支持仍需在实际目标应用中验证。当前需要自行安装运行依赖；不是开箱即用、已公证的安装包。
- 点击按钮或使用全局快捷键录音，尝试将文字插回开始录音前的输入框与光标位置。
- 快捷键通过直接按组合键设置，支持冲突提示。
- 默认快速听写；需要时开启本地 AI 润色。中文听写输出简体中文，翻译遵循指定目标语言。
- 录音计时、取消、历史记录、原文复制、词典和诊断信息复制。
- 本地 Whisper Large v3 Turbo / Small 语音识别与 Qwen3 4B 文本处理，本地模式不使用远程推理服务；可选 Codex 润色需要联网。
自动插入依赖目标应用提供的 macOS 辅助功能或 Windows UI Automation 信息，不能保证覆盖所有输入框。输入框关闭、内容变化或无法恢复光标时，请从历史记录复制结果。密码输入框不支持自动插入。
默认“优先准确”会选择已安装的 Whisper Large v3 Turbo Q5（新增约 574 MB）；旧安装没有该文件时仍可使用 Small。运行 npm run models:download 获取模型，打包时会一并包含。在设置中可以选择 Small 节省内存。
主要说中文、夹杂英文术语时，将“识别语言”设为“中文”，避免短句被自动判断成其他语言；纯英文使用 English。专有名词可加入词典；“添加开发常用词”可一次加入 API、bug、inventory、leaderboard 等词语。Codex 润色也会参考词典，选择联网润色时词典提示会与转录一同发送。识别与润色是两个独立步骤，润色不能保证找回漏识别的信息。
node scripts/evaluate-speech.js 可在 macOS 用合成中文样例对比 Small 和 Turbo；这只是可复现的冒烟测试，不代表真实口音或噪声下的准确率。
安装新版 Codex CLI 并执行 codex login，在设置中开启“润色听写”，将“润色引擎”设为“Codex · 联网”并保存。此选项仅影响听写；翻译和问答仍使用本地 Qwen。
语音仍由本地 Whisper 识别，转录文本通过 codex exec 发送到 OpenAI，使用现有 Codex 登录与可用额度。这不是离线模型，也不是调用 Codex 桌面内置语音。CLI 使用独立临时目录、临时会话和只读沙箱，不加载用户配置；保留原始转录，失败时不自动插入。无需复制登录令牌或填写 API Key。
macOS 支持 Homebrew 或 PATH 中的 codex；其他安装位置可通过 REATYPELESS_CODEX 指定原生可执行文件路径。Windows 需要可直接执行的 codex.exe，暂不自动运行 npm 的 .cmd 包装器。近期 CLI 才支持所用参数；出现不支持参数错误时请升级 CLI。润色可改善口头语和标点，但无法可靠还原漏识别的信息。
需要 Windows 10/11 x64、Node.js 22.12+ 和系统自带 Windows PowerShell 5.1。
npm ci
npm run build:native
npm run models:download
npm start依赖与模型安装完成后，可以双击 start-windows.cmd 启动。
启动前安装 Windows 版 whisper-cli.exe、ffmpeg.exe；润色、翻译、问答还需要 llama-server.exe。工具来源为 whisper.cpp、FFmpeg 和 llama.cpp 各自的官方项目。工具及其配套 DLL 应保留在同一目录，可加入 PATH，或分别放入项目下 runtime/whisper-cli/、runtime/ffmpeg/、runtime/llama-server/。不要只复制 exe 而遗漏 DLL。
也可以在启动应用的 PowerShell 中指定路径：
$env:REATYPELESS_WHISPER_CLI = 'C:\Tools\whisper\whisper-cli.exe'
$env:REATYPELESS_FFMPEG = 'C:\Tools\ffmpeg\bin\ffmpeg.exe'
$env:REATYPELESS_LLAMA_SERVER = 'C:\Tools\llama\llama-server.exe'
npm start在 Windows 设置 → 隐私和安全性 → 麦克风中允许桌面应用访问。无需 macOS 辅助功能授权。外部应用请先点击目标输入框，再使用全局快捷键，或切回主窗口点击开始；Windows 版会记住最近的外部输入框与光标。使用 UI Automation 恢复支持的输入框及选区，内容变化、焦点恢复失败、密码框或不支持的控件不会自动插入。插入后会核对控件内容；无法确认时提示检查结果，不会自动重试。如未插入，从历史记录复制。以管理员身份运行的应用可能拒绝普通权限进程插入。
npm test 包含 Windows 助手通信和繁简转换测试。安装模型和工具后，npm run test:integration 使用 Windows 自带英文语音合成验证转写，不读取麦克风。npm run dist:win 输出 dist/win-unpacked/REATypeless.exe，包含模型和 runtime/ 下的工具及 DLL；通过 PATH 或环境变量找到的外部工具不会自动打包。当前是未签名目录包，不是安装程序。Windows 数据保存在 %APPDATA%/reatypeless/。
需要 Apple Silicon Mac、Node.js 22.12+、Xcode Command Line Tools 和安装于 /opt/homebrew 的 Homebrew。
xcode-select --install
brew install whisper-cpp llama.cpp ffmpeg
git clone https://github.com/gnuser/REATypeless.git
cd REATypeless
npm ci
npm run models:download
npm run build:native
npm start模型下载约 3.1 GB，需要连接 Hugging Face；脚本校验 SHA-256，已验证的文件不会重复下载。模型不包含在 Git 仓库中，各自许可证见 第三方说明。首次运行与模型加载可能较慢。
在系统设置中允许麦克风和辅助功能权限，然后回到目标输入框。开发模式的权限归属可能显示为 Electron；打包后为 REATypeless。界面语言和快捷键均在设置中修改并保存。
macOS 运行依赖优先支持 runtime 目录和环境变量，也从 /opt/homebrew/bin/whisper-cli、/opt/homebrew/bin/llama-server 和 /opt/homebrew/bin/ffmpeg 加载，并支持 PATH。仅复制应用到另一台电脑仍需安装这些依赖。
npm test
npm run test:native
npm run test:integration
npm run distnpm test 检查核心逻辑、快捷键和录音流程，不需要模型。原生测试需要 macOS 和 Swift。集成测试使用系统合成语音，不打开麦克风，需要完整模型和运行依赖。
打包命令自动构建原生辅助程序和图标，输出在 dist/，并包含本地模型。当前构建未进行 Apple Developer ID 签名与公证。本仓库不提供经过跨机器验证的二进制发行版。面向普通用户的便携安装包、Windows 安装程序和 Intel Mac 验证仍待开发。
在设置中查看或修改当前快捷键；按一次开始录音，再按一次停止。Escape 可取消。关闭主窗口后应用仍留在菜单栏，使用“退出”完全关闭。
音频在本地临时处理，正常处理结束后删除。识别文本、历史记录和设置保存在 Electron 用户数据目录（通常为 ~/Library/Application Support/reatypeless/），没有额外加密。Ask 模式可以读取选中的文字。自动插入可能使用系统剪贴板。模型下载和依赖安装需要联网，本地模式推理在本机执行；选择 Codex 润色后，转录文本会发往 OpenAI。
提交问题时请先检查诊断内容，不要附上私人录音、完整历史记录、密码或密钥。简短测试步骤见 TESTING.txt。
Electron 已固定为 43.8.0。当前 npm audit 仍可能报告打包工具经 global-agent → roarr → sprintf-js 引入的中等级别拒绝服务问题；它们属于开发/打包依赖，没有打入应用源码的运行依赖中。不要将不可信格式字符串交给这些工具；后续将随上游修复更新锁文件。
欢迎提交 issue 和 pull request。请提供系统版本、芯片类型、目标应用、复现步骤与预期结果；涉及光标插入的改动请同时验证按钮和全局快捷键。提交前运行适用测试，不要提交模型、录音、用户数据、生成文件或第三方应用文件。
本项目采用 MIT License。这是独立实现，与 Typeless 无隶属或赞助关系；不包含其源码、商标素材或服务凭据。第三方模型及工具不受本项目 MIT 许可证覆盖。
REATypeless is a local voice dictation app with English / Simplified Chinese UI, configurable recorded shortcuts, optional AI polishing, translation, and spoken questions. Local mode requires no account or subscription. Optional Codex polishing sends transcript text to OpenAI using your CLI login and quota. Whisper Large v3 Turbo (or Small) handles speech recognition; Qwen3 4B handles text generation on your computer.
Source preview for Windows x64 and Apple Silicon macOS. Windows requires Windows builds of whisper-cli, FFmpeg, and optionally llama-server in PATH or the runtime directory. Use npm run build:native and npm start; package with npm run dist:win. On Windows, focus the destination first, then start with a shortcut or return to the main window to record. Unsupported inputs fall back to History. Intel Mac has not been validated. Install Node.js 22.12+, Xcode Command Line Tools, and Homebrew in /opt/homebrew, then follow the commands above. Downloading models requires approximately 3.1 GB. Grant microphone and accessibility permissions before use.
Automatic insertion depends on the target app's accessibility support. If insertion cannot be confirmed, retrieve the result from History. Recordings are processed locally; saved transcripts are not encrypted. Dependency and model downloads require internet access. Packaged apps still require the external Homebrew runtimes and are not notarized. This repository is an independent MIT-licensed implementation, not affiliated with Typeless; third-party components retain their own licenses.