docs: tighten clickthrough skill and API guidance

Closes #10
2026-05-01 15:40:38 +02:00
parent 775c188732
commit 1429e90be2
3 changed files with 116 additions and 1 deletions
--- a/README.md
+++ b/README.md
@@ -38,6 +38,11 @@ For OCR support, install the native `tesseract` binary on the host (in addition
 5. `POST /action?screen=0` to execute
 6. `GET /screen?screen=0` again to verify result

+Important:
+- `POST /action` expects an `action` plus a `target` object; do not send raw top-level `x` / `y` fields.
+- Pixel coordinates and OCR bounding boxes are always global desktop coordinates.
+- Prefer structured GUI interaction first; use `/exec` for launch, recovery, or explicit system-level tasks.
+
 See:
 - `docs/API.md`
 - `docs/coordinate-system.md`