UnimeType 文档状态与故障排查
每一种异常状态、对应变量和下一步操作。
成功替换已经能在宿主文本中直接看到，因此 UnimeType 不持续显示正常状态。
processing、completed 和 replacementSent 都保持静默。
可见异常状态
| 内部状态 | 含义 | 下一步 |
|---|---|---|
unchanged | 最终结构有效的模型结果与捕获文本相同 | 增加上下文、选择更精确范围或重试 |
nothingToConvert | 没有可用的非空选区、段落、句子或输入缓冲 | 把光标放在新输入文本末尾，或明确选中文本 |
requestInFlight | 另一个请求或光标替换正在执行 | 等待当前操作结束 |
textChanged | 请求期间宿主文本、光标证据或输入缓冲版本发生变化 | 对当前文本重新执行操作 |
selectionRequired | 宿主无法替换捕获范围，且光标不在已验证末尾 | 精确选中目标后重试 |
replacementFailed | 合成替换、超时或回读验证失败 | 确认宿主文本后选中目标并重试 |
actionFailed | 配置、网络、HTTP、解码、空输出、推理标记或结构修复失败 | 检查服务设置并重试；反复出现时查看日志 |
setupRequired | API 或服务设置不完整 | 打开 UnimeType 设置并完成配置 |
cancelled | 用户拒绝了 AI 处理许可 | 主动使用 AI 操作时授予许可 |
常见应用症状
Caps Lock 没有反应
确认当前 macOS 输入源是 UnimeType，并且已启用 Caps Lock 转换。切换到其他输入源时， F20 映射会按设计移除。
文本只插入，没有替换
宿主可能忽略了文档相对替换范围。保持光标位于刚输入文本末尾，或明确选中目标后 重试。详见应用兼容性。
新追加的文字没有被包含
已接受段落标记可能有意只发送追加后缀。如果宿主文本和本地输入缓冲无法证明它们 描述同一个后缀，UnimeType 会取消，而不是删除不确定的范围。明确选中完整段落可覆盖 自动范围。
操作失败与内容未变化
最终结果结构有效但与原文相同，对应 unchanged。actionFailed 表示请求未完成或
没有得到可接受响应；它不会用于本地区分英文和拼音。