# 执行套件与查看结果

## 执行套件

使用 `agc run` 命令在本地执行套件：

```bash
SUITE_MARKET_URL="https://suites.mercator.cn" \
agc run <work_dir> \
  --suite-id 2c99a1cb-84a5-42dd-9147-1c8e8f7f2941 \
  --input bid_xls=/path/to/标段清单.xls \
  --input points_shp=/path/to/点状工程.shp
```

参数说明：
- `--suite-id`：套件 ID，从市场获取
- `--input`：输入参数，每个参数一个 `--input`，文件路径用本地绝对路径

## 执行流程

```
agc run 执行
  │
  ├── 从市场查询套件的脚本包地址
  ├── 下载脚本包到本地
  ├── 复制输入文件到工作目录
  │
  ├── Step 1: docker run gis-base 执行脚本（Linux）
  ├── Step 2: 本地 subprocess 执行（Windows）
  │
  └── 结果写入 /tmp/output/
```

## 查看结果

- **控制台输出**：执行过程实时打印，每个步骤的状态、产出一目了然
- **结果文件**：在工作目录（如 `/tmp/my-output/`）的 `_step_outputs/` 下

## 错误处理

如果执行失败：

1. 查看控制台错误信息
2. 检查输入文件路径是否正确
3. 确认执行环境（Linux: `docker ps`, Windows: `agc --help`）
4. 确认 gis-actions 版本（`dpkg -l gis-actions`）

## 数据安全

**数据永不离开本地。** 输入文件始终在你的机器上，在本地处理（Linux Docker 或 Windows 本机），不上传到云端。