اتصال API هوش مصنوعی Mindbase به Neovim (CodeCompanion) و Emacs (gptel)

یک پست، دو ادیتور افسانه‌ای: در Neovim با CodeCompanion.nvim (ریپو فعال: olimorris) از adapter رسمی openai_compatible استفاده می‌کنیم و در Emacs با gptel از gptel-make-openai. هر دو مایندبیس را به‌عنوان بک‌اند OpenAI-compatible می‌پذیرند؛ تفاوت ظریف: آدرس‌دهی.

پیش‌نیازها

  • Neovim + CodeCompanion.nvim (یا Emacs + gptel از MELPA).
  • کلید API مایندبیس (گام صفر پایین).

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

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

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

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

بخش اول — CodeCompanion.nvim

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

پیکربندی Lua: با extend روی openai_compatible — فیلد url فقط دامنه (آداپتور خودش /v1/chat/completions اضافه می‌کند):

-- init.lua — CodeCompanion.nvim
require('codecompanion').setup({
  adapters = { http = { mindbase = function()
    return require('codecompanion.adapters').extend('openai_compatible', {
      formatted_name = 'MindBase',
      env = { url = 'https://api.mindbase.ir', api_key = 'mb_xxxxxxxxxxxxxxxxxxxxxxxx' },
      schema  = { model = { default = 'MindBase' } } })
  end } },
  interactions = { chat = { adapter = 'mindbase' } } })

;; init.el — gptel
(setq gptel-model 'MindBase
      gptel-backend (gptel-make-openai "MindBase"
                    :host "api.mindbase.ir" :stream t
                    :key "mb_xxxxxxxxxxxxxxxxxxxxxxxx" :models '(MindBase)))

بخش دوم — gptel (Emacs)

در elisp: gptel-make-openai با :host فقط-دامنه؛ endpoint پیش‌فرض /v1/chat/completions است. ابزارها با plist قابلیت اعلام می‌شوند.

انتخاب مدل

در CodeCompanion با ga در بافر چت؛ در gptel از منوی transient و gptel-model. مدل: MindBase.

نکات مهم

  • دامنه نه URL: CodeCompanion: url بدون /v1؛ gptel: :host بدون /v1 — هر دو مسیر را خودشان می‌سازند.
  • قابلیت: gptel مدل custom بدون :capabilities '(tool-use ...) ابزار نمی‌زند؛ CC با opts stream/tools/vision خاموش/روشن می‌شود.
  • کش: مدل‌های کش‌شده بین adapterهای openai_compatible مشترک‌اند؛ default/choices ست کنید.

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

  • پاسخ نیست: پیشوند /v1 را حذف کنید (دامنه خالی) و api_key را چک کنید.
  • ابزار خطا: capabilities مدل اعلام نشده.
  • مدل نیست: default/choices یا :models.

جمع‌بندی

دو ادیتور ترمینال‌محور با دو تنظیم کوتاه — adapter سازگار CodeCompanion و backend گپتل — مایندبیس را می‌پذیرند؛ Neovim و Emacs حالا روی سرویس ایرانی کار می‌کنند.

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

url یا base_url؟

CodeCompanion در env.url فقط ریشه (بدون /v1) می‌گیرد؛ gptel در :host فقط میزبان — هر دو مسیر API را می‌سازند.

ابزارها؟

gptel: :capabilities tool-use؛ CC: opts.openai_compatible/tools.

GLM؟

choices/`:models` را با نام دقیق مدل‌های مایندبیس پر کنید.