diff --git a/README.md b/README.md index 5d3cf23..66ffa81 100644 --- a/README.md +++ b/README.md @@ -258,9 +258,10 @@ dsh-memory/ content/ content.js — ISOLATED-скрипт, парсер вызовов parser.js — разбор маркеров DSH - panel.js — панель в правом нижнем углу + panel.js — панель в правом нижнем углу, бокс ArtCraft + bridge-client.js — клиент моста для панели (sendCall, fetchBridge, health) chat-logger.js — инжект MAIN-скрипта - overlay.css — стили панели + overlay.css — стили панели и бокса ArtCraft injected/ chat-logger.js — MAIN-скрипт, перехват XHR memory/ @@ -525,12 +526,47 @@ Discovery двухуровневый: Признак, что подключились к окну: `inspect_ui` отвечает (возвращает `graphicsAdapter`, `window`, `perf.fps`). В headless он падает с ошибкой «needs the desktop app». -**Включить live-режим (код моста менять не нужно):** +### Бокс ArtCraft в панели (главный способ) + +В панели DSH Memory внизу справа есть сворачиваемая строка **▶ ArtCraft**. Клик по ней раскрывает бокс со всеми найденными приложениями. Это заменяет `cmd`, `--control`, `netstat` и перезапуск моста — всё делается двумя кликами. + +**Что внутри:** + +- **Поле пути** (`V:\artcraft` по умолчанию) и кнопка **↻** — сменить папку и пересканировать. Нужно, если поставили ArtCraft в другое место или установили новое приложение после старта моста. +- **Список приложений** — только установленные. Чего нет на диске, того нет в списке. +- **Строка приложения:** точка статуса, имя, метка, кнопки. + +**Статусы (точка слева):** + +| Точка | Метка | Что значит | +|---|---|---| +| серая | — | окно закрыто, MCP-клиент не поднят | +| зелёная | `win` | окно открыто, клиент ещё не поднят | +| зелёная | `Nt` | клиент поднят, N инструментов доступно | +| жёлтая (мигает) | `...` | идёт запуск окна или подхват клиента | +| красная (мигает) | `err` | ошибка, причина в тултипе | + +**Кнопки справа:** + +- **⏻ (питание)** — запустить окно приложения с нужным `--control <порт>`. Мост сам ждёт открытия порта и подхватывает MCP-клиент — через секунду-две метка сменится на число инструментов. Когда окно уже открыто, кнопка становится **✓**. +- **stop** — закрыть MCP-клиент (окно остаётся). Полезно, если клиент завис или нужно переподключить после ручного перезапуска окна. + +Пока бокс раскрыт, статус обновляется каждые 5 секунд. Закрыли бокс — обновление останавливается. + +**Порты.** У каждого приложения свой порт (7979–7995), поэтому несколько редакторов могут работать одновременно. Порты заданы в `mcp-registry.js`, переопределяются через `config.json` → `mcpServers.artcraft.ports`. + +**Кнопки ⏻ нет у двух приложений:** PdfCraft и Craft Anything. У них CLI не умеет подключаться к окну — работают только headless. В тултипе написано «no live control». + +### Live-режим вручную (если панель недоступна) + +Тот же результат без расширения: 1. Закрыть приложение. -2. Запустить: `"V:\artcraft\VectorCraft\vectorcraft.exe" --control 7979` (или через ярлык с этим флагом). +2. Запустить: `"V:\artcraft\VectorCraft\vectorcraft.exe" --control 7979`. 3. Проверить: `netstat -ano | findstr :7979` — должно быть `LISTENING`. 4. Перезапустить мост (`stop-dsh-memory.cmd`, затем `start-dsh-memory.cmd`). +Важно: CLI кэширует соединение. Если окно подняли **после** старта клиента, он сам не переподключится. Кнопка ⏻ в панели это лечит (закрывает старый клиент), а при ручном запуске нужен перезапуск моста или 5 минут простоя. + ### Инструменты На каждое найденное приложение регистрируются два инструмента: