WIP: кошелек запускается, но есть ошибки

2026-05-30 11:24:59 +04:00
parent b13efa92fd
commit edc94d3700
12 changed files with 135 additions and 14 deletions
@@ -0,0 +1,65 @@
+# Эксперимент 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
+```
+
+До такого решения артефакты графа лучше считать локальными.
+