Skip to content
KitploitKITPLOIT
أدواتالمدونة
إرسال
أدواتالمدونة
إرسال

أدوات الاختراق واختبار الاختراق والأمن السيبراني لترسانتك الأمنية!

Kitploit هو دليل لأدوات الاختراق والأمن السيبراني واختبار الاختراق. اكتشف آخر تحديثات المشاريع للعثور على الثغرات وتحليل الأنظمة وأتمتة الاختبارات وتعزيز أمنك.

··الخلاصات·اتصال·الخصوصية·© 2026 Kitploit

دليل الأدوات

الفئات

عرض جميع الفئات
Loading categories
run-gemini-cli — إجراء GitHub يستدعي واجهة سطر الأوامر Gemini. | Kitploit
أدوات/GitHubGitHub/google-github-actions/run-gemini-cli
تحليل الكودDevSecOpsالأدوات والمكوناتالتعلم والتعليمأمن الذكاء الاصطناعي
GitHubgoogle-github-actions/run-gemini-cli

run-gemini-cli

إجراء GitHub يستدعي واجهة سطر الأوامر Gemini.

عرض المستودع
2.0k277منذ شهر واحدتمت المراجعة من قبل Kitploit

الأكثر شعبية

عرض الكل →

اكتشف الأدوات الأكثر استخدامًا من قبل مجتمعنا.

استكشف جميع الأدوات

تصفح مجموعتنا من الأدوات

عرض جميع الأدوات →
مشاركة
الموقع الإلكتروني

run-gemini-cli

نظرة عامة

run-gemini-cli هو إجراء GitHub يدمج Gemini في سير عمل التطوير الخاص بك عبر Gemini CLI. يعمل كعامل مستقل للمهام البرمجية الروتينية الحرجة، وكمتعاون حسب الطلب يمكنك تفويض العمل إليه بسرعة.

استخدمه لتنفيذ مراجعات طلبات السحب على GitHub، وفرز المشكلات، وإجراء تحليل الكود وتعديله، والمزيد باستخدام Gemini بطريقة محادثة (مثل @gemini-cli fix this issue) مباشرة داخل مستودعات GitHub الخاصة بك.

  • run-gemini-cli
    • نظرة عامة
    • الميزات
    • بدء سريع
      • 1. احصل على مفتاح API من Gemini
      • 2. أضفه كسر من أسرار GitHub
      • 3. حدّث ملف .gitignore الخاص بك
      • 4. اختر سير عمل
      • 5. جربه!
    • سير العمل
      • Gemini Dispatch
      • فرز المشكلات
      • مراجعة طلب السحب
      • مساعد Gemini CLI
    • الإعدادات
      • المدخلات
      • المخرجات
      • متغيرات المستودع
      • الأسرار
    • المصادقة
      • المصادقة مع Google
      • المصادقة مع GitHub
    • قابلية المراقبة
    • الإضافات
    • أفضل الممارسات
    • التخصيص
    • المساهمة

الميزات

  • الأتمتة: تشغيل سير العمل بناءً على الأحداث (مثل فتح مشكلة) أو الجداول الزمنية (مثل الليلي).
  • التعاون حسب الطلب: تشغيل سير العمل في تعليقات المشكلات وطلبات السحب عن طريق ذكر Gemini CLI (مثل @gemini-cli /review).
  • قابل للتوسيع بالأدوات: استفد من قدرات Gemini على استدعاء الأدوات للتفاعل مع واجهات CLI الأخرى مثل GitHub CLI (gh).
  • قابل للتخصيص: استخدم ملف GEMINI.md في مستودعك لتقديم تعليمات وسياق خاص بالمشروع لـ Gemini CLI.

بدء سريع

ابدأ مع Gemini CLI في مستودعك في دقائق معدودة:

1. احصل على مفتاح API من Gemini

احصل على مفتاح API الخاص بك من Google AI Studio مع حصص سخية مجانية.

2. أضفه كسر من أسرار GitHub

خزّن مفتاح API الخاص بك كسر باسم GEMINI_API_KEY في مستودعك:

  • اذهب إلى Settings > Secrets and variables > Actions في مستودعك.
  • انقر على New repository secret.
  • الاسم: GEMINI_API_KEY، القيمة: مفتاح API الخاص بك.

3. حدّث ملف .gitignore الخاص بك

أضف الإدخالات التالية إلى ملف .gitignore الخاص بك:

root@kitploit:~
# gemini-cli settings
.gemini/

# GitHub App credentials
gha-creds-*.json

4. اختر سير عمل

لديك خياران لإعداد سير عمل:

