← Tous les manuels · Portail
↗ Ouvrir l'app

Clic-Guide — MANUAL

Outil de guidage de clic a distance. Matt ouvre une capture d'ecran dans le

navigateur, pose des reperes la ou il faut cliquer (avec le type d'interaction

et une note), valide, et l'AIOS recupere les coordonnees exactes en pixels de

l'image d'origine. Sert a corriger/piloter le bot Dofus (et tout autre besoin

"montre-moi ou cliquer") a distance.

URL / service / port

  • - URL publique : https://clic.panelbay.com
  • - Port local : 8348
  • - Service systemd : aios-clic-guide.service (Restart=always, enable on boot)
  • - Racine : /root/workspace/apps/clic-guide/backend

    • Architecture

  • - app.py — backend Flask (sert la page, les images, gere annotations).
  • - static/index.html — UI (une page, vanilla JS, tactile + souris).
  • - data/screenshots/ — les captures poussees.
  • - data/shots.json — meta par capture (label, taille, date).
  • - data/annotations.jsonl — une ligne JSON par validation (historique).

    • Endpoints

  • - GET / — la page d'annotation.
  • - GET /img/<name> — sert une capture.
  • - GET /api/shots — liste des captures + derniere annotation de chacune.
  • - POST /api/annotate — {image, points:[{x,y,type,note}], note} → append jsonl.
  • - GET /api/health — {ok, shots}.

    • Boucle d'usage (cote AIOS)

    1. Pousser une capture pour Matt :

    ```bash

    python3 backend/push_shot.py <image.png> --name "slug.png" --label "Texte lisible"

    ```

    2. Matt ouvre https://clic.panelbay.com, clique/glisse ses reperes, choisit le

    type (clic gauche/droit/double/marcher dessus/survol/autre), ajoute une note,

    valide.

    3. Lire ce qu'il a valide :

    ```bash

    python3 backend/read_annotations.py # dernier par image

    python3 backend/read_annotations.py --image slug.png # une image

    python3 backend/read_annotations.py --since <ts> # nouveautes depuis ts

    python3 backend/read_annotations.py --all # historique complet

    ```

    Les coordonnees x,y sont en pixels de l'image d'origine (ex: 1920x1080),

    directement utilisables pour un clic bot.

    Details UI

  • - Clic/tap sur l'image = ajoute un repere numerote. Glisser un repere = ajuster.
  • - Plusieurs reperes = une sequence ordonnee (clic 1 puis 2...).
  • - Le mapping ecran→pixels image se fait via naturalWidth/Height (precis meme

    • quand l'image est reduite a l'ecran ou sur mobile).

    Pieges / notes

  • - Pas d'authentification : URL publique. Contenu peu sensible (captures de jeu).

    • Si besoin d'un jour restreindre, ajouter un token simple en query.

  • - Le service ne redemarre pas tout seul si app.py change :

    • systemctl restart aios-clic-guide.

  • - Les captures poussees restent dans data/screenshots/ (nettoyer a la main si

    • ca s'accumule).

    CHANGELOG

  • - 2026-09-15 : creation. Backend Flask + UI annotation tactile, service systemd

    • 8348, expose sur clic.panelbay.com. Seed avec 2 maps Bonta Bouchers

    (-32,-50 et -30,-50) pour localiser le zaapi du HDV alchimiste.