XTERM Terminal Setup Guide
هر زبان آموز یک سرور خصوصی، یک آزمایشگاه Node-RED و Google Gemini CLI از پیش نصب شده دریافت می کند. کلید API خود را ایمن کنید، آن را در ترمینال بچسبانید، یک پیام چت سریع ارسال کنید و تأیید کنید که دستیار AI شما متصل است. مراحل این صفحه را کامل کنید، سپس از دکمه تکمیل در بالای این فعالیت برای باز کردن قفل ماموریت بعدی استفاده کنید.
- سرور شخصی AI (با WebTerminal با حالت چت و صدا) + فضای ذخیره سازی دائمی
- Gemini + Claude CLI از پیش نصب شده (AI حالت Cloud Bot)
- پشته اتوماسیون Node-RED شخصی
- تأیید ورود به ترمینال از کشوی پیام (
adminاعتبارنامه) - یک کلید Gemini API روی آن ایجاد کنید aistudio.google.com و آن را در ترمینال قرار دهید
- دستور Gemini را برای ساخت جریان شروع Node-RED بدهید
آیا دوباره به اعتبار WebTerminal (VNC + XTerm) یا Node-RED نیاز دارید؟ روی نماد حباب گفتار در بالا سمت راست کلیک کنید. کشوی پیامرسانی را تغییر دهید - پیام مدیریت شامل تمام URL ها و رمزهای عبور است. در صورت نیاز به کمک هر زمان که خواستید در آنجا پاسخ دهید.
پیام ها را باز کنید، به عنوان سرپرست وارد شوید، تأیید کنید چت Gemini آماده است
کلید را در AI Studio ایجاد کنید، آن را در ترمینال بچسبانید، سپس Enter (کلید یا دکمه Enter ترمینال) را فشار دهید.
یک سلام سریع ارسال کنید (به عنوان مثال، test) و پاسخ های Gemini را تأیید کنید
از دستور آماده شده از مرحله 4 استفاده کنید: آن را کپی کنید، در چت Gemini جایگذاری کنید، سپس Enter (دکمه Enter صفحه کلید یا ترمینال) را فشار دهید.
وقتی همه چیز زیر کامل شد، از دکمه تکمیل در بالای این فعالیت استفاده کنید تا سیستم سطح و تکلیف دوره بعدی را باز کند.
واسط چت اول: انگلیسی ساده بنویسید و Gemini اجرا را روی سرور شما انجام می دهد.
Gemini به شما می گوید چه زمانی جریان آماده است. پس از آن، روی Reload کلیک کنید و بهروزرسانی بوم را تأیید کنید.
مرحله 1 · ابتدا دسترسی ترمینال را تأیید کنید
از کشوی پیام شروع کنید. قبل از ایجاد هر کلید API، مطمئن شوید که ترمینال در دسترس است و می توانید با موفقیت وارد شوید.
- کشوی پیام (حباب گفتار) را باز کنید و منتظر دو پیام سرپرست باشید: Node-RED اعتبار، سپس WebTerminal is ready.
- پس از WebTerminal is ready، اعتبارنامه ترمینال (
admin+ رمز عبور) را از پیام ها کپی کنید. - صفحه را بازخوانی کنید (F5)، وارد ترمینال شوید و اعتبارنامه ها را برای جلسات بعدی در مرورگر خود ذخیره کنید.
- اگر فریم ترمینال بارگیری نشد، روی ↗ Open in new tab کلیک کنید و در آنجا ادامه دهید.
- هنگامی که چت Gemini ظاهر شد و فعال سازی کلید API را درخواست کرد، به مرحله 2 بروید.
مرحله 2 · کلید API را ایجاد کنید و Gemini را فعال کنید
اکنون کلید را در Google AI Studio ایجاد کنید و آن را در چت ترمینال قرار دهید تا Gemini بتواند روی سرور شما شروع به کار کند.
- باز کنید Google AI Studio → API کلیدها.
- در صورت درخواست، شرایط Google/licenses را بپذیرید.
- یک پروژه موجود را انتخاب کنید یا یک پروژه جدید ایجاد کنید.
- روی Create API key کلیک کنید، سپس کلید تولید شده را کپی کنید.
- به ترمینال برگردید و کلید را با استفاده از منوی راست کلیک یا
Ctrl+Shift+Vجایگذاری کنید. - Enter را فشار دهید و منتظر تأیید باشید (به عنوان مثال،
Gemini API کلید ذخیره شد).
مرحله 3 · بررسی چت و رسیدگی به محدودیت های سهمیه
Gemini در حالت چت اجرا می شود. همانطور که با مربیان صحبت می کنید با آن صحبت کنید - نیازی به دستور دستوری نیست.
اگر ببینید
API خطا: شما سهمیه روزانه خود را در این مدل تمام کرده اید. 
سپس تنظیمات ترمینال را با /settings و مطمئن شوید Preview Features = ON.
بعد، انتخابگر مدل را با باز کنید /model.
حالت Manual را انتخاب کنید و gemini-3-flash-preview را انتخاب کنید. "مدل به خاطر بسپار برای جلسات آینده" را فعال کنید.
پیام خود را دوباره امتحان کنید اگر محدودیت دوباره ظاهر شد، ~5 دقیقه صبر کنید. اگر باز هم شکست بخورد، احتمالاً به حد مجاز روزانه (RPD) رسیدهاید و ممکن است لازم باشد تا 24 ساعت صبر کنید.
همچنین میتوانید به کلید Google Cloud project/API دیگری بروید، یا از اینجا کمک بخواهید: https://t.me/sell_systems
در صورت نیاز، صورتحساب را برای باز کردن محدودیتهای نرخ بالاتر تنظیم کنید.
اگر هنوز به کمک نیاز دارید، با یک مدیر در اینجا تماس بگیرید: https://t.me/sell_systems
مسیر بازیابی جایگزین: از یک پروژه جدید یا یک کلید API جدید استفاده کنید.
| موضوع | رفع کنید |
|---|---|
| "کلید API نامعتبر" | کلید را در AI Studio حذف کنید → یک کلید جدید ایجاد کنید → دوباره جایگذاری کنید. |
| ترمینال پاسخ نمی دهد | Reload را بزنید، 10 ثانیه صبر کنید، پیام را تکرار کنید. |
| مشکل شبکه | Wi-Fi/VPN را بازیابی کنید، صفحه را بازخوانی کنید، دوباره امتحان کنید. |
مرحله 4 · جریان شروع را راه اندازی کنید
اکنون از دستور ماموریت آماده شده در زیر استفاده کنید: آن را کپی کنید، آن را در چت Gemini جایگذاری کنید، Enter (دکمه Enter صفحه کلید یا ترمینال) را فشار دهید و بر اجرا نظارت کنید. این اولین اتوماسیون کوچک برد شماست.
این را در ترمینال قرار دهید، سپس Enter را فشار دهید (یا به زبان خودتان بگویید):
آیا باید راهنما را به صورت دستی بررسی کنید؟ شروع کننده README را در یک تب جدید باز کنید و همین مراحل را دنبال کنید.
✦ Gemini پیشرفت را در حین کار گزارش می کند. به سؤالات آن پاسخ دهید، درخواستها را تأیید کنید، و وقتی گفت که جریان آماده است، روی Reload کلیک کنید تا تغییرات در Node-RED را بررسی کنید. اگر چیزی نامشخص است، یک پیام بعدی ارسال کنید یا با یک مدیر تماس بگیرید - شما کنترل کامل را در دست خواهید داشت.
خروجی مورد انتظار باید به شکل زیر باشد: 
Gemini معمولاً وقتی همه چیز کامل است اینگونه پاسخ می دهد:
وقتی الگوهای GitHub گسترش مییابند، درخواستهای پیشرفتهتری را در اینجا اضافه میکنیم.
Gemini ممکن است برای اجرای دستورات اجازه بخواهد (به عنوان مثال، ls ). این دستورات را تأیید کنید تا Gemini بتواند محیط را بازرسی کند. شما اپراتور باقی میمانید و هر عمل را تأیید میکنید.
برای مرور دستورالعملهای سرپرست یا درخواست کمک از کشوی پیام (حباب گفتار بالا سمت راست) استفاده کنید. همه چیز—WebTerminal اعتبارنامه، آدرس Node-RED، نکات اضافی—در آنجا زندگی می کند. یا اینجا بپرس https://t.me/sell_systems
برای قسمت بعدی آماده اید؟ از دکمه تکمیل در بالای این فعالیت استفاده کنید.
