Files

qiaoxinjiu e31a75d2bb Add under-anything knowledge dashboard

2026-05-27 15:40:32 +08:00

16 KiB

Raw Blame History

Understand Anything

Convierte cualquier código fuente, base de conocimiento o documentación en un grafo de conocimiento interactivo que puedes explorar, buscar y consultar.
Compatible con Claude Code, Codex, Cursor, Copilot, Gemini CLI y más.

💬 Únete a la comunidad de Discord →
Pregunta, comparte lo que construyes y recibe ayuda de la comunidad.

Acabas de unirte a un nuevo equipo. El código tiene 200,000 líneas. ¿Por dónde empiezas?

Understand Anything es un Claude Code Plugin que analiza tu proyecto con un pipeline multi-agente, construye un grafo de conocimiento de cada archivo, función, clase y dependencia, y luego te ofrece un panel interactivo para explorarlo visualmente. Deja de leer código a ciegas. Empieza a ver el panorama completo.

El objetivo no es un grafo que te impresione mostrándote lo complejo que es tu código — es un grafo que, sin alardes, te enseña cómo encaja cada pieza.

✨ Características

Note

¿Quieres probarlo directamente? Prueba la demo en vivo en nuestra página principal — un panel interactivo donde puedes navegar, hacer zoom, buscar y explorar directamente en tu navegador.

Explora el grafo estructural

Navega tu código como un grafo de conocimiento interactivo: cada archivo, función y clase es un nodo que puedes hacer clic, buscar y explorar. Selecciona cualquier nodo para ver resúmenes en lenguaje natural, relaciones y recorridos guiados.

Comprende la lógica de negocio

Cambia a la vista de dominio y observa cómo tu código se mapea a procesos de negocio reales: dominios, flujos y pasos representados como un grafo horizontal.

Analiza bases de conocimiento

Apunta /understand-knowledge a un wiki LLM con patrón Karpathy y obtén un grafo de conocimiento dirigido por fuerzas con agrupación por comunidad. El parser determinístico extrae wikilinks y categorías de index.md, luego los agentes LLM descubren relaciones implícitas, extraen entidades y revelan afirmaciones, convirtiendo tu wiki en un grafo navegable de ideas interconectadas.

🧭 Recorridos Guiados

Recorridos generados automáticamente de la arquitectura, ordenados por dependencia. Aprende el código en el orden correcto.

🔍 Búsqueda Difusa y Semántica

Encuentra cualquier cosa por nombre o por significado. Busca "¿qué partes manejan la autenticación?" y obtén resultados relevantes en todo el grafo.

📊 Análisis de Impacto de Cambios

Visualiza qué partes del sistema afectan tus cambios antes de hacer commit. Comprende los efectos en cascada a través del código.

🎭 Interfaz Adaptativa por Persona

El panel ajusta su nivel de detalle según quién eres: desarrollador junior, PM o usuario avanzado.

🏗️ Visualización por Capas

Agrupación automática por capa arquitectónica — API, Servicio, Datos, UI, Utilidades — con leyenda codificada por colores.

📚 Conceptos del Lenguaje

12 patrones de programación (genéricos, closures, decoradores, etc.) explicados en contexto donde aparecen.

🚀 Inicio Rápido

1. Instala el plugin

/plugin marketplace add Lum1104/Understand-Anything
/plugin install understand-anything

2. Analiza tu código

/understand

Un pipeline multi-agente escanea tu proyecto, extrae cada archivo, función, clase y dependencia, y construye un grafo de conocimiento guardado en .understand-anything/knowledge-graph.json.

Salida localizada: Usa --language para generar contenido en tu idioma preferido:

# Genera contenido en el idioma preferido (descripciones de nodos y UI del dashboard)
/understand --language en

# Idiomas soportados: en (default), zh, zh-TW, ja, ko, ru

El parámetro --language afecta:

Resúmenes y descripciones de nodos en el grafo de conocimiento
Etiquetas, botones y tooltips de la UI del dashboard
Explicaciones de los tours guiados

3. Explora el panel

/understand-dashboard

