Docs

Arsitektur

Seluruh layanan berjalan di satu VPS dan dikelola oleh PM2. Portal web tidak menyimpan data bot; semua angka diambil langsung dari API bot secara real-time.

1. Bot Shiroko (proses PM2 index) menjalankan koneksi WhatsApp, Discord, Minecraft Bot, dan menyediakan API internal di port 3000.
2. Web Control Center (proses PM2 web-shiroko) memanggil /api/dashboard milik bot, lalu menormalkan datanya untuk ditampilkan.
3. Telemetry dikirim juga lewat Socket.IO agar kartu status dan grafik ikut berubah tanpa reload.
4. Status server Minecraft diambil dari ping protokol Server List Ping asli, bukan nilai tetap.
5. Nginx menerima trafik HTTPS lalu meneruskannya ke proses web Node.

Prinsip utamanya: tidak ada data contoh. Jika API bot tidak dapat dijangkau, status ditampilkan sebagai UNKNOWN, bukan ditebak sebagai online.

WhatsApp Bot

Cara memulai menggunakan asisten Shiroko di WhatsApp.

1. Buka tautan WhatsApp pada kartu WhatsApp Bot di halaman Ecosystem.
2. Kirim pesan pembuka, lalu ketik !menu untuk melihat kemampuan yang tersedia saat ini.
3. Setiap pengguna memiliki kuota harian. Kuota terpakai saat memakai fitur AI dan pembuatan media.
4. Fitur khusus pemilik bot, seperti kontrol Minecraft Bot, hanya dapat dijalankan oleh akun owner.

Aktivitas percakapan tidak pernah ditampilkan di portal ini. Control Center hanya menerima jumlah event dan status koneksi, tanpa isi pesan, nomor, atau identitas pengguna.

Discord Bot

Shiroko versi komunitas dengan memori yang sama seperti di WhatsApp.

1. Gabung server lewat tombol Masuk komunitas pada halaman Ecosystem.
2. Gunakan kanal yang tersedia untuk mengobrol dan meminta gambar.
3. Permintaan gambar masuk ke antrean bersama; jika antrean panjang, hasil akan menyusul.
4. Status koneksi dan latensi gateway Discord dapat dipantau di halaman System Status.

Minecraft Server & Bot

Server komunitas mendukung pemain Java maupun Bedrock.

1. Salin alamat melalui tombol salin pada kartu Minecraft di halaman Ecosystem.
2. Tambahkan sebagai server baru pada klien Minecraft Anda, lalu sambungkan.
3. Jumlah pemain, versi server, dan latensi ping ditampilkan otomatis pada portal saat server menyala.
4. Minecraft Bot adalah entitas terpisah dari server. Bot dapat berstatus mati meskipun server menyala, dan sebaliknya.

PixAI Web Auth (Ambil API Key)

Halaman PixAI Web Auth dipakai untuk menghubungkan API key PixAI ke mesin gambar bot tanpa mengirim kata sandi Anda ke bot.

1. Di WhatsApp Bot, kirim perintah !api-pixai. Bot membalas dengan kode OTP sekali pakai yang berlaku lima menit.
2. Buka halaman PixAI Web Auth, masukkan kode OTP tersebut, lalu tekan Generate.
3. Salin kode bookmarklet yang muncul.
4. Buka tab pixai.art dalam keadaan sudah login, lalu jalankan kode tersebut di address bar.
5. Token akan dikirim otomatis ke server bot dan diverifikasi. Jika berhasil, Anda menerima konfirmasi di WhatsApp.
6. Jika pengiriman otomatis gagal, browser menampilkan kode cadangan berbentuk token|nonce. Tempel kode itu pada kolom Opsi B di halaman yang sama.

Catatan penting: OTP dan nonce hanya berlaku sekali, dibuat dengan generator acak kriptografis, punya batas waktu, dan dibatasi jumlah percobaannya. Token yang kedaluwarsa atau bukan format PixAI akan ditolak.

Control Center

Portal ini terdiri dari beberapa halaman dengan fungsi berbeda.

Arti status: ONLINE layanan menjawab normal, STANDBY sedang menyambung atau menunggu, OFFLINE tidak menjawab, dan UNKNOWN berarti portal belum berhasil mengambil telemetry dari bot.

Operasional

Panduan singkat bagi pengelola server.

1. Kedua aplikasi dijalankan PM2: index untuk bot dan web-shiroko untuk portal.
2. Deployment dilakukan dengan menarik perubahan dari repositori, memasang dependensi, lalu memuat ulang proses terkait.
3. Konfigurasi sensitif disimpan dalam berkas .env pada masing-masing aplikasi dan tidak pernah dimasukkan ke repositori.
4. Portal web membaca alamat API bot dari variabel VPS_API_URL.
5. Setelah deploy, periksa halaman System Status untuk memastikan sumber data kembali ke kondisi langsung.

Keamanan & Privasi

1. Portal tidak menampilkan isi percakapan, nomor telepon, maupun identitas pengguna.
2. Endpoint penukaran token PixAI dibatasi asal permintaannya, dibatasi laju aksesnya, dan memvalidasi token sebelum disimpan.
3. Sesi admin memakai cookie khusus yang diperbarui setiap kali login berhasil.
4. Jangan pernah membagikan kode OTP, bookmarklet, maupun token kepada orang lain.
5. Bila Anda merasa token bocor, buat token baru agar token lama tidak lagi dipakai.

FAQ