Unduhan hangoutsbot - pengunduhan kode sumber hangoutsbot

hangoutsbot

Kode Sumber AI

Patch release

Unduh

Perkenalan

Hangupsbot adalah bot obrolan yang dirancang untuk bekerja dengan Google Hangouts.

Silakan lihat:

Petunjuk untuk menginstal
Pelacak masalah untuk bug, masalah, dan permintaan fitur
Wiki untuk yang lainnya

Tautan Repositori

Organisasi GitHub
Proyek Penerjemahan
Referensi Perpustakaan Hangups

Fitur

Sebutan : Jika seseorang menyebut Anda di suatu ruangan, terima hangout pribadi dari bot dengan detail penyebutan tersebut, termasuk konteks, ruangan, dan orang yang menyebut Anda.
Sinkronisasi : Sinkronisasi adalah dua obrolan grup Hangout yang pesannya diteruskan satu sama lain, sehingga memungkinkan interaksi yang lancar antara dua ruang. Terutama digunakan untuk melampaui batas obrolan 150 anggota, tetapi juga dapat digunakan untuk menghubungkan tim untuk sementara waktu guna berinteraksi.
Sinkronisasi Cross-chat : Setengah dari tim Anda menggunakan Slack? Tidak masalah! Anda dapat menghubungkan mereka ke ruangan yang sama untuk berkomunikasi. Dukungan untuk klien obrolan lainnya segera hadir.
Integrasi Hubot : Hangupsbot memungkinkan Anda terhubung ke Hubot, langsung memberi Anda akses ke ratusan alat obrolan dan plugin yang dikembangkan.
Plugin dan sink : Bot memiliki instruksi untuk mengembangkan plugin dan sink Anda sendiri, memungkinkan bot berinteraksi dengan layanan eksternal seperti situs web perusahaan Anda, skrip Google, dan banyak lagi.
Plugin mania : permainan, dukungan nama panggilan, kata kunci berlangganan, API yang dapat disesuaikan - daftarnya terus bertambah !

Menjalankan Bot

Catatan: Pertama kali dijalankan? Lihat petunjuk instalasi

Untuk mengeksekusi: 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

Konfigurasi Bot untuk Administrator

Arahan konfigurasi dapat ditentukan di config.json .

Harap dicatat bahwa file config.json yang disertakan dengan repositori tidak boleh diedit/diubah. Ini adalah file referensi yang digunakan oleh bot untuk membuat file konfigurasi sebenarnya yang terletak di tempat lain dalam sistem. Untuk mengetahui letak file sebenarnya, silakan lihat bagian Konfigurasi Tambahan pada petunjuk instalasi.

Sebagian besar arahan konfigurasi ditentukan secara global

Arahan global selalu ditentukan di "root" config.json .
Untuk menentukan arahan per percakapan, opsi konfigurasi yang sama harus didefinisikan sebagai config.conversations[<conversation-id>].<configuration option> .
Arahan per percakapan akan menggantikan pengaturan global, jika keduanya disetel.
Perintah per percakapan yang dikonfigurasi secara manual sudah TIDAK DIGUNAKAN lagi.

Plugin

Kunci plugins di config.json memungkinkan Anda menentukan daftar plugin yang akan dimuat oleh bot saat startup. Jika opsi ini dibiarkan null , maka semua plugin yang tersedia akan dimuat.

Untuk menentukan plugin yang akan dimuat, pertama-tama pastikan bahwa file .py yang benar ada di dalam direktori hangupsbot/plugin/ Anda, kemudian ubah kunci plugins di config.json untuk mencerminkan plugin/file mana yang ingin Anda muat, misalnya plugins: ["mentions", "default", "chance", "syncrooms"]

Beberapa plugin mungkin memerlukan konfigurasi tambahan. config.json adalah penyedia konfigurasi untuk bot dan pluginnya.

Beberapa plugin menarik:

menyebutkan plugin
- memperingatkan pengguna ketika nama mereka disebutkan dalam obrolan
berlangganan plugin
- memperingatkan pengguna ketika kata kunci langganan mereka diucapkan dalam obrolan
plugin sinkronisasi / sinkronisasi
- menyampaikan pesan obrolan di antara percakapan grup Hangout yang berbeda (ruang sinkronisasi)
- konfigurasikan melalui perintah bot (syncrooms_config)
- terjemahan otomatis melalui Google Terjemahan dari pesan yang disampaikan (syncrooms_autotranslate)

Wiki memiliki daftar plugin yang lebih lengkap ...

Berinteraksi dengan Bot

Ada dua jenis interaksi umum dengan bot:

Perintah /bot dimulai dengan /bot misalnya /bot dosomething
- beberapa perintah bot hanya untuk admin
interaksi khusus (penggunaan dan aksesibilitas bervariasi menurut plugin)

Bot dasar mendukung beberapa perintah dasar bahkan tanpa plugin apa pun dimuat. Berikut ini sebagian daftarnya:

/bot help

Bot mencantumkan semua perintah yang didukung dalam pesan pribadi dengan pengguna

/bot ping

Bot membalas dengan pong .

/bot version

Bot membalas dengan nomor versi kerangka kerja

Daftar lengkap perintah yang didukung oleh kerangka dasar tersedia di halaman wiki Perintah Inti .

Wiki juga memiliki daftar plugin yang merinci plugin yang tersedia dengan daftar perintah dan penggunaannya.

Memperbarui

Arahkan ke direktori bot (mis. cd ~/hangupsbot )
Ubah ke cabang stabil terbaru menggunakan git checkout master
git pull untuk menarik hangupsbot versi terbaru
pip3 install -r requirements.txt --upgrade
Mulai ulang botnya

Men-debug

Jalankan bot dengan parameter -d misalnya python3 hangupsbot.py -d - ini menurunkan level log ke INFO untuk file log yang lebih bertele-tele dan informatif.
tail file log, yang mungkin terletak di /<user>/.local/share/hangupsbot/hangupsbot.log - lokasinya bervariasi menurut distro!
Output konsol (STDOUT) cukup terbatas, apa pun level lognya, jadi andalkan output file log saja.

Kiat untuk mengatasi masalah

Program tidak berjalan:

Perbarui hangupsbot dan hangups
Jalankan hangups untuk memeriksa apakah perpustakaan hangups asli berfungsi
- Jika ada kesalahan, hapus cookie di ``~/.local/share/hangupsbot/cookies.json` dan coba lagi
- Masuk ke Akun Google Anda dari alamat server.

Bot tidak merespons pesan: