Tutorial Penerapan groupultra telegram-search

groupultra telegram-search adalah alat baru untuk mencari riwayat obrolan pengguna telegram.

Beberapa rekomendasi:

Bot manajemen grup Telegram @CSUBOT: Dapat mengirim pesan pribadi ke pengguna baru, mengirim kode verifikasi halaman CloudFlare, untuk melakukan audit masuk grup, untuk memverifikasi apakah pengguna yang mengajukan permohonan untuk bergabung dengan grup adalah manusia nyata. Tidak akan mengganggu teman-teman grup lainnya.
Periksa IP publik dari mesin ini saat mengakses situs web yang berbeda, yang dapat mendeteksi konfigurasi split proxy untuk menghindari pemblokiran oleh alat AI. Anda dapat melihat IP yang digunakan pengguna saat mengunjungi situs web Tiongkok, situs web AI terkenal internasional, situs web internasional yang diblokir, dan situs web internasional yang diizinkan

Fitur Proyek

Menurut dokumentasi resmi, Telegram Search menyediakan fungsi inti berikut:

Pencarian semantik: Tidak hanya mencari kata kunci, tetapi juga memahami konteks dan arti pesan
Pencocokan vektor: Berdasarkan teknologi vektor embedding OpenAI untuk mewujudkan pencarian kesamaan
Pengambilan yang efisien: Pengalaman pengambilan yang lebih akurat dan cerdas daripada pencarian asli Telegram
Dukungan multi-platform: Menyediakan antarmuka Web dan aplikasi desktop

Pembatalan

Pertama-tama, mari daftarkan beberapa konten yang sangat berbeda dari harapan pengguna, serta beberapa masalah yang ada, untuk membatalkan sebagian pengguna yang tidak cocok untuk proyek ini. Dan berikan saran untuk menggunakan proyek matang lainnya.

Perbedaan antara proyek ini dan proyek tradisional yang tidak menggunakan AI adalah pencarian semantik (tidak hanya mencari kata kunci, tetapi juga dapat memahami konteks dan arti pesan). Namun, saat ini saya mencoba beberapa kueri, terlepas dari apakah opsi pengaturan “Cari konten” dicentang atau tidak di kotak pencarian, pada dasarnya saya tidak dapat menggunakan pertanyaan untuk mencari (hanya satu yang dapat); saya tidak dapat melakukan pencarian sinonim. Hanya pesan dengan kata-kata umum dengan kueri yang dapat dicari. Saya tidak yakin apakah ini masalah model embedding.

Perintah untuk menjalankan deployment frontend dan backend yang sering digunakan harus menunggu kompilasi. Untuk pengguna yang terbiasa dengan bahasa pemrograman yang tidak perlu dikompilasi sebelumnya dan pengguna yang terbiasa dengan kecepatan kompilasi yang cepat, waktu tunggu proyek ini agak lama.

Buka frontend untuk digunakan, lalu setelah beberapa saat, refresh untuk digunakan, frontend akan menampilkan layar kosong, seperti yang ditunjukkan di bawah ini. Setiap kali Anda perlu memulai ulang, pnpm run dev:frontend, Anda harus menunggu kompilasi. Di-deploy di server, setiap kali Anda menggunakannya, atau setiap kali Anda melakukan kueri, Anda harus terhubung ke server untuk mengkompilasi sekali, yang memang merepotkan.

Masalah layar kosong frontend proyek groupultra/telegram-search

Singkatnya, groupultra telegram-search sebagai proyek untuk mencari pesan riwayat telegram, saat ini tidak sematang proyek tradisional lainnya untuk digunakan. Rekomendasi proyek lainnya:

落絮 lilydjwg/luoxu：一个用于索引中文和日文群组内容的 Telegram 用户机器人。 — A Telegram userbot to index Chinese and Japanese group contents. , dikembangkan oleh Yiyun dari komunitas archlinux cn, proyek telah berjalan dengan stabil selama bertahun-tahun, lihat efek sebenarnya: Halaman web pencarian catatan pesan grup publik . Fitur proyek:

Proyek ini terutama menggunakan python dan tidak perlu menunggu kompilasi. Meskipun ada komponen yang perlu dikompilasi, hanya perlu dikompilasi sekali
Pencarian string tidak membedakan antara karakter sederhana dan tradisional (akan secara otomatis dikonversi menggunakan OpenCC)
Pencarian string mendukung beberapa sintaks pencarian
Sumber daya yang ditempati lebih rendah daripada groupultra/telegram-search saat dijalankan

