Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

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

آیا PRECC برای استفاده امن است؟

بله. PRECC از مکانیزم رسمی hook PreToolUse کد Claude استفاده می‌کند – همان نقطه توسعه‌ای که Anthropic دقیقاً برای این منظور طراحی کرده است. هوک:

  • کاملاً آفلاین اجرا می‌شود (بدون فراخوانی شبکه در مسیر حساس)
  • در کمتر از ۵ میلی‌ثانیه تکمیل می‌شود
  • fail-open است: اگر مشکلی پیش بیاید، دستور اصلی بدون تغییر اجرا می‌شود
  • فقط دستورات را تغییر می‌دهد، هرگز خودش اجرا نمی‌کند
  • داده‌ها را به صورت محلی در پایگاه داده SQLite ذخیره می‌کند

آیا PRECC با سایر ابزارهای کدنویسی هوش مصنوعی کار می‌کند؟

PRECC به طور خاص برای Claude Code طراحی شده است. به پروتکل hook PreToolUse که Claude Code ارائه می‌دهد متکی است. با Cursor، Copilot، Windsurf یا سایر ابزارهای کدنویسی هوش مصنوعی کار نمی‌کند.

تله‌متری چه داده‌هایی ارسال می‌کند؟

تله‌متری فقط اختیاری است. وقتی فعال شود، ارسال می‌کند:

  • نسخه PRECC، سیستم‌عامل و معماری
  • شمارش‌های تجمیعی (دستورات رهگیری‌شده، مهارت‌های فعال‌شده)
  • میانگین تأخیر هوک

متن دستور، مسیر فایل، نام پروژه یا اطلاعات شناسایی شخصی ارسال نمی‌کند. قبل از فعال‌سازی می‌توانید بار دقیق را با precc telemetry preview مشاهده کنید. برای جزئیات تله‌متری را ببینید.

چگونه PRECC را حذف کنم؟

??faq_uninstall_a_intro??

  1. حذف ثبت هوک:

    # Delete the hook entry from Claude Code's settings
    # (precc init added it; removing it disables PRECC)
    
  2. حذف فایل باینری:

    rm ~/.local/bin/precc ~/.local/bin/precc-hook ~/.local/bin/precc-learner
    
  3. حذف داده‌ها (اختیاری):

    rm -rf ~/.local/share/precc/
    rm -rf ~/.config/precc/
    

مجوز من منقضی شده. چه اتفاقی می‌افتد؟

PRECC به سطح Community بازمی‌گردد. تمام عملکردهای اصلی همچنان کار می‌کنند:

  • مهارت‌های داخلی فعال می‌مانند
  • خط لوله hook به طور عادی اجرا می‌شود
  • precc savings نمای خلاصه را نشان می‌دهد
  • precc ingest و استخراج جلسات کار می‌کنند

ویژگی‌های Pro تا تمدید غیرفعال می‌شوند:

  • precc savings --all (جزئیات کامل)
  • precc compress
  • precc gif
  • precc gha
  • precc geofence
  • گزارش‌های ایمیلی

به نظر می‌رسد هوک اجرا نمی‌شود. چگونه اشکال‌زدایی کنم؟

??faq_debug_a_intro??

  1. بررسی کنید که هوک ثبت شده باشد:

    precc init
    
  2. هوک را به صورت دستی تست کنید:

    echo '{"tool_input":{"command":"cargo build"}}' | precc-hook
    
  3. بررسی کنید که فایل باینری در PATH شما باشد:

    which precc-hook
    
  4. پیکربندی hook در ~/.claude/settings.json را بررسی کنید.

آیا PRECC باعث کندی Claude Code می‌شود؟

خیر. هوک در کمتر از ۵ میلی‌ثانیه (p99) تکمیل می‌شود. این در مقایسه با زمانی که Claude صرف استدلال و تولید پاسخ می‌کند نامحسوس است.

آیا می‌توانم از PRECC در CI/CD استفاده کنم؟

PRECC برای جلسات تعاملی Claude Code طراحی شده است. در CI/CD، نسخه‌ای از Claude Code برای اتصال وجود ندارد. با این حال، precc gha می‌تواند اجراهای ناموفق GitHub Actions را از هر محیطی تحلیل کند.

مهارت‌های استخراج‌شده چه تفاوتی با مهارت‌های داخلی دارند؟

مهارت‌های داخلی با PRECC ارائه می‌شوند و الگوهای رایج پوشه اشتباه را پوشش می‌دهند. مهارت‌های استخراج‌شده از لاگ‌های جلسه خاص شما آموخته می‌شوند. هر دو در SQLite ذخیره و به طور یکسان توسط خط لوله hook ارزیابی می‌شوند.

آیا می‌توانم مهارت‌ها را با تیمم به اشتراک بگذارم؟

بله. هر مهارتی را با precc skills export NAME به TOML صادر کنید و فایل را به اشتراک بگذارید.