README.fa.md

🇬🇧 English

git-lrc

Free, Unlimited AI Code Reviews That Run on Commit

   

---

عامل‌های هوش مصنوعی سریع کد می‌نویسند. آن‌ها همچنین بی‌سر و صدا منطق را حذف می‌کنند، رفتار را عوض می‌کنند و باگ معرفی می‌کنند — بدون اینکه به شما بگویند. اغلب در محیط تولید متوجه می‌شوید.

git-lrc این را درست می‌کند. به git commit وصل می‌شود و هر diff را قبل از اعمال بررسی می‌کند. راه‌اندازی ۶۰ ثانیه‌ای. کاملاً رایگان.

در عمل ببینید

ببینید git-lrc چطور مسائل امنیتی جدی مثل credentialهای نشت‌کرده، عملیات ابری پرهزینه و مطالب حساس در لاگ را تشخیص می‌دهد

git-lrc-intro-60s.mp4

چرا

• 🤖 عامل‌های هوش مصنوعی بی‌سر و صدا خراب می‌کنند. کد حذف شده. منطق عوض شده. موارد لبه از بین رفته. تا محیط تولید متوجه نمی‌شوید.
• 🔍 قبل از ship گرفتن بگیرید. کامنت‌های خطی مبتنی بر هوش مصنوعی دقیقاً نشان می‌دهند چه چیزی عوض شده و چه چیزی اشتباه به نظر می‌رسد.
• 🔁 عادت بسازید، کد بهتر ship کنید. بررسی منظم → باگ کمتر → کد مقاوم‌تر → نتیجه بهتر در تیم.
• 🔗 چرا git؟ Git همه‌گیر است. هر ادیتور، هر IDE، هر ابزار هوش مصنوعی از آن استفاده می‌کند. commit اجباری است. پس تقریباً هیچ شانسی برای از دست دادن review نیست — مستقل از استک شما.

شروع کنید

نصب

لینوکس / مک:

curl -fsSL https://hexmos.com/lrc-install.sh | bash

ویندوز (PowerShell):

iwr -useb https://hexmos.com/lrc-install.ps1 | iex

باینری نصب شد. هوک‌ها به‌صورت سراسری تنظیم شد. تمام.

راه‌اندازی

git lrc setup

یک ویدیوی کوتاه از نحوهٔ راه‌اندازی:

git-lrc-setup-fast.mp4

دو مرحله، هر دو در مرورگر باز می‌شوند:

1. کلید API لایو ریویو — با Hexmos وارد شوید
2. کلید رایگان API جمینی — یکی از Google AI Studio بگیرید

حدود ۱ دقیقه. راه‌اندازی یک‌بار، برای کل ماشین. بعد از این، هر ریپوی git روی ماشین شما با commit بررسی را اجرا می‌کند. نیازی به تنظیم per-repo نیست.

چطور کار می‌کند

گزینه الف: بررسی روی commit (خودکار)

git add .
git commit -m "add payment validation"
# review launches automatically before the commit goes through

گزینه ب: بررسی قبل از commit (دستی)

git add .
git lrc review          # run AI review first
# or: git lrc review --vouch   # vouch personally, skip AI
# or: git lrc review --skip    # skip review entirely
git commit -m "add payment validation"

در هر صورت، یک رابط وب در مرورگر باز می‌شود.

git-lrc-trigger-edit-compressed.mp4

رابط بررسی

• 📄 diff سبک گیت‌هاب — اضافه/حذف با رنگ
• 💬 کامنت‌های خطی هوش مصنوعی — دقیقاً روی خطوط مهم، با نشان شدت
• 📝 خلاصه بررسی — نمای کلی از آنچه هوش مصنوعی پیدا کرد
• 📁 لیست فایل‌های staged — همهٔ فایل‌های staged را یک‌جا ببینید، بین آن‌ها جابه‌جا شوید
• 📊 خلاصه diff — خطوط اضافه/حذف‌شده به‌ازای هر فایل برای حس سریع دامنهٔ تغییر
• 📋 کپی مسائل — یک کلیک برای کپی همهٔ مسائل علامت‌خوردهٔ هوش مصنوعی، آماده برای برگرداندن به عامل هوش مصنوعی شما
• 🔄 چرخیدن بین مسائل — بین کامنت‌ها یکی‌یکی بدون اسکرول حرکت کنید
• 📜 لاگ رویداد — رویدادهای بررسی، تکرارها و تغییر وضعیت را در یک جا دنبال کنید

