XIII.安装手册 · v0.19

Codex / Claude Code · Windows / macOS / Linux

一句提示，让代理安装 STOLZ。

将提示复制到 Codex 或 Claude Code。同一请求适用于 Windows、macOS 和 Linux。

Codex / Claude Code

请从 https://github.com/Sergey360/stolz-ai/releases/latest 为你自己安装所有 STOLZ A.I. 技能及其参考文件。验证归档的 SHA-256，使用用户级技能目录，保留现有技能并验证安装结果。

将这句话粘贴到代理聊天中。代理可以为你的系统下载并安装技能。

安装后打开新的代理会话。

手动安装与团队配置

1. 验证存档

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

SHA-256cdde8bad689c9247c7b1ab406f193f876ebb4f8e8694d0dff94055b4529d501a

下载软件包查看标签源码

2. 安装到使用项目

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

terminal / npm

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

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

4. 运行 doctor

Doctor 不调用提供商或模型。它报告安装状态、检测到的运行时版本、兼容性依据、惰性适配器可用性和下一步。

terminal / doctor

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

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

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

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

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

可选：单独安装 stolz-browser

复制完整 browser 目录及两个参考文件，无需个人恢复技能或相邻适配器。

terminal / optional skill

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

用于受控标签页及恢复决策。保留指定浏览器与必要界面检查；安装指导不会提供浏览器工具，也不证明能够防止崩溃。

可选：单独安装 stolz-evidence

复制完整 evidence 目录及参考文件。配置管理五项优化技能，可选技能需单独更新或删除。

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

可选：单独安装 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 包还提供离线 stolz-mcp CLI 和 stolz-ai/mcp-code API。

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

这些检查证明什么

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

真实项目后续

状态仍为 `followup_gap`：尚未记录具名真实试点负责人，也没有 28 天真实证据窗口。

返回 v0.19 版本