Masalah Luoxu:

Instalasi dan deployment mungkin lebih merepotkan daripada proyek groupultra/telegram-search. (Ini adalah perbandingan saya yang sebenarnya dari deployment dua proyek. Karena saya men-deploy luoxu di sistem Linux arm32, semua dependensi luoxu saya di-deploy dengan kompilasi penuh, termasuk PostgreSQL: Linux Kompilasi dan Instal PostgreSQL 17.4)
Kode default hanya dapat mengindeks pesan grup dan saluran yang ditulis dalam file konfigurasi, tentu saja Anda dapat mengubah kode secara manual

Prasyarat dan Persyaratan Deployment

AI yang dapat digunakan, seperti Google Gemini, OpenAI, dll.
Node.js: 20.0 atau lebih tinggi
RAM: Setidaknya 100 MB
Jaringan yang dapat mengakses Internet internasional

Tutorial ini menggunakan Google Gemini yang sepenuhnya gratis, dan API online tidak menempati sumber daya komputasi lokal. Perkenalan aplikasi: Aplikasi dan Penggunaan Gemini API KEY

Saya men-deploy di server internasional Linux amd64, tanpa menggunakan Docker, lingkungan sistem operasi lain hanya untuk referensi

Saat beroperasi sesuai dengan tutorial ini, harap perhatikan untuk membandingkan dengan dokumentasi resmi.

Mulai Cepat

Menurut dokumentasi resmi, proses dasar menggunakan Telegram Search adalah sebagai berikut:

Instalasi dan konfigurasi: Instal aplikasi dan konfigurasi API yang diperlukan
Hubungkan akun Telegram: Masuk ke akun Telegram Anda
Sinkronkan riwayat obrolan: Pilih riwayat obrolan yang perlu dicari untuk disinkronkan
Mulai pencarian: Gunakan fungsi pencarian semantik untuk menemukan pesan

Instalasi dan konfigurasi

Instal Node.js

Kunjungi Situs web resmi Node.js untuk melihat dokumentasi dan menginstal. Disarankan untuk menggunakan versi LTS terbaru, gunakan dua perintah berikut untuk mengonfirmasi versi setelah instalasi selesai:

node -v
v22.16.0

npm --version
10.9.2

Karena proyek ini menggunakan pnpm, instal. Dokumentasi resmi: Instalasi | pnpm , perintah aktual saat ini:

curl -fsSL https://get.pnpm.io/install.sh | sh -

Menurut petunjuk

source /home/opc/.bashrc

Instal database PostgreSQL dan plugin pgvector

Perhatikan untuk menginstal PostgreSQL dan plugin pgvector. Harap dicatat bahwa bagian ini mungkin tidak lengkap

Perhatikan bahwa sistem CentOS dan redhat menggunakan perintah instalasi ini. Saat beroperasi, pastikan untuk merujuk ke artikel online dan saran AI lainnya.

Instal paket konfigurasi repositori YUM resmi PostgreSQL

sudo yum install -y https://download.postgresql.org/pub/repos/yum/reporpms/EL-9-x86_64/pgdg-redhat-repo-latest.noarch.rpm

Versi yang saya pilih adalah 13, Anda dapat memilih versi yang lebih baru. Karena PostgreSQL 13 telah diinstal sebelumnya, perintah spesifiknya tidak pasti. Sekarang

Cari paket yang tersedia yang terkait dengan pgvector di sumber YUM

sudo yum search pgvector

Instal

sudo yum install -y pgvector_13

sudo systemctl status postgresql-13

Inisialisasi direktori data PostgreSQL 13 (harus dijalankan setelah instalasi pertama).

sudo /usr/pgsql-13/bin/postgresql-13-setup initdb

Mulai ulang layanan PostgreSQL 13 untuk menerapkan perubahan.

sudo systemctl restart postgresql-13

Beralih ke pengguna administrator database postgres.

sudo -i -u postgres

Luncurkan klien baris perintah PostgreSQL.

psql

Atur kata sandi login untuk pengguna postgres.

ALTER USER postgres WITH PASSWORD 'Kata sandi database Anda';

Hubungkan ke PostgreSQL sebagai pengguna postgres melalui localhost, dan minta Anda memasukkan kata sandi.

psql -U postgres -h localhost --password

Keluar dari psql

exit

Kemudian kembali ke pengguna sistem awal,

exit

Coba masuk ke database