git-diff-viewer-compressed.mp4

تصمیم

Action	What happens
✅ Commit	Accept and commit the reviewed changes
🚀 Commit & Push	Commit and push to remote in one step
⏭️ Skip	Abort the commit — go fix issues first

📎 Screenshot: Pre-commit bar showing Commit / Commit & Push / Skip buttons

چرخهٔ بررسی

گردش کار معمول با کد تولیدشدهٔ هوش مصنوعی:

1. کد تولید کنید با عامل هوش مصنوعی
2. git add . → git lrc review — هوش مصنوعی مسائل را علامت می‌زند
3. مسائل را کپی کنید، به عامل برگردانید تا اصلاح کند
4. git add . → git lrc review — هوش مصنوعی دوباره بررسی می‌کند
5. تا رضایت تکرار کنید
6. git lrc review --vouch → git commit — شما ضمانت می‌کنید و commit می‌کنید

هر git lrc review یک تکرار است. ابزار تعداد تکرارها و درصد diffای که توسط هوش مصنوعی بررسی شده (coverage) را نگه می‌دارد.

Vouch

وقتی به‌قدر کافی تکرار کردید و از کد راضی هستید:

git lrc review --vouch

یعنی: «این را بررسی کردم — با تکرارهای هوش مصنوعی یا شخصاً — و مسئولیت می‌پذیرم.» بررسی هوش مصنوعی اجرا نمی‌شود، ولی آمار coverage از تکرارهای قبلی ثبت می‌شود.

Skip

فقط می‌خواهید بدون بررسی یا attestation مسئولیت commit کنید؟

git lrc review --skip

بدون بررسی هوش مصنوعی. بدون attestation شخصی. git log مقدار skipped را ثبت می‌کند.

ردیابی Git Log

هر commit یک خط وضعیت بررسی به پیام git log خود اضافه می‌کند:

LiveReview Pre-Commit Check: ran (iter:3, coverage:85%)

LiveReview Pre-Commit Check: vouched (iter:2, coverage:50%)

LiveReview Pre-Commit Check: skipped

• iter — تعداد چرخه‌های بررسی قبل از commit. iter:3 = سه دور بررسی → اصلاح → بررسی.
• coverage — درصد diff نهایی که قبلاً در تکرارهای قبل توسط هوش مصنوعی بررسی شده. coverage:85% = فقط ۱۵٪ کد بررسی‌نشده است.

تیم شما دقیقاً می‌بیند کدام commitها بررسی شدند، vouched شدند یا skip شدند — در خود git log.

سوالات متداول

Review در مقابل Vouch در مقابل Skip؟

	Review	Vouch	Skip
AI reviews the diff?	✅ Yes	❌ No	❌ No
Takes responsibility?	✅ Yes	✅ Yes, explicitly	⚠️ No
Tracks iterations?	✅ Yes	✅ Records prior coverage	❌ No
Git log message	ran (iter:N, coverage:X%)	vouched (iter:N, coverage:X%)	skipped
When to use	Each review cycle	Done iterating, ready to commit	Not reviewing this commit

Review پیش‌فرض است. هوش مصنوعی diff staged شما را تحلیل و بازخورد خطی می‌دهد. هر بررسی یک تکرار در چرخهٔ تغییر–بررسی است.

Vouch یعنی شما صریحاً مسئولیت این commit را می‌گیرید. معمولاً بعد از چند تکرار بررسی — رفت‌وآمد کردید، مسائل را اصلاح کردید و الان راضی‌اید. هوش مصنوعی دوباره اجرا نمی‌شود، ولی آمار تکرار و coverage قبلی ثبت می‌شود.

