docs: TOOLS.md 更新 gis-actions 名称、v2.0.8 URL、registry 凭据、已知问题

This commit is contained in:
Ubuntu
2026-07-13 14:18:46 +08:00
parent 8dc7b8c041
commit 6cd8b3b05e
2 changed files with 22 additions and 28 deletions
+12 -15
View File
@@ -21,25 +21,22 @@ agc config set api-key mk_xxxxxxxxxxx
pip install https://git.mercator.cn/api/packages/SuiteHub/generic/agentgis-sdk/0.1.0/agentgis_sdk-0.1.0-py3-none-any.whl
```
### agentgis-worker(本地执行器,`agc run` 必需)
### gis-actions(本地执行器,`agc run` 必需)
`agc run` 在 v0.2.0 中改为本地执行,不再调用平台 API。需要安装 worker
`agc run` 在 v0.2.0 中改为本地执行,需要 gis-actions 在本地运行
```bash
# 安装依赖(Docker
sudo apt-get install -y docker.io
sudo usermod -aG docker $USER
# 重新登录或执行 newgrp docker
newgrp docker
# 安装 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
# 安装 gis-actions
curl -OJ https://git.mercator.cn/api/packages/SuiteHub/generic/gis-actions/2.0.8/gis-actions_2.0.8_all.deb
sudo dpkg -i gis-actions_2.0.8_all.deb
# 登录 Docker Registry(拉取 gis-base 镜像)
docker login registry.mercator.cn -u <用户名> --password-stdin
# 启动
sudo systemctl start agentgis-worker
echo "agw_readonly_2026" | docker login registry.mercator.cn -u agentgis-worker --password-stdin
```
---
@@ -54,7 +51,7 @@ agc suites list | grep <关键词> # 搜索已有套件
# 初始化新套件(脚手架)
agc init ./my-analysis
# 测试执行(需先安装 agentgis-worker
# 测试执行(需先安装 gis-actions
agc run <suite-id> --inputs '{"key": "val"}' --wait --poll 5
# 发布到市场
@@ -118,11 +115,11 @@ steps:
## 基础镜像
所有套件在 gis-base 镜像中执行,包含:Python 3, GDAL, Shapely, GeoPandas, numpy
所有套件在 gis-base 镜像中执行,包含:Python 3, GDAL, Shapely, GeoPandas, numpy, openpyxl, xlrd
镜像地址:`registry.mercator.cn/agentgis/gis-base:latest`
> ⚠️ 已知限制:gis-base 镜像暂缺 openpyxl / xlrd,涉及 Excel 读写的套件需要在脚本中 pip install。详见 Issue #6。
> 当前 digest`sha256:48c31cb3`(验证含 openpyxl/xlrd
## 知识库
@@ -140,5 +137,5 @@ steps:
| Issue | 描述 | 状态 |
|-------|------|------|
| [#5](https://git.mercator.cn/SuiteHub/agent-profiles/issues/5) | Docker Registry 认证 | 已修复(agentgis-worker/agw_readonly_2026 |
| [#6](https://git.mercator.cn/SuiteHub/agent-profiles/issues/6) | worker 未挂载输入文件 + 镜像缺包 | 待修复 |
| [#5](https://git.mercator.cn/SuiteHub/agent-profiles/issues/5) | Docker Registry 认证 | 已修复(agentgis-worker/agw_readonly_2026 |
| [#6](https://git.mercator.cn/SuiteHub/agent-profiles/issues/6) | gis-actions worker 兼容性问题 | ⏳ 待修复 |