نصب
نصب سریع (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 و فایلهای prompt |
| 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 را بهجای نصبکننده curl از طریق CLI ClawHub نصب کنند:
# 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 شما قرار دارد.