5 步快速自检表
| 阶段 | 正常表现 | 异常时的解决办法 |
|---|---|---|
| 1. 键盘与输入法启用 | 系统输入法菜单里能看到 UnimeType，且能正常敲出英文字母 | 对照安装、启用与快捷键检查系统键盘设置 |
| 2. 触发动作 | 点击 Convert / Polish / Explain 或按 Caps Lock（ChromeOS 按右 Alt 或 Alt + Enter）后开始处理 | 检查当前是否已切到 UnimeType、iOS 是否开启“允许完全访问”以及应用内 AI 授权 |
| 3. AI 服务连接 | 在 UnimeType 设置页点击 测试连接 显示成功 | 检查账号登录与积分余额，或核对自定义 Base URL、Model ID、API Key 与网络 |
| 4. 文本范围读取 | 预期的短句、段落或选区被识别为处理目标 | 先手动选中要处理的文字，再触发动作 |
| 5. 原地替换写回 | Convert 或 Polish 成功替换输入框中的目标文字 | 按下转换后先等出字再继续打字；遇到特殊编辑器时先选中文字再重试 |
常见可见状态提示说明
| 界面状态提示 | 为什么会出现 | 怎么解决 |
|---|---|---|
| 请选择要转换的文字（Select text to convert.） | 当前软件不支持自动读取或直接替换光标前的段落 | 先用鼠标拖拽或 Shift + 方向键 选中那句话，再按 Convert 或 Polish |
| 文字已变化，请重试（Text changed. Try again.） | 在等待 AI 返回结果的期间，你又继续打字或改了输入框内容 | 按下转换后稍等半秒，待文字替换完成后再敲下一句 |
| 文字替换失败，请重试（Text replacement failed. Try again.） | 当前目标软件拒绝或打断了写回动作 | 手动选中要处理的词句后重新按一次 Convert 或 Polish |
| 这次没有新结果（No new conversion found） | 点击 Another（换一个） 时，该短语没有其他合理的同音候选 | 选中更完整的句子以提供更多上下文，或直接改一下拼音拼写 |
| 需要完成设置（Setup required） | 尚未开启 iOS“允许完全访问”、未确认 AI 处理授权，或未配置 AI 服务 | 打开 UnimeType 主应用完成配置，并点击 测试连接 |
| 需要更新 UnimeType（Update UnimeType） | 当前客户端版本过旧，不再兼容最新服务端协议 | 前往下载中心或应用商店升级到最新版本 |
| 网络不可用（Network unavailable） | 请求超时或设备当前断网 | 检查网络连接或代理设置后重试 |
| AI 服务错误（AI service error） | 模型服务商报错、API Key 无效，或账号积分余额已用完 | 前往AI 服务、模型与积分检查积分余额或自定义 API Key 设置 |
为什么按了转换没弹任何提示，文字也没变？
在以下两种正常情况下，UnimeType 不会弹窗报错打扰你：
一种情况是当前没有可转的文字：比如输入框是空的、光标停在密码框或只读区域里，或者你在终端、VS Code 里打字中途挪过光标导致连续按键记录清空了。这时只要重新连续敲一句新话，或者先用鼠标选中已有的文字再按转换即可。
另一种情况是原文不需要改动：比如你敲的本来就是通顺的英文，或者已经是目标文字了。如果你本来想转成某种语言却没反应，去输入语言与混输里看一眼是不是忘了勾选那门语言。
各平台高频问题处理
iPhone 与 iPad：能打字，但点 Convert / Polish / Explain 没反应
- 打开系统 设置 › 通用 › 键盘 › 键盘 › UnimeType，确认 允许完全访问 已开启。
- 打开 UnimeType 主应用，确认已同意 AI 处理提示，并在 AI 服务 页面点击 测试连接。
Mac / Windows / Linux：按 Caps Lock 只是切换大小写或切走了输入法，没有触发转换
- 看一眼屏幕右上角菜单栏或任务栏右下角，确认当前正在用的输入法确实是 UnimeType（而不是系统自带的 ABC 或美式英文键盘）。
- Mac 用户必查：打开 系统设置 › 键盘 › 文字输入 › 输入法 › 编辑… › 所有输入法，确认已关掉 “使用大写锁定键（或中/英键）切换‘上次使用的拉丁输入法’”，防止 macOS 先把
Caps Lock抢走。 - 打开 UnimeType 设置，确认已开启 使用 Caps Lock 触发 Convert，或试试备选快捷键
Option + Return（Mac）/Alt + Enter（Windows、Linux）。 - ChromeOS 用户提示：ChromeOS 端触发 Convert 的快捷键是 右
Alt（Right Alt） 或Alt + Enter，不用Caps Lock。
为什么按 Convert 只转了段落最后新敲的几个词？
当你对某一段话运行过一次 Convert、接着又在这段末尾继续敲新词时，UnimeType 默认只转你新追加的那几个词，以免把你前面已经确认好的句子重改一遍。如果你想让整段话从头重转，先全选这段话再按 Convert 即可。
短词被转成了别的语言怎么办？
打开 UnimeType 设置 › 语言，把你平时用不到的转换语言关掉，再把最常用的那门语言设为 首选语言（Primary Language），短音节撞车时就会优先按你的主力语言来解。