الخيار أ: استخدم أمر الإعداد (موصى به)

  1. ابدأ Gemini CLI في الطرفية الخاصة بك:

    root@kitploit:~
    gemini

  2. في Gemini CLI في الطرفية، اكتب:

    root@kitploit:~
    /setup-github

الخيار ب: انسخ سير العمل يدويًا

  1. انسخ سير العمل المُعدّة مسبقًا من دليل examples/workflows إلى دليل .github/workflows في مستودعك. ملاحظة: يجب أيضًا نسخ سير العمل gemini-dispatch.yml، الذي يقوم بتشغيل سير العمل لتنفيذه.

5. جربه!

مراجعة طلب السحب:

  • افتح طلب سحب في مستودعك وانتظر المراجعة التلقائية.
  • علّق بـ @gemini-cli /review على طلب سحب موجود لتشغيل مراجعة يدويًا.

فرز المشكلات:

  • افتح مشكلة وانتظر الفرز التلقائي.
  • علّق بـ @gemini-cli /triage على مشكلات موجودة لتشغيل الفرز يدويًا.

المساعدة العامة بالذكاء الاصطناعي:

  • في أي مشكلة أو طلب سحب، اذكر @gemini-cli متبوعًا بطلبك.
  • أمثلة:
    • @gemini-cli explain this code change
    • @gemini-cli suggest improvements for this function
    • @gemini-cli help me debug this error
    • @gemini-cli write unit tests for this component

سير العمل

يوفر هذا الإجراء العديد من سير العمل المُعدّة مسبقًا لحالات استخدام مختلفة. كل سير عمل مُصمم ليتم نسخه إلى دليل .github/workflows في مستودعك وتخصيصه حسب الحاجة.

Gemini Dispatch

يعمل سير العمل هذا كموزع مركزي لـ Gemini CLI، حيث يوجه الطلبات إلى سير العمل المناسب بناءً على الحدث المُشغّل والأمر المُقدم في التعليق. للحصول على دليل مفصل حول كيفية إعداد سير عمل التوزيع، توجه إلى وثائق سير عمل Gemini Dispatch.

فرز المشكلات

يمكن استخدام هذا الإجراء لفرز مشكلات GitHub تلقائيًا أو وفقًا لجدول زمني. للحصول على دليل مفصل حول كيفية إعداد نظام فرز المشكلات، توجه إلى وثائق سير عمل فرز مشكلات GitHub.

مراجعة طلب السحب

يمكن استخدام هذا الإجراء لمراجعة طلبات السحب تلقائيًا عند فتحها. للحصول على دليل مفصل حول كيفية إعداد نظام مراجعة طلب السحب، توجه إلى وثائق سير عمل مراجعة PR على GitHub.

مساعد Gemini CLI

يمكن استخدام هذا النوع من الإجراءات لاستدعاء مساعد Gemini AI للأغراض العامة والمحادثة داخل طلبات السحب والمشكلات لأداء مجموعة واسعة من المهام. للحصول على دليل مفصل حول كيفية إعداد سير عمل Gemini CLI للأغراض العامة، توجه إلى وثائق سير عمل مساعد Gemini.

الإعدادات

