Skip to content

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.```