原始飞书文档：《AI工单》6月资产语义底座作者：龚菲

【AI工单】6月资产语义底座

墨刀原型 #AI-gf-分享

页面基本信息

• 页面名称：资产资源管理
• 页面标识符：AssetResourceManagement
• 核心目标：从业务中台拉取资产数据，并为每个资产注入"AI语义信息"（别名、权重），构建AI能够理解的向量知识库。

页面布局与交互逻辑

物理空间树

1. 页面左侧加载"空间资源管理"模块定义的物理空间数据。

2. 交互样式请参考设备资源管理页面的左侧物理空间层级。

   • 联动加载：选中树节点（如"一栋"），右侧列表展示该节点及其下所有叶子节点（如"一栋一层"、"一栋二层"）关联的资产。
   • 默认状态：默认选中项目节点，展示项目下所有资产。可为空，为空则默认是全部。
   • 前置约束：点击"引入资产"按钮时，系统需判断当前是否选中了某个树节点。若未选中节点，在页面顶部弹出警告提示（Toast）："请先选择对应空间层级"。

资产列表

1. 过滤条件

检索条件	说明
资产类型	单选，可为空，默认为空显示全部。数据来源为列表里有的资产类型。按照树形结构进行检索。可参考资产应用里的检索组件。
资产名称	文本，可为空，为空检索全部。模糊检索。可参考资产应用里的检索组件。
资产编码	文本，可为空，为空检索全部。模糊检索。可参考资产应用里的检索组件。
启用状态	单选，可为空，不选默认为全部，选项为启用、禁用。对应列表里的AI状态。

1. 列表

分类	说明
默认排序	按更新编辑时间倒序（最新编辑操作的放在前面，也可与设备资源管理列表排序规则保持一致）
勾选框	与批量操作配合使用，若没有勾选直接选择批量操作按钮，则需要弹出提示文本"请先勾选资产"
资产类型	显示资产类型，不需要完整路径，叶节点即可。类型列和名称列麻烦互换下位置~
资产名称	显示资产名称
资产编码	显示资产编码
资产存放位置	展示完整路径，如：一栋 | 一层 | 101房间
AI别名	显示在配置右抽屉弹窗配置的该资产的别名。可与资产资源管理保持一致。
AI状态	AI的状态。新引入资产后，默认为启用。启用前面显示绿色小圆圈，禁用显示灰色小圆圈。
同步异常【6/15新增】	每次系统自动定时同步或者手动点击数据同步。如果同步成功，则自动按照最新的数据，去更改资产信息，列表里的同步异常字段为空。 如果同步失败，则需要显示同步失败的原因。每次仅记录最新的一条数据。 如果失败的报错是资产应用中该资产已被删除，则AI状态自动禁用。其他的报错，不要把AI状态自动禁用了。
操作列	配置：点击配置按钮，弹出该资产配置的右抽屉弹窗 重新同步：点击重新同步，则查询资产业务中台中该资产的最新数据，对该资产进行数据同步，同步成功弹出提示弹窗：同步更新成功。失败则显示：同步更新失败，请检查服务。AI别名、权重、AI启用状态禁止被同步覆盖。 启禁用：AI状态为启用的资产，该按钮为红色禁用。点击则把AI状态的启用变成禁用。如果AI状态已经为禁用的，该按钮为绿色启用击则把AI状态变成启用。单条或批量启禁用，提示文本如流程工单AI配置里的启禁用。 删除：点击则弹出删除的提示弹窗，确定后则删除该资产。
数据同步更新	系统定时自动同步：如果是已经被添加进来的资产，每次资产业务编辑、删除该资产，均同步更改资产数据到资产资源配置页面。如果资产业务该资产被删除或已被报废，那这个对应的资产就也被删除。AI别名、权重、AI启用状态禁止被自动同步覆盖。 手动更新同步：点击操作列重新同步按钮，交互效果如上。

引入流程工单

1. 点击引入资产的按钮，弹出从业务中台引入资产资源的弹窗

