Visualization and i18n

中文 | English

可视化与国际化

维护版本：v0.51.2 ｜ 最后更新：2026-07-06

EnerOS v0.46.0 引入可视化与交互增强，v0.47.0 引入国际化与数据隐私合规。本页为特性摘要；完整设计请参阅 ADR-0013 + ADR-0014 + 主仓库 docs/user-manual.md。

可视化能力

DashboardDef 声明式仪表盘

crates/eneros-dashboard 提供声明式仪表盘定义，运维人员通过 TOML/JSON 描述仪表盘布局，由 dashboard 服务渲染：

[[dashboard]]
name = "substation_overview"
title = "变电站总览"
layout = "grid"

[[dashboard.widgets]]
type = "scada_table"
title = "遥测数据"
source = "timeseries"
refresh_ms = 1000

[[dashboard.widgets]]
type = "topology_graph"
title = "电网拓扑"
source = "topology"

3D 可视化（glTF）

crates/eneros-3d 生成 glTF 2.0 资产，用于：

• 变电站三维场景漫游
• 设备空间位置可视化
• 故障点空间定位

支持主流 glTF 查看（Three.js / Babylon.js / CESIUM）。

自然语言意图识别

crates/eneros-nl 提供 8 种电网运维意图识别：

意图	示例查询	解析为
query_status	"查看 110kV 母线电压"	/api/v1/devices?level=110kV&metric=voltage
query_history	"过去 24 小时负荷曲线"	/api/v1/timeseries?range=24h
query_alarm	"当前未确认告警"	/api/v1/alarms?status=unacked
control_device	"合上 521 断路器"	POST /api/v1/devices/521/control
query_topology	"显示变电站一次图"	/api/v1/topology
query_analysis	"潮流计算结果"	/api/v1/analysis/powerflow
query_plan	"日前发电计划"	/api/v1/plans/daily
query_market	"今日现货价格"	/api/v1/market/price

多格式报表

crates/eneros-report 支持生成：

• PDF（高保真打印）
• Excel（数据分析）
• Word（运维报告）

报表模板通过 Jinja-like 语法定义，数据源为 timeseries / audit / analysis 结果。

PWA 与移动端

• PWA 离线访问（Service Worker 缓存）
• 移动端响应式布局
• 移动端手势（缩放 / 拖拽 / 长按）

国际化（i18n）

Fluent i18n

crates/eneros-i18n 使用 Mozilla Fluent 实现 i18n：

locales/
├── en-US/
│   ├── dashboard.ftl
│   ├── errors.ftl
│   └── ...
├── zh-CN/
│   ├── dashboard.ftl
│   ├── errors.ftl
│   └── ...
└── ...

支持语言：英语（en-US）/ 简中（zh-CN）/ 繁中（zh-TW）/ 日语（ja）/ 韩语（ko）/ 俄语（ru）/ 法语（fr）/ 德语（de）。

DL/T 698.45 与 DL/T 645

支持中国电力行业标准协议本地化：

• DL/T 698.45 电表协议（v0.47.0）
• DL/T 645 电表协议（多费率）

数据隐私合规（v0.47.0+）

法规	范围	实现
GDPR	欧盟通用数据保护条例	数据主体权利（访问 / 更正 / 删除 / 可携带）
PIPL	中国个人信息保护法	数据出境安全评估 + 个人信息分类
CCPA	加州消费者隐私法	消费者权利（知情 / 拒绝出售 / 删除）

[privacy]
enable_subject_rights = true
data_residency = "cn"      # cn / eu / us / global
retention_days_pii = 365
allow_cross_border = false

已知限制（v0.51.2）

• DashboardDef 仅支持 grid 与 flex 布局，未支持自由画布
• 3D 资产仅 glTF 静态场景，未支持实时设备状态同步
• NL 意图识别仅关键词匹配，未支持 LLM 真实理解（待与 eneros-ai 集成）
• 报表生成同步阻塞，未支持异步大报表
• 繁中 / 日语 / 韩语等翻译覆盖率不全，待社区贡献

相关文档

• ADR-0013 可视化
• ADR-0014 国际化与隐私
• 多租户 — 多租户隔离下的数据隐私
• 配置参考 — [i18n] / [privacy] 段
• 主仓库 docs/user-manual.md — 用户视角
• 主仓库 crates/eneros-dashboard/ — 源码