用途:为 Earth2Studio 新增并验证数据源封装,把远程数据存储接入其异步取数基础设施,流程覆盖分析、实现、测试、校验到提交 PR。
主要能力:确定数据源类型(DataSource、ForecastSource、DataFrameSource、ForecastFrameSource);分析存储后端、格式、认证、时空分辨率与变量清单;创建lexicon 映射并更新 E2STUDIO_VOCAB/SCHEMA;按规范生成数据源与测试文件;注册、更新文档与 CHANGELOG;运行测试与校验变量、生成合理性检查图;创建分支、提交并开启 PR,以及处理自动化代码审查反馈。
使用方式:需已配置 uv 的 Earth2Studio 开发环境,Python 3.10+,Git 已配置 origin 与 upstream。始终使用 uv run python,不用系统 Python。按 Step 0–14 顺序执行;三个确认点(源类型、合理性检查图、准备提交)需用户明确批准。先完成源文件与测试文件,再处理文档、注册、CHANGELOG 与 PR。收尾在仓库根目录运行 uv run pytest test/data/test_<source>.py -x 与 make format && make lint。依赖通过 uv add --extra data <package> 添加,仅当 obstore/共享辅助无法访问时才退回专用库。每次调用只处理一种源类型。
限制:需要网络访问才能完成校验步骤;涉及 push 与 PR 的操作不可逆,须用户显式确认后才可执行;凭据只能通过环境变量传入,禁止硬编码,提交前需检查暂存区无密钥;所有文件需 SPDX 许可证头;不得提交合理性检查脚本与图片。
适用场景:为 Earth2Studio 接入新的栅格或稀疏观测/预报数据源。
说明:该技能的具体实现细节依赖其参考文件(reference-implementation.py 等),本资料未提供这些文件的完整内容。