SHiNE-server/tools/understand-anything-lab/README.md

Эксперимент Understand Anything

Эта папка нужна, чтобы безопасно проверить Lum1104/Understand-Anything в SHiNE без подключения к сборке, деплою и рабочему серверному коду.

Что здесь лежит

• upstream/ - локальный клон https://github.com/Lum1104/Understand-Anything.git; он игнорируется git, чтобы не тащить внешний репозиторий внутрь SHiNE.
• install_codex_skills.sh - локальная установка skills для Codex из уже скачанного upstream/, без curl | bash.

Проверенный upstream:

• commit: 26edf61856fa476e466bda1814819a266a293c47
• дата commit: 2026-05-26T13:09:57+08:00
• сообщение: Merge pull request #235 from ZebangCheng/feat/add-trae-platform

Безопасный сценарий проверки

1. Подготовить окружение:

   node --version
   pnpm --version
   

   Для полноценного запуска нужен Node.js 22 или новее и pnpm 10 или новее. На текущей машине при первичной проверке были обнаружены Node.js v18.19.1 и отсутствие pnpm, поэтому полноценный /understand пока не запускался.

2. Установить skills для Codex из локального клона:

   ./tools/understand-anything-lab/install_codex_skills.sh
   

   Скрипт использует локальный tools/understand-anything-lab/upstream, а не скачивает установщик из интернета.

3. Перезапустить Codex-сессию, чтобы появились команды/skills:

   /understand --language ru
   /understand-dashboard
   

4. После первого запуска проверить созданный файл:

   ls -la .understand-anything/
   

Что не делать без отдельного решения

• Не включать Understand Anything в Gradle-сборку.
• Не добавлять его в deployServer или deployUI.
• Не переносить серверные модули в новую папку одновременно с этим экспериментом.
• Не включать auto-update hook через /understand --auto-update, пока не понятно, нужен ли граф в каждом commit.

Что можно коммитить позже

Если эксперимент подтвердится, можно будет отдельно решить, нужно ли хранить .understand-anything/knowledge-graph.json в репозитории. По рекомендации upstream обычно коммитят содержимое .understand-anything/, кроме:

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

До такого решения артефакты графа лучше считать локальными.