Troubleshoot the first stage whose success variable is missing. A working download proves only that the installer opened; a passing connection test proves only that the configured service answered; neither proves that a host editor can capture and replace text.
Find the failing stage
| Stage | Success variable | If it is missing |
|---|---|---|
| 1. Keyboard or input source | UnimeType appears in the operating-system keyboard picker and can type ordinary characters | Recheck platform setup and permissions |
| 2. Action trigger | Choosing Convert, Polish, or Explain shows an in-progress state or result | Recheck active input source, shortcut setting, Full Access, and AI-processing consent |
| 3. AI service | Test connection succeeds and the selected route has account access or complete provider fields | Recheck sign-in, credits, Base URL, model ID, API key, and network |
| 4. Text capture | The intended selection, sentence, or paragraph is the action target | Select the exact text and retry |
| 5. Validation and replacement | Convert or Polish changes only the intended host range | Keep the source unchanged during the request; select explicitly; check the visible status |
After a successful replacement, the changed text remains in the current app and no separate success label remains.
1. Keyboard or input source is unavailable
iPhone and iPad
Open Settings › General › Keyboard › Keyboards and confirm UnimeType is in the list. Open a text field, hold the globe key, and select UnimeType. If the keyboard appears but AI actions do not start, confirm Allow Full Access and AI-processing consent. See iPhone and iPad setup.
Mac
Confirm UnimeType is installed in Applications, appears in macOS Keyboard settings, and is the selected input source. Caps Lock conversion works only while UnimeType is selected and the corresponding shortcut is enabled.
Windows
Confirm the signed installer completed and UnimeType appears in the Windows input-language menu. Select it before testing Caps Lock or Alt + Enter. If ordinary typing works but a particular editor cannot be replaced, continue at text capture and replacement.
Android
Open the UnimeType app, choose Enable keyboard, enable it in Android input method settings, then use Choose keyboard. Android does not use the iOS Full Access permission.
2. An action does not start
- Tap an on-keyboard action before diagnosing a desktop shortcut. Success means an in-progress state or Explain panel appears.
- If tapping works but a shortcut does not, re-enable that shortcut and confirm UnimeType is the active input source.
- If no AI action starts, grant the AI-processing consent. On iOS, also confirm Allow Full Access.
- Wait for the previous action to finish. UnimeType does not start a second action while one is in flight.
3. AI service or model fails
Open Settings and run Test connection for the selected route.
- For UnimeType Balance, refresh sign-in and balance state. The route needs an account with available service access.
- For Your own API key, re-copy the provider, Base URL, exact model ID, and API key. Your provider must allow that credential to use the model.
- A failed or empty model browser means authenticated
GET /modelsdid not return a usable list. You can still enter a known model ID and test it. - A passing connection test does not prove that Convert will change every input; the model can return unchanged text.
See AI service, models, and credits.
4. Text capture or replacement fails
No convertible input found
Place the caret immediately after newly typed text or select the exact target. An explicit selection overrides automatic sentence and paragraph capture.
Text is inserted instead of replaced
Confirm the original text is still present, select it explicitly, and retry. Editors expose different replacement APIs; selection is the most portable target. macOS-specific host behavior is listed under Mac application compatibility.
Newly appended words are not included
Convert may target only text added after the previous successful conversion. Select the complete paragraph when the full paragraph should be processed again. See Text scope strategy.
Text changed before replacement
Do not edit the target while the request is running. Run the action again on the current text. UnimeType refuses to overwrite a range when the captured source no longer matches.
5. Language or Language Pack result is wrong
Convert chooses the wrong language
Disable unused conversion languages, choose the intended Preferred language, and retry with an explicit selection. English remains preserved, and at most three non-English languages can be enabled. See Input languages.
A Language Pack has no effect
Confirm the pack is both downloaded and enabled, then check that its capability
applies to the current action. A local Chinese shortcut must be a complete
lowercase a–z input, used by itself with Chinese enabled. Knowledge retrieval
and document indexing are not available. See Language Packs.
Messages and next actions
| Message or symptom | What it means | Next action |
|---|---|---|
| Text did not change | The model returned the same structurally valid text | Select a clearer target, add context, or try another model |
| No convertible input found | UnimeType found no selected or newly typed target | Place the caret after the text or select it explicitly |
| The previous action is still processing | Another action has not finished | Wait before starting another action |
| Text changed before replacement | The captured source was edited during the request | Run the action again on the current text |
| This editor requires a text selection | The host cannot replace from the caret-only target | Select the exact text and retry |
| Could not replace the text | The host did not accept the verified replacement | Confirm the source, select it, and retry |
| Network unavailable | The request could not reach the selected service or timed out | Check the connection and retry |
| AI service error | The service response was unusable or local validation rejected it | Test the service, model, and input again |
| Complete AI service setup first | A required service field or managed access state is missing | Complete the selected route in Settings |
| Action cancelled | AI text processing was not allowed | Enable AI-processing consent before using an AI action |
Text did not change, Network unavailable, and AI service error are different outcomes. Unchanged means the route returned usable but identical text. Network unavailable means the route could not be reached. AI service error means the response could not complete the product's service or validation contract.
Report a reproducible issue
Include these observable objects without including private input or credentials:
- Platform and UnimeType version
- Host application name and field type
- Action used and whether text was selected
- Exact visible status message
- Whether ordinary typing, Test connection, and the same action in a plain text editor each succeed
- The shortest non-sensitive example that reproduces the behavior
Internal status identifiers and validator cases are listed separately in the Advanced technical reference. They are diagnostic labels, not user instructions and not proof that another platform has the same failure.