Problemas Comunes
Esta guía cubre los problemas más comunes que los usuarios encuentran con Sidian y proporciona soluciones paso a paso para resolverlos rápidamente.
Las Funciones de IA No Funcionan
Si las funciones de IA de Sidian no responden o no funcionan correctamente:
Problemas de Autenticación
Las funciones de IA requieren autenticación
- Comprueba si has iniciado sesión (busca el estado de la cuenta en la barra lateral)
- Intenta cerrar sesión y volver a iniciarla
- Verifica que tu suscripción esté activa
- Borra la caché del navegador si usas autenticación web
Conectividad de Red
Los modelos de IA en la nube requieren conexión a internet
- Para modelos en la nube: Comprueba tu conexión a internet
- Para modelos locales: Verifica que el servidor de IA local esté en funcionamiento (Ollama/LM Studio)
- Verifica que el firewall no esté bloqueando a Sidian
- Intenta desactivar temporalmente la VPN si usas modelos en la nube
- Comprueba si un proxy corporativo está interfiriendo
Problemas de Configuración
Verifica la configuración del modelo y proveedor de IA
- Verifica que las claves de API estén configuradas correctamente
- Comprueba si el modelo de IA seleccionado está disponible
- Intenta cambiar a un proveedor de IA diferente
- Restablece la configuración de IA a los valores predeterminados
Problemas del Servidor MCP
Problemas con los servidores del Protocolo de Contexto del Modelo (MCP):
El Servidor No Arranca
- Comprueba si Node.js está instalado y accesible
- Verifica que el paquete del servidor esté instalado:
npm list -g
- Comprueba la sintaxis del archivo de configuración de MCP
- Revisa los registros del servidor para ver mensajes de error específicos
- Intenta ejecutar manualmente el comando del servidor en la terminal
Errores de Permisos
- Asegúrate de que Sidian tenga acceso de lectura/escritura a los directorios configurados
- Comprueba los permisos del sistema de archivos en las carpetas del proyecto
- Ejecuta Sidian como administrador si es necesario (Windows)
- Verifica que el archivo de configuración de MCP sea legible
El Servidor Se Cae Constantemente
- Actualiza el paquete del servidor MCP a la última versión
- Comprueba si hay versiones de Node.js en conflicto
- Aumenta los valores de tiempo de espera en la configuración
- Supervisa los recursos del sistema (CPU, memoria)
- Revisa los registros del servidor en busca de patrones de error
Problemas de Rendimiento
Arranque Lento
- Desactiva las extensiones innecesarias
- Borra la caché de las extensiones
- Reduce el número de archivos abiertos
- Comprueba si hay archivos grandes en el espacio de trabajo
- Actualiza a la última versión de Sidian
Alto Uso de Memoria
- Cierra los archivos y pestañas no utilizados
- Desactiva las extensiones que consumen mucha memoria
- Reduce el alcance del observador de archivos
- Borra las cachés de búsqueda y símbolos
- Reinicia Sidian periódicamente
Alto Uso de CPU
- Comprueba si hay extensiones fuera de control
- Desactiva temporalmente las funciones en tiempo real
- Reduce la frecuencia de las sugerencias de IA
- Cierra las terminales que consumen muchos recursos
- Supervisa los procesos en segundo plano
Problemas con Archivos y el Editor
Los Archivos No Se Cargan
- Comprueba los permisos de los archivos
- Verifica que la ruta del archivo sea correcta
- Intenta actualizar el explorador de archivos
- Comprueba si el archivo está bloqueado por otro proceso
- Reinicia Sidian si los archivos parecen estar corruptos
El Guardado Automático No Funciona
- Comprueba la configuración de guardado automático en las preferencias
- Verifica los permisos de escritura del archivo
- Asegúrate de que haya suficiente espacio en disco
- Comprueba si el archivo es de solo lectura
- Intenta guardar manualmente para probar los permisos de escritura
La Búsqueda No Encuentra Archivos
- Comprueba los patrones de exclusión de la búsqueda
- Verifica que las extensiones de archivo no estén filtradas
- Intenta reconstruir el índice de búsqueda
- Comprueba si los archivos están en .gitignore
- Borra la caché de búsqueda y reinicia
Problemas con Extensiones
La Extensión No Se Instala
- Comprueba la conexión a internet
- Verifica la compatibilidad de la extensión
- Borra la caché de extensiones
- Intenta instalar desde un archivo VSIX
- Comprueba el espacio en disco disponible
Errores de la Extensión
- Revisa los registros de la extensión en el panel de salida
- Desactiva las extensiones en conflicto
- Actualiza la extensión a la última versión
- Restablece la configuración de la extensión
- Informa del problema al autor de la extensión
La Extensión No Se Carga
- Comprueba si la extensión está habilitada
- Verifica las dependencias de la extensión
- Intenta recargar la ventana (Ctrl+Shift+P → Recargar Ventana)
- Comprueba si hay actualizaciones de la extensión
- Reinstala la extensión
Problemas de Integración con Git
Los Comandos de Git Fallan
- Verifica que Git esté instalado y en la variable PATH
- Comprueba el estado del repositorio
- Asegúrate de que la configuración de Git sea la correcta
- Intenta las operaciones de Git en la terminal
- Comprueba los permisos de los archivos
Conflictos de Fusión (Merge)
- Utiliza el solucionador de conflictos de fusión incorporado
- Comprueba si hay cambios en conflicto
- Asegúrate de que todos los cambios estén en el "stage"
- Intenta la resolución manual de conflictos
- Utiliza herramientas de fusión externas si es necesario
Problemas de Push/Pull
- Comprueba el acceso al repositorio remoto
- Verifica las credenciales de autenticación
- Comprueba la conectividad de red
- Intenta las operaciones de Git en la terminal
- Actualiza Git a la última versión
Problemas de la Terminal
La Terminal No Se Abre
- Comprueba la configuración del shell predeterminado
- Verifica que el ejecutable del shell exista
- Prueba con un shell diferente (bash, zsh, PowerShell)
- Comprueba la configuración de la terminal
- Restablece la configuración de la terminal
Comandos No Encontrados
- Comprueba la variable de entorno PATH
- Verifica la instalación del comando
- Intenta la ruta completa al ejecutable
- Comprueba los archivos de configuración del shell
- Reinicia la sesión de la terminal
Problemas de Visualización de la Terminal
- Comprueba la configuración de la fuente de la terminal
- Verifica la configuración del esquema de colores
- Prueba con un renderizador de terminal diferente
- Comprueba el soporte para Unicode
- Restablece la configuración de apariencia de la terminal
Problemas de Depuración
El Depurador No Se Inicia
- Comprueba la configuración de depuración
- Verifica la instalación del depurador
- Comprueba la sintaxis de launch.json
- Prueba con un adaptador de depuración diferente
- Comprueba la disponibilidad del puerto
Los Puntos de Ruptura (Breakpoints) No Funcionan
- Verifica que los "source maps" sean correctos
- Comprueba si el código está optimizado
- Intenta establecer puntos de ruptura después de iniciar
- Comprueba el "attachment" del depurador
- Verifica que las rutas de los archivos coincidan
Las Variables No Se Muestran
- Revisa la consola de depuración en busca de errores
- Verifica el alcance de las variables
- Prueba con un adaptador de depuración diferente
- Comprueba la sintaxis de la expresión
- Reinicia la sesión de depuración
Obtener Ayuda Adicional
Documentación
- Consulta la documentación oficial en docs.sidian.dev
- Consulta la documentación de las extensiones
Soporte de la Comunidad
- Únete al servidor de Discord de Sidian
- Busca en Stack Overflow
Soporte Directo
- Contacta a support@sidian.dev
- Incluye registros de errores y capturas de pantalla
- Describe los pasos para reproducir el problema
- Menciona la configuración de tu sistema
Información de Diagnóstico
Al informar problemas, incluye:
- Versión de Sidian
- Sistema operativo
- Mensajes de error
- Pasos para reproducir el problema
- Lista de extensiones
- Especificaciones del sistema
La mayoría de los problemas se pueden resolver siguiendo estos pasos de solución de problemas. Si los problemas persisten, no dudes en contactar a la comunidad o al equipo de soporte.```