From 9a73f4d5c8d36f1727f164bdf57fd4afc4db51e7 Mon Sep 17 00:00:00 2001
From: Ubuntu <ubuntu@localhost.localdomain>
Date: Mon, 13 Jul 2026 16:59:55 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E4=BF=AE=20Issue=20#8=20=E5=88=97?=
 =?UTF-8?q?=E5=87=BA=E7=9A=84=20P0/P1=20=E9=97=AE=E9=A2=98=20=E2=80=94=20w?=
 =?UTF-8?q?orkflow=20=E6=A0=BC=E5=BC=8F=E3=80=81registry=20=E5=BC=95?=
 =?UTF-8?q?=E7=94=A8=E3=80=81=E9=94=99=E8=AF=AF=20CLI=20=E5=91=BD=E4=BB=A4?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 suite-developer/MEMORY.md                         |  3 +--
 suite-developer/knowledge/data-execution-model.md |  2 +-
 suite-user/AGENTS.md                              |  2 +-
 suites-help/开发者指南/Workflow-规范.md           | 10 +++++-----
 suites-help/开发者指南/最佳实践.md                |  4 ++--
 5 files changed, 10 insertions(+), 11 deletions(-)

diff --git a/suite-developer/MEMORY.md b/suite-developer/MEMORY.md
index d311a00..a49ff7f 100644
--- a/suite-developer/MEMORY.md
+++ b/suite-developer/MEMORY.md
@@ -5,7 +5,6 @@
 - **API:** https://suites.mercator.cn
 - **API Key 获取:** https://auth.mercator.cn
 - **API 文档:** https://suites.mercator.cn/docs
-- **基础镜像:** `registry.mercator.cn/agentgis/gis-base:latest`
 
 ## 知识库（knowledge/）
 
@@ -24,7 +23,7 @@ steps:
     name: 我的步骤
     script_id: run          # ✅ script_id: run，不是 script: run.py
     params:
-      input: "${{inputs.input_path}}"   # ✅ 双花括号
+      input: $params.input_path   # ✅ 使用 $params.xxx
 ```
 
 ### 常见错误
diff --git a/suite-developer/knowledge/data-execution-model.md b/suite-developer/knowledge/data-execution-model.md
index 5224dfc..6cbba71 100644
--- a/suite-developer/knowledge/data-execution-model.md
+++ b/suite-developer/knowledge/data-execution-model.md
@@ -54,7 +54,7 @@
 
 - **需要安装 Docker**（一次性）
 - **需要安装 gis-actions**（一次性）
-- **需要能访问 `suites.mercator.cn` 和 `registry.mercator.cn`**（网络条件）
+- **需要能访问 `suites.mercator.cn`**（网络条件）
 - **提供本地文件路径**，不是上传文件
 
 ## 对套件开发者的影响
diff --git a/suite-user/AGENTS.md b/suite-user/AGENTS.md
index 1dcdb80..0eeae93 100644
--- a/suite-user/AGENTS.md
+++ b/suite-user/AGENTS.md
@@ -15,7 +15,7 @@
 3. 准备本地的数据文件             → 文件在你的硬盘上
    记下文件路径
 4. 执行套件                      → gis-actions 从市场拉取脚本包
-   agc run <suite-id>            → 启动本地 Docker 容器
+   agc run <suite-id> --inputs '{...}'  → 启动本地 Docker 容器
    --inputs '{"input_path":      → 将你的路径挂载到容器内
      "/data/myfile.shp"}'        → 脚本在容器中处理你的文件
                                  → 结果写入 /tmp/output/
diff --git a/suites-help/开发者指南/Workflow-规范.md b/suites-help/开发者指南/Workflow-规范.md
index deb2a89..963e568 100644
--- a/suites-help/开发者指南/Workflow-规范.md
+++ b/suites-help/开发者指南/Workflow-规范.md
@@ -49,21 +49,21 @@ params:
 ## 步骤定义（steps）
 
 ```yaml
-nodes:
+steps:
   - id: my-step          # 步骤 ID，唯一
     name: 我的步骤        # 步骤名称
-    script_id: run        # 脚本标识（不是 script: run.py）
+    script: run        # 脚本标识（不是 script: run.py）
     params:
-      input: "${{inputs.input_path}}"   # 双花括号语法
+      input: "$params.input_path}}"   # 双花括号语法
 ```
 
 ### 常见错误
 
 | ❌ 错误写法 | ✅ 正确写法 | 原因 |
 |-----------|-----------|------|
-| `script: run.py` | `script_id: run` | 执行器读的是 `script_id` |
+| `script: run.py` | `script: run` | 执行器读的是 `script` |
 | `params_mapping: {...}` | `params: {...}` | 字段名是 `params` |
-| `$inputs.xxx` | `${{inputs.xxx}}` | 双花括号语法 |
+| `$inputs.xxx` | `$params.xxx}}` | 双花括号语法 |
 
 ## 文件共享
 
diff --git a/suites-help/开发者指南/最佳实践.md b/suites-help/开发者指南/最佳实践.md
index 2c96e9f..b21d7c4 100644
--- a/suites-help/开发者指南/最佳实践.md
+++ b/suites-help/开发者指南/最佳实践.md
@@ -5,8 +5,8 @@
 开发新套件前，先搜索市场是否已有能复用的套件：
 
 ```bash
-agc suites search 缓冲区
-agc suites search 面积计算
+agc suites list  缓冲区
+agc suites list  面积计算
 ```
 
 能找到现成的就引用它。不需要每次都写自己的脚本。