المدخلات

  • gcp_location: (اختياري) موقع Google Cloud.

  • gcp_project_id: (اختياري) معرف مشروع Google Cloud.

  • gcp_service_account: (اختياري) البريد الإلكتروني لحساب الخدمة في Google Cloud.

  • gcp_workload_identity_provider: (اختياري) موفر هوية العمل في Google Cloud.

  • gcp_token_format: (اختياري، القيمة الافتراضية: access_token) تنسيق الرمز المميز للمصادقة. اضبط على "access_token" لإنشاء رموز وصول (يتطلب حساب خدمة)، أو اضبط على سلسلة فارغة لـ WIF المباشر. يمكن أن يكون "access_token" أو "id_token".

  • gcp_access_token_scopes: (اختياري، القيمة الافتراضية: https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/userinfo.email,https://www.googleapis.com/auth/userinfo.profile) نطاقات رمز الوصول عند استخدام token_format "access_token". قائمة مفصولة بفواصل لنطاقات OAuth 2.0.

المخرجات

  • summary: المخرجات الملخصة من تنفيذ Gemini CLI.

  • error: مخرجات الخطأ من تنفيذ Gemini CLI، إن وجدت.

متغيرات المستودع

نوصي بتعيين القيم التالية كمتغيرات للمستودع بحيث يمكن إعادة استخدامها عبر جميع سير العمل. بدلاً من ذلك، يمكنك تعيينها بشكل مضمن كمدخلات إجراء في سير العمل الفردي أو لتجاوز القيم على مستوى المستودع.

[!WARNING] لا تستخدم متغير البيئة DEBUG لأنه يتسبب في توقف Gemini CLI عن العمل في انتظار اتصال مصحح العقدة.

لإضافة متغير مستودع:

  1. اذهب إلى Settings > Secrets and variables > Actions > New variable في مستودعك.
  2. أدخل اسم المتغير وقيمته.
  3. احفظ.

للحصول على تفاصيل حول متغيرات المستودع، راجع وثائق GitHub حول المتغيرات.

الأسرار

يمكنك تعيين الأسرار التالية في مستودعك:

لإضافة سر:

  1. اذهب إلى Settings > Secrets and variables > Actions > New repository secret في مستودعك.
  2. أدخل اسم السر وقيمته.
  3. احفظ.

لمزيد من المعلومات، راجع وثائق GitHub الرسمية حول إنشاء واستخدام الأسرار المشفرة.

المصادقة

يتطلب هذا الإجراء المصادقة على كل من خدمات Google (لـ Gemini AI) وواجهة GitHub API.

المصادقة مع Google

اختر طريقة المصادقة التي تناسب حالة الاستخدام الخاصة بك:

  1. مفتاح Gemini API: أبسط طريقة للمشاريع التي لا تتطلب التكامل مع Google Cloud.
  2. Workload Identity Federation: الطريقة الأكثر أمانًا للمصادقة على خدمات Google Cloud.

المصادقة مع GitHub

يمكنك المصادقة مع GitHub بطريقتين:

  1. GITHUB_TOKEN الافتراضي: لحالات الاستخدام الأبسط، يمكن للإجراء استخدام GITHUB_TOKEN الافتراضي الذي يوفره سير العمل.
  2. تطبيق GitHub مخصص (موصى به): للحصول على المصادقة الأكثر أمانًا ومرونة، نوصي بإنشاء تطبيق GitHub مخصص.

للحصول على تعليمات إعداد مفصلة لكل من المصادقة مع Google وGitHub، توجه إلى وثائق المصادقة.

قابلية المراقبة

يمكن تكوين هذا الإجراء لإرسال بيانات القياس عن بُعد (التتبعات والمقاييس والسجلات) إلى مشروع Google Cloud الخاص بك. يتيح لك ذلك مراقبة أداء وسلوك Gemini CLI داخل سير العمل الخاص بك، مما يوفر رؤى قيّمة لتصحيح الأخطاء والتحسين.

للحصول على تعليمات مفصلة حول كيفية إعداد وتكوين قابلية المراقبة، توجه إلى وثائق قابلية المراقبة.

الإضافات

يمكن توسيع Gemini CLI بوظائف إضافية من خلال الإضافات. يتم تثبيت هذه الإضافات من المصدر من مستودعاتها على GitHub.

للحصول على تعليمات مفصلة حول كيفية إعداد وتكوين الإضافات، توجه إلى وثائق الإضافات.

أفضل الممارسات

لضمان أمان وموثوقية وكفاءة سير العمل الآلي الخاص بك، نوصي بشدة باتباع أفضل ممارساتنا. تغطي هذه الإرشادات المجالات الرئيسية مثل أمان المستودع، وتكوين سير العمل، والمراقبة.

تشمل التوصيات الرئيسية ما يلي:

  • تأمين مستودعك: تنفيذ حماية الفروع والعلامات، وتقييد معتمدي طلبات السحب.
  • تكوين سير العمل: استخدام Workload Identity Federation للمصادقة الآمنة على Google Cloud، وإدارة الأسرار بفعالية، وتثبيت إصدارات الإجراءات لمنع التغييرات غير المتوقعة.
  • المراقبة والتدقيق: مراجعة سجلات الإجراءات بانتظام وتمكين OpenTelemetry للحصول على رؤى أعمق حول الأداء والسلوك.

للحصول على دليل شامل حول تأمين مستودعك وسير العمل، يرجى الرجوع إلى وثائق أفضل الممارسات.

التخصيص

أنشئ ملف GEMINI.md في جذر مستودعك لتوفير سياق وتعليمات خاصة بالمشروع لـ Gemini CLI. هذا مفيد لتحديد اصطلاحات الترميز، أو الأنماط المعمارية، أو إرشادات أخرى يجب أن يتبعها النموذج لمستودع معين.

المساهمة

المساهمات مرحب بها! اطلع على دليل المساهمة الخاص بـ Gemini CLI لمزيد من التفاصيل حول كيفية البدء.

تنزيل الأداة

  • gemini_api_key: (اختياري) مفتاح API لواجهة Gemini API.

  • gemini_cli_version: (اختياري، القيمة الافتراضية: latest) إصدار Gemini CLI الذي سيتم تثبيته. يمكن أن يكون "latest"، أو "preview"، أو "nightly"، أو رقم إصدار محدد، أو فرع git أو علامة أو commit. لمزيد من المعلومات، راجع إصدارات Gemini CLI.

  • gemini_debug: (اختياري) تمكين تسجيل التصحيح وتدفق المخرجات.

  • gemini_model: (اختياري) النموذج الذي سيتم استخدامه مع Gemini.

  • google_api_key: (اختياري) مفتاح Vertex AI API الذي سيتم استخدامه مع Gemini.

  • prompt: (اختياري، القيمة الافتراضية: You are a helpful assistant) سلسلة تُمرر إلى وسيطة --prompt الخاصة بـ Gemini CLI.

  • settings: (اختياري) سلسلة JSON تُكتب إلى .gemini/settings.json لتكوين إعدادات المشروع في CLI. لمزيد من التفاصيل، راجع الوثائق حول ملفات الإعدادات.

  • use_gemini_code_assist: (اختياري، القيمة الافتراضية: false) ما إذا كان سيتم استخدام Code Assist للوصول إلى نموذج Gemini بدلاً من مفتاح Gemini API الافتراضي. لمزيد من المعلومات، راجع وثائق Gemini CLI.

  • use_vertex_ai: (اختياري، القيمة الافتراضية: false) ما إذا كان سيتم استخدام Vertex AI للوصول إلى نموذج Gemini بدلاً من مفتاح Gemini API الافتراضي. لمزيد من المعلومات، راجع وثائق Gemini CLI.

  • extensions: (اختياري) قائمة بإضافات Gemini CLI التي سيتم تثبيتها.

  • upload_artifacts: (اختياري، القيمة الافتراضية: false) ما إذا كان سيتم رفع القطع الأثرية إلى إجراء GitHub.

  • use_pnpm: (اختياري، القيمة الافتراضية: false) ما إذا كان سيتم استخدام pnpm بدلاً من npm لتثبيت gemini-cli.

  • workflow_name: (اختياري، القيمة الافتراضية: ${{ github.workflow }}) اسم سير العمل في GitHub، يُستخدم لأغراض القياس عن بُعد.

  • github_pr_number: (اختياري، القيمة الافتراضية: ${{ github.event.pull_request.number }}) رقم طلب السحب الذي يعمل عليه CLI. القيمة الافتراضية هي حمولة الحدث.

  • github_issue_number: (اختياري، القيمة الافتراضية: ${{ github.event.issue.number }}) رقم المشكلة (أو قائمة مفصولة بفواصل لأرقام المشكلات) الذي يعمل عليه CLI. القيمة الافتراضية هي حمولة الحدث.

    • الاسمالوصفالنوعمطلوبمتى يكون مطلوبًا
    GEMINI_DEBUGتمكين تسجيل التصحيح لـ Gemini CLI.متغيرلاأبدًا
    GEMINI_CLI_VERSIONيتحكم في إصدار Gemini CLI الذي سيتم تثبيته.متغيرلاتثبيت إصدار CLI
    GCP_WIF_PROVIDERاسم المورد الكامل لموفر هوية العمل.متغيرلااستخدام Google Cloud
    GOOGLE_CLOUD_PROJECTمشروع Google Cloud للاستدلال وقابلية المراقبة.متغيرلااستخدام Google Cloud
    SERVICE_ACCOUNT_EMAILعنوان البريد الإلكتروني لحساب الخدمة في Google Cloud. اختياري - مطلوب فقط لـ WIF مع حساب الخدمة (غير مطلوب لـ WIF المباشر).متغيرلااستخدام WIF مع حساب الخدمة
    GOOGLE_CLOUD_LOCATIONمنطقة مشروع Google Cloud.متغيرلااستخدام Google Cloud
    GOOGLE_GENAI_USE_VERTEXAIاضبط على true لاستخدام Vertex AIمتغيرلااستخدام Vertex AI
    GOOGLE_GENAI_USE_GCAاضبط على true لاستخدام Gemini Code Assistمتغيرلااستخدام Gemini Code Assist
    APP_IDمعرف تطبيق GitHub للمصادقة المخصصة.متغيرلااستخدام تطبيق GitHub مخصص
    الاسمالوصفمطلوبمتى يكون مطلوبًا
    GEMINI_API_KEYمفتاح Gemini API الخاص بك من Google AI Studio.لاليس لديك مشروع GCP.
    APP_PRIVATE_KEYالمفتاح الخاص لتطبيق GitHub الخاص بك (تنسيق PEM).لااستخدام تطبيق GitHub مخصص.
    GOOGLE_API_KEYمفتاح Google API الخاص بك لاستخدامه مع Vertex AI.لالديك حساب Vertex AI صريح.