企业知识库与 UNS

企业设计期包含企业知识库、数据工厂和 UNS 建模入口。三者分工不同，需要在手册中分开理解。

企业知识库

企业知识库面向企业级知识治理，关注企业知识文件、权限、检索、共享和应用引用。它与资源库中的知识库资源可以协同，但企业知识库更强调企业范围管理。

数据工厂

数据工厂负责数据目录、数据资产、UNS 相关能力和数据治理。数据目录操作、资源绑定和语义调用配置在数据工厂入口中完成，AIOS 项目侧只使用已授权能力。

UNS 建模

UNS（Unified Namespace，统一命名空间）建模用于在同一工作空间内维护工业对象、点位及其语义关系。它将工厂、车间、产线、设备、工艺环节、采集点和业务资料组织为可浏览的语义树，使不同来源的数据能够使用稳定的命名路径被查询、订阅和引用。

UNS 中的“文件夹”负责组织层级，“文件”承载具体的数据定义或来源映射；模板用于复用字段结构，标签用于跨目录归类文件。模型可以手动建立，也可以从物联网、外部数据源、湖仓和知识库批量生成。

进入与界面概览

从工作台左侧导航选择 UNS 建模 即可进入。页面默认显示当前工作空间的建模资产，主要由以下区域组成：

• 模型分类：顶部提供“工厂模型、模板、标签”三个分类入口，用于在正式模型、可复用模板和标签资产之间切换查看。
• 操作栏：提供新建文件、新建文件夹、外部数据源、批量生成、刷新、数据结构、导入、导出等入口。
• 检索框：可按“名称 / 别名 / 路径”检索模型内的对象或点位。
• 模型树：以层级方式展示工厂模型。节点支持展开、收起和选择；叶子节点可代表采集点、视频通道、关系数据、计算指标、聚合结果、引用对象、湖仓资产或知识库。
• 节点详情：选择模型树中的节点后，右侧按节点来源和类型显示对应的明细与操作，不同类型的详情内容并不相同。

示例工作空间中，“湿法脱硫工艺闭环”工厂模型按“01-工况采集、02-模型研判、03-知识策略、04-安全校验与审批”等工艺阶段组织。工况采集阶段可见入口二氧化硫、烟气流量、烟气温度、吸收塔 pH、浆液给料流量、出口二氧化硫、脱硫效率、液位、压差、浆液密度、循环泵频率、氧化风机频率和 PLC 在线状态等点位；安全校验与审批阶段包含远程控制许可等约束点。这种结构用于把原始工业信号与工艺、诊断、知识和安全规则关联起来。

手动建立模型层级

新建文件夹

点击 新建文件夹，选择父级命名空间并填写名称、显示名称、别名和描述。别名留空时由系统生成。需要补充来源标识或业务信息时，可以增加扩展属性，最多 3 组。

建议先按“企业 / 工厂 / 车间 / 产线 / 设备”或企业自己的工艺层级建立文件夹，再将文件放到对应业务对象下。名称、别名和路径应保持稳定、可读，避免同一物理信号在不同位置出现含义不一致的命名。

新建文件

点击 新建文件，先选择父级命名空间，再填写名称、显示名称、别名和描述。页面提供以下 5 种文件数据类型：

• 时序型：用于连续变化的测点、状态量和控制量。定义中除业务值外，通常还包含质量码和采集时间。可以自定义字段、使用模板生成字段，或根据结构化数据样例及已有数据表逆向识别字段。
• 关系型：用于订单、台账、批次、工单等表格数据。可以定义多个字段，并指定唯一的主键；主键只允许使用字符串、整数或长整数类型。字段同样支持自定义、模板和逆向生成。
• 计算型：用于根据其他文件的字段实时计算新指标。先选择函数计算或统计计算，再添加输入变量并编写表达式。变量可以引用其他文件中的字段，表达式支持常见运算、数学函数、字符串处理和条件判断。
• 聚合型：用于按固定周期汇总一组文件。可以选择秒、分钟或小时级频率，并选择最多 100 个聚合目标。
• 引用型：用于在当前命名空间中指向另一个已有节点，避免重复定义同一对象。

时序型、关系型和计算型文件在后续步骤中还可以关联标签并设置是否持久化。时序型和关系型可以配置数据下写；聚合型和引用型在第一页完成目标配置后即可创建。

常用字段类型包括整数、长整数、单精度浮点数、双精度浮点数、布尔、日期时间、字符串及二进制大对象。字段定义应与真实数据含义一致，并补充显示名称、单位和备注，便于后续项目或 Agent 正确理解。

模型树操作

