تخطَّ إلى المحتوى
HanuBees
HomeDocs

دعم ACP

استخدم HanuBees في أي محرر متوافق مع ACP.

يدعم HanuBees بروتوكول Agent Client Protocol أو (ACP)، مما يتيح لك استخدامه مباشرة في المحررات وبيئات التطوير المتكاملة (IDEs) المتوافقة.

ACP بروتوكول مفتوح يوحّد آلية التواصل بين محررات الشيفرة ووكلاء البرمجة بالذكاء الاصطناعي.

الإعداد

لاستخدام HanuBees عبر ACP، اضبط محررك ليشغّل الأمر HanuBees acp.

يشغّل هذا الأمر HanuBees كعملية فرعية متوافقة مع ACP تتواصل مع محررك عبر JSON-RPC باستخدام stdio.

فيما يلي أمثلة لمحررات شائعة تدعم ACP.

Zed

أضف إلى إعدادات Zed (~/.config/zed/settings.json):

~/.config/zed/settings.json
{
  "agent_servers": {
    "HanuBees": {
      "command": "HanuBees",
      "args": ["acp"]
    }
  }
}

لفتحه، استخدم الإجراء agent: new thread في Command Palette.

يمكنك أيضا ربط اختصار لوحة مفاتيح عبر تعديل keymap.json:

keymap.json
[
  {
    "bindings": {
      "cmd-alt-o": [
        "agent::NewExternalAgentThread",
        {
          "agent": {
            "custom": {
              "name": "HanuBees",
              "command": {
                "command": "HanuBees",
                "args": ["acp"]
              }
            }
          }
        }
      ]
    }
  }
]

JetBrains IDEs

أضف إلى ملف acp.json الخاص بـ JetBrains IDE وفقا لـ documentation:

acp.json
{
  "agent_servers": {
    "HanuBees": {
      "command": "/absolute/path/bin/HanuBees",
      "args": ["acp"]
    }
  }
}

لفتحه، اختر الوكيل الجديد ‘HanuBees’ من محدد الوكلاء في AI Chat.

Avante.nvim

أضف إلى إعدادات Avante.nvim:

{
  acp_providers = {
    ["HanuBees"] = {
      command = "HanuBees",
      args = { "acp" }
    }
  }
}

إذا احتجت إلى تمرير متغيرات البيئة:

{
  acp_providers = {
    ["HanuBees"] = {
      command = "HanuBees",
      args = { "acp" },
      env = {
        HanuBees_API_KEY = os.getenv("HanuBees_API_KEY")
      }
    }
  }
}

CodeCompanion.nvim

لاستخدام HanuBees كوكيل ACP في CodeCompanion.nvim، أضف التالي إلى إعدادات Neovim:

require("codecompanion").setup({
  interactions = {
    chat = {
      adapter = {
        name = "HanuBees",
        model = "claude-sonnet-4",
      },
    },
  },
})

يضبط هذا الإعداد CodeCompanion لاستخدام HanuBees كوكيل ACP للدردشة.

إذا احتجت إلى تمرير متغيرات البيئة (مثل HanuBees_API_KEY)، فارجع إلى Configuring Adapters: Environment Variables ضمن توثيق CodeCompanion.nvim للاطلاع على التفاصيل كاملة.

الدعم

يعمل HanuBees عبر ACP بالطريقة نفسها التي يعمل بها في terminal. جميع الميزات مدعومة:

  • الأدوات المضمنة (عمليات الملفات، أوامر terminal، إلخ.)
  • الأدوات المخصصة وأوامر الشرطة المائلة
  • خوادم MCP المضبوطة في إعدادات HanuBees
  • قواعد خاصة بالمشروع من AGENTS.md
  • المنسقات (formatters) والمدققات (linters) المخصصة
  • نظام الوكلاء والأذونات