تصور کنید در میانهٔ یک پروژه پیچیده کدنویسی، مدل اصلی شما به‌دلیل محدودیت تعداد درخواست‌ها (Rate Limit) از دسترس خارج شود یا ارائه‌دهنده در میانهٔ انجام یک وظیفه به‌طور ناگهانی ساکت شود و تمام جریان تفکر شما قطع شود. OpenCode Model Router دقیقاً برای پایان دادن به این وقفه و حل این مشکل طراحی شده است. طبق اعلام توسعه‌دهندگان در ۶ اکتبر ۲۰۲۶، این ابزار با پیاده‌سازی زنجیره‌های جایگزین خودکار (Automated Fallback Chains)، تداوم کار را میان ارائه‌دهندگان مختلف مدل‌ها تضمین می‌کند.
در حال حاضر اکثر کاربران وقتی با خطا مواجه می‌شوند، به‌صورت دستی مدل را تغییر می‌دهند؛ اتفاقی که ریسک از دست رفتن زمینه (Context) یا شکستن جریان جلسه را به‌همراه دارد. این پلاگین فرآیند دستی را به یک منطق تعریف‌شده تبدیل می‌کند: اگر مدل A شکست خورد، سیستم بلافاصله مدل B و سپس مدل C را امتحان می‌کند. این قابلیت به‌ویژه برای کاربرانی که به‌طور هم‌زمان با چندین ارائه‌دهنده مانند OpenRouter و DeepSeek سر و کار دارند، حیاتی است.
زمینه و موارد استفاده
همان‌طور که در تحلیل‌های پیشین ما درباره‌ی پایداری سیستم‌های عامل‌محور اشاره کردیم، وابستگی به یک ارائه‌دهنده واحد، بزرگ‌ترین نقطه ضعف اتوماسیون‌های فعلی است. این چالش با پیاده‌سازی گیت‌وی‌های سازگار با OpenAI که به حذف شکست‌های خاموش در معماری‌های چند-مدلی کمک می‌کنند، تا حد زیادی قابل مدیریت است. در جلسات طولانی، احتمال اینکه مدل اصلی با خطای نرخ درخواست مواجه شود یا ارائه‌دهنده در میانهٔ کار پاسخ ندهد بسیار زیاد است. در حالی که یک بار منتظر شدن برای رفع محدودیت نرخ درخواست (Rate Limit) قابل تحمل است، اما تکرار این اتفاق در میان عوامل (Agents) و ارائه‌دهندگان مختلف، به یک نقطه اصطکاک بزرگ در گردش کار تبدیل می‌شود.
با تعریف یک زنجیره، کاربر اطمینان می‌یابد که کارش نیمه‌کاره نمی‌ماند. این ابزار اجازه می‌دهد تا جای ممکن از رفتار یک مدل خاص استفاده کنید؛ به‌طوری که همان مدل را از طریق ارائه‌دهندگان مختلف فراخوانی کند و تنها در صورت شکست همه، به مدل دیگری کوچ کند. به گزارش وب‌سایت dev.to، این پلاگین به‌جای تنظیمات کلی (Global)، بر اساس هر عامل (Agent) عمل می‌کند. این یعنی یک عامل کدنویسی طولانی‌مدت می‌تواند اولویت‌هایی متفاوت از یک عامل بررسی متن کوتاه داشته باشد. هر عامل سه جایگاه (Slot) اختصاصی دارد: یک مدل اصلی، یک مدل ثانویه و یک مدل ثالث.
جزئیات فنی
ساختار فنی این سیستم برای حداکثر تاب‌آوری طراحی شده است:
- ساختار زنجیره: هر مرحله فهرستی مرتب از ارجاعات مدل به فرمت
{providerID, id, variant?}است. یک مرحله می‌تواند دارای یک «نسخه» (Variant) اختیاری باشد، که اجازه می‌دهد دو بیلد (Build) مختلف از یک مدل با یک ID یکسان، به عنوان دو مرحله مجزا در زنجیره قرار گیرند. - جداسازی ارائه‌دهنده: سیستم یک مدل یکسان روی دو ارائه‌دهنده مختلف را دو مرحله مجزا می‌بیند. این رویکرد در واقع دفاع در برابر قطعی‌های خاص هر ارائه‌دهنده است، نه لزوماً شکست در هوش مدل.
- پیکربندی: پلاگین وضعیت مدل‌ها را از مسیر Settings > Models و از طریق فایل
drafts.sqliteمی‌خواند. این موضوع تضمین می‌کند که هیچ مدلی بدون اطلاع و اجازه کاربر در پس‌زمینه فعال نشود. - منطق جایگاه‌ها: سه جایگاه برای پوشش یک قطعی کلی ارائه‌دهنده به‌علاوه یک مسیر تخریب‌شده (Degraded Route) دوم در یک جلسه در نظر گرفته شده تا مدیریت سیستم برای کاربر پیچیده نشود.
مدیریت این زنجیره‌ها از طریق یک رابط کاربری وب محلی اختصاصی در آدرس http://127.0.0.1:37337 انجام می‌شود. برای امنیت بیشتر، این رابط فقط روی آدرس لوپ‌بک محلی (127.0.0.1) فعال است و در شبکه بیرونی قابل دسترسی نیست تا از افشای تنظیمات جلوگیری شود. این محیط دارای تم تاریک و ساده است و شامل فهرستی از عوامل، یک ویرایشگر زنجیره سه-جایگاهی و یک کشوی مدل‌های قابل جست‌وجو است که بر اساس ارائه‌دهنده گروه‌بندی شده و از پیمایش با کیبورد پشتیبانی می‌کند.
برای کسانی که محیط خط فرمان (CLI) را ترجیح می‌دهند، دستور /model-router یک مسیر جایگزین برای مدیریت فراهم می‌کند. این ویژگی تضمین می‌کند کاربرانی که ترجیح می‌دهند ترمینال را ترک نکنند، بتوانند جایگزین‌های خود را مدیریت کنند. در حالی که OpenCode بر روی مدیریت زنجیره‌ها تمرکز دارد، پروژه‌هایی مانند Bifrost با کاهش تأخیر مسیریابی به ۱۱ میکروثانیه، استانداردهای جدیدی را برای بهینه‌سازی سرعت در لایه‌های گیت‌وی تعریف کرده‌اند.
نحوه ادغام این ابزار بسته به نوع نصب متفاوت است. برای کاربرانی که از oh-my-opencode-slim استفاده می‌کنند، پلاگین آرایه‌های agents.<agent>.model بومی را مستقیماً در پیکربندی می‌نویسد تا موتور Failover آن‌ها را شناسایی کند. در مقابل، نصبات استاندارد OpenCode به‌روزرسانی‌های پیکربندی میزبان (Host) را دریافت می‌کنند. برای جلوگیری از تداخل و فاصله گرفتن تنظیمات (Configuration Drift)، در هر لحظه تنها یکی از این دو روش نوشته می‌شود.
همچنین برای جلوگیری از دست رفتن داده‌ها، هر عملیات نوشتن یک فایل پشتیبان با نام .model-router.bak در کنار فایل هدف ایجاد می‌کند. این کار باعث می‌شود بازگرداندن یک تغییر اشتباه به یک عملیات ساده کپی تبدیل شود.
این سازوکار نقش توسعه‌دهنده را از «عیب‌یابی فعال» به «برنامه‌ریزی معماری» تغییر می‌دهد. کاربر به‌جای واکنش به خطای ۴۲۹ (Rate Limit)، یک استراتژی تاب‌آوری را پیش‌تعریف می‌کند. این ابزار پذیرفته است که نقطه شکست معمولاً زیرساخت ارائه‌دهنده است، نه هوش مدل.
با محدود کردن زنجیره به سه جایگاه، ابزار از پیچیدگی بیش از حد (Over-engineering) جلوگیری کرده و رایج‌ترین سناریوهای شکست را پوشش می‌دهد. البته دو محدودیت اصلی وجود دارد: اول اینکه پلاگین مدل جدیدی تعریف یا فراهم نمی‌کند و فقط بین مدل‌های فعال در سیستم میزبان مسیریابی می‌کند. اگر مدلی بخشی از تنظیمات OpenCode نباشد، در لیست انتخابگر ظاهر نمی‌شود. دوم اینکه به‌دلیل نبود رابط مدیریت از راه دور، تمام تنظیمات باید روی همان ماشینی که نرم‌افزار اجرا می‌شود، انجام شود.
توسعه‌دهندگان می‌توانند این ابزار با مجوز MIT (نسخه ۰.۳.۱) را از طریق گیت‌هاب و با استفاده از اسکریپت نصب PowerShell زیر نصب کنند:powershell -ExecutionPolicy Bypass -File tools/install-dev.ps1
این پروژه در حال حاضر هیچ وابستگی خارجی (Zero Dependencies) ندارد و مستندات README آن به زبان‌های انگلیسی و ترکی موجود است.
برای مشاهده عملکرد این ابزار، می‌توانید به مخزن گیت‌هاب در آدرس https://github.com/sertdisk/OpenCode-Model-Router مراجعه کرده و اولین زنجیره جایگزین خود را پیکربندی کنید.
گام بعدی شما
- اگر از چندین API Key برای مدل‌های مختلف استفاده می‌کنید، این پلاگین را نصب کنید تا توقف‌های ناگهانی در کدنویسی را به صفر برسانید.
- زنجیره‌های خود را به‌گونه‌ای تنظیم کنید که ابتدا مدل‌های ارزان‌تر و سپس مدل‌های قدرتمندتر (مثل Claude 3.5) را در اولویت قرار دهید.
- فایل‌های
.bakرا پس از هر تغییر بزرگ بررسی کنید تا از صحت پیکربندی مطمئن شوید.
اما برای کسانی که به دنبال اجرای مدل‌های سنگین روی سخت‌افزار محدود هستند، به تحلیل ما درباره POCKET-Darwin-180B مراجعه کنید.
گفتگو