访问类型	URL 格式	说明
标准 Web 访问	`http://[서버IP]/` (端口 80)	一般用户使用的主控制台
管理控制台	`http://[서버IP]:7500/`	面向系统管理员(ADMIN)的独立管理控制台

浏览器	推荐度
Chrome	推荐 — 最为稳定
Microsoft Edge	推荐
Firefox	可用
Safari	可用

┌──────────────────────────────────────────────┐
│                                              │
│              [PlantPulse 로고]                │
│                                              │
│              플랜트펄스 플랫폼                 │
│                                              │
│  [ 아이디 또는 이메일 주소         ]          │
│  [ 비밀번호                       ]          │
│                                              │
│  ☐ 세션이 유효할 시, 자동 로그인              │
│                                              │
│  ┌──────────────────────────────┐             │
│  │           로그인              │             │
│  └──────────────────────────────┘             │
│                                              │
│         📱 모바일버전으로 접속                 │
│                                              │
└──────────────────────────────────────────────┘

输入项	字段名	形式	placeholder / 标签	说明
账号或邮箱	`userId`	文本输入	"账号或邮箱地址"	已分配的用户 ID 或邮箱
密码	`password`	密码输入(掩码)	"密码"	个人密码
自动登录	`auto_login`	复选框 (值 `true`)	"会话有效时自动登录"	下次访问时跳过登录步骤
登录按钮	(`#bt`)	大按钮 (form submit)	"登录"	点击或按 Enter 键提交
移动端访问	(链接)	文本 + 移动图标	"以移动版访问"	跳转至 `/m/` 移动端界面

登录进度显示

点击登录按钮后，表单会暂时隐藏并显示加载提示。

   ⟳ (회전)
  로그인 중...

收到服务器响应后会自动跳转至主界面。

登录步骤

第 1 步 — 在账号/邮箱输入框中输入已分配的用户 ID 或邮箱。

第 2 步 — 在密码输入框中输入密码。输入内容会自动被掩码显示(•••••)。

第 3 步(可选) — 若希望下次访问时跳过登录步骤，请勾选 自动登录 复选框。

第 4 步 — 点击登录按钮或按键盘 Enter 键。

初次安装时的默认管理员账号为 admin / admin123!。出于安全考虑，请在登录后立即修改密码。

自动登录

勾选登录界面的 会话有效时自动登录 复选框后，下次访问时将跳过登录步骤。

工作原理

自动登录将令牌保存在 浏览器 Cookie 中，下次访问时自动认证
仅在 Cookie 有效期内生效 — 删除浏览器 Cookie、使用隐身模式或更换浏览器时需重新登录
显式注销后 Cookie 会失效，自动登录随之解除

安全建议

请勿在 公用 PC 上使用自动登录
若已在 公用 PC 上使用，用完后务必显式注销
离开座位时建议锁屏或注销

登录失败时的处理

情况	界面提示	处理措施
ID 或密码错误	"登录信息不正确"	确认 ID/密码后重新输入
账号锁定	失败次数超限时临时锁定	稍后重试或请系统管理员解锁
会话过期	自动跳转至登录页	重新登录
页面加载失败	浏览器无法连接服务器	确认服务器 IP/端口，并请系统管理员确认服务器是否运行
违反密码策略	提示"违反密码策略"	查看安全管理中的密码策略

登录失败消息以系统消息代码 login.text.login_error / login.text.login_error_msg 处理，在多语言环境下会按用户语言显示。

注销

点击顶部标题栏右侧的 用户图标 即可注销。

方式	位置	行为
用户菜单 → 注销	点击右上角用户图标 → 下拉菜单	与个人资料、修改密码菜单一同以红色文字显示

注销后，自动登录 Cookie 也会失效。

会话管理

项目	说明
会话有效时长	默认 30 分钟(可由管理员设置更改)
自动注销	有效时长内无操作则会话自动过期 → 跳转至登录页
并发登录	同一账号可在多个浏览器同时登录
会话续期	有操作(点击、页面跳转、API 调用)时自动续期
自动登录令牌	保存在独立 Cookie 中 — 即使会话过期，只要自动登录令牌有效，下次访问时仍可自动认证

用户角色(ADMIN/API/USER)与权限

平台角色由系统管理员在安全管理 > 用户界面设置，共三种。

角色	界面标识	说明
ADMIN	系统管理员	全部运维、设置、安全与系统管理
API	API 开发者	用于外部系统集成的账号。需同时授予安全策略
USER	一般用户	以查询为主，无变更权限

菜单与角色无关，三者完全相同

左侧菜单列表对三种角色显示完全一致。权限差异体现在 界面内部 — 即使可以打开菜单，保存、删除、控制等操作也可能因角色和服务器安全策略而被阻止。

