Windows 上配置 OpenTypeless：安装、热键与文字插入
Typeless 已有官方 Windows 应用。本指南设置的是独立产品 OpenTypeless，用于桌面听写。先在普通文字输入框中测试一句短句，再验证你日常使用的应用。使用官方 Typeless 的用户应查看其自己的下载与设置文档。
开始前需要准备什么
准备可用的麦克风、Windows 桌面应用和一条可用的语音转文字（STT）路径。BYOK 需要所选提供商的凭证与账户权限。MIT 桌面许可、提供商用量费用和托管服务套餐分别计算。本地路径需要另外运行兼容服务，并确认机器资源足够。
1. 下载并打开 Windows 版本
从项目下载页选择适合机器的 Windows 发布文件，安装后先打开一次 OpenTypeless，再配置全局快捷键。升级已有安装时，保留配置并查看发布说明，避免导入来源不明的安装包或配置。
2. 检查麦克风权限与输入
Windows 11 在“设置 > 隐私和安全性 > 麦克风”中检查权限，Windows 10 在“设置 > 隐私 > 麦克风”中检查。打开可用的麦克风访问和桌面应用访问开关，再到“系统 > 声音 > 输入”选择实际使用的麦克风，确认输入音量指示条会随说话变化。没有声音时先检查静音开关与耳机连接。
3. 配置语音转写路径
在语音识别设置中选择受支持的提供商，填写该路径要求的 key、模型和端点，先测试连接，再听写一句不含敏感内容的短句。鉴权或额度错误应检查提供商配置；空录音应检查麦克风。使用本地 STT 时，需要配置 Custom Whisper-compatible 端点，并确保兼容服务已运行。
4. 配置并核对 AI 润色
使用 AI 润色时，需要单独配置并测试 LLM 提供商。比较原始转写与润色结果，核对专名、数字、否定表达、代码标识符和原意。本地润色可以配置 Ollama，但本地 LLM 不会把云端 STT 自动变成本地路径。需要确认处理去向时，应同时检查音频与文字两条端点。 本地语音转写使用已运行的 Custom Whisper-compatible STT 端点；Ollama 是单独的本地 LLM 润色路径。
5. 测试热键与录音模式
在热键设置中，以当前安装版本显示的快捷键与录音模式为准，测试按住、松开或再次按下是否按配置开始和停止录音。遇到冲突时更换组合、保存，并在编辑器或浏览器获得焦点后重试。快捷键在应用里有效，不代表文字一定能插入其他应用。
6. 逐个验证应用中的文字插入
先聚焦一个空的普通文字输入框，听写一句短句，检查文字是否进入目标位置、是否意外替换选区，并测试撤销。再到浏览器表单、日常编辑器或聊天应用中重复测试。转写成功却未插入时，检查焦点、输入框是否可编辑、所选插入模式，以及应用权限级别是否不同。不要连续向没有焦点的窗口重试。
首次听写失败时怎样排查
- 没有音频：检查 Windows 输入音量指示条、麦克风选择、静音开关和桌面应用麦克风权限。
- 热键没有反应：检查已保存的组合、录音模式、快捷键冲突与注册错误。
- 转写报错：检查所选路径、凭证、端点、模型可用性、额度和网络连接。
- 润色报错或改变原意：先检查独立的 LLM 连接并对比原始转写，再调整提示词或模型。
- 已有文字但没有插入：检查当前输入框与插入设置，在简单文字框中复测，以区分目标应用问题。
设置完成的检查清单
- 所选麦克风能录到一句短句，并能按预期结束录音。
- STT 返回可读转写；如果开启润色，结果保持原意。
- 保存的快捷键能在常用应用里工作，不触发冲突动作。
- 文字进入正确的输入框，选区和撤销行为已核对。
- 已确认音频与文字的处理端点，以及提供商或托管套餐的用量费用。