Skip to content

QuickStart.md

Latest commit

 

History

History
80 lines (58 loc) · 5.29 KB

QuickStart.md

File metadata and controls

80 lines (58 loc) · 5.29 KB

راهنمای راه‌اندازی سریع کلاینت گرافیکی TelegramTrader (Quick Start)

به راهنمای کاربری نرم‌افزار گرافیکی و پیشرفته TelegramTrader Premium Client خوش آمدید. این کلاینت به شما اجازه می‌دهد تا معاملات متاتریدر ۵ خود را به صورت هوشمند مدیریت کنید، سیگنال‌ها را از تلگرام به طور خودکار دریافت کرده و با ماشین‌حساب مدیریت سرمایه در کسری از ثانیه سفارش ثبت کنید.

💻 ۱. نحوه اجرای پروژه کلاینت در حالت توسعه

برای اجرای برنامه روی سیستم شخصی، ابتدا وارد پوشه client شده و مراحل زیر را انجام دهید:

پیش‌نیازها:

  • نصب پایتون (نسخه ۳.۹ الی ۳.۱۲)
  • نصب متاتریدر ۵ روی ویندوز

دستورات اجرا:

# ۱. فعال‌سازی محیط مجازی پایتون
.venv\Scripts\activate

# ۲. اجرای برنامه گرافیکی Flet
python main.py

برنامه بلافاصله به صورت یک پنجره دسکتاپ بومی و بسیار شیک با تم تاریک بالا می‌آید.

📈 ۲. راه‌اندازی پل ارتباطی متاتریدر ۵ (MQL5 EA Bridge)

این کلاینت بدون نیاز به فعال‌سازی DLLهای ناامن ویندوز، از طریق متد امن شبکه متاتریدر کار می‌کند. برای فعال‌سازی اتصال:

  1. نرم‌افزار MetaTrader 5 خود را باز کنید.
  2. از منوی بالا وارد مسیر Tools -> Options (یا کلیدهای میانبر Ctrl+O) شوید.
  3. زبانه Expert Advisors را انتخاب کنید.
  4. تیک گزینه‌های زیر را فعال کنید:
    • Allow algorithmic trading
    • Allow WebRequest for listed URL:
  5. روی دکمه Add new URL (علامت سبز رنگ +) کلیک کرده و آدرس زیر را دقیقاً اضافه کنید: http://127.0.0.1:8000
  6. روی OK کلیک کنید.
  7. فایل TelegramTraderBridge.mq5 موجود در پوشه mql/Experts پروژه را کپی کرده و در دایرکتوری اکسپرت‌های متاتریدر خود قرار دهید: (در متاتریدر: File -> Open Data Folder -> MQL5 -> Experts)
  8. اکسپرت را کامپایل کنید یا متاتریدر را رفرش کنید و آن را روی یکی از چارت‌ها (مثلاً EURUSD) رها کنید.
  9. اکنون اکسپرت هر ۵۰۰ میلی‌ثانیه زنده کلاینت را مانیتور می‌کند و دستورات ترید را بدون تاخیر اجرا می‌نماید!

👑 ۳. ویژگی‌های فوق‌العاده برنامه

🧮 ماشین‌حساب مدیریت سرمایه هوشمند (Smart Sizer)

دیگر نیازی به محاسبه دستی حجم لات ندارید!

  • در صفحه Settings، فیلد ریسک را تنظیم کنید (مثلاً درصد ریسک = ۱٪).
  • در صفحه Dashboard، نماد مورد نظر را وارد کرده (مثلاً XAUUSD)، جهت معامله را مشخص کرده و میزان حد ضرر (SL) را بنویسید (مثلاً ۳۰ پیپ).
  • روی Execute Smart Trade کلیک کنید. برنامه به طور خودکار بر اساس Equity واقعی متاتریدر شما و پپ‌ولی نماد، لات سایز ایمن (مثلاً ۰.۳۳) را محاسبه کرده و در کسری از ثانیه سفارش را ارسال می‌کند!

🗺️ نگاشت نمادهای بروکر (Symbol Mapping)

اگر پیام سیگنال تلگرام کلمه GOLD را فرستاد اما نماد بروکر شما XAUUSD یا GOLD.m است:

  • به صفحه Settings بروید.
  • در پنل Broker Symbol Mapping، فیلد سیگنال را GOLD و نماد بروکر را XAUUSD بنویسید و دکمه Add را بزنید.
  • سیستم از این به بعد سیگنال‌های دریافال طلا را روی نماد صحیح اعمال می‌کند.

📦 ۴. نحوه پکیج کردن و ساخت فایل خروجی تک‌فایل .exe

اگر می‌خواهید اپلیکیشن را به مشتریان یا تریدرهای دیگر تحویل دهید تا نیازی به نصب پایتون نداشته باشند، می‌توانید آن را به یک فایل پرتابل .exe ویندوزی تبدیل کنید:

# ۱. فعال‌سازی محیط مجازی
.venv\Scripts\activate

# ۲. پکیج کردن به صورت فایل اجرایی بدون نمایش ترمینال (No Console)
flet pack main.py --icon=assets/logo.ico --name="SignalTrader_Premium"

فایل خروجی ویندوز در دایرکتوری dist/ ساخته می‌شود و کاربر نهایی فقط با دوبار کلیک می‌تواند آن را اجرا کند!

Tip

پشتیبانی: برای ثبت فیدبک‌ها و توسعه ویژگی‌های پیشرفته‌تر نظیر تریلینگ استاپ پیشرفته، می‌توانید به گیت‌هاب پروژه مراجعه کنید.