跳到主内容

v0.47.0 版本说明

版本说明

EnerOS v0.47.0 版本说明

  • 发布日期:2026-07-05
  • 版本代号:Convergence
  • 中文名:能枢OS
  • 支持状态:稳定(Stable),当前最新版本
  • Crate 总数:56
  • 测试用例数:7300+
  • 贡献者:32 人

版本概述

EnerOS v0.47.0 是「成熟优化」阶段的收官版本,代号 Convergence(收敛)。聚能以枢,驱动万物智能——本版本将前六个版本积累的性能基准、安全审计、开发者体验、文档系统、生态扩展与稳定性增强成果进行全面收敛,完成品牌形象的统一与文档站点的最终定型。

v0.47.0 不是一个功能密集型版本,而是一个收敛与打磨版本。本版本的核心工作集中在四个方向:品牌形象统一(LOGO 更新、中文名「能枢OS」启用)、文档系统完善(SenseNova 风格、Mimo 设计语言)、主页重构与视觉规范统一(三栏布局居中、代码块黑色背景加复制按钮)、以及工程指标的最终达标(56 个 Crate、7300+ 测试用例)。

经过从 v0.41.0 到 v0.47.0 共七个版本的迭代,EnerOS 已从「架构完备」走向「工程成熟」,具备了进入 v0.48.0 长期支持(LTS)候选阶段的条件。v0.47.0 是 0.x 系列的收敛点,也是 1.0 的起跑线。

核心口号

聚能以枢,驱动万物智能。

能枢OS 将电力系统的能量(Energy)汇聚于智能体操作系统之枢纽(Hub),以原生智能体架构驱动万物互联的智能电网。LOGO 以六边形电网节点为基本元素,象征电网的拓扑结构与智能体的节点化设计。

关键数据

指标数值说明
Crate 数量56全部用 Rust 实现
测试用例7300+单元 + 集成 + 端到端 + 压力
代码行数26 万不含生成代码
文档页面380+中英双语
测试覆盖率84%核心模块 92%+
文档站点首屏< 0.6sCDN 加速
连续运行168 小时无退化、无泄漏
认证插件24 个8 家合作伙伴

新特性

1. 品牌形象统一

本版本完成 EnerOS 品牌形象的全面统一,包括 LOGO 更新、中文名启用与视觉规范定稿。

LOGO 设计