全部菜单列表

分组	子菜单
Overview	仪表板·每日统计
Connectivity	协议·连接状态·Edge
Factory Model	模型·资产·标签·本体·元数据·基准信息
Production	客户·产品·员工·排班表·工单
Equipment	设备列表·数据查询·时间线对比
ISO	ISO 数据·ISO 分析
Data	流·趋势·快照·数据导出·对象(BLOB)
Alarm	报警·报警高级检索·报警可视化分析·高级 EQL 报警
Visualization	画布
Automation	流程·流程执行历史·EQL 查询·语句
Standard	命名空间·目录·OPC-UA·AAS V3
System	用户·安全策略·API 令牌·监控·诊断·日志·集群·HA·审计·设置·环境信息

如需变更角色，请联系系统管理员。各角色的详细权限请参阅安全管理页面。

登录后主界面构成

登录完成后会自动跳转至仪表板。下面一并介绍所有页面通用的顶部标题栏与左侧边栏菜单。

顶部标题栏 — 左侧

顶部标题栏左侧显示 侧边品牌 Logo + 侧边菜单切换 + 域 ID 综合搜索 三个元素。

元素	位置	行为
PlantPulse Logo	侧边栏头部(最左侧深色区域)	点击跳转至仪表板 (`/map/index`)
侧边菜单切换(☰ 缩进图标)	Logo 右侧	折叠/展开左侧边栏菜单(同时整理展开宽度)
域搜索按钮	切换按钮右侧(宽幅)	🔍 + "域搜索" + 提示文本 + `CTRL+K` 标签 — 点击或按键盘 `Ctrl+K` (Mac `⌘+K`) 立即打开对话框

EQL 输入框已不再显示于顶部标题栏。EQL 编写请在 CEP 菜单内的专用界面中进行。

域 ID 综合搜索对话框

可通过顶部搜索按钮或 Ctrl+K (Mac ⌘+K) 快捷键在任意位置调出。无论当前焦点位于何种输入框/编辑器，均以最高优先级拦截并打开对话框。

对话框构成(自上而下):

区域	显示内容
头部	🔍 "域 ID 综合搜索"标题 + 关闭(×)
搜索框 (`ds-q`)	单一输入框 — ID/名称/描述中任意位置包含即可命中
域标签(过滤器)	域过滤器 — 点击仅显示单一域。各标签同时显示当前结果条数
最近搜索行	最近搜索的关键词标签 — 点击后以该关键词重新搜索
结果表格	按域着色的徽章 + ID(点击复制到剪贴板) + 名称 + 跳转至详情界面的操作按钮
页脚	分页 + 结果数显示

可搜索的域与颜色

徽章	域	颜色
SITE	站点	🟦 青绿
AREA	区域	🟩 深绿
LINE	产线	🟢 绿
EQUIPMENT	设备(资产)	🟢 亮绿
TAG	标签	🟡 芥黄
OPC	OPC 数据源	🟣 紫
EDGE	Edge 网关	🟦 青绿2
ALARM_CONFIG	报警定义	🔴 红
USER	用户	🔵 藏青
EMPLOYEE	员工	🟠 橙
SECURITY	安全策略	🟣 紫
CUSTOMER	客户	⚫ 石板灰
PRODUCT	产品	🔵 蓝
FLOW	流程	🟣 紫罗兰

搜索结果的使用

点击 ID 单元格 → 将 ID 复制到剪贴板(对话框不会关闭)
跳转详情操作 → 跳转至各域的详情页(例如 EDGE → /edge/view/{id}，EQUIPMENT → 资产树)
点击域标签 → 仅过滤该域

顶部标题栏 — 右侧工具

右上角工具栏图标按 从左到右顺序 如下(全面改版后顺序与图标已明确整理)。

序号	图标	含义	点击行为
1	🟢 LIVE(圆点 + 文本)	实时推送(WebSocket)连接状态 — 圆点脉冲闪烁表示正常	下拉 — 📡 连接说明 + WebSocket 地址 + 当前时间
2	🔔 报警铃 + 红色徽标	最近接收的报警计数(100 条以上以 `99+` 封顶)	下拉 — 最近报警预览 + "跳转至报警菜单"页脚链接
3	📺 TV(全屏)	浏览器全屏切换	点击即切换(无下拉)
4	⚙ 设置	界面环境设置	界面缩放、报警弹窗、诊断日志显示设置
5	📖 书(手册)	新窗口打开手册	在新标签页打开本 GitBook 手册 (`https://kopens.gitbook.io/plantpulse-platform`)
6	👤 用户(最右侧)	登录用户菜单	下拉 — 大头像·用户名 + 个人资料 / 修改密码 / 注销

