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

أذونات وكيل الذكاء الاصطناعي والسلامة

يقترح الوكيل الإجراءات فقط. يخضع كل تعديل للملف وكل أمر لفحص الأذونات على جهازك قبل أن يحدث أي شيء، ولا يمكن لأي شيء إيقاف هذا الفحص.

ما يحدث دائمًا دون السؤال

Section titled “ما يحدث دائمًا دون السؤال”

تعمل الأدوات المخصصة للقراءة فقط بحرية داخل مساحة العمل: قراءة الملفات، وإدراج قوائم الدلائل، والبحث، والقراءة فقط git أوامر مثل status, diff، و log. مساحة العمل هي الدليل الذي بدأت فيه الوكيل بالإضافة إلى أي دليل تمت إضافته باستخدام --add-dir أو /add-dir. المسارات خارجها، .. يتم رفض أحرف الهروب والروابط التي تؤدي إلى خارج المساحة.

اضغط Shift+Tab لتبديل الوضع. يظهر الوضع الحالي في سطر الحالة.

الوضعتعديلات الملفاتالأوامر
ask (افتراضي)يسأل في كل مرةيسأل في كل مرة
accept-editsالتشغيل دون السؤال داخل مساحة العملالاستمرار في السؤال
planمرفوضمرفوض

في plan في هذا الوضع، يقوم الوكيل بالبحث عن التغييرات ووصفها بدلاً من إجرائها . /plan يتحول إلى وضع التخطيط لطلب التخطيط.

اضبط وضع البدء باستخدام --permission-mode، باستخدام /permissions mode MODE، أو باستخدام defaultMode في ملف الإعدادات. لا يوجد وضع يتخطى كل فحص للأذونات.

تُظهر المطالبة بالضبط ما سيحدث: الفروق في حالة التعديل، و سطر الأوامر الكامل ودليل العمل في حالة الأمر، أو الخادم والمعلمات في حالة أداة MCP. يمكنك الاختيار من بين:

  • نعم لتشغيله مرة واحدة.
  • نعم، ولا تسأل مرة أخرى لتلك البادئة للأمر أو نمط الملف في هذا المشروع. يتم حفظ القاعدة في إعداداتك الخاصة لهذا المشروع، تحت $CONFIG/ai/projects/، ولا توجد أبدًا داخل المستودع.
  • لا، ووضح للذكاء الاصطناعي السبب، حتى يتمكن الوكيل من التعديل.

يتم السؤال دائمًا عن بعض الاستدعاءات، ولا يمكن لأي قاعدة السماح بها: الأوامر التي تشير إلى ملفات سرية أو مخازن بيانات الاعتماد، والتغييرات على .champrep/ أو .git/ العناصر الداخلية، والأوامر التي تكون معقدة للغاية بحيث يتعذر تحليلها بأمان.

تتخذ القواعد الشكل التالي Tool أو Tool(pattern):

