访问类型	URL 格式	说明
Web 访问	`http://[서버IP]/` (端口 80)	用户与管理员使用相同地址 — 根据登录账户的角色显示不同菜单

浏览器	建议
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 上使用后，请务必在离开前显式登出。
离开座位时，建议锁定屏幕或登出。

登录失败应对

界面上显示的失败信息 仅有两种。

界面显示原文	触发时机	处理措施
登录失败请再次确认账号或密码。	账号错误 · 密码错误 · 账户不存在 — 以上三种情况均显示此条	重新输入账号、密码。检查 Caps Lock 状态
登录尝试过多 (`N` 秒后重试)	短时间内连续失败被封锁时 (HTTP 429)	等待指示的秒数后重试

不区分是账户不存在还是密码错误

无论哪种情况都显示相同文案。这是特意设计的 — 如果提示信息不同，攻击者可以通过尝试得知「此账号存在」(账户枚举)。因此，请勿通过此消息推测「账号正确但密码错误」。

封锁阈值 — 为默认值，可在 plantpulse-engine.properties 中修改。

键	默认值	含义
`engine.session.bruteforce.enabled`	`true`	是否使用封锁功能
`engine.session.bruteforce.ip_limit`	`30`	单个 IP 在时间窗口内允许失败次数
`engine.session.bruteforce.user_limit`	`10`	单个账号在时间窗口内允许失败次数
`engine.session.bruteforce.window.seconds`	`300`	时间窗口长度(秒)。也可在 `Retry-After` 中配置

若部署多个 WAS，其实际阈值将随之增加

计数器存储在 节点内存 中，节点间不共享。若有 N 个节点，实际阈值为 limit × N。目前尚未引入共享计数器 (Redis)。

非消息类异常 — 不在界面弹出文案，仅通过行为体现。

场景	表现	处理措施
会话过期	无文案直接返回登录页面	重新登录
无法连接服务器	浏览器的连接失败页面	检查服务器 IP、端口及运行状态

以上两条消息的原文为 login.text.login_error · login.text.login_error_msg · validation.login.too_many_attempts，将根据用户语言进行显示。

登出

通过顶部页眉右侧的 用户图标 即可进行登出。

方法	位置	动作
用户菜单 → 登出	点击右上角用户图标 → 下拉菜单	与个人资料、密码修改菜单并列，以红色文本显示

登出后，自动登录 Cookie 同样失效。

会话管理

项目	说明
会话有效期	默认为 30 分钟 (可根据管理员设置更改)
自动登出	有效期内无活动则会话自动过期 → 跳转至登录页面
并发登录	允许同一账号在多个浏览器同时登录
会话更新	有活动 (点击, 页面跳转, API 调用) 时自动更新有效期
自动登录令牌	存储在独立 Cookie 中 — 即使会话过期，只要自动登录令牌有效，下次访问即可自动认证

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

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

角色	界面标注	说明
ADMIN	系统管理员	负责整体运行、设置、安全、系统管理
API	API 开发人员	用于外部系统联动的账号。需同时授予安全策略
USER	一般用户	以查询为主，无修改权限

菜单根据角色而异

左侧菜单显示的项取决于角色的安全策略。即使菜单可见，其内部的保存、删除、控制等操作权限仍会进一步区分 — 请参阅权限与菜单可见性。

MANAGER 是 «无法授予但服务器识别» 的角色

在用户注册界面的角色选项中没有 MANAGER，存储路径也仅接收 ADMIN·API·USER 这三种。但在服务器的访问控制中 MANAGER 依然存在 — 设备命令的执行权限、标签·连接·报警界面的写入按钮显示条件均被设定为 «ADMIN 或 MANAGER»。

由于 POST /api/v5/user 不检查角色值，因此可以通过 API 填入 MANAGER。请勿执行此操作。登录后的跳转分歧仅有 «ADMIN·API → 仪表盘, USER → 共享界面» 两种，因此 MANAGER 账号即使登录成功，也无法跳出加载界面。

若想赋予中间管理人员部分权限，请使用 安全策略 而非角色 → 安全管理。

完整菜单列表

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

