rhwp GUI Agent
Nutzen Sie diesen Skill, um rhwp-studio sowohl als menschliches Web-Editor als auch als agentengesteuerte GUI zu bedienen. Bevorzugen Sie echte GUI-Aktionen für Feature-Prüfungen; verwenden Sie die ?agent=1-Brücke nur für Bereitschaftsprüfung, Zustandsinspektion, Laden von Beispielen und Exportverifikation.
Schnellstart
Vom rhwp-Repository-Root aus:
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
Öffnen Sie http://127.0.0.1:8765/?agent=1. Ohne ?agent=1 funktioniert der Editor nur für Benutzer, legt aber die Automatisierungsbrücke nicht offen.
Kernablauf
- Erstellen Sie
pkg/rhwp.jsundpkg/rhwp_bg.wasmvor dem Start von Studio. Wennnpm run build„Cannot find module '@wasm/rhwp.js'“ meldet, wurde das WASM-Paket nicht erstellt. - Stellen Sie die erstellte App bereit oder starten Sie Vite. Verwenden Sie
python3 -m http.server ... -d dist, wenn Vite in einer Sandbox keine Ports binden kann. - Starten Sie eine Browser-Automatisierungssitzung für
/?agent=1. - Verwenden Sie GUI-Selektoren für Aktionen:
- Menüs:
#menu-bar .menu-item[data-menu="<menu>"] .menu-title - Menübefehle:
[data-cmd="<command-id>"] - Toolbar-Schaltflächen:
.tb-btn[data-cmd="<command-id>"] - Stil-Steuerelemente:
#style-name,#font-lang,#font-name,#font-size,#btn-bold,#btn-italic,#btn-underline,#btn-strike,#btn-text-color,#btn-highlight, Ausrichtungsschaltflächen und#linespacing-select - Dateieingabe:
#file-input - Canvas-Editor:
#scroll-container canvas
- Menüs:
- Verwenden Sie
window.__rhwpAgentzur Beobachtung:ready()context()commands()pageCount()fileName()loadSample(path)loadBytes(bytes, fileName)createNewDocument()exportHwp(),exportHwpx()
- Machen Sie Screenshots und exportierte Dateien nach jedem Feature-Cluster. Behandeln Sie fehlgeschlagene Klicks, deaktivierte Befehle, Konsolenfehler und leere Canvase als Testfehler.
Feature-Abdeckung
Lesen Sie references/feature-map.md beim Aufzählen oder Testen aller GUI-Features. Es bildet die Menüs der obersten Ebene, Befehls-IDs, Dialoge, Toolbar-Steuerelemente und hwpctl-Aktionen ab.
Für einen automatisierten Smoke-Test verwenden Sie:
cd rhwp-studio
node e2e/agent-gui-full-smoke.mjs
Wenn der Browserstart durch die Umgebung blockiert wird, führen Sie trotzdem aus:
npm run build
Dann überprüfen Sie e2e/agent-gui-full-smoke.mjs und führen es in einer browserfähigen Umgebung aus.
Teststrategie
Verwenden Sie drei Ebenen:
- Build-Validierung:
docker compose --env-file .env.docker run --rm wasm, dannnpm run build. - GUI-Smoke: Erstellen Sie ein neues Dokument, geben Sie Text ein, schalten Sie Zeichen-/Absatzformatierung um, erstellen Sie eine Tabelle, öffnen Sie den Formauswähler, öffnen Sie den Symboldialog, laden Sie
.hwp- und.hwpx-Beispiele, speichern/laden Sie.hwpherunter und machen Sie Screenshots. - Tiefgehende Prüfungen: Führen Sie vorhandene
rhwp-studio/e2e/*.mjs-Tests und hwpctl-Szenarien aus, wenn ein echter Browser verfügbar ist.
Bevorzugen Sie zuerst integrierte Beispiele:
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
Beim Herunterladen öffentlicher HWP/HWPX-Beispiele speichern Sie diese unter rhwp-studio/public/samples/external/, überprüfen Sie die Dateisignatur vor dem Laden und dokumentieren Sie Quell-URL, Dateiname, Byte-Größe und Ladeergebnis.
Agent-Brückenregeln
Verwenden Sie die Brücke zur Zustandsbeobachtung und zum Laden wiederholbarer Test-Fixtures, nicht zur Umgehung der GUI-Abdeckung. Für eine Feature-Behauptung wie „Tabellenerstellung funktioniert“ klicken Sie auf die Toolbar, das Menü und den Dialog. Für eine Behauptung wie „Das Dokument wurde geladen“ ist window.__rhwpAgent.pageCount() angemessen.
Gehen Sie nicht davon aus, dass ein Befehl implementiert ist, nur weil er in HTML auftaucht. Überprüfen Sie mit src/command/commands/*.ts; einige Menüpunkte sind Platzhalter oder je nach Kontext deaktiviert.
Häufige Fehler
listen EPERM: Verwenden Sie einen statischen Server auf einem genehmigten Port oder führen Sie ihn außerhalb der Sandbox aus.- Browserstart fehlgeschlagen: Führen Sie das Skript aus, wo die Ausführung von Chrome/Chromium erlaubt ist; setzen Sie ggf.
CHROME_PATH. - HWPX-Speichern deaktiviert: Erwartet für HWPX-Quelldokumente im aktuellen Beta-Pfad.
@wasm/rhwp.jsfehlt: Erstellen Sie WASM mit Docker neu.- File System Access API im Headless-Chrome nicht verfügbar: Erwarten Sie den Fallback-Download-Ablauf.