مطور / Git

مساعد رسائل Conventional Commits (إنشاء والتحقق)

أنشئ رسالة commit بتنسيق Conventional Commits 1.0.0: اختر النوع، وأضف النطاق والوصف، وحدد التغييرات الجذرية، وأضف النص والتذييلات، واعرف الإصدار الذي ستنشئه أداة مثل semantic-release.

مساعد رسائل Conventional Commits (إنشاء والتحقق): تنشئ الأداة السطر الأول بالتنسيق type(scope): description، وتضيف ! بعد النطاق عند وجود تغيير جذري، ثم تضيف النص والتذييلات بعد أسطر فارغة، بما في ذلك BREAKING CHANGE: مع ملاحظة الترحيل. وتنبّه إلى تجاوز السطر الأول 72 حرفًا، وإلى وجود نقطة في نهايته، وإلى بدء الحرف الأول بحرف كبير، كما تعرض ما إذا كان commit سيؤدي إلى إصدار major أو minor أو patch. يعمل 100% محليًا في المتصفح، من دون رفع أي ملفات إلى الخادم.

الفئة
أدوات المطورين
مرات التشغيل
في المتصفح
التكلفة
مجاني · بلا تسجيل
التوفر
جاهز للاستخدام
مساعد رسائل الالتزاممعالجة محلية

تعمل بالكامل في المتصفح

رسالة الالتزام

feat(auth): إضافة تسجيل الدخول باستخدام مفاتيح المرور

53 حرفًا في السطر الأول · الإصدار: ثانوي (ميزة جديدة)

Conventional Commits 1.0.0: type(scope): description، ونص اختياري بعد سطر فارغ، وتذييلات مثل BREAKING CHANGE:. تشير ! بعد النوع إلى تغيير جذري. تقرأ أدوات مثل semantic-release وrelease-please هذه الرسائل لاختيار رقم الإصدار التالي وكتابة سجل التغييرات.

مثال

feat(auth)!: add login with passkeys, a blank line, a body explaining why, and BREAKING CHANGE: sessions now expire after 24 hours. بسبب !، ستجعل أداة الإصدار هذا إصدارًا رئيسيًا.

الإصدارات

تتوافق Conventional Commits مع نظام الإصدارات الدلالية: fix للإصدار التصحيحي، وfeat للإصدار الفرعي، والتغييرات غير المتوافقة للإصدار الرئيسي. احسب رقم الإصدار التالي باستخدام حاسبة semver.

طريقة الاستخدام

  1. اختر النوع، مثل feat أو fix، وأضف نطاقًا اختياريًا.
  2. اكتب وصفًا موجزًا، وحدد التغيير الجذري إذا وُجد.
  3. أضف نصًا أو تذييلات عند الحاجة، ثم انسخ الرسالة.

الخصوصية والقيود

تعمل جميع العمليات في المتصفح.

أدوات ذات صلة

SemverGitignoreمولّد الرخص

الأسئلة الشائعة

ما الفرق بين feat و fix؟

يضيف feat ميزة يمكن للمستخدمين الاستفادة منها، وينتج إصدار minor؛ أما fix فيصحح خللًا، وينتج إصدار patch.

متى يكون التغيير جذريًا؟

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

هل يجب استخدام Conventional Commits؟

لا، لكن أدوات مثل semantic-release وrelease-please وcommitlint تعتمد عليه لأتمتة أرقام الإصدارات وسجلات التغييرات.

أداة مجانية · عدد مرات الاستخدام في المتصفح · لا يتطلب حسابًا