From 8d8c08fd8cf2006146ea719312a35695a6d63478 Mon Sep 17 00:00:00 2001 From: Ubuntu Date: Mon, 13 Jul 2026 16:41:49 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=85=A8=E9=9D=A2=E6=9B=B4=E6=96=B0?= =?UTF-8?q?=E8=BF=87=E6=9C=9F=E5=BC=95=E7=94=A8=20=E2=80=94=20agentgis-cli?= =?UTF-8?q?=E2=86=92gis-actions,=20=E7=89=88=E6=9C=AC=203.0.2?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- suites-help/SDK参考/CLI-参考.md | 32 +++++---------- suites-help/SDK参考/Python-SDK.md | 40 +++---------------- suites-help/开发者指南/套件发布指南.md | 2 +- .../系统使用手册/GIS-Actions-本地部署.md | 2 +- 4 files changed, 19 insertions(+), 57 deletions(-) diff --git a/suites-help/SDK参考/CLI-参考.md b/suites-help/SDK参考/CLI-参考.md index c090a33..7c39fc5 100644 --- a/suites-help/SDK参考/CLI-参考.md +++ b/suites-help/SDK参考/CLI-参考.md @@ -2,11 +2,15 @@ ## 安装 +`agc` 命令随 gis-actions 包一起安装： + ```bash -# 从 Gitea 安装 -pip install https://git.mercator.cn/SuiteHub/agentgis-cli/raw/branch/main/dist/agentgis_cli-0.1.0-py3-none-any.whl +curl -sLO https://git.mercator.cn/api/packages/SuiteHub/generic/gis-actions/3.0.2/gis-actions_3.0.2_all.deb +sudo dpkg -i gis-actions_3.0.2_all.deb ``` +安装后直接使用 `agc` 命令。 + ## 配置 ```bash @@ -18,32 +22,18 @@ agc config set api-key mk_xxxxxxxxxxxxx ### 查询套件 ```bash -# 列出所有套件 agc suites list - -# 搜索套件 -agc suites search <关键词> - -# 查看套件详情 -agc suites get ``` -### 执行 +### 执行套件 ```bash -# 执行套件 -agc run --inputs '{"expression": "1+1"}' - -# 查看执行状态 -agc status +agc run --inputs '{"key": "val"}' --wait --poll 5 ``` -### 开发 +### 发布套件 ```bash -# 从模板创建新套件 -agc init ./my-suite - -# 发布套件 -agc publish ./my-suite +tar czf suite.tgz --exclude='.git' --exclude='__pycache__' my-suite/ +agc publish upload suite.tgz ``` diff --git a/suites-help/SDK参考/Python-SDK.md b/suites-help/SDK参考/Python-SDK.md index 5ca67b0..83437e3 100644 --- a/suites-help/SDK参考/Python-SDK.md +++ b/suites-help/SDK参考/Python-SDK.md @@ -1,36 +1,8 @@ -# Python SDK +# Python SDK（已废弃） -## 安装 +`agentgis-sdk` 已不再维护。功能已被 `gis-actions` 命令行工具覆盖。 -```bash -``` - -## 快速开始 - -```python -from agentgis import AgentGIS - -client = AgentGIS(api_key="mk_xxxxxxxxx", base_url="https://suites.mercator.cn") - -# 查询套件列表 -suites = client.list_suites() -for s in suites: - print(f"{s.name} v{s.version}") - -# 查询套件详情 -detail = client.get_suite("suite-id-xxx") -print(detail.description) - -# 执行套件 -execution = client.execute_suite("suite-id-xxx", inputs={"buffer_distance": 0.5}) -print(f"Execution: {execution.execution_id}") - -# 查询执行状态 -status = client.get_execution(execution.execution_id) -print(f"Status: {status.status}") -``` - -## API 参考 - -完整的 API 客户端方法列表和参数说明见自动生成的 API 文档： -[https://suites.mercator.cn/docs](https://suites.mercator.cn/docs) +替代方案： +- `agc suites list` — 列出套件 +- `agc run` — 执行套件 +- `agc publish upload` — 发布套件 diff --git a/suites-help/开发者指南/套件发布指南.md b/suites-help/开发者指南/套件发布指南.md index 220ebdd..df4e8aa 100644 --- a/suites-help/开发者指南/套件发布指南.md +++ b/suites-help/开发者指南/套件发布指南.md @@ -9,7 +9,7 @@ ```bash # 安装 CLI -pip install https://git.mercator.cn/SuiteHub/agentgis-cli/raw/branch/main/dist/agentgis_cli-0.1.0-py3-none-any.whl +# gis-actions 安装后自带 agc 命令（见 TOOLS.md） # 配置 API Key agc config set api-key mk_xxxxxxxxxxxxx diff --git a/suites-help/系统使用手册/GIS-Actions-本地部署.md b/suites-help/系统使用手册/GIS-Actions-本地部署.md index 3c25db2..7b4f128 100644 --- a/suites-help/系统使用手册/GIS-Actions-本地部署.md +++ b/suites-help/系统使用手册/GIS-Actions-本地部署.md @@ -21,7 +21,7 @@ GIS Actions 是**本地执行器**，从套件市场下载脚本包并在本地 ## 获取代码 ```bash -curl -L -o gis-actions.tar.gz "https://git.mercator.cn/api/packages/AgentGIS/generic/gis-actions/v2.4.0/gis-actions.tar.gz" +curl -L -o gis-actions.tar.gz "https://git.mercator.cn/api/packages/SuiteHub/generic/gis-actions/3.0.2/gis-actions_3.0.2_all.deb" tar xzf gis-actions.tar.gz cd gis-actions ```