@thesashadev/girl-agent 0.3.2 → 0.4.1

package/CHANGELOG.md

@@ -1,5 +1,64 @@
 # Changelog
 
+## 0.4.1
+
+Дата: 2026-05-14
+
+🐛 Исправления
+- Исправлены некорректные Docker URL, из‑за которых могли ломаться загрузка образов
+- Устранены проблемы с памятью при работе с медиа (снижение утечек/чрезмерного потребления)
+- Исправлены ошибки в процессе установки и в веб‑интерфейсе (WebUI), мешавшие корректной настройке
+
+🔧 Улучшения
+- Улучшен пользовательский опыт аддонов: доработан интерфейс и поведение при взаимодействии с расширениями
+
+
+## 0.4.0
+
+Дата: 2026-05-14
+
+🚀 Новое
+
+- WebUI теперь показывает сразу 3 понятные ссылки при запуске:
+  - `http://127.0.0.1:<port>` — для локального запуска на этой же машине;
+  - `http://localhost:<port>` — привычный локальный адрес;
+  - `http://<public-ip>:<port>` — адрес, который удобно открыть с основного ПК, если girl-agent запущен на сервере, VPS или в Docker.
+- Добавлена авторизация WebUI. Если задан `GIRL_AGENT_WEBUI_PASSWORD` или `GIRL_AGENT_WEBUI_TOKEN`, интерфейс просит пароль и защищает API/WebSocket от доступа без входа. При обычном локальном запуске без переменной окружения WebUI остаётся максимально удобным и не требует пароль.
+- Добавлена поддержка Telegram-прокси формата `tg://proxy?server=...&port=...&secret=...`. Теперь можно вставлять ссылку из Telegram напрямую, без ручного перевода в socks-формат.
+- Добавлено осторожное обнаружение известных интернет-мемов в медиа без reverse image search. Если vision-модель уверенно понимает, что изображение — известный мем, эта информация передаётся персоне; если уверенности нет, картинка считается обычной, чтобы не плодить false positive.
+- Для Termux добавлен отдельный low-memory build-сценарий: сборка старается потреблять меньше ОЗУ именно на этапе компиляции, при этом качество ответов, лимиты токенов и runtime-память диалогов не урезаются.
+- WebUI теперь использует отдельный React/Vite-интерфейс из папки `webui/` как основной пользовательский интерфейс. Встроенная серверная часть `src/webui` остаётся backend/API/runtime-слоем.
+
+🔧 Улучшения
+
+- Минимальная версия Node.js снижена с 20 до `18.18+`. На Node 18/19 приложение больше не останавливается из-за жёсткого требования Node 20: показывается предупреждение, но запуск продолжается.
+- Установка в Termux теперь использует `pkg install nodejs`, проверяет установленную версию Node и даёт понятную подсказку, если нужна установка/обновление.
+- Docker-запуск стал удобнее для реального сервера: порт `3000` пробрасывается наружу, WebUI слушает `0.0.0.0`, а контейнер запускается от текущего пользователя, чтобы не создавать файлы с неожиданными правами root.
+- Улучшена работа с папкой `data`: если текущая директория недоступна для записи, girl-agent выбирает нормальное пользовательское хранилище вместо падения с `permission denied`.
+- `GIRL_AGENT_PUBLIC_URL` продолжает поддерживаться для reverse proxy/доменов, но теперь не скрывает локальные ссылки — пользователь всё равно видит все варианты входа.
+- В userbot-настройке API ID/API HASH больше не требуются там, где выбран сценарий «прокси автора». Если пользователь выбирает свои Telegram API credentials, поля остаются обязательными.
+- Для владельческого proxy-flow добавлены переменные `GIRL_AGENT_OWNER_PROXY_API_ID` и `GIRL_AGENT_OWNER_PROXY_API_HASH` с fallback на `GIRL_AGENT_TG_API_ID`/`GIRL_AGENT_TG_API_HASH`.
+- WebUI dev-server теперь слушает `0.0.0.0`, чтобы интерфейс было проще открыть снаружи VM/сервера во время разработки.
+- В сборке WebUI явно закреплён `esbuild`, чтобы избежать несовпадения JS-обёртки и native binary при разных install-сценариях.
+- Сохранены и расширены улучшения из текущего PR: более понятные Docker URL, исправления медиа/стикеров, безопасная память о не-владельцах, UX аддонов и улучшения desktop installer.
+
+🐛 Исправления
+
+- Исправлена ошибка `runtime start failed: Invalid sockets params: ip=undefined, port=undefined, socksType=undefined`, которая возникала из-за неподдержанного `tg://proxy` или некорректно разобранного proxy URL.
+- Исправлена проблема, когда после изменения настроек и нажатия «Применить» значения в WebUI визуально возвращались на старые, хотя после перезагрузки уже были сохранены. Теперь draft очищается только после успешного сохранения/применения.
+- Исправлено зависание на генерации персоны: если persona-файлы уже есть, они переиспользуются; если LLM не отвечает или падает, создаётся базовый persona pack, чтобы мастер настройки не висел бесконечно.
+- Исправлены permission denied сценарии при создании `data` в Linux/Docker, из-за которых раньше мог потребоваться ручной `chmod`.
+- Исправлены проблемы с Telegram media pipeline: фото и статичные стикеры корректнее передаются в vision-контекст, а повторные стикеры не создают лишние дубли в памяти.
+- Исправлены edge cases в installer/desktop flow: обновление runtime стало атомарнее, а вставка через Ctrl/Cmd+V лучше работает даже при кириллической раскладке.
+
+📝 Для пользователя
+
+- Если запускаешь локально — открывай `127.0.0.1` или `localhost`.
+- Если запускаешь на сервере или в Docker — пробрось порт и открывай ссылку с public IP.
+- Если хочешь закрыть WebUI паролем — запусти с `GIRL_AGENT_WEBUI_PASSWORD=твой_пароль`.
+- Если используешь Telegram proxy-ссылку — теперь можно вставлять прямо `tg://proxy?...`.
+- Если запускаешь на телефоне в Termux — используй обычный Termux `nodejs`; Node 20 больше не обязателен, но нужна версия `18.18+`.
+
 ## 0.3.2
 
 Дата: 2026-05-13