66 lines
3.1 KiB
Markdown
66 lines
3.1 KiB
Markdown
# Эксперимент 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
|
||
```
|
||
|
||
До такого решения артефакты графа лучше считать локальными.
|
||
|