You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
السياسات هي قواعد تعمل قبل وبعد كل استدعاء أداة لدى الوكيل. تلتقط الأوامر الضارة، تسرب الأسرار، وأوضاع الفشل الأخرى قبل أن تسبب ضررًا.
33
+
<Steptitle="فعّل السياسات">
34
+
السياسات هي قواعد تعمل قبل وبعد كل استدعاء أداة من الوكيل. تقبض على الأوامر المدمرة وتسريب الأسرار وأوضاع الفشل الأخرى قبل أن تسبب ضررًا.
36
35
37
36
```bash
38
37
failproofai policies --install
39
38
```
40
39
41
-
يكتب هذا إدخالات hook في أدوات الوكيل المثبتة لديك (ملف Claude Code `~/.claude/settings.json`، ملف OpenAI Codex `~/.codex/hooks.json`، ملف GitHub Copilot CLI`~/.copilot/hooks/failproofai.json`، ملف Cursor Agent `~/.cursor/hooks.json`، مكون OpenCode المولد في `~/.config/opencode/plugins/failproofai.mjs` بالإضافة إلى إدخال التسجيل في مصفوفة `plugin` في `~/.config/opencode/opencode.json`، ملف Pi `~/.pi/agent/settings.json`، ملف Gemini CLI `~/.gemini/settings.json`، أو ملف Hermes `~/.hermes/config.yaml`). عند وجود أكثر من واحد ستُطلب منك المتابعة؛ مرر`--cli claude codex copilot cursor opencode pi gemini hermes` (أي مجموعة فرعية) لتخطي الطلب.
40
+
يكتب هذا مدخلات الخطاف في واجهات سطر الأوامر المثبتة للوكيل (ملف `~/.claude/settings.json` الخاص بـ Claude Code، `~/.codex/hooks.json` الخاص بـ OpenAI Codex، `~/.copilot/hooks/failproofai.json` الخاص بـ GitHub Copilot CLI، `~/.cursor/hooks.json` الخاص بـ Cursor Agent، مكون إضافة shim مُنتج في `~/.config/opencode/plugins/failproofai.mjs` الخاص بـ OpenCode بالإضافة إلى مدخل تسجيل في مصفوفة `plugin` في `~/.config/opencode/opencode.json`، `~/.pi/agent/settings.json` الخاص بـ Pi، `~/.hermes/config.yaml` الخاص بـ Hermes، `~/.openclaw/openclaw.json` الخاص بـ OpenClaw، `~/.factory/hooks.json` الخاص بـ Factory Droid، `~/.config/devin/config.json` الخاص بـ Devin CLI، `~/.gemini/config/hooks.json` الخاص بـ Antigravity CLI، أو دليل المكون الإضافي الذي يتم اكتشافه تلقائيًا في `~/.agents/plugins/failproofai/hooks/hooks.json` الخاص بـ Goose). عندما يكون أكثر من واحد موجودًا ستُطالب؛ مرّر `--cli claude codex copilot cursor opencode pi hermes openclaw factory devin antigravity goose` (أي مجموعة جزئية) لتخطي المطالبة.
42
41
43
-
دعم GitHub Copilot CLI و Cursor Agent و OpenCode و Pi و Gemini CLI موجود في مرحلة **تجريبية** — ثبّت باستخدام `--cli copilot` أو `--cli cursor` أو `--cli opencode` أو `--cli pi` أو `--cli gemini`. يثبّت Hermes (hermes-agent، بوابة Slack/Telegram) بنطاق المستخدم باستخدام `--cli hermes` وهو أيضًا **مصدر تدقيق** دون اتصال.
42
+
دعم GitHub Copilot CLI و Cursor Agent و OpenCode و Pi هو **تجريبي** — ثبّت باستخدام `--cli copilot` أو `--cli cursor` أو `--cli opencode` أو `--cli pi`. يثبت Hermes (hermes-agent، بوابة Slack/Telegram) بنطاق المستخدم باستخدام `--cli hermes` وهو **أيضًا** مصدر تدقيق غير متصل. يثبت OpenClaw (بوابة openclaw، مساعد متعدد القنوات ذاتي الاستضافة) بنطاق المستخدم باستخدام `--cli openclaw` — يعمل الإنفاذ عبر خطاف البرنامج المدمج (`before_agent_finalize` هو بوابة نهاية دور حقيقية، لذا يفرض البرنامج المدمج `require-*-before-stop`) — وهو **أيضًا** مصدر تدقيق غير متصل. يثبت Factory Droid (`droid`) باستخدام `--cli factory` (نطاق المستخدم والمشروع) وهو **أيضًا** مصدر تدقيق غير متصل. يثبت Devin CLI (`devin`، Cognition) باستخدام `--cli devin` (نطاق المستخدم والمشروع) وهو **أيضًا** مصدر تدقيق غير متصل. يثبت Antigravity CLI (`agy`) باستخدام `--cli antigravity` (نطاق المستخدم والمشروع) وهو **أيضًا** مصدر تدقيق غير متصل. يثبت Goose (اسم الكود goose، Block) باستخدام `--cli goose` (نطاق المستخدم والمشروع) — يقطع المثبت للتو دليل مكون إضافي في `~/.agents/plugins/failproofai/` الذي يكتشفه Goose تلقائيًا، وهو **أيضًا** مصدر تدقيق غير متصل.
يعرض كل سياسة، وما إذا كانت مفعّلة، وأي معاملات مُعدّة.
65
+
يعرض كل سياسة، وما إذا كانت مُفعّلة، وأي معاملات مكونة.
63
66
</Step>
64
-
<Steptitle="تشغيل لوحة المعلومات">
67
+
<Steptitle="شغّل لوحة المعلومات">
65
68
```bash
66
69
failproofai
67
70
```
68
71
69
-
يفتح لوحة معلومات محلية على`http://localhost:8020` حيث يمكنك استعراض الجلسات، فحص استدعاءات الأدوات، وإدارة السياسات.
72
+
يفتح لوحة معلومات محلية في`http://localhost:8020` حيث يمكنك استعراض الجلسات والتفتيش على استدعاءات الأدوات وإدارة السياسات.
70
73
</Step>
71
-
<Steptitle="تشغيل وكيلك">
72
-
شغّل Claude Code كالمعتاد. إذا حاول الوكيل فعل شيء محفوف بالمخاطر، سيعترضه failproofai تلقائيًا. اتركه يعمل دون إشراف واستعرض ما حدث في لوحة المعلومات.
74
+
<Steptitle="شغّل وكيلك">
75
+
شغّل Claude Code كالمعتاد. إذا حاول الوكيل فعل شيء محفوف بالمخاطر، سيعترضه failproofai تلقائيًا. اتركه يعمل دون حضور واستعرض ما حدث في لوحة المعلومات.
73
76
</Step>
74
77
</Steps>
75
78
76
79
---
77
80
78
-
## كيف تعمل السياسات
81
+
## كيفية عمل السياسات
79
82
80
-
في كل مرة يشغّل الوكيل أداة، يستدعي Claude Code failproofai كعملية فرعية:
83
+
في كل مرة يشغل الوكيل أداة، يستدعي Claude Code failproofai كعملية فرعية:
81
84
82
85
```text
83
-
Claude Code → failproofai --hook PreToolUse → reads stdin JSON
84
-
evaluates policies
85
-
writes decision to stdout
86
+
Claude Code → failproofai --hook PreToolUse → يقرأ JSON من stdin
87
+
يقيّم السياسات
88
+
يكتب القرار إلى stdout
86
89
```
87
90
88
-
كل سياسة تعيد أحد ثلاث قرارات:
91
+
تُرجع كل سياسة أحد ثلاثة قرارات:
89
92
90
-
-**allow** - يمضي الوكيل بشكل طبيعي
91
-
-**deny** - يتم حظر الإجراء، يُخبر الوكيل السبب
92
-
-**instruct** - يتم إضافة سياق إضافي إلى فوري الوكيل
93
+
-**allow** - يستمر الوكيل بشكل طبيعي
94
+
-**deny** - يتم حظر الإجراء، ويُخبر الوكيل السبب
95
+
-**instruct** - يضاف سياق إضافي إلى موجه الوكيل
93
96
94
97
<Note>
95
-
تعمل السياسات في عمليتك المحلية. لا شيء يُرسل إلى خدمة بعيدة.
98
+
تعمل السياسات في عمليتك المحلية. لا يتم إرسال أي شيء إلى خدمة بعيدة.
96
99
</Note>
97
100
98
101
---
99
102
100
-
## إعداد سياسات الفريق باستخدام السياسات المستندة إلى الاتفاقية
103
+
## اضبط سياسات الفريق باستخدام السياسات المبنية على الاتفاقية
101
104
102
-
أسرع طريقة لإنشاء معايير الجودة عبر فريقك هي اتفاقية `.failproofai/policies/`. ضع ملفات السياسة في هذا الدليل وسيتم تحميلها تلقائيًا — لا أعلام، لا تغييرات إعدادات، لا أوامر تثبيت.
105
+
الطريقة الأسرع لإنشاء معايير جودة في جميع أنحاء فريقك هي اتفاقية `.failproofai/policies/`. ضع ملفات السياسة في هذا الدليل وسيتم تحميلها تلقائيًا — لا أعلام، لا تغييرات في الإعدادات، لا أوامر تثبيت.
كل فرد من فريقك الذي لديه failproofai مثبت سيستقبل هذه السياسات تلقائيًا. لا يلزم إعداد لكل مطور.
145
+
كل عضو في الفريق لديه failproofai مثبتًا يختار هذه السياسات تلقائيًا. لا حاجة لإعداد لكل مطور.
143
146
</Step>
144
147
</Steps>
145
148
146
149
<Tip>
147
-
التزم بـ `.failproofai/policies/` في مستودعك حتى يتشارك الفريق بأكمله نفس المعايير. كلما اكتشف فريقك أوضاع فشل جديدة، أضف سياسات وادفع — الجميع يحصلون على التحديث في `git pull`التالي. بمرور الوقت تصبح هذه السياسات معيار جودة حي يستمر في التحسن.
150
+
التزم بـ `.failproofai/policies/` في مستودعك حتى يشارك الفريق بأكمله نفس المعايير. مع اكتشاف فريقك لأوضاع فشل جديدة، أضف سياسات وادفع — يحصل الجميع على التحديث في عملية `git pull`التالية. بمرور الوقت، تصبح هذه السياسات معيار جودة حي يستمر في التحسن.
148
151
</Tip>
149
152
150
153
---
151
154
152
155
## تخزين البيانات
153
156
154
-
جميع الإعدادات والسجلات تبقى على جهازك:
157
+
تبقى جميع الإعدادات والسجلات على جهازك:
155
158
156
159
| المسار | ما يخزنه |
157
-
|------|-------------|
160
+
|------|----------------|
158
161
| `~/.failproofai/policies-config.json` | إعدادات السياسة العامة |
159
-
| `~/.failproofai/hook-activity.jsonl` | سجل تنفيذ Hook |
160
-
| `~/.failproofai/hook.log` | سجل تصحيح أخطاء Hook المخصص |
161
-
| `.failproofai/policies-config.json` | إعدادات لكل مشروع (مُلتزم به) |
162
-
| `.failproofai/policies-config.local.json` | تجاوزات شخصية (مُستثناة من git) |
162
+
| `~/.failproofai/hook-activity.jsonl` | سجل تنفيذ الخطاف |
163
+
| `~/.failproofai/hook.log` | سجل تصحيح لأخطاء الخطاف المخصصة |
164
+
| `.failproofai/policies-config.json` | إعدادات لكل مشروع (ملتزم بها) |
165
+
| `.failproofai/policies-config.local.json` | التجاوزات الشخصية (مُدرجة في gitignore) |
163
166
164
167
---
165
168
166
-
## إلغاء التثبيت
169
+
## الإزالة
167
170
168
171
```bash
169
172
failproofai policies --uninstall
170
173
```
171
174
172
-
يزيل إدخالات hook من `~/.claude/settings.json`. ملفات الإعدادات في `~/.failproofai/` يتم الاحتفاظ بها.
175
+
يزيل مدخلات الخطاف من `~/.claude/settings.json`. يتم الاحتفاظ بملفات الإعدادات في `~/.failproofai/`.
الخطافات والسياسات لـ **معالجة أعطال الذكاء الاصطناعي** و **استرجاع الأخطاء** و **موثوقية نماذج اللغة الكبيرة**. حافظ على موثوقية وكلائك الذكيين والعمل بشكل مستقل عبر **Claude Code** و **OpenAI Codex** و **GitHub Copilot** و **Cursor Agent** و **OpenCode** و **Pi** و**Gemini CLI** و**Hermes** و **Agents SDK**.
8
+
خطافات وسياسات لـ **معالجة فشل الذكاء الاصطناعي**، **استرجاع الأخطاء**، و**موثوقية نموذج اللغة الكبير**. حافظ على وكلاء الذكاء الاصطناعي الخاص بك موثوقين وتشغيلهم بشكل مستقل عبر **Claude Code**، **OpenAI Codex**، **GitHub Copilot**، **Cursor Agent**، **OpenCode**، **Pi**، **Hermes**،**OpenClaw**، **Factory Droid**،**Devin CLI**، **Antigravity CLI**، و**Agents SDK**.
9
9
10
-
الوكلاء الذكيون يفشلون بطرق يمكن التنبؤ بها. يقومون بتنفيذ أوامر مدمرة، تسرب الأسرار، الانجراف عن المهمة الأساسية، الوقوع في حلقات، أو الدفع مباشرة إلى الفرع الرئيسي. إذا تركت دون مراقبة، فإن الأعطال الصغيرة قد تؤدي إلى انقطاعات، تسرب بيانات الاعتماد، وفقدان العمل.
10
+
وكلاء الذكاء الاصطناعي يفشلون بطرق يمكن التنبؤ بها. يقومون بتشغيل أوامر مدمرة، وتسريب الأسرار، والانجراف عن المهمة، والعلوق في حلقات، أو الدفع مباشرة إلى الفرع الرئيسي. في حالة تركهم بدون مراقبة، قد تتسبب الأخطاء الصغيرة في انهيارات وتسريب بيانات المصادقة وفقدان العمل.
11
11
12
-
FailproofAI يحل هذه المشكلة عبر**السياسات**. هذه القواعد تتصل بكل استدعاء أداة من الوكيل لـ **الكشف عن الأعطال** و **تخفيفها** (حظر، توجيه، تعقيم) و **تنبيهك** عند الحاجة للاهتمام. لوحة معلومات محلية تسمح لك باستعراض كل استدعاء أداة وفشل وكيل وإجراء استرجاع بعد ذلك.
12
+
يحل FailproofAI هذه المشكلة باستخدام**السياسات**. هذه القواعد تتعلق بكل استدعاء أداة من وكيل لـ **اكتشاف الأخطاء**، **التخفيف من آثارها** (حظر، إرشاد، تعقيم)، و**إنبيهك** عند الحاجة إلى الانتباه. لوحة تحكم محلية تسمح لك بمراجعة كل استدعاء أداة، فشل الوكيل، وإجراء الاسترجاع لاحقاً.
13
13
14
-
لا تغادر أي بيانات جهازك.
14
+
لا تترك أي بيانات جهازك.
15
15
16
-
## ابدأ الآن
16
+
## البدء
17
17
18
18
<CardGroupcols={2}>
19
19
20
20
<Cardtitle="39 سياسة مدمجة"icon="shield"href="/ar/built-in-policies">
21
-
حظر الأوامر المدمرة، منع تسرب الأسرار، إبقاء الوكلاء داخل حدود المشروع، والمزيد. كل ذلك جاهز من البداية.
21
+
احظر الأوامر المدمرة، ومنع تسريب الأسرار، وحافظ على الوكلاء داخل حدود المشروع، والمزيد. كل شيء جاهز من الصندوق.
![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4&size=40){kind=avatar}
0 commit comments