اتصال Roo Code به چابکان
Roo Code چیست؟
Roo Code یک عامل برنامهنویسی داخل VS Code و ویرایشگرهای سازگار است. این افزونه میتواند context پروژه را بخواند، درباره معماری توضیح بدهد، فایلها را ویرایش کند و فرمانهای terminal را با mode و permission مناسب اجرا کند. Roo Code برای گردشکارهای قابل شخصیسازی طراحی شده و modeهایی مانند Ask، Architect و Code کمک میکنن د مرحله تحلیل از مرحله تغییر جدا بماند.
این افزونه provider نوع OpenAI Compatible دارد و میتواند مستقیماً به درگاه چابکان متصل شود. در این اتصال، Roo Code عملیات محلی را مدیریت میکند و چابکان پاسخ مدل، مصرف و محدودیت کلید را مدیریت میکند.
کاربردهای مناسب
- تحلیل و مرور codebase داخل VS Code؛
- طراحی معماری پیش از ویرایش؛
- پیادهسازی و refactor با تأیید مرحلهای؛
- اجرای تست و تحلیل خطا؛
- تعریف profileهای جدا برای مدل یا پروژههای مختلف.
Roo Code و Cline هر دو agentمحورند، اما تنظیم mode و profile در Roo Code برای workflowهای سفارشیتر مناسب است. انتخاب نهایی را با یک pilot روی پروژه کوچک انجام دهید.
پیشنیاز
پیش از شروع، اتصال عمومی را با cURL آزمایش کنید. مدلی انتخاب کنید که از tool calling پشتیبانی کند؛ Roo Code برای خواندن فایل، اجرای دستور و ویرایش پروژه به ابزارخوان ی نیاز دارد.
۱. نصب افزونه
- VS Code، Cursor، Windsurf یا VSCodium را باز کنید.
- با
Ctrl/Cmd + Shift + Xبخش Extensions را باز کنید. - عبارت
Roo Codeرا جستوجو کنید. - افزونه رسمی Roo Code را نصب کنید.
- اگر ویرایشگر درخواست کرد، پنجره را Reload کنید.
- آیکون Roo Code را از Activity Bar باز کنید.
۲. ساخت پروفایل چابکان
- در پنل Roo Code روی آیکون چرخدنده کلیک کنید.
- بخش Providers یا انتخابگر API Provider را باز کنید.
- گزینه OpenAI Compatible را انتخاب کنید.
- یک نام مانند
Chabokan AIبرای profile وارد کنید. - مقادیر زیر را وارد کنید:
| فیلد | مقدار |
|---|---|
| Base URL | https://ai.chabokan.net/v1 |
| API Key | کلید کامل با شروع sk-chbk- |
| Model ID | شناسه دقیق مدل پنل، مانند openai/gpt-4o-mini |
- اگر فیلد Context Window نمایش داده شد، مقدار واقعی مدل را از اطلاعات مدل در پنل وارد کنید؛ حدسزدن عدد بزرگ باعث ارسال درخواست بیش از ظرفیت مدل میشود.
- تنظیمات را ذخیره و profile چابکان را فعال کنید.
۳. آزمایش امن
یک پوشه پروژه را باز کنید و ابتدا حالت Ask یا Architect را انتخاب کنید. سپس بنویسید:
ساختار پروژه را بررسی کن و بدون تغییر هیچ فایلی، روش اجرای تستها را توضیح بده.
پس از پاسخ موفق، میتوانید حالت Code را انتخاب کنید. هر فرمان shell و diff پیشنهادی را پیش از تأیید بررسی کنید.
۴. انتخاب مدل متفاوت برای هر حالت
اگر نسخه Roo Code شما profile جدا برای modeها دارد، میتوانید برای Ask یک مدل سریع و برای Code یک مدل قویتر تعیین کنید. برای هر profile همین Base URL و API Key را وارد کنید و فقط Model ID را تغییر دهید.
خطاهای رایج Roo Code
- Model Not Found: شناسه مدل را بدون تغییر از پنل کپی کنید.
- Invalid API Key: کلید ناقص، لغوشده یا منقضی است.
- Tool calling error: مدل انتخابی ابزارخوانی native ندارد؛ مدل مناسبتری انتخاب کنید.
- اتصال chat موفق ولی Code ناموفق: ابتدا یک درخواست ساده بفرستید و سپس tool calling را آزمایش کنید.