选择节点会打开右侧详情。将鼠标移到节点上可以快速复制或删除；右键菜单还提供刷新、查看标签、查看模板、复制、粘贴、新建下级文件夹、新建下级文件和收起文件夹等操作。

复制操作会连同下级结构一起复制。粘贴到文件夹时以该文件夹为目标，粘贴到文件时以该文件的父级目录为目标。由物联网、外部数据源、湖仓或知识库生成的节点受来源管理，不能在其内部直接新建或粘贴下级节点。

删除可能同时影响下级结构和下游引用，执行前应确认节点路径和使用范围。导入生成的节点即使可以从 UNS 树移除，也不会因此删除其上游设备、数据表、湖仓资产或知识库。

不同节点的右侧详情

所有节点的 明细 都会显示类型、命名路径、名称、显示名称、别名、描述、数据类型、关联模板、引用源、表达式和创建/更新时间。普通文件还可以设置持久化，手动建立的节点可以编辑。

右侧其余内容按节点类型变化：

• 普通文件：显示消息体、字段定义和附件。附件最多上传 3 个，单个文件不超过 10 MB，可下载或删除。
• 物联网普通点位：除通用明细外，还显示采集任务、点位编号、点位路径、协议、协议地址、访问模式和单位。消息体会展示最新值、质量码和采集时间；打开详情后系统会尝试建立实时订阅，也可以手动读取上游最新值或进入历史数据页面查询。
• 可写物联网点位：值字段旁显示 写值。写值会向真实设备或控制系统发送命令，只对上游声明为可写或读写的点位开放。操作前必须确认点位、类型、联锁、审批和现场条件。
• 视频通道：显示为“视频型”，右侧使用 视频播放 代替普通消息体。可以刷新播放配置、选择可用播放协议并查看画面；具备云台能力时，还会显示方向移动、停止、变倍、设置预置位和调用预置位。云台控制会直接作用于真实摄像机。
• 外部数据表或视图：显示来源数据源、对象类型、表或视图名称及字段映射。可使用 数据预览 分页查看只读数据，也可在 字段管理 中重新读取远端结构、保留需要的字段并更新当前文件定义。
• 湖仓数据资产：显示资产目录、来源路径、存储状态、模板属性、实例字段和存储信息。可使用 查询数据 设置查询条件、排序和分页参数，读取湖仓中的实际数据。
• 知识库节点：右侧提供 文件列表 和 检索。可以按文件名查询、刷新、查看文件详情、读取知识内容或下载源文件。标准知识库和图谱知识库支持内容检索；对象存储类知识库主要展示对象信息和源文件，不生成知识切片。

由外部来源生成的节点以来源结构为准，因此通常不提供直接编辑、附件上传或任意修改字段的入口；应先在上游调整，再回到 UNS 刷新或重新生成映射。

接入外部数据源

点击 外部数据源 会进入数据源管理页面。页面可以刷新列表、新建数据源，并对已有数据源执行连接测试、编辑或删除。删除数据源会同时移除对应的连接配置，执行前应确认没有模型仍在使用它。

新建时先选择数据源类型，再填写名称、启用状态、说明、连接信息和认证方式；各连接器还可以提供高级配置。当前可选择的连接器包括：

• 关系型数据库：MySQL、MariaDB、PostgreSQL、openGauss、达梦、人大金仓、Oracle、SQL Server、DB2；
• NoSQL：Redis、MongoDB、Elasticsearch；
• 时序型数据库：InfluxDB、TDengine、QuestDB、IoTDB；
• 向量数据库：Milvus；
• 对象存储：MinIO；
• 消息队列：Kafka、Mosquitto、NATS、RabbitMQ、RocketMQ、Pulsar。

连接参数、账号口令等敏感信息应由具备数据源管理权限的人员填写。完成配置后先执行连接测试，再在批量生成中选择可识别表结构的关系型或时序型数据源，建立数据表与 UNS 文件的映射。

批量生成

点击 批量生成，先选择数据来源和目标命名空间。目标可以是根命名空间，也可以是模型树中已有的文件夹。页面支持放大全屏，便于在大量设备、字段或资产中筛选。

物联网普通点位

选择 物联网点位采集器，再选择采集器和点位。列表显示点位名称、文件夹路径编码、数据类型、访问模式和单位，支持搜索、分页、本页勾选和“全选全部”。

生成时，系统按照点位的完整路径逐级创建或复用文件夹，并在末级目录下生成时序型文件。文件会保留上游点位编号、任务、协议地址、访问模式、单位和数据类型，同时增加质量码与采集时间。再次导入同一上游点位时，系统会识别已有映射；路径或来源信息发生变化时更新原节点，没有变化时跳过，避免盲目生成重复点位。

物联网视频节点

