دعم ACP

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

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

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

الإعداد

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

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

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

Zed

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

{
  "agent_servers": {
    "Matrix": {
      "command": "matrix",
      "args": ["acp"]
    }
  }
}

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

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

[
  {
    "bindings": {
      "cmd-alt-o": [
        "agent::NewExternalAgentThread",
        {
          "agent": {
            "custom": {
              "name": "Matrix",
              "command": {
                "command": "matrix",
                "args": ["acp"]
              }
            }
          }
        }
      ]
    }
  }
]

JetBrains IDEs

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

{
  "agent_servers": {
    "Matrix": {
      "command": "/absolute/path/bin/matrix",
      "args": ["acp"]
    }
  }
}

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

Avante.nvim

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

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

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

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

CodeCompanion.nvim

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

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

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

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

الدعم

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

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