docs: 增加 Playground 演示数据说明（demo-data/ 目录规范）

2026-07-19 09:06:41 +00:00
parent 259379f9c7
commit 3821e96edb
1 changed files with 19 additions and 0 deletions
@@ -63,3 +63,22 @@
 - **本地测试路径 ≠ 用户路径**，脚本要用参数化路径而非硬编码
 - **输出必须写入 `output_path`**，由 gis-actions 决定输出目录位置
 - **不要假设文件系统结构**，用户文件和容器文件系统是隔离的
+
+
+## Playground 在线演示（新增）
+
+> agentgis.cn 上的在线 Playground 提供浏览器沙箱体验。
+
+### 数据差异
+
+| 场景 | 数据来源 | 执行位置 |
+|------|---------|---------|
+| 本地 agc run | 用户本地文件 | 用户本地 Docker |
+| 在线 Playground | 套件包内 demo-data/ 目录 | 腾迅云隔离容器 |
+
+### 对套件开发者的影响
+
+- Playground 可用的套件必须包含 demo-data/ 目录，放入样例数据文件（GeoJSON / SHP / CSV）
+- 样例数据需要小而典型，建议 < 5MB
+- workflow.yaml 的参数默认值指向 demo-data/ 中的文件路径
+- 无 demo-data/ 的套件不会出现在 Playground 中，只能本地执行