docs: rewrite GIS-Actions local deployment guide (#8)

suites-help/系统使用手册/GIS-Actions-本地部署.md

@@ -15,61 +15,51 @@ GIS Actions 是**本地执行器**，从套件市场下载脚本包并在本地
 
 ## 环境要求
 
-- Python 3.10+
+- Linux 系统（Debian / Ubuntu）
-- Docker（用于容器化执行）
+- Docker
+- Python 3.10+（已随系统安装）
 
-## 获取代码
+## 安装
 
 ```bash
-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"
+# 下载并安装 gis-actions（一个 deb 包含全部功能）
-tar xzf gis-actions.tar.gz
+curl -sLO https://git.mercator.cn/api/packages/SuiteHub/generic/gis-actions/3.0.2/gis-actions_3.0.2_all.deb
-cd gis-actions
+sudo dpkg -i gis-actions_3.0.2_all.deb
 ```
 
-## 配置
+安装后 `agc` 命令即可用。postinst 会自动下载 gis-base 镜像。
+
+## 配置（可选）
 
 ```bash
 # 设置 API Key（从 https://auth.mercator.cn 获取）
 export AGENTGIS_API_KEY=mk_xxxxxxxxxxxxx
 ```
 
-或创建 `worker.json`：
-
-```json
-{
-  "worker": { "id": "my-machine-001" },
-  "scheduler": { "url": "https://suites.mercator.cn" },
-  "auth": { "api_key": "***" }
-}
-```
-
 ## 运行套件
 
 ```bash
-# 通过套件 ID 执行（推荐）
+# 通过套件 ID 执行
-python cli.py run /tmp/workdir --suite-id parcel-analysis --input buffer_distance=0.5
+agc run /tmp/output --suite-id <suite-id> --input key=value
 
-# 或直接指定脚本包地址
+# 示例
-python cli.py run /tmp/workdir --package-url https://git.mercator.cn/.../scripts.tar.gz
+agc run /tmp/output --suite-id 2c99a1cb-84a5-42dd-9147-1c8e8f7f2941 --input buffer_distance=0.5
 ```
 
-## 目录结构
+## 包结构
 
 ```
-gis-actions/
+/usr/bin/agc                          # CLI 入口
-├── cli.py                  # 命令行入口（支持 --suite-id / --package-url）
+/usr/share/gis-actions/cli.py         # CLI 逻辑
-├── download_and_run.py     # 下载 + 执行核心逻辑
+/usr/share/gis-actions/download_and_run.py  # 下载+执行
-├── steps_executor.py       # workflow.yaml 步骤执行器
+/usr/share/gis-actions/steps_executor.py    # 步骤执行器
-├── workdir/                # 默认工作目录
-└── packaging/deb/          # DEB 打包结构（待完善）
 ```
 
 ## 执行流程
 
-1. `cli.py run` 启动
+1. `agc run` 启动
 2. 解析套件 ID（调用 Suite Market API 获取 package_url）
-3. 下载 scripts.tar.gz → 解压到工作目录
+3. 下载脚本包 → 解压到工作目录
 4. 读取 workflow.yaml，按 steps 顺序执行
 5. 每个步骤在 Docker 容器中运行（gis-base 镜像）
-6. 清理脚本目录（知识产权保护）
+6. 结果写入本地输出目录
-7. 结果写入本地输出目录