Understand-Anything：代码库的交互式知识图谱 — 60K+ 星 2026

# Install via npm (TypeScript-based CLI)
npm install -g understand-anything

# Or use via Docker
docker run -v $(pwd):/code ghcr.io/egonex-ai/understand-anything:latest /code

# npm installation (recommended)
npm install -g understand-anything

# Verify
understand-anything --version

# Pull latest image
docker pull ghcr.io/egonex-ai/understand-anything:latest

# Analyze a codebase
docker run --rm -v $(pwd):/code \
  ghcr.io/egonex-ai/understand-anything:latest \
  /code --output ./knowledge-graph.json

git clone https://github.com/Egonex-AI/Understand-Anything.git
cd Understand-Anything
npm install
npm run build
npm link  # global install

pip install understand-anything-python

from understand_anything import CodebaseAnalyzer

analyzer = CodebaseAnalyzer("/path/to/codebase")
analyzer.build_graph()
analyzer.export_graph("graph.json")

{
  "include": ["src/**/*.{ts,tsx,js,jsx}", "tests/**/*"],
  "exclude": ["node_modules", "dist", "*.test.*"],
  "languages": ["typescript", "python", "rust", "go"],
  "embedding_model": "all-MiniLM-L6-v2",
  "max_file_size": 50000,
  "max_depth": 5
}

# Add knowledge graph to Claude Code context
understand-anything analyze ./src --format claude-code

# Claude Code automatically loads the graph for context-aware responses

# Install the Cursor extension
# Settings → Extensions → Understand-Anything
# Point to your project root

# Cursor will show the knowledge graph sidebar
# Click any node to navigate to the source

# Generate a .copilot context file
understand-anything analyze ./src --format copilot

# Creates .github/copilot-instructions.md with
# graph-derived context for Copilot

# Install from marketplace
# vscode-marketplace: egonex.understand-anything

# Or CLI install
npx @egonex/vscode-extension install

# Generate onboarding graph
understand-anything analyze ./src --onboarding

# Outputs:
# - Architecture overview (HLD + LLD)
# - Key entry points
# - Module dependency map
# - Common patterns and anti-patterns

# Find all files that reference deprecated API
understand-anything query "deprecated authentication endpoints"

# Returns: 23 files, 47 references
# With full dependency chains

// Add support for a new language
import { LanguagePlugin } from 'understand-anything';

class MyLangPlugin implements LanguagePlugin {
  name = 'mylang';
  
  parse(source: string): ASTNode {
    // Your language-specific parser
    return parseMyLang(source);
  }
  
  extractDependencies(node: ASTNode): Dependency[] {
    return extractMyDeps(node);
  }
}

// Register plugin
registerPlugin(new MyLangPlugin());

# Find all functions called by more than 5 other functions
understand-anything gql "func where call_count > 5 order by call_count desc"

# Find orphan files (no incoming references)
understand-anything gql "file where incoming_refs == 0"

# Find circular dependencies
understand-anything gql "cycle where type == 'import'"

# .github/workflows/graph-check.yml
name: Knowledge Graph CI
on: [pull_request]

jobs:
  analyze:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Build knowledge graph
        run: |
          npx understand-anything analyze ./src --format ci
      - name: Check for circular dependencies
        run: |
          npx understand-anything gql "cycle" \
            | tee graph-violations.json
      - name: Upload violations
        if: failure()
        uses: actions/upload-artifact@v4
        with:
          name: graph-violations
          path: graph-violations.json

# Use incremental analysis (fastest for dev workflows)
understand-anything analyze ./src --incremental

# Cache graph for repeated queries
understand-anything analyze ./src --cache ./graph-cache.db

# Parallel analysis for large codebases
understand-anything analyze ./src --workers 8

# Memory-efficient mode (for constrained environments)
understand-anything analyze ./src --low-memory

# JSON (programmatic access)
understand-anything analyze ./src --format json -o graph.json

# DOT (Graphviz visualization)
understand-anything analyze ./src --format dot -o graph.dot
# Then: dot -Tpng graph.dot -o graph.png

# Mermaid (Markdown diagrams)
understand-anything analyze ./src --format mermaid -o graph.mmd

# HTML (interactive viewer)
understand-anything analyze ./src --format html -o graph.html
# Opens in browser with zoom, pan, search