feat: 添加 suite-user/TOOLS.md

2026-07-09 07:39:52 +00:00
parent 005a459f76
commit a599a7c112
1 changed files with 69 additions and 0 deletions
@@ -0,0 +1,69 @@
+# TOOLS.md — 套件使用工具
+
+## 市场前端
+
+https://suites.mercator.cn
+
+浏览套件、查看详情、提交执行任务。
+
+## CLI（可选）
+
+```bash
+# 安装
+pip install agentgis-cli
+
+# 配置 API Key
+agc config set api-key mk_xxxxxxxxx
+
+# 执行套件（在市场找到 suite-id 后）
+agc run <suite-id> --inputs '{"input_path": "/data/myfile.shp"}'
+
+# 查看技能列表
+agc skills list
+
+# 查看套件列表
+agc suites list
+
+# 查看执行状态
+agc status <task-id>
+```
+
+## Worker
+
+Worker 运行在你的机器上，是套件的执行引擎。
+
+### 安装前提
+
+- Python 3
+- Docker
+
+### 启动
+
+```bash
+python3 worker.py --config worker.json
+```
+
+Worker 启动后自动连接调度中心，等待执行任务。
+
+### 数据流向
+
+```
+你本地的 SHP/GeoJSON/TIFF 文件
+    │
+    ▼
+Worker（你的机器）
+    │  docker run gis-base
+    │  套件脚本处理文件
+    ▼
+结果文件（你的机器 /tmp/output/）
+```
+
+## 支持的输入类型
+
+| 类型 | 说明 | 示例 |
+|------|------|------|
+| `file` | 本地文件路径 | `/data/land_use.shp` |
+| `string` | 文本 | `"缓冲区距离: 500"` |
+| `number` | 数值 | `500.0` |
+| `integer` | 整数 | `100` |
+| `boolean` | 布尔值 | `true` |