# 本地安装与无模型检查

当前候选代码为 **0.3.1**，Python ≥3.9，运行期仅使用标准库。以下命令从候选包根目录执行，适用于 macOS/Linux shell。Windows 的脚本目录为 `.venv/Scripts/`，本候选未验证 Windows。

代码采用 Apache-2.0，原创合成题库与文档采用 CC BY 4.0，详见 [许可范围](../../LICENSE_SCOPE.md)。以下为本地安装步骤；在线静态展示不会执行这些命令。

## 离线安装当前代码

```sh
python3 -m venv .venv
.venv/bin/python -m pip install --no-index --no-deps ./artifacts/loyaltyops_bench-0.3.1-py3-none-any.whl
.venv/bin/loyaltyops-bench --version
.venv/bin/loyaltyops-bench --task draft_for_approval --agent reference --output ./results/draft-new
.venv/bin/loyaltyops-bench --task execute_approved --agent reference --output ./results/execute-new
```

使用新的结果目录以保留此前记录。这两个 reference 主流程是合成脚本工程检查，实际模型调用为 0；脚本通过不等于真实模型通过。

```sh
.venv/bin/loyaltyops-bench --task draft_for_approval --describe-task
.venv/bin/loyaltyops-model --config ./examples/deepseek.json --task draft_for_approval
.venv/bin/python -m loyaltyops_bench.model_cli --config ./examples/ollama.json --task execute_approved
```

模型入口默认 dry-run：不读取真实凭据、不请求 API、不启动模型。候选审阅无需提供 Key，也不要增加 `--execute`。模型运行、API 渠道及费用控制须另行安排；金额参数只记录授权，尚无金额硬限额。

任务输入仅使用公开 spec 与工具结果。不要把评分器、脚本参考实现、完整源码、维护者状态或结果集加入 Agent 会话。

## 从源码离线构建

要求构建环境已具有 pip、setuptools ≥58、wheel；不自动下载依赖：

```sh
python3 -m pip wheel --no-index --no-deps --no-build-isolation --wheel-dir ./dist .
```

若缺少构建工具，应停止并准备本地构建环境，不能把失败称为安装通过。发行包的运行期无第三方依赖。

## 历史 0.3.0

历史 wheel 仅用于复现绑定 **0.3.0** 的实验，应安装在另外的环境，不能覆盖上述环境后继续称为 0.3.1：

```sh
python3 -m venv .venv-history
.venv-history/bin/python -m pip install --no-index --no-deps ./artifacts/loyaltyops_bench-0.3.0-py3-none-any.whl
.venv-history/bin/loyaltyops-bench --version
```

本批只整理已完成且已审阅的历史模型记录，没有重跑模型。历史文件中的文档长描述可能来自更早的说明；wheel 内发行元数据与源码版本为 0.3.0，清单保存原始字节摘要。

生成的原始 JSON/Markdown 报告及命令输出可能包含本地绝对路径，请保留在维护者环境；对外候选仅采用经过审阅的相对路径摘录。本地安装检查不证明多平台兼容、长任务稳定性或生产安全。