💡 用户菜单中的注销始终以 红色文字 显示 — 用于防止误操作的视觉提示。

LIVE 圆点的含义

显示	含义
🟢 圆点脉冲(闪烁)	WebSocket 连接正常，正在接收实时数据
🔘 圆点为灰色或静止	WebSocket 断开 — 刷新页面尝试重连
下拉右侧时钟 (`current-time`)	每秒刷新的服务器时间 — 若停止即为 WS 断开的信号

报警徽标显示规则

计数	显示
0	`0` (小号显示)
1~99	对应数字
100 以上	`99+` — 节省界面宽度

报警下拉中按时间倒序显示最近 N 条报警标题，可通过"跳转至报警菜单"页脚链接进入报警菜单查看完整列表。

左侧边栏菜单

左侧边栏根据用户角色显示菜单(参见上文各角色菜单差异)。以 ADMIN 角色为准如下。

图标	菜单	URL	子菜单
🌐	仪表板	`/map/index`	OVERVIEW
📊	每日统计	`/statistics/index`	OVERVIEW
🔌	Connectivity	(多个)	协议(`/connect/index`) · 连接状态(`/connect/status`) · Edge(`/edge/index`)
🏭	工厂	(多个)	模型(`/model/index`) · 资产(`/asset/tree/index`) · 标签(`/tag/index`) · 本体(`/ontology/index`) · 元数据(`/metadata/index`) · 基准信息(`/basedata/index`)
⚙️	Production	(多个)	客户(`/customer/index`) · 产品(`/product/index`) · 员工(`/employee/index`) · 排班表(`/calendar/index`) · 工单(`/order/index`)
📺	Equipment	(多个)	设备列表(`/equipment/index`) · 数据查询(`/asset/data/index`) · 时间线对比(`/timeline/index`)
📈	ISO	(多个)	ISO 数据(`/asset/plugin/index`) · ISO 分析(`/analysis/index`)
🗄️	Data	(多个)	流(`/stream/index`) · 趋势(`/storage/index`) · 快照(`/snapshot/index`) · 数据导出(`/data/index`) · 对象(BLOB)(`/blob/store`)
🔔	Alarm	(多个)	报警(`/alarm/index`) · 报警高级检索(`/alarm/advsearch/index`) · 报警可视化分析(`/alarm/analysis/index`) · 高级 EQL 报警(`/alarm/config/index`)
🎨	Visualization	`/canvas/index`	画布
🔀	Automation	(多个)	流程(`/flow/index`) · 流程执行历史(`/flow/log`) · EQL 查询(`/query/index`) · 语句(`/statement/index`)
🌐	Standard	(多个/外部)	命名空间(`/uns/tree`) · 目录(`/catalog/index`) · OPC-UA(:12780) · AAS V3(:8091/ui)
⚙	System	(多个/外部)	用户(`/user/index`) · 安全策略(`/security/index`) · API 令牌(`/token/index`) · 监控(`/monitoring/index`) · 诊断(`/diagnostic/index`) · 日志(`/log/index`) · 集群(`/cluster/index`) · HA(`/ha/index`) · 审计(`/audit/index`) · 设置(`/config/index`) · 环境信息(`/env/view`)

含子菜单的项目会显示 ▼ 箭头图标。点击后展开，点击其他菜单时自动折叠。

左下角系统性能框

左侧菜单下方设有系统性能监控框。

项目	显示
头部	"系统性能" + 切换箭头(展开/折叠)
CPU (`cpu-text`)	当前 CPU 使用率(%) + 1 分钟迷你折线图 (`nav-cpu-sparkline`，高 40px)
内存 (`memory-text`)	当前内存使用量 + 1 分钟迷你折线图 (`nav-memory-sparkline`，高 40px)

在全屏查看模式下该框会被隐藏。

移动端访问

使用移动浏览器(智能手机、平板)访问同一 URL 时，会自动切换至移动端优化界面(/m/)，也可通过登录界面下方的 📱 以移动版访问 链接跳转。

移动端提供的主要功能

仪表板查看
实时报警确认与推送通知
数据点查询
工单状态确认

移动端的详细功能请在移动界面中直接查看。

常见问题

Q. 登录后界面一直白屏。 A. 请确认浏览器是否已连接服务器。若右上角 WS 信号图标为红色，说明实时连接已断开。若刷新(F5)仍无法恢复，请联系系统管理员。

Q. 勾选了自动登录，但每次仍需重新登录。 A. 浏览器阻止 Cookie、使用隐身模式或混用多个浏览器时，自动登录不会生效。请在同一浏览器中允许 Cookie 后使用。