选择 物联网视频设备采集器，再选择视频设备和通道。列表与普通点位类似，但勾选对象是视频通道。生成时同样按照通道的完整路径建立文件夹，并生成视频型文件。视频型文件保留设备任务和通道编号，右侧提供播放及云台能力，不显示普通点位的消息体和字段定义。

外部数据源

选择 外部数据源，依次选择已配置的数据源、表或视图，填写节点名称并勾选字段。字段列表显示原始类型、映射后的 UNS 类型、字段类别、是否可空、主键、唯一键和备注。

一张表或视图会生成一个关系型或时序型文件，所选字段作为该文件的字段定义，而不是为每个字段建立一个子文件。再次选择同一数据源和同一对象生成时，会更新原有文件及字段；如果旧结构中存在与数据源无关的下级节点，系统会停止自动转换，防止误删人工内容。

湖仓一体

选择 湖仓一体 后，在数据资产树中勾选资产。页面只展示数据型资产，尚未创建存储空间的资产不可选择。

生成时，系统在目标命名空间下还原资产所属的目录关系，并为每个选中资产建立关系型文件。资产字段会转换为对应的日期时间、数值、字符串或二进制字段，同时保留资产路径、模板属性和存储信息。相同来源资产在同一目录下不会重复创建。

知识库

选择 知识库 后，可以搜索组织、文件夹或知识库，并选择一个标准知识库、图谱知识库或对象存储知识库。生成时，系统按照知识资源的上级目录建立或复用文件夹，再生成一个对应的知识库文件节点。

再次导入同一知识库时会复用或移动原有节点，不会创建重复副本。导入后可以直接在右侧查看文件、检索内容或下载源文件；对象存储类知识库不提供知识切片检索。

批量生成 是把已接入的业务资源映射为 UNS 节点；操作栏中的 导入 则是读取符合 UNS 交换格式的模型定义文件。两者用途不同。

模板、标签与订阅

顶部切换到 模板 后，可以新建、查看、编辑或删除模板。模板包含名称、显示名称、别名、字段定义和描述；模板详情会显示自身定义以及使用该模板的文件，并支持解除文件关联。

切换到 标签 后，可以新建、查看、编辑或删除标签。标签包含名称、颜色、描述和关联文件；标签详情中可以增加或移除关联文件。标签适合跨目录组织同类对象，例如“关键控制点”“质量指标”或“需审批写点”。

文件、文件夹、模板和标签都可以开放订阅，但发布方式不同：

• 文件启用订阅后，开放该文件自身的消息主题，不改变上游采集频率；
• 文件夹、模板和标签启用订阅后，系统按设定周期发布其范围内的最新值汇总；
• 汇总订阅可选择 1 秒、5 秒、30 秒、1 分钟、5 分钟、1 小时或 1 天。

数据结构、导入与导出

点击 数据结构 可查看文件夹、文件、模板和标签 4 类结构说明。每一类都可以复制，供模型交换或外部系统理解元数据格式使用。

点击 导出 会把当前工作空间的模型层级、模板和标签整理为一个模型定义文件。导出前会检查编号重复、层级循环等异常，成功后下载到本地。

点击 导入 先选择由本页面导出或符合相同结构的模型定义文件，确认后递归创建其中的文件夹、文件、模板和标签。系统会校验文件结构、层级和别名冲突；导入失败时应先修正定义，不要在生产模型中反复尝试。

在执行批量生成或导入前，应确认工作空间、目标目录、命名规则和字段映射。对生产模型进行导出、批量调整或重新导入前，建议保留可追溯的版本并由相关负责人复核。

在项目中使用 UNS 数据

UNS 建模侧负责定义和维护数据结构；项目、应用或 Agent 侧应只引用已授权、已校验的能力。推荐流程如下：

1. 在 UNS 建模中建立对象层级、点位、属性和必要的语义关系。
2. 按数据来源选择手动建模或批量生成，并确认目标命名空间。
3. 打开不同类型节点的右侧详情，核对来源、字段、实时值、视频、湖仓或知识内容是否正确。
4. 使用检索和数据结构检查名称、别名、路径及层级是否符合约定。
5. 根据使用范围设置模板、标签、持久化和订阅，并完成必要授权。
6. 在项目或 Agent 中引用已授权、已验证的 UNS 数据能力。
7. 当设备、工艺、数据源或知识资源发生变化时，先刷新或重新生成映射并复核，再同步调整下游引用。

当前页面所见功能以所在工作空间的权限和已配置资产为准。批量生成、导入、删除、数据下写和视频云台控制可能影响现有资产或外部系统，实际执行前请按企业的数据治理、设备安全和变更流程审批。