Resumen

Este explicador de código convierte un fragmento pegado en un esquema en español: el lenguaje, cada función y lo que sugiere su nombre, una puntuación de complejidad ciclomática, y banderas como bloques catch vacíos, llamadas eval y secretos codificados. Es un lector basado en reglas, no un modelo de lenguaje, por lo que describe la estructura en lugar de la intención. La complejidad sigue la medida de McCabe, donde 10 o menos por función es el límite recomendado. El análisis se ejecuta en tu navegador y tu código nunca se envía a ningún lado.

Pega tu Código, Obtén un Esquema en Español de lo que Hace

Este explicador de código gratuito lee un fragmento en tu navegador y devuelve sus funciones, rutas de decisión, manejo de errores y señales de alerta, para que sepas dónde mirar antes de leer línea por línea.

Engineer reading unfamiliar code on a monitor with a notebook sketch of function boxes beside the keyboard

Explicador de código

Pega una función o un archivo corto. El esquema se actualiza mientras escribes. Nada sale de tu navegador.

Recorrido

    Cosas a verificar

      Cómo usar el esquema

      Cómo usar el esquema

      1. 1

        Pega el fragmento

        Una función o un archivo funciona mejor. Después de algunos cientos de líneas, el esquema deja de ser un resumen y se convierte en una lista.

      2. 2

        Comprueba la oración principal

        Nombra el lenguaje, cuenta funciones y proporciona un puntaje de complejidad. Un puntaje superior a 10 significa que el código tiene demasiadas rutas para retener en tu cabeza de una vez.

      3. 3

        Lee el recorrido

        Cada función obtiene una línea: lo que sugiere su nombre, cuán larga es, cuántas rutas tiene, y si hace bucles, espera o maneja fallos.

      4. 4

        Abre las banderas primero

        Si la herramienta enumera un controlador de errores vacío o una cadena similar a una credencial, comienza ahí. Esas son las líneas que probablemente te duela más tarde.

      Cómo funciona

      Lo que el explicador realmente mide

      Estructura de sintaxis

      Elimina comentarios y cadenas, luego coincide con definiciones de funciones, importaciones, clases, bucles y ramas para el lenguaje que detecta. Sin adivinanzas sobre para qué sirve el código, solo lo que contiene.

      Complejidad que puedes verificar

      El puntaje es complejidad ciclomática: uno más cada if, bucle, case, catch y operador booleano. Es el mismo recuento que un linter te daría, y el informe de pruebas estructuradas de NIST sugiere mantener una función en 10 o menos.

      Banderas que coinciden con errores reales

      Llamadas eval o exec, bloques catch vacíos, secretos codificados, notas TODO, anidamiento más allá de cuatro niveles y funciones de más de 40 líneas. Cada regla existe porque apunta a un código que es fácil de malinterpretar.

      Dónde se detiene

      Un explicador de fragmentos responde "qué hay aquí", no "por qué está aquí"

      La pregunta que hace un ingeniero nuevo es raramente "qué hace este bucle". Es "por qué el servicio de facturación llama a esta función, y quién más depende de ella". Un fragmento pegado no puede responder eso, porque la respuesta vive en otros archivos. Esta herramienta está construida para el primer paso: tienes una función abierta, tienes cinco minutos, y quieres saber si es un ayudante de diez líneas o un lío con seis caminos de salida. Te da eso en un segundo y te dice dónde está el riesgo. Para la segunda pregunta necesitas buscar en todo el repositorio. Esa es la brecha entre leer una función y entender cómo está conectado un sistema, y es donde va la mayor parte del tiempo de incorporación.

      • Úsalo en una función o archivo único, no en un servicio completo
      • Trata las banderas como indicaciones para mirar más de cerca, no como hallazgos
      • Cambia a búsqueda en todo el repositorio cuando la pregunta es sobre llamadores y dependencias
      Dos ingenieros en una laptop, uno señalando una línea de código fuente mientras el otro lee

      Preguntas sobre el explicador de código

      ¿Es este explicador de código gratuito y mi código sale de mi navegador?
      Es gratuito y no requiere registro. El análisis se ejecuta completamente en tu navegador con JavaScript simple. Tu fragmento nunca se envía a un servidor, por lo que puedes pegar código interno sin una revisión de seguridad. Lo único que se registra es un recuento anónimo de que se usó la herramienta.
      ¿Es este un modelo de IA que entiende mi código?
      No. Es un lector basado en reglas. Detecta el lenguaje, encuentra funciones, importaciones, ramas, bucles y manejo de errores, y los describe usando los nombres y la estructura que ve. Eso lo hace rápido y predecible, pero no puede conocer la intención. Si una función se llama process() y hace algo sorprendente, la herramienta no lo sabrá.
      ¿Cómo se calcula el puntaje de complejidad?
      Cuenta puntos de decisión (if, elif, for, while, case, catch o except, operadores booleanos and/or, ternarios) y suma uno. Esa es la medida de complejidad ciclomática que McCabe propuso en 1976. Un puntaje de 10 o menos es el límite que el informe de pruebas estructuradas de NIST recomienda para una función única.
      ¿Qué lenguajes admite?
      Python, JavaScript, TypeScript, Java, Go y Rust. La detección automática busca palabras clave y sintaxis. Si adivina mal en un fragmento corto, elige el lenguaje en la lista desplegable. Otros lenguajes de estilo C a menudo funcionan, pero la detección de funciones es menos confiable.
      ¿Por qué señala cosas como bloques catch vacíos y comentarios TODO?
      Esos son los lugares donde un lector a menudo se sorprende más tarde. Un catch vacío oculta fallos, un TODO marca una brecha conocida, y una función larga o profundamente anidada es difícil de probar. Las banderas son indicaciones para mirar más de cerca, no veredictos.
      ¿Cuál es la diferencia entre esto y preguntarle a un chat de IA sobre mi código?
      Un modelo de chat puede razonar sobre la intención, pero solo sobre lo que pegas. Esta herramienta muestra la estructura en segundos sin modelo involucrado. Ninguno de los dos sabe cómo se conecta el fragmento con el resto de tu repositorio. Para eso necesitas una herramienta que haya indexado toda la base de código.
      ¿Puedo usarlo para revisar una solicitud de extracción?
      Sí. Elige la opción de revisor y pega la función modificada. Obtienes una lista de verificación con recuentos de ramas, manejo de errores y señales de alerta, que te dice dónde gastar tu atención antes de abrir el diff completo.

      Comprende todo el repositorio, no solo un fragmento

      codebasechat responde preguntas sobre tu base de código en inglés simple, con los archivos y sitios de llamadas que respaldan cada respuesta.