Hubungkan DeepSeek Harness ke Buzz Lewat Gateway Nostr

Plugin DeepSeek Harness (DSH), dsh-message-gateway, memperluas jangkauan asisten DeepSeek Harness ke berbagai platform perpesanan seperti Discord, Telegram, dan WeChat. Repositori plugin ini di-fork dan diperluas untuk menambahkan platform Self-Host Buzz dari Block: Ruang Kerja Bersama Agen AI Anda ke dalam daftar. Repositori hasil fork tersedia di GitHub di https://github.com/Tech-Voyage-Dev/dsh-message-gateway.

Panduan prasyarat

Self-Host Buzz dari Block: Ruang Kerja Bersama Agen AI Anda

Pelajari cara self-host relay Buzz Block pada Linux VPS di balik Cloudflare. Kelola ruang kerja berbasis Nostr tempat kolaborasi manusia dan agen AI.

12 MENIT BACA

Asisten DSH bergabung ke relay Buzz sebagai anggota, menerima pesan langsung (DM) serta pesan saluran tempat asisten di-@mention, dan menjawab melalui pipeline agen per-obrolan yang sama persis dengan yang digunakan oleh antarmuka Web.

Arsitektur Plugin dsh-message-gateway

Arsitektur plugin dsh-message-gateway terbagi menjadi dua bagian utama:

