Instalacja

Szybka instalacja (Linux / macOS)

curl -fsSL https://peria.ai/install.sh | bash

To pobiera najnowszy plik binarny wydania dla Twojej platformy, weryfikuje sumę kontrolną SHA256 i umieszcza go w ~/.local/bin/.

Po instalacji zainicjalizuj PRECC:

precc init

precc init rejestruje hook PreToolUse w Claude Code, tworzy katalogi danych i inicjalizuje bazę umiejętności.

Opcje instalacji

Weryfikacja SHA256

Domyślnie instalator weryfikuje sumę kontrolną pliku binarnego względem opublikowanej sumy SHA256. Aby pominąć weryfikację (niezalecane):

curl -fsSL https://peria.ai/install.sh | bash -s -- --no-verify

Niestandardowy prefiks instalacji

Zainstaluj w niestandardowej lokalizacji:

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.

Narzędzia towarzyszące (–extras)

PRECC jest dostarczany z opcjonalnymi narzędziami towarzyszącymi. Zainstaluj je z --extras:

curl -fsSL https://peria.ai/install.sh | bash -s -- --extras

To instaluje:

Windows (PowerShell)

irm https://peria.ai/install.ps1 | iex

Następnie zainicjalizuj:

precc init

Instalacja ręczna

1. Pobierz binarny plik wydania dla swojej platformy z GitHub Releases.
2. Zweryfikuj sumę kontrolną SHA256 względem pliku .sha256 w wydaniu.
3. Umieść plik binarny w katalogu w swoim PATH (np. ~/.local/bin/).
4. Uruchom precc init.

Aktualizacja

precc update

Wymuś aktualizację do konkretnej wersji:

precc update --force --version 0.3.0

Włącz automatyczne aktualizacje:

precc update --auto

Instalacja w OpenClaw / ClawHub

PRECC dostarcza manifest wtyczki w plugins/openclaw/openclaw.plugin.json (id precc-token-saver). Po opublikowaniu wydania publicznego przepływ GitHub Actions clawhub-publish.yml wysyła pakiet umiejętności do rejestru ClawHub, dzięki czemu użytkownicy końcowi mogą zainstalować PRECC przez CLI ClawHub zamiast przez instalator 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.

Jak oszczędności są prezentowane w OpenClaw

Każda powierzchnia raportowania PRECC, która działa w Claude Code, działa również w OpenClaw — precc savings, precc savings --all, zlokalizowany wiersz statusu (ustaw PRECC_LANG=zh, a wiersz wyświetli się w twoim języku) oraz lokalny dziennik audytu przepisań — wszystkie czytają z tych samych baz danych SQLCipher na twoim komputerze. Osobna specyfikacja w docs/symposium-plan/openclaw-savings-reporting.md opisuje przyszłe ustrukturyzowane pole preccSavings w każdej odpowiedzi hooka oraz jednowierszowe powiadomienie o końcu sesji przy domyślnym progu $0.05; ta część nie jest jeszcze dostarczona.

Weryfikacja instalacji

$ precc --version
precc 0.3.0

$ precc savings
Session savings: 0 tokens (no commands intercepted yet)

Jeśli precc nie został znaleziony, upewnij się, że ~/.local/bin jest w Twoim PATH.