mobridge-mcp 0.8.7 → 0.8.8
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/AI-USAGE.md
CHANGED
|
@@ -150,7 +150,14 @@ The `ad` step is VERIFIED when the ad is closed or there was no ad. If an ad is
|
|
|
150
150
|
- MULTIPLE_DEVICES: with several devices pass `-d ANDROID:<serial>` or run `mobridge device use <serial>`; with exactly one device it is picked automatically and `-d` is not needed.
|
|
151
151
|
- EXTERNAL_INSTRUMENTATION_ACTIVE: Appium/UiAutomator holds Accessibility; stop it, then connect again.
|
|
152
152
|
- WAITING_FOR_USER_ACCESSIBILITY (Android 13+, Xiaomi, Oppo): Settings → Apps → MoBridge Runtime → ⋮ → Allow restricted settings, then enable Accessibility.
|
|
153
|
-
- Recovery: `mobridge daemon restart` (after upgrading the package), `mobridge doctor --restart-adb
|
|
153
|
+
- Recovery: `mobridge daemon restart` (after upgrading the package). Run `mobridge health --preflight` for a verdict (ready, degraded, blocked) and ordered `nextSteps`: `Run:` is one command you may run, `Guidance:` is something only the user can do. `mobridge doctor --fix` previews the safe repair and `--fix --apply` runs it (it only runs `connect` and re-checks). `mobridge doctor --restart-adb --confirm-adb-restart` drops every other adb client on the machine: ask the user first.
|
|
154
|
+
|
|
155
|
+
## Reading failures and repeats
|
|
156
|
+
|
|
157
|
+
- A NodeRef action that fails as STALE_NODE_REF or NODE_NOT_FOUND carries `error.details.targetDiagnosis` {state, reason, evidence}. `moved` and `covered` are proven, `gone` means a complete capture of the same app window held no match, `ambiguous` means several nodes match, `unknown` always names a reason (for example TARGET_OFFSCREEN, WINDOW_OR_PACKAGE_CHANGED, TREE_TRUNCATED). It is information only: re-resolve with your original query, never replay.
|
|
158
|
+
- `observation.treeEvidence.state` is CHANGED, UNCHANGED or UNKNOWN for the accessibility tree (canvas and WebView content is not in it). `screenChanged` means the same tree comparison. `stuck {repeatCount, hint}` appears after the same action hit the same target 3 times in a row with the tree unchanged: observe and change approach.
|
|
159
|
+
- `mobile.run` and `mobridge run --status` list `notRun`: the planned steps after the stop point that never executed. `steps` still means completed steps.
|
|
160
|
+
- `scroll-to` with several scrollable containers of similar size fails with AMBIGUOUS_MATCH; pass `axis` (VERTICAL or HORIZONTAL).
|
|
154
161
|
|
|
155
162
|
## Typed commands (generated from the registry)
|
|
156
163
|
|