SuperAPI AI 工具集

semantius-transfer

通用与其它

查看项目

更新于 10-16 05:46

技能介绍

用途:在 Semantius 主机之间迁移模块或一组数据表,或导出为可恢复的 JSON 文件。主机间传输等于源端导出加目标端导入;备份即导出;恢复即导入回同一主机。

主要能力:支持三种模式——传输(默认,指定两个主机)、备份(导出到当前目录文件)、恢复(从文件导入)。范围可为模块(export_module,按 module_name)或表列表(export_entities,逗号分隔表名)。内容可为结构与记录(默认)、仅结构(exclude_data: true)或仅记录(exclude_schema: true,仅表,目标须已有表)。备份文件名形如 <module_slug>-<YYYYMMDD-HHMMSS>.json。

使用方式:先运行 semantius --version 与 semantius info utils 确认列出 export_module;用 semantius hosts 和 semantius --host <h> whoami 解析主机,退出码 5 表示未登录,需 semantius login --host <h>。导出示例:semantius --host <source> call utils/export_module '{"name":"CRM","path":"crm-20260926-141500.json"}';导入示例:semantius --host <target> call utils/import_module '{"path":"…"}'。流程分五阶段:确定范围、导出、确认门、导入、校验报告。

限制:导入前必须经确认门;记录按 id upsert 并覆盖同 id 目标行;用户按 external_id 匹配,未知用户会中止导入;不删除任何内容,跨请求无事务;不携带 webhook 接收器,导出仅含当前用户可见行;不加载 CSV/xlsx,不生成 markdown 规格;不执行 logout 或 use,不写凭据到 .env。