rhwp GUI Agent
Utilisez cette compétence pour piloter rhwp-studio à la fois comme un éditeur web destiné aux humains et comme une interface graphique contrôlable par un agent. Privilégiez les actions GUI réelles pour les vérifications de fonctionnalités ; utilisez le pont ?agent=1 uniquement pour la disponibilité, l'inspection d'état, le chargement d'échantillons et la vérification d'exportation.
Démarrage rapide
Depuis la racine du dépôt rhwp :
cp .env.docker.example .env.docker
docker compose --env-file .env.docker run --rm wasm
cd rhwp-studio
npm ci
npm run build
python3 -m http.server 8765 --bind 0.0.0.0 -d dist
Ouvrez http://127.0.0.1:8765/?agent=1. Sans ?agent=1, l'éditeur fonctionne pour les utilisateurs mais n'expose pas le pont d'automatisation.
Flux de travail principal
- Construisez
pkg/rhwp.jsetpkg/rhwp_bg.wasmavant d'exécuter Studio. Sinpm run buildsignaleCannot find module '@wasm/rhwp.js', le package WASM n'a pas été construit. - Servez l'application construite ou exécutez Vite. Utilisez
python3 -m http.server ... -d distlorsque Vite ne peut pas lier les ports dans un environnement cloisonné. - Lancez une session d'automatisation de navigateur vers
/?agent=1. - Utilisez les sélecteurs GUI pour les actions :
- Menus :
#menu-bar .menu-item[data-menu="<menu>"] .menu-title - Commandes de menu :
[data-cmd="<command-id>"] - Boutons de la barre d'outils :
.tb-btn[data-cmd="<command-id>"] - Contrôles de la barre de style :
#style-name,#font-lang,#font-name,#font-size,#btn-bold,#btn-italic,#btn-underline,#btn-strike,#btn-text-color,#btn-highlight, boutons d'alignement et#linespacing-select - Entrée de fichier :
#file-input - Éditeur canvas :
#scroll-container canvas
- Menus :
- Utilisez
window.__rhwpAgentpour l'observation :ready()context()commands()pageCount()fileName()loadSample(path)loadBytes(bytes, fileName)createNewDocument()exportHwp(),exportHwpx()
- Capturez des captures d'écran et les fichiers exportés après chaque groupe de fonctionnalités. Considérez les clics échoués, les commandes désactivées, les erreurs dans la console et les canvass vierges comme des échecs de test.
Couverture des fonctionnalités
Consultez references/feature-map.md lorsque vous énumérez ou testez toutes les fonctionnalités de l'interface graphique. Ce fichier répertorie les menus de haut niveau, les identifiants de commande, les boîtes de dialogue, les contrôles de la barre d'outils et les actions hwpctl.
Pour un test automatisé de base, utilisez :
cd rhwp-studio
node e2e/agent-gui-full-smoke.mjs
Si le lancement du navigateur est bloqué par l'environnement, exécutez tout de même :
npm run build
Ensuite, examinez e2e/agent-gui-full-smoke.mjs et exécutez-le dans un environnement avec navigateur.
Stratégie de test
Utilisez trois niveaux :
- Validation de construction :
docker compose --env-file .env.docker run --rm wasm, puisnpm run build. - Test de base GUI : créez un nouveau document, tapez du texte, basculez le formatage des caractères/paragraphes, créez un tableau, ouvrez le sélecteur de formes, ouvrez la boîte de dialogue des symboles, chargez des échantillons
.hwpet.hwpx, sauvegardez/téléchargez.hwp, et capturez des captures d'écran. - Vérifications approfondies : exécutez les tests existants dans
rhwp-studio/e2e/*.mjset les scénarios hwpctl lorsqu'un véritable navigateur est disponible.
Privilégiez d'abord les échantillons intégrés :
public/samples/basic/KTX.hwp
public/samples/form-002.hwpx
public/samples/BlogForm_BookReview.hwp
public/samples/biz_plan.hwp
public/samples/field-01.hwp
public/samples/footnote-01.hwp
public/samples/number-bullet.hwp
Lors du téléchargement d'échantillons HWP/HWPX publics, sauvegardez-les sous rhwp-studio/public/samples/external/, vérifiez la signature du fichier avant de le charger, et enregistrez l'URL source, le nom du fichier, la taille en octets et le résultat du chargement.
Règles du pont agent
Utilisez le pont pour observer l'état et charger des jeux de test reproductibles, et non pour contourner la couverture de l'interface graphique. Pour une affirmation de fonctionnalité comme « la création de tableaux fonctionne », cliquez sur la barre d'outils/le menu et la boîte de dialogue. Pour une affirmation comme « le document est chargé », window.__rhwpAgent.pageCount() est approprié.
Ne supposez pas qu'une commande est implémentée simplement parce qu'elle apparaît dans le HTML. Vérifiez avec src/command/commands/*.ts ; certains éléments de menu sont des espaces réservés ou désactivés selon le contexte.
Échecs courants
listen EPERM: utilisez un serveur statique sur un port approuvé ou exécutez en dehors de l'environnement cloisonné.- Échec du lancement du navigateur : exécutez le script là où l'exécution de Chrome/Chromium est autorisée ; définissez
CHROME_PATHsi nécessaire. - Sauvegarde HWPX désactivée : attendue pour les documents source HWPX dans le chemin bêta actuel.
@wasm/rhwp.jsmanquant : reconstruisez WASM avec Docker.- API File System Access indisponible dans Chrome headless : attendez-vous à un flux de téléchargement de secours.