پرش به محتوا
بازگشت به پروژه‌ها
02

پروژه شخصی · ایجنت تلگرامی خودمیزبان

Pocket Ops

یک ایجنت کنترل از راه دور با تلگرام برای سیستم خودم: پل Node.js خودمیزبان که تلگرام را به کنسول کامل عملیات یک ایستگاه کاری لینوکس تبدیل می‌کند؛ نشست‌های استریم ایجنت کدنویسی، فرمان صوتی، کنترل دسکتاپ و شبکه پرکسی خودترمیم که همه چیز را بدون VPN روی شبکه‌های سخت زنده نگه می‌دارد. حدود ۱۱۰۰ خط Node.js، بدون هیچ وابستگی ابری.

نقش

طراح و مهندس سیستم

فناوری

  • Node.js · Bridge core, ~1,100 LOC
  • Telegram Bot API · Streaming edit-in-place UX
  • Multi-CLI agent layer · OpenCode, Claude Code, Codex, Gemini
  • SOCKS5 / HTTP tunnels · VPN-free failover egress
  • whisper.cpp · Local voice transcription (fa/en)
●localhost · self-hosted
2026
Pocket Ops Telegram remote console

نقش AI در این پروژه با همراهی AI

فلسفه پروژه همین است: ایجنت‌های AI با دسترسی کامل روی سیستم من اجرا می‌شوند، اما فقط با اعتماد مالک. بات صفحه کنترل است؛ کار را ایجنت‌ها انجام می‌دهند.

معماری سطح بالا

OWNER
TELEGRAM
PROXY MESH
POCKET OPS
AGENT CLIS
LINUX BOX

02 · Pocket Ops · © 2026

مساله

  • ایستگاه کاری من محیط واقعی کار است؛ گوشی فقط باید ترمینال آن باشد.
  • شبکه‌های عمومی و سانسور، خود تلگرام را هم ناپایدار می‌کنند و VPN هم همیشه جواب نمی‌دهد.

رویکرد

  • یک قرارداد آداپتور مبتنی بر قابلیت، پنج CLI ایجنت (OpenCode، Claude Code، Codex، Gemini و هر endpoint سازگار با OpenAI) را در یک رابط یکسان نرمال می‌کند؛ با پارس رویداد JSONL و کاتالوگ مدل جدا برای هر بک‌اند.
  • خروجی استریم در یک حباب تلگرام درجا ویرایش می‌شود؛ حداکثر یک ویرایش هر ۲ ثانیه، چرخش پیام از سقف ۴هزار کاراکتر و دکمه‌های Stop / Retry / New-session روی هر پاسخ.

معماری

  • مالک ← تلگرام ← مش پرکسی ← پل Pocket Ops ← CLIهای ایجنت ← کل سیستم.
  • یک فورواردر HTTP-CONNECT محلی باعث می‌شود پروسه‌های تازه هم از همان زنجیره failover از طریق HTTPS_PROXY استفاده کنند؛ اعتبارسنجی گواهی هرگز تعطیل نمی‌شود.

فناوری

  • Node.js
  • Telegram Bot API
  • SOCKS5 / HTTP tunnels
  • whisper.cpp
  • Hyprland / systemd

چالش‌ها

  • خروجی شبکه زیر سانسور: برداشت پراکسی‌های عمومی از چند منبع، مسابقه‌دادن آن‌ها با TLS واقعی و زنده نگه داشتن زنجیره failover چسبان.
  • نشت‌ندادن رازها: رمز sudo فقط ۱۵ دقیقه در tmpfs می‌ماند و از مسیر askpass تزریق می‌شود تا هرگز به پرامپت، لاگ یا بافت مدل نرسد.

نتیجه

  • کنسول روزمره من: نشست استریم ایجنت، فرمان صوتی دوزبانه، کنترل صفحه و دسکتاپ Hyprland، انتقال فایل و زمان‌بند پرامپت.
  • قابلیت اطمینان طراحی‌شده: واچ‌داگ ۸ دقیقه‌ای برای ایجنت‌های قفل‌شده، بررسی تونل قبل از polling و استخر پرکسی ذخیره‌شده روی دیسک که از رستارت‌ها جان سالم به در می‌برد.