Saltar al contenido principal

Solución de problemas

Problemas comunes y cómo solucionarlos.

Problemas con proveedores​

"Error: 401 Unauthorized"​

  • Causa: Clave de API no válida.
  • Solución: Ve a Settings > Providers. Vuelve a introducir tu clave de API. Asegúrate de que no haya espacios extra ni saltos de línea.

"Error: 403 Forbidden"​

  • Causa: Tu clave de API no tiene acceso al modelo solicitado.
  • Solución:
    • Para OpenAI: Algunos modelos requieren un plan de pago. Comprueba tu acceso en platform.openai.com.
    • Para Anthropic: Asegúrate de que tu cuenta tenga acceso al modelo de Claude que estás solicitando.

"Error: 429 Too Many Requests"​

  • Causa: Has alcanzado el límite de solicitudes (rate limit) o te has quedado sin credits.
  • Solución:
    • Espera unos minutos y vuelve a intentarlo (límite de solicitudes).
    • Comprueba el estado de tu facturación y añade credits en el sitio web del proveedor.
    • Considera cambiar temporalmente a otro proveedor.

"Error: 500 Internal Server Error"​

  • Causa: Los servidores del proveedor están teniendo problemas.
  • Solución: Espera unos minutos y vuelve a intentarlo. Consulta la página de estado del proveedor.

"Connection Refused" (Ollama)​

  • Causa: Rephlo no puede comunicarse con el servidor de IA local.
  • Solución:
    1. Abre una terminal y ejecuta ollama serve.
    2. Verifica que esté en ejecución: visita http://localhost:11434 en un navegador.
    3. Comprueba si otra aplicación está usando el puerto 11434.

"Model Not Found" (Ollama)​

  • Causa: El modelo solicitado no se ha descargado.
  • Solución: Ejecuta ollama pull [model-name] en tu terminal (por ejemplo, ollama pull llama3).

Problemas de interfaz​

"Hotkeys are not working"​

  • Causa (Windows/Linux): Otra aplicación (como PowerToys o un juego) podría haber capturado el atajo de teclado.
  • Solución: Ve a Settings > Hotkeys y cambia el atajo a otro distinto (por ejemplo, Ctrl + Shift + Alt + Z).

Usuarios de macOS: Consulta Problemas específicos de macOS más abajo para solucionar problemas de atajos de teclado en macOS.

"Tray Icon is Missing"​

  • Causa: Windows podría haberlo ocultado en el menú de "overflow" (desbordamiento).
  • Solución: Haz clic en la flecha ^ junto al reloj. Arrastra el icono de Rephlo hacia el área principal de la barra de tareas.

Problemas con funciones​

"Vision/Screenshot not working"​

  • Causa (Windows): Los permisos de grabación de pantalla podrían estar denegados en la configuración de privacidad de Windows.
  • Solución (Windows): Ejecuta Rephlo como administrador o revisa Windows Privacy settings > Camera / Screen capture.
  • Causa (macOS): Rephlo necesita el permiso de Screen Recording.
  • Solución (macOS): Consulta Problemas específicos de macOS más abajo para ver los pasos detallados.

"Space is not answering questions"​

  • Causa: El Space podría estar vacío o falló la ingesta de datos.
  • Solución: Revisa los detalles del Space. Asegúrate de que los archivos aparezcan listados y de que el estado diga "Ready". Prueba a vaciar la caché en Advanced Settings.

"Variable not found in Space"​

  • Causa: Estás usando una variable {{filename}} pero el archivo no está en el Space activo.
  • Solución:
    1. Comprueba que el Space contenga el archivo referenciado.
    2. Verifica que el nombre de la variable coincida con el nombre del archivo (convertido a snake_case, por ejemplo: "Style Guide.pdf" -> {{style_guide_pdf}}).
    3. Asegúrate de que el Space correcto esté activo.

Problemas específicos de macOS​

"Hotkeys are not working" (macOS)​

  • Causa: Rephlo necesita el permiso de Accessibility para detectar atajos de teclado globales.
  • Solución:
    1. Abre System Settings > Privacy & Security > Accessibility.
    2. Busca Rephlo en la lista y actívalo (ON).
    3. Si Rephlo no aparece en la lista, cierra la app y vuelve a abrirla.
    4. Reinicia Rephlo después de conceder el permiso.

Importante: Los atajos de teclado globales solo funcionan al ejecutar Rephlo como un paquete .app firmado. Si eres desarrollador y ejecutas dotnet run desde la terminal, es posible que los atajos no funcionen. Consulta el Tutorial de configuración en macOS para compilar y ejecutar el paquete .app.

"Screenshot / Vision not working" (macOS)​

  • Causa: Rephlo necesita el permiso de Screen Recording para capturar el contenido de la pantalla.
  • Solución:
    1. Abre System Settings > Privacy & Security > Screen Recording.
    2. Busca Rephlo en la lista y actívalo (ON).
    3. Reinicia Rephlo.

"Permission dialog keeps appearing"​

  • Causa: Rephlo se estaba ejecutando sin una firma de código estable. Cada nueva compilación cambia el hash del binario, lo que hace que macOS lo trate como una app nueva y reinicie los permisos.
  • Solución: Usa una compilación de lanzamiento (release) firmada de Rephlo desde el canal de distribución oficial. Una vez concedidos los permisos a la app firmada, se mantienen a través de las actualizaciones.

