Skip to content

README.ar.md

Latest commit

 

History

History
189 lines (142 loc) · 9.42 KB

README.ar.md

File metadata and controls

189 lines (142 loc) · 9.42 KB

⚠️ هذه ترجمة آلية. للاطلاع على أحدث إصدار، راجع English README.

🇺🇸 English | 🇨🇳 简体中文 | 🇯🇵 日本語 | 🇰🇷 한국어 | 🇪🇸 Español | 🇧🇷 Português | 🇩🇪 Deutsch | 🇫🇷 Français | 🇷🇺 Русский | 🇮🇳 हिन्दी | 🇹🇷 Türkçe | 🇻🇳 Tiếng Việt | 🇮🇹 Italiano | 🇸🇦 العربية | 🇮🇱 עברית

failproof ai

npm CI Supply Chain Slack Docs License

الترجمات: 简体中文 · 日本語 · 한국어 · Español · Português · Deutsch · Français · Русский · हिन्दी · Türkçe · Tiếng Việt · Italiano · العربية · עברית

حل فشل وقت التشغيل لوكيل الترميز. يدمج مع Claude Code و Codex. يمسك الحلقات والإجراءات الخطيرة وتسرب الأسرار قبل أن تصبح حوادث. بدون كمون. يعمل محلياً.

Failproof AI قيد العمل

واجهات الخط أمر الوكيل المدعومة

Claude Code        OpenAI Codex        GitHub Copilot        Cursor Agent

OpenCode        Pi        Gemini CLI

تثبيت المشاريع لواحد أو أي مزيج: failproofai policies --install --cli opencode pi gemini (أو --cli claude codex copilot cursor opencode pi gemini). حذف --cli للكشف التلقائي عن واجهات الخط أمر المثبتة والطلب.

تثبيت

npm install -g failproofai
failproofai policies --install   # أو فقط قم بتشغيل `failproofai` واقبل موجه التشغيل الأول
failproofai

30 سياسة مدمجة تنشط فوراً. لوحة المعلومات في localhost:8020. عطّل موجه التشغيل الأول باستخدام FAILPROOFAI_NO_FIRST_RUN=1.

ما الذي يوقفه

السياسة ما الذي يمنعه
block-push-master الدفع المباشر إلى main / master
block-force-push git push --force
block-work-on-main الالتزامات والدمج والإعادة على main / master
block-rm-rf حذف ملفات عودية
sanitize-api-keys تسرب مفاتيح API إلى سياق الوكيل

→ جميع السياسات المدمجة الـ 30

سياساتك الخاصة

أسقط ملفاً في .failproofai/policies/ — يتم تحميله تلقائياً، بدون حاجة لأعلام. التزم به وستحصل الفريق بالكامل عليه في الطلب التالي.

import { customPolicies, deny, allow } from "failproofai";

customPolicies.add({
  name: "no-production-writes",
  match: { events: ["PreToolUse"] },
  fn: async (ctx) => {
    if (ctx.toolInput?.file_path?.includes("production"))
      return deny("Writes to production paths are blocked.");
    return allow();
  },
});

ثلاثة قرارات متاحة لكل سياسة:

القرار التأثير
allow() السماح بالعملية
deny(message) حظرها — تعود الرسالة إلى الوكيل
instruct(message) اسمح بها، لكن أضف سياقاً لموجه الوكيل التالي

→ دليل السياسات المخصصة

رؤية الجلسة

كل استدعاء أداة يقوم به وكيلك يتم تسجيله محلياً. لوحة المعلومات توضح ما الذي تم تشغيله، ما الذي تم حظره، وما قالته السياسة للوكيل — بحيث لا تكون تخمين عندما يحدث خطأ ما. → دليل لوحة المعلومات

التوثيق
البدء السريع التثبيت والخطوات الأولى
السياسات المدمجة جميع السياسات الـ 30 مع المعاملات
السياسات المخصصة اكتب سياساتك الخاصة
التكوين نطاقات التكوين وقواعد الدمج
لوحة المعلومات مراقب الجلسة ونشاط السياسة
العمارة كيفية عمل نظام الخطاف

الترخيص

MIT مع Commons Clause — مجاني للاستخدام الداخلي والشخصي؛ إعادة البيع التجاري لـ failproofai نفسه يتطلب اتفاقية منفصلة. انظر LICENSE للنص الكامل.

المساهمة

انظر CONTRIBUTING.md. السياسات الجديدة والحالات الحدودية والترجمات كلها مرحب بها.

بناء قبل البدء. قم بتشغيل bun install && bun run build أولاً. يقوم هذا المستودع بتشغيل مشاريع failproofai على نفسه، وهو يحل استيراد failproofai مقابل حزمة dist/ المترجمة — بدون بناء ستصل إلى أخطاء الخطاف Cannot find package 'failproofai'. أعد البناء بعد تغيير src/. انظر البناء قبل أن تعمل خطافات المستودع داخلي.

تم البناء بواسطة Nivedit Jain و Nikita Agarwal. befailproof.ai