用途:把一份 CSV 导入 Semantius,一次处理一个实体(新建或复用),按批加载行。与面向整套系统设计的流水线技能不同,它只做轻量的单实体创建,由文件实际内容驱动,不需要蓝图或目录对账机制。
主要能力与流程:工作流分为六步:读取文件、映射与复核、检测与差异比对、决策与创建、执行导入、验证与报告。它负责整体流程与决策点,底层 CLI 语法、载荷结构与响应约定由 use-semantius 负责,冲突时以后者为准。支持的运行模式有三类:全量导入(默认,写目录加数据)、仅建表(只写目录,不导入行)、仅比对(不写任何数据,只输出分类差异报告)。任何会修改现有实体的分支都提供“仅报告、不更新”选项,比对不会强制更新。
使用方式:运行前需安装工具链、通过 getCurrentUser 确认已认证,并确认 CLI 含 get_csvschema。核心命令为 semantius call utils/get_csvschema '{"path": "<csv-path>"}' 做文件探查,随后创建工作目录、复制模板文件、执行 bun add --cwd <run-folder> csv-parse,再依次运行 create-fields.ts(可先 --dry-run 预检)与 import.ts <absolute-csv-path>,最后用 postgrestRequest GET 抽查验证。所有辅助脚本需从当前工作目录按路径运行,不要 cd 进运行目录。
适用场景与限制:适合把单张 CSV 快速接入 Semantius。需注意:映射、命名、去重等决策点会向用户逐项提问(以 Q: 任务形式登记并需先清空未决问题才能继续);扫描默认全文件,限制扫描会削弱格式判定与 id 识别;数据按字节原样传入,只应用显式声明的类型转换。关于收费、价格与平台支持的更多信息暂未提供。