اتصال 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. هر دو از سایت مایندبیس قابل دریافت هستند:
- وارد حساب کاربری خود در mindbase.ir شوید (ثبتنام رایگان است).
- از منوی پروفایل، بخش «کلیدهای API» را باز کنید.
- روی «+ کلید جدید» بزنید و یک نام دلخواه بدهید؛ مثلاً
Neovim & Emacsتا بعداً بدانید این کلید مال کدام ابزار است. - مقدار کلید را کپی کنید — این کلید با پیشوند
mb_شروع میشود. - Base URL نیز در همین صفحه نمایش داده میشود:
https://api.mindbase.ir/v1
در ادامه همین دو مقدار را در تنظیمات Neovim/Emacs جایگذاری میکنیم. اگر خواستید مدل دیگری هم امتحان کنید، لیست کامل مدلها (GLM-5.3 در سه سطح توان، مدل سبک سریع و Qwen3.8) در صفحه مدلهای مایندبیس قابل مشاهده است.
بخش اول — CodeCompanion.nvim
پیکربندی 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` را با نام دقیق مدلهای مایندبیس پر کنید.