Загрузка hangoutsbot - Загрузка исходного кода hangoutsbot

hangoutsbot

AI Исходный код

Patch release

Скачать

Введение

Hangupsbot — чат-бот, предназначенный для работы с Google Hangouts.

Пожалуйста, посмотрите:

Инструкции по установке
Отслеживание ошибок, проблем и запросов функций
Вики обо всем остальном

Ссылки на репозиторий

Организация GitHub
Проект перевода
Справочная библиотека Hangups

Функции

Упоминания : если кто-то упоминает вас в комнате, вы получите частную видеовстречу от бота с подробной информацией об упоминании, включая контекст, комнату и человека, который вас упомянул.
Синкауты . Синкаут — это два групповых чата Hangouts, сообщения которых пересылаются друг другу, что обеспечивает беспрепятственное взаимодействие между двумя комнатами. В основном используется для преодоления лимита в 150 участников чата, но его также можно использовать для временного объединения команд для взаимодействия.
Синкауты между чатами : половина вашей команды использует Slack? Без проблем! Вы можете соединить их в одной комнате для общения. Скоро появится поддержка других чат-клиентов.
Интеграция с Hubot : Hangupsbot позволяет вам подключиться к Hubot, мгновенно предоставляя вам доступ к сотням разработанных инструментов чата и плагинов.
Плагины и приемники : у бота есть инструкции по разработке собственных плагинов и приемников, позволяющие боту взаимодействовать с внешними сервисами, такими как веб-сайт вашей компании, скрипты Google и многое другое.
Мания плагинов : игры, поддержка псевдонимов, подписанные ключевые слова, настраиваемый API — список можно продолжать !

Запуск бота

Примечание. Первый запуск? См. инструкции по установке

Для выполнения: python3 hangupsbot.py

 usage: hangupsbot [-h] [-d] [--log LOG] [--cookies COOKIES] [--memory MEMORY] [--config CONFIG] [--version]

optional arguments:
-h, --help         show this help message and exit
-d, --debug        log detailed debugging messages (default: False)
--log LOG          log file path (default:
                   ~/.local/share/hangupsbot/hangupsbot.log)
--cookies COOKIES  cookie storage path (default:
                   ~/.local/share/hangupsbot/cookies.json)
--memory MEMORY    memory storage path (default:
                   ~/.local/share/hangupsbot/memory.json)
--config CONFIG    config storage path (default:
                   ~/.local/share/hangupsbot/config.json)
--version          show program's version number and exit

Настройка бота для администраторов

Директивы конфигурации можно указать в config.json .

Обратите внимание, что файл config.json , поставляемый с репозиторием, не подлежит редактированию/изменению. Это справочный файл, используемый ботом для создания фактического файла конфигурации, расположенного в другом месте системы. Чтобы узнать, где находится настоящий файл, обратитесь к разделу «Дополнительная конфигурация» в инструкциях по установке.

Большинство директив конфигурации указаны глобально.

Глобальные директивы всегда указываются в «корне» config.json .
Чтобы указать директиву для каждого разговора, необходимо определить тот же параметр конфигурации как config.conversations[<conversation-id>].<configuration option> .
Директивы для каждого разговора переопределяют глобальные настройки, если оба они установлены.
Директивы, настроенные вручную для каждого диалога, УСТАРЕЛИ.

Плагины

Ключ plugins в config.json позволяет вам дополнительно указать список плагинов, которые будут загружаться ботом при запуске. Если для этой опции оставить значение null , будут загружены все доступные плагины.

Чтобы указать плагины для загрузки, сначала убедитесь, что правильные файлы .py находятся в вашем каталоге hangupsbot/plugin/ , затем измените ключ plugins в config.json чтобы указать, какие плагины/файлы вы хотите загрузить, например plugins: ["mentions", "default", "chance", "syncrooms"]

Некоторые плагины могут потребовать дополнительной настройки. config.json — поставщик конфигурации для бота и его плагинов.

Несколько интересных плагинов:

упоминает плагин
- предупреждать пользователей, когда их имена упоминаются в чате
плагин подписки
- оповещать пользователей, когда ключевые слова, на которые они подписаны, произносятся в чате
плагины syncout/syncrooms
- ретранслировать сообщения чата между различными групповыми беседами Hangouts (syncrooms)
- настроить через команды бота (syncrooms_config)
- автоматический перевод пересылаемых сообщений через Google Translate (syncrooms_autotranslate)

В вики есть более полный список плагинов ...

Взаимодействие с ботом

Существует два основных типа взаимодействия с ботом:

Команды /bot начинаются с /bot например /bot dosomething
- некоторые команды бота доступны только администратору
пользовательские взаимодействия (использование и доступность зависят от плагина)

Базовый бот поддерживает некоторые базовые команды даже без загрузки каких-либо плагинов. Вот неполный список:

/bot help

Бот перечисляет все поддерживаемые команды в личном сообщении пользователю.

/bot ping

Бот отвечает pong .

/bot version

Бот отвечает номером версии фреймворка

Полный список команд, поддерживаемых базовой платформой, доступен на вики-странице Core Commands .

В вики также есть список плагинов с подробным описанием доступных плагинов со списками команд и их использованием.

Обновление

Перейдите в каталог бота (например, cd ~/hangupsbot ).
Перейдите на последнюю стабильную ветку с помощью git checkout master
git pull , чтобы получить последнюю версию Hangupsbot
pip3 install -r requirements.txt --upgrade
Перезапустите бота

Отладка

Запустите бота с параметром -d , например, python3 hangupsbot.py -d — это понизит уровень журнала до INFO для более подробного и информативного файла журнала.
tail файл журнала, который, вероятно, находится по адресу /<user>/.local/share/hangupsbot/hangupsbot.log — его расположение зависит от дистрибутива!
Вывод консоли (STDOUT) довольно ограничен независимо от уровня журнала, поэтому вместо этого полагайтесь на вывод файла журнала.

Советы по устранению неполадок

Программа не запускается:

Обновите hangupsbot и hangups
Запустите hangups , чтобы проверить, работает ли исходная библиотека зависаний.
- Если есть ошибки, удалите файл cookie в ``~/.local/share/hangupsbot/cookies.json` и повторите попытку.
- Войдите в свой аккаунт Google с адреса сервера.

Бот не отвечает на сообщения: