7.9 KiB
7.9 KiB
NetVibe VPN - Telegram Content Aggregation & Automated Publishing Pipeline
سیستم جامع و چندعاملی (Multi-Agent) برای رصد خودکار کانالهای مرجع تلگرام در حوزه فیلترشکن، پروکسی و هوش مصنوعی، بازنویسی هوشمند و جذاب با لحن عامیانه ایرانی، داشبورد نظارت و ویرایش سردبیر تحت Next.js و دیسپچر انتشار خودکار به کانال رسمی @NetVibe_VPN.
🏗️ معماری سیستم و ایجنتها
┌────────────────────────────────────────────────────────┐
│ Telegram Public Web │
│ (Channels: VPN, Proxy, Bypass, AI Tools) │
└───────────────────────────┬────────────────────────────┘
│
▼
┌───────────────────────────┐
│ Agent A: Web Scraper │ (httpx + BeautifulSoup)
│ (No Bot / No Ban Risk) │
└─────────────┬─────────────┘
│ Saves to raw_posts
▼
┌───────────────────────────┐
│ PostgreSQL / SQLAlchemy │ (Persistent storage & DDL)
└─────────────┬─────────────┘
│
▼
┌───────────────────────────┐
│ Agent B: LLM Curator │ (Persian Copywriting + Active Learning)
│ (GPT-4o + Few-shot Diff) │
└─────────────┬─────────────┘
│ Generates content_drafts
▼
┌───────────────────────────┐
│ Next.js Curation Panel │ (Review, Edit, Inline Diff, Tooltips)
│ (Editor / Human Gate) │
└─────────────┬─────────────┘
│ Approves into publish_queue
▼
┌───────────────────────────┐
│ Agent C: Auto Publisher │ (python-telegram-bot / Telegram Bot API)
│ (Scheduled Worker) │
└─────────────┬─────────────┘
│
▼
┌───────────────────────────┐
│ Official Telegram Channel │
│ @NetVibe_VPN │
└───────────────────────────┘
🌟 ویژگیهای کلیدی
-
Agent A (اسکرپر عمومی تلگرام):
- بدون نیاز به اکانت تلگرام یا سشن MTProto (حذف کامل ریسک بن شدن).
- استخراج عنوان، متن پیام، عکس/ویدیو، تعداد بازدید، واکنشها و تاریخ پیام از
https://t.me/s/{channel}. - جلوگیری از ذخیره پستهای تکراری با کلید یکتای ترکیبی
(channel_id, message_id).
-
Agent B (موتور سنتز و یادگیری فعال):
- نگارش با لحن خودمانی، عامیانه، رفاقتی و به شدت روان فارسی متناسب با برند NetVibe.
- استخراج تفاوتها (Diff Tracking) بین خروجی اولیه هوش مصنوعی و ویرایشهای نهایی سردبیر با الگوریتم توالییابی کاراکتری.
- تزریق خودکار تجربیات و خطقرمزهای سردبیر به عنوان نمونههای پرامپت (Active Few-shot In-context Learning).
-
Agent C (دیسپچر انتشار خودکار):
- پایش مداوم صف انتشار در دیتابیس (
publish_queue). - ارسال مستقیم به کانال
@NetVibe_VPNبه همراه مدیا (عکس/ویدیو) و کپشن با فرمت Markdown. - ثبت شناسه پیام منتشرشده (
telegram_msg_id) و مدیریت خطاها با امکان تلاش مجدد.
- پایش مداوم صف انتشار در دیتابیس (
-
پنل مدیریت Next.js (App Router + Tailwind CSS):
- صندوق بررسی و ویرایش پیشنویسها با ادیتور متنی زنده.
- رعایت دقیق استاندارد Enterprise: تمامی کارتها، ستونهای جداول و دکمهها دارای آیکون راهنما (i) (Info Tooltip) با توضیح کامل هستند.
- مانیتورینگ وضعیت کانالها و صف انتشار زمانبندیشده.
🗄️ ساختار جداول دیتابیس (PostgreSQL)
فایل مایگریشن در مسیر backend/migrations/001_initial_schema.sql قرار دارد:
channels: ثبت کانالهای تحت نظر، عنوان، حوزه و وضعیت رصد.raw_posts: پستهای خام استخراجشده همراه با بازدید، مدیا و لینک اصلی.content_drafts: پیشنویسهای تولیدشده توسط هوش مصنوعی با وضعیتهایpending,approved,edited,rejected,published.feedback_logs: سوابق دیفهای ویراستار انسانی، درصد شباهت، دستهبندی تغییرات و دلایل رد.publish_queue: صف زمانبندیشده انتشار با وضعیتهایqueued,publishing,success,failed.
🚀 راهنمای راهاندازی سریع
روش ۱: اجرا با Docker Compose (پیشنهادی)
cd /workspace/personal/VPN_chanel
cp .env.example .env
# مقادیر TELEGRAM_BOT_TOKEN و OPENAI_API_KEY را در .env تکمیل کنید
docker compose up -d
- بکاند:
http://localhost:8000/docs - فرانتاند:
http://localhost:3000
روش ۲: راهاندازی محلی (Development)
راهاندازی بکاند:
cd /workspace/personal/VPN_chanel/backend
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
# اجرای سرور API
uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload
راهاندازی فرانتاند:
cd /workspace/personal/VPN_chanel/frontend
npm install
npm run dev
📡 مسیرهای اصلی API
| متد | مسیر | توضیحات |
|---|---|---|
GET |
/api/v1/channels |
دریافت لیست کانالهای تحت پایش |
POST |
/api/v1/channels |
افزودن کانال جدید به لیست رصد |
POST |
/api/v1/pipeline/scrape-and-curate |
اجرای آنی فرآیند اسکرپ و تولید پیشنویس |
GET |
/api/v1/drafts?status=pending |
دریافت پیشنویسها جهت بررسی |
POST |
/api/v1/drafts/{id}/action |
تایید، ویرایش یا رد پیشنویس |
GET |
/api/v1/queue |
مشاهده صف زمانبندی انتشار |
POST |
/api/v1/pipeline/dispatch-now |
ارسال فوری پستهای صف به تلگرام |
GET |
/api/v1/feedback-logs |
مشاهده تاریخچه ویرایشها و یادگیری هوش مصنوعی |