Q. 忘记密码了。 A. 请向系统管理员(ADMIN)申请重置密码。视运行环境可能提供自动重置邮件功能，但标准做法是由管理员重置。

Q. 在其他 PC 登录会导致原会话断开吗? A. 不会。系统允许并发登录。但根据安全策略也可能被设置为仅允许单一会话，请查看安全管理中的安全策略。

Q. 一段时间不操作会自动注销吗? A. 是的，默认 30 分钟无操作会话即过期。若已开启自动登录，下次访问时会自动认证，否则需重新登录。

Q. 顶部的 EQL 输入框不见了。 A. UI 全面改版后，EQL 输入框已移至 CEP 菜单内的专用界面。作为替代，顶部左侧新增了 域 ID 综合搜索 按钮，可在任意界面通过 Ctrl+K (Mac ⌘+K) 调出。

Q. Ctrl+K 快捷键在正在输入的文本框中也有效吗? A. 是的，其设计为以最高优先级拦截。在 EQL 编辑器、代码编辑器中同样有效。正在输入的文本不会自动带入对话框的搜索框，请重新输入要搜索的关键词。

Q. 域搜索中找不到我们的用户 ID。 A. USER 域属于可搜索对象，但 安全策略与 API 令牌 被有意排除在搜索之外。用户一般信息可用 USER 域标签过滤查看，安全标识符请在安全管理界面直接确认。

Q. 报警计数显示为 99+。 A. 表示未处理报警已累计 100 条以上。请点击 🔔 在报警下拉中查看最近条目，或通过"跳转至报警菜单"查看完整列表并进行处理。

Q. LIVE 圆点为灰色或看起来静止。 A. 说明实时推送通道已断开。点击右上角 LIVE → 确认下拉中的"当前时间"是否每秒刷新。若已停止，刷新页面(F5)可重连；若仍断开，请在诊断界面确认服务器模块状态。

Q. 域搜索(CTRL+K)可以搜索什么? A. 可综合搜索站点 ID、资产 ID、标签 ID、工单 ID 等域标识符。点击结果即可立即跳转至对应域的详情界面。

Q. 报警铃图标旁的数字一直不减少。 A. 该数字为最近 N 分钟内的报警数量。时间推移后会自动移出窗口并归零。若希望立即归零，请点击报警铃进入报警菜单并进行确认处理。

Q. 系统性能框中的 CPU 接近 100%。 A. 若为短暂现象，可能属于正常负载。若持续超过 5 分钟，请联系系统管理员。更详细的监控请一并查看仪表板右侧的健康栏与系统监控界面。

Q. 我想折叠左侧菜单。 A. 点击左上角的 ☰ 切换图标即可折叠菜单，再次点击则展开。

登录

目录

概述

访问方式

支持的浏览器

登录界面 — 输入字段

登录进度显示

登录步骤

自动登录

工作原理

安全建议

登录失败时的处理

注销

会话管理

用户角色(ADMIN/API/USER)与权限

全部菜单列表

登录后主界面构成

最新控制台导航文档

顶部标题栏 — 左侧

域 ID 综合搜索对话框

可搜索的域与颜色

搜索结果的使用

顶部标题栏 — 右侧工具

LIVE 圆点的含义

报警徽标显示规则

左侧边栏菜单

左下角系统性能框

移动端访问

移动端提供的主要功能

常见问题

相关界面

目录​

概述​

访问方式​

支持的浏览器​

登录界面 — 输入字段​

登录进度显示​

登录步骤​

自动登录​

工作原理​

安全建议​

登录失败时的处理​

注销​

会话管理​

用户角色(ADMIN/API/USER)与权限​

全部菜单列表​

登录后主界面构成​

最新控制台导航文档​

顶部标题栏 — 左侧​

域 ID 综合搜索对话框​

可搜索的域与颜色​

搜索结果的使用​

顶部标题栏 — 右侧工具​

LIVE 圆点的含义​

报警徽标显示规则​

左侧边栏菜单​

左下角系统性能框​

移动端访问​

移动端提供的主要功能​

常见问题​

相关界面​

目录

概述

访问方式

支持的浏览器

登录界面 — 输入字段

登录进度显示

登录步骤

自动登录

工作原理

安全建议

登录失败时的处理

注销

会话管理

用户角色(ADMIN/API/USER)与权限

全部菜单列表

登录后主界面构成

最新控制台导航文档

顶部标题栏 — 左侧

域 ID 综合搜索对话框

可搜索的域与颜色

搜索结果的使用

顶部标题栏 — 右侧工具

LIVE 圆点的含义

报警徽标显示规则

左侧边栏菜单

左下角系统性能框

移动端访问

移动端提供的主要功能

常见问题

相关界面