# Эксперимент 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. Подготовить окружение:

   ```bash
   node --version
   pnpm --version
   ```

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

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

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

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

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

   ```text
   /understand --language ru
   /understand-dashboard
   ```

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

   ```bash
   ls -la .understand-anything/
   ```

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

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

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

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

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

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