مقدمه
PRECC چیست؟
PRECC (تصحیح خطای پیشبینانه برای Claude Code) یک ابزار Rust است که دستورات bash Claude Code را از طریق مکانیزم رسمی هوک PreToolUse رهگیری میکند. خطاها را قبل از وقوع اصلاح میکند.
رایگان برای کاربران جامعه.
مشکل
Claude Code توکنهای قابل توجهی را روی خطاهای قابل پیشگیری هدر میدهد:
- خطاهای پوشه – اجرای
cargo buildبدونCargo.toml - حلقههای تلاش مجدد – دستور ناموفق خروجی طولانی تولید میکند
- خروجی طولانی – دستوراتی مانند
findیاls -Rهزاران خط تولید میکنند
چهار ستون
اصلاح زمینه (cd-prepend)
تشخیص میدهد زمانی که دستوراتی مانند cargo build یا npm test در پوشه اشتباه اجرا میشوند و cd /مسیر/درست && را قبل از اجرا اضافه میکند.
اشکالزدایی GDB
فرصتهای اتصال GDB را شناسایی میکند.
کاوش جلسات
لاگهای جلسه Claude Code را برای یافتن جفتهای خطا-اصلاح تحلیل میکند.
مهارتهای خودکارسازی
کتابخانهای از مهارتها که الگوهای دستور را تطبیق داده و بازنویسی میکنند.
چگونه کار میکند (نسخه 30 ثانیهای)
- Claude Code در حال اجرای یک دستور bash است.
- هوک PreToolUse دستور را به صورت JSON ارسال میکند.
precc-hookدستور را در کمتر از 3 میلیثانیه پردازش میکند.- دستور اصلاحشده برگردانده میشود.
- Claude Code دستور اصلاحشده را اجرا میکند.
Claude هرگز خطا را نمیبیند.
فشردهسازی تطبیقی
اگر یک دستور پس از فشردهسازی شکست بخورد، PRECC به طور خودکار فشردهسازی را در تلاش بعدی رد میکند تا Claude خروجی کامل غیرفشرده را برای اشکالزدایی دریافت کند.
آمار استفاده زنده
| معیار | مقدار |
|---|---|
| فراخوانیهای هوک | – |
| توکنهای صرفهجویی شده | – |
| نسبت صرفهجویی | –% |
| بازنویسیهای RTK | – |
| اصلاحات CD | – |
| تأخیر هوک | – ms (p50) |
اعداد تخمینی هستند. هر شکست جلوگیری شده یک چرخه کامل تلاش مجدد را اجتناب میکند: خروجی خطا، استدلال مدل و دستور تلاش مجدد. این اعداد به طور خودکار از دادههای اندازهگیری ناشناس بهروز میشوند.
پیوندها
- GitHub: https://github.com/peria-ai/precc-cc
- وبسایت: https://peria.ai
- مستندات: https://precc.cc