أذونات وكيل الذكاء الاصطناعي والسلامة
يقترح الوكيل الإجراءات فقط. يخضع كل تعديل للملف وكل أمر لفحص الأذونات على جهازك قبل أن يحدث أي شيء، ولا يمكن لأي شيء إيقاف هذا الفحص.
ما يحدث دائمًا دون السؤال
Section titled “ما يحدث دائمًا دون السؤال”تعمل الأدوات المخصصة للقراءة فقط بحرية داخل مساحة العمل: قراءة الملفات، وإدراج قوائم الدلائل، والبحث، والقراءة فقط git أوامر مثل status, diff، و log. مساحة العمل هي الدليل الذي بدأت فيه الوكيل بالإضافة إلى أي دليل تمت إضافته باستخدام --add-dir أو /add-dir. المسارات خارجها، ..
يتم رفض أحرف الهروب والروابط التي تؤدي إلى خارج المساحة.
أوضاع الأذونات
Section titled “أوضاع الأذونات”اضغط Shift+Tab لتبديل الوضع. يظهر الوضع الحالي في سطر الحالة.
| الوضع | تعديلات الملفات | الأوامر |
|---|---|---|
ask (افتراضي) | يسأل في كل مرة | يسأل في كل مرة |
accept-edits | التشغيل دون السؤال داخل مساحة العمل | الاستمرار في السؤال |
plan | مرفوض | مرفوض |
في plan في هذا الوضع، يقوم الوكيل بالبحث عن التغييرات ووصفها بدلاً من إجرائها . /plan يتحول إلى وضع التخطيط لطلب التخطيط.
اضبط وضع البدء باستخدام --permission-mode، باستخدام /permissions mode MODE، أو باستخدام defaultMode في ملف الإعدادات. لا يوجد وضع يتخطى كل فحص للأذونات.
الرد على مطالبة الإذن
Section titled “الرد على مطالبة الإذن”تُظهر المطالبة بالضبط ما سيحدث: الفروق في حالة التعديل، و سطر الأوامر الكامل ودليل العمل في حالة الأمر، أو الخادم والمعلمات في حالة أداة MCP. يمكنك الاختيار من بين:
- نعم لتشغيله مرة واحدة.
- نعم، ولا تسأل مرة أخرى لتلك البادئة للأمر أو نمط الملف في هذا المشروع. يتم حفظ القاعدة في إعداداتك الخاصة لهذا المشروع، تحت
$CONFIG/ai/projects/، ولا توجد أبدًا داخل المستودع. - لا، ووضح للذكاء الاصطناعي السبب، حتى يتمكن الوكيل من التعديل.
يتم السؤال دائمًا عن بعض الاستدعاءات، ولا يمكن لأي قاعدة السماح بها: الأوامر التي تشير إلى ملفات سرية أو مخازن بيانات الاعتماد، والتغييرات على .champrep/ أو
.git/ العناصر الداخلية، والأوامر التي تكون معقدة للغاية بحيث يتعذر تحليلها بأمان.
قواعد السماح والرفض
Section titled “قواعد السماح والرفض”تتخذ القواعد الشكل التالي 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 موجود على جهازك.
حماية الأسرار
Section titled “حماية الأسرار”يتم فرض هذه القواعد بواسطة 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(...) قواعد الرفض. يمكن توسيع القائمة المدمجة ولكن لا يمكن تخفيفها أبدًا.
ثقة المستودع
Section titled “ثقة المستودع”يمكن للمستودع أن يتضمن تكوين الوكيل في .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إعداداتك على الويب.