---
title: "Limitaciones y restricciones"
description: "Comprende las limitaciones y restricciones de Verdent"
---
### Lo que aprenderás
Limitaciones conocidas de Verdent for VS Code, incluidas las restricciones de formatos de archivo, las limitaciones de las herramientas y las consideraciones específicas de cada plataforma.
---
## Limitaciones conocidas
### Archivos binarios no compatibles
Las herramientas de archivos de Verdent solo funcionan con formatos basados en texto. Los siguientes no se pueden editar:
| Tipo de formato | Ejemplos |
| --------------------- | ------------------------------ |
| **Imágenes** | PNG, JPG, GIF, SVG (como binario) |
| **Videos** | MP4, AVI, MOV |
| **Código compilado** | EXE, DLL, SO |
| **Archivos comprimidos** | ZIP, TAR, GZ |
| **Documentos de Office** | DOCX, XLSX, PPTX |
| **PDF** | Archivos PDF |
**Solución alternativa:** Los archivos binarios pueden referenciarse en el código o tratarse conceptualmente, pero las modificaciones requieren herramientas externas.
### Límites de líneas de file_read
**Limitación:**
- Los archivos grandes (\>10.000 líneas) deben leerse por secciones
- Leer archivos grandes completos puede agotar el contexto
**Solución:** Usa rangos de líneas: `file_read("file.js", start_line=100, max_lines=50)`
---
### Tiempos de espera de comandos bash
**Limitación:**
- Tiempo de espera máximo: 120 segundos (2 minutos)
- Las operaciones de larga duración se terminan automáticamente
**Solución:** Divide las operaciones en comandos más pequeños que se completen en menos de 2 minutos
---
### Rendimiento de búsqueda
**Limitación:**
- Los patrones glob amplios (`**/*`) pueden devolver miles de resultados
- Las búsquedas con regex son más lentas que las de cadenas literales
**Solución:** Usa patrones específicos y excluye directorios innecesarios
### Agotamiento del contexto
**Problema:** Durante sesiones largas u operaciones complejas, la ventana de contexto de la IA puede llenarse, lo que limita la capacidad de hacer referencia a partes anteriores de la conversación.
**Estrategias de mitigación:**
- Usa subagentes para investigación exploratoria (los resultados solo consumen el contexto principal)
- Lee archivos de forma estratégica con rangos de líneas
- Usa `grep_file` antes de leer el contenido completo
- Delega tareas en segundo plano al subagente Explorer
Para archivos de más de 500 líneas, usa siempre rangos de líneas para preservar el espacio de contexto.
---
## Lo que Verdent no puede hacer
### Sin administración directa del sistema
**No puede:**
- Modificar la configuración de VS Code de forma programática
- Instalar extensiones de VS Code automáticamente
- Cambiar configuraciones a nivel de sistema
- Reiniciar VS Code o servicios del sistema
**Alcance:** Verdent opera dentro del espacio de trabajo de VS Code, no a nivel de administración del sistema.
### Sin ejecución autónoma
**Controles de Manual Accept Mode:**
- Debes aprobar las ejecuciones de herramientas en Manual Accept Mode
- No hay operaciones automatizadas en segundo plano sin aprobación
- No puede ejecutar comandos mientras VS Code está cerrado
**Propósito:** Seguridad y control del usuario sobre todas las operaciones.
Verdent no puede ejecutar comandos en segundo plano sin la aprobación del usuario. Todas las operaciones requieren consentimiento explícito en Manual Accept Mode.
### Sin monitoreo en tiempo real
**No puede:**
- Monitorear procesos en ejecución de forma continua
- Rastrear cambios del sistema de archivos en tiempo real
- Alertar sobre eventos del sistema
- Transmitir archivos de registro de forma continua
**Alternativa:** Usa integraciones de MCP para herramientas de monitoreo externas.
### Sin operaciones de red sin MCP
**Limitaciones integradas:**
- No puede hacer solicitudes HTTP arbitrarias (usa `web_fetch` para páginas específicas)
- No hay conexiones directas a bases de datos (requiere MCP)
- No puede acceder a servicios en la nube directamente (requiere MCP)
- No hay integraciones en tiempo real con API (requiere MCP)
**Solución:** Configura servidores MCP para acceder a sistemas externos.
---
## Restricciones específicas de cada plataforma
### Diferencias entre sistemas operativos
**Comportamiento de la herramienta bash:**
| Plataforma | Shell | Notas |
| --------------- | ---------- | ---------------------------------------------------------- |
| **macOS/Linux** | bash/zsh | Funcionalidad completa de bash |
| **Windows** | PowerShell | Algunos comandos bash no están disponibles; usa equivalentes de PowerShell |
| **WSL** | bash | Los comandos de Linux funcionan en el entorno WSL |
**Manejo de rutas:**
- Windows usa barras invertidas (`\`), Unix usa barras diagonales (`/`)
- Las rutas de archivo pueden necesitar ajustes en proyectos multiplataforma
---
### Requisitos de versión de VS Code
**Requisitos mínimos:**
- Compatibilidad de versión de VS Code (consulta el marketplace de extensiones para conocer el mínimo actual)
- Espacio en disco suficiente para el almacenamiento en caché del contexto
Los requisitos de versión específicos se mantienen en la ficha del marketplace de VS Code. Consulta los detalles de la extensión para conocer la compatibilidad actual.
---
### Restricciones del espacio de trabajo
**Enfoque en un solo espacio de trabajo:**
- Verdent opera dentro de un espacio de trabajo de VS Code a la vez
- No puede modificar archivos simultáneamente en varias ventanas abiertas de VS Code
- Los espacios de trabajo con varias raíces son compatibles, pero el contexto se limita al espacio de trabajo activo actual
---
## Soluciones alternativas para limitaciones comunes
### Modificación de archivos binarios
**Limitación:** No puede editar imágenes, PDF ni binarios compilados
**Soluciones alternativas:**
- Referencia herramientas externas en comandos bash: `bash("convert input.png -resize 50% output.png")`
- Genera scripts que las herramientas externas puedan ejecutar
- Documenta los pasos manuales para las operaciones con archivos binarios
**Ejemplo:**
```bash
# Image conversion
bash("convert input.png -resize 50% output.png")
# PDF to text
bash("pdftotext document.pdf output.txt")
```
### Manejo de archivos grandes
**Limitación:** Los archivos de más de 10.000 líneas sobrecargan la ventana de contexto
**Soluciones alternativas:**
- Usa rangos de líneas: `file_read("large.log", start_line=1000, max_lines=100)`
- Busca primero: `grep_content("ERROR", glob="large.log")` para encontrar las secciones relevantes
- Divide los archivos en módulos más pequeños para facilitar su gestión
Usa siempre `grep_content` primero para identificar las secciones relevantes y luego lee únicamente esos rangos de líneas específicos.
### Agotamiento de la ventana de contexto
**Limitación:** Las conversaciones largas llenan la ventana de contexto
**Soluciones alternativas:**
- Delega en el subagente Explorer la investigación del código base
- Usa el subagente Verifier para tareas de validación aisladas
- Inicia una nueva conversación para tareas distintas
- Usa `todo_update` para hacer seguimiento del progreso entre sesiones
**Práctica recomendada:** Delega la investigación en segundo plano a los subagentes para preservar el contexto principal para el desarrollo activo.
### Diferencias de comandos entre plataformas
**Limitación:** Los comandos bash difieren entre Windows y Unix
**Soluciones alternativas:**
- Usa herramientas multiplataforma: scripts de npm en lugar de bash directo
- Comandos condicionales: `bash("if [[ \"$OSTYPE\" == \"linux-gnu\"* ]]; then ...; fi")`
- AGENTS.md específico del proyecto con notas sobre la plataforma
**Ejemplo:**
```bash
# Cross-platform
bash("npm run build")
# Platform-specific conditional
bash("if [[ \"$OSTYPE\" == \"linux-gnu\"* ]]; then make; else nmake; fi")
```
---
## Mejoras futuras
Las limitaciones se abordan continuamente. Consulta las notas de la versión de Verdent para conocer las actualizaciones sobre capacidades ampliadas, límites incrementados y nuevas integraciones.
---
## Consulta también
Capacidades completas de las herramientas
Optimiza el uso de Verdent