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,5 @@
+upstream/
+work/
+.understand-anything/
+*.log
+
@@ -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
+```
+
+До такого решения артефакты графа лучше считать локальными.
+
@@ -0,0 +1,29 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)"
+UPSTREAM_DIR="$SCRIPT_DIR/upstream"
+
+if [[ ! -d "$UPSTREAM_DIR/.git" ]]; then
+  echo "Не найден локальный upstream-клон: $UPSTREAM_DIR" >&2
+  echo "Сначала выполните:" >&2
+  echo "  git clone --depth 1 https://github.com/Lum1104/Understand-Anything.git \"$UPSTREAM_DIR\"" >&2
+  exit 1
+fi
+
+if ! command -v node >/dev/null 2>&1; then
+  echo "Не найден Node.js. Для полноценного запуска Understand Anything нужен Node.js 22+." >&2
+  exit 1
+fi
+
+if ! command -v pnpm >/dev/null 2>&1; then
+  echo "Не найден pnpm. Для полноценного запуска Understand Anything нужен pnpm 10+." >&2
+  echo "Skills можно установить, но команда /understand не соберёт core без pnpm." >&2
+fi
+
+UA_DIR="$UPSTREAM_DIR" "$UPSTREAM_DIR/install.sh" codex
+
+echo
+echo "Skills Understand Anything установлены для Codex из локального клона."
+echo "Перезапустите Codex-сессию перед использованием /understand."
+