# 离线参考实验

在学习包根目录执行：

```bash
python3 -m unittest discover -s labs -p 'test_*.py' -v
python3 labs/tool_loop.py
python3 labs/durable_ticket.py
python3 labs/eval_runner.py --self-check
```

仅依赖 Python 标准库，无需安装包或配置密钥。测试会在临时目录创建 SQLite 数据库，结束后清理；不会访问真实订单或外部系统。

## 代码边界

- `tool_loop.py`：预设动作模拟模型，展示只读工具、参数校验、身份上下文与循环上限。没有自然语言推理、真正认证、网络超时或生产监控。
- `durable_ticket.py`：在同一个 SQLite 数据库里展示草稿、审批、取消、事务、重复提交和结果恢复。没有外部工单系统，不能证明跨系统 exactly-once；没有完整 HTTP 授权、审批有效期和审计平台。
- `eval_runner.py`：评分器读取你自己的项目适配器输出，仅核对指定规则。不会执行 40 条业务案例，不会生成模型答案或语义评分。
- `test_reference.py`、`test_eval.py`：26 项测试，覆盖选定工程不变量。它们是学习起点，不是生产验证全集。

扩展主项目时保留这些边界，编写自己的接口、真实模型适配器、持久化编排、知识检索与案例运行器。官方 API 示例按所安装的版本使用。