"Overlay doesn't appear even after granting permissions"​

  • Solución:
    1. Cierra Rephlo por completo (clic derecho en el icono de la bandeja > Exit).
    2. Vuelve a abrirlo desde el paquete .app.
    3. Comprueba que ambos permisos, Accessibility Y Screen Recording, estén concedidos.
    4. Prueba el botón Test Overlay en Settings > Hotkeys.

Problemas de rendimiento​

"Responses are very slow"​

  • Causa: Varios factores pueden ralentizar las respuestas.
  • Solución:
    • Contexto de Space muy grande: Considera compactar tu Space.
    • Proveedor lento: Cambia a un modelo más rápido, como GPT-5.4 Mini o Gemini 3.5 Flash, para obtener respuestas más rápidas.
    • Modelo local (Ollama): Asegúrate de que se esté usando tu GPU. Revisa los logs de Ollama.

"App feels sluggish on startup"​

  • Causa: Carga de Spaces grandes o de muchos comandos.
  • Solución: Archiva los comandos que no uses. Elimina los Spaces antiguos que ya no necesites.

Problemas de Chat​

"Chat history is missing"​

  • Causa: Las conversaciones se almacenan localmente y podrían haberse borrado.
  • Solución: Revisa Settings > Privacy para ver la configuración de retención del historial. Si está en "Immediate", el historial no se conserva.

"Chat keeps forgetting context"​

  • Causa: Has superado la ventana de contexto del proveedor.
  • Solución: Inicia una conversación nueva o usa un proveedor con una ventana de contexto más grande. Consulta la documentación de tu proveedor para conocer los tamaños específicos de la ventana de contexto.

Problemas con variables y plantillas​

"Variable not found" or "Invalid variable"​

  • Causa: El nombre de la variable no coincide con ninguna variable del sistema válida ni con ningún archivo de tu Space.
  • Solución:
    • Usa la sintaxis exacta: {{input_content}}, {{space_data_all}} o {{filename}}.
    • Para variables de archivo: convierte el nombre del archivo a snake_case (por ejemplo: "Style Guide.pdf" -> {{style_guide_pdf}}).
    • Verifica que el archivo exista en tu Space activo.
    • Revisa que no haya errores tipográficos: los nombres de variable no distinguen mayúsculas/minúsculas, pero deben escribirse correctamente.

"Space variables ignored in Standalone mode"​

  • Causa: Los comandos Standalone no inyectan automáticamente los datos del Space.
  • Explicación: El modo Standalone te da control manual total. Variables como {{space_data_all}} no se sustituirán automáticamente.
  • Solución: Cambia al modo Combination para la inyección automática de datos del Space, o pega manualmente los datos del Space en tu prompt.

Problemas con Space​

"Space full" or "Token budget exceeded"​

  • Causa: Tu Space ha superado el límite de tokens configurado.
  • Solución:
    1. Abre la vista de datos del Space y revisa el uso actual.
    2. Elimina los archivos menos importantes del Space, o aumenta el presupuesto de tokens (máximo 1.000.000 de tokens) — ambas opciones reducen directamente un Space que supera su presupuesto almacenado.
    3. Cambia el modo de datos a 🗜️ Compact para almacenar resúmenes generados por IA en lugar del texto completo — esto reduce los tokens contabilizados del Space (confirma el costo en credits). Luego elige un nivel de compactación:
      • Conservative: Resumen mínimo (conserva el detalle).
      • Balanced: Resumen moderado (opción predeterminada y recomendada).
      • Aggressive: Resumen intensivo (lo mejor para Spaces muy grandes).
      • Nota: para un Space muy grande (≈128.000 tokens o más), Compact está deshabilitado por diseño — en su lugar, elimina archivos o aumenta el presupuesto.
    4. Nota: 🔍 Smart Search mantiene pequeña cada solicitud enviando solo los pasajes relevantes, pero cuenta el texto completo en bruto dentro del presupuesto del Space — así que controla el costo por solicitud, no un Space que ha superado su límite almacenado.

"Space ingestion failed" (PDF/document error)​

  • Causa: El archivo no se pudo procesar, posiblemente porque está dañado, protegido con contraseña o en un formato no compatible.
  • Solución:
    • Asegúrate de que el PDF no esté protegido con contraseña.
    • Intenta volver a exportar el documento desde la aplicación original.
    • Para PDF escaneados: Rephlo solo extrae texto — las imágenes dentro de los PDF no se leen.
    • Comprueba que el archivo no esté dañado abriéndolo primero en otra aplicación.

Problemas de generación de imágenes​

"This prompt was blocked by our content policy"​

  • Causa: Tu prompt de imagen fue marcado por la moderación de contenido y rechazado antes de que se ejecutara la generación.
  • Solución: Reescribe tu prompt para eliminar el contenido no permitido e inténtalo de nuevo. Consulta la página de Política de Contenido para ver qué no está permitido.

"Content moderation is temporarily unavailable"​

  • Causa: El servicio de moderación de contenido está caído temporalmente (una interrupción transitoria), por lo que tu prompt no pudo ser verificado.
  • Solución: Espera un momento y vuelve a intentarlo.

Obtener ayuda​

¿Cómo reporto contenido de IA dañino o inapropiado?​

  • Solución:
    • Si has iniciado sesión: Haz clic en tu avatar al final de la barra lateral > Help > Report inappropriate content.
    • En cualquier momento: Abre Settings > About > Contact & Support > Report inappropriate content.
    • Esto abrirá rephlo.app/contact en tu navegador con la categoría de reporte ya seleccionada.