Status and Troubleshooting

Successful text replacement is already visible in the host, so UnimeType keeps normal status UI quiet. processing, completed, and replacementSent do not display a persistent status label.

Visible abnormal statuses

Internal state	Meaning	Next action
`unchanged`	The final structurally valid model output equals the captured text	Add context, select a narrower target, or try again
`nothingToConvert`	No non-empty selection, paragraph, sentence, or typing buffer was available	Place the caret after newly typed text or select text
`requestInFlight`	Another request or caret replacement is running	Wait for that operation to finish
`textChanged`	Host text, caret evidence, or typing-buffer generation changed during the request	Invoke the action again on the current text
`selectionRequired`	The host cannot replace the captured range and the caret is not at its verified end	Select the exact target and retry
`replacementFailed`	Synthetic replacement, timeout, or read-back verification failed	Confirm the host text, then select and retry
`actionFailed`	Configuration, network, HTTP, decoding, empty-output, reasoning-markup, or structural repair failed	Check service settings and retry; inspect logs if repeated
`setupRequired`	API/service settings are incomplete	Open UnimeType settings and finish setup
`cancelled`	AI-processing consent was declined	Grant consent when you intentionally use an AI action

Common application symptoms

Caps Lock does nothing

Confirm that UnimeType is the selected macOS input source and Caps Lock conversion is enabled. The F20 mapping is intentionally removed when another input source is selected.

Text is inserted instead of replaced

The host likely ignored its document-relative replacement range. Keep the caret at the end of the newly typed text, or explicitly select the target before retrying. See Application Compatibility.

Newly appended words are not included

An accepted-paragraph mark may intentionally send only the appended suffix. If the host text and local typing buffer no longer describe the same suffix, UnimeType cancels rather than deleting an uncertain range. Select the complete paragraph to override automatic scope.

Action failed versus unchanged

An identical but structurally valid final result is unchanged. actionFailed means the action did not produce an acceptable response or could not complete the request. It is not used to classify English or Pinyin locally.