Se abre un panel web interactivo con tu código visualizado como un grafo, codificado por colores según la capa arquitectónica, con funciones de búsqueda y clic. Selecciona cualquier nodo para ver su código, relaciones y una explicación en lenguaje natural.

4. Sigue aprendiendo

# Pregunta cualquier cosa sobre el código
/understand-chat How does the payment flow work?

# Analiza el impacto de tus cambios actuales
/understand-diff

# Profundiza en un archivo o función específica
/understand-explain src/auth/login.ts

# Genera una guía de incorporación para nuevos miembros del equipo
/understand-onboard

# Extrae conocimiento de dominio de negocio (dominios, flujos, pasos)
/understand-domain

# Analiza un wiki LLM con patrón Karpathy
/understand-knowledge ~/path/to/wiki

# Vuelve a ejecutarlo cuando quieras — incremental por defecto (solo archivos modificados)
/understand

# Instala un hook post-commit para actualizaciones incrementales automáticas
/understand --auto-update

# Acota el análisis a un subdirectorio (útil para monorepos enormes)
/understand src/frontend

🌐 Instalación Multiplataforma

Understand-Anything funciona en múltiples plataformas de codificación con IA.

Claude Code (Nativo)

/plugin marketplace add Lum1104/Understand-Anything
/plugin install understand-anything

Instalación de una línea (Codex / OpenCode / OpenClaw / Antigravity / Gemini CLI / Pi Agent / Vibe CLI / VS Code Copilot / Hermes / Cline / KIMI CLI)

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/Lum1104/Understand-Anything/main/install.sh | bash
# o pasa la plataforma directamente para saltar el prompt:
curl -fsSL https://raw.githubusercontent.com/Lum1104/Understand-Anything/main/install.sh | bash -s codex

Windows (PowerShell):

iwr -useb https://raw.githubusercontent.com/Lum1104/Understand-Anything/main/install.ps1 | iex

El instalador clona el repositorio en ~/.understand-anything/repo y crea los enlaces simbólicos correspondientes para la plataforma elegida. Reinicia tu CLI/IDE al terminar.

Valores soportados de <platform>: gemini, codex, opencode, pi, openclaw, antigravity, vibe, vscode, hermes, cline, kimi
Actualizar más adelante: ./install.sh --update
Desinstalar: ./install.sh --uninstall <platform>

Cursor

Cursor detecta automáticamente el plugin a través de .cursor-plugin/plugin.json cuando se clona este repositorio. No requiere instalación manual: simplemente clona y abre en Cursor.

Si la detección automática no lo reconoce, instálalo manualmente: abre Cursor Settings → Plugins, pega https://github.com/Lum1104/Understand-Anything en el campo de búsqueda y añádelo desde allí.

VS Code + GitHub Copilot

VS Code con GitHub Copilot (v1.108+) detecta automáticamente el plugin a través de .copilot-plugin/plugin.json cuando se clona este repositorio. No requiere instalación manual: simplemente clona y abre en VS Code.

Para habilidades personales (disponibles en todos los proyectos), ejecuta el install.sh de arriba con la plataforma vscode.

Copilot CLI

copilot plugin install Lum1104/Understand-Anything:understand-anything-plugin

Compatibilidad de Plataformas

Plataforma	Estado	Método de Instalación
Claude Code	✅ Nativo	Marketplace de plugins
Cursor	✅ Soportado	Detección automática
VS Code + GitHub Copilot	✅ Soportado	Detección automática
Copilot CLI	✅ Soportado	Instalación de plugin
Codex	✅ Soportado	`install.sh codex`
OpenCode	✅ Soportado	`install.sh opencode`
OpenClaw	✅ Soportado	`install.sh openclaw`
Antigravity	✅ Soportado	`install.sh antigravity`
Gemini CLI	✅ Soportado	`install.sh gemini`
Pi Agent	✅ Soportado	`install.sh pi`
Vibe CLI	✅ Soportado	`install.sh vibe`
Hermes	✅ Soportado	`install.sh hermes`
Cline	✅ Soportado	`install.sh cline`
KIMI CLI	✅ Soportado	`install.sh kimi`