Skip یعنی این commit را بررسی نمی‌کنید. شاید پیش‌پاافتاده است، شاید حیاتی نیست — دلیل با شماست. git log فقط skipped را ثبت می‌کند.

چطور رایگانه؟

git-lrc از API جمینی گوگل برای بررسی‌های هوش مصنوعی استفاده می‌کند. جمینی سطح رایگان سخاوتمندانه دارد. شما کلید API خودتان را می‌آورید — صورتحساب واسطه نیست. سرویس ابری LiveReview که بررسی‌ها را هماهنگ می‌کند برای توسعه‌دهندگان انفرادی رایگان است.

چه داده‌ای فرستاده می‌شود؟

فقط diff staged تحلیل می‌شود. هیچ زمینهٔ کامل ریپو آپلود نمی‌شود و بعد از بررسی diffها ذخیره نمی‌شوند.

می‌توانم برای یک ریپوی خاص غیرفعالش کنم؟

git lrc hooks disable   # disable for current repo
git lrc hooks enable    # re-enable later

می‌توانم یک commit قدیمی‌تر را بررسی کنم؟

git lrc review --commit HEAD       # review the last commit
git lrc review --commit HEAD~3..HEAD  # review a range

مرجع سریع

Command	Description
lrc or lrc review	Review staged changes
lrc review --vouch	Vouch — skip AI, take personal responsibility
lrc review --skip	Skip review for this commit
lrc review --commit HEAD	Review an already-committed change
lrc hooks disable	Disable hooks for current repo
lrc hooks enable	Re-enable hooks for current repo
lrc hooks status	Show hook status
lrc self-update	Update to latest version
lrc version	Show version info

نکته: git lrc <command> و lrc <command> قابل تعویض هستند.

رایگانه. به اشتراک بگذارید.

git-lrc کاملاً رایگان است. بدون کارت اعتباری. بدون trial. بدون تله.

اگر به دردتان خورد — با دوستان توسعه‌دهنده به اشتراک بگذارید. هرچه بیشتر کد تولیدشدهٔ هوش مصنوعی بررسی شود، باگ کمتری به تولید می‌رسد.

⭐ به این ریپو ستاره بدهید تا دیگران هم پیدا کنند.

جامعه

در جامعهٔ دیسکورد git-lrc دربارهٔ امکان‌ها، بهبودها، قابلیت‌ها گفتگو کنید و برای مشارکت کمک بگیرید: discord.gg/sGdnKwB3qq.

مجوز

git-lrc تحت گونهٔ تغییریافتهٔ Sustainable Use License (SUL) توزیع می‌شود.

Note

یعنی چه:

• ✅ Source Available — کد منبع کامل برای self-hosting در دسترس است
• ✅ Business Use Allowed — از LiveReview برای عملیات داخلی کسب‌وکار استفاده کنید
• ✅ Modifications Allowed — برای استفادهٔ خود سفارشی کنید
• ❌ No Resale — قابل فروش مجدد یا عرضه به‌عنوان سرویس رقیب نیست
• ❌ No Redistribution — نسخه‌های تغییر یافته به‌صورت تجاری قابل توزیع مجدد نیستند

این مجوز تضمین می‌کند LiveReview پایدار بماند و در عین حال دسترسی کامل برای self-host و سفارشی‌سازی را دارید.

برای شرایط دقیق، نمونهٔ استفاده‌های مجاز و ممنوع و تعاریف، LICENSE.md کامل را ببینید.

---

برای تیم‌ها: LiveReview

تنها از git-lrc استفاده می‌کنید؟ عالی. با تیم می‌سازید؟ LiveReview را ببینید — مجموعهٔ کامل برای بررسی کد هوش مصنوعی در سطح تیم، با داشبورد، سیاست‌های سطح سازمان و تحلیل بررسی. هرچه git-lrc انجام می‌دهد، به‌علاوهٔ هماهنگی تیم.