• Host (Node): gateway-store (kredensial, ~/.dsh/gateway.json), platforms.ts (definisi platform dan uji koneksi), routes.ts (endpoint /gateway/*), dan bridge-manager.ts (jembatan penghubung: sesi agen independen per-chat dan balasan streaming).
• Client (browser): halaman "Message platforms" di bilah samping tempat Anda menyimpan kredensial, menguji koneksi, dan memantau status.

Menambahkan platform baru melibatkan langkah-langkah berikut:

1. Kelas jembatan (bridge class): menyediakan fungsi start/stop/status ditambah callback onText(text, frame), mencerminkan pola wecom-bridge.ts.
2. Integrasi bridge-manager: menggunakan kembali pipeline per-obrolan yang ada (ensureAgentForKey + pendingMap) dan menghubungkan reply sink milik platform.
3. Penyimpanan dan rute: di dalam /gateway/save dan /gateway/delete: menyimpan kredensial akan memulai jembatan, menghapusnya akan menghentikan jembatan — ditambah flag autoStartXxx agar dsh web tersambung kembali saat boot.

Implementasi Jembatan Buzz: Protokol Nostr & Siklus Hidup Event

DeepSeek Harness digunakan untuk mengimplementasikan jembatan Buzz. Implementasi ini sepenuhnya mematuhi spesifikasi protokol Nostr berikut:

Diagram berikut mengilustrasikan alur inisialisasi (bootstrap) jembatan Buzz:

Streaming Real-Time Lewat Pengeditan In-Place Nostr (Kind 40003)

Nostr tidak memiliki indikator mengetik bawaan dan event-nya bersifat append-only. Untuk membuat balasan terasa responsif dan interaktif, jembatan Buzz mensimulasikan streaming menggunakan pengeditan in-place:

• Jembatan Buzz menerbitkan event placeholder kind 9, kemudian secara progresif menulis ulang event tersebut dengan pengeditan in-place kind 40003 yang dibatasi lajunya, dan menuliskan edit final saat agen menyelesaikan tugasnya. Ini mencerminkan pola yang sama persis dengan yang digunakan oleh jembatan Telegram dan Discord.

Menghubungkan Workspace DeepSeek Harness Lewat Perintah Chat

Fitur "Workspaces" pada antarmuka Web DSH dikelola oleh layanan workspaceRegistry (@deepseek-ai/dsh-workspace):

const existing = await ctx.workspaceRegistry.resolveByPath(request.path);

Jembatan Buzz menyediakan perintah obrolan, /workspace <folder>, yang mendaftarkan folder yang ada ke DSH. Setiap sesi baru yang dibuat melalui gateway akan terhubung ke folder tersebut dan langsung terlihat di antarmuka Web.

Tiga pertimbangan desain yang perlu diperhatikan:

• Beralih folder = sesi baru. Parameter cwd dicatat ke dalam header sesi saat pembuatan dan tidak dapat diubah setelahnya.
• Folder harus sudah ada sebelumnya. Fungsi create menolak jalur folder yang belum ada di disk.
• Perintah sensitif keamanan. Setiap sesi berjalan dengan kebijakan auto-approve, yang memberikan akses baca dan tulis ke file di folder target.

Panduan Langkah Demi Langkah: Instalasi & Konfigurasi

1. Jalankan perintah berikut di terminal Anda:

dsh plugin --profile web add https://github.com/Tech-Voyage-Dev/dsh-message-gateway.git

# Start DSH web
dsh web

2. Setelah antarmuka Web DSH terbuka di peramban web, klik ikon "Message platforms":

3. Klik menu "Buzz" di panel sebelah kiri:

4. Klik "Generate keypair" untuk membuat pasangan kunci Nostr baru. Salin public key npub ke tempat yang aman.
5. Isi kolom Relay URL dan Channels (daftar UUID saluran yang diizinkan untuk berlangganan).
6. Klik tombol "Save".

Menyimpan formulir akan menyimpan kredensial dan menjalankan jembatan. Kunci privat nsec diperlakukan sebagai rahasia dan disimpan secara eksklusif di ~/.dsh/gateway.json.

Mendaftarkan Pasangan Kunci Agen ke Relay Nostr Buzz

Tambahkan asisten DSH ke relay sebagai anggota. Gunakan pubkey npub yang telah dibuat sebelumnya:

docker compose exec relay buzz-admin add-member --pubkey npub123123123

Tambahkan asisten DSH ke saluran tertentu. Mendaftarkan anggota ke relay hanya menempatkannya di server, anggota tidak akan otomatis muncul atau dapat dicari di saluran. Saat menjalankan langkah ini menggunakan buzz-cli, perhatikan bahwa parameter --pubkey harus dalam format HEX, bukan npub (perintah buzz-admin add-member mencetak pubkey HEX anggota):

buzz channels add-member --channel <CHANNEL_UUID> --pubkey <AGENT_HEX> --role member

Panduan CLI

Cara Menginstal dan Menggunakan buzz-cli

Petunjuk langkah demi langkah untuk menginstal dan mengonfigurasi buzz-cli untuk mengelola saluran Nostr, kunci anggota, dan izin agen AI.

5 MENIT BACA

Perbarui profil asisten DSH di relay Nostr agar memiliki nama tampilan yang jelas dengan buzz-cli:

Kirim salam Wave (sapaan DM khas Buzz) ke asisten DSH. Balasan konfirmasi akan segera diterima:

Mengirim Wave sebagai pesan langsung ke asisten DSH — jembatan telah aktif.

Mengaktifkan Akses Folder Lokal dengan /workspace

Karena opsi allowWorkspace dinonaktifkan (false) secara default, perintah /workspace awalnya akan ditolak:

Aktifkan opsi tersebut di file ~/.dsh/profiles/web/cordis.patch.yml, lalu mulai ulang dsh web:

- id: ui-message-gateway
  config:
    allowWorkspace: true

Setelah dimulai ulang:

Catatan penting: konfigurasi ini mengasumsikan folder workspace (TechVoyage pada tangkapan layar) berada di dalam direktori default pengguna. Jika tidak, tentukan jalur absolut lengkap. Setiap sesi baru yang terdaftar di bawah workspace ini melalui Buzz juga akan muncul di antarmuka Web DeepSeek Harness.

Perintah yang Tersedia di Buzz

Semua perintah yang didukung di platform lain dapat digunakan secara mulus di Buzz:

Ikhtisar Keamanan

• Kunci privat nsec hanya tersimpan di ~/.dsh/gateway.json (izin 0600, penulisan atomik) — tidak pernah diekspos di endpoint /gateway/list atau log sistem.
• Setiap event masuk selalu diverifikasi tanda tangan kriptografinya (verifyEvent), dideduplikasi, disaring dari pesan sendiri, dan divalidasi mention-nya sebelum sampai ke agen.
• Pendaftaran workspace dikontrol ketat oleh konfigurasi (allowWorkspace: false secara default) karena sesi gateway otomatis menyetujui izin file.

Kesimpulan: Kolaborasi AI Terdesentralisasi di Buzz

Tantangan utama dalam menambahkan Buzz ke dsh-message-gateway terletak pada pemenuhan kontrak protokol Nostr. Arsitektur dasar plugin yang sudah matang menyediakan fondasi solid untuk pengelolaan sesi dan perutean perintah, sehingga integrasi jembatan berjalan sangat mulus setelah penanganan event dan streaming in-place selesai diimplementasikan.

Referensi:

• dsh-message-gateway architecture guide — panduan arsitektur, resep ekstensi, dan catatan keamanan
• nostr-tools — pustaka Nostr yang digunakan di balik layar
• deer-flow IM channel connections — referensi pola koneksi saluran pesan instan