XIII.Книга установки · v0.19

Codex / Claude Code · Windows / macOS / Linux

Одна строка. Агент установит STOLZ.

Скопируйте запрос в Codex или Claude Code. Он подходит для Windows, macOS и Linux.

Codex / Claude Code
Установи себе навыки STOLZ A.I. со справочниками из https://github.com/Sergey360/stolz-ai/releases/latest: проверь SHA-256 архива, используй свой пользовательский каталог навыков, сохрани существующие навыки и проверь установку.

Вставьте эту строку в чат агента. Он сможет сам скачать и установить навыки для вашей системы.

После установки откройте новую сессию агента.

Ручная установка и настройка для команды
02

2. Установите пакет в свой проект

Подключите скачанный архив как dev-зависимость. После этого CLI работает без загрузки другого пакета.

terminal / npm
npm install --save-dev /absolute/downloads/stolz-ai-0.19.0.tgz
03

3. Выберите профиль, просмотрите план и установите

Выберите профиль Codex, изучите детерминированный план установки и добавьте `--apply` только после проверки каталога и принадлежащих STOLZ файлов.

terminal / profile
npx --no-install stolz-profile resolve --runtime codex
npx --no-install stolz-profile install --runtime codex --destination /absolute/path/to/skills --dry-run
npx --no-install stolz-profile install --apply --runtime codex --destination /absolute/path/to/skills
04

4. Запустите doctor

Doctor не обращается к провайдеру или модели. Он показывает состояние установки, найденную версию среды, основание совместимости, доступность ленивого адаптера и следующее действие.

terminal / doctor
npx --no-install stolz-profile doctor --runtime codex --runtime-version <version> --destination /absolute/path/to/skills
05

5. Зафиксируйте командный lock и проверяйте его в CI

Lock хранит идентичность пакета и профиля, но не секреты и локальные пути. `verify-lock` завершится с ошибкой при расхождении, повреждённом lock или несовместимой заявленной версии среды.

terminal / team lock
npx --no-install stolz-profile lock --apply --runtime codex --lockfile ./stolz-profile.lock.json
npx --no-install stolz-profile verify-lock --runtime codex --lockfile ./stolz-profile.lock.json
06

6. Просмотрите обновление до применения

Первая команда показывает будущие изменения. Применяйте их после проверки; отсутствие или локальное изменение файла STOLZ останавливает обновление. Обновление v0.18.0 → v0.19.0, восстановление, конфликт и откат прошли проверку пакета.

terminal / update
npx --no-install stolz-profile update --runtime codex --destination /absolute/path/to/skills
npx --no-install stolz-profile update --apply --runtime codex --destination /absolute/path/to/skills
07

7. Восстановитесь после прерванного обновления

Если doctor сообщает `recovery_required`, сначала просмотрите восстановление. Затем `--apply` вернёт проверенную предыдущую установку из журнала транзакции.

terminal / recover
npx --no-install stolz-profile recover --dry-run --destination /absolute/path/to/skills
npx --no-install stolz-profile recover --apply --destination /absolute/path/to/skills
08

8. Откатывайтесь по тому же правилу

Сначала просмотрите откат. Команда не перезапишет локально изменённый файл, принадлежащий STOLZ.

terminal / rollback
npx --no-install stolz-profile rollback --dry-run --destination /absolute/path/to/skills
npx --no-install stolz-profile rollback --apply --destination /absolute/path/to/skills
+

По желанию: установите stolz-browser отдельно

Скопируйте каталог browser целиком с двумя справочниками. Личный навык восстановления или соседний адаптер не требуются.

terminal / optional skill
mkdir -p .agents/skills
cp -R node_modules/stolz-ai/skills/stolz-browser .agents/skills/

Навык нужен для управляемых вкладок и решений о восстановлении. Он сохраняет выбранный браузер и необходимые проверки интерфейса. Установка инструкций не предоставляет браузерные инструменты и не подтверждает предотвращение падений.

+

По желанию: установите stolz-evidence отдельно

Скопируйте папку evidence целиком вместе с references. Профили управляют пятью навыками оптимизации; необязательный навык обновляется и удаляется отдельно.

terminal / optional skill
mkdir -p .agents/skills
cp -R node_modules/stolz-ai/skills/stolz-evidence .agents/skills/

Для короткого проектного правила сначала изучите предварительный просмотр, затем добавьте --apply. Выберите codex, claude-code или qwen-code и существующий каталог проекта по абсолютному пути. Проверьте действующие инструкции в своей среде: запись файла сама по себе не подтверждает их загрузку.

terminal / project rule dry run
node node_modules/stolz-ai/tools/evidence-instructions.mjs --project-root /absolute/project --runtime codex
09

По желанию: установите stolz-guard отдельно

Профили устанавливают пять навыков оптимизации. Для проверки безопасности инструкций скопируйте папку guard целиком вместе с references. Выполните команду один раз для нового каталога.

terminal / optional skill
mkdir -p .agents/skills
cp -R node_modules/stolz-ai/skills/stolz-guard .agents/skills/

Профильные lock, status, update и uninstall управляют только своими файлами. Отдельную установку guard проверяйте и обновляйте вручную. Права доступа к инструментам контролирует среда запуска.

+

По желанию: установите stolz-mcp отдельно

Скопируйте каталог MCP целиком с двумя справочниками. Пакет Node также содержит локальный CLI stolz-mcp и API stolz-ai/mcp-code.

terminal / optional skill
mkdir -p .agents/skills
cp -R node_modules/stolz-ai/skills/stolz-mcp .agents/skills/
npx --no-install stolz-mcp --help

Настройки MCP не меняются. Среда предоставляет подключение и авторизованное выполнение; запуск кода не создаёт песочницу и не обходит проверку полномочий.

§ 3scope / evidence

Что подтверждают эти проверки

Они подтверждают идентичность пакета, выбранную конфигурацию и файлы из манифеста. Они не доказывают совместимость модели, токены провайдера, биллинг, стоимость или экономию.

09

Следующий шаг — реальный проект

Статус остаётся `followup_gap`: ответственный за пилот и данные за 28 дней реальной работы пока не зафиксированы.

Вернуться к релизу v0.19