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

This commit is contained in:
2026-07-19 09:06:41 +00:00
parent 259379f9c7
commit 3821e96edb
@@ -63,3 +63,22 @@
- **本地测试路径 ≠ 用户路径**,脚本要用参数化路径而非硬编码 - **本地测试路径 ≠ 用户路径**,脚本要用参数化路径而非硬编码
- **输出必须写入 `output_path`**,由 gis-actions 决定输出目录位置 - **输出必须写入 `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 中,只能本地执行