agent-profiles/suite-user/TOOLS.md

TOOLS.md — 套件使用工具

市场前端

https://suites.mercator.cn

浏览套件、查看详情。

CLI 安装

# 安装 agentgis-cli v0.2.0
pip install https://git.mercator.cn/api/packages/SuiteHub/generic/agentgis-cli/0.2.0/agentgis_cli-0.2.0.tar.gz

# 配置 API Key
agc config set api-key mk_xxxxxxxxx

# 查看套件列表
agc suites list

本地执行环境

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

前提条件

• Linux 系统（Debian / Ubuntu）
• Docker（验证：docker ps）
  • sudo apt install docker.io
• 能访问 registry.mercator.cn（拉取 gis-base 镜像）

安装本地执行器

# 安装 worker
wget -O agentgis-worker.deb https://git.mercator.cn/api/packages/SuiteHub/generic/gis-actions/v2.0.0-alpha/agentgis-worker_2.0.0-alpha_all.deb
sudo dpkg -i agentgis-worker.deb

# 配置 Docker Registry 认证
echo "agw_readonly_2026" | docker login registry.mercator.cn -u agentgis-worker --password-stdin

# 启动 worker
sudo systemctl start agentgis-worker

执行套件

agc run <suite-id> --inputs '{"input_path": "/data/myfile.shp"}' --wait --poll 5

• <suite-id> 从 agc suites list 获取
• 输入文件路径用你的本地绝对路径
• --wait 等待执行完成，--poll 5 每 5 秒轮询结果

数据流向

你本地的 SHP/GeoJSON/TIFF/XLS 文件
    │
    ▼
worker（你的机器）
    │  ← 从市场下载套件脚本包
    │  ← docker run gis-base + 套件脚本
    │  → 结果写入 /tmp/output/
    ▼
结果文件（你的机器）

系统服务管理

# 查看状态
sudo systemctl status agentgis-worker

# 查看日志
journalctl -u agentgis-worker -f

# 停止
sudo systemctl stop agentgis-worker

# 卸载
sudo dpkg --purge agentgis-worker

已知限制

问题	说明
输入文件挂载	worker 暂未自动将输入文件挂载到容器内，需等待 Issue #6 修复
基础镜像缺包	gis-base 暂缺 openpyxl/xlrd，Excel 套件运行时会自动 pip install

详见 #6