# 智货 T1 本地 CLI

此包提供 SmartPacker T1 单规格纸箱装柜算法的 Windows 本地命令行验证工具。

公开 MCP 服务保持 depth 2，用于保证在线请求速度。本地 CLI 可以在用户自己的
电脑上运行 depth 3，用于复现更强的 benchmark 结果，而不会增加公开 MCP 服务器
负载。

## 文件

- `PackCli.exe`：T1 本地命令行程序。
- `container_loading_benchmark_generator.py`：公开报告使用的 10,000 组可复现
  benchmark 生成器。
- `BUILDINFO.json`：程序输出的构建信息。
- `samples/count_sample.txt`：计数样例。
- `samples/layout_sample.txt`：排布 JSON 样例输入。
- `run_count_sample.cmd`：运行计数样例。
- `run_depth3_layout_sample.cmd`：用 `T1_DEPTH=3` 运行排布样例并输出 JSON。

## 快速验证

在此目录打开 Windows 命令行：

```cmd
run_count_sample.cmd
```

期望计数输出：

```text
720 820 876 886
144 157 166 166
14400 14550 14820 14855
```

四列分别是直接装载、depth 1、depth 2、depth 3 的计数结果。

## 复现 Benchmark

benchmark 生成器需要 Python 3：

```cmd
python container_loading_benchmark_generator.py --out-dir benchmark_out --packcli PackCli.exe
```

`benchmark_out` 中生成的 CSV 和 summary JSON 可与 T1 benchmark 页面发布的数据
对照。

快速烟测可使用 `--cases 10`。样例数必须能被 10 个 benchmark 分层整除。

## Depth 3 排布 JSON

生成无悬空的实际排布方案：

```cmd
run_depth3_layout_sample.cmd
```

脚本会写出 `samples\layout_depth3_sample.json`。公开 MCP 服务使用同样的 JSON
结构，但公开服务默认运行 depth 2。
