Установка

Быстрая установка (Linux / macOS)

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

Скачивает последний бинарный файл релиза для вашей платформы, проверяет контрольную сумму SHA256 и помещает в ~/.local/bin/.

После установки инициализируйте PRECC:

precc init

precc init регистрирует PreToolUse hook в 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

Это устанавливает:

Windows (PowerShell)

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

Затем инициализируйте:

precc init

Ручная установка

1. Скачайте бинарный файл релиза для вашей платформы с GitHub Releases.
2. Проверьте контрольную сумму SHA256 по файлу .sha256 в релизе.
3. Поместите бинарный файл в директорию из вашего PATH (например, ~/.local/bin/).
4. Выполните precc init.

Обновление

precc update

Принудительное обновление до определённой версии:

precc update --force --version 0.3.0

Включите автоматические обновления:

precc update --auto

Установка в OpenClaw / ClawHub

PRECC поставляется с манифестом плагина в plugins/openclaw/openclaw.plugin.json (id precc-token-saver). При публикации публичного релиза рабочий процесс GitHub Actions clawhub-publish.yml отправляет пакет навыков в реестр ClawHub, поэтому конечные пользователи могут устанавливать PRECC через CLI 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.