rhwp GUI Agent
Usa este skill para operar rhwp-studio tanto como un editor web orientado a humanos como una GUI controlable por el agente. Prefiere acciones reales de GUI para verificar características; usa el puente ?agent=1 solo para verificar disponibilidad, inspeccionar estado, cargar muestras y verificar exportaciones.
Inicio Rápido
Desde la raíz del repositorio 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
Abre http://127.0.0.1:8765/?agent=1. Sin ?agent=1, el editor funciona para los usuarios pero no expone el puente de automatización.
Flujo de Trabajo Principal
- Compila
pkg/rhwp.jsypkg/rhwp_bg.wasmantes de ejecutar Studio. Sinpm run buildinformaCannot find module '@wasm/rhwp.js', el paquete WASM no se ha compilado. - Sirve la aplicación compilada o ejecuta Vite. Usa
python3 -m http.server ... -d distcuando Vite no pueda enlazar puertos en un entorno aislado. - Inicia una sesión de automatización del navegador contra
/?agent=1. - Usa selectores de GUI para las acciones:
- Menús:
#menu-bar .menu-item[data-menu="<menu>"] .menu-title - Comandos de menú:
[data-cmd="<command-id>"] - Botones de barra de herramientas:
.tb-btn[data-cmd="<command-id>"] - Controles de barra de estilo:
#style-name,#font-lang,#font-name,#font-size,#btn-bold,#btn-italic,#btn-underline,#btn-strike,#btn-text-color,#btn-highlight, botones de alineación y#linespacing-select - Entrada de archivo:
#file-input - Editor de lienzo:
#scroll-container canvas
- Menús:
- Usa
window.__rhwpAgentpara observación:ready()context()commands()pageCount()fileName()loadSample(path)loadBytes(bytes, fileName)createNewDocument()exportHwp(),exportHwpx()
- Captura capturas de pantalla y archivos exportados después de cada grupo de características. Trata los clics fallidos, comandos deshabilitados, errores de consola y lienzos vacíos como fallos de prueba.
Cobertura de Características
Lee references/feature-map.md al enumerar o probar todas las características de la GUI. Allí se mapean los menús de nivel superior, IDs de comandos, diálogos, controles de barra de herramientas y acciones de hwpctl.
Para una ejecución de humo automatizada, usa:
cd rhwp-studio
node e2e/agent-gui-full-smoke.mjs
Si el inicio del navegador está bloqueado por el entorno, ejecuta:
npm run build
Luego revisa e2e/agent-gui-full-smoke.mjs y ejecútalo en un entorno con navegador habilitado.
Estrategia de Pruebas
Usa tres capas:
- Validación de compilación:
docker compose --env-file .env.docker run --rm wasm, luegonpm run build. - Prueba de humo de GUI: crea un nuevo documento, escribe texto, alterna formato de carácter/párrafo, crea una tabla, abre el selector de formas, abre el diálogo de símbolos, carga muestras
.hwpy.hwpx, guarda/descarga.hwpy captura capturas de pantalla. - Verificaciones profundas: ejecuta las pruebas existentes de
rhwp-studio/e2e/*.mjsy escenarios de hwpctl cuando haya un navegador real disponible.
Primero prefiere las muestras integradas:
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
Al descargar muestras HWP/HWPX públicas, guárdalas en rhwp-studio/public/samples/external/, verifica la firma del archivo antes de cargarlo, y registra la URL de origen, el nombre del archivo, el tamaño en bytes y el resultado de la carga.
Reglas del Puente del Agente
Usa el puente para observar el estado y cargar accesorios de prueba repetibles, no para evitar la cobertura de la GUI. Para una afirmación de característica como "la creación de tablas funciona", haz clic en la barra de herramientas/menú y el diálogo. Para una afirmación como "el documento se ha cargado", window.__rhwpAgent.pageCount() es apropiado.
No asumas que un comando está implementado solo porque aparece en HTML. Verifica con src/command/commands/*.ts; algunos elementos del menú son marcadores de posición o están deshabilitados según el contexto.
Fallos Comunes
listen EPERM: usa un servidor estático en un puerto permitido o ejecuta fuera del entorno aislado.- Fallo al iniciar el navegador: ejecuta el script donde la ejecución de Chrome/Chromium esté permitida; establece
CHROME_PATHsi es necesario. - Guardado de HWPX deshabilitado: esperado para documentos de origen HWPX en la ruta beta actual.
- Falta
@wasm/rhwp.js: reconstruye WASM con Docker. - API de acceso al sistema de archivos no disponible en Chrome sin interfaz gráfica: espera el flujo de descarga alternativo.