📦 Comparte el Grafo con tu Equipo

El grafo es solo JSON — confírmalo una vez y tus compañeros se saltan el pipeline. Ideal para onboarding, revisiones de PR y flujos docs-as-code.

Ejemplo: GoogleCloudPlatform/microservices-demo (fork) — referencia políglota (Go / Java / Python / Node) con el grafo ya confirmado.

Qué confirmar: todo lo que hay en .understand-anything/ excepto intermediate/ y diff-overlay.json (archivos temporales locales).

.understand-anything/intermediate/
.understand-anything/diff-overlay.json

Mantenlo al día: activa /understand --auto-update — un hook post-commit parchea el grafo de forma incremental, así cada commit llega con su grafo correspondiente. O vuelve a ejecutar /understand manualmente antes de cada release.

Grafos grandes (10 MB o más): úsalos con git-lfs.

git lfs install
git lfs track ".understand-anything/*.json"
git add .gitattributes .understand-anything/

🔧 Bajo el Capó

Híbrido Tree-sitter + LLM

Lo determinista lo hace el análisis estático, lo semántico lo hace el LLM:

Tree-sitter (determinista) — parsea el código a un árbol de sintaxis concreto y extrae hechos estructurales: imports, exports, definiciones de funciones/clases, llamadas, herencia. Se preresuelve como importMap en la fase de escaneo y se pasa al file-analyzer para que no tenga que volver a derivar los imports desde el código fuente. La misma entrada siempre produce la misma salida, y también es la base de los fingerprints usados para las actualizaciones incrementales.
LLM (semántico) — lee la estructura parseada junto con el código original para producir lo que los parsers no pueden: resúmenes en lenguaje natural, etiquetas, asignaciones de capa arquitectónica, mapeo de dominios de negocio, tours guiados, notas sobre conceptos del lenguaje.

Esta división es la que hace que el grafo sea reproducible en lo estructural (el mismo código siempre genera las mismas aristas) y a la vez capture intención en lo semántico (para qué sirve un archivo, no solo qué importa).

Pipeline Multi-Agente

El comando /understand orquesta 5 agentes especializados, y /understand-domain añade un sexto:

Agente	Rol
`project-scanner`	Descubre archivos, detecta lenguajes y frameworks
`file-analyzer`	Extrae funciones, clases e importaciones; produce nodos y aristas del grafo
`architecture-analyzer`	Identifica capas arquitectónicas
`tour-builder`	Genera recorridos de aprendizaje guiados
`graph-reviewer`	Valida la completitud y la integridad referencial del grafo (se ejecuta inline por defecto; usa `--review` para una revisión completa con LLM)
`domain-analyzer`	Extrae dominios de negocio, flujos y pasos de proceso (usado por `/understand-domain`)
`article-analyzer`	Extrae entidades, afirmaciones y relaciones implícitas de artículos wiki (usado por `/understand-knowledge`)

Los analizadores de archivos se ejecutan en paralelo (hasta 5 concurrentes, 20-30 archivos por lote). Soporta actualizaciones incrementales: solo reanaliza los archivos que cambiaron desde la última ejecución.

🎥 Comunidad

Un recorrido en video hecho por la comunidad de Better Stack.

Ver en YouTube →

¿Has hecho un video, post o tutorial? Abre un issue o PR — estaremos encantados de mostrarlo aquí.

🤝 Contribuir

¡Las contribuciones son bienvenidas! Así puedes empezar:

Haz fork del repositorio
Crea una rama de funcionalidad (git checkout -b feature/my-feature)
Ejecuta las pruebas (pnpm --filter @understand-anything/core test)
Haz commit de tus cambios y abre un pull request

Para cambios importantes, abre primero un issue para que podamos discutir el enfoque.

Deja de leer código a ciegas. Empieza a entenderlo todo.

Historial de Stars

Gracias a todas las personas que lo han usado y han contribuido — saber que les ahorra tiempo es lo que hizo que valiera la pena construirlo.

16 KiB Raw Blame History