Cài đặt

Cài đặt nhanh (Linux / macOS)

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

Lệnh này tải xuống bản phát hành mới nhất cho nền tảng của bạn, xác minh mã SHA256 và đặt vào ~/.local/bin/.

Sau khi cài đặt, khởi tạo PRECC:

precc init

precc init đăng ký hook PreToolUse với Claude Code, tạo các thư mục dữ liệu và khởi tạo cơ sở dữ liệu kỹ năng.

Tùy chọn cài đặt

Xác minh SHA256

Mặc định, trình cài đặt xác minh mã checksum của tệp nhị phân với SHA256 đã công bố. Để bỏ qua xác minh (không khuyến nghị):

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

Tiền tố cài đặt tùy chỉnh

Cài đặt vào vị trí tùy chỉnh:

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.

Công cụ đi kèm (–extras)

PRECC đi kèm với các công cụ tùy chọn. Cài đặt chúng với --extras:

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

Lệnh này cài đặt:

Windows (PowerShell)

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

Sau đó khởi tạo:

precc init

Cài đặt thủ công

1. Tải xuống tệp nhị phân cho nền tảng của bạn từ GitHub Releases.
2. Xác minh mã SHA256 với tệp .sha256 trong bản phát hành.
3. Đặt tệp nhị phân vào thư mục trong PATH của bạn (ví dụ: ~/.local/bin/).
4. Chạy precc init.

Cập nhật

precc update

Buộc cập nhật lên phiên bản cụ thể:

precc update --force --version 0.3.0

Bật cập nhật tự động:

precc update --auto

Cài đặt trên OpenClaw / ClawHub

PRECC đi kèm một manifest plugin tại plugins/openclaw/openclaw.plugin.json (id precc-token-saver). Khi một bản phát hành công khai được công bố, quy trình GitHub Actions clawhub-publish.yml sẽ đẩy gói skill lên registry của ClawHub, để người dùng cuối có thể cài đặt PRECC qua CLI của ClawHub thay vì qua trình cài đặt 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.

Cách hiển thị mức tiết kiệm trên OpenClaw

Mọi giao diện báo cáo của PRECC hoạt động trên Claude Code đều hoạt động trên OpenClaw — precc savings, precc savings --all, dòng trạng thái được bản địa hóa (đặt PRECC_LANG=zh và dòng này hiển thị theo ngôn ngữ của bạn), và nhật ký kiểm tra ghi đè cục bộ đều đọc từ cùng các cơ sở dữ liệu SQLCipher trên máy của bạn. Một đặc tả riêng tại docs/symposium-plan/openclaw-savings-reporting.md mô tả một trường có cấu trúc preccSavings trong tương lai trong mỗi phản hồi hook cộng với một thông báo kết thúc phiên một dòng tại ngưỡng mặc định $0.05; phần đó vẫn chưa được phát hành.

Xác minh cài đặt

$ precc --version
precc 0.3.0

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

Nếu không tìm thấy precc, hãy đảm bảo ~/.local/bin nằm trong PATH của bạn.