Code Graph
Abrir la aplicación: Dibuja el mapa de un repositorio → (products.documentize.ai)
En una frase
Code Graph toma un repositorio de GitHub con código C#, analiza su solución y te entrega una única base de datos SQLite que mapea sus proyectos, tipos, miembros y las relaciones entre ellos.
Qué lo hace único
El resultado son datos, no un documento. En lugar de un PDF o una página web, obtienes un archivo .sqlite que puedes abrir con cualquier herramienta SQLite y consultar tú mismo: «¿qué tipos dependen de este?», «¿qué hay en este proyecto?». Eso lo convierte en la columna vertebral estructural para herramientas, auditorías e incorporación de personas, y en un buen complemento de la prosa que escribe Documentos del repositorio (Repo Docs).
Cuándo usarlo y cuándo no
- Úsalo cuando quieras un mapa consultable de una base de código .NET a la que vas a incorporarte, que vas a revisar o que vas a refactorizar.
- No sirve si quieres documentación legible → Documentos del repositorio (Repo Docs).
- No sirve para preguntas sobre una biblioteca compilada → Chat de Assembly (Assembly Chat).
- No sirve para código que no sea C#. Code Graph analiza soluciones de C#.
Antes de empezar
- El repositorio debe estar en GitHub, escrito como
owner/nameo como una URL completahttps://github.com/owner/name. También vale la URL de una rama copiada del navegador (.../tree/dev), que selecciona esa rama. - Debe contener un archivo
.sln. La aplicación elige la solución menos profunda, prefiriendo la que se llame como el repositorio, e ignora carpetas comobin,obj,node_modulesy cualquiera que empiece por un punto. Una ejecución construye un grafo a partir de una solución; un repositorio con varias soluciones recibe la que elija la aplicación (en la página no puedes escoger). - ¿Repositorio privado? Invita antes como colaborador a la cuenta de GitHub
arise-project, como indica la sugerencia de la página. Sin acceso, la ejecución falla con un mensaje de acceso.
Paso a paso
- Abre Code Graph.
- Escribe el repositorio de GitHub.
- Si quieres, escribe una rama (Branch; si queda vacía, se usa la rama predeterminada).
- Inicia la ejecución. Los mensajes de progreso muestran «Downloading owner/name» y después «Building the graph of <solution> @ <commit>».
- Descarga el archivo
.sqlitecuando termine.
El texto de la página menciona también descripciones del propósito, embeddings y una API de consulta alojada. El formulario de entrada solo tiene repositorio y rama, y nada de la ejecución produce resúmenes ni un punto de conexión de consulta (compruébalo en la aplicación en funcionamiento).
Opciones explicadas
| Opción | Qué hace | Valor por defecto | Recomendado |
|---|---|---|---|
| Repositorio de GitHub | El repositorio que se va a analizar (owner/name o URL, hasta 300 caracteres) | obligatorio | Pega la URL desde tu navegador |
| Rama | Rama que se va a analizar (hasta 200 caracteres). El nombre de una rama no puede empezar por -, ni contener .., espacios ni caracteres especiales como ~ ^ : ? * [ | rama predeterminada | Indícala expresamente cuando trabajes en una rama de funcionalidad |
No hay más controles.
Qué obtienes
- Un archivo con un nombre como
owner-name-<primeros 7 caracteres del commit>.sqlite, de modo que el nombre te dice exactamente qué commit se analizó. - Un resumen del resultado con el repositorio, la rama, el commit completo y la ruta de la solución que se usó.
- Tu repositorio no se modifica.
Calidad y límites
- Análisis determinista del código, no una suposición de la IA: lo que hay en el grafo procede de los fuentes C#. El código que se genera durante la compilación o que está fuera de la solución no estará.
- Hay un límite de tiempo por ejecución. Si el repositorio es demasiado grande para analizarlo a tiempo, la ejecución se detiene con un mensaje que lo explica y que dice que una suscripción elimina el límite.
- Un repositorio sin
.slnse rechaza con un mensaje claro. - El repositorio se descarga como una copia de solo lectura para la ejecución. Para esta aplicación no se indica si se envía algo a un modelo de lenguaje (compruébalo en la aplicación en funcionamiento).
Funciona bien con
- Ejecuta después de esta aplicación: Documentos del repositorio (Repo Docs) para obtener documentación legible del mismo repositorio; Asistente de refactorización (Refactor Assistant) para ver qué clases conviene dividir.
- Relacionado: Chat de Assembly (Assembly Chat) para la forma compilada de una biblioteca.
Errores frecuentes y soluciones
- «is not a GitHub repository» → usa
owner/nameo una URL de github.com; no se aceptan otros servidores. - «has no .sln file» → el repositorio solo tiene archivos
.csproj, o su solución está en otro formato. Añade o genera un archivo de solución, o usa Documentos del repositorio (Repo Docs), que también acepta un.csproj. - Error de acceso en un repositorio privado → invita a
arise-projecty vuelve a intentarlo. - «not a valid branch name» → quita los espacios y los caracteres especiales.
Lo mismo en otros canales
No verificado para esta aplicación. Consulta canales para ver qué existe en el conjunto de aplicaciones.
Pruébalo
Ejecuta Code Graph sobre un repositorio público pequeño de C# que tenga un archivo de solución en la raíz, por ejemplo cualquier aplicación de ejemplo que conozcas. Abre el .sqlite descargado en un explorador de SQLite, enumera sus tablas y busca las filas que describen tus proyectos y tipos.