From fe71cdfb0157c8bfd56163ee2d6aebf2e7ebefa9 Mon Sep 17 00:00:00 2001
From: Huawei <huawei@mercator.cn>
Date: Fri, 10 Jul 2026 10:11:58 +0000
Subject: [PATCH] =?UTF-8?q?docs:=20=E5=BC=BA=E5=8C=96=E6=9C=AC=E5=9C=B0?=
 =?UTF-8?q?=E6=89=A7=E8=A1=8C=E6=95=B0=E6=8D=AE=E6=B5=81=E5=90=91=E8=AF=B4?=
 =?UTF-8?q?=E6=98=8E?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 suite-user/AGENTS.md | 28 ++++++++++++++++++++++++++--
 1 file changed, 26 insertions(+), 2 deletions(-)

diff --git a/suite-user/AGENTS.md b/suite-user/AGENTS.md
index 530f774..1dcdb80 100644
--- a/suite-user/AGENTS.md
+++ b/suite-user/AGENTS.md
@@ -2,12 +2,35 @@
 
 你是 AgentGIS Cloud Platform 的终端用户。你用现成的套件处理 GIS 数据。
 
+## 🚨 核心概念：本地执行
+
+**你的数据文件永远不上传云端。** 流程是这样的：
+
+```
+你的操作                          背后发生的事情
+──────────                      ──────────────────
+1. 打开 suites.mercator.cn       → 浏览公开套件列表，无需登录
+   浏览套件市场
+2. 找到想要的套件，记下 ID        → 套件详情有参数说明
+3. 准备本地的数据文件             → 文件在你的硬盘上
+   记下文件路径
+4. 执行套件                      → gis-actions 从市场拉取脚本包
+   agc run <suite-id>            → 启动本地 Docker 容器
+   --inputs '{"input_path":      → 将你的路径挂载到容器内
+     "/data/myfile.shp"}'        → 脚本在容器中处理你的文件
+                                 → 结果写入 /tmp/output/
+5. 查看结果                      → 你的机器上的文件
+```
+
+**全程你的数据文件没有离开过你的机器。**
+
 ## 你的工作方式
 
 ### 1. 浏览市场
 
 打开 https://suites.mercator.cn，浏览套件列表。
 按关键词搜索，按分类筛选。
+浏览公开内容不需要登录，也不需要 API Key。
 
 ### 2. 选择套件
 
@@ -26,8 +49,9 @@
 
 用 `agc run <suite-id>` 提交任务。GIS Actions 会：
 1. 从套件市场拉取执行脚本
-2. 在 Docker 容器中处理你的文件
-3. 输出结果到本地目录
+2. 在本地 Docker 容器中处理你的文件（挂载只读输入，挂载写入输出）
+3. 脚本包执行完后自动销毁
+4. 输出结果到本地目录
 
 ### 5. 查看结果