# TOOLS.md — 套件使用工具

## 市场前端

https://suites.mercator.cn

浏览套件、查看详情。

## CLI 安装（gis-actions 本地执行器）

所有套件在你的机器上通过 Docker 本地执行，数据不上云。

安装 gis-actions 包即可获得 CLI + worker：

```bash
# 下载
curl -OJ https://git.mercator.cn/api/packages/SuiteHub/generic/gis-actions/2.0.14/gis-actions_2.0.14_all.deb

# 安装
sudo dpkg -i gis-actions_2.0.14_all.deb

# 登录 Docker Registry（拉取 gis-base 镜像）
docker login registry.mercator.cn
```

## 前提条件

- Linux 系统（Debian / Ubuntu）
- Docker（验证：`docker ps`）
- 能访问 `registry.mercator.cn`

## 执行套件

```bash
SUITE_MARKET_URL="https://suites.mercator.cn" \
python3 /usr/share/gis-actions/cli.py run /tmp/work-output \
  --suite-id <suite-id> \
  --input bid_xls=/path/to/bid.xls \
  --input points_shp=/path/to/points.shp
```

- `<suite-id>` 从 Suite Market 界面获取
- 输入文件路径用本地绝对路径，shapefile 只需传 .shp 路径，配套文件自动复制
- 支持 `--input key=value` 多参数传递

## 数据流向

```
你本地的 SHP/XLS 文件
    │
    ▼
cli.py（你的机器）
    │  ← 从市场下载套件脚本包
    │  ← 复制输入文件到工作目录
    │  → docker run gis-base + 套件脚本
    │  → 结果写入 /tmp/output/
    ▼
结果文件（你的机器）
```

## 系统服务管理

```bash
# 查看状态
sudo systemctl status gis-actions

# 查看日志
journalctl -u gis-actions -f

# 停止
sudo systemctl stop gis-actions
```

## 快速上手（使用测试文件）

```bash
SUITE_MARKET_URL="https://suites.mercator.cn" \
python3 /usr/share/gis-actions/cli.py run /tmp/my-output \
  --suite-id 2c99a1cb-84a5-42dd-9147-1c8e8f7f2941 \
  --input bid_xls=/path/to/标段清单.xls \
  --input points_shp=/path/to/点状工程.shp \
  --input lines_shp=/path/to/线性工程.shp \
  --input polygons_shp=/path/to/面状工程.shp
```

## 注意事项

1. 先安装 gis-actions（含 cli.py）
2. `docker login registry.mercator.cn` 确保能拉镜像
3. 从 Suite Market 获取 suite id
4. 执行：`python3 /usr/share/gis-actions/cli.py run ... --input key=value`