diff --git a/suite-developer/TOOLS.md b/suite-developer/TOOLS.md new file mode 100644 index 0000000..2b4fe63 --- /dev/null +++ b/suite-developer/TOOLS.md @@ -0,0 +1,72 @@ +# TOOLS.md — 套件开发工具与资源 + +## 安装 CLI + +```bash +pip install agentgis-cli +``` + +(当前可从 Git 仓库安装,未来上 PyPI 后一行命令即可) + +## 配置 + +```bash +agc config set api-key mk_xxxxxxxxxxxxx +``` + +API Key 从 [auth.mercator.cn](https://auth.mercator.cn) 获取。 + +## 日常命令 + +```bash +# 初始化新套件 +agc init ./my-analysis + +# 发布套件(自动处理打包→上传→注册) +agc publish ./my-analysis + +# 测试执行 +agc run --inputs '{"expression": "1+1"}' + +# 查看市场上已有的技能和套件 +agc skills list +agc suites list +``` + +## API 端点(直接调用时) + +| 用途 | 端点 | +|------|------| +| 注册 Skill | `POST https://suites.mercator.cn/api/v1/skills` | +| 注册 Suite | `POST https://suites.mercator.cn/api/v1/suites` | +| 提交执行 | `POST https://suites.mercator.cn/api/v1/task` | +| API 文档 | `https://suites.mercator.cn/docs` | + +## 套件结构 + +``` +my-suite/ +├── workflow.yaml # 步骤定义(核心) +└── scripts/ + └── run.py # 执行入口 +``` + +## 基础镜像 + +所有套件在 `registry.mercator.cn/agentgis/gis-base:latest` 中执行。 +包含:Python 3, GDAL, Shapely, GeoPandas, numpy + +## 参考示例 + +- `SuiteHub/hello-world-suite` — 最小模板(查看代码了解 workflow.yaml 写法) +- `SuiteHub/math-add` — 算术相加示例 +- `SuiteHub/buffer-analysis` — GIS 缓冲区分析 + +## 文档 + +所有文档在 AgentGIS/docs 仓库的 `03-workflow/` 目录: +- `workflow-spec.md` — workflow.yaml 完整规范 +- `script-dev-guide.md` — 脚本开发指南 +- `skill-dev-guide.md` — 技能开发指南 +- `suite-dev-guide.md` — 套件开发指南 +- `suite-publishing-guide.md` — 发布指南