如需更改角色，请向系统管理员申请。详细的角色权限请参考安全管理页面。

登录后主界面构成

登录完成后，将短暂经过 会话加载界面 (带有旋转 Logo 的进度条)，然后根据 角色进入不同的界面。

角色	进入界面
ADMIN · API	仪表盘 (`/map/index`)
USER	共享界面 (`/share/index`) — 通过安全策略共享的 Canvas 列表

USER 不进入仪表盘

使用 USER 角色登录后，首先弹出的是 共享界面 而非控制台侧边菜单。该界面简洁，仅包含 Logo、标题(«共享»)和登出按钮，已共享给该用户的 Canvas 以卡片形式排列，页眉显示 «共 N 个》。此界面专为现场只读账号设计。

关于分享 Canvas 的设置，请参阅 Canvas 的共享设置面板与安全管理。

以下以 ADMIN 为基准，介绍所有页面共用的顶部页眉和左侧侧边菜单。

顶部页眉 — 左侧

顶部页眉左侧显示三个元素：侧边品牌 Logo + 侧边菜单切换 + 域 ID 统一检索。

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

EQL 输入框不再显示在顶部页眉。请在 CEP 菜单的专用界面中编写 EQL。

域 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/config/index`) · 报警分析(`/alarm/analysis/index`) · 报警性能(`/alarm/performance/index`)
🎨	Visualization	`/canvas/index`	Canvas
🔀	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. 登录后一直停留在 Logo 旋转的 «加载» 界面，无法进入。 A. 可能是因为该账号的角色不属于 ADMIN·API·USER 之一。登录后的跳转分歧仅处理这三种角色。如果通过 API 填入了 MANAGER 之类的角色值，请将其修改为上述三种角色之一 (参考用户角色与权限)。

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 分钟以上，请咨询系统管理员。更详细的监控请结合仪表盘右侧的 Health Rail 与系统监控界面共同确认。

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

基准站点

在个人资料中设定 基准站点 后，检索 · 模型界面将默认打开该站点。若未设定，则打开第一个站点。

界面打开站点的顺序为：URL 参数站点 → 基准站点 → 第一个站点。最后选择的范围不会被记录。删除站点后，基准站点将被清空。此项不适用于 V5 · MCP。

登录

目录

概览

访问方法

支持的浏览器

登录界面 — 输入字段

登录进度显示

登录步骤

自动登录

运行原理

安全建议

登录失败应对

登出

会话管理

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

完整菜单列表

登录后主界面构成

最新控制台导航文档

顶部页眉 — 左侧

域 ID 统一检索对话框

可检索域与颜色

检索结果使用

顶部页眉 — 右侧工具

LIVE 圆点含义

报警徽章显示规则

左侧侧边菜单

左侧下角系统性能栏

移动端访问

移动端提供的主要功能

常见问题

基准站点

相关界面

目录​

概览​

访问方法​

支持的浏览器​

登录界面 — 输入字段​

登录进度显示​

登录步骤​

自动登录​

运行原理​

安全建议​

登录失败应对​

登出​

会话管理​

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

完整菜单列表​

登录后主界面构成​

最新控制台导航文档​

顶部页眉 — 左侧​

域 ID 统一检索对话框​

可检索域与颜色​

检索结果使用​

顶部页眉 — 右侧工具​

LIVE 圆点含义​

报警徽章显示规则​

左侧侧边菜单​

左侧下角系统性能栏​

移动端访问​

移动端提供的主要功能​

常见问题​

基准站点​

相关界面​

目录

概览

访问方法

支持的浏览器

登录界面 — 输入字段

登录进度显示

登录步骤

自动登录

运行原理

安全建议

登录失败应对

登出

会话管理

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

完整菜单列表

登录后主界面构成

最新控制台导航文档

顶部页眉 — 左侧

域 ID 统一检索对话框

可检索域与颜色

检索结果使用

顶部页眉 — 右侧工具

LIVE 圆点含义

报警徽章显示规则

左侧侧边菜单

左侧下角系统性能栏

移动端访问

移动端提供的主要功能

常见问题

基准站点

相关界面