fix: 清除 suite-developer 文件中的平台内部引用

This commit is contained in:
2026-07-09 07:43:50 +00:00
parent 51b303bbff
commit 46b5b15d79
+14 -30
View File
@@ -1,34 +1,23 @@
# TOOLS.md — 套件开发工具与资源 # TOOLS.md — 套件开发工具与资源
## 安装 CLI ## CLI
```bash ```bash
pip install agentgis-cli pip install agentgis-cli
```
(当前可从 Git 仓库安装,未来上 PyPI 后一行命令即可) # 配置
agc config set api-key mk_xxxxxxxxxxx
## 配置
```bash
agc config set api-key mk_xxxxxxxxxxxxx
```
API Key 从 [auth.mercator.cn](https://auth.mercator.cn) 获取。
## 日常命令
```bash
# 初始化新套件 # 初始化新套件
agc init ./my-analysis agc init ./my-analysis
# 发布套件(自动处理打包→上传→注册) # 发布到市场
agc publish ./my-analysis agc publish ./my-analysis
# 测试执行 # 测试执行
agc run <skill-id> --inputs '{"expression": "1+1"}' agc run <skill-id> --inputs '{"expression": "1+1"}'
# 查看市场上已有的技能套件 # 查看市场上已有的技能/套件
agc skills list agc skills list
agc suites list agc suites list
``` ```
@@ -39,34 +28,29 @@ agc suites list
|------|------| |------|------|
| 注册 Skill | `POST https://suites.mercator.cn/api/v1/skills` | | 注册 Skill | `POST https://suites.mercator.cn/api/v1/skills` |
| 注册 Suite | `POST https://suites.mercator.cn/api/v1/suites` | | 注册 Suite | `POST https://suites.mercator.cn/api/v1/suites` |
| 提交执行 | `POST https://suites.mercator.cn/api/v1/task` | | 执行任务 | `POST https://suites.mercator.cn/api/v1/task` |
| API 文档 | `https://suites.mercator.cn/docs` | | API 文档 | `https://suites.mercator.cn/docs` |
## 套件结构 ## 套件结构
``` ```
my-suite/ my-suite/
├── workflow.yaml # 步骤定义(核心 ├── workflow.yaml # 步骤定义(必填
└── scripts/ └── scripts/
└── run.py # 执行入口 └── run.py # 执行入口脚本
``` ```
## 基础镜像 ## 基础镜像
所有套件在 `registry.mercator.cn/agentgis/gis-base:latest` 中执行。 所有套件在 gis-base 镜像中执行,包含:Python 3, GDAL, Shapely, GeoPandas
包含:Python 3, GDAL, Shapely, GeoPandas, numpy
## 参考示例 ## 参考示例
- `SuiteHub/hello-world-suite` — 最小模板(查看代码了解 workflow.yaml 写法) 查看 `SuiteHub` 组织下的公开仓库:
- `SuiteHub/math-add` — 算术相加示例 - `hello-world-suite` — 最小模板
- `SuiteHub/buffer-analysis` — GIS 缓冲区分析 - `math-add` — 算术相加
- `buffer-analysis` — 缓冲区分析
## 文档 ## 文档
所有文档在 AgentGIS/docs 仓库的 `03-workflow/` 目录: 公开文档在 `SuiteHub/agent-profiles` 仓库中。
- `workflow-spec.md` — workflow.yaml 完整规范
- `script-dev-guide.md` — 脚本开发指南
- `skill-dev-guide.md` — 技能开发指南
- `suite-dev-guide.md` — 套件开发指南
- `suite-publishing-guide.md` — 发布指南