用途:把用户提供的 CSV 或 TSV(单个文件、一个文件夹或路径列表)转换成 infrahubctl object load 可接受的对象 YAML,使数据出现在可审查的分支上。该技能是“有表格数据”到“对象存在于分支上”的桥梁。
主要能力:只读方式发现并使用当前 live schema,将列映射到属性、做值类型转换(布尔/数字/日期/JSON)、处理空值与 dropdown 标签转名称、识别引用与 HFID、折叠接口式范围、拆分反规范化 CSV、合并同类多文件输入;输出带 apiVersion: infrahub.app/v1 信封、编号加载顺序、来源注释(含 sha256 与时间戳)的 YAML。
使用方式:按 14 步工作流执行,先用 MCP、infrahubctl schema export 或 /api/schema 发现 schema,再 profile 样本、确认映射,随后运行 infrahubctl branch create <name>、infrahubctl object validate ./output_dir/ --branch <name>、infrahubctl object load ./output_dir/ --branch <name>。
限制:严格只读 schema,若某列无 schema 归属则 fail-closed 并交给 infrahub-managing-schemas;不写默认分支;只覆盖 CSV/TSV,不处理 JSON、XLSX、Parquet;object load 跨文件非事务,需按分支优先原则丢弃分支重跑;不自动合并;需注意项目 Python 环境前缀与服务器连通性检查。