# Локальный узел A2A Work — инструкция ## Что это Локальный узел A2A Work — это программа, которая работает прямо на вашем устройстве, обеспечивая безопасное хранение ваших данных и взаимодействие с сетью A2A Work. Все ваши данные (резюме, аккаунт, переписка) остаются у вас, а на релей уходят только слепки из кодов (без имени, контактов и текста; методика слепка v9, схема события 1.0), вопросы и приглашения кодами и зашифрованные сообщения. Узел запускается просто, без сложной установки, и позволяет подключить веб-чаты (например, DeepSeek или Qwen) для управления поиском работы или кандидатов через MCP-расширение. ## Скачать и запустить Для запуска не требуются навыки программирования или использование консоли. Скачайте портативный пакет для вашей системы: * **Windows:** Скачайте `A2A-Node-<версия>-win-x64.zip`. Внутри находится портативный Node.js и узел. Распакуйте и дважды кликните файл `Запустить A2A-узел.cmd` (или `Start A2A node.cmd`). * **macOS:** Скачайте `A2A-Node-<версия>-darwin-arm64.tar.gz` (для процессоров Apple) или `-darwin-x64.tar.gz` (для Intel). Распакуйте и дважды кликните файл `Запустить A2A-узел.command` (или `Start A2A node.command`). Программа не подписана — при первом запуске Gatekeeper может заблокировать; откройте файл через правую кнопку мыши → «Открыть» или перейдите в «Системные настройки → Конфиденциальность и безопасность → Всё равно открыть» [проверить: точные пункты в текущей macOS]. * **Linux:** Скачайте `A2A-Node-<версия>-linux-x64.tar.gz`. Распакуйте и запустите `./run-local-node.sh`. Если двойной клик не запускает, дайте права на выполнение: `chmod +x run-local-node.sh && ./run-local-node.sh`. После запуска узел стартует на `http://127.0.0.1:7010`, и браузер автоматически откроет `http://127.0.0.1:7010/local` — страницу первого запуска. Никакой установки Node, npm или консоли. **Для тех, у кого Node.js (версия ≥ 20) уже установлен:** Распакуйте `a2a-release-dist-<хэш>.tar.gz` и запустите скрипт `release/deploy/local/run-local-node.sh` (Linux/macOS) или `run-local-node.cmd` (Windows). Скрипт при первом запуске выполняет `npm ci --omit=dev`, затем стартует узел. Параметры узла: `--port 7010`, `--relay https://a2awork.ru`, `--data <папка>`, `--lang ru|en`, `--open` (открыть браузер). ## Подключить чат 1. Установите расширение MCP-SuperAssistant (Chrome/Firefox; mcpsuperassistant.ai или github.com/srbhptl39/MCP-SuperAssistant). 2. Добавьте сервер `http://127.0.0.1:7010/mcp`, тип Streamable HTTP [проверить: название поля в текущей версии расширения]. 3. В чате DeepSeek или Qwen напишите: «Зарегистрируй аккаунт кандидата в A2A Work, метка: <ваша метка>». 4. Ссылка вида `http://127.0.0.1:7010/link/<КОД>` откроется на вашем узле → нажмите «Разрешить». 5. В чате напишите: «Вызови whoami» — это подтвердит подключение. ## Что дальше Полные сценарии: [SCENARIOS-CHAT.md](SCENARIOS-CHAT.md). **Кандидат:** | Шаг | Что сказать | Что вызовется | Где нужен браузер | |---|---|---|---| | 1. Публикация | «Вот мое резюме (текст).» | `publish_resume` | Чат | | 2. Слепок | «Собери слепок из моего резюме.» | `build_cv_slepok` | Чат | | 3. Согласие | «Я согласен опубликовать это.» | — | **Браузер (`http://127.0.0.1:7010/account/confirm`)** | | 4. В сеть | «Публикуй.» | `publish_cv_slepok` | Чат | | 5. Поиск | «Найди мне вакансии.» | `search_vacancies_slepok` | Чат | | 6. Аналитика | «Покажи аналитику из моего слепка.» | `my_analytics` | Чат → **Браузер (`http://127.0.0.1:7010/account/analytics`)** | **Компания:** | Шаг | Что сказать | Что вызовется | Где нужен браузер | |---|---|---|---| | 1. Публикация | «У меня есть текст вакансии. Опубликуй.» | `publish_vacancy` | Чат | | 2. Сборка слепка | «Подготовь слепок для этой вакансии.» | `compile_vacancy_slepok` | Чат | | 3. Подтверждение | «Подтверждаю требования 1, 2...» | `publish_vacancy_slepok` | Чат | | 4. Поиск | «Найди подходящих кандидатов.» | `search_candidates_slepok` | Чат | | 5. Уточнение | «Спроси кандидата X про код Y.» | `ask_slepok_question` | Чат | | 6. Приглашение | «Пригласи кандидата X.» | `invite_candidate` | Чат | ## Где ваши данные Папка данных: Windows `C:\Users\<имя>\.a2a\local`, macOS/Linux `~/.a2a/local`. Внутри: `accounts.json` (аккаунт и ключ), `links.json` (подтверждения), `state.json`, `release/` (журнал: резюме, факты, слепок, черновики, переписка). Всё это не покидает устройство. В сеть уходят только: опубликованный слепок из кодов, вопросы и приглашения кодами, зашифрованные сообщения. Что видит чат: чат нейросети видит то, что вы пишете и что показывают инструменты. Аналитика из слепка считается на вашем устройстве и не является рейтингом или прогнозом найма. Расширение SuperAssistant — стороннее; до 16.09 вживую с этим узлом не проверялось — см. таблицу «Проверено» ниже. Что не присылать в поддержку: токены, ссылки `/link/`, коды восстановления, содержимое `accounts.json`. ## Резервная копия, удаление, остановка узла - Узел работает, пока его окно открыто; закрыли — остановилось (данные остались). Автозапуска и трея нет. - Резервная копия и удаление — кнопки на странице `http://127.0.0.1:7010/local`. Архив содержит ключи и текст резюме. - Удаление данных на устройстве не отзывает опубликованный слепок — сначала отзовите согласие в кабинете. ## Если не работает - **Порт занят:** запустить с `--port 7011` и поменять адрес в расширении. - **Браузер не открылся:** открыть адрес `http://127.0.0.1:7010/local` вручную. - **Расширение не видит узел:** проверить адрес и тип подключения; открыть `http://127.0.0.1:7010/health` — должен ответить JSON. - **macOS Gatekeeper:** открыть правой кнопкой → «Открыть». - **Linux права:** выполнить `chmod +x run-local-node.sh`. ## Проверено | дата | ОС | браузер (версия) | версия расширения | способ подключения (напрямую / прокси, версия прокси) | сервис (DeepSeek / Qwen) | узел (.ru / .net) | сеть (без VPN / VPN) | пройденные шаги | ожидаемый / фактический результат | блокер | |---|---|---|---|---|---|---|---|---|---|---| | | | | | | | | | | | | | | | | | | | | | | | |