OpenTypeless

故障排除

常见问题及解决方案。如果这里找不到你的答案，请在 GitHub 上提交 Issue。

常见问题

快捷键不起作用

检查是否有其他应用占用了相同的快捷键。在 macOS 上，确保 OpenTypeless 已获得辅助功能权限（系统设置 > 隐私与安全性 > 辅助功能）。在 Linux 上，某些桌面环境可能会拦截全局快捷键。

转录不准确

尝试切换到其他 STT 供应商。Deepgram 和 OpenAI Whisper 通常对英语准确率最高。对于中文，试试 GLM-ASR。同时检查系统设置中的麦克风输入音量。

AI 润色改变了我的意思

LLM 会尽量在改善语法和格式的同时保留你的原意。如果改动太大，试试其他 LLM 供应商或在设置中调整润色提示词。

延迟高 / 响应慢

请分别检查 STT 路径和 LLM 路径的延迟。对于每个提供商，请确认端点、API 密钥、地区和网络流量。本地 STT 路径使用 Custom Whisper-compatible 端点；Ollama 仅用于 LLM 路径的文本编辑。如果 Ollama 运行缓慢，请确认设备有足够的内存加载模型。

API 密钥无法使用

确认密钥正确且具有正确的权限。检查你的供应商账户是否已启用计费。某些供应商要求你先充值才能使用密钥。

应用在 Linux 上无法启动

确保已安装 WebKit2GTK。Ubuntu 上：sudo apt install libwebkit2gtk-4.1-0。Fedora 上：sudo dnf install webkit2gtk4.1。