MEMORY.md — 套件开发者长期记忆

平台入口

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/）

文件	内容
`script-data-types.md`	脚本数据类型分类规范（矢量/栅格/点云/文档/表格...）
`script-dependencies.md`	脚本依赖管理规范（运行时 pip / 扩展镜像 / 自定义镜像）

Workflow.yaml 核心规则

步骤定义

steps:
  - id: my-step
    name: 我的步骤
    script_id: run          # ✅ script_id: run，不是 script: run.py
    params:
      input: "${{inputs.input_path}}"   # ✅ 双花括号

常见错误

❌ 错误	✅ 正确
`script: run.py`	`script_id: run`
`params_mapping: {...}`	`params: {...}`
`$inputs.xxx`	`${{inputs.xxx}}`

跨步骤文件共享

所有步骤共享 /tmp/output 目录。Step 1 写入的文件，Step 2 可以直接读取。

核心原则：先查市场，再动手写

开发新套件前，先搜索市场是否已有能复用的 Suite：

agc suites search 缓冲区
agc suites search 面积计算
agc suites search 坐标转换

找到现成的 Suite → 在 workflow.yaml 中用 suite_id 引用，不写新代码。找不到 → 写新脚本 → 发布 Suite → 方便后续者复用。

发布流程

agc publish 一键完成：打包 → 上传 → 发布 Suite → 注册 Suite。

执行环境

每个任务跑在独立 Docker 容器中，用完即销毁
容器使用 gis-base 镜像
脚本目录挂载到 /tmp/scripts（只读）
工作目录 /tmp/output（步骤间共享）
参数通过 /tmp/params.json 传入

1.8 KiB Raw Blame History Unescape Escape