分类	说明
数据源	列表数据来自于资产台账中空间位置在左侧物理空间树下的资产，需过滤掉"已引入当前系统"的资产（通过资产编码去重）。
筛选条件	支持按照资产类型、资产名称、资产编码进行查询。
提示文本	当前选中空间**{左侧物理空间选项}下共条结果|已选择**项资产。
清空所选	点击清空所选按钮，则清空勾选项
列表字段	勾选框、资产类型、资产名称、资产编码、资产标准型号、资产存放位置。
确定引入后的提示	点击确定引入的按钮后，显示提示弹窗 "已成功引入{X} 条资产数据，失败{y}条"

批量操作

1. 支持与勾选项，配合使用批量删除、批量启用、批量禁用、批量配置权重等操作。

分类	说明
删除	点击操作列表里的删除的按钮，弹出删除的提示弹窗，提示文本： "您正在移除流程 {资产名称}（{资产标识符}）。 此操作将彻底清除该资产在AI系统中的所有语义配置（别名、权重）。 注意：此操作不可撤销。" 勾选列表前面的多选框，再与批量操作里的批量删除按钮配合使用，则弹出批量删除的提示弹窗，提示文本： "您正在批量移除 {勾选数量} 条资产。此操作将导致AI无法匹配中这些资产，现有的配置也将清空不再保存。" 点击确认移除，则移除资产向量知识库里的这些资产。点击取消则关闭弹窗不删除。
批量配置权重	需先勾选多选组件，才可点击该操作。点击"批量操作"下拉菜单中的"批量配置权重"。弹出如下弹窗。 顶部信息提示：展示当前选中的资产总数。文案："当前选中 {count} 条资产"。 权重滑动条：范围：0.0 ~ 1.0。步长：0.1。默认值：0.5。 数值：右上方实时显示当前选取的数字，精确到小数点后1位。 确定按钮：点击后，对所有选中的资产 ID 进行批量更新。更新成功后关闭弹窗并弹出提示文本"已成功设置 {X} 条资产数据的权重，失败 {y} 条"

资产配置

1. 点击资产列表操作列的"配置"按钮。弹出如下资产配置右抽屉弹窗。

类型	说明
触发方式	点击资产列表操作列的"配置"按钮，弹出资产配置的弹窗。
状态标签	根据当前资产状态显示 启用 或 禁用。
关闭按钮	点击右上角叉的图标或点击取消的按钮，则直接关闭右抽屉弹窗。
资产基础信息	全部从中台同步，此区域不可编辑。显示资产名称、资产编码、资产类型、标准型号、存放位置、计量单位。文本若超过单行，自动换行展示。不要挤压其他字段。
语义权重	滑动条，数据范围（0-1.0），单位 0.1，即每次滑动都是0.1作为一格去变更。右上角实时显示当前的权重数据。
语义别名/俗名	默认提示文本"请输入，并按回车添加"。 在输入框内输入文字，按"回车 (Enter)"键生成 Tag。点击 Tag 上的 "×" 符号移除该别名。 字符限制和防重的交互逻辑请参考空间资源管理和设备资源管理。如果他们没有，那这里也不加额外逻辑。
提示信息	在底部显示灯泡图标提示："提示：添加俗称有助于 AI 在工单语境中更精准地定位资产。"
保存	点击保存，则保存资产相关配置信息。 如果中台在同步时删除了该资产，而用户正在配置，点击"保存"时应提示：保存失败，该资产已被移除。并关闭右抽屉弹窗。

资产实体基础表

字段	类型	必填	说明
id	UUID	Yes	AI系统主键
iot_ref_id	String	Yes	资产台账原始id
type	Enum	Yes	Asset
ai_status	Enum	Yes	ACTIVE、DISABLED
base_weight	Float	Yes	默认0.5
aliases	Json	Yes	字符串组["别名1"，"别名2"]
	String	Yes	资产类型
	String	Yes	资产名称
	String	No	标准型号
	String	Yes	存放位置
	String	No	品牌
	String	Yes	计量单位