تخطَّ إلى المحتوى
وثائق V1
الإعداد

السياسات

تحدد السياسات ما إذا كان يُسمح لـ OpenCode بتنفيذ إجراء على مورد مُسمّى. هذه الميزة في OpenCode 2 تجريبية، وتُضبط عبر المصفوفة experimental.policies في opencode.json.

السياسات منفصلة عن الأذونات. تتحكم الأذونات فيما يمكن للأدوات فعله أثناء الجلسة، بينما تتحكم السياسات في ما إذا كان يُسمح لـ OpenCode باستخدام مورد مثل مزوّد LLM.


تحتوي كل عبارة سياسة على ثلاثة حقول:

  • effect - إما "allow" أو "deny".
  • action - العملية الخاضعة للتحكم.
  • resource - معرّف المورد أو نمط أحرف البدل الذي تنطبق عليه العبارة.

على سبيل المثال، لحظر استخدام المزوّد openai:

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "experimental": {
    "policies": [
      {
        "effect": "deny",
        "action": "provider.use",
        "resource": "openai"
      }
    ]
  }
}

المزوّد المحظور بسياسة لا يكون متاحًا لاختيار النماذج أو استخدامها، حتى لو كانت لديه بيانات اعتماد أو كان مضبوطًا بشكل صحيح من نواحٍ أخرى.


يدعم OpenCode حاليًا إجراء سياسة واحدًا:

الإجراءالموردالوصف
provider.useمعرّف المزوّد، مثل openaiالسماح باستخدام مزوّد LLM أو حظره.

قد تُضاف إجراءات سياسات أخرى مستقبلًا.


يدعم الحقل resource المطابقة بأحرف البدل. استخدم * لمطابقة صفر أو أكثر من الأحرف، و? لمطابقة حرف واحد.

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "experimental": {
    "policies": [
      {
        "effect": "deny",
        "action": "provider.use",
        "resource": "company-*"
      }
    ]
  }
}

يحظر هذا مزوّدين مثل company-us وcompany-eu.


عند تطابق عدة عبارات، تكون الغلبة لآخر عبارة مطابقة. ضع القواعد العامة أولًا، ثم الاستثناءات الأكثر تحديدًا بعدها.

على سبيل المثال، للسماح بـ Anthropic فقط:

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "experimental": {
    "policies": [
      {
        "effect": "deny",
        "action": "provider.use",
        "resource": "*"
      },
      {
        "effect": "allow",
        "action": "provider.use",
        "resource": "anthropic"
      }
    ]
  }
}

إذا لم تطابق أي سياسة مزوّدًا ما، يكون استخدامه مسموحًا افتراضيًا.

يمكن ضبط السياسات في كلٍّ من الإعدادات العامة وإعدادات المشروع. إذا طابقت سياسات من الموقعين المزوّد نفسه، تكون الأولوية لسياستك العامة على سياسة المشروع. يمنع هذا أي مستودع من إعادة تفعيل مزوّد حظرته على المستوى العام.


في OpenCode 2، استخدم السياسات بدلًا من الإعدادين الأقدم disabled_providers وenabled_providers عند التحكم في الوصول إلى المزوّدين. واصل استخدام قوائم المزوّدين هذه في OpenCode 1.

لاستبدال disabled_providers:

opencode.json
{
  "experimental": {
    "policies": [
      { "effect": "deny", "action": "provider.use", "resource": "openai" },
      { "effect": "deny", "action": "provider.use", "resource": "google" }
    ]
  }
}

لاستبدال enabled_providers، احظر جميع المزوّدين أولًا ثم اسمح بالمزوّدين المختارين بعد ذلك:

opencode.json
{
  "experimental": {
    "policies": [
      { "effect": "deny", "action": "provider.use", "resource": "*" },
      { "effect": "allow", "action": "provider.use", "resource": "anthropic" },
      { "effect": "allow", "action": "provider.use", "resource": "openai" }
    ]
  }
}