الانتقال إلى المحتوى الرئيسي

Documentation Index

Fetch the complete documentation index at: https://docs.wolffi.sh/llms.txt

Use this file to discover all available pages before exploring further.

​
أنماط الأمان

amygdala هي بوابة الأمان في Wolffish. كل استدعاء أداة يمر عبرها قبل التنفيذ. لا تحتوي على أي أنماط مكتوبة في الكود — كل أنماط الخطر والتأكيد تُحمَّل من ملفات SKILL.md عبر cerebellum.

​
كيف تعمل

عندما ينتج نموذج اللغة استدعاء أداة، تبني amygdala سلسلة مطابقة: 
toolName + " " + JSON.stringify(args)
تُختبر هذه السلسلة مقابل كل الأنماط المسجلة. تحدد نتيجة التصنيف ما يحدث:
التصنيفالسلوك
safeتُنفَّذ الأداة فورًا
confirmيُعرض مربع حوار موافقة في واجهة المستخدم؛ ينتظر التنفيذ رد المستخدم
blockيُرفض استدعاء الأداة؛ يتلقى نموذج اللغة رسالة رفض

​
مطابقة الأنماط

الأنماط هي سلاسل تعابير نمطية معرَّفة في واجهة YAML لـ SKILL.md: 
danger_patterns:
  - "rm -rf /"
  - "sudo rm"
  - "chmod 777"
  - "mkfs"
  - "dd if="

confirm_patterns:
  - "npm install"
  - "git push"
  - "docker rm"
  - "pip install"

​
أولوية الأنماط

إذا طابق استدعاء أداة نمط خطر ونمط تأكيد معًا، يفوز الخطر. ترتيب الأولوية: block > confirm > safe.

​
تدفق الموافقة

عندما تصنف amygdala استدعاءً على أنه confirm:
  1. يُطلق حدث safety.confirm على ناقل أحداث corpus
  2. تُرسل رسالة IPC إلى عملية المُعرِّض
  3. تعرض الواجهة بطاقة موافقة باسم الأداة والمعطيات وأزرار الموافقة/الرفض
  4. تنتظر amygdala عبر جسر مبني على Promise
  5. يُعاد قرار المستخدم (موافقة أو رفض)
  6. إذا تمت الموافقة، يستمر التنفيذ. إذا رُفض، يتلقى نموذج اللغة رسالة رفض

​
كتابة أنماط جيدة

اجعل الأنماط محددة بما يكفي لاصطياد المخاطر الحقيقية، لكن واسعة بما يكفي لعدم تفويت التنويعات. اختبر أنماطك مقابل صيغة سلسلة المطابقة الكاملة (toolName + " " + JSON.stringify(args)).
عند الشك، استخدم أنماط التأكيد بدلًا من أنماط الخطر. من الأفضل أن تسأل المستخدم على أن تحجب شيئًا بصمت كان ينوي القيام به.

​
حلقة الملاحظات

عندما يوافق المستخدمون على استدعاءات الأدوات أو يرفضونها، يُسجل القرار بواسطة basalganglia. بمرور الوقت، يبني هذا تاريخًا من التفضيلات يستطيع نموذج اللغة الرجوع إليه لفهم ما يوافق عليه المستخدم عادة وما يرفضه.