آموزش اتصال API هوش مصنوعی Mindbase به Crush (TUI چارم)

Crush ترمینال‌ایجنت مدرن تیم Charm (سازندگان Bubble Tea) است؛ TUI‌ای که مدل‌ها را در سایدبار نگه می‌دارد. سرویس‌های سازگار با OpenAI با یک دستور provider add (نوع completions) معرفی می‌شوند و برای همیشه در انتخابگر ctrl+L می‌مانند.

پیش‌نیازها

  • Crush نصب‌شده (crush —charmbracelet/crush).
  • کلید API مایندبیس (گام صفر پایین).

گام صفر: دریافت API Key و Base URL از مایندبیس

قبل از هر چیز به دو مقدار نیاز دارید: کلید API و Base URL. هر دو از سایت مایندبیس قابل دریافت هستند:

  1. وارد حساب کاربری خود در mindbase.ir شوید (ثبت‌نام رایگان است).
  2. از منوی پروفایل، بخش «کلیدهای API» را باز کنید.
  3. روی «+ کلید جدید» بزنید و یک نام دلخواه بدهید؛ مثلاً Crush تا بعداً بدانید این کلید مال کدام ابزار است.
  4. مقدار کلید را کپی کنید — این کلید با پیشوند mb_ شروع می‌شود.
  5. Base URL نیز در همین صفحه نمایش داده می‌شود: https://api.mindbase.ir/v1
دریافت کلید API و Base URL از پنل کاربری مایندبیس

در ادامه همین دو مقدار را در تنظیمات Crush جای‌گذاری می‌کنیم. اگر خواستید مدل دیگری هم امتحان کنید، لیست کامل مدل‌ها (GLM-5.3 در سه سطح توان، مدل سبک سریع و Qwen3.8) در صفحه مدل‌های مایندبیس قابل مشاهده است.

مرحله اول: افزودن پروایدر

محیط واقعی Crush — آموزش تنظیم اتصال به مایندبیس

در ترمینال دستور افزودن پروایدر را بزنید — نوع completions دقیقاً همان OpenAI-compatible است (در نسخه‌های قدیمی openai-compat):

crush provider add mindbase \
  --type completions \
  --base-url "https://api.mindbase.ir/v1" \
  --api-key "mb_xxxxxxxxxxxxxxxxxxxxxxxx"
crush model add mindbase/MindBase --name MindBase

# یا crush.json:
{ "providers": { "mindbase": {
    "type": "completions",
    "base_url": "https://api.mindbase.ir/v1",
    "models": [{ "id": "MindBase", "context_window": 128000 }]
} } }

مرحله دوم: ثبت مدل MindBase

مدل را با شناسه دقیق API ثبت کنید؛ اگر سرویس /models نداشته باشد دستی اضافه می‌شود (اسکیمای charm.land.crush.json):

مرحله سوم: انتخاب در TUI

در Crush با ctrl+l انتخابگر مدل را باز کنید؛ MindBase از گروه mindbase انتخاب می‌شود. فیلدهای هزینه و context در اسکیمای پیکربندی پر می‌شوند.

نکات مهم

  • نوع completions: اسکیما رسمی: providers..type = completions برای هر API سازگار OpenAI (legacy openai-compat هم می‌پذیرد).
  • استریم: در ProviderConfig پرچم استریم جداگانه ندارد؛ رفتار پیش‌فرض کلاینت است.
  • هزینه‌ها: میدان‌های cost و context در اسکیمای پیکربندی اجباری‌اند؛ صفر یا مقدار واقعی بگذارید.

رفع مشکلات رایج

  • خطای پارس کانفیگ: نوع باید completions باشد و json معتبر.
  • مدل نیست: id دقیق MindBase در models[].id.
  • ۴۰۱: api_key با mb_ در همان provider.

جمع‌بندی

Crush با یک provider add (نوع completions) و مدل MindBase، یکی از زیباترین TUIهای کدنویسی را به مایندبیس وصل می‌کند — انتخابگر مدل ctrl+L همیشه باز.

سوالات متداول

completions یعنی چه؟

اسم رسمی نوع OpenAI-compatible در اسکیماست؛ نوع معمولی completions برای هر سرور OpenAI-style.

مدل خودکار نمی‌آید؟

اگر /models سرویس لیست ندهد، با model add دستی ثبتش کنید؛ مدل‌های کاربر اولویت دارند.

هزینه نمایشی؟

cost_per_1m_* در اسکیمای پیکربندی؛ صفر یا قیمت واقعی مایندبیس.