虹元连接

虹元是沅虹的数据底座。智建 EPM 通过「虹元连接」和它打通，打通以后有几件事会自动发生：

智建里产生的 NCR（不符合项）、隐患登记与销号、作业票签发放行关闭，带着来源和追踪编号送进虹元，集团层面能按同一个编号查到；
智眸从现场画面里识别出的违章与险情，经虹元推到智建的现场事件核查；
智安（随手拍、智安 HSE）的隐患与作业票经虹元送到智安隐患与作业票只读视图；
智眸按机位定时拍的现场照片进形象进度；
组织与人员以虹元为准，见统一组织与人员；
判定口径（规则、阈值这类）取虹元当前生效的版本。

每个单位只需要登记一次。没登记虹元的单位，智建照常使用，只是上面这些页面没有数据。

打开位置

左侧导航「系统管理 → 虹元连接」。需要 system.user（用户管理）权限，一般只给单位的系统管理员。

界面构成

顶部四张卡

登记成功后页面顶部出现四张卡：

卡片	看什么
订阅登记	已登记 / 未登记，以及最近一次虹元推送、智建拉取的时间
收到智眸事件	累计收到多少条，这些事件进「现场事件核查」
上行	已配对 / 未配对 / 已关闭；下面写着已进虹元多少条、还有多少条待发
当前生效口径	从虹元取回的口径条数和取回时间

连接设置

字段	说明
虹元地址	虹元的访问地址，由实施方提供
虹元管理密钥	首次连接必填。保存以后只显示打码后的样子，不改就留空
智建对外地址	虹元往智建推送时回调的地址，下方会显示完整的回调地址
订阅的智眸事件	要接收的智眸事件类型，逗号分隔。车辆经过这类观测事件不要加
最低等级	低于这个等级的事件不接收，可选不限、低、中、高、紧急
开关	四个勾选项，见下表
节点名	系统自动生成，订阅名和上行节点名用同一个

四个开关：

开关	关掉以后
接收智眸现场事件	现场事件核查不再收新事件
质量与施工安全事件上行	NCR、隐患、作业票不再送进虹元；组织与人员也只取不推
接收智安隐患与作业票（只读）	智安隐患与作业票视图不再更新
接收智眸形象进度照片	形象进度不再收新照片

页面下方还有三块：

上行记录：最近 50 条送往虹元的记录，列出时间、类型（NCR 产生、隐患登记、隐患销号、作业票签发、作业票放行、作业票关闭）、标题、智建里的单据、追踪编号、虹元事件号和状态。没发出去的可以点「重发」。
当前生效口径：取自虹元，每个规则名只留当前生效的最新版本，列出名称、类别、版本、生效时间、来源系统和取回时间。连好以后每十分钟取一次。
模型上报：智建在用的大模型、向量模型和项目健康度打分规则，按虹元模型台账的口径列出台账标识、种类、用途、版本和运行位置。

首次连接（操作步骤）

填好虹元地址、虹元管理密钥，核对智建对外地址。
按需调整订阅的事件类型、最低等级和四个开关。默认全部勾上。
点「保存并登记」。系统会去虹元登记订阅、完成上行配对，并取一次当前生效口径。
页面弹出一段提示，里面有一行推送签名密钥。这行只显示这一次，请复制下来交给虹元的运维人员。虹元配好这把密钥后，才能把事件主动推给智建。
运维配好之前也不会漏事件。智建每分钟会按进度去虹元拉一次。

推送签名密钥只显示一次

离开页面或刷新以后，这一行就不再显示。没来得及复制的，再点一次「保存并登记」，页面会重新给出同一行。

日常检查与处理

检查连接：点「检查连接」，页面会显示虹元的健康状态和订阅进度。
重新配对：虹元那边换了库或者删过节点，上行会被拒绝，页面顶部出现「上行出错」。点「重新配对」，积压的记录会立即补发。
立即取口径：不想等十分钟，点「立即取口径」马上取一次。
地址或密钥变了：改好以后再点「保存并登记」，系统会自动重新配对。
验证是否打通：登记一条隐患，到「上行记录」看它变成「已进虹元」并带上虹元事件号；HSE 安全体系下的「现场事件核查」能看到智眸送来的事件。

模型上报

智建用到的模型（AI 周报和看板解读、设计变更的 AI 辅助录入、文件智能问答）和项目健康度打分规则，要在虹元的模型台账里登记，方便集团统一管理。

运营侧先按「运营侧登记内容」里给出的内容在虹元登记一次，换了模型再登一次。展开这一栏就能看到要提交的内容，许可和评测记录按实际补上。
部署时配好产品服务钥匙以后，智建启动后上报一次，之后每小时一次。卡片右上角显示上报节点，可以点「立即上报」。
没配产品服务钥匙时，页面会提示「模型不上报」，其他功能都不受影响。
最近一次上报的结果显示在表格上方，全部被台账认下时提示为成功。

注意事项与常见问题

「虹元连接」只影响和虹元相关的几项功能。断开或者没登记，智建自己的进度、质量、HSE、文件等模块照常使用。
看到「最近一次登记或拉取出错」「取口径出错」，多半是虹元地址写错或虹元暂时不可用。核对地址后点「检查连接」。
演练或测试环境如果复制了正式环境的连接设置，请先关掉「质量与施工安全事件上行」，免得往正式的虹元里写数据。
关掉上行以后，组织与人员也会变成只从虹元取、不往虹元推。

相关文档