psql -U postgres -h localhost --password

CREATE DATABASE tg_1;

CREATE EXTENSION IF NOT EXISTS vector;

Konfigurasikan proyek dan mulai

Karena Google Gemini API memiliki batasan kecepatan, saya membuat sedikit perubahan:

git clone -b rate https://github.com/cjh0613/groupultra-telegram-search.git

Perhatikan bahwa cabang tarif saat ini, saya telah memodifikasi semuanya di halaman web Github, dan tidak ada pengujian yang dilakukan secara lokal.

Modifikasi batasan kecepatan yang dapat berjalan dengan sukses di mesin saya didasarkan pada rilis ini: v1.0.0-beta.10, commit: c60ac6416dcac6543d2623c49179681ed859e26f, tetapi dapat memastikan bahwa kode dapat berjalan tanpa kesalahan. Jika kode Anda tidak dapat berjalan, coba kembalikan modifikasi proyek resmi setelah commit ini.

Jika API yang Anda gunakan tidak memiliki batasan kecepatan, Anda dapat langsung menggunakan repositori resmi

git clone https://github.com/groupultra/telegram-search.git

Salin file konfigurasi config\config.example.yaml ke file config\config.yaml di direktori yang sama.

Ubah langsung file konfigurasi dengan mengacu pada format berikut, dan bagian lainnya mengacu pada deskripsi file konfigurasi default untuk modifikasi.

Aplikasi telegram api memerlukan ip berkualitas baik, jika Anda tidak dapat mengajukan permohonan, gunakan milik penulis, tidak perlu diubah. Ini untuk klien pihak ketiga, bukan bot telegram.

database:
  # Database type: postgres, pglite
  type: postgres
  # PostgreSQL configuration (used when type: postgres)
  # Can use URL or separate field configuration
  # url: postgres://postgres:postgres@localhost:5432/tg_search
  host: localhost
  port: 5432
  user: postgres
  password: 'Kata sandi database Anda'
  database: tg_1

api:
  embedding:
    # Embedding provider (openai or ollama) # Jangan ubah ini menjadi Gemini
    provider: openai
    # Embedding model
    model: models/text-embedding-004
    # gemini-embedding-exp-03-07
    # API key for provider
    apiKey: <Gemini API KEY yang Anda peroleh>
    # Gemini embedding-001 secara default mengeluarkan 3072 dimensi, dimensi tidak dapat disesuaikan
    dimension: 768
    # Optional, for custom API providers
    apiBase: 'https://generativelanguage.googleapis.com/v1beta/openai/'

# Mulai layanan backend
pnpm run dev:server

# Mulai antarmuka frontend di jendela terminal lain
pnpm run dev:frontend

Periksa apakah frontend dapat diakses dengan sukses:

curl http://localhost:3333/

Jika itu adalah mesin lokal, buka browser untuk mengunjungi http://localhost:3333 untuk menggunakan aplikasi

Jika itu adalah perangkat jarak jauh, Anda hanya perlu membuka port frontend untuk diakses. Tetapi Anda tidak dapat langsung mengeksposnya ke publik di jaringan publik, jika tidak, siapa pun dapat mengoperasikan akun telegram Anda. Anda perlu mengkonfigurasi izin akses sendiri, ada banyak solusi untuk ini.

Selain itu, akses domain, Anda mungkin perlu memodifikasi apps\frontend\vite.config.ts untuk menambahkan

 allowedHosts: ['Domain yang Anda akses']

Untuk konten lainnya, silakan lihat dokumentasi resmi.

Versi lain dari halaman web ini

Artikel ini memiliki beberapa versi bahasa.

Jika Anda ingin memberikan komentar, silakan kunjungi halaman web berikut:

ZH EN ZH-TW JA

Halaman web ini hanya mendukung penjelajahan, tidak dapat memberikan komentar atau meninggalkan pesan, tetapi menyediakan lebih banyak opsi bahasa, dan waktu pemuatan lebih singkat:

ZH EN ZH-TW JA RU KO CS ES AR FR PT DE TR IT NL SV DA FI PL UK HE RO HU EL HR TH HI BN ID SW VI NO

Fitur Proyek#

Pembatalan#

Prasyarat dan Persyaratan Deployment#

Mulai Cepat#

Instalasi dan konfigurasi#

Instal Node.js#

Instal database PostgreSQL dan plugin pgvector#

Konfigurasikan proyek dan mulai#

Versi lain dari halaman web ini#