docs: add dual-platform throughout training doc

This commit is contained in:
2026-07-20 09:15:05 +00:00
parent c5f3d4e9c4
commit 522a040128
+44 -25
View File
@@ -211,7 +211,9 @@
### 第 19 页:GIS Actions 是什么
- 本地执行器,安装在自己的 Linux 机器上
- 本地执行器
- **Linux**:安装在自己的机器上(deb 包)
- **Windows**:安装 agc.exezip 包)
- 命令行工具:`agc`
- 完整命令集:
- `agc config` — 配置 API Key 和市场地址
@@ -221,21 +223,35 @@
- `agc logs / cache` — 运行历史和缓存管理
- `agc mcp` — AI Agent 集成入口(MCP 协议)
- `agc self-update` — 自动升级
- 职责:从套件市场下载脚本包 → 在本地 Docker 中执行 → 返回结果
- 安装方式:一行命令
- 职责:从套件市场下载脚本包 → 在本地执行(Linux Docker / Windows 本机)→ 返回结果
- 安装方式:
**Linux**
```bash
curl -sLO https://packages.mercator.cn/public/gis-actions/latest.deb
sudo dpkg -i latest.deb
```
**Windows**
1. 下载 latest-windows.zip
2. 解压到 %LOCALAPPDATA%\AgentGIS\gis-actions\
3. 加入 PATH
4. 验证:`agc --help`
### 第 20 页:环境要求
- 操作系统:LinuxDebian / Ubuntu 推荐)
- Docker:需要安装 Docker Engine
- Python 3.10+(已随 deb 包安装)
- 网络:需要能访问 suites.mercator.cn(查询套件)和 git.mercator.cn(下载脚本包)
**Linux**
- 操作系统:Debian / Ubuntu
- Docker Engine
- Python 3.10+
- 首次运行时自动下载 gis-base 镜像(约 465MB
**Windows**
- 操作系统:Windows 10/11
- ArcMap 10.8arcpy 步骤需要)
- 无需 Docker
**通用:**
- 网络:需要能访问 suites.mercator.cn 和 git.mercator.cn
### 第 21 页:配置 API Key
- 为什么需要 API Key:用于认证身份、调取套件信息和下载脚本包
@@ -270,15 +286,18 @@
3. 从 Gitea Packages 下载脚本包(自动缓存)
4. 解压并读取 workflow.yaml
5. 按 depends_on 拓扑顺序执行各步骤
6. 每步在独立 Docker 容器中运行(docker run --rm gis-base
6. 每步按 runtime 执行:
- runtime: docker → Docker 容器(gis-base 镜像)
- runtime: python3 → 本地 subprocess
- runtime: arcpy → 系统 arcpyWindows only
7. 结果写入本地工作目录的 `_step_outputs/` 下
8. 清理下载的脚本包
8. 清理下载的脚本包和临时文件
### 第 23 页:数据安全
- **数据永不离开本地**
- 输入文件始终在用户自己的机器上
- 数据处理在本地 Docker 容器中完成
- 数据处理在本地完成(Linux Docker 容器 / Windows 本机进程)
- 不上传到云端、不经过平台服务器
- 执行完成后脚本包自动清理
- 用户数据和结果文件始终保留在本地
@@ -289,12 +308,12 @@
1. 查看控制台错误信息
2. 检查输入文件路径是否正确
3. 运行 `agc doctor` 一键诊断环境:
- Docker 是否运行
- gis-base 镜像是否存在
- Linux: Docker 是否运行 / Windows: agc.exe 是否在 PATH
- 镜像是否存在Linux
- API Key 是否有效
- 能否连通套件市场
4. 查看失败记录:`agc logs --status failed`
5. 确认已升级到最新版:`agc self-update`
5. 确认已升级到最新版:`agc self-update`Linux: deb / Windows: zip 自动解压)
- 自动报告失败:已配置 API Key 的情况下,执行失败会自动发帖到 Discussions
- 如果怀疑是套件本身的 Bug
- 配置 API Key 后,自动反馈到讨论区
@@ -306,12 +325,13 @@
### 第 25 页:GIS Base 是什么
- 所有套件运行基石
- **Linux 模式**:所有 Docker 套件运行基石
- 预装完整 GIS 工具链的 Linux Docker 镜像
- 永久存储在用户本地,所有套件共享
- 镜像名:`gis-base:latest`
- 大小:约 465MB
- 基底:Debian slimbookworm
- 镜像名:`gis-base:latest`,约 465MB
- **Windows 模式**:不需要 gis-base 镜像
- 使用本地 arcpy / Python 环境
- 依赖 ArcMap 10.8 的 arcpy 环境
### 第 26 页:预装环境
@@ -401,9 +421,9 @@
```
用户 → Auth Center 登录/获取 API Key
→ 浏览 Suite Market → 选择合适的套件
→ 浏览 Suite Market → 选择合适的套件(关注平台标签)
→ 复制 agc run 命令 → 在本地终端执行
→ GIS Actions 下载脚本包 → Docker 运行 → 得到结果
→ GIS Actions 下载脚本包 → 执行(Linux Docker / Windows 本机)→ 得到结果
→ 出问题 → Discussions 反馈 → 开发者收到 → 修复 → 发布新版本
```
@@ -424,10 +444,9 @@
┌─────────────────────────────────────────────────┐
│ 本地用户 │
│ │
│ gis-actions (agc) ── docker run ── 脚本执行
gis-base 镜像
│ (本地 + 只读) │
│ gis-actions (agc)
├─ Linux: docker run gis-base → 脚本执行
└─ Windows: subprocess(arcpy/python3) → 执行
└─────────────────────────────────────────────────┘
```
@@ -435,8 +454,8 @@
- **Mercator 云平台**:认证 + 市场 + 讨论区,构成完整生态
- **AgentGIS**:将 GIS 能力扩展到本地,数据安全有保障
- **GIS Actions**:一键安装,即装即用
- **GIS Base**开箱即用的 GIS 工具箱
- **GIS Actions**:一键安装Linux deb / Windows zip,即装即用
- **GIS Base**Linux Docker 模式的 GIS 工具箱 / Windows 使用本地 arcpy
- **核心价值**:数据不离开本地,算法安全交付,身份贯穿全域
---