{
"permissions": {
"allow": ["local_bash(npm test*)", "local_bash(go test ./...)", "local_edit_file(src/**)"],
"deny": ["local_bash(git push*)", "local_bash(rm -rf*)", "local_read_file(secrets/**)"],
"defaultMode": "ask"
}
}
  • قواعد الأوامر مثل local_bash(npm test*) تتطابق مع سطر الأوامر. الأوامر المرتبطة بـ ;, &&, ||, |، أو يتم تقسيم البدائل، و كل يجب السماح بهذا الجزء.
  • قواعد المسار مثل local_edit_file(src/**) تطابق المسارات النسبية لمساحة العمل. * تظل ضمن مجلد واحد؛ ** عبر المجلدات.
  • أسماء الأدوات يمكنك استخدام *، على سبيل المثال local_mcp__github__* لكل أداة في خادم MCP محلي واحد.
  • أ local_read_file(...) قاعدة رفض، أو deny_read القائمة، تخفي أيضًا تلك الملفات عن كل أدوات القراءة والبحث.

إدارة القواعد دون تحرير الملفات:

/permissions
/permissions allow local_bash(npm run lint*)
/permissions deny local_bash(git push*)
/permissions remove local_bash(npm run lint*)
/permissions mode accept-edits

/permissions allow, deny، و remove قم بتحرير إجاباتك المحفوظة لهذا المشروع (تحت $CONFIG/ai/projects/). قم بتحرير الملفات الأخرى مباشرةً.

ملفات الإعدادات والأولوية

Section titled “ملفات الإعدادات والأولوية”
الملفالنطاق
--allowed-tools علامةهذه الجولة فقط
$CONFIG/ai/projects/<id>.jsonإجاباتك المحفوظة لهذا المشروع (“لا تسأل مرة أخرى”، /permissions)
.champrep/settings.local.jsonأنت، في هذا المشروع (تتم إضافتك إلى .gitignore تلقائيًا)
.champrep/settings.jsonجميع المشاركين في هذا المشروع (قم بالتسجيل لمشاركته)
$CONFIG/ai/settings.jsonأنت، في كل مشروع

تكون الأولوية للمدخلات الأقدم. تكون قواعد الحظر الواردة في أي ملف هي السائدة دائمًا. يتم تطبيق إجاباتك المحفوظة على الفور لأنها موجودة خارج المستودع. قواعد السماح و defaultMode في الاثنين .champrep/ لا تصبح الملفات سارية المفعول إلا بعد أن تثق في مشروع .champrep/ التكوين (انظر ثقة المستودع)؛ وتُطبق قواعد «الرفض» الموجودة فيها دائمًا. ضع قواعد «السماح» التي تريدها في أي مكان في إعدادات المستخدم الخاصة بك. تُطبق حدود خطتك على كل ملف، ولا يمكن لأي عنصر محلي رفعها.

تشغيل champrep ai paths لمعرفة أين $CONFIG موجود على جهازك.

يتم فرض هذه القواعد بواسطة CLIنفسه، وليس بواسطة النموذج:

  • الملفات المحظورة. لا يقوم الوكيل أبدًا بقراءة محتويات المستودع أو سردها أو إرسالها .env الملفات (باستثناء .env.example)، والمفاتيح الخاصة والشهادات مثل *.pem, *.key, *.p12، و id_rsa*, .npmrc, .pypirc, .netrc، الخاص بك ~/.aws, ~/.ssh، و ~/.gnupg المجلدات، وسلسلة مفاتيح نظام التشغيل ، وتكوين CLIنفسه. يتم إخطار النموذج بأن الملف محظور؛ ولا يرى المحتوى أبدًا.
  • التنقيح. يتم فحص مخرجات الأداة قبل أن تغادر جهازك. يتم استبدال الأسرار عالية الثقة مثل مفاتيح الوصول إلى السحابة، ورموز التحكم في المصدر، ومفاتيح مزودي الدفع، ومفاتيح مزودي الذكاء الاصطناعي، وكتل المفاتيح الخاصة، ورموز الحامل بـ [REDACTED:<kind>].
  • المفاتيح الملصقة. إذا احتوت المطالبة على شيء يشبه سرًّا، فإنه لا يتم إرساله. قم بتسجيل مفاتيح النموذج مع /model register بيانات اعتماد MCP مع /mcp بدلاً من ذلك.
  • لا يوجد توريث لبيانات الاعتماد. الأوامر التي يقوم الوكيل بتشغيلها، والخطافات، وخوادم MCP المحلية لا تتلقى أبدًا بياناتCHAMPREP اعتمادك أو CHAMPREP_* المتغيرات.

أضف المسارات المحظورة الخاصة بك باستخدام deny_read أو local_read_file(...) قواعد الرفض. يمكن توسيع القائمة المدمجة ولكن لا يمكن تخفيفها أبدًا.

يمكن للمستودع أن يتضمن تكوين الوكيل في .champrep/: الأوامر المخصصة، المهارات، الوكلاء، الخطافات، خوادم MCP، وإعدادات المشروع. عند فتح مستودع غير مألوف، يجب ألا يتم تشغيل أي من هذه العناصر أبدًا، لذا يظل هذا المحتوى غير نشط حتى تقوم بالموافقة عليه.

  • عندما يحتوي مشروع ما على مثل هذا المحتوى، يسألك الوكيل مرة واحدة عما إذا كنت تثق به ويعرض ما يحتويه.
  • وإذا تغير المحتوى لاحقًا، فسيُطلب منك الموافقة مرة أخرى.
  • /trust يعرض الحالة الحالية؛ /trust approve و /trust revoke تغييره.

يتم تخزين الموافقات في $CONFIG/ai/trusted-projects.json.

نقاط التحقق، والمقارنة، والتراجع

Section titled “نقاط التحقق، والمقارنة، والتراجع”

قبل كل تعديل، يحفظ الوكيل الحالة السابقة للملف على جهازك.

الأمرالتأثير
/diffإظهار كل تغيير تم إجراؤه على الملفات في هذه الجلسة.
/undoالتراجع عن آخر مجموعة من التغييرات.
/rewindاختيار رسالة سابقة واستعادة الملفات إلى حالتها قبلها. Esc كما أن «twice» يفتحه أيضًا.

/rewind يستعيد الملفات فقط؛ ولا تتغير المحادثة نفسها. يتم حذف نقاط التحقق عند انتهاء الجلسة ما لم تبدأ بـ --keep-checkpoints. التغييرات التي يتم إجراؤها بواسطة أوامر shell، على سبيل المثال مشغل كود يتم تشغيله عبر local_bash، لا تخضع لفحص؛ استخدم git لأغراض تلك الأدوات.

الإجراءات في الخدماتCHAMPREP

Section titled “الإجراءات في الخدماتCHAMPREP”

الإجراءات التي تغير البيانات في CHAMPREPخدماتك، مثل إرسال بريد إلكتروني، تستخدم نفس مسار الموافقة المستخدم في تطبيق الويب. يعرض الوكيل بطاقة موافقة، وتقوم أنت باختيار الموافقة, الرفض، أو تحديد ذلك لاحقًا. لا يتم الموافقة على هذه الإجراءات تلقائيًّا أبدًا، مهما كان وضع الأذونات المحلية. في عمليات التشغيل بدون واجهة مستخدم، تظل هذه الإجراءات معلقة حتى توافق عليها في التطبيق الويبCHAMPREP.

/services يوضح الخدماتCHAMPREP التي قد يستخدمها الذكاء الاصطناعي. قم بتغيير تلك القائمة في CHAMPREP AIإعداداتك على الويب.