Клиент Runtime и подключение IDE через ACP
Клиент Runtime и ACP-адаптер используют тот же Core, беседы, агентов и подтверждения, что обычный интерфейс. Подключение IDE не выдаёт ей доступ к файлам или терминалу сервера и не превращает её в доверенного администратора. Используйте действительное подключение исходного пользователя, а не машинный ключ с подставленным именем человека.
Подготовить подключение
Выберите адрес своего Core, существующую рабочую область и доступного вам агента. Сначала клиентское приложение согласует поддерживаемую версию протокола. При несовместимой версии используйте совместимое ПО, а не повторяйте запрос с выдуманной возможностью.
Публичный Go-клиент предоставляет client.NewRuntime, Negotiate, CreateSession, Prompt и Observe. Перед первой отправкой сохраните его ClientMessageID так, чтобы он сохранился после перезапуска. После тайм-аута или перезапуска вызовите Observe для той же беседы и сообщения. Это читает исходный запрос, а не запускает новую генерацию. Не используйте один идентификатор с другим текстом.
Создание новой беседы — отдельное действие. Если подтверждение её создания потерялось, сначала проверьте список бесед: автоматический повтор создания может добавить вторую беседу.
Использовать ACP
ACP-адаптер передаёт сообщения по стандартному вводу и выводу. Настройте -core, -workspace, -agent, -cwd и действительный пользовательский токен в AIHUMMER_RUNTIME_TOKEN. Не помещайте токен в общий проект или журнал. Значение -cwd обозначает проект IDE; оно не подключает каталог компьютера к серверу.
Поддерживается ACP1 и текстовый ввод. Передача произвольного MCP-сервера со стороны IDE, новые файловые или терминальные полномочия, изображения и аудио не принимаются этим адаптером. Отдельные инструменты Core продолжают работать только в пределах уже настроенных прав.
Для каждой беседы допускается один активный запрос. Две независимые беседы могут выполняться независимо. Загрузка беседы показывает сохранённые сообщения и исходные идентификаторы, но не отправляет незавершённый запрос повторно.
Подтверждение, отмена и обрыв связи
Запрос подтверждения инструмента передаётся пользователю с выбором разрешить один раз или отклонить. Пропавший, просроченный или некорректный ответ не означает согласие. Решение всё равно проверяет Core.
Явная отмена относится к конкретному активному исходному запросу. Отмена одной беседы не должна отменять другую. Закрытие соединения само по себе не подтверждает отмену; подтверждение принятого запроса отмены ещё не означает, что все выполнявшиеся операции остановлены. Клиентское приложение различает окончательный результат, принятое фоновое выполнение и неопределённый внешний эффект.
Частичный поток и конец соединения не заменяют сохранённый итог. Если результат неизвестен, восстановите исходное состояние, а не запускайте действие ещё раз. Внешние длительные операции имеют собственную проверку исходного идентификатора.