LOGO 以六边形电网节点为核心元素。六边形是自然界中最高效的密铺结构,也是电网拓扑中常见的连接模式。每个六边形代表一个电网节点(母线),多个六边形的密铺代表电网的拓扑连接。LOGO 采用电光蓝(#0066FF)与能量橙(#FF6600)双色,分别代表电力与智能。

六边形电网节点 LOGO 设计要素:

  形状:六边形密铺(蜂窝结构)
  主色:电光蓝 #0066FF(电力)
  辅色:能量橙 #FF6600(智能)
  字体:Inter(英文)+ 思源黑体(中文)
  中文名:能枢OS
  英文名:EnerOS

中文名启用

正式启用中文名「能枢OS」。「能」代表能源与能力,「枢」代表枢纽与中枢。能枢OS 即「能源之枢纽,智能之中枢」,精准概括了 EnerOS 作为电力与能源领域原生智能体操作系统的定位。

// 品牌信息配置
use eneros_branding::{Brand, BrandConfig};

let brand = Brand::new(BrandConfig {
    name_en: "EnerOS",
    name_zh: "能枢OS",
    tagline_zh: "聚能以枢,驱动万物智能",
    tagline_en: "Energy Hub, Driving Intelligent Everything",
    logo: "assets/logo-hexagon.svg",
    primary_color: "#0066FF",
    secondary_color: "#FF6600",
    version: "v0.47.0",
});

2. 文档系统完善(SenseNova 风格)

文档站点在 v0.44.0 重构的基础上,参照 SenseNova 风格进行视觉打磨与信息架构优化。整体风格更趋简洁、专业、科技感,强调内容的可读性与导航的高效性。

视觉规范

元素规范说明
主色调#0066FF(电光蓝)品牌主色
辅助色#FF6600(能量橙)强调与高亮
背景色#FFFFFF / #0D1117明暗模式
代码块背景#0D1117(黑色)统一深色
正文字体思源黑体 / Inter中英双语
代码字体JetBrains Mono等宽
圆角8px统一圆角
间距8px 基准8 的倍数

代码块黑色背景与复制按钮

所有代码块统一采用黑色背景(#0D1117),配以语法高亮。每个代码块右上角附带复制按钮,点击后一键复制代码内容到剪贴板。

// 代码块组件(React)
import { useState } from 'react';

export function CodeBlock({ code, language }: CodeBlockProps) {
  const [copied, setCopied] = useState(false);

  const handleCopy = async () => {
    await navigator.clipboard.writeText(code);
    setCopied(true);
    setTimeout(() => setCopied(false), 2000);
  };

  return (
    <div className="code-block" style={{ background: '#0D1117' }}>
      <div className="code-header">
        <span className="code-lang">{language}</span>
        <button className="copy-btn" onClick={handleCopy}>
          {copied ? '已复制' : '复制'}
        </button>
      </div>
      <pre><code className={`language-${language}`}>{code}</code></pre>
    </div>
  );
}

SenseNova 风格要点

  • 首页采用大留白与居中布局,突出品牌口号与核心价值
  • 卡片式信息展示,每张卡片有清晰的标题、图标与描述
  • 渐变色装饰线条,从电光蓝过渡到能量橙
  • 文档页面采用三栏布局,左中右统一居中对齐
  • 暗色模式默认开启,代码块始终为黑色背景

3. 主页重构(Mimo 设计语言)

主页参照 Mimo 设计语言进行全面重构。Mimo 强调「极简、聚焦、呼吸感」,通过大留白、克制的色彩与清晰的层级关系,让用户在 3 秒内理解 EnerOS 的核心价值。

主页结构

主页布局(Mimo 设计语言):

1. Hero 区域
   - 品牌口号:聚能以枢,驱动万物智能
   - 副标题:面向电力与能源领域的原生智能体操作系统
   - CTA 按钮:快速开始 / 查看文档

2. 核心特性区
   - 4 张卡片:Power-Native 内核 / 双执行架构 / 约束即法律 / Agent-as-Grid-Node
   - 每张卡片含图标、标题、描述与「了解更多」链接

3. 性能数据区
   - 关键指标:56 Crate / 7300+ 测试 / < 1ms 实时延迟 / 99.999% 可用性
   - 数字滚动动画

4. 生态展示区
   - 合作伙伴 LOGO 墙
   - 应用市场入口

5. 版本更新区
   - 最新版本 v0.47.0 高亮
   - 版本时间线缩略图

6. 页脚
   - 文档链接 / 社区 / 联系方式

三栏布局统一居中

文档页面采用三栏布局:左侧导航栏、中间正文区、右侧目录栏。三栏在最大宽度 1440px 的视口中统一居中对齐,正文区最大宽度 800px,保证最佳阅读体验。

/* 三栏布局样式 */
.doc-layout {
  display: grid;
  grid-template-columns: 280px minmax(0, 800px) 240px;
  max-width: 1440px;
  margin: 0 auto;
  gap: 32px;
  padding: 0 32px;
}

.doc-content {
  max-width: 800px;
  margin: 0 auto;
}

/* 响应式:小屏隐藏侧栏 */
@media (max-width: 1024px) {
  .doc-layout {
    grid-template-columns: 1fr;
  }
  .doc-sidebar, .doc-toc {
    display: none;
  }
}

4. 工程指标达标

v0.47.0 达成了 0.x 系列的全部工程指标,为 1.0 候选阶段做好准备。

最终指标一览

指标v0.40.0(起点)v0.47.0(当前)增长
Crate 数量4256+14
测试用例5400+7300++1900
代码行数18 万26 万+8 万
测试覆盖率78%84%+6%
文档页面120+380++260
认证插件024+24
合作伙伴08+8
解决方案模板015+15
应用市场应用042+42

Crate 全景

eneros 工作区(56 个 crate):

内核层(12 个):
  eneros-core · eneros-topology · eneros-powerflow · eneros-constraint
  eneros-equipment · eneros-timeseries · eneros-os · eneros-syscall
  eneros-rt · eneros-safety · eneros-shmem · eneros-arch

Agent 层(8 个):
  eneros-agent · eneros-reasoning · eneros-memory · eneros-tool
  eneros-orchestrator · eneros-react · eneros-toolchain · eneros-sandbox

服务层(10 个):
  eneros-api · eneros-gateway · eneros-dashboard · eneros-cli
  eneros-config · eneros-auth · eneros-tenant · eneros-ha
  eneros-trust · eneros-compliance

领域层(10 个):
  eneros-scada · eneros-i61850 · eneros-i104 · eneros-modbus
  eneros-mqtt · eneros-iot · eneros-twin · eneros-forecast
  eneros-dispatch · eneros-protection

生态层(8 个):
  eneros-marketplace · eneros-plugin-sdk · eneros-eco
  eneros-docs · eneros-branding · eneros-web · eneros-stress
  eneros-benchmark

工具层(8 个):
  eneros-dev · eneros-debug · eneros-audit · eneros-build
  eneros-codegen · eneros-macros · eneros-test-utils · eneros-profiler
// 工程指标统计
use eneros_build::metrics::{WorkspaceMetrics, MetricReport};

let metrics = WorkspaceMetrics::scan("./").await?;

let report = MetricReport::new()
    .crate_count(metrics.crates.len())          // 56
    .test_count(metrics.tests.len())            // 7300+
    .loc(metrics.lines_of_code())               // 260,000
    .coverage(metrics.coverage())               // 84%
    .doc_pages(metrics.doc_pages())             // 380+
    .certified_plugins(metrics.plugins())       // 24
    .partners(metrics.partners())               // 8
    .solution_templates(metrics.templates());   // 15

report.render("reports/v0.47-metrics.md")?;

改进优化

文档站点性能

文档站点首屏加载时间从 0.8s 降至 0.6s,通过以下优化:

  • 静态资源全面启用 Brotli 压缩
  • 图片自动转换为 WebP 格式
  • 字体采用 subset + preload 策略
  • 关键 CSS 内联,非关键 CSS 延迟加载

搜索体验

全文搜索增加搜索建议与历史记录,搜索结果按相关性排序并高亮匹配关键词。

暗色模式完善

暗色模式覆盖全部页面与组件,代码块在两种模式下均保持黑色背景,确保代码可读性一致。

移动端适配

全部文档页面完成移动端响应式适配,在小屏幕设备上自动切换为单栏布局,导航与目录折叠为抽屉式菜单。

Bug 修复

  • BG-801:主页在 Safari 下渐变色渲染异常,已修复 CSS 兼容性
  • BG-805:代码块复制按钮在 HTTPS 下被剪贴板权限阻止,已增加降级方案
  • BG-809:三栏布局在 1280px 宽度下右侧栏溢出,已调整断点
  • BG-813:LOGO 在深色背景下对比度不足,已增加描边
  • BG-817:中英双语切换后部分页面未刷新,已修复缓存策略
  • BG-821:文档目录在长文章中超出视口,已改为 sticky + 滚动

破坏性变更

本版本无运行时破坏性变更。以下为文档与品牌相关的变更:

BC-261:文档 URL 最终定型

文档 URL 结构在 v0.44.0 变更的基础上最终定型,移除了所有遗留的重定向规则。从 v0.47.0 起,URL 结构为:

  • 最新版本:/docs/xxx
  • 历史版本:/docs/v0.XX/xxx

BC-262:品牌资源路径变更

品牌资源(LOGO、字体、配色)的文件路径从 /static/brand/ 迁移至 /static/assets/brand/

依赖升级

依赖旧版本新版本说明
astro4.54.8文档站点框架
starlight0.150.18文档主题
react18.218.3前端框架
tailwindcss3.43.4.4CSS 框架

升级指南

从 v0.46.0 升级

本版本无运行时破坏性变更,升级过程简单:

cargo update
cargo test --workspace

更新文档站点:

cd eneros-web
npm install
npm run build

验证品牌资源:

eneros-cli brand verify --assets

从更早版本升级

如从 v0.43.0 或更早版本升级,请按顺序逐版本升级:

  1. 升级到 v0.44.0(处理文档工具链变更)
  2. 升级到 v0.45.0(处理插件 SDK 变更)
  3. 升级到 v0.46.0(处理资源限额配置变更)
  4. 升级到 v0.47.0(当前版本)

每个版本的详细升级指南请参阅对应版本的发布说明。

版本阶段总结

v0.47.0 标志着「成熟优化」阶段(阶段五)的完成。下表汇总了该阶段七个版本的核心贡献:

版本代号日期核心贡献
v0.41.0Bench2026-06-22性能基准测试体系
v0.42.0Audit2026-06-25安全审计与漏洞扫描
v0.43.0DevEx2026-06-27开发者体验与工具链
v0.44.0Docs2026-06-29文档系统重构
v0.45.0Eco2026-07-01生态扩展与应用市场
v0.46.0Stable2026-07-03稳定性增强与内存修复
v0.47.0Convergence2026-07-05品牌收敛与文档定型

下阶段预览

v0.48.0 将进入「长期支持候选」阶段(阶段六),预计 2026-08 发布。主要方向包括:

  • API 冻结:标记 stable API,承诺长期兼容
  • 性能基线锁定:确定 1.0 的性能基线
  • 安全认证完成:完成等保三级与 IEC 62443 SL-3 认证
  • 文档冻结:1.0 候选文档定稿
  • LTS 预告:公布 LTS 支持政策

1.0.0 预计在 v0.50.0 后正式发布。

相关文档