SuperAPI AI 工具集

semantic-model-deployer

部署与运维

查看项目

更新于 10-16 08:46

技能介绍

用途:把 semantic-model-analyst 技能生成的 *-semantic-model.md 文件安全部署到运行中的 Semantius 实例。该技能负责工作流,包括解析模型、检查已部署内容、对比差异、与内置实体去重、检测整个实体目录中的名称冲突与相近冲突、规划并编排步骤;实际执行由 use-semantius 技能通过 semantius CLI 完成。

主要能力:部署前先检视统一目录,避免歧义,确保两个模块不会各自拥有同名实体。它会按顺序处理模块解析、内置实体检查、加载完整实体目录并对每个模型实体分类:内置、同模块匹配、跨模块同名、相近名或新实体。跨模块同名或相近名属于必须由用户决定的门禁,不能静默共存。技能支持重复运行,会比较新模型与已部署内容,只应用增量,不创建重复模块,不删除 Semantius 中已不在模型中的内容。

使用方式:先读取 use-semantius 的 SKILL.md 与 data-modeling.md,然后按阶段解析模型、检视目录、规划、执行、验证。所有操作通过 semantius 命令完成,例如 semantius call crud read_module '{"filters": "name=eq.lead_manager"}' 和 semantius call crud create_entity '{"data": {...}}'。内置实体从不替换,只能附加字段;自引用字段需在实体全部建立后二次创建。

限制:模型若存在未解决的决策问题必须停下并让用户选择;front-matter 与 Related domains 不一致时停止;对已有数据的实体新增必填字段必须有默认值,否则需先处理。文中未提供的细节,如具体收费、平台支持范围等,暂未提供。