🤖 DSH Browser Bridge

Дайте вашему ИИ-агенту руки в настоящем Chrome — наглядно, безопасно и с возможностью самоулучшения.

Chrome-расширение + локальный мост, которые позволяют агенту (DeepSeek Harness, Claude Code, Codex и др.) управлять вашим реальным браузером Chrome через chrome.debugger (CDP). Никакого отдельного браузера, Playwright или MCP — агент работает именно в том Chrome, где установлено расширение: с вашими логинами, куками и профилем.

агент ──HTTP──▶ мост (127.0.0.1:8787) ──WebSocket──▶ расширение Chrome
                                                       │
                                                       ▼
                                               chrome.debugger → ваши вкладки

✨ Возможности

• Человеческие действия — human_click / human_move / human_type: плавные траектории мыши по кривой Безье с естественными паузами и джиттером (меньше шансов срабатывания антибот-защиты); human_type умеет клик-фокус, очистку поля и Enter.
• Экономия — page_snapshot отдаёт карту всех видимых кнопок/ссылок/полей с координатами одним вызовом: агенту не нужны десятки DOM-запросов и скриншоты.
• Всё видно — баннер «DSH-агент работает на этой странице», призрачный курсор следует за каждым движением, клики подсвечивают элемент кольцом и обводкой.
• Вкладки с подписью — вкладки агента объединяются в синюю группу «DSH-агент» и получают заголовок 🤖 DSH · <заголовок страницы>: видно, не открывая вкладку.
• Фоновый режим — вкладки агента открываются неактивными, ваш фокус никто не перехватывает.
• Само-обновление — агент перезагружает расширение удалённо (reload_extension) и может улучшать код собственных «рук» без участия человека.
• Локально и приватно — мост слушает только 127.0.0.1, соединение защищено случайным токеном; данные не покидают ваш компьютер.

🚀 Быстрый старт (без ручного ввода токена)

1. Сервер: macOS — двойной клик по browser-bridge/start.command; вручную — node browser-bridge/server/index.mjs. Сервер слушает только 127.0.0.1.
2. Расширение: chrome://extensions → «Режим разработчика» → «Загрузить распакованное» → выберите папку browser-bridge/extension/.
3. Готово — расширение само получит токен с локального сервера (поле «Токен» можно не трогать). Статус «подключено к мосту» — всё работает.
4. Команды: ./bridge.sh list_tabs, ./bridge.sh open_tab /tmp/p.json, ./bridge.sh human_click /tmp/xy.json <tabId> — полный список в AGENTS.md.

🌐 Сайт проекта

Лендинг на GitHub Pages

📱 Пульт задач в Telegram

telegram-bot/ — Телеграм-бот, подключающийся к локальному DeepSeek Harness (Web GUI, порт 3080) по его же HTTP/WebSocket-API: реалтайм-стриминг вывода агента в чат, остановка процесса (/stop), корректировки текстом и голосом (локальный whisper.cpp — аудио не покидает машину), ответы на вопросы и запросы разрешений агента кнопками.

🤖 Для агентов: самообучающаяся машина

Этот репозиторий — не просто расширение. Агент, работающий в нём, может улучшать сам себя: править extension/background.js, применять изменения мгновенно через reload_extension и проверять результат через мост — замкнутый цикл без человека.

Полная инструкция для агентов (команды, паттерн добавления новых команд, оверлей, правила безопасности, чек-лист тестирования): AGENTS.md.

🔒 Безопасность

• Сервер слушает только 127.0.0.1 и требует токен; расширение подключается только к ws://127.0.0.1:* с проверкой Origin.
• Управляемые вкладки помечаются жёлтой плашкой Chrome «debugging» — всегда видно, когда идёт управление.
• Убрать плашку: запустите Chrome с флагом --silent-debugger-extension-api (macOS: двойной клик по browser-bridge/chrome-silent.command; Windows/Linux — добавьте флаг в ярлык/команду запуска). Плашка исчезает, баннеры агента остаются.
• Кнопка «Отключить управление всеми вкладками» в попапе — мгновенная остановка.
• Политика конфиденциальности: PRIVACY.md.

📦 Установка без магазина (ZIP)

Готовый пакет для ручной установки (manifest.json в корне): dsh-browser-bridge-v0.4.0.zip в Release v0.4.0. На каждом теге v* GitHub Action собирает свежий ZIP автоматически.

🤝 Участие

Звёзды, issues, PR — приветствуются! См. CONTRIBUTING.md.

📄 Лицензия

MIT