98 lines
1.9 KiB
Markdown
98 lines
1.9 KiB
Markdown
# Validacion en entorno limpio (OpenCode)
|
|
|
|
Objetivo: verificar que `opencode-browser-tool` puede instalarse y usarse desde cero en una maquina con OpenCode.
|
|
|
|
## Alcance de la validacion
|
|
|
|
- Instalacion de dependencias y Chromium gestionado por Playwright.
|
|
- Compilacion del servidor MCP.
|
|
- Conexion MCP visible para OpenCode.
|
|
- Ejecucion de una prueba minima end-to-end.
|
|
|
|
## Prerrequisitos
|
|
|
|
- Node.js 20+ y npm.
|
|
- OpenCode CLI instalado y funcional.
|
|
- Acceso a internet para instalar dependencias y Chromium.
|
|
|
|
## Pasos
|
|
|
|
1) Copiar el proyecto completo en una carpeta local, por ejemplo:
|
|
|
|
```bash
|
|
cp -R opencode-browser-tool "$HOME/opencode-browser-tool"
|
|
```
|
|
|
|
2) Instalar:
|
|
|
|
```bash
|
|
cd "$HOME/opencode-browser-tool"
|
|
./install.sh
|
|
```
|
|
|
|
Alternativa neutral:
|
|
|
|
```bash
|
|
npm run setup
|
|
```
|
|
|
|
3) Verificacion basica:
|
|
|
|
```bash
|
|
./check.sh
|
|
```
|
|
|
|
4) Configurar MCP para OpenCode con la ruta local real de `dist/server.js`:
|
|
|
|
```json
|
|
{
|
|
"$schema": "https://opencode.ai/config.json",
|
|
"mcp": {
|
|
"browser-tool": {
|
|
"type": "local",
|
|
"command": [
|
|
"node",
|
|
"/ABSOLUTE/PATH/opencode-browser-tool/dist/server.js"
|
|
]
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
5) Comprobar que OpenCode detecta el MCP:
|
|
|
|
```bash
|
|
opencode mcp list
|
|
```
|
|
|
|
Resultado esperado: `browser-tool` aparece como `connected`.
|
|
|
|
6) Prueba minima desde OpenCode:
|
|
|
|
- abrir navegador visible
|
|
- navegar a `https://example.com`
|
|
- tomar snapshot con label `clean-env-smoke`
|
|
- cerrar navegador
|
|
|
|
7) Verificar artifacts:
|
|
|
|
- Debe existir una captura en `artifacts/`.
|
|
|
|
## Criterios de aceptacion
|
|
|
|
- `install.sh` termina sin error.
|
|
- `npm run build` termina sin error.
|
|
- `opencode mcp list` muestra `browser-tool` conectado.
|
|
- La prueba minima produce screenshot en `artifacts/`.
|
|
|
|
## Resultado de la ejecucion
|
|
|
|
Rellenar al completar la validacion real:
|
|
|
|
- Fecha:
|
|
- Equipo/SO:
|
|
- Version Node:
|
|
- Version OpenCode:
|
|
- Resultado: pendiente | ok | fallo
|
|
- Evidencia (capturas/logs):
|
|
- Notas:
|