التثبيت
التثبيت السريع (Linux / macOS)
curl -fsSL https://peria.ai/install.sh | bash
يقوم هذا بتنزيل أحدث إصدار ثنائي لمنصتك، والتحقق من المجموع الاختباري SHA256، ووضعه في ~/.local/bin/.
بعد التثبيت، قم بتهيئة PRECC:
precc init
يقوم precc init بتسجيل خطاف PreToolUse مع Claude Code، وإنشاء أدلة البيانات، وتهيئة قاعدة بيانات المهارات.
خيارات التثبيت
التحقق من SHA256
بشكل افتراضي، يتحقق المثبت من المجموع الاختباري للملف الثنائي مقابل مجموع SHA256 المنشور. لتخطي التحقق (غير مستحسن):
curl -fsSL https://peria.ai/install.sh | bash -s -- --no-verify
بادئة تثبيت مخصصة
التثبيت في موقع مخصص:
curl -fsSL https://peria.ai/install.sh | bash -s -- --prefix /opt/precc
OpenCLI (–opencli) — WebFetch token savings
PRECC can also install OpenCLI, a third-party Node.js tool that turns ~148 websites (HackerNews, Reddit, arxiv, bilibili, zhihu, x.com, …) into structured-output commands. When installed, PRECC’s two built-in webfetch-opencli-* skills auto-rewrite raw curl/wget calls into the corresponding opencli <site> command for 5–50× smaller output.
precc init --opencli
This runs npm install -g @jackwener/opencli (requires Node.js 20+) and prints the URL for OpenCLI’s optional Chrome extension. The extension is only needed to reuse logged-in cookies on private pages; public sources work without it.
Skipping --opencli keeps PRECC fully self-contained — the auto-rewrite skill inlines a command -v opencli check that falls back to the original command when OpenCLI isn’t installed, so the skill is safe to ship default-on.
The Chrome extension requests broad permissions (debugger, <all_urls>, cookies). Operators should review them before installing it; --opencli only handles the npm package, not the extension.
أدوات مصاحبة (–extras)
يأتي PRECC مع أدوات مصاحبة اختيارية. قم بتثبيتها باستخدام --extras:
curl -fsSL https://peria.ai/install.sh | bash -s -- --extras
هذا يثبت:
| أداة | الغرض |
|---|---|
| RTK | مجموعة أدوات إعادة كتابة الأوامر |
| lean-ctx | ضغط السياق لملفات CLAUDE.md والتعليمات |
| nushell | صدفة منظمة لخطوط الأنابيب المتقدمة |
| cocoindex-code | فهرسة الكود لحل السياق بشكل أسرع |
Windows (PowerShell)
irm https://peria.ai/install.ps1 | iex
ثم قم بالتهيئة:
precc init
التثبيت اليدوي
- قم بتنزيل الملف الثنائي لمنصتك من GitHub Releases.
- تحقق من المجموع الاختباري SHA256 مقابل ملف
.sha256في الإصدار. - ضع الملف الثنائي في دليل ضمن
PATHالخاص بك (مثل~/.local/bin/). - قم بتشغيل
precc init.
التحديث
precc update
فرض التحديث إلى إصدار محدد:
precc update --force --version 0.3.0
تمكين التحديثات التلقائية:
precc update --auto
التثبيت ضمن OpenClaw / ClawHub
يتضمن PRECC بيان مكوّن إضافي في plugins/openclaw/openclaw.plugin.json (المعرّف precc-token-saver). عند نشر إصدار عام، يقوم سير عمل GitHub Actions باسم clawhub-publish.yml بدفع حزمة المهارات إلى سجل ClawHub، بحيث يمكن للمستخدمين النهائيين تثبيت PRECC عبر واجهة سطر أوامر ClawHub بدلاً من مثبّت curl:
# ClawHub CLI
clawhub install precc
# Or pin the plugin manifest (id: precc-token-saver) via OpenClaw's
# plugin marketplace UI or its CLI equivalent.
كيف تظهر التوفيرات ضمن OpenClaw
كل واجهة تقارير في PRECC تعمل تحت Claude Code تعمل أيضًا تحت OpenClaw — precc savings وprecc savings --all وسطر الحالة المُعرَّب (اضبط PRECC_LANG=zh فيظهر السطر بلغتك) وسجل تدقيق إعادة الكتابة المحلي، كلها تقرأ من نفس قواعد بيانات SQLCipher على جهازك. توجد مواصفة منفصلة في docs/symposium-plan/openclaw-savings-reporting.md تصف حقلًا مستقبليًا منظمًا preccSavings في كل استجابة خطاف، إضافة إلى إشعار من سطر واحد عند انتهاء الجلسة عند عتبة افتراضية $0.05؛ هذا الجزء لم يُشحن بعد.
التحقق من التثبيت
$ precc --version
precc 0.3.0
$ precc savings
Session savings: 0 tokens (no commands intercepted yet)
إذا لم يتم العثور على precc، تأكد من أن ~/.local/bin موجود في PATH الخاص بك.