SHA256
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
|
|
```
|
|
|
|
До такого решения артефакты графа лучше считать локальными.
|
|
|