Skip to content

Commit 48ec1ce

Browse files
github-actions[bot]github-actions[bot]
authored
docs: update translations for changed English sources (#371)
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
1 parent 5918966 commit 48ec1ce

56 files changed

Lines changed: 2915 additions & 2905 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎docs/ar/built-in-policies.mdx‎

Lines changed: 125 additions & 123 deletions
Large diffs are not rendered by default.

‎docs/ar/examples.mdx‎

Lines changed: 35 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,16 @@
11
---
2-
---
32
title: أمثلة
4-
description: "كيفية إعداد الخطافات لـ Claude Code و Agents SDK"
3+
description: "كيفية إعداد hooks لـ Claude Code و Agents SDK"
54
icon: book-open
65
---
76

8-
أمثلة جاهزة للاستخدام لسيناريوهات شائعة. يعرض كل منها كيفية التثبيت وما يمكن توقعه.
7+
أمثلة جاهزة للاستخدام لسيناريوهات شائعة. يوضح كل منها كيفية التثبيت وما يمكن توقعه.
98

109
---
1110

12-
## إعداد الخطافات لـ Claude Code
11+
## إعداد hooks لـ Claude Code
1312

14-
يتكامل Failproof AI مع Claude Code عبر [نظام الخطافات](https://docs.anthropic.com/en/docs/claude-code/hooks). عند تشغيل `failproofai policies --install`، يسجل أوامر الخطافات في `settings.json` الخاص بـ Claude Code والتي تعمل على كل استدعاء أداة.
13+
يتكامل Failproof AI مع Claude Code عبر [نظام hooks الخاص به](https://docs.anthropic.com/en/docs/claude-code/hooks). عند تشغيل `failproofai policies --install`، يسجل أوامر hook في ملف `settings.json` الخاص بـ Claude Code التي تُشغّل عند كل استدعاء أداة.
1514

1615
<Steps>
1716
<Step title="تثبيت failproofai">
@@ -24,36 +23,36 @@ icon: book-open
2423
failproofai policies --install
2524
```
2625
</Step>
27-
<Step title="التحقق من تسجيل الخطافات">
26+
<Step title="التحقق من تسجيل hooks">
2827
```bash
2928
cat ~/.claude/settings.json | grep failproofai
3029
```
3130

32-
يجب أن تشاهد إدخالات خطافات لأحداث `PreToolUse` و `PostToolUse` و `Notification` و `Stop`.
31+
يجب أن ترى إدخالات hook لأحداث `PreToolUse` و `PostToolUse` و `Notification` و `Stop`.
3332
</Step>
3433
<Step title="تشغيل Claude Code">
3534
```bash
3635
claude
3736
```
3837

39-
تعمل السياسات الآن تلقائياً على كل استدعاء أداة. جرّب طلب Claude لتشغيل `sudo rm -rf /` - سيتم حظره.
38+
تعمل السياسات الآن تلقائياً عند كل استدعاء أداة. جرب طلب Claude بتشغيل `sudo rm -rf /` - سيتم حظره.
4039
</Step>
4140
</Steps>
4241

4342
---
4443

45-
## إعداد الخطافات لـ Agents SDK
44+
## إعداد hooks لـ Agents SDK
4645

47-
إذا كنت تبني باستخدام [Agents SDK](https://docs.anthropic.com/en/docs/agents-sdk)، يمكنك استخدام نفس نظام الخطافات برمجياً.
46+
إذا كنت تبني باستخدام [Agents SDK](https://docs.anthropic.com/en/docs/agents-sdk)، يمكنك استخدام نفس نظام hooks برمجياً.
4847

4948
<Steps>
5049
<Step title="تثبيت failproofai في مشروعك">
5150
```bash
5251
npm install failproofai
5352
```
5453
</Step>
55-
<Step title="تكوين الخطافات في وكيلك">
56-
مرّر أوامر الخطافات عند إنشاء عملية الوكيل. تعمل الخطافات بنفس الطريقة كما في Claude Code - عبر stdin/stdout JSON:
54+
<Step title="تكوين hooks في وكيلك">
55+
مرر أوامر hook عند إنشاء عملية الوكيل. تُشغّل الـ hooks بنفس الطريقة كما في Claude Code - عبر JSON في stdin/stdout:
5756

5857
```bash
5958
failproofai --hook PreToolUse # يُستدعى قبل كل أداة
@@ -89,35 +88,35 @@ icon: book-open
8988
9089
## حظر الأوامر المدمرة
9190
92-
الإعداد الأكثر شيوعاً - منع الوكلاء من إلحاق الضرر غير القابل للعكس.
91+
الإعداد الأكثر شيوعاً - منع الوكلاء من إلحاق الضرر الذي لا يمكن إرجاعه.
9392
9493
```bash
9594
failproofai policies --install block-sudo block-rm-rf block-force-push block-curl-pipe-sh
9695
```
9796
98-
ما الذي يفعله:
97+
ما تفعله:
9998
- `block-sudo` - يحظر جميع أوامر `sudo`
10099
- `block-rm-rf` - يحظر حذف الملفات العودية
101100
- `block-force-push` - يحظر `git push --force`
102-
- `block-curl-pipe-sh` - يحظر إرسال البرامج النصية البعيدة إلى shell
101+
- `block-curl-pipe-sh` - يحظر توجيه النصوص البعيدة إلى shell
103102
104103
---
105104
106105
## منع تسرب الأسرار
107106
108-
منع الوكلاء من رؤية أو تسرب بيانات المصادقة في مخرجات الأداة.
107+
منع الوكلاء من رؤية أو تسرب بيانات اعتماد من مخرجات الأداة.
109108
110109
```bash
111110
failproofai policies --install sanitize-api-keys sanitize-jwt sanitize-connection-strings sanitize-bearer-tokens
112111
```
113112
114-
تعمل هذه على `PostToolUse` - بعد تشغيل أداة، تقوم بتنظيف المخرجات قبل أن يراها الوكيل.
113+
تُشغّل على `PostToolUse` - بعد تشغيل الأداة، تُنظّف المخرجات قبل أن يراها الوكيل.
115114
116115
---
117116
118-
## الحصول على تنبيهات Slack عند احتياج الوكلاء للاهتمام
117+
## الحصول على تنبيهات Slack عندما يحتاج الوكلاء إلى الاهتمام
119118
120-
استخدم خطاف الإشعارات لإعادة توجيه تنبيهات الخمول إلى Slack.
119+
استخدم hook الإشعار لإعادة توجيه تنبيهات عدم النشاط إلى Slack.
121120
122121
```javascript
123122
import { customPolicies, allow, instruct } from "failproofai";
@@ -159,7 +158,7 @@ SLACK_WEBHOOK_URL=https://hooks.slack.com/... failproofai policies --install --c
159158
160159
---
161160
162-
## إبقاء الوكلاء على فرع
161+
## الحفاظ على الوكلاء على فرع معين
163162
164163
منع الوكلاء من تبديل الفروع أو الدفع إلى الفروع المحمية.
165164
@@ -183,7 +182,7 @@ customPolicies.add({
183182
184183
---
185184
186-
## طلب الاختبارات قبل الالتزامات
185+
## مطالبة الوكلاء بتشغيل الاختبارات قبل الالتزام
187186
188187
ذكّر الوكلاء بتشغيل الاختبارات قبل الالتزام.
189188
@@ -209,7 +208,7 @@ customPolicies.add({
209208
210209
## قفل مستودع الإنتاج
211210
212-
التزم بتكوين على مستوى المشروع بحيث يحصل كل مطور في فريقك على نفس السياسات.
211+
ألزم إعداد على مستوى المشروع حتى يحصل كل مطور في فريقك على نفس السياسات.
213212
214213
أنشئ `.failproofai/policies-config.json` في مستودعك:
215214
@@ -232,23 +231,23 @@ customPolicies.add({
232231
}
233232
```
234233
235-
ثم التزم به:
234+
ثم ألزمه:
236235
237236
```bash
238237
git add .failproofai/policies-config.json
239238
git commit -m "Add failproofai team policies"
240239
```
241240
242-
كل عضو في الفريق لديه failproofai مثبتاً سيختار هذه القواعد تلقائياً.
241+
كل عضو في الفريق لديه failproofai مثبت سيختار هذه القواعد تلقائياً.
243242
244243
---
245244
246-
## بناء معيار جودة على مستوى المؤسسة مع سياسات الاتفاقية
245+
## بناء معيار جودة على مستوى المنظمة باستخدام سياسات الاتفاقية
247246
248-
الإعداد الأكثر تأثيراً: التزم بـ `.failproofai/policies/` في مستودعك مع سياسات مخصصة لمشروعك. كل عضو في الفريق يحصل عليها تلقائياً - لا أوامر تثبيت، لا تغييرات تكوين.
247+
الإعداد الأكثر تأثيراً: ألزم `.failproofai/policies/` في مستودعك مع سياسات مصممة خصيصاً لمشروعك. يحصل كل عضو في الفريق عليها تلقائياً — بدون أوامر تثبيت، بدون تغييرات في الإعدادات.
249248
250249
<Steps>
251-
<Step title="إنشاء الدليل وإضافة السياسات">
250+
<Step title="أنشئ المجلد وأضف السياسات">
252251
```bash
253252
mkdir -p .failproofai/policies
254253
```
@@ -284,25 +283,25 @@ git commit -m "Add failproofai team policies"
284283
});
285284
```
286285
</Step>
287-
<Step title="الالتزام بـ git">
286+
<Step title="ألزم إلى git">
288287
```bash
289288
git add .failproofai/policies/
290289
git commit -m "Add team quality policies"
291290
```
292291
</Step>
293-
<Step title="الاستمرار في التحسين">
294-
عندما يواجه فريقك أنماط فشل جديدة، أضف سياسات وادفع. يحصل الجميع على التحديث في أالتحديث التالي `git pull`. تصبح هذه السياسات معيار جودة حياً ينمو مع فريقك.
292+
<Step title="استمر في التحسين">
293+
عندما يواجه فريقك أنماط فشل جديدة، أضف سياسات واضغط. يحصل الجميع على التحديث عند `git pull` التالي. تصبح هذه السياسات معياراً للجودة يتطور مع فريقك.
295294
</Step>
296295
</Steps>
297296
298297
---
299298
300-
## أمثلة أخرى
299+
## أمثلة إضافية
301300
302301
يحتوي دليل [`examples/`](https://github.com/failproofai/failproofai/tree/main/examples) في المستودع على:
303302
304-
| الملف | ما الذي يعرضه |
305-
|------|---------------|
306-
| `policies-basic.js` | سياسات المبتدئين - حظر عمليات كتابة الإنتاج والدفع الإجباري والبرامج النصية المرسلة |
307-
| `policies-notification.js` | تنبيهات Slack لإخطارات الخمول ونهاية الجلسة |
308-
| `policies-advanced/index.js` | الاستيراد المتعدي والخطافات غير المتزامنة وتنظيف مخرجات PostToolUse ومعالجة حدث Stop |
303+
| الملف | ما يوضحه |
304+
|------|----------|
305+
| `policies-basic.js` | سياسات البداية - حظر عمليات الكتابة في الإنتاج، الدفع القسري، النصوص المعاد توجيهها |
306+
| `policies-notification.js` | تنبيهات Slack لإشعارات عدم النشاط ونهاية الجلسة |
307+
| `policies-advanced/index.js` | الواردات الانتقالية، hooks غير المتزامنة، تنظيف مخرجات PostToolUse، معالجة حدث Stop |

‎docs/ar/package-aliases.mdx‎

Lines changed: 26 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
2-
title: اسم الحزم المستعار
3-
description: "اسماء مستعارة مسجلة لمنع الكتابة الخاطئة وكيفية عملها"
2+
title: اسم الحزم المستعارة
3+
description: "الأسماء المستعارة المسجلة لمنع محاكاة الأخطاء وكيفية عملها"
44
icon: copy
55
---
66

@@ -10,58 +10,58 @@ icon: copy
1010

1111
```bash
1212
npm install -g failproofai
13-
# or
13+
# أو
1414
bun add -g failproofai
1515
```
1616

1717
---
1818

19-
## لماذا نملك أسماء الحزم المستعارة
19+
## لماذا نمتلك أسماء الأسماء المستعارة
2020

21-
Typosquatting هي هجمة شائعة على سلسلة التوريد حيث يقوم جهة فاعلة خبيثة بتسجيل اسم حزمة يختلف بضغطة واحدة فقط عن حزمة شهيرة. المستخدمون غير المدركين الذين يخطئون في كتابة أمر التثبيت ينتهي بهم الحال بتشغيل رمز يتحكم فيه المهاجم مع وصول كامل إلى النظام - وهذا هو نوع التهديد الذي تم تصميم Failproof AI للدفاع ضده.
21+
محاكاة الأخطاء (typosquatting) هي هجوم شائع على سلسلة التوريد حيث يقوم ممثل خبيث بتسجيل اسم حزمة يبعد ضغطة واحدة عن حزمة شهيرة. المستخدمون الذين لا يتوقعون ذلك والذين يخطئون في كتابة أمر التثبيت ينتهي بهم الحال إلى تشغيل كود يتحكم به المهاجم بإمكانية الوصول الكامل إلى النظام - وهو بالضبط نوع التهديد الذي صُمم Failproof AI للدفاع ضده.
2222

23-
لاستبعاد هذه المشكلة، **نحن نملك بشكل استباقي جميع الأخطاء الإملائية الشائعة والمتغيرات الشكلية** لـ `failproofai` على npm. لا يمكن لأي طرف ثالث تسجيل أي من هذه الأسماء. كل واحد منها هو وكيل بسيط يقوم بتثبيت وتفويض الحزمة الحقيقية `failproofai`.
23+
لإزالة هذا السطح، **نمتلك مسبقاً جميع الأخطاء الإملائية الشائعة ومتغيرات التنسيق** لـ `failproofai` على npm. لا يمكن لأي طرف ثالث تسجيل أي من هذه الأسماء. كل واحد منها هو وكيل خفيف يثبت ويفوض إلى حزمة `failproofai` الحقيقية.
2424

2525
---
2626

2727
## الأسماء المستعارة المسجلة
2828

29-
**المتغيرات الشكلية** - طرق مختلفة لكتابة "failproof ai":
29+
**متغيرات التنسيق** - طرق مختلفة لكتابة "failproof ai":
3030

3131
| الحزمة | الحالة |
3232
|---------|--------|
3333
| `failproof` | ✅ منشورة |
34-
| `failproof-ai` | ⏳ في انتظار دعم npm |
35-
| `fail-proof-ai` | ⏳ في انتظار دعم npm |
36-
| `failproof_ai` | ⏳ في انتظار دعم npm |
37-
| `fail_proof_ai` | ⏳ في انتظار دعم npm |
38-
| `fail-proofai` | ⏳ في انتظار دعم npm |
34+
| `failproof-ai` | ⏳ قيد انتظار دعم npm |
35+
| `fail-proof-ai` | ⏳ قيد انتظار دعم npm |
36+
| `failproof_ai` | ⏳ قيد انتظار دعم npm |
37+
| `fail_proof_ai` | ⏳ قيد انتظار دعم npm |
38+
| `fail-proofai` | ⏳ قيد انتظار دعم npm |
3939

40-
**أخطاء `failprof*`** - الحرف o مفقود من "proof":
40+
**أخطاء `failprof*`** - حرف واحد مفقود من "proof":
4141

4242
| الحزمة | الحالة |
4343
|---------|--------|
4444
| `failprof` | ✅ منشورة |
4545
| `failprof-ai` | ✅ منشورة |
46-
| `failprofai` | ⏳ في انتظار دعم npm |
47-
| `fail-prof-ai` | ⏳ في انتظار دعم npm |
48-
| `failprof_ai` | ⏳ في انتظار دعم npm |
46+
| `failprofai` | ⏳ قيد انتظار دعم npm |
47+
| `fail-prof-ai` | ⏳ قيد انتظار دعم npm |
48+
| `failprof_ai` | ⏳ قيد انتظار دعم npm |
4949

50-
**أخطاء `faliproof*`** - تبديل موضع `a` و `i`:
50+
**أخطاء `faliproof*`** - حروف `a` و `i` مقلوبة:
5151

5252
| الحزمة | الحالة |
5353
|---------|--------|
5454
| `faliproof` | ✅ منشورة |
5555
| `faliproof-ai` | ✅ منشورة |
56-
| `faliproofai` | ⏳ في انتظار دعم npm |
56+
| `faliproofai` | ⏳ قيد انتظار دعم npm |
5757

58-
> **لماذا في الانتظار؟** سياسة مكافحة البريد العشوائي في npm تحظر الأسماء التي تتطابق مع اسم حزمة موجودة بعد إزالة علامات الترقيم والتحقق من التشابه. لقد تواصلنا مع دعم npm لحجز هذه الأسماء لأغراض مكافحة الكتابة الخاطئة. سيتم تفعيلها بمجرد الموافقة عليها.
58+
> **لماذا قيد الانتظار؟** سياسة npm لمنع البريد العشوائي تحظر الأسماء التي تتطابق مع نفس السلسلة النصية للحزمة الموجودة بعد إزالة علامات الترقيم وتشغيل فحوصات التشابه. لقد تواصلنا مع فريق دعم npm لحجز هذه الأسماء لأغراض منع محاكاة الأخطاء. سيتم تفعيلها بمجرد الموافقة عليها.
5959
60-
يمكنك التحقق من أن أي اسم مستعار منشور يملكه لنا:
60+
يمكنك التحقق من أن أي اسم مستعار منشور مملوك لنا:
6161

6262
```bash
6363
npm info failproof
64-
# ابحث عن: "ExosphereHost Inc." في حقل المشرفين
64+
# ابحث عن: "ExosphereHost Inc." في حقل المسؤولين
6565
```
6666

6767
---
@@ -70,13 +70,13 @@ npm info failproof
7070

7171
كل حزمة مستعارة:
7272

73-
1. تدرج `failproofai` كتبعية - بحيث تعمل الحزمة الحقيقية (بما في ذلك خطاف `postinstall` الخاص بها) عند التثبيت
74-
2. تكشف عن ملف ثنائي يطابق اسمها الخاص (مثل `failprof-ai`) الذي يفوض جميع المعاملات إلى ملف `failproofai` الثنائي
73+
1. تدرج `failproofai` كمتطلب اعتماد - بحيث تعمل الحزمة الحقيقية (بما في ذلك إعداد `postinstall` hook الخاص بها) عند التثبيت
74+
2. تكشف عن ملف تنفيذي يطابق اسمها الخاص (على سبيل المثال `failprof-ai`) يفوض جميع المعاملات إلى ملف تنفيذي `failproofai`
7575

76-
الوكيل هو نص Node بسطرين؛ لا توجد منطق، ولا استدعاءات شبكية، ولا جمع بيانات تتجاوز ما تفعله `failproofai` نفسها.
76+
الوكيل هو سكريبت Node من سطرين؛ لا توجد منطق، لا استدعاءات شبكة، ولا جمع بيانات فيما وراء ما تفعله `failproofai` بنفسها.
7777

7878
---
7979

80-
## إذا وجدت اسما لم نسجله
80+
## إذا وجدت اسماً فاتنا
8181

82-
افتح مشكلة في [failproofai/failproofai](https://github.com/failproofai/failproofai/issues) وسنقوم بتسجيلها.
82+
افتح مشكلة في [failproofai/failproofai](https://github.com/failproofai/failproofai/issues) وسنقوم بتسجيله.

0 commit comments

Comments
 (0)