XI.安装手册 · v0.13

验证存档 / 预览每次写入 / 保留回滚路径

清楚每一步,再安装 STOLZ A.I.。

在使用项目中安装不可变的 v0.13 软件包,并让每次生命周期变更都从只读检查开始。

01

1. 验证存档

下载软件包,并在安装前核对 SHA-256。规范存档包含 191 个文件。

SHA-25605645ff2d899dee7a8c3231c04e069a11f7e6bccb044509f9d39e58f1b34c82c
02

2. 安装到使用项目

将下载的存档安装为开发依赖。之后 CLI 不会再获取另一个软件包。

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

3. 解析、预览并安装配置

解析 Codex 配置,审阅确定性的安装计划;确认目标目录和 STOLZ 所有文件后,再加入 `--apply`。

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. 提交团队锁并在 CI 中验证

锁文件包含软件包和配置身份,不含凭据或本地路径。发生偏移、锁无效或上报的运行时版本不兼容时,`verify-lock` 会让 CI 失败。

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 所有文件缺失或被本地修改时,更新会停止。

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. 以同样方式回滚

先预览回滚。回滚拒绝覆盖本地修改过的受管文件。

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

§ 3scope / evidence

这些检查证明什么

它们证明软件包身份、所选配置和清单内文件,不证明模型兼容性、提供商令牌、计费、成本或节省。

09

真实项目后续

目前尚无真实试点负责人。只有在项目负责人同意后,才使用包内试点日志。

返回 v0.13 版本