一、简介 ​

openUBMC Studio 是一款基于 Code - OSS 的 openUBMC 集成开发环境，面向 openUBMC 开发、调试和构建场景。

最近版本新增功能 ​

下表按发布时间倒序汇总 openUBMC Studio 最近三个版本的新增功能，单击功能名称可跳转到对应章节。当前收录 2026 年 8 月和 9 月发布的版本；后续发布新版本时，仅保留最近三个版本。

主要特性 ​

openUBMC Studio 的主要特性包括：

• 智能代码辅助：提供代码跳转、定义预览和引用查找等功能。
• 实时错误检查：基于规则集检测代码错误和潜在问题。
• 表达式计算器：支持 CSR 表达式的编写、调试和批量测试。
• SMC 命令字配置：提供可视化的 SMC 命令字解析和配置工具。
• 模型配置：支持产品和规则集的选择与配置。
• CSR 拓扑可视化与调试：支持本地、日志和远程三种整机拓扑模式，提供总线异常检测、单板卡配置、日志包离线还原和真机在位调试。
• 事件管理：支持查看和编辑事件字典、描述模板及 CSR 事件绑定。
• 能效调速配置：支持通过 Excel 导入热设计表格并生成 CSR 调速曲线代码。
• Manifest 可视化配置：支持配置构建变体、组件依赖、默认特性和组件特性，并提供配置诊断。
• 组件与固件联合构建：支持从业务组件仓构建本地组件包，在隔离 Manifest 中验证选包并转入固件出包。
• 一键出包：支持选择机型和包型，完成出包预检、固件构建、日志查看和产物下载。
• 签名配置：支持管理 HPM 和 EEPROM 签名档案，并生成或吊销本地自签名证书。
• AI 引导环境初始化：支持通过 AI Agent 完成社区开发环境初始化。
• 日志诊断与告警链条分析：支持导入 BMC 一键日志进行可视化诊断、Agent 日志体检和告警链条分析。
• C/C++、Lua 与北向接口快速调试：支持按照 Git 变更规划直接部署或隔离构建，将最小替换集部署到 BMC 并验证结果。
• BMC 远程 GDB 调试：支持附加板端服务，或部署独立程序进行源码级调试。
• BMC 环境管理插件：集中管理多台 BMC，支持连接与分组、命令宏、SFTP/HPM 升级和日志监控。
• 白牌包定制：支持可视化定制 Web 风格、Logo、图片和产品信息，并构建白牌包或清白牌包。
• 社区集成：对接 openUBMC 社区资源和服务。

二、AI 引导环境初始化 ​

openUBMC Studio 提供 AI 引导环境初始化能力。将预置 Prompt 发送给 AI Agent（例如 opencode、Claude Code 或 Cursor）后，AI Agent 会检测当前状态、诊断问题，并按顺序引导用户完成社区开发环境初始化。

使用前准备 ​

• 已安装并能正常使用 AI Agent，例如 opencode、Claude Code 或 Cursor。

打开配置引导 ​

1. 在欢迎页面中单击“配置引导”入口。

2. 在打开的配置引导窗口中找到“AI 引导初始化”卡片。

复制引导指令 ​

1. 单击“复制指令”卡片，打开 Prompt 对话框。

2. 单击“复制到 AI Agent”，将 Prompt 复制到剪贴板。

3. 切换到 AI Agent，粘贴并发送 Prompt。

了解 AI 引导流程 ​

AI Agent 接收到 Prompt 后，会按以下流程引导用户完成环境初始化：

1. GitCode 登录认证：AI Agent 打开 OAuth 登录窗口，并在用户授权后检测登录状态。
2. 环境检测与部署：AI Agent 检测操作系统。Windows 用户可以选择 Docker（约 5 分钟）或 WSL（约 30 分钟）部署方式，Linux 用户直接进入环境配置。
3. 规则集配置：AI Agent 引导用户在 openUBMC Studio 界面中选择机型和规则集，并通过 localview_get_data_source 验证配置是否生效。
4. 状态写回：每个步骤完成后，AI Agent 会回写向导状态；全部步骤完成后，向导状态变为“已完成”。

验证初始化结果 ​

1. 确认配置引导窗口显示初始化已完成。

2. 返回欢迎页面，确认状态栏中的登录状态、机型和规则集信息已更新。

常见问题 ​

• Docker SSH 连接失败：检查容器内 sshd 是否启动、10022 端口是否开放，以及密钥认证是否配置正确。
• Conan 鉴权失败：检查 GitCode 登录状态是否有效，重新登录后重试。
• 规则集未生效：在 openUBMC Studio 状态栏中确认是否已选择机型和规则集，必要时重新配置。

三、登录到社区 ​

openUBMC Studio提供了便捷的社区登录功能，通过社区登录可以获取更多资源和服务支持。

登录步骤 ​

1. 点击IDE右下角状态栏中的登录图标

2. 在弹出的登录页面中输入您的openUBMC社区账号和密码

3. 点击“登录”按钮完成登录

登录状态保持 ​

登录成功后，IDE会自动保持和刷新登录状态：

• 自动刷新：IDE会定期刷新登录状态，确保持续有效
• 状态保持：退出IDE后，登录状态会继续保持一段时间
• 自动重连：重新打开IDE时，会自动尝试使用上一次的登录状态重新登录

Conan中心仓集成 ​

登录社区后，IDE会自动同步登录到Conan中心仓：

• 登录状态自动保持并刷新
• 只要IDE处于登录状态，Conan就处于登录状态
• 在执行出包等操作时不会因为认证问题而超时

四、CSR 编码辅助 ​

openUBMC Studio提供了强大的CSR编码辅助功能，包括引用跳转、规则检查、表达式计算器和SMC计算器等，帮助开发者快速定位代码、发现问题并提高开发效率。

模型配置 ​

使用CSR编码辅助功能前，需要先完成模型配置。登录IDE后，点击Web版Studio状态栏中的"未选择机型"按钮，按以下步骤操作：

1. 在模型配置页面中，选择对应的产品和规则集。

2. 确认产品信息后，选择需要配置的模型文件。

3. 配置模型文件对应的代码仓和分支信息。

4. 完成配置后，点击"确定"保存配置。模型配置完成后，规则检查、拓扑配置等功能即可正常使用。

引用跳转功能 ​

引用跳转功能可以帮助开发者快速定位代码定义和引用位置，支持多种跳转方式，大幅提高代码阅读和导航效率。

转到定义 ​

1. 在代码编辑器中，将光标定位到需要查看定义的符号上。

2. 使用以下任一方式跳转到定义：

   • 右键点击符号，选择“转到定义”
   • 按住 Ctrl 键，点击符号

3. 编辑器将自动跳转到符号的定义位置。

转到引用 ​

1. 在代码编辑器中，将光标定位到需要查看引用的符号上。

2. 使用以下任一方式查看引用：

   • 按下 Shift + F12 键
   • 右键点击符号，选择“转到引用”

3. 在侧边栏将显示所有引用该符号的位置列表。

4. 点击列表中的项可跳转到对应的引用位置。

鼠标悬停预览定义 ​

1. 在代码编辑器中，将鼠标悬停在符号上。

2. 等待片刻，将显示符号的定义预览窗口。

基本规则错误检查功能 ​

openUBMC Studio内置了CSR规则检查功能，模型配置完成后即可支持CSR语法与配置约束的实时检查。该功能支持错误位置高亮和规则自动更新，帮助开发者在编码阶段就发现潜在问题。

实时检查 ​

模型配置后，在openUBMC Studio中打开任意CSR文件，检查自动生效：

页面中的类型错误和格式错误都会被实时拦截：

表达式中的语法错误也可以被实时拦截：

查看检查结果 ​

1. 错误和警告会以波浪线形式标注在代码中：

   • 红色波浪线：表示错误（Error）
   • 黄色波浪线：表示警告（Warning）

2. 查看"问题"面板：

   • 点击底部"问题"标签页
   • 查看所有错误和警告列表
   • 点击列表项可快速定位到对应代码位置

复杂规则校验 ​

openUBMC Studio已建立复杂规则校验能力，可以在社区代码仓 openubmc_dsl_rulepack 中开发业务相关的检查规则，自定义规则同样支持实时检查功能。

表达式计算器功能 ​

表达式计算器是openUBMC Studio提供的强大工具，用于编写、调试和测试CSR表达式，帮助开发者快速验证表达式的正确性。

打开表达式计算器 ​

1. 打开CSR文件，在表达式上方将显示“计算表达式”按钮

2. 点击“计算表达式”按钮，表达式计算器窗口将在右侧打开

表达式计算器界面 ​

表达式计算器界面包含以下部分：

• 表达式编辑区：显示和编辑当前选中的表达式
• 模式切换按钮：可以在“调试模式”和“用例模式”之间切换
• 变量面板：显示当前表达式中可用的变量及其值
• 结果面板：显示表达式计算结果和各级管道的计算过程

修改表达式 ​

1. 在表达式编辑区查看或修改表达式

2. 修改完成后，点击“保存到文件”按钮保存修改

3. 保存后，表达式计算器会自动重新加载表达式

4. 源文件中的表达式修改并保存后，表达式编辑页面也会自动重新加载

调试表达式 ​

1. 在表达式编辑区查看表达式内容

2. 在变量面板中输入或修改变量值

3. 完成输入后，系统将自动计算：

   • 各级管道的中间结果
   • 最终表达式结果

表达式批量用例测试 ​

1. 在表达式计算器中， 点击“用例模式”按钮切换到批量测试模式

2. 创建测试用例：

   • 按照要求输入测试用例名称和参数值以及结果值

3. 执行批量测试：

   • 点击“加载用例”加载所有测试用例
   • 点击“Execute all”执行所有测试用例
   • 查看验证报告，显示每个用例的执行结果

SMC计算器功能 ​

SMC计算器用于解析和配置SMC命令字，帮助开发者快速理解和生成SMC命令，简化SMC相关的开发工作。

打开SMC计算器 ​

1. 打开CSR文件，定位到Scanner或Accessor的offset字段

2. 点击offset字段上方显示的"计算偏移量"按钮

3. SMC计算器窗口将在右侧打开

SMC命令字解析 ​

SMC计算器提供了强大的命令字解析功能：

1. 自动解析：当前偏移量会被自动解析，显示各字段的含义
2. 实时计算：修改下方输入框的数据内容将自动更新和计算偏移量
3. 应用到文件：点击“应用”按钮可以将计算结果写入到CSR文件
4. 字段提示：鼠标悬停在字段上方可以显示具体的字段含义和说明

SMC命令字可视化辅助 ​

openUBMC Studio提供了直观的SMC命令字可视化功能：

1. 水印显示：SMC命令字将在CSR中以水印形式显示字段内容，方便查看

2. 悬停详情：鼠标悬停在offset字段上将显示偏移量的详细信息，包括：

   • 各字段的值
   • 字段的含义
   • 完整的偏移量计算结果

五、拓扑与 CSR 可视化配置 ​

CSR 拓扑插件提供整机和单板卡两个维度的总线及器件拓扑可视化。0.3.7 版本新增本地、日志和远程三种整机拓扑模式，并支持总线异常检测、日志包离线还原、真机在位调试以及单板卡可视化配置。

创建拓扑配置 ​

1. 单击 openUBMC Studio 左侧的拓扑十字形侧边栏图标。

2. 单击“创建配置”。

3. 单击“添加仓库”，选择 CSR 文件夹，即可在该机型配置中使用来自该文件夹的 CSR。可以添加多个 CSR 代码仓，单击右下角的“确定”即可创建项目。

4. 创建完成后，拓扑起点为 root.sr。

CSR 整机拓扑 ​

CSR 整机拓扑图提供整机维度与单 CSR 维度的总线及器件拓扑可视化：以板卡为节点展示整机的层级结构、Connector 连接关系与总线连线，支持双击板卡下钻到单板视图、从器件库拖拽器件完成配置。根据数据来源不同，拓扑图分为三种使用模式：本地模式、日志模式与远程模式。

三种模式对比与选择 ​

根据手头资源选择：

• 有整机 CSR 代码仓，需要搭建或修改拓扑配置 → 本地模式（见下文「本地模式」）。
• 只有现场日志压缩包，需要还原收集时刻的整机拓扑 → 日志模式（完整指南见导入 BMC 日志压缩包查看 CSR 拓扑）。
• 有可达真机 BMC，需要查看实时在位或调试板卡加载 → 远程模式（完整指南见远程模式连接 BMC 环境）。

模式切换：日志模式与远程模式均为临时查看模式，重新从侧边栏加载本地拓扑（如切换机型或点击侧边栏文件节点）即恢复本地模式，导入日志产生的临时解压目录会自动清理。

界面说明 ​

拓扑图中的主要元素如下：

• 板卡节点：每个节点代表一块板卡，显示板卡类型、SR 文件名与对应的板型示意图；根节点为 root.sr（BMC 主板）。
• 在位状态：节点左上角显示在位标签或开关，含义与可操作性随模式不同，详见各模式说明。
• 板卡选择器：本地模式下，尚未确定 SR 的节点提供候选板卡列表与数量选择器，用于配置下游板卡。
• 总线连线与连接桩：连线表示上游 Connector 传入的总线，由上游板卡的连接桩连向下游板卡；总线配置不一致时会出现红色连线或异常标志。
• 单板下钻：双击整机拓扑页面的任意板卡，或点击左侧 CSR 列表中的文件，即可打开单 CSR 配置页面，查看该板卡 SR 的板内拓扑与详情。
• 工具栏：配置选择框与「导出配置」按钮用于整机拓扑的多配置管理，仅本地模式可用。

本地模式 ​

本地模式是默认模式，数据来自模型配置的本地 CSR 代码仓，用于日常开发中搭建与修改整机拓扑。

查看整机拓扑 ​

点击侧边栏拓扑插件图标，进入整机拓扑图页面，显示如下：

1. 总线连线：板卡之间的连线为上游 Connector 传入的总线，将鼠标悬停在总线上可显示总线名称。

2. 总线异常检测：自动检测上游 Connector 传入总线与下游板卡 Anchor 中定义总线的一致性。

   1. 总线类型不匹配

      当上游 Connector 的 Buses 和下游板卡 Anchor 的 Buses 同一索引位置的总线类型不一致时，总线显示为红色，将鼠标悬停在图标上可查看具体信息。

      总线类型判断逻辑：取总线名称前缀，若前缀相同，则认为类型匹配。

   2. 上游多传入总线

      当上游 Connector 的 Buses 数量大于下游板卡 Anchor 的 Buses 数量时，Connector 的 Buses 数组中多出的总线会被识别为上游多传入总线。板卡左下角会显示红色异常标志，将鼠标悬停在标志上可查看具体信息。

   3. 下游板卡多出总线

      当上游 Connector 的 Buses 数量小于下游板卡 Anchor 的 Buses 数量时，下游板卡 Anchor 的 Buses 数组中多出的总线会被识别为下游多定义总线。板卡左下角会显示红色异常标志，将鼠标悬停在标志上可查看具体信息。

3. 板卡合并：SR 文件中的不同 Connector 加载同一个文件时，拓扑图会将其合并为一张板卡。

配置整机拓扑 ​

1. 可通过板卡上方选项在整机拓扑中选择对应板卡，各板卡可选下游板卡数量和类型由该板卡的 Connector 配置决定；尚未确定 SR 的节点通过板卡选择器从候选列表中指定 SR 文件。所有配置信息会自动在本地持久化。

2. 双击整机拓扑页面的任意板卡，或点击左侧 CSR 列表中的文件，即可打开单 CSR 配置页面。

3. 通过工具栏的配置选择框可在多套整机配置之间切换，点击「导出配置」可导出当前配置。

在位状态 ​

本地模式根据 SR 文件中上游 Connector 的 IdentifyMode 和 Presence 值显示在位状态，单击开关可切换：

1. 板卡在位状态

2. 切换在位状态：单击开关可同步修改上游 Connector 中 Presence 的值。

CSR 单板卡配置 ​

双击整机拓扑页面的任意板卡，或单击左侧 CSR 列表中的文件，即可打开单 CSR 配置页面。单板卡视图支持新增、删除总线或器件，以及修改 Mux 总线的 ChannelId。也可以按 Ctrl + Z 撤销、按 Ctrl + Y 恢复。

定位器件 ​

单击器件，右侧 SR 文件会自动定位到该器件对象所在的位置。

修改 ChannelId ​

单击器件上方的 ChannelId 数字方块，可修改其值。

新增总线 ​

单击 + 图标，选择总线类型并填写总线后缀，然后单击“确定”新增总线。

删除器件、总线 ​

将鼠标悬停在器件或总线上，单击鼠标右键并选择“删除”。

拖拽器件 ​

打开器件库，将器件拖拽到总线上即可将器件挂载到总线，同时自动修改对应 CSR 文件内容。也可以拖拽器件到可下连的器件卡片上进行挂载。

导入 BMC 日志压缩包查看 CSR 拓扑 ​

openUBMC Studio 支持导入 BMC 一键收集的日志压缩包，在离线环境下还原当前整机加载的 CSR 及其拓扑关系。适用于现场问题定位与离线日志分析：拿到日志包即可查看板卡层级结构、连接关系与在位情况，无需连接真机。

使用前准备 ​

• 已安装 openUBMC Studio 并启用 CSR 拓扑插件（随主插件提供）。
• 准备 BMC 一键收集的日志压缩包，支持 zip、tar、tgz、gz（含 .tar.gz）格式。
• 本机需可执行 tar 命令（日志包解压依赖系统 tar）。

导入日志压缩包 ​

1. 在 openUBMC Studio 左侧 CSR 拓扑侧边栏视图标题栏，点击「导入日志包」按钮。

2. 在弹出的文件选择框中，选择 BMC 日志压缩包并点击「选择日志压缩包」确认。

3. 工具自动解压并解析日志包中的 connectors.txt，随后在主编辑区渲染整机 CSR 拓扑图。导入成功后右下角提示「成功导入: 文件路径」。

查看导入的拓扑 ​

• 板卡层级与连接关系：拓扑图展示整机各板卡的层级结构与总线连接，查看能力与本地整机拓扑页面一致，但不支持切换板卡配置（配置选择框与导出配置按钮为禁用状态）。

• 在位状态：每块板卡以只读标签显示在位状态（在位/不在位），状态取自日志包记录。

实现原理 ​

数据来源 ​

导入模式的拓扑数据全部来自日志压缩包内部，不访问真机，各数据项来源如下：

connectors.txt 通常位于日志包的 dump_info/AppDump/hwdiscovery/ 目录下；工具同时支持在解压根目录及任意子目录中递归查找。.sr 文件从 connectors.txt 所在目录及其子目录中递归收集。

connectors.txt 格式示例 ​

connectors.txt 由 BMC 硬件自发现流程生成，前半部分是板卡树形结构，后半部分是每个 Connector 的属性详情：

root
├─Connector_BMC
│├─Connector_PCPU_1
│└─Connector_PCPU_2
└─Connector_PSU_1

Connector_BMC:
.Buses: ["I2c_1","I2c_2"]
.Type: BMC
.Presence: 1
.IdentifyMode: 2

Connector_PSU_1:
.Buses: ["I2c_3"]
.Type: PSU
.Presence: 0
.IdentifyMode: 2

• 树形部分：通过行首的 ├─、└─、│ 符号表达层级，每个节点即一块板卡的 Connector，对应 SR 文件名为 节点名.sr（如 Connector_PCPU_1.sr）。

• 详情部分：Connector_XXX: 开启一个 Connector 段，其下以 .属性: 值 逐行列出属性。其中 Presence 决定在位标签（1=在位，0=不在位），Buses 决定上游总线连线。

处理流程 ​

1. 解压：调用系统 tar（zip 在 Linux 下用 unzip）将日志包解压到固定临时目录。
2. 查找 connectors.txt：按「解压根目录 → dump_info/AppDump/hwdiscovery/ → 递归子目录」的顺序查找。
3. 解析：拆分树形结构与 Connector 详情段，得到拓扑树骨架与各 Connector 属性。
4. 收集 SR 文件：递归收集同目录下全部 .sr 文件并解析缓存到内存。
5. 构建拓扑：将 Connector 属性与 SR 文件按名称（去除末尾 _序号 后缀）匹配，生成前端拓扑树并渲染。

功能验证 ​

导入完成后，可按以下检查项验证功能是否正常：

常见问题 ​

远程模式连接 BMC 环境 ​

远程模式支持连接真机 BMC 环境，自动从运行时数据（mdbctl 调试命令 + 框架日志）构建整机 CSR 拓扑，实时展示板卡实际在位情况。无需从 BMC 手动导出数据再导入，选择环境即可出图，适用于真机调试、板卡适配验证与在位异常定位。

使用前准备 ​

• 已安装并启用 BMC环境管理 插件（openubmc.bmcstudio-bmc-remote），并添加至少一条 BMC 连接。连接的添加方法参见 BMC环境管理插件 章节。
• 目标 BMC 运行 openUBMC 固件，开放 Telnet 调试通道（23 端口免认证调试 shell），且板上具备 mdbctl 调试命令。
• 开发机无需安装 telnet 客户端，扩展使用内置连接直连。

连接 BMC 环境 ​

1. 在 CSR 拓扑侧边栏视图标题栏，点击「远程调试」按钮。

2. 在顶部弹出的环境选择框中，选择目标 BMC 环境。列表展示全部已配置连接，并实时探测在线状态（在线/离线图标 + 账号信息）。

3. 选择后显示「正在加载 xx 环境的 CSR 拓扑」进度通知，工具自动读取真机运行时的 Connector 对象与 SR 加载记录并构建拓扑。

4. 加载完成后，拓扑图工具栏显示当前连接的环境名称与 IP，主编辑区渲染整机实时拓扑。

查看实时拓扑 ​

• 真实在位状态：拓扑以真机运行时数据为准（而非静态 root.sr 配置），每块板卡显示实际在位/不在位状态。
• EEPROM 板卡：CSR 烧录在 EEPROM（而非 .sr 文件）的板卡会被自动解码，与文件板卡同等展示，双击同样可查看内容。
• 板卡 SR 下钻：双击板卡即可进入单板视图查看该板卡的 SR 内容。
• 在位调试：板卡节点上的在位开关可点击切换，模拟板卡拔插，详见下文「在位调试」。

在位调试 ​

远程模式下，点击板卡节点上的在位开关即可模拟板卡拔插，验证下级板卡的加载逻辑，无需物理操作真机。

普通在位属性 ​

Presence 为固定值（1/0）的板卡，节点上显示单个在位开关。点击开关后：

1. 工具通过 mdbctl setprop 向真机下发修改，更新该 Connector 的 Presence 值；
2. 重新读取运行时在位状态并重建拓扑（不重新读取 SR 文件）；
3. 下级板卡的加载状态随 Presence 变化体现在拓扑上。

同步属性（多开关） ​

Presence 为表达式（引用其他对象属性，如多个物理在位开关共用一个 Connector）时，节点上会按同步源渲染多个开关，每个开关对应一个同步源对象的属性。点击单个开关只修改对应同步源对象的属性值，适用于逐个验证各物理开关对板卡加载的影响。

实现原理 ​

数据来源 ​

远程模式的拓扑数据来自真机运行时，全部通过 Telnet 调试通道（23 端口）自动采集，各数据项来源如下：

通过日志查看 Connector 加载的文件 ​

每个 Connector 实际加载的 SR 文件记录在 BMC 的框架日志 /var/log/framework.log 中，由硬件自发现流程打印，共两类记录：

记录一（init.lua，板卡加载主源）——每个 Connector 加载 SR 时打印，position 即该 Connector 的 GroupPosition：

2026-08-20 10:15:32 hwdiscovery NOTICE: init.lua(152): position: 0101011A, get csr data from /opt/bmc/sr/14100513_pcie_card.sr, ...

记录二（dump.lua，根节点主源）——根板卡的加载只出现在此类记录中：

2026-08-20 10:15:30 hwdiscovery NOTICE: dump.lua(88): start to dump connector: root loading file: /opt/bmc/sr/root.sr

工具解析后的对应关系示例：

也可以在 BMC 上手动执行以下命令核对（与工具解析使用同一数据源）：

grep -E "get csr data from|start to dump connector" /var/log/framework.log

处理流程 ​

1. 连通性自检：通过 Telnet 23 端口连接目标 BMC，探测调试 shell 可用性。
2. 发现 Connector：执行 mdbctl lsobj connector 获取运行时全量 Connector 对象，再批量 mdbctl lsprop 读取每个 Connector 的 Presence 实际值。
3. 解析加载记录：读取 /var/log/framework.log（含历史 .gz 轮转文件），解析「position → SR 文件」与「运行时名 → 文件」两组映射。
4. 建树：按 Connector 的 GroupPosition 属性构建整机层级（去掉末两位十六进制即父节点位置）。
5. 读取 SR 内容：按映射从 /opt/bmc/sr/ 读取 .sr 文件；EEPROM 板卡读取 EEPROM 二进制（CDR 容器）并本地解码出 CSR。
6. 渲染：组装拓扑树、在位状态与 SR 数据，发送到拓扑图视图渲染。

功能验证 ​

连接环境并加载拓扑后，可按以下检查项验证功能是否正常：

常见问题 ​

能效调速配置 ​

能效调速配置功能提供能效调速对象的配置入口，支持通过Excel导入热设计表格解析调速曲线配置，支持对象自动关联及配置检查、CSR片段自动生成。

打开配置页面 ​

点击CSR拓扑侧边栏中的温度计图标即可开启能效调速配置页面。

配置能效调速对象 ​

1. 通过该页面配置能效调速对象，以及配置对象间的关联关系。

2. 点击右上角的"导入Excel"即可导入热设计表格，当前仅支持xlsx格式，若为其他格式请通过Excel另存为xlsx格式文件。完成导入后，温度点与调速曲线等配置可以自动解析。

3. 点击右上角"生成CSR"即可根据当前配置产生CSR代码片段，可以自行填入CSR文件中。生成CSR过程支持配置语法检查，禁止出现ID冲突等问题。

六、事件管理 ​

本章节介绍 openUBMC Studio 的事件管理功能。用户可以在 IDE 中查看和编辑 event_def.json 中的事件信息与描述模板，也可以查看、新增和保存事件与 CSR Event_ 对象的绑定关系。

功能说明 ​

BMC 事件字典定义了整机事件的事件标识、严重级别、事件编码和描述模板等标准信息。事件管理提供以下能力：

• 事件字典管理：查看、筛选和搜索全部事件，编辑基础字段与中英文描述模板，新建自定义事件模板，以及还原或导出差量。
• CSR 绑定管理：查看事件在 SR 文件中绑定的 Event_ 对象，可视化新增、编辑和删除绑定，并批量保存到 SR 文件。

根据打开入口，事件管理提供以下两种视图：

两种视图共用同一套事件字典与编辑能力，仅 CSR 绑定的聚合范围不同。

使用前准备 ​

• 模型配置：已完成产品和规则集选择，事件字典基线来自 Conan 规则包中的 event_def.json。
• 拓扑项目：已通过拓扑侧边栏创建配置并添加 CSR 仓库，当前工作区存在可用的 SR 上下文。

打开事件管理 ​

• 打开整机视图：进入总拓扑页面，单击工具栏中的“事件管理”。

• 打开单板卡视图：进入单 SR 拓扑视图，单击“事件管理”。此时 CSR 绑定范围限定为当前 SR 文件。

事件管理会在独立面板中打开，不影响原拓扑页面。

查看事件管理界面 ​

事件管理界面由工具栏、事件列表、编辑横幅、分页栏和详情面板组成。

• 工具栏：提供新建事件模板、重新拉取、导出、清除全部筛选和搜索功能。
• 事件列表：展示全部事件，支持列头筛选和分页。
• 编辑横幅：存在未导出的编辑时，以黄色或绿色横幅提示导出。
• 详情面板：单击事件行后显示在界面右侧。拖动面板左边缘可以在约 280～700px 范围内调整宽度，单击“×”可以关闭面板。

筛选和搜索事件 ​

查看列表字段 ​

设置筛选条件 ​

1. 单击“级别”“CSR 绑定”“分类”“机型支持”或“恢复上报”列头中的筛选按钮。
2. 勾选需要保留的选项。每个选项会显示对应的事件数量。
3. 如需清空当前列的条件，再次打开筛选菜单并单击“清空筛选”。

右上角搜索框支持按 EventKeyId、事件名称或事件编码进行模糊搜索。存在筛选或搜索条件时，工具栏会显示“清除全部筛选（N）”，单击后可以恢复完整列表。

设置分页 ​

底部分页栏支持将每页数量设置为 20、40、80 或 100 条，也支持按页码跳转。没有事件数据时，可以通过空状态入口新建事件模板；存在数据但被过滤时，可以通过空状态入口清除筛选。

新建和编辑事件 ​

新建事件模板 ​

1. 单击工具栏中的“新建事件模板”。
2. 在右侧详情面板中编辑新模板。

新建的自定义事件会置于列表顶部并自动选中。详情面板底部提供“删除该自定义事件模板”按钮。

编辑基础字段 ​

1. 在事件列表中单击目标事件。

2. 在右侧详情面板中打开“基础信息”页签。

基础字段说明如下：

编辑描述模板 ​

“描述模板”区域提供以下四类内容的中英文编辑，单击右上角的“中”或“EN”可以切换语言：

• Description：描述。
• Cause：可能原因。
• Influence：影响。
• Suggestion：处理建议。

还原事件数据 ​

• 还原单个事件：单击详情面板标题行中的“还原”，丢弃该事件的全部本地编辑并恢复为字典基线值。

• 重新拉取全部事件：单击工具栏中的“重新拉取”，在确认窗口中继续操作。完成后，事件管理会丢弃全部编辑，从 Conan 包重新读取事件字典，并将筛选、搜索和分页恢复为初始状态。

查看并导出修改 ​

存在未同步的编辑时，列表上方会显示编辑横幅。

• 查看修改：打开变化清单后，可以单击事件标识定位到对应事件，也可以单独还原某个事件。
• 导出事件字典：导出的 event_def.json 包含全部事件定义与描述模板，文件版本号末段自动加一，例如从 1.0.0 更新为 1.0.1。导出后，请将文件提交到 VPD 仓库进行同步。
• 导出机型事件清单：导出的 eventDefList.txt 仅包含“机型支持”为“是”的事件标识。

管理 CSR 绑定 ​

CSR 绑定描述事件与 SR 文件中 Event_ 对象的对应关系。在详情面板中打开“CSR 绑定”页签，可以查看和编辑绑定。

查看 CSR 绑定 ​

页签顶部显示当前视图类型和事件的绑定总数。绑定以卡片形式展示，每张卡片会标注所属 SR 文件，悬停后可以查看完整路径。

新增 CSR 绑定 ​

1. 单击详情面板底部的“CSR 绑定”。

2. 在新增卡片中填写绑定字段。

3. 如果当前处于整机视图，选择“目标 SR 文件”。整机根文件 root.sr 不在候选范围内；单板卡视图会自动使用当前 SR 文件。

4. 单击“确定”，批量保存本次绑定修改。

查看绑定字段 ​

验证保存结果 ​

• “确定”仅在存在修改且表单校验通过时可用；单击“取消”会放弃本次全部修改。
• 对象名为空、未以 Event_ 开头或在组内重名时，对应输入框会显示错误。
• 保存成功后，绑定列表和绑定数量会自动刷新，事件列表会定位到当前事件。
• 在编辑器中直接保存 SR 文件后，绑定列表和绑定数量也会自动刷新。

常见问题 ​

• 事件字段是否需要手动保存？ 不需要。字段与描述模板编辑会在停止输入约 1 秒后写入本地缓存，并在关闭面板时落盘；CSR 绑定修改需要单击“确定”保存到 SR 文件。
• 重新拉取后编辑全部消失：此行为符合预期。“重新拉取”会丢弃全部本地差量并恢复到字典基线。
• CSR 绑定提示对象名必须以 Event_ 开头：事件对象名必须带有固定前缀，并且不能只有 Event_ 前缀。
• 整机视图与单板卡视图的绑定数量不一致：两种视图的聚合范围分别为全部 SR 文件和当前 SR 文件，因此数量可能不同。
• 还原事件后列表中的绑定数量未变化：“还原”仅丢弃事件字典的本地差量，不修改 CSR 绑定。
• 导出的文件应提交到哪里？ event_def.json 与 eventDefList.txt 均用于提交到 VPD 仓库，具体流程遵循团队的字典变更管理规范。
• 新建的模板在筛选结果中不可见：新建模板时会自动清空筛选。如模板仍不可见，请检查搜索词和列头筛选条件。

七、日志诊断与告警链条分析 ​

一键日志解析插件（扩展 ID：openubmc.bmcstudio-log-reviewer）用于导入 BMC 一键日志包或 dump 目录，并通过可视化页面和 AI Agent 分析设备状态。用户可以浏览硬件、告警、传感器、性能及原始日志，也可以结合 openUBMC RAG 进行日志体检，或通过告警证据工具分析指定事件的触发链条。

功能说明 ​

日志诊断提供以下使用方式：

使用前准备 ​

如果活动栏中没有“一键日志解析”图标，请先执行以下操作：

1. 在 openUBMC Studio 中打开插件市场，搜索“一键日志解析”。
2. 安装插件，并按照提示重新加载窗口。
3. 确认活动栏中出现“一键日志解析”图标。

使用 Agent 日志体检前，还需要满足以下条件：

• 已登录 openUBMC 社区。
• openubmc-rag 扩展已启用。
• 当前网络可以访问配置的 LightRAG 服务。
• AI Agent 可以访问 openUBMC Studio MCP 工具。

AI Agent 会在读取日志前检查 RAG 状态。未登录、RAG 工具未启用、网络异常或状态响应无法解析时，日志体检会停止并显示处理建议。

打开一键日志 ​

一键日志解析支持 Windows、Linux、WSL、SSH 远程工作区和容器工作区。

支持导入以下内容：

• .tar.gz、.tgz、.tar 或 .zip 格式的 BMC 一键日志压缩包。
• 已解压且包含 AppDump 子目录的 dump 文件夹。

操作步骤如下：

1. 单击活动栏中的“一键日志解析”图标。

2. 根据日志形态，选择“打开 BMC 一键日志压缩包”或“打开 dump 目录”。

3. 选择日志压缩包或 dump 根目录。选择目录时，应选中包含 AppDump 子目录的 dump 根目录。

4. 等待解压和解析完成，确认日志页面已在编辑器区域打开。

也可以通过以下入口打开日志：

• 在资源管理器中右键单击日志压缩包或 dump 文件夹，选择对应的一键日志解析命令。
• 单击“最近打开”中的历史记录，重新打开对应日志。

“最近打开”最多保存 30 条记录。同一日志已经打开时，再次打开只会定位到原页面。删除一条最近记录时，对应的日志页面也会关闭。

查看日志包要求 ​

日志包中必须存在名称完全匹配的 AppDump 目录，典型结构如下：

dump_info/
├── AppDump/
├── LogDump/
├── RTOSDump/
└── OSDump/

插件最多向下查找 6 层目录。AppDump 是导入日志时的必需目录；缺少 LogDump、RTOSDump 或 OSDump 时，日志包仍可能打开，但对应页面会显示无数据或目录缺失。

查看诊断信息 ​

日志面板按照不同领域组织现场信息，常用视图包括：

• 现场概览：查看机型、健康状态、FRU、板卡和软件版本。
• 告警与传感器：查看告警记录、活动状态、传感器读值和门限信息。
• 运行状态：查看性能、功率、进风温度、调速策略和 PID 配置。
• 硬件关联：查看线缆检测、同步属性、CSR 和丝印信息。
• 日志与诊断：查看操作日志、应用日志、框架日志、维护日志、驱动日志、串口日志、journalctl、一键日志原始文件和故障诊断文件。
• 智能检测：使用 AI Agent 和 openUBMC RAG 进行日志体检。

不同页面按需解析日志文件，不会在导入时将所有文件一次性加载到内存。日志视图支持筛选、大小写匹配、全字匹配、正则表达式、匹配项跳转和保存搜索，具体可用项以当前视图为准。

使用 Agent 进行日志体检 ​

日志体检会将本地日志证据与 openUBMC RAG 检索结果关联，并按照严重程度、紧急度和置信度排列问题。故障案例库是可信度最高的知识来源，但不是唯一可用来源。

复制分析 Prompt ​

1. 打开日志页面顶部的“智能检测”。

2. 单击“复制 Prompt 模板”。

3. 将 Prompt 粘贴到能够访问 openUBMC Studio MCP 工具的 AI Agent 中。

4. 发送 Prompt，等待 AI Agent 完成 RAG 状态检查并开始分析。

Prompt 已包含以下约束，无需手动填写日志路径：

• 包含当前日志包的显示名称、分析任务标识和回调地址。
• 只允许读取当前分析任务绑定的日志包。
• 必须先检查 RAG 连接和社区登录状态。
• 必须保留 RAG 引用的真实来源，其中故障案例库来源具有最高可信度。
• 每个问题必须同时提供 RAG 匹配内容和本地日志证据。
• 分析完成后，按照用户配置的 TopN 返回结果。

查看实时问题 ​

AI Agent 分析期间，每个已确认的问题会实时显示在“Agent 日志问题”区域。问题卡片包含以下内容：

• 严重程度：CRITICAL、HIGH、MEDIUM 或 LOW。
• 紧急度：综合故障影响、恶化可能、冗余能力和修复窗口计算的 0～100 分。
• 置信度：本地多源证据与 RAG 知识的一致程度。
• 可能原因和处理建议。
• RAG 匹配内容、来源及可信度。
• 日志片段、日志包内相对路径和定位信息。

同一根因产生的重复现象应合并为一个问题。分析完成后，插件会依次按照严重程度、紧急度和置信度排序，并展示最紧急的 TopN 问题。

配置 TopN ​

TopN 默认值为 10，可以设置为 1～50：

1. 单击“一键日志解析”侧边栏标题栏中的齿轮图标。
2. 在设置页面中修改 bmcstudio.logReviewer.analysisTopN。
3. 创建新的分析会话，使新设置生效。

TopN 只限制分析完成后页面和 PDF 报告中展示的问题数量。AI Agent 可以在分析过程中回写更多候选问题，插件会在完成时统一排序和截取。已经打开的分析会话继续使用创建会话时的 TopN 值；如需让同一日志使用新的 TopN，请先从“最近打开”中删除该日志，再重新导入并发起分析。

导出 PDF 报告 ​

“导出为 PDF 报告”仅在分析状态变为“已完成”后可用：

1. 确认页面显示“Agent 智能分析：已完成”。
2. 单击“导出为 PDF 报告”。
3. 选择保存路径和文件名。
4. 使用 PDF 阅读器打开报告，核对摘要、问题排序、RAG 内容、日志证据和处理建议。

报告在当前 openUBMC Studio 扩展宿主运行期间可以持续导出。完全关闭或重启 openUBMC Studio 后，内存中的分析会话不会保留，需要重新发起分析。

处理会话异常 ​

使用 AI Agent 定向诊断日志 ​

在 AI Agent 对话中提供日志路径和分析目标，例如：

请打开并诊断 /path/to/bmc-log.tar.gz，先给出设备健康概览、关键异常和对应证据位置。

openUBMC Studio 会打开同一份日志的可视化面板，同时将机型、健康状态、硬件清单、告警、传感器、性能、调速、线缆和 CSR 等结构化数据提供给 AI Agent。后续可以继续要求 AI Agent 聚焦某个领域，例如：

继续分析当前日志中的散热异常，关联传感器、调速策略、功率和相关运行日志。

分析告警链条 ​

分析单条告警时，建议提供以下任一组定位信息：

• 事件码和发生时间。事件码格式为 0x 后接 8 位十六进制数字，时间格式为 YYYY-MM-DD HH:mm:ss。
• sel.txt 中的事件记录 ID。openUBMC Studio 可以据此解析事件码和发生时间。
• 需要区分多个告警实例时，再补充组件或实例名称。

示例：

基于当前打开的一键日志，分析事件码 0x12345678、时间 2026-08-28 14:23:16 的完整告警触发链。
请说明当前告警状态、已观察到和缺失的阶段、恢复与复发情况，并在每个节点标注证据文件及行号或数据库记录位置。

AI Agent 会根据日志中的实际证据按需给出以下内容：

• 唯一告警锚点及其匹配方式，避免混淆相同事件码的不同告警实例。
• 告警当前状态，包括 active、inactive、conflicted 或 unknown，并分别列出状态依据。
• 已观察到的触发流程，例如采样、数值转换、门限或事件规则求值、事件存储和北向上报；未采集到的阶段会标记为缺失。
• 运行期事件与 dump 内 .sr 文件中 CSR Event/PowerEvent 定义、属性和直接引用关系的关联结果。
• Assert/Deassert 恢复配对、复发次数下界、历史覆盖范围和可能的时钟跳变。
• 每个关键事实对应的 dump 相对路径、行号、列号、JSON Pointer 或数据库定位信息。

了解数据范围和安全边界 ​

• AI Agent 日志工具只能访问分析任务绑定的日志包，不会自动选择其他历史日志。
• 日志证据使用日志包内相对路径，不会向页面回写宿主绝对路径。
• 日志体检唯一允许访问的外部知识是 openUBMC RAG 状态和知识检索结果。
• tar 系列导入会拒绝路径逃逸、绝对路径和解压炸弹，并忽略符号链接、硬链接及设备文件。
• PDF 报告只包含当前分析会话中的摘要、TopN 问题、RAG 依据和日志证据。

八、BMC 环境管理 ​

本章介绍 openUBMC Studio 的 BMC环境管理 插件（扩展 ID：openubmc.bmcstudio-bmc-remote）的功能与使用方法。该插件用于在 IDE 内集中管理多台 BMC 环境、批量下发命令、上传文件、一键升级固件、实时监控日志、自动调试组件以及远程 GDB 调试。

BMC环境管理插件在活动栏注册一个「BMC环境管理」容器，下设两个视图：

• BMC Environments：BMC 环境连接树，按分组组织，管理连接的元数据与凭据。
• Command Macros：命令宏树，维护可批量下发的命令序列。

插件的核心能力包括：

• 连接管理：以分组方式管理多台 BMC，单条连接可任选 SSH、Telnet 或 WebView 方式接入。
• 连通性管理：手动或周期性探测 BMC 可达性，并在状态变化时播报。
• 命令宏：预定义命令序列与变量，按「全部可达 / 分组 / 手动多选」批量下发，回收结构化结果。
• SFTP 上传：从资源管理器右键将本地文件或目录上传到 BMC。
• HPM 一键升级：右键 .hpm 固件包，并发升级多台 BMC，全程进度可视。
• 实时日志监控：实时 tail 远端 /var/log 日志，支持日志轮转衔接、时间回绕校准与原始文件下载。
• 组件自动调试：根据 Git 变更自动部署 Lua、C/C++ 和北向接口调试内容，详见 C/C++、Lua 与北向接口快速调试。
• 远程 GDB 调试：附加板端服务或部署独立程序进行源码级调试，详见 BMC 远程 GDB 调试。
• MCP 工具：对外暴露 27 个 MCP 工具，供 AI Agent 调用，实现自然语言驱动的批量运维与告警证据分析。

使用前准备 ​

环境要求 ​

• 运行平台：推荐 Linux（Ubuntu）。连接管理以 Linux 为目标平台；HPM 升级与日志监控仅依赖 Node 内置模块，三平台行为一致。
• 系统依赖：建议预装以下工具：
  • openssh-client：SSH 接入与 SFTP 上传。
  • telnet：Telnet 接入与实时日志监控。
  • tar（支持 -z）：目录上传与日志下载解压。
  • libsecret-1-0 / gnome-keyring：Linux 下用于安全存储密码。

安装插件 ​

1. 在 openUBMC Studio 中打开插件市场（活动栏的「扩展」图标，或按 Ctrl+Shift+X），搜索「BMC环境管理」，点击「安装」。
2. 安装完成后重启 IDE 生效。活动栏出现「BMC环境管理」图标即表示安装成功。

BMC 环境管理 ​

新增分组 ​

连接以「分组」为单位组织，系统默认创建一个分组。

1. 在 BMC Environments 视图标题栏单击「Add Group」按钮。
2. 输入分组名称并确认。

分组的右键菜单支持「Add」「Rename Group」「Delete Group」。分组非空时拒绝删除（保护数据），需先清空或迁移其下连接。

新增连接 ​

1. 单击 BMC Environments 视图标题栏「Add BMC Environment」按钮，或在某个分组上右键选择「Add」。
2. 在弹出的表单中填写连接信息并保存。

连接字段说明：

接入 BMC ​

在连接上右键，选择接入方式：

• Connect via SSH：使用进程内 SSH 客户端登录（兼容老款 BMC 的弱算法与 keyboard-interactive 交互），以伪终端呈现。默认在编辑器区（接近全屏）打开，由配置项 bmc.autoMaximizeTerminal 控制，关闭后回到底部面板。
• Connect via Telnet：调用系统 telnet 命令接入，需本机已安装 telnet。Telnet 不会自动发送密码，需手动输入。
• Open in WebView：使用系统浏览器打开 BMC Web UI（https://{host}）。

SSH 握手超时由 bmc.connectionTimeout（默认 30 秒）控制。

编辑与删除 ​

• Edit Configuration / Change Password：修改连接信息。编辑密码时留空表示保留原密码。
• Disconnect：发送 exit、关闭终端并注销会话。
• Delete：删除前会弹出模态确认；删除会先关闭相关终端并清理该连接的凭据。

连通性管理 ​

插件通过 TCP 探测 SSH 22 端口判断 BMC 可达性，连接树图标实时反映状态（不可达时变红），分组徽章显示「X/Y 可达」。

• 手动探测单个：右键连接 → 「Check Connection Health」，提示可达 / 不可达。
• 全量刷新：单击视图标题栏「Refresh」，先把全部连接置为检测中再统一探测。
• 周期检测：右键连接 → 「开启自动检测连通状态」/「关闭自动检测连通状态」。开启后每 10 秒 探测一轮，仅对开启该项的连接生效。
• 状态播报：右键连接 → 「开启连通性变更播报」/「关闭连通性变更播报」。上线提示「{分组}/{名称} 已上电」，掉线提示「{名称} 已下电」。

探测超时由 bmc.pingTimeout（默认 3000 毫秒）控制。可达性 = 「TCP 22 端口通 + 已配置凭据」；运行宏、上传、升级前均以此作为就绪判据。

命令宏 ​

命令宏用于预定义「一组有序 shell 命令 + 变量 + 失败策略」，运行时按目标范围批量下发到 BMC，每台环境复用一条 SSH 连接执行完整命令集，并回收结构化的「环境 × 命令」结果矩阵。

新建宏 ​

1. 单击 Command Macros 视图标题栏「Add Command Macro」按钮。
2. 在表单中填写宏内容并保存。

宏字段说明：

一、简介 ​

openUBMC Studio 是一款基于 Code - OSS 的 openUBMC 集成开发环境，面向 openUBMC 开发、调试和构建场景。

最近版本新增功能 ​

下表按发布时间倒序汇总 openUBMC Studio 最近三个版本的新增功能，单击功能名称可跳转到对应章节。当前收录 2026 年 8 月和 9 月发布的版本；后续发布新版本时，仅保留最近三个版本。

主要特性 ​

openUBMC Studio 的主要特性包括：

• 智能代码辅助：提供代码跳转、定义预览和引用查找等功能。
• 实时错误检查：基于规则集检测代码错误和潜在问题。
• 表达式计算器：支持 CSR 表达式的编写、调试和批量测试。
• SMC 命令字配置：提供可视化的 SMC 命令字解析和配置工具。
• 模型配置：支持产品和规则集的选择与配置。
• CSR 拓扑可视化与调试：支持本地、日志和远程三种整机拓扑模式，提供总线异常检测、单板卡配置、日志包离线还原和真机在位调试。
• 事件管理：支持查看和编辑事件字典、描述模板及 CSR 事件绑定。
• 能效调速配置：支持通过 Excel 导入热设计表格并生成 CSR 调速曲线代码。
• Manifest 可视化配置：支持配置构建变体、组件依赖、默认特性和组件特性，并提供配置诊断。
• 组件与固件联合构建：支持从业务组件仓构建本地组件包，在隔离 Manifest 中验证选包并转入固件出包。
• 一键出包：支持选择机型和包型，完成出包预检、固件构建、日志查看和产物下载。
• 签名配置：支持管理 HPM 和 EEPROM 签名档案，并生成或吊销本地自签名证书。
• AI 引导环境初始化：支持通过 AI Agent 完成社区开发环境初始化。
• 日志诊断与告警链条分析：支持导入 BMC 一键日志进行可视化诊断、Agent 日志体检和告警链条分析。
• C/C++、Lua 与北向接口快速调试：支持按照 Git 变更规划直接部署或隔离构建，将最小替换集部署到 BMC 并验证结果。
• BMC 远程 GDB 调试：支持附加板端服务，或部署独立程序进行源码级调试。
• BMC 环境管理插件：集中管理多台 BMC，支持连接与分组、命令宏、SFTP/HPM 升级和日志监控。
• 白牌包定制：支持可视化定制 Web 风格、Logo、图片和产品信息，并构建白牌包或清白牌包。
• 社区集成：对接 openUBMC 社区资源和服务。

二、AI 引导环境初始化 ​

openUBMC Studio 提供 AI 引导环境初始化能力。将预置 Prompt 发送给 AI Agent（例如 opencode、Claude Code 或 Cursor）后，AI Agent 会检测当前状态、诊断问题，并按顺序引导用户完成社区开发环境初始化。

使用前准备 ​

• 已安装并能正常使用 AI Agent，例如 opencode、Claude Code 或 Cursor。

打开配置引导 ​

1. 在欢迎页面中单击“配置引导”入口。

2. 在打开的配置引导窗口中找到“AI 引导初始化”卡片。

复制引导指令 ​

1. 单击“复制指令”卡片，打开 Prompt 对话框。

2. 单击“复制到 AI Agent”，将 Prompt 复制到剪贴板。

3. 切换到 AI Agent，粘贴并发送 Prompt。

了解 AI 引导流程 ​

AI Agent 接收到 Prompt 后，会按以下流程引导用户完成环境初始化：

1. GitCode 登录认证：AI Agent 打开 OAuth 登录窗口，并在用户授权后检测登录状态。
2. 环境检测与部署：AI Agent 检测操作系统。Windows 用户可以选择 Docker（约 5 分钟）或 WSL（约 30 分钟）部署方式，Linux 用户直接进入环境配置。
3. 规则集配置：AI Agent 引导用户在 openUBMC Studio 界面中选择机型和规则集，并通过 localview_get_data_source 验证配置是否生效。
4. 状态写回：每个步骤完成后，AI Agent 会回写向导状态；全部步骤完成后，向导状态变为“已完成”。

验证初始化结果 ​

1. 确认配置引导窗口显示初始化已完成。

2. 返回欢迎页面，确认状态栏中的登录状态、机型和规则集信息已更新。

常见问题 ​

• Docker SSH 连接失败：检查容器内 sshd 是否启动、10022 端口是否开放，以及密钥认证是否配置正确。
• Conan 鉴权失败：检查 GitCode 登录状态是否有效，重新登录后重试。
• 规则集未生效：在 openUBMC Studio 状态栏中确认是否已选择机型和规则集，必要时重新配置。

三、登录到社区 ​

openUBMC Studio提供了便捷的社区登录功能，通过社区登录可以获取更多资源和服务支持。

登录步骤 ​

1. 点击IDE右下角状态栏中的登录图标

2. 在弹出的登录页面中输入您的openUBMC社区账号和密码

3. 点击“登录”按钮完成登录

登录状态保持 ​

登录成功后，IDE会自动保持和刷新登录状态：

• 自动刷新：IDE会定期刷新登录状态，确保持续有效
• 状态保持：退出IDE后，登录状态会继续保持一段时间
• 自动重连：重新打开IDE时，会自动尝试使用上一次的登录状态重新登录

Conan中心仓集成 ​

登录社区后，IDE会自动同步登录到Conan中心仓：

• 登录状态自动保持并刷新
• 只要IDE处于登录状态，Conan就处于登录状态
• 在执行出包等操作时不会因为认证问题而超时

四、CSR 编码辅助 ​

openUBMC Studio提供了强大的CSR编码辅助功能，包括引用跳转、规则检查、表达式计算器和SMC计算器等，帮助开发者快速定位代码、发现问题并提高开发效率。

模型配置 ​

使用CSR编码辅助功能前，需要先完成模型配置。登录IDE后，点击Web版Studio状态栏中的"未选择机型"按钮，按以下步骤操作：

1. 在模型配置页面中，选择对应的产品和规则集。

2. 确认产品信息后，选择需要配置的模型文件。

3. 配置模型文件对应的代码仓和分支信息。

4. 完成配置后，点击"确定"保存配置。模型配置完成后，规则检查、拓扑配置等功能即可正常使用。

引用跳转功能 ​

引用跳转功能可以帮助开发者快速定位代码定义和引用位置，支持多种跳转方式，大幅提高代码阅读和导航效率。

转到定义 ​

1. 在代码编辑器中，将光标定位到需要查看定义的符号上。

2. 使用以下任一方式跳转到定义：

   • 右键点击符号，选择“转到定义”
   • 按住 Ctrl 键，点击符号

3. 编辑器将自动跳转到符号的定义位置。

转到引用 ​

1. 在代码编辑器中，将光标定位到需要查看引用的符号上。

2. 使用以下任一方式查看引用：

   • 按下 Shift + F12 键
   • 右键点击符号，选择“转到引用”

3. 在侧边栏将显示所有引用该符号的位置列表。

4. 点击列表中的项可跳转到对应的引用位置。

鼠标悬停预览定义 ​

1. 在代码编辑器中，将鼠标悬停在符号上。

2. 等待片刻，将显示符号的定义预览窗口。

基本规则错误检查功能 ​

openUBMC Studio内置了CSR规则检查功能，模型配置完成后即可支持CSR语法与配置约束的实时检查。该功能支持错误位置高亮和规则自动更新，帮助开发者在编码阶段就发现潜在问题。

实时检查 ​

模型配置后，在openUBMC Studio中打开任意CSR文件，检查自动生效：

页面中的类型错误和格式错误都会被实时拦截：

表达式中的语法错误也可以被实时拦截：

查看检查结果 ​

1. 错误和警告会以波浪线形式标注在代码中：

   • 红色波浪线：表示错误（Error）
   • 黄色波浪线：表示警告（Warning）

2. 查看"问题"面板：

   • 点击底部"问题"标签页
   • 查看所有错误和警告列表
   • 点击列表项可快速定位到对应代码位置

复杂规则校验 ​

openUBMC Studio已建立复杂规则校验能力，可以在社区代码仓 openubmc_dsl_rulepack 中开发业务相关的检查规则，自定义规则同样支持实时检查功能。

表达式计算器功能 ​

表达式计算器是openUBMC Studio提供的强大工具，用于编写、调试和测试CSR表达式，帮助开发者快速验证表达式的正确性。

打开表达式计算器 ​

1. 打开CSR文件，在表达式上方将显示“计算表达式”按钮

2. 点击“计算表达式”按钮，表达式计算器窗口将在右侧打开

表达式计算器界面 ​

表达式计算器界面包含以下部分：

• 表达式编辑区：显示和编辑当前选中的表达式
• 模式切换按钮：可以在“调试模式”和“用例模式”之间切换
• 变量面板：显示当前表达式中可用的变量及其值
• 结果面板：显示表达式计算结果和各级管道的计算过程

修改表达式 ​

1. 在表达式编辑区查看或修改表达式

2. 修改完成后，点击“保存到文件”按钮保存修改

3. 保存后，表达式计算器会自动重新加载表达式

4. 源文件中的表达式修改并保存后，表达式编辑页面也会自动重新加载

调试表达式 ​

1. 在表达式编辑区查看表达式内容

2. 在变量面板中输入或修改变量值

3. 完成输入后，系统将自动计算：

   • 各级管道的中间结果
   • 最终表达式结果

表达式批量用例测试 ​

1. 在表达式计算器中， 点击“用例模式”按钮切换到批量测试模式

2. 创建测试用例：

   • 按照要求输入测试用例名称和参数值以及结果值

3. 执行批量测试：

   • 点击“加载用例”加载所有测试用例
   • 点击“Execute all”执行所有测试用例
   • 查看验证报告，显示每个用例的执行结果

SMC计算器功能 ​

SMC计算器用于解析和配置SMC命令字，帮助开发者快速理解和生成SMC命令，简化SMC相关的开发工作。

打开SMC计算器 ​

1. 打开CSR文件，定位到Scanner或Accessor的offset字段

2. 点击offset字段上方显示的"计算偏移量"按钮

3. SMC计算器窗口将在右侧打开

SMC命令字解析 ​

SMC计算器提供了强大的命令字解析功能：

1. 自动解析：当前偏移量会被自动解析，显示各字段的含义
2. 实时计算：修改下方输入框的数据内容将自动更新和计算偏移量
3. 应用到文件：点击“应用”按钮可以将计算结果写入到CSR文件
4. 字段提示：鼠标悬停在字段上方可以显示具体的字段含义和说明

SMC命令字可视化辅助 ​

openUBMC Studio提供了直观的SMC命令字可视化功能：

1. 水印显示：SMC命令字将在CSR中以水印形式显示字段内容，方便查看

2. 悬停详情：鼠标悬停在offset字段上将显示偏移量的详细信息，包括：

   • 各字段的值
   • 字段的含义
   • 完整的偏移量计算结果

五、拓扑与 CSR 可视化配置 ​

CSR 拓扑插件提供整机和单板卡两个维度的总线及器件拓扑可视化。0.3.7 版本新增本地、日志和远程三种整机拓扑模式，并支持总线异常检测、日志包离线还原、真机在位调试以及单板卡可视化配置。

创建拓扑配置 ​

1. 单击 openUBMC Studio 左侧的拓扑十字形侧边栏图标。

2. 单击“创建配置”。

3. 单击“添加仓库”，选择 CSR 文件夹，即可在该机型配置中使用来自该文件夹的 CSR。可以添加多个 CSR 代码仓，单击右下角的“确定”即可创建项目。

4. 创建完成后，拓扑起点为 root.sr。

CSR 整机拓扑 ​

CSR 整机拓扑图提供整机维度与单 CSR 维度的总线及器件拓扑可视化：以板卡为节点展示整机的层级结构、Connector 连接关系与总线连线，支持双击板卡下钻到单板视图、从器件库拖拽器件完成配置。根据数据来源不同，拓扑图分为三种使用模式：本地模式、日志模式与远程模式。

三种模式对比与选择 ​

根据手头资源选择：

• 有整机 CSR 代码仓，需要搭建或修改拓扑配置 → 本地模式（见下文「本地模式」）。
• 只有现场日志压缩包，需要还原收集时刻的整机拓扑 → 日志模式（完整指南见导入 BMC 日志压缩包查看 CSR 拓扑）。
• 有可达真机 BMC，需要查看实时在位或调试板卡加载 → 远程模式（完整指南见远程模式连接 BMC 环境）。

模式切换：日志模式与远程模式均为临时查看模式，重新从侧边栏加载本地拓扑（如切换机型或点击侧边栏文件节点）即恢复本地模式，导入日志产生的临时解压目录会自动清理。

界面说明 ​

拓扑图中的主要元素如下：

• 板卡节点：每个节点代表一块板卡，显示板卡类型、SR 文件名与对应的板型示意图；根节点为 root.sr（BMC 主板）。
• 在位状态：节点左上角显示在位标签或开关，含义与可操作性随模式不同，详见各模式说明。
• 板卡选择器：本地模式下，尚未确定 SR 的节点提供候选板卡列表与数量选择器，用于配置下游板卡。
• 总线连线与连接桩：连线表示上游 Connector 传入的总线，由上游板卡的连接桩连向下游板卡；总线配置不一致时会出现红色连线或异常标志。
• 单板下钻：双击整机拓扑页面的任意板卡，或点击左侧 CSR 列表中的文件，即可打开单 CSR 配置页面，查看该板卡 SR 的板内拓扑与详情。
• 工具栏：配置选择框与「导出配置」按钮用于整机拓扑的多配置管理，仅本地模式可用。

本地模式 ​

本地模式是默认模式，数据来自模型配置的本地 CSR 代码仓，用于日常开发中搭建与修改整机拓扑。

查看整机拓扑 ​

点击侧边栏拓扑插件图标，进入整机拓扑图页面，显示如下：

1. 总线连线：板卡之间的连线为上游 Connector 传入的总线，将鼠标悬停在总线上可显示总线名称。

2. 总线异常检测：自动检测上游 Connector 传入总线与下游板卡 Anchor 中定义总线的一致性。

   1. 总线类型不匹配

      当上游 Connector 的 Buses 和下游板卡 Anchor 的 Buses 同一索引位置的总线类型不一致时，总线显示为红色，将鼠标悬停在图标上可查看具体信息。

      总线类型判断逻辑：取总线名称前缀，若前缀相同，则认为类型匹配。

   2. 上游多传入总线

      当上游 Connector 的 Buses 数量大于下游板卡 Anchor 的 Buses 数量时，Connector 的 Buses 数组中多出的总线会被识别为上游多传入总线。板卡左下角会显示红色异常标志，将鼠标悬停在标志上可查看具体信息。

   3. 下游板卡多出总线

      当上游 Connector 的 Buses 数量小于下游板卡 Anchor 的 Buses 数量时，下游板卡 Anchor 的 Buses 数组中多出的总线会被识别为下游多定义总线。板卡左下角会显示红色异常标志，将鼠标悬停在标志上可查看具体信息。

3. 板卡合并：SR 文件中的不同 Connector 加载同一个文件时，拓扑图会将其合并为一张板卡。

配置整机拓扑 ​

1. 可通过板卡上方选项在整机拓扑中选择对应板卡，各板卡可选下游板卡数量和类型由该板卡的 Connector 配置决定；尚未确定 SR 的节点通过板卡选择器从候选列表中指定 SR 文件。所有配置信息会自动在本地持久化。

2. 双击整机拓扑页面的任意板卡，或点击左侧 CSR 列表中的文件，即可打开单 CSR 配置页面。

3. 通过工具栏的配置选择框可在多套整机配置之间切换，点击「导出配置」可导出当前配置。

在位状态 ​

本地模式根据 SR 文件中上游 Connector 的 IdentifyMode 和 Presence 值显示在位状态，单击开关可切换：

1. 板卡在位状态

2. 切换在位状态：单击开关可同步修改上游 Connector 中 Presence 的值。

CSR 单板卡配置 ​

双击整机拓扑页面的任意板卡，或单击左侧 CSR 列表中的文件，即可打开单 CSR 配置页面。单板卡视图支持新增、删除总线或器件，以及修改 Mux 总线的 ChannelId。也可以按 Ctrl + Z 撤销、按 Ctrl + Y 恢复。

定位器件 ​

单击器件，右侧 SR 文件会自动定位到该器件对象所在的位置。

修改 ChannelId ​

单击器件上方的 ChannelId 数字方块，可修改其值。

新增总线 ​

单击 + 图标，选择总线类型并填写总线后缀，然后单击“确定”新增总线。

删除器件、总线 ​

将鼠标悬停在器件或总线上，单击鼠标右键并选择“删除”。

拖拽器件 ​

打开器件库，将器件拖拽到总线上即可将器件挂载到总线，同时自动修改对应 CSR 文件内容。也可以拖拽器件到可下连的器件卡片上进行挂载。

导入 BMC 日志压缩包查看 CSR 拓扑 ​

openUBMC Studio 支持导入 BMC 一键收集的日志压缩包，在离线环境下还原当前整机加载的 CSR 及其拓扑关系。适用于现场问题定位与离线日志分析：拿到日志包即可查看板卡层级结构、连接关系与在位情况，无需连接真机。

使用前准备 ​

• 已安装 openUBMC Studio 并启用 CSR 拓扑插件（随主插件提供）。
• 准备 BMC 一键收集的日志压缩包，支持 zip、tar、tgz、gz（含 .tar.gz）格式。
• 本机需可执行 tar 命令（日志包解压依赖系统 tar）。

导入日志压缩包 ​

1. 在 openUBMC Studio 左侧 CSR 拓扑侧边栏视图标题栏，点击「导入日志包」按钮。

2. 在弹出的文件选择框中，选择 BMC 日志压缩包并点击「选择日志压缩包」确认。

3. 工具自动解压并解析日志包中的 connectors.txt，随后在主编辑区渲染整机 CSR 拓扑图。导入成功后右下角提示「成功导入: 文件路径」。

查看导入的拓扑 ​

• 板卡层级与连接关系：拓扑图展示整机各板卡的层级结构与总线连接，查看能力与本地整机拓扑页面一致，但不支持切换板卡配置（配置选择框与导出配置按钮为禁用状态）。

• 在位状态：每块板卡以只读标签显示在位状态（在位/不在位），状态取自日志包记录。

实现原理 ​

数据来源 ​

导入模式的拓扑数据全部来自日志压缩包内部，不访问真机，各数据项来源如下：

connectors.txt 通常位于日志包的 dump_info/AppDump/hwdiscovery/ 目录下；工具同时支持在解压根目录及任意子目录中递归查找。.sr 文件从 connectors.txt 所在目录及其子目录中递归收集。

connectors.txt 格式示例 ​

connectors.txt 由 BMC 硬件自发现流程生成，前半部分是板卡树形结构，后半部分是每个 Connector 的属性详情：

root
├─Connector_BMC
│├─Connector_PCPU_1
│└─Connector_PCPU_2
└─Connector_PSU_1

Connector_BMC:
.Buses: ["I2c_1","I2c_2"]
.Type: BMC
.Presence: 1
.IdentifyMode: 2

Connector_PSU_1:
.Buses: ["I2c_3"]
.Type: PSU
.Presence: 0
.IdentifyMode: 2

• 树形部分：通过行首的 ├─、└─、│ 符号表达层级，每个节点即一块板卡的 Connector，对应 SR 文件名为 节点名.sr（如 Connector_PCPU_1.sr）。

• 详情部分：Connector_XXX: 开启一个 Connector 段，其下以 .属性: 值 逐行列出属性。其中 Presence 决定在位标签（1=在位，0=不在位），Buses 决定上游总线连线。

处理流程 ​

1. 解压：调用系统 tar（zip 在 Linux 下用 unzip）将日志包解压到固定临时目录。
2. 查找 connectors.txt：按「解压根目录 → dump_info/AppDump/hwdiscovery/ → 递归子目录」的顺序查找。
3. 解析：拆分树形结构与 Connector 详情段，得到拓扑树骨架与各 Connector 属性。
4. 收集 SR 文件：递归收集同目录下全部 .sr 文件并解析缓存到内存。
5. 构建拓扑：将 Connector 属性与 SR 文件按名称（去除末尾 _序号 后缀）匹配，生成前端拓扑树并渲染。

功能验证 ​

导入完成后，可按以下检查项验证功能是否正常：

常见问题 ​

远程模式连接 BMC 环境 ​

远程模式支持连接真机 BMC 环境，自动从运行时数据（mdbctl 调试命令 + 框架日志）构建整机 CSR 拓扑，实时展示板卡实际在位情况。无需从 BMC 手动导出数据再导入，选择环境即可出图，适用于真机调试、板卡适配验证与在位异常定位。

使用前准备 ​

• 已安装并启用 BMC环境管理 插件（openubmc.bmcstudio-bmc-remote），并添加至少一条 BMC 连接。连接的添加方法参见 BMC环境管理插件 章节。
• 目标 BMC 运行 openUBMC 固件，开放 Telnet 调试通道（23 端口免认证调试 shell），且板上具备 mdbctl 调试命令。
• 开发机无需安装 telnet 客户端，扩展使用内置连接直连。

连接 BMC 环境 ​

1. 在 CSR 拓扑侧边栏视图标题栏，点击「远程调试」按钮。

2. 在顶部弹出的环境选择框中，选择目标 BMC 环境。列表展示全部已配置连接，并实时探测在线状态（在线/离线图标 + 账号信息）。

3. 选择后显示「正在加载 xx 环境的 CSR 拓扑」进度通知，工具自动读取真机运行时的 Connector 对象与 SR 加载记录并构建拓扑。

4. 加载完成后，拓扑图工具栏显示当前连接的环境名称与 IP，主编辑区渲染整机实时拓扑。

查看实时拓扑 ​

• 真实在位状态：拓扑以真机运行时数据为准（而非静态 root.sr 配置），每块板卡显示实际在位/不在位状态。
• EEPROM 板卡：CSR 烧录在 EEPROM（而非 .sr 文件）的板卡会被自动解码，与文件板卡同等展示，双击同样可查看内容。
• 板卡 SR 下钻：双击板卡即可进入单板视图查看该板卡的 SR 内容。
• 在位调试：板卡节点上的在位开关可点击切换，模拟板卡拔插，详见下文「在位调试」。

在位调试 ​

远程模式下，点击板卡节点上的在位开关即可模拟板卡拔插，验证下级板卡的加载逻辑，无需物理操作真机。

普通在位属性 ​

Presence 为固定值（1/0）的板卡，节点上显示单个在位开关。点击开关后：

1. 工具通过 mdbctl setprop 向真机下发修改，更新该 Connector 的 Presence 值；
2. 重新读取运行时在位状态并重建拓扑（不重新读取 SR 文件）；
3. 下级板卡的加载状态随 Presence 变化体现在拓扑上。

同步属性（多开关） ​

Presence 为表达式（引用其他对象属性，如多个物理在位开关共用一个 Connector）时，节点上会按同步源渲染多个开关，每个开关对应一个同步源对象的属性。点击单个开关只修改对应同步源对象的属性值，适用于逐个验证各物理开关对板卡加载的影响。

实现原理 ​

数据来源 ​

远程模式的拓扑数据来自真机运行时，全部通过 Telnet 调试通道（23 端口）自动采集，各数据项来源如下：

通过日志查看 Connector 加载的文件 ​

每个 Connector 实际加载的 SR 文件记录在 BMC 的框架日志 /var/log/framework.log 中，由硬件自发现流程打印，共两类记录：

记录一（init.lua，板卡加载主源）——每个 Connector 加载 SR 时打印，position 即该 Connector 的 GroupPosition：

2026-08-20 10:15:32 hwdiscovery NOTICE: init.lua(152): position: 0101011A, get csr data from /opt/bmc/sr/14100513_pcie_card.sr, ...

记录二（dump.lua，根节点主源）——根板卡的加载只出现在此类记录中：

2026-08-20 10:15:30 hwdiscovery NOTICE: dump.lua(88): start to dump connector: root loading file: /opt/bmc/sr/root.sr

工具解析后的对应关系示例：

也可以在 BMC 上手动执行以下命令核对（与工具解析使用同一数据源）：

grep -E "get csr data from|start to dump connector" /var/log/framework.log

处理流程 ​

1. 连通性自检：通过 Telnet 23 端口连接目标 BMC，探测调试 shell 可用性。
2. 发现 Connector：执行 mdbctl lsobj connector 获取运行时全量 Connector 对象，再批量 mdbctl lsprop 读取每个 Connector 的 Presence 实际值。
3. 解析加载记录：读取 /var/log/framework.log（含历史 .gz 轮转文件），解析「position → SR 文件」与「运行时名 → 文件」两组映射。
4. 建树：按 Connector 的 GroupPosition 属性构建整机层级（去掉末两位十六进制即父节点位置）。
5. 读取 SR 内容：按映射从 /opt/bmc/sr/ 读取 .sr 文件；EEPROM 板卡读取 EEPROM 二进制（CDR 容器）并本地解码出 CSR。
6. 渲染：组装拓扑树、在位状态与 SR 数据，发送到拓扑图视图渲染。

功能验证 ​

连接环境并加载拓扑后，可按以下检查项验证功能是否正常：

常见问题 ​

能效调速配置 ​

能效调速配置功能提供能效调速对象的配置入口，支持通过Excel导入热设计表格解析调速曲线配置，支持对象自动关联及配置检查、CSR片段自动生成。

打开配置页面 ​

点击CSR拓扑侧边栏中的温度计图标即可开启能效调速配置页面。

配置能效调速对象 ​

1. 通过该页面配置能效调速对象，以及配置对象间的关联关系。

2. 点击右上角的"导入Excel"即可导入热设计表格，当前仅支持xlsx格式，若为其他格式请通过Excel另存为xlsx格式文件。完成导入后，温度点与调速曲线等配置可以自动解析。

3. 点击右上角"生成CSR"即可根据当前配置产生CSR代码片段，可以自行填入CSR文件中。生成CSR过程支持配置语法检查，禁止出现ID冲突等问题。

六、事件管理 ​

本章节介绍 openUBMC Studio 的事件管理功能。用户可以在 IDE 中查看和编辑 event_def.json 中的事件信息与描述模板，也可以查看、新增和保存事件与 CSR Event_ 对象的绑定关系。

功能说明 ​

BMC 事件字典定义了整机事件的事件标识、严重级别、事件编码和描述模板等标准信息。事件管理提供以下能力：

• 事件字典管理：查看、筛选和搜索全部事件，编辑基础字段与中英文描述模板，新建自定义事件模板，以及还原或导出差量。
• CSR 绑定管理：查看事件在 SR 文件中绑定的 Event_ 对象，可视化新增、编辑和删除绑定，并批量保存到 SR 文件。

根据打开入口，事件管理提供以下两种视图：

两种视图共用同一套事件字典与编辑能力，仅 CSR 绑定的聚合范围不同。

使用前准备 ​

• 模型配置：已完成产品和规则集选择，事件字典基线来自 Conan 规则包中的 event_def.json。
• 拓扑项目：已通过拓扑侧边栏创建配置并添加 CSR 仓库，当前工作区存在可用的 SR 上下文。

打开事件管理 ​

• 打开整机视图：进入总拓扑页面，单击工具栏中的“事件管理”。

• 打开单板卡视图：进入单 SR 拓扑视图，单击“事件管理”。此时 CSR 绑定范围限定为当前 SR 文件。

事件管理会在独立面板中打开，不影响原拓扑页面。

查看事件管理界面 ​

事件管理界面由工具栏、事件列表、编辑横幅、分页栏和详情面板组成。

• 工具栏：提供新建事件模板、重新拉取、导出、清除全部筛选和搜索功能。
• 事件列表：展示全部事件，支持列头筛选和分页。
• 编辑横幅：存在未导出的编辑时，以黄色或绿色横幅提示导出。
• 详情面板：单击事件行后显示在界面右侧。拖动面板左边缘可以在约 280～700px 范围内调整宽度，单击“×”可以关闭面板。

筛选和搜索事件 ​

查看列表字段 ​

设置筛选条件 ​

1. 单击“级别”“CSR 绑定”“分类”“机型支持”或“恢复上报”列头中的筛选按钮。
2. 勾选需要保留的选项。每个选项会显示对应的事件数量。
3. 如需清空当前列的条件，再次打开筛选菜单并单击“清空筛选”。

右上角搜索框支持按 EventKeyId、事件名称或事件编码进行模糊搜索。存在筛选或搜索条件时，工具栏会显示“清除全部筛选（N）”，单击后可以恢复完整列表。

设置分页 ​

底部分页栏支持将每页数量设置为 20、40、80 或 100 条，也支持按页码跳转。没有事件数据时，可以通过空状态入口新建事件模板；存在数据但被过滤时，可以通过空状态入口清除筛选。

新建和编辑事件 ​

新建事件模板 ​

1. 单击工具栏中的“新建事件模板”。
2. 在右侧详情面板中编辑新模板。

新建的自定义事件会置于列表顶部并自动选中。详情面板底部提供“删除该自定义事件模板”按钮。

编辑基础字段 ​

1. 在事件列表中单击目标事件。

2. 在右侧详情面板中打开“基础信息”页签。

基础字段说明如下：

编辑描述模板 ​

“描述模板”区域提供以下四类内容的中英文编辑，单击右上角的“中”或“EN”可以切换语言：

• Description：描述。
• Cause：可能原因。
• Influence：影响。
• Suggestion：处理建议。

还原事件数据 ​

• 还原单个事件：单击详情面板标题行中的“还原”，丢弃该事件的全部本地编辑并恢复为字典基线值。

• 重新拉取全部事件：单击工具栏中的“重新拉取”，在确认窗口中继续操作。完成后，事件管理会丢弃全部编辑，从 Conan 包重新读取事件字典，并将筛选、搜索和分页恢复为初始状态。

查看并导出修改 ​

存在未同步的编辑时，列表上方会显示编辑横幅。

• 查看修改：打开变化清单后，可以单击事件标识定位到对应事件，也可以单独还原某个事件。
• 导出事件字典：导出的 event_def.json 包含全部事件定义与描述模板，文件版本号末段自动加一，例如从 1.0.0 更新为 1.0.1。导出后，请将文件提交到 VPD 仓库进行同步。
• 导出机型事件清单：导出的 eventDefList.txt 仅包含“机型支持”为“是”的事件标识。

管理 CSR 绑定 ​

CSR 绑定描述事件与 SR 文件中 Event_ 对象的对应关系。在详情面板中打开“CSR 绑定”页签，可以查看和编辑绑定。

查看 CSR 绑定 ​

页签顶部显示当前视图类型和事件的绑定总数。绑定以卡片形式展示，每张卡片会标注所属 SR 文件，悬停后可以查看完整路径。

新增 CSR 绑定 ​

1. 单击详情面板底部的“CSR 绑定”。

2. 在新增卡片中填写绑定字段。

3. 如果当前处于整机视图，选择“目标 SR 文件”。整机根文件 root.sr 不在候选范围内；单板卡视图会自动使用当前 SR 文件。

4. 单击“确定”，批量保存本次绑定修改。

查看绑定字段 ​

验证保存结果 ​

• “确定”仅在存在修改且表单校验通过时可用；单击“取消”会放弃本次全部修改。
• 对象名为空、未以 Event_ 开头或在组内重名时，对应输入框会显示错误。
• 保存成功后，绑定列表和绑定数量会自动刷新，事件列表会定位到当前事件。
• 在编辑器中直接保存 SR 文件后，绑定列表和绑定数量也会自动刷新。

常见问题 ​

• 事件字段是否需要手动保存？ 不需要。字段与描述模板编辑会在停止输入约 1 秒后写入本地缓存，并在关闭面板时落盘；CSR 绑定修改需要单击“确定”保存到 SR 文件。
• 重新拉取后编辑全部消失：此行为符合预期。“重新拉取”会丢弃全部本地差量并恢复到字典基线。
• CSR 绑定提示对象名必须以 Event_ 开头：事件对象名必须带有固定前缀，并且不能只有 Event_ 前缀。
• 整机视图与单板卡视图的绑定数量不一致：两种视图的聚合范围分别为全部 SR 文件和当前 SR 文件，因此数量可能不同。
• 还原事件后列表中的绑定数量未变化：“还原”仅丢弃事件字典的本地差量，不修改 CSR 绑定。
• 导出的文件应提交到哪里？ event_def.json 与 eventDefList.txt 均用于提交到 VPD 仓库，具体流程遵循团队的字典变更管理规范。
• 新建的模板在筛选结果中不可见：新建模板时会自动清空筛选。如模板仍不可见，请检查搜索词和列头筛选条件。

七、日志诊断与告警链条分析 ​

一键日志解析插件（扩展 ID：openubmc.bmcstudio-log-reviewer）用于导入 BMC 一键日志包或 dump 目录，并通过可视化页面和 AI Agent 分析设备状态。用户可以浏览硬件、告警、传感器、性能及原始日志，也可以结合 openUBMC RAG 进行日志体检，或通过告警证据工具分析指定事件的触发链条。

功能说明 ​

日志诊断提供以下使用方式：

使用前准备 ​

如果活动栏中没有“一键日志解析”图标，请先执行以下操作：

1. 在 openUBMC Studio 中打开插件市场，搜索“一键日志解析”。
2. 安装插件，并按照提示重新加载窗口。
3. 确认活动栏中出现“一键日志解析”图标。

使用 Agent 日志体检前，还需要满足以下条件：

• 已登录 openUBMC 社区。
• openubmc-rag 扩展已启用。
• 当前网络可以访问配置的 LightRAG 服务。
• AI Agent 可以访问 openUBMC Studio MCP 工具。

AI Agent 会在读取日志前检查 RAG 状态。未登录、RAG 工具未启用、网络异常或状态响应无法解析时，日志体检会停止并显示处理建议。

打开一键日志 ​

一键日志解析支持 Windows、Linux、WSL、SSH 远程工作区和容器工作区。

支持导入以下内容：

• .tar.gz、.tgz、.tar 或 .zip 格式的 BMC 一键日志压缩包。
• 已解压且包含 AppDump 子目录的 dump 文件夹。

操作步骤如下：

1. 单击活动栏中的“一键日志解析”图标。

2. 根据日志形态，选择“打开 BMC 一键日志压缩包”或“打开 dump 目录”。

3. 选择日志压缩包或 dump 根目录。选择目录时，应选中包含 AppDump 子目录的 dump 根目录。

4. 等待解压和解析完成，确认日志页面已在编辑器区域打开。

也可以通过以下入口打开日志：

• 在资源管理器中右键单击日志压缩包或 dump 文件夹，选择对应的一键日志解析命令。
• 单击“最近打开”中的历史记录，重新打开对应日志。

“最近打开”最多保存 30 条记录。同一日志已经打开时，再次打开只会定位到原页面。删除一条最近记录时，对应的日志页面也会关闭。

查看日志包要求 ​

日志包中必须存在名称完全匹配的 AppDump 目录，典型结构如下：

dump_info/
├── AppDump/
├── LogDump/
├── RTOSDump/
└── OSDump/

插件最多向下查找 6 层目录。AppDump 是导入日志时的必需目录；缺少 LogDump、RTOSDump 或 OSDump 时，日志包仍可能打开，但对应页面会显示无数据或目录缺失。

查看诊断信息 ​

日志面板按照不同领域组织现场信息，常用视图包括：

• 现场概览：查看机型、健康状态、FRU、板卡和软件版本。
• 告警与传感器：查看告警记录、活动状态、传感器读值和门限信息。
• 运行状态：查看性能、功率、进风温度、调速策略和 PID 配置。
• 硬件关联：查看线缆检测、同步属性、CSR 和丝印信息。
• 日志与诊断：查看操作日志、应用日志、框架日志、维护日志、驱动日志、串口日志、journalctl、一键日志原始文件和故障诊断文件。
• 智能检测：使用 AI Agent 和 openUBMC RAG 进行日志体检。

不同页面按需解析日志文件，不会在导入时将所有文件一次性加载到内存。日志视图支持筛选、大小写匹配、全字匹配、正则表达式、匹配项跳转和保存搜索，具体可用项以当前视图为准。

使用 Agent 进行日志体检 ​

日志体检会将本地日志证据与 openUBMC RAG 检索结果关联，并按照严重程度、紧急度和置信度排列问题。故障案例库是可信度最高的知识来源，但不是唯一可用来源。

复制分析 Prompt ​

1. 打开日志页面顶部的“智能检测”。

2. 单击“复制 Prompt 模板”。

3. 将 Prompt 粘贴到能够访问 openUBMC Studio MCP 工具的 AI Agent 中。

4. 发送 Prompt，等待 AI Agent 完成 RAG 状态检查并开始分析。

Prompt 已包含以下约束，无需手动填写日志路径：

• 包含当前日志包的显示名称、分析任务标识和回调地址。
• 只允许读取当前分析任务绑定的日志包。
• 必须先检查 RAG 连接和社区登录状态。
• 必须保留 RAG 引用的真实来源，其中故障案例库来源具有最高可信度。
• 每个问题必须同时提供 RAG 匹配内容和本地日志证据。
• 分析完成后，按照用户配置的 TopN 返回结果。

查看实时问题 ​

AI Agent 分析期间，每个已确认的问题会实时显示在“Agent 日志问题”区域。问题卡片包含以下内容：

• 严重程度：CRITICAL、HIGH、MEDIUM 或 LOW。
• 紧急度：综合故障影响、恶化可能、冗余能力和修复窗口计算的 0～100 分。
• 置信度：本地多源证据与 RAG 知识的一致程度。
• 可能原因和处理建议。
• RAG 匹配内容、来源及可信度。
• 日志片段、日志包内相对路径和定位信息。

同一根因产生的重复现象应合并为一个问题。分析完成后，插件会依次按照严重程度、紧急度和置信度排序，并展示最紧急的 TopN 问题。

配置 TopN ​

TopN 默认值为 10，可以设置为 1～50：

1. 单击“一键日志解析”侧边栏标题栏中的齿轮图标。
2. 在设置页面中修改 bmcstudio.logReviewer.analysisTopN。
3. 创建新的分析会话，使新设置生效。

TopN 只限制分析完成后页面和 PDF 报告中展示的问题数量。AI Agent 可以在分析过程中回写更多候选问题，插件会在完成时统一排序和截取。已经打开的分析会话继续使用创建会话时的 TopN 值；如需让同一日志使用新的 TopN，请先从“最近打开”中删除该日志，再重新导入并发起分析。

导出 PDF 报告 ​

“导出为 PDF 报告”仅在分析状态变为“已完成”后可用：

1. 确认页面显示“Agent 智能分析：已完成”。
2. 单击“导出为 PDF 报告”。
3. 选择保存路径和文件名。
4. 使用 PDF 阅读器打开报告，核对摘要、问题排序、RAG 内容、日志证据和处理建议。

报告在当前 openUBMC Studio 扩展宿主运行期间可以持续导出。完全关闭或重启 openUBMC Studio 后，内存中的分析会话不会保留，需要重新发起分析。

处理会话异常 ​

使用 AI Agent 定向诊断日志 ​

在 AI Agent 对话中提供日志路径和分析目标，例如：

请打开并诊断 /path/to/bmc-log.tar.gz，先给出设备健康概览、关键异常和对应证据位置。

openUBMC Studio 会打开同一份日志的可视化面板，同时将机型、健康状态、硬件清单、告警、传感器、性能、调速、线缆和 CSR 等结构化数据提供给 AI Agent。后续可以继续要求 AI Agent 聚焦某个领域，例如：

继续分析当前日志中的散热异常，关联传感器、调速策略、功率和相关运行日志。

分析告警链条 ​

分析单条告警时，建议提供以下任一组定位信息：

• 事件码和发生时间。事件码格式为 0x 后接 8 位十六进制数字，时间格式为 YYYY-MM-DD HH:mm:ss。
• sel.txt 中的事件记录 ID。openUBMC Studio 可以据此解析事件码和发生时间。
• 需要区分多个告警实例时，再补充组件或实例名称。

示例：

基于当前打开的一键日志，分析事件码 0x12345678、时间 2026-08-28 14:23:16 的完整告警触发链。
请说明当前告警状态、已观察到和缺失的阶段、恢复与复发情况，并在每个节点标注证据文件及行号或数据库记录位置。

AI Agent 会根据日志中的实际证据按需给出以下内容：

• 唯一告警锚点及其匹配方式，避免混淆相同事件码的不同告警实例。
• 告警当前状态，包括 active、inactive、conflicted 或 unknown，并分别列出状态依据。
• 已观察到的触发流程，例如采样、数值转换、门限或事件规则求值、事件存储和北向上报；未采集到的阶段会标记为缺失。
• 运行期事件与 dump 内 .sr 文件中 CSR Event/PowerEvent 定义、属性和直接引用关系的关联结果。
• Assert/Deassert 恢复配对、复发次数下界、历史覆盖范围和可能的时钟跳变。
• 每个关键事实对应的 dump 相对路径、行号、列号、JSON Pointer 或数据库定位信息。

了解数据范围和安全边界 ​

• AI Agent 日志工具只能访问分析任务绑定的日志包，不会自动选择其他历史日志。
• 日志证据使用日志包内相对路径，不会向页面回写宿主绝对路径。
• 日志体检唯一允许访问的外部知识是 openUBMC RAG 状态和知识检索结果。
• tar 系列导入会拒绝路径逃逸、绝对路径和解压炸弹，并忽略符号链接、硬链接及设备文件。
• PDF 报告只包含当前分析会话中的摘要、TopN 问题、RAG 依据和日志证据。

八、BMC 环境管理 ​

本章介绍 openUBMC Studio 的 BMC环境管理 插件（扩展 ID：openubmc.bmcstudio-bmc-remote）的功能与使用方法。该插件用于在 IDE 内集中管理多台 BMC 环境、批量下发命令、上传文件、一键升级固件、实时监控日志、自动调试组件以及远程 GDB 调试。

BMC环境管理插件在活动栏注册一个「BMC环境管理」容器，下设两个视图：

• BMC Environments：BMC 环境连接树，按分组组织，管理连接的元数据与凭据。
• Command Macros：命令宏树，维护可批量下发的命令序列。

插件的核心能力包括：

• 连接管理：以分组方式管理多台 BMC，单条连接可任选 SSH、Telnet 或 WebView 方式接入。
• 连通性管理：手动或周期性探测 BMC 可达性，并在状态变化时播报。
• 命令宏：预定义命令序列与变量，按「全部可达 / 分组 / 手动多选」批量下发，回收结构化结果。
• SFTP 上传：从资源管理器右键将本地文件或目录上传到 BMC。
• HPM 一键升级：右键 .hpm 固件包，并发升级多台 BMC，全程进度可视。
• 实时日志监控：实时 tail 远端 /var/log 日志，支持日志轮转衔接、时间回绕校准与原始文件下载。
• 组件自动调试：根据 Git 变更自动部署 Lua、C/C++ 和北向接口调试内容，详见 C/C++、Lua 与北向接口快速调试。
• 远程 GDB 调试：附加板端服务或部署独立程序进行源码级调试，详见 BMC 远程 GDB 调试。
• MCP 工具：对外暴露 27 个 MCP 工具，供 AI Agent 调用，实现自然语言驱动的批量运维与告警证据分析。

使用前准备 ​

环境要求 ​

• 运行平台：推荐 Linux（Ubuntu）。连接管理以 Linux 为目标平台；HPM 升级与日志监控仅依赖 Node 内置模块，三平台行为一致。
• 系统依赖：建议预装以下工具：
  • openssh-client：SSH 接入与 SFTP 上传。
  • telnet：Telnet 接入与实时日志监控。
  • tar（支持 -z）：目录上传与日志下载解压。
  • libsecret-1-0 / gnome-keyring：Linux 下用于安全存储密码。

安装插件 ​

1. 在 openUBMC Studio 中打开插件市场（活动栏的「扩展」图标，或按 Ctrl+Shift+X），搜索「BMC环境管理」，点击「安装」。
2. 安装完成后重启 IDE 生效。活动栏出现「BMC环境管理」图标即表示安装成功。

BMC 环境管理 ​

新增分组 ​

连接以「分组」为单位组织，系统默认创建一个分组。

1. 在 BMC Environments 视图标题栏单击「Add Group」按钮。
2. 输入分组名称并确认。

分组的右键菜单支持「Add」「Rename Group」「Delete Group」。分组非空时拒绝删除（保护数据），需先清空或迁移其下连接。

新增连接 ​

1. 单击 BMC Environments 视图标题栏「Add BMC Environment」按钮，或在某个分组上右键选择「Add」。
2. 在弹出的表单中填写连接信息并保存。

连接字段说明：

接入 BMC ​

在连接上右键，选择接入方式：

• Connect via SSH：使用进程内 SSH 客户端登录（兼容老款 BMC 的弱算法与 keyboard-interactive 交互），以伪终端呈现。默认在编辑器区（接近全屏）打开，由配置项 bmc.autoMaximizeTerminal 控制，关闭后回到底部面板。
• Connect via Telnet：调用系统 telnet 命令接入，需本机已安装 telnet。Telnet 不会自动发送密码，需手动输入。
• Open in WebView：使用系统浏览器打开 BMC Web UI（https://{host}）。

SSH 握手超时由 bmc.connectionTimeout（默认 30 秒）控制。

编辑与删除 ​

• Edit Configuration / Change Password：修改连接信息。编辑密码时留空表示保留原密码。
• Disconnect：发送 exit、关闭终端并注销会话。
• Delete：删除前会弹出模态确认；删除会先关闭相关终端并清理该连接的凭据。

连通性管理 ​

插件通过 TCP 探测 SSH 22 端口判断 BMC 可达性，连接树图标实时反映状态（不可达时变红），分组徽章显示「X/Y 可达」。

• 手动探测单个：右键连接 → 「Check Connection Health」，提示可达 / 不可达。
• 全量刷新：单击视图标题栏「Refresh」，先把全部连接置为检测中再统一探测。
• 周期检测：右键连接 → 「开启自动检测连通状态」/「关闭自动检测连通状态」。开启后每 10 秒 探测一轮，仅对开启该项的连接生效。
• 状态播报：右键连接 → 「开启连通性变更播报」/「关闭连通性变更播报」。上线提示「{分组}/{名称} 已上电」，掉线提示「{名称} 已下电」。

探测超时由 bmc.pingTimeout（默认 3000 毫秒）控制。可达性 = 「TCP 22 端口通 + 已配置凭据」；运行宏、上传、升级前均以此作为就绪判据。

命令宏 ​

命令宏用于预定义「一组有序 shell 命令 + 变量 + 失败策略」，运行时按目标范围批量下发到 BMC，每台环境复用一条 SSH 连接执行完整命令集，并回收结构化的「环境 × 命令」结果矩阵。

新建宏 ​

1. 单击 Command Macros 视图标题栏「Add Command Macro」按钮。
2. 在表单中填写宏内容并保存。

宏字段说明：

变量替换 ​

命令模板支持变量占位：

• 语法：$VAR 或 ${VAR}；$ 转义为字面 `---

一、简介 ​

openUBMC Studio 是一款基于 Code - OSS 的 openUBMC 集成开发环境，面向 openUBMC 开发、调试和构建场景。

最近版本新增功能 ​

下表按发布时间倒序汇总 openUBMC Studio 最近三个版本的新增功能，单击功能名称可跳转到对应章节。当前收录 2026 年 8 月和 9 月发布的版本；后续发布新版本时，仅保留最近三个版本。

主要特性 ​

openUBMC Studio 的主要特性包括：

• 智能代码辅助：提供代码跳转、定义预览和引用查找等功能。
• 实时错误检查：基于规则集检测代码错误和潜在问题。
• 表达式计算器：支持 CSR 表达式的编写、调试和批量测试。
• SMC 命令字配置：提供可视化的 SMC 命令字解析和配置工具。
• 模型配置：支持产品和规则集的选择与配置。
• CSR 拓扑可视化与调试：支持本地、日志和远程三种整机拓扑模式，提供总线异常检测、单板卡配置、日志包离线还原和真机在位调试。
• 事件管理：支持查看和编辑事件字典、描述模板及 CSR 事件绑定。
• 能效调速配置：支持通过 Excel 导入热设计表格并生成 CSR 调速曲线代码。
• Manifest 可视化配置：支持配置构建变体、组件依赖、默认特性和组件特性，并提供配置诊断。
• 组件与固件联合构建：支持从业务组件仓构建本地组件包，在隔离 Manifest 中验证选包并转入固件出包。
• 一键出包：支持选择机型和包型，完成出包预检、固件构建、日志查看和产物下载。
• 签名配置：支持管理 HPM 和 EEPROM 签名档案，并生成或吊销本地自签名证书。
• AI 引导环境初始化：支持通过 AI Agent 完成社区开发环境初始化。
• 日志诊断与告警链条分析：支持导入 BMC 一键日志进行可视化诊断、Agent 日志体检和告警链条分析。
• C/C++、Lua 与北向接口快速调试：支持按照 Git 变更规划直接部署或隔离构建，将最小替换集部署到 BMC 并验证结果。
• BMC 远程 GDB 调试：支持附加板端服务，或部署独立程序进行源码级调试。
• BMC 环境管理插件：集中管理多台 BMC，支持连接与分组、命令宏、SFTP/HPM 升级和日志监控。
• 白牌包定制：支持可视化定制 Web 风格、Logo、图片和产品信息，并构建白牌包或清白牌包。
• 社区集成：对接 openUBMC 社区资源和服务。

二、AI 引导环境初始化 ​

openUBMC Studio 提供 AI 引导环境初始化能力。将预置 Prompt 发送给 AI Agent（例如 opencode、Claude Code 或 Cursor）后，AI Agent 会检测当前状态、诊断问题，并按顺序引导用户完成社区开发环境初始化。

使用前准备 ​

• 已安装并能正常使用 AI Agent，例如 opencode、Claude Code 或 Cursor。

打开配置引导 ​

1. 在欢迎页面中单击“配置引导”入口。

2. 在打开的配置引导窗口中找到“AI 引导初始化”卡片。

复制引导指令 ​

1. 单击“复制指令”卡片，打开 Prompt 对话框。

2. 单击“复制到 AI Agent”，将 Prompt 复制到剪贴板。

3. 切换到 AI Agent，粘贴并发送 Prompt。

了解 AI 引导流程 ​

AI Agent 接收到 Prompt 后，会按以下流程引导用户完成环境初始化：

1. GitCode 登录认证：AI Agent 打开 OAuth 登录窗口，并在用户授权后检测登录状态。
2. 环境检测与部署：AI Agent 检测操作系统。Windows 用户可以选择 Docker（约 5 分钟）或 WSL（约 30 分钟）部署方式，Linux 用户直接进入环境配置。
3. 规则集配置：AI Agent 引导用户在 openUBMC Studio 界面中选择机型和规则集，并通过 localview_get_data_source 验证配置是否生效。
4. 状态写回：每个步骤完成后，AI Agent 会回写向导状态；全部步骤完成后，向导状态变为“已完成”。

验证初始化结果 ​

1. 确认配置引导窗口显示初始化已完成。

2. 返回欢迎页面，确认状态栏中的登录状态、机型和规则集信息已更新。

常见问题 ​

• Docker SSH 连接失败：检查容器内 sshd 是否启动、10022 端口是否开放，以及密钥认证是否配置正确。
• Conan 鉴权失败：检查 GitCode 登录状态是否有效，重新登录后重试。
• 规则集未生效：在 openUBMC Studio 状态栏中确认是否已选择机型和规则集，必要时重新配置。

三、登录到社区 ​

openUBMC Studio提供了便捷的社区登录功能，通过社区登录可以获取更多资源和服务支持。

登录步骤 ​

1. 点击IDE右下角状态栏中的登录图标

2. 在弹出的登录页面中输入您的openUBMC社区账号和密码

3. 点击“登录”按钮完成登录

登录状态保持 ​

登录成功后，IDE会自动保持和刷新登录状态：

• 自动刷新：IDE会定期刷新登录状态，确保持续有效
• 状态保持：退出IDE后，登录状态会继续保持一段时间
• 自动重连：重新打开IDE时，会自动尝试使用上一次的登录状态重新登录

Conan中心仓集成 ​

登录社区后，IDE会自动同步登录到Conan中心仓：

• 登录状态自动保持并刷新
• 只要IDE处于登录状态，Conan就处于登录状态
• 在执行出包等操作时不会因为认证问题而超时

四、CSR 编码辅助 ​

openUBMC Studio提供了强大的CSR编码辅助功能，包括引用跳转、规则检查、表达式计算器和SMC计算器等，帮助开发者快速定位代码、发现问题并提高开发效率。

模型配置 ​

使用CSR编码辅助功能前，需要先完成模型配置。登录IDE后，点击Web版Studio状态栏中的"未选择机型"按钮，按以下步骤操作：

1. 在模型配置页面中，选择对应的产品和规则集。

2. 确认产品信息后，选择需要配置的模型文件。

3. 配置模型文件对应的代码仓和分支信息。

4. 完成配置后，点击"确定"保存配置。模型配置完成后，规则检查、拓扑配置等功能即可正常使用。

引用跳转功能 ​

引用跳转功能可以帮助开发者快速定位代码定义和引用位置，支持多种跳转方式，大幅提高代码阅读和导航效率。

转到定义 ​

1. 在代码编辑器中，将光标定位到需要查看定义的符号上。

2. 使用以下任一方式跳转到定义：

   • 右键点击符号，选择“转到定义”
   • 按住 Ctrl 键，点击符号

3. 编辑器将自动跳转到符号的定义位置。

转到引用 ​

1. 在代码编辑器中，将光标定位到需要查看引用的符号上。

2. 使用以下任一方式查看引用：

   • 按下 Shift + F12 键
   • 右键点击符号，选择“转到引用”

3. 在侧边栏将显示所有引用该符号的位置列表。

4. 点击列表中的项可跳转到对应的引用位置。

鼠标悬停预览定义 ​

1. 在代码编辑器中，将鼠标悬停在符号上。

2. 等待片刻，将显示符号的定义预览窗口。

基本规则错误检查功能 ​

openUBMC Studio内置了CSR规则检查功能，模型配置完成后即可支持CSR语法与配置约束的实时检查。该功能支持错误位置高亮和规则自动更新，帮助开发者在编码阶段就发现潜在问题。

实时检查 ​

模型配置后，在openUBMC Studio中打开任意CSR文件，检查自动生效：

页面中的类型错误和格式错误都会被实时拦截：

表达式中的语法错误也可以被实时拦截：

查看检查结果 ​

1. 错误和警告会以波浪线形式标注在代码中：

   • 红色波浪线：表示错误（Error）
   • 黄色波浪线：表示警告（Warning）

2. 查看"问题"面板：

   • 点击底部"问题"标签页
   • 查看所有错误和警告列表
   • 点击列表项可快速定位到对应代码位置

复杂规则校验 ​

openUBMC Studio已建立复杂规则校验能力，可以在社区代码仓 openubmc_dsl_rulepack 中开发业务相关的检查规则，自定义规则同样支持实时检查功能。

表达式计算器功能 ​

表达式计算器是openUBMC Studio提供的强大工具，用于编写、调试和测试CSR表达式，帮助开发者快速验证表达式的正确性。

打开表达式计算器 ​

1. 打开CSR文件，在表达式上方将显示“计算表达式”按钮

2. 点击“计算表达式”按钮，表达式计算器窗口将在右侧打开

表达式计算器界面 ​

表达式计算器界面包含以下部分：

• 表达式编辑区：显示和编辑当前选中的表达式
• 模式切换按钮：可以在“调试模式”和“用例模式”之间切换
• 变量面板：显示当前表达式中可用的变量及其值
• 结果面板：显示表达式计算结果和各级管道的计算过程

修改表达式 ​

1. 在表达式编辑区查看或修改表达式

2. 修改完成后，点击“保存到文件”按钮保存修改

3. 保存后，表达式计算器会自动重新加载表达式

4. 源文件中的表达式修改并保存后，表达式编辑页面也会自动重新加载

调试表达式 ​

1. 在表达式编辑区查看表达式内容

2. 在变量面板中输入或修改变量值

3. 完成输入后，系统将自动计算：

   • 各级管道的中间结果
   • 最终表达式结果

表达式批量用例测试 ​

1. 在表达式计算器中， 点击“用例模式”按钮切换到批量测试模式

2. 创建测试用例：

   • 按照要求输入测试用例名称和参数值以及结果值

3. 执行批量测试：

   • 点击“加载用例”加载所有测试用例
   • 点击“Execute all”执行所有测试用例
   • 查看验证报告，显示每个用例的执行结果

SMC计算器功能 ​

SMC计算器用于解析和配置SMC命令字，帮助开发者快速理解和生成SMC命令，简化SMC相关的开发工作。

打开SMC计算器 ​

1. 打开CSR文件，定位到Scanner或Accessor的offset字段

2. 点击offset字段上方显示的"计算偏移量"按钮

3. SMC计算器窗口将在右侧打开

SMC命令字解析 ​

SMC计算器提供了强大的命令字解析功能：

1. 自动解析：当前偏移量会被自动解析，显示各字段的含义
2. 实时计算：修改下方输入框的数据内容将自动更新和计算偏移量
3. 应用到文件：点击“应用”按钮可以将计算结果写入到CSR文件
4. 字段提示：鼠标悬停在字段上方可以显示具体的字段含义和说明

SMC命令字可视化辅助 ​

openUBMC Studio提供了直观的SMC命令字可视化功能：

1. 水印显示：SMC命令字将在CSR中以水印形式显示字段内容，方便查看

2. 悬停详情：鼠标悬停在offset字段上将显示偏移量的详细信息，包括：

   • 各字段的值
   • 字段的含义
   • 完整的偏移量计算结果

五、拓扑与 CSR 可视化配置 ​

CSR 拓扑插件提供整机和单板卡两个维度的总线及器件拓扑可视化。0.3.7 版本新增本地、日志和远程三种整机拓扑模式，并支持总线异常检测、日志包离线还原、真机在位调试以及单板卡可视化配置。

创建拓扑配置 ​

1. 单击 openUBMC Studio 左侧的拓扑十字形侧边栏图标。

2. 单击“创建配置”。

3. 单击“添加仓库”，选择 CSR 文件夹，即可在该机型配置中使用来自该文件夹的 CSR。可以添加多个 CSR 代码仓，单击右下角的“确定”即可创建项目。

4. 创建完成后，拓扑起点为 root.sr。

CSR 整机拓扑 ​

CSR 整机拓扑图提供整机维度与单 CSR 维度的总线及器件拓扑可视化：以板卡为节点展示整机的层级结构、Connector 连接关系与总线连线，支持双击板卡下钻到单板视图、从器件库拖拽器件完成配置。根据数据来源不同，拓扑图分为三种使用模式：本地模式、日志模式与远程模式。

三种模式对比与选择 ​

根据手头资源选择：

• 有整机 CSR 代码仓，需要搭建或修改拓扑配置 → 本地模式（见下文「本地模式」）。
• 只有现场日志压缩包，需要还原收集时刻的整机拓扑 → 日志模式（完整指南见导入 BMC 日志压缩包查看 CSR 拓扑）。
• 有可达真机 BMC，需要查看实时在位或调试板卡加载 → 远程模式（完整指南见远程模式连接 BMC 环境）。

模式切换：日志模式与远程模式均为临时查看模式，重新从侧边栏加载本地拓扑（如切换机型或点击侧边栏文件节点）即恢复本地模式，导入日志产生的临时解压目录会自动清理。

界面说明 ​

拓扑图中的主要元素如下：

• 板卡节点：每个节点代表一块板卡，显示板卡类型、SR 文件名与对应的板型示意图；根节点为 root.sr（BMC 主板）。
• 在位状态：节点左上角显示在位标签或开关，含义与可操作性随模式不同，详见各模式说明。
• 板卡选择器：本地模式下，尚未确定 SR 的节点提供候选板卡列表与数量选择器，用于配置下游板卡。
• 总线连线与连接桩：连线表示上游 Connector 传入的总线，由上游板卡的连接桩连向下游板卡；总线配置不一致时会出现红色连线或异常标志。
• 单板下钻：双击整机拓扑页面的任意板卡，或点击左侧 CSR 列表中的文件，即可打开单 CSR 配置页面，查看该板卡 SR 的板内拓扑与详情。
• 工具栏：配置选择框与「导出配置」按钮用于整机拓扑的多配置管理，仅本地模式可用。

本地模式 ​

本地模式是默认模式，数据来自模型配置的本地 CSR 代码仓，用于日常开发中搭建与修改整机拓扑。

查看整机拓扑 ​

点击侧边栏拓扑插件图标，进入整机拓扑图页面，显示如下：

1. 总线连线：板卡之间的连线为上游 Connector 传入的总线，将鼠标悬停在总线上可显示总线名称。

2. 总线异常检测：自动检测上游 Connector 传入总线与下游板卡 Anchor 中定义总线的一致性。

   1. 总线类型不匹配

      当上游 Connector 的 Buses 和下游板卡 Anchor 的 Buses 同一索引位置的总线类型不一致时，总线显示为红色，将鼠标悬停在图标上可查看具体信息。

      总线类型判断逻辑：取总线名称前缀，若前缀相同，则认为类型匹配。

   2. 上游多传入总线

      当上游 Connector 的 Buses 数量大于下游板卡 Anchor 的 Buses 数量时，Connector 的 Buses 数组中多出的总线会被识别为上游多传入总线。板卡左下角会显示红色异常标志，将鼠标悬停在标志上可查看具体信息。

   3. 下游板卡多出总线

      当上游 Connector 的 Buses 数量小于下游板卡 Anchor 的 Buses 数量时，下游板卡 Anchor 的 Buses 数组中多出的总线会被识别为下游多定义总线。板卡左下角会显示红色异常标志，将鼠标悬停在标志上可查看具体信息。

3. 板卡合并：SR 文件中的不同 Connector 加载同一个文件时，拓扑图会将其合并为一张板卡。

配置整机拓扑 ​

1. 可通过板卡上方选项在整机拓扑中选择对应板卡，各板卡可选下游板卡数量和类型由该板卡的 Connector 配置决定；尚未确定 SR 的节点通过板卡选择器从候选列表中指定 SR 文件。所有配置信息会自动在本地持久化。

2. 双击整机拓扑页面的任意板卡，或点击左侧 CSR 列表中的文件，即可打开单 CSR 配置页面。

3. 通过工具栏的配置选择框可在多套整机配置之间切换，点击「导出配置」可导出当前配置。

在位状态 ​

本地模式根据 SR 文件中上游 Connector 的 IdentifyMode 和 Presence 值显示在位状态，单击开关可切换：

1. 板卡在位状态

2. 切换在位状态：单击开关可同步修改上游 Connector 中 Presence 的值。

CSR 单板卡配置 ​

双击整机拓扑页面的任意板卡，或单击左侧 CSR 列表中的文件，即可打开单 CSR 配置页面。单板卡视图支持新增、删除总线或器件，以及修改 Mux 总线的 ChannelId。也可以按 Ctrl + Z 撤销、按 Ctrl + Y 恢复。

定位器件 ​

单击器件，右侧 SR 文件会自动定位到该器件对象所在的位置。

修改 ChannelId ​

单击器件上方的 ChannelId 数字方块，可修改其值。

新增总线 ​

单击 + 图标，选择总线类型并填写总线后缀，然后单击“确定”新增总线。

删除器件、总线 ​

将鼠标悬停在器件或总线上，单击鼠标右键并选择“删除”。

拖拽器件 ​

打开器件库，将器件拖拽到总线上即可将器件挂载到总线，同时自动修改对应 CSR 文件内容。也可以拖拽器件到可下连的器件卡片上进行挂载。

导入 BMC 日志压缩包查看 CSR 拓扑 ​

openUBMC Studio 支持导入 BMC 一键收集的日志压缩包，在离线环境下还原当前整机加载的 CSR 及其拓扑关系。适用于现场问题定位与离线日志分析：拿到日志包即可查看板卡层级结构、连接关系与在位情况，无需连接真机。

使用前准备 ​

• 已安装 openUBMC Studio 并启用 CSR 拓扑插件（随主插件提供）。
• 准备 BMC 一键收集的日志压缩包，支持 zip、tar、tgz、gz（含 .tar.gz）格式。
• 本机需可执行 tar 命令（日志包解压依赖系统 tar）。

导入日志压缩包 ​

1. 在 openUBMC Studio 左侧 CSR 拓扑侧边栏视图标题栏，点击「导入日志包」按钮。

2. 在弹出的文件选择框中，选择 BMC 日志压缩包并点击「选择日志压缩包」确认。

3. 工具自动解压并解析日志包中的 connectors.txt，随后在主编辑区渲染整机 CSR 拓扑图。导入成功后右下角提示「成功导入: 文件路径」。

查看导入的拓扑 ​

• 板卡层级与连接关系：拓扑图展示整机各板卡的层级结构与总线连接，查看能力与本地整机拓扑页面一致，但不支持切换板卡配置（配置选择框与导出配置按钮为禁用状态）。

• 在位状态：每块板卡以只读标签显示在位状态（在位/不在位），状态取自日志包记录。

实现原理 ​

数据来源 ​

导入模式的拓扑数据全部来自日志压缩包内部，不访问真机，各数据项来源如下：

connectors.txt 通常位于日志包的 dump_info/AppDump/hwdiscovery/ 目录下；工具同时支持在解压根目录及任意子目录中递归查找。.sr 文件从 connectors.txt 所在目录及其子目录中递归收集。

connectors.txt 格式示例 ​

connectors.txt 由 BMC 硬件自发现流程生成，前半部分是板卡树形结构，后半部分是每个 Connector 的属性详情：

root
├─Connector_BMC
│├─Connector_PCPU_1
│└─Connector_PCPU_2
└─Connector_PSU_1

Connector_BMC:
.Buses: ["I2c_1","I2c_2"]
.Type: BMC
.Presence: 1
.IdentifyMode: 2

Connector_PSU_1:
.Buses: ["I2c_3"]
.Type: PSU
.Presence: 0
.IdentifyMode: 2

• 树形部分：通过行首的 ├─、└─、│ 符号表达层级，每个节点即一块板卡的 Connector，对应 SR 文件名为 节点名.sr（如 Connector_PCPU_1.sr）。

• 详情部分：Connector_XXX: 开启一个 Connector 段，其下以 .属性: 值 逐行列出属性。其中 Presence 决定在位标签（1=在位，0=不在位），Buses 决定上游总线连线。

处理流程 ​

1. 解压：调用系统 tar（zip 在 Linux 下用 unzip）将日志包解压到固定临时目录。
2. 查找 connectors.txt：按「解压根目录 → dump_info/AppDump/hwdiscovery/ → 递归子目录」的顺序查找。
3. 解析：拆分树形结构与 Connector 详情段，得到拓扑树骨架与各 Connector 属性。
4. 收集 SR 文件：递归收集同目录下全部 .sr 文件并解析缓存到内存。
5. 构建拓扑：将 Connector 属性与 SR 文件按名称（去除末尾 _序号 后缀）匹配，生成前端拓扑树并渲染。

功能验证 ​

导入完成后，可按以下检查项验证功能是否正常：

常见问题 ​

远程模式连接 BMC 环境 ​

远程模式支持连接真机 BMC 环境，自动从运行时数据（mdbctl 调试命令 + 框架日志）构建整机 CSR 拓扑，实时展示板卡实际在位情况。无需从 BMC 手动导出数据再导入，选择环境即可出图，适用于真机调试、板卡适配验证与在位异常定位。

使用前准备 ​

• 已安装并启用 BMC环境管理 插件（openubmc.bmcstudio-bmc-remote），并添加至少一条 BMC 连接。连接的添加方法参见 BMC环境管理插件 章节。
• 目标 BMC 运行 openUBMC 固件，开放 Telnet 调试通道（23 端口免认证调试 shell），且板上具备 mdbctl 调试命令。
• 开发机无需安装 telnet 客户端，扩展使用内置连接直连。

连接 BMC 环境 ​

1. 在 CSR 拓扑侧边栏视图标题栏，点击「远程调试」按钮。

2. 在顶部弹出的环境选择框中，选择目标 BMC 环境。列表展示全部已配置连接，并实时探测在线状态（在线/离线图标 + 账号信息）。

3. 选择后显示「正在加载 xx 环境的 CSR 拓扑」进度通知，工具自动读取真机运行时的 Connector 对象与 SR 加载记录并构建拓扑。

4. 加载完成后，拓扑图工具栏显示当前连接的环境名称与 IP，主编辑区渲染整机实时拓扑。

查看实时拓扑 ​

• 真实在位状态：拓扑以真机运行时数据为准（而非静态 root.sr 配置），每块板卡显示实际在位/不在位状态。
• EEPROM 板卡：CSR 烧录在 EEPROM（而非 .sr 文件）的板卡会被自动解码，与文件板卡同等展示，双击同样可查看内容。
• 板卡 SR 下钻：双击板卡即可进入单板视图查看该板卡的 SR 内容。
• 在位调试：板卡节点上的在位开关可点击切换，模拟板卡拔插，详见下文「在位调试」。

在位调试 ​

远程模式下，点击板卡节点上的在位开关即可模拟板卡拔插，验证下级板卡的加载逻辑，无需物理操作真机。

普通在位属性 ​

Presence 为固定值（1/0）的板卡，节点上显示单个在位开关。点击开关后：

1. 工具通过 mdbctl setprop 向真机下发修改，更新该 Connector 的 Presence 值；
2. 重新读取运行时在位状态并重建拓扑（不重新读取 SR 文件）；
3. 下级板卡的加载状态随 Presence 变化体现在拓扑上。

同步属性（多开关） ​

Presence 为表达式（引用其他对象属性，如多个物理在位开关共用一个 Connector）时，节点上会按同步源渲染多个开关，每个开关对应一个同步源对象的属性。点击单个开关只修改对应同步源对象的属性值，适用于逐个验证各物理开关对板卡加载的影响。

实现原理 ​

数据来源 ​

远程模式的拓扑数据来自真机运行时，全部通过 Telnet 调试通道（23 端口）自动采集，各数据项来源如下：

通过日志查看 Connector 加载的文件 ​

每个 Connector 实际加载的 SR 文件记录在 BMC 的框架日志 /var/log/framework.log 中，由硬件自发现流程打印，共两类记录：

记录一（init.lua，板卡加载主源）——每个 Connector 加载 SR 时打印，position 即该 Connector 的 GroupPosition：

2026-08-20 10:15:32 hwdiscovery NOTICE: init.lua(152): position: 0101011A, get csr data from /opt/bmc/sr/14100513_pcie_card.sr, ...

记录二（dump.lua，根节点主源）——根板卡的加载只出现在此类记录中：

2026-08-20 10:15:30 hwdiscovery NOTICE: dump.lua(88): start to dump connector: root loading file: /opt/bmc/sr/root.sr

工具解析后的对应关系示例：

也可以在 BMC 上手动执行以下命令核对（与工具解析使用同一数据源）：

grep -E "get csr data from|start to dump connector" /var/log/framework.log

处理流程 ​

1. 连通性自检：通过 Telnet 23 端口连接目标 BMC，探测调试 shell 可用性。
2. 发现 Connector：执行 mdbctl lsobj connector 获取运行时全量 Connector 对象，再批量 mdbctl lsprop 读取每个 Connector 的 Presence 实际值。
3. 解析加载记录：读取 /var/log/framework.log（含历史 .gz 轮转文件），解析「position → SR 文件」与「运行时名 → 文件」两组映射。
4. 建树：按 Connector 的 GroupPosition 属性构建整机层级（去掉末两位十六进制即父节点位置）。
5. 读取 SR 内容：按映射从 /opt/bmc/sr/ 读取 .sr 文件；EEPROM 板卡读取 EEPROM 二进制（CDR 容器）并本地解码出 CSR。
6. 渲染：组装拓扑树、在位状态与 SR 数据，发送到拓扑图视图渲染。

功能验证 ​

连接环境并加载拓扑后，可按以下检查项验证功能是否正常：

常见问题 ​

能效调速配置 ​

能效调速配置功能提供能效调速对象的配置入口，支持通过Excel导入热设计表格解析调速曲线配置，支持对象自动关联及配置检查、CSR片段自动生成。

打开配置页面 ​

点击CSR拓扑侧边栏中的温度计图标即可开启能效调速配置页面。

配置能效调速对象 ​

1. 通过该页面配置能效调速对象，以及配置对象间的关联关系。

2. 点击右上角的"导入Excel"即可导入热设计表格，当前仅支持xlsx格式，若为其他格式请通过Excel另存为xlsx格式文件。完成导入后，温度点与调速曲线等配置可以自动解析。

3. 点击右上角"生成CSR"即可根据当前配置产生CSR代码片段，可以自行填入CSR文件中。生成CSR过程支持配置语法检查，禁止出现ID冲突等问题。

六、事件管理 ​

本章节介绍 openUBMC Studio 的事件管理功能。用户可以在 IDE 中查看和编辑 event_def.json 中的事件信息与描述模板，也可以查看、新增和保存事件与 CSR Event_ 对象的绑定关系。

功能说明 ​

BMC 事件字典定义了整机事件的事件标识、严重级别、事件编码和描述模板等标准信息。事件管理提供以下能力：

• 事件字典管理：查看、筛选和搜索全部事件，编辑基础字段与中英文描述模板，新建自定义事件模板，以及还原或导出差量。
• CSR 绑定管理：查看事件在 SR 文件中绑定的 Event_ 对象，可视化新增、编辑和删除绑定，并批量保存到 SR 文件。

根据打开入口，事件管理提供以下两种视图：

两种视图共用同一套事件字典与编辑能力，仅 CSR 绑定的聚合范围不同。

使用前准备 ​

• 模型配置：已完成产品和规则集选择，事件字典基线来自 Conan 规则包中的 event_def.json。
• 拓扑项目：已通过拓扑侧边栏创建配置并添加 CSR 仓库，当前工作区存在可用的 SR 上下文。

打开事件管理 ​

• 打开整机视图：进入总拓扑页面，单击工具栏中的“事件管理”。

• 打开单板卡视图：进入单 SR 拓扑视图，单击“事件管理”。此时 CSR 绑定范围限定为当前 SR 文件。

事件管理会在独立面板中打开，不影响原拓扑页面。

查看事件管理界面 ​

事件管理界面由工具栏、事件列表、编辑横幅、分页栏和详情面板组成。

• 工具栏：提供新建事件模板、重新拉取、导出、清除全部筛选和搜索功能。
• 事件列表：展示全部事件，支持列头筛选和分页。
• 编辑横幅：存在未导出的编辑时，以黄色或绿色横幅提示导出。
• 详情面板：单击事件行后显示在界面右侧。拖动面板左边缘可以在约 280～700px 范围内调整宽度，单击“×”可以关闭面板。

筛选和搜索事件 ​

查看列表字段 ​

设置筛选条件 ​

1. 单击“级别”“CSR 绑定”“分类”“机型支持”或“恢复上报”列头中的筛选按钮。
2. 勾选需要保留的选项。每个选项会显示对应的事件数量。
3. 如需清空当前列的条件，再次打开筛选菜单并单击“清空筛选”。

右上角搜索框支持按 EventKeyId、事件名称或事件编码进行模糊搜索。存在筛选或搜索条件时，工具栏会显示“清除全部筛选（N）”，单击后可以恢复完整列表。

设置分页 ​

底部分页栏支持将每页数量设置为 20、40、80 或 100 条，也支持按页码跳转。没有事件数据时，可以通过空状态入口新建事件模板；存在数据但被过滤时，可以通过空状态入口清除筛选。

新建和编辑事件 ​

新建事件模板 ​

1. 单击工具栏中的“新建事件模板”。
2. 在右侧详情面板中编辑新模板。

新建的自定义事件会置于列表顶部并自动选中。详情面板底部提供“删除该自定义事件模板”按钮。

编辑基础字段 ​

1. 在事件列表中单击目标事件。

2. 在右侧详情面板中打开“基础信息”页签。

基础字段说明如下：

编辑描述模板 ​

“描述模板”区域提供以下四类内容的中英文编辑，单击右上角的“中”或“EN”可以切换语言：

• Description：描述。
• Cause：可能原因。
• Influence：影响。
• Suggestion：处理建议。

还原事件数据 ​

• 还原单个事件：单击详情面板标题行中的“还原”，丢弃该事件的全部本地编辑并恢复为字典基线值。

• 重新拉取全部事件：单击工具栏中的“重新拉取”，在确认窗口中继续操作。完成后，事件管理会丢弃全部编辑，从 Conan 包重新读取事件字典，并将筛选、搜索和分页恢复为初始状态。

查看并导出修改 ​

存在未同步的编辑时，列表上方会显示编辑横幅。

• 查看修改：打开变化清单后，可以单击事件标识定位到对应事件，也可以单独还原某个事件。
• 导出事件字典：导出的 event_def.json 包含全部事件定义与描述模板，文件版本号末段自动加一，例如从 1.0.0 更新为 1.0.1。导出后，请将文件提交到 VPD 仓库进行同步。
• 导出机型事件清单：导出的 eventDefList.txt 仅包含“机型支持”为“是”的事件标识。

管理 CSR 绑定 ​

CSR 绑定描述事件与 SR 文件中 Event_ 对象的对应关系。在详情面板中打开“CSR 绑定”页签，可以查看和编辑绑定。

查看 CSR 绑定 ​

页签顶部显示当前视图类型和事件的绑定总数。绑定以卡片形式展示，每张卡片会标注所属 SR 文件，悬停后可以查看完整路径。

新增 CSR 绑定 ​

1. 单击详情面板底部的“CSR 绑定”。

2. 在新增卡片中填写绑定字段。

3. 如果当前处于整机视图，选择“目标 SR 文件”。整机根文件 root.sr 不在候选范围内；单板卡视图会自动使用当前 SR 文件。

4. 单击“确定”，批量保存本次绑定修改。

查看绑定字段 ​

验证保存结果 ​

• “确定”仅在存在修改且表单校验通过时可用；单击“取消”会放弃本次全部修改。
• 对象名为空、未以 Event_ 开头或在组内重名时，对应输入框会显示错误。
• 保存成功后，绑定列表和绑定数量会自动刷新，事件列表会定位到当前事件。
• 在编辑器中直接保存 SR 文件后，绑定列表和绑定数量也会自动刷新。

常见问题 ​

• 事件字段是否需要手动保存？ 不需要。字段与描述模板编辑会在停止输入约 1 秒后写入本地缓存，并在关闭面板时落盘；CSR 绑定修改需要单击“确定”保存到 SR 文件。
• 重新拉取后编辑全部消失：此行为符合预期。“重新拉取”会丢弃全部本地差量并恢复到字典基线。
• CSR 绑定提示对象名必须以 Event_ 开头：事件对象名必须带有固定前缀，并且不能只有 Event_ 前缀。
• 整机视图与单板卡视图的绑定数量不一致：两种视图的聚合范围分别为全部 SR 文件和当前 SR 文件，因此数量可能不同。
• 还原事件后列表中的绑定数量未变化：“还原”仅丢弃事件字典的本地差量，不修改 CSR 绑定。
• 导出的文件应提交到哪里？ event_def.json 与 eventDefList.txt 均用于提交到 VPD 仓库，具体流程遵循团队的字典变更管理规范。
• 新建的模板在筛选结果中不可见：新建模板时会自动清空筛选。如模板仍不可见，请检查搜索词和列头筛选条件。

七、日志诊断与告警链条分析 ​

一键日志解析插件（扩展 ID：openubmc.bmcstudio-log-reviewer）用于导入 BMC 一键日志包或 dump 目录，并通过可视化页面和 AI Agent 分析设备状态。用户可以浏览硬件、告警、传感器、性能及原始日志，也可以结合 openUBMC RAG 进行日志体检，或通过告警证据工具分析指定事件的触发链条。

功能说明 ​

日志诊断提供以下使用方式：

使用前准备 ​

如果活动栏中没有“一键日志解析”图标，请先执行以下操作：

1. 在 openUBMC Studio 中打开插件市场，搜索“一键日志解析”。
2. 安装插件，并按照提示重新加载窗口。
3. 确认活动栏中出现“一键日志解析”图标。

使用 Agent 日志体检前，还需要满足以下条件：

• 已登录 openUBMC 社区。
• openubmc-rag 扩展已启用。
• 当前网络可以访问配置的 LightRAG 服务。
• AI Agent 可以访问 openUBMC Studio MCP 工具。

AI Agent 会在读取日志前检查 RAG 状态。未登录、RAG 工具未启用、网络异常或状态响应无法解析时，日志体检会停止并显示处理建议。

打开一键日志 ​

一键日志解析支持 Windows、Linux、WSL、SSH 远程工作区和容器工作区。

支持导入以下内容：

• .tar.gz、.tgz、.tar 或 .zip 格式的 BMC 一键日志压缩包。
• 已解压且包含 AppDump 子目录的 dump 文件夹。

操作步骤如下：

1. 单击活动栏中的“一键日志解析”图标。

2. 根据日志形态，选择“打开 BMC 一键日志压缩包”或“打开 dump 目录”。

3. 选择日志压缩包或 dump 根目录。选择目录时，应选中包含 AppDump 子目录的 dump 根目录。

4. 等待解压和解析完成，确认日志页面已在编辑器区域打开。

也可以通过以下入口打开日志：

• 在资源管理器中右键单击日志压缩包或 dump 文件夹，选择对应的一键日志解析命令。
• 单击“最近打开”中的历史记录，重新打开对应日志。

“最近打开”最多保存 30 条记录。同一日志已经打开时，再次打开只会定位到原页面。删除一条最近记录时，对应的日志页面也会关闭。

查看日志包要求 ​

日志包中必须存在名称完全匹配的 AppDump 目录，典型结构如下：

dump_info/
├── AppDump/
├── LogDump/
├── RTOSDump/
└── OSDump/

插件最多向下查找 6 层目录。AppDump 是导入日志时的必需目录；缺少 LogDump、RTOSDump 或 OSDump 时，日志包仍可能打开，但对应页面会显示无数据或目录缺失。

查看诊断信息 ​

日志面板按照不同领域组织现场信息，常用视图包括：

• 现场概览：查看机型、健康状态、FRU、板卡和软件版本。
• 告警与传感器：查看告警记录、活动状态、传感器读值和门限信息。
• 运行状态：查看性能、功率、进风温度、调速策略和 PID 配置。
• 硬件关联：查看线缆检测、同步属性、CSR 和丝印信息。
• 日志与诊断：查看操作日志、应用日志、框架日志、维护日志、驱动日志、串口日志、journalctl、一键日志原始文件和故障诊断文件。
• 智能检测：使用 AI Agent 和 openUBMC RAG 进行日志体检。

不同页面按需解析日志文件，不会在导入时将所有文件一次性加载到内存。日志视图支持筛选、大小写匹配、全字匹配、正则表达式、匹配项跳转和保存搜索，具体可用项以当前视图为准。

使用 Agent 进行日志体检 ​

日志体检会将本地日志证据与 openUBMC RAG 检索结果关联，并按照严重程度、紧急度和置信度排列问题。故障案例库是可信度最高的知识来源，但不是唯一可用来源。

复制分析 Prompt ​

1. 打开日志页面顶部的“智能检测”。

2. 单击“复制 Prompt 模板”。

3. 将 Prompt 粘贴到能够访问 openUBMC Studio MCP 工具的 AI Agent 中。

4. 发送 Prompt，等待 AI Agent 完成 RAG 状态检查并开始分析。

Prompt 已包含以下约束，无需手动填写日志路径：

• 包含当前日志包的显示名称、分析任务标识和回调地址。
• 只允许读取当前分析任务绑定的日志包。
• 必须先检查 RAG 连接和社区登录状态。
• 必须保留 RAG 引用的真实来源，其中故障案例库来源具有最高可信度。
• 每个问题必须同时提供 RAG 匹配内容和本地日志证据。
• 分析完成后，按照用户配置的 TopN 返回结果。

查看实时问题 ​

AI Agent 分析期间，每个已确认的问题会实时显示在“Agent 日志问题”区域。问题卡片包含以下内容：

• 严重程度：CRITICAL、HIGH、MEDIUM 或 LOW。
• 紧急度：综合故障影响、恶化可能、冗余能力和修复窗口计算的 0～100 分。
• 置信度：本地多源证据与 RAG 知识的一致程度。
• 可能原因和处理建议。
• RAG 匹配内容、来源及可信度。
• 日志片段、日志包内相对路径和定位信息。

同一根因产生的重复现象应合并为一个问题。分析完成后，插件会依次按照严重程度、紧急度和置信度排序，并展示最紧急的 TopN 问题。

配置 TopN ​

TopN 默认值为 10，可以设置为 1～50：

1. 单击“一键日志解析”侧边栏标题栏中的齿轮图标。
2. 在设置页面中修改 bmcstudio.logReviewer.analysisTopN。
3. 创建新的分析会话，使新设置生效。

TopN 只限制分析完成后页面和 PDF 报告中展示的问题数量。AI Agent 可以在分析过程中回写更多候选问题，插件会在完成时统一排序和截取。已经打开的分析会话继续使用创建会话时的 TopN 值；如需让同一日志使用新的 TopN，请先从“最近打开”中删除该日志，再重新导入并发起分析。

导出 PDF 报告 ​

“导出为 PDF 报告”仅在分析状态变为“已完成”后可用：

1. 确认页面显示“Agent 智能分析：已完成”。
2. 单击“导出为 PDF 报告”。
3. 选择保存路径和文件名。
4. 使用 PDF 阅读器打开报告，核对摘要、问题排序、RAG 内容、日志证据和处理建议。

报告在当前 openUBMC Studio 扩展宿主运行期间可以持续导出。完全关闭或重启 openUBMC Studio 后，内存中的分析会话不会保留，需要重新发起分析。

处理会话异常 ​

使用 AI Agent 定向诊断日志 ​

在 AI Agent 对话中提供日志路径和分析目标，例如：

请打开并诊断 /path/to/bmc-log.tar.gz，先给出设备健康概览、关键异常和对应证据位置。

openUBMC Studio 会打开同一份日志的可视化面板，同时将机型、健康状态、硬件清单、告警、传感器、性能、调速、线缆和 CSR 等结构化数据提供给 AI Agent。后续可以继续要求 AI Agent 聚焦某个领域，例如：

继续分析当前日志中的散热异常，关联传感器、调速策略、功率和相关运行日志。

分析告警链条 ​

分析单条告警时，建议提供以下任一组定位信息：

• 事件码和发生时间。事件码格式为 0x 后接 8 位十六进制数字，时间格式为 YYYY-MM-DD HH:mm:ss。
• sel.txt 中的事件记录 ID。openUBMC Studio 可以据此解析事件码和发生时间。
• 需要区分多个告警实例时，再补充组件或实例名称。

示例：

基于当前打开的一键日志，分析事件码 0x12345678、时间 2026-08-28 14:23:16 的完整告警触发链。
请说明当前告警状态、已观察到和缺失的阶段、恢复与复发情况，并在每个节点标注证据文件及行号或数据库记录位置。

AI Agent 会根据日志中的实际证据按需给出以下内容：

• 唯一告警锚点及其匹配方式，避免混淆相同事件码的不同告警实例。
• 告警当前状态，包括 active、inactive、conflicted 或 unknown，并分别列出状态依据。
• 已观察到的触发流程，例如采样、数值转换、门限或事件规则求值、事件存储和北向上报；未采集到的阶段会标记为缺失。
• 运行期事件与 dump 内 .sr 文件中 CSR Event/PowerEvent 定义、属性和直接引用关系的关联结果。
• Assert/Deassert 恢复配对、复发次数下界、历史覆盖范围和可能的时钟跳变。
• 每个关键事实对应的 dump 相对路径、行号、列号、JSON Pointer 或数据库定位信息。

了解数据范围和安全边界 ​

• AI Agent 日志工具只能访问分析任务绑定的日志包，不会自动选择其他历史日志。
• 日志证据使用日志包内相对路径，不会向页面回写宿主绝对路径。
• 日志体检唯一允许访问的外部知识是 openUBMC RAG 状态和知识检索结果。
• tar 系列导入会拒绝路径逃逸、绝对路径和解压炸弹，并忽略符号链接、硬链接及设备文件。
• PDF 报告只包含当前分析会话中的摘要、TopN 问题、RAG 依据和日志证据。

八、BMC 环境管理 ​

本章介绍 openUBMC Studio 的 BMC环境管理 插件（扩展 ID：openubmc.bmcstudio-bmc-remote）的功能与使用方法。该插件用于在 IDE 内集中管理多台 BMC 环境、批量下发命令、上传文件、一键升级固件、实时监控日志、自动调试组件以及远程 GDB 调试。

BMC环境管理插件在活动栏注册一个「BMC环境管理」容器，下设两个视图：

• BMC Environments：BMC 环境连接树，按分组组织，管理连接的元数据与凭据。
• Command Macros：命令宏树，维护可批量下发的命令序列。

插件的核心能力包括：

• 连接管理：以分组方式管理多台 BMC，单条连接可任选 SSH、Telnet 或 WebView 方式接入。
• 连通性管理：手动或周期性探测 BMC 可达性，并在状态变化时播报。
• 命令宏：预定义命令序列与变量，按「全部可达 / 分组 / 手动多选」批量下发，回收结构化结果。
• SFTP 上传：从资源管理器右键将本地文件或目录上传到 BMC。
• HPM 一键升级：右键 .hpm 固件包，并发升级多台 BMC，全程进度可视。
• 实时日志监控：实时 tail 远端 /var/log 日志，支持日志轮转衔接、时间回绕校准与原始文件下载。
• 组件自动调试：根据 Git 变更自动部署 Lua、C/C++ 和北向接口调试内容，详见 C/C++、Lua 与北向接口快速调试。
• 远程 GDB 调试：附加板端服务或部署独立程序进行源码级调试，详见 BMC 远程 GDB 调试。
• MCP 工具：对外暴露 27 个 MCP 工具，供 AI Agent 调用，实现自然语言驱动的批量运维与告警证据分析。

使用前准备 ​

环境要求 ​

• 运行平台：推荐 Linux（Ubuntu）。连接管理以 Linux 为目标平台；HPM 升级与日志监控仅依赖 Node 内置模块，三平台行为一致。
• 系统依赖：建议预装以下工具：
  • openssh-client：SSH 接入与 SFTP 上传。
  • telnet：Telnet 接入与实时日志监控。
  • tar（支持 -z）：目录上传与日志下载解压。
  • libsecret-1-0 / gnome-keyring：Linux 下用于安全存储密码。

安装插件 ​

1. 在 openUBMC Studio 中打开插件市场（活动栏的「扩展」图标，或按 Ctrl+Shift+X），搜索「BMC环境管理」，点击「安装」。
2. 安装完成后重启 IDE 生效。活动栏出现「BMC环境管理」图标即表示安装成功。

BMC 环境管理 ​

新增分组 ​

连接以「分组」为单位组织，系统默认创建一个分组。

1. 在 BMC Environments 视图标题栏单击「Add Group」按钮。
2. 输入分组名称并确认。

分组的右键菜单支持「Add」「Rename Group」「Delete Group」。分组非空时拒绝删除（保护数据），需先清空或迁移其下连接。

新增连接 ​

1. 单击 BMC Environments 视图标题栏「Add BMC Environment」按钮，或在某个分组上右键选择「Add」。
2. 在弹出的表单中填写连接信息并保存。

连接字段说明：

接入 BMC ​

在连接上右键，选择接入方式：

• Connect via SSH：使用进程内 SSH 客户端登录（兼容老款 BMC 的弱算法与 keyboard-interactive 交互），以伪终端呈现。默认在编辑器区（接近全屏）打开，由配置项 bmc.autoMaximizeTerminal 控制，关闭后回到底部面板。
• Connect via Telnet：调用系统 telnet 命令接入，需本机已安装 telnet。Telnet 不会自动发送密码，需手动输入。
• Open in WebView：使用系统浏览器打开 BMC Web UI（https://{host}）。

SSH 握手超时由 bmc.connectionTimeout（默认 30 秒）控制。

编辑与删除 ​

• Edit Configuration / Change Password：修改连接信息。编辑密码时留空表示保留原密码。
• Disconnect：发送 exit、关闭终端并注销会话。
• Delete：删除前会弹出模态确认；删除会先关闭相关终端并清理该连接的凭据。

连通性管理 ​

插件通过 TCP 探测 SSH 22 端口判断 BMC 可达性，连接树图标实时反映状态（不可达时变红），分组徽章显示「X/Y 可达」。

• 手动探测单个：右键连接 → 「Check Connection Health」，提示可达 / 不可达。
• 全量刷新：单击视图标题栏「Refresh」，先把全部连接置为检测中再统一探测。
• 周期检测：右键连接 → 「开启自动检测连通状态」/「关闭自动检测连通状态」。开启后每 10 秒 探测一轮，仅对开启该项的连接生效。
• 状态播报：右键连接 → 「开启连通性变更播报」/「关闭连通性变更播报」。上线提示「{分组}/{名称} 已上电」，掉线提示「{名称} 已下电」。

探测超时由 bmc.pingTimeout（默认 3000 毫秒）控制。可达性 = 「TCP 22 端口通 + 已配置凭据」；运行宏、上传、升级前均以此作为就绪判据。

命令宏 ​

命令宏用于预定义「一组有序 shell 命令 + 变量 + 失败策略」，运行时按目标范围批量下发到 BMC，每台环境复用一条 SSH 连接执行完整命令集，并回收结构化的「环境 × 命令」结果矩阵。

新建宏 ​

1. 单击 Command Macros 视图标题栏「Add Command Macro」按钮。
2. 在表单中填写宏内容并保存。

宏字段说明：

一、简介 ​

openUBMC Studio 是一款基于 Code - OSS 的 openUBMC 集成开发环境，面向 openUBMC 开发、调试和构建场景。

最近版本新增功能 ​

下表按发布时间倒序汇总 openUBMC Studio 最近三个版本的新增功能，单击功能名称可跳转到对应章节。当前收录 2026 年 8 月和 9 月发布的版本；后续发布新版本时，仅保留最近三个版本。

主要特性 ​

openUBMC Studio 的主要特性包括：

• 智能代码辅助：提供代码跳转、定义预览和引用查找等功能。
• 实时错误检查：基于规则集检测代码错误和潜在问题。
• 表达式计算器：支持 CSR 表达式的编写、调试和批量测试。
• SMC 命令字配置：提供可视化的 SMC 命令字解析和配置工具。
• 模型配置：支持产品和规则集的选择与配置。
• CSR 拓扑可视化与调试：支持本地、日志和远程三种整机拓扑模式，提供总线异常检测、单板卡配置、日志包离线还原和真机在位调试。
• 事件管理：支持查看和编辑事件字典、描述模板及 CSR 事件绑定。
• 能效调速配置：支持通过 Excel 导入热设计表格并生成 CSR 调速曲线代码。
• Manifest 可视化配置：支持配置构建变体、组件依赖、默认特性和组件特性，并提供配置诊断。
• 组件与固件联合构建：支持从业务组件仓构建本地组件包，在隔离 Manifest 中验证选包并转入固件出包。
• 一键出包：支持选择机型和包型，完成出包预检、固件构建、日志查看和产物下载。
• 签名配置：支持管理 HPM 和 EEPROM 签名档案，并生成或吊销本地自签名证书。
• AI 引导环境初始化：支持通过 AI Agent 完成社区开发环境初始化。
• 日志诊断与告警链条分析：支持导入 BMC 一键日志进行可视化诊断、Agent 日志体检和告警链条分析。
• C/C++、Lua 与北向接口快速调试：支持按照 Git 变更规划直接部署或隔离构建，将最小替换集部署到 BMC 并验证结果。
• BMC 远程 GDB 调试：支持附加板端服务，或部署独立程序进行源码级调试。
• BMC 环境管理插件：集中管理多台 BMC，支持连接与分组、命令宏、SFTP/HPM 升级和日志监控。
• 白牌包定制：支持可视化定制 Web 风格、Logo、图片和产品信息，并构建白牌包或清白牌包。
• 社区集成：对接 openUBMC 社区资源和服务。

二、AI 引导环境初始化 ​

openUBMC Studio 提供 AI 引导环境初始化能力。将预置 Prompt 发送给 AI Agent（例如 opencode、Claude Code 或 Cursor）后，AI Agent 会检测当前状态、诊断问题，并按顺序引导用户完成社区开发环境初始化。

使用前准备 ​

• 已安装并能正常使用 AI Agent，例如 opencode、Claude Code 或 Cursor。

打开配置引导 ​

1. 在欢迎页面中单击“配置引导”入口。

2. 在打开的配置引导窗口中找到“AI 引导初始化”卡片。

复制引导指令 ​

1. 单击“复制指令”卡片，打开 Prompt 对话框。

2. 单击“复制到 AI Agent”，将 Prompt 复制到剪贴板。

3. 切换到 AI Agent，粘贴并发送 Prompt。

了解 AI 引导流程 ​

AI Agent 接收到 Prompt 后，会按以下流程引导用户完成环境初始化：

1. GitCode 登录认证：AI Agent 打开 OAuth 登录窗口，并在用户授权后检测登录状态。
2. 环境检测与部署：AI Agent 检测操作系统。Windows 用户可以选择 Docker（约 5 分钟）或 WSL（约 30 分钟）部署方式，Linux 用户直接进入环境配置。
3. 规则集配置：AI Agent 引导用户在 openUBMC Studio 界面中选择机型和规则集，并通过 localview_get_data_source 验证配置是否生效。
4. 状态写回：每个步骤完成后，AI Agent 会回写向导状态；全部步骤完成后，向导状态变为“已完成”。

验证初始化结果 ​

1. 确认配置引导窗口显示初始化已完成。

2. 返回欢迎页面，确认状态栏中的登录状态、机型和规则集信息已更新。

常见问题 ​

• Docker SSH 连接失败：检查容器内 sshd 是否启动、10022 端口是否开放，以及密钥认证是否配置正确。
• Conan 鉴权失败：检查 GitCode 登录状态是否有效，重新登录后重试。
• 规则集未生效：在 openUBMC Studio 状态栏中确认是否已选择机型和规则集，必要时重新配置。

三、登录到社区 ​

openUBMC Studio提供了便捷的社区登录功能，通过社区登录可以获取更多资源和服务支持。

登录步骤 ​

1. 点击IDE右下角状态栏中的登录图标

2. 在弹出的登录页面中输入您的openUBMC社区账号和密码

3. 点击“登录”按钮完成登录

登录状态保持 ​

登录成功后，IDE会自动保持和刷新登录状态：

• 自动刷新：IDE会定期刷新登录状态，确保持续有效
• 状态保持：退出IDE后，登录状态会继续保持一段时间
• 自动重连：重新打开IDE时，会自动尝试使用上一次的登录状态重新登录

Conan中心仓集成 ​

登录社区后，IDE会自动同步登录到Conan中心仓：

• 登录状态自动保持并刷新
• 只要IDE处于登录状态，Conan就处于登录状态
• 在执行出包等操作时不会因为认证问题而超时

四、CSR 编码辅助 ​

openUBMC Studio提供了强大的CSR编码辅助功能，包括引用跳转、规则检查、表达式计算器和SMC计算器等，帮助开发者快速定位代码、发现问题并提高开发效率。

模型配置 ​

使用CSR编码辅助功能前，需要先完成模型配置。登录IDE后，点击Web版Studio状态栏中的"未选择机型"按钮，按以下步骤操作：

1. 在模型配置页面中，选择对应的产品和规则集。

2. 确认产品信息后，选择需要配置的模型文件。

3. 配置模型文件对应的代码仓和分支信息。

4. 完成配置后，点击"确定"保存配置。模型配置完成后，规则检查、拓扑配置等功能即可正常使用。

引用跳转功能 ​

引用跳转功能可以帮助开发者快速定位代码定义和引用位置，支持多种跳转方式，大幅提高代码阅读和导航效率。

转到定义 ​

1. 在代码编辑器中，将光标定位到需要查看定义的符号上。

2. 使用以下任一方式跳转到定义：

   • 右键点击符号，选择“转到定义”
   • 按住 Ctrl 键，点击符号

3. 编辑器将自动跳转到符号的定义位置。

转到引用 ​

1. 在代码编辑器中，将光标定位到需要查看引用的符号上。

2. 使用以下任一方式查看引用：

   • 按下 Shift + F12 键
   • 右键点击符号，选择“转到引用”

3. 在侧边栏将显示所有引用该符号的位置列表。

4. 点击列表中的项可跳转到对应的引用位置。

鼠标悬停预览定义 ​

1. 在代码编辑器中，将鼠标悬停在符号上。

2. 等待片刻，将显示符号的定义预览窗口。

基本规则错误检查功能 ​

openUBMC Studio内置了CSR规则检查功能，模型配置完成后即可支持CSR语法与配置约束的实时检查。该功能支持错误位置高亮和规则自动更新，帮助开发者在编码阶段就发现潜在问题。

实时检查 ​

模型配置后，在openUBMC Studio中打开任意CSR文件，检查自动生效：

页面中的类型错误和格式错误都会被实时拦截：

表达式中的语法错误也可以被实时拦截：

查看检查结果 ​

1. 错误和警告会以波浪线形式标注在代码中：

   • 红色波浪线：表示错误（Error）
   • 黄色波浪线：表示警告（Warning）

2. 查看"问题"面板：

   • 点击底部"问题"标签页
   • 查看所有错误和警告列表
   • 点击列表项可快速定位到对应代码位置

复杂规则校验 ​

openUBMC Studio已建立复杂规则校验能力，可以在社区代码仓 openubmc_dsl_rulepack 中开发业务相关的检查规则，自定义规则同样支持实时检查功能。

表达式计算器功能 ​

表达式计算器是openUBMC Studio提供的强大工具，用于编写、调试和测试CSR表达式，帮助开发者快速验证表达式的正确性。

打开表达式计算器 ​

1. 打开CSR文件，在表达式上方将显示“计算表达式”按钮

2. 点击“计算表达式”按钮，表达式计算器窗口将在右侧打开

表达式计算器界面 ​

表达式计算器界面包含以下部分：

• 表达式编辑区：显示和编辑当前选中的表达式
• 模式切换按钮：可以在“调试模式”和“用例模式”之间切换
• 变量面板：显示当前表达式中可用的变量及其值
• 结果面板：显示表达式计算结果和各级管道的计算过程

修改表达式 ​

1. 在表达式编辑区查看或修改表达式

2. 修改完成后，点击“保存到文件”按钮保存修改

3. 保存后，表达式计算器会自动重新加载表达式

4. 源文件中的表达式修改并保存后，表达式编辑页面也会自动重新加载

调试表达式 ​

1. 在表达式编辑区查看表达式内容

2. 在变量面板中输入或修改变量值

3. 完成输入后，系统将自动计算：

   • 各级管道的中间结果
   • 最终表达式结果

表达式批量用例测试 ​

1. 在表达式计算器中， 点击“用例模式”按钮切换到批量测试模式

2. 创建测试用例：

   • 按照要求输入测试用例名称和参数值以及结果值

3. 执行批量测试：

   • 点击“加载用例”加载所有测试用例
   • 点击“Execute all”执行所有测试用例
   • 查看验证报告，显示每个用例的执行结果

SMC计算器功能 ​

SMC计算器用于解析和配置SMC命令字，帮助开发者快速理解和生成SMC命令，简化SMC相关的开发工作。

打开SMC计算器 ​

1. 打开CSR文件，定位到Scanner或Accessor的offset字段

2. 点击offset字段上方显示的"计算偏移量"按钮

3. SMC计算器窗口将在右侧打开

SMC命令字解析 ​

SMC计算器提供了强大的命令字解析功能：

1. 自动解析：当前偏移量会被自动解析，显示各字段的含义
2. 实时计算：修改下方输入框的数据内容将自动更新和计算偏移量
3. 应用到文件：点击“应用”按钮可以将计算结果写入到CSR文件
4. 字段提示：鼠标悬停在字段上方可以显示具体的字段含义和说明

SMC命令字可视化辅助 ​

openUBMC Studio提供了直观的SMC命令字可视化功能：

1. 水印显示：SMC命令字将在CSR中以水印形式显示字段内容，方便查看

2. 悬停详情：鼠标悬停在offset字段上将显示偏移量的详细信息，包括：

   • 各字段的值
   • 字段的含义
   • 完整的偏移量计算结果

五、拓扑与 CSR 可视化配置 ​

CSR 拓扑插件提供整机和单板卡两个维度的总线及器件拓扑可视化。0.3.7 版本新增本地、日志和远程三种整机拓扑模式，并支持总线异常检测、日志包离线还原、真机在位调试以及单板卡可视化配置。

创建拓扑配置 ​

1. 单击 openUBMC Studio 左侧的拓扑十字形侧边栏图标。

2. 单击“创建配置”。

3. 单击“添加仓库”，选择 CSR 文件夹，即可在该机型配置中使用来自该文件夹的 CSR。可以添加多个 CSR 代码仓，单击右下角的“确定”即可创建项目。

4. 创建完成后，拓扑起点为 root.sr。

CSR 整机拓扑 ​

CSR 整机拓扑图提供整机维度与单 CSR 维度的总线及器件拓扑可视化：以板卡为节点展示整机的层级结构、Connector 连接关系与总线连线，支持双击板卡下钻到单板视图、从器件库拖拽器件完成配置。根据数据来源不同，拓扑图分为三种使用模式：本地模式、日志模式与远程模式。

三种模式对比与选择 ​

根据手头资源选择：

• 有整机 CSR 代码仓，需要搭建或修改拓扑配置 → 本地模式（见下文「本地模式」）。
• 只有现场日志压缩包，需要还原收集时刻的整机拓扑 → 日志模式（完整指南见导入 BMC 日志压缩包查看 CSR 拓扑）。
• 有可达真机 BMC，需要查看实时在位或调试板卡加载 → 远程模式（完整指南见远程模式连接 BMC 环境）。

模式切换：日志模式与远程模式均为临时查看模式，重新从侧边栏加载本地拓扑（如切换机型或点击侧边栏文件节点）即恢复本地模式，导入日志产生的临时解压目录会自动清理。

界面说明 ​

拓扑图中的主要元素如下：

• 板卡节点：每个节点代表一块板卡，显示板卡类型、SR 文件名与对应的板型示意图；根节点为 root.sr（BMC 主板）。
• 在位状态：节点左上角显示在位标签或开关，含义与可操作性随模式不同，详见各模式说明。
• 板卡选择器：本地模式下，尚未确定 SR 的节点提供候选板卡列表与数量选择器，用于配置下游板卡。
• 总线连线与连接桩：连线表示上游 Connector 传入的总线，由上游板卡的连接桩连向下游板卡；总线配置不一致时会出现红色连线或异常标志。
• 单板下钻：双击整机拓扑页面的任意板卡，或点击左侧 CSR 列表中的文件，即可打开单 CSR 配置页面，查看该板卡 SR 的板内拓扑与详情。
• 工具栏：配置选择框与「导出配置」按钮用于整机拓扑的多配置管理，仅本地模式可用。

本地模式 ​

本地模式是默认模式，数据来自模型配置的本地 CSR 代码仓，用于日常开发中搭建与修改整机拓扑。

查看整机拓扑 ​

点击侧边栏拓扑插件图标，进入整机拓扑图页面，显示如下：

1. 总线连线：板卡之间的连线为上游 Connector 传入的总线，将鼠标悬停在总线上可显示总线名称。

2. 总线异常检测：自动检测上游 Connector 传入总线与下游板卡 Anchor 中定义总线的一致性。

   1. 总线类型不匹配

      当上游 Connector 的 Buses 和下游板卡 Anchor 的 Buses 同一索引位置的总线类型不一致时，总线显示为红色，将鼠标悬停在图标上可查看具体信息。

      总线类型判断逻辑：取总线名称前缀，若前缀相同，则认为类型匹配。

   2. 上游多传入总线

      当上游 Connector 的 Buses 数量大于下游板卡 Anchor 的 Buses 数量时，Connector 的 Buses 数组中多出的总线会被识别为上游多传入总线。板卡左下角会显示红色异常标志，将鼠标悬停在标志上可查看具体信息。

   3. 下游板卡多出总线

      当上游 Connector 的 Buses 数量小于下游板卡 Anchor 的 Buses 数量时，下游板卡 Anchor 的 Buses 数组中多出的总线会被识别为下游多定义总线。板卡左下角会显示红色异常标志，将鼠标悬停在标志上可查看具体信息。

3. 板卡合并：SR 文件中的不同 Connector 加载同一个文件时，拓扑图会将其合并为一张板卡。

配置整机拓扑 ​

1. 可通过板卡上方选项在整机拓扑中选择对应板卡，各板卡可选下游板卡数量和类型由该板卡的 Connector 配置决定；尚未确定 SR 的节点通过板卡选择器从候选列表中指定 SR 文件。所有配置信息会自动在本地持久化。

2. 双击整机拓扑页面的任意板卡，或点击左侧 CSR 列表中的文件，即可打开单 CSR 配置页面。

3. 通过工具栏的配置选择框可在多套整机配置之间切换，点击「导出配置」可导出当前配置。

在位状态 ​

本地模式根据 SR 文件中上游 Connector 的 IdentifyMode 和 Presence 值显示在位状态，单击开关可切换：

1. 板卡在位状态

2. 切换在位状态：单击开关可同步修改上游 Connector 中 Presence 的值。

CSR 单板卡配置 ​

双击整机拓扑页面的任意板卡，或单击左侧 CSR 列表中的文件，即可打开单 CSR 配置页面。单板卡视图支持新增、删除总线或器件，以及修改 Mux 总线的 ChannelId。也可以按 Ctrl + Z 撤销、按 Ctrl + Y 恢复。

定位器件 ​

单击器件，右侧 SR 文件会自动定位到该器件对象所在的位置。

修改 ChannelId ​

单击器件上方的 ChannelId 数字方块，可修改其值。

新增总线 ​

单击 + 图标，选择总线类型并填写总线后缀，然后单击“确定”新增总线。

删除器件、总线 ​

将鼠标悬停在器件或总线上，单击鼠标右键并选择“删除”。

拖拽器件 ​

打开器件库，将器件拖拽到总线上即可将器件挂载到总线，同时自动修改对应 CSR 文件内容。也可以拖拽器件到可下连的器件卡片上进行挂载。

导入 BMC 日志压缩包查看 CSR 拓扑 ​

openUBMC Studio 支持导入 BMC 一键收集的日志压缩包，在离线环境下还原当前整机加载的 CSR 及其拓扑关系。适用于现场问题定位与离线日志分析：拿到日志包即可查看板卡层级结构、连接关系与在位情况，无需连接真机。

使用前准备 ​

• 已安装 openUBMC Studio 并启用 CSR 拓扑插件（随主插件提供）。
• 准备 BMC 一键收集的日志压缩包，支持 zip、tar、tgz、gz（含 .tar.gz）格式。
• 本机需可执行 tar 命令（日志包解压依赖系统 tar）。

导入日志压缩包 ​

1. 在 openUBMC Studio 左侧 CSR 拓扑侧边栏视图标题栏，点击「导入日志包」按钮。

2. 在弹出的文件选择框中，选择 BMC 日志压缩包并点击「选择日志压缩包」确认。

3. 工具自动解压并解析日志包中的 connectors.txt，随后在主编辑区渲染整机 CSR 拓扑图。导入成功后右下角提示「成功导入: 文件路径」。

查看导入的拓扑 ​

• 板卡层级与连接关系：拓扑图展示整机各板卡的层级结构与总线连接，查看能力与本地整机拓扑页面一致，但不支持切换板卡配置（配置选择框与导出配置按钮为禁用状态）。

• 在位状态：每块板卡以只读标签显示在位状态（在位/不在位），状态取自日志包记录。

实现原理 ​

数据来源 ​

导入模式的拓扑数据全部来自日志压缩包内部，不访问真机，各数据项来源如下：

connectors.txt 通常位于日志包的 dump_info/AppDump/hwdiscovery/ 目录下；工具同时支持在解压根目录及任意子目录中递归查找。.sr 文件从 connectors.txt 所在目录及其子目录中递归收集。

connectors.txt 格式示例 ​

connectors.txt 由 BMC 硬件自发现流程生成，前半部分是板卡树形结构，后半部分是每个 Connector 的属性详情：

root
├─Connector_BMC
│├─Connector_PCPU_1
│└─Connector_PCPU_2
└─Connector_PSU_1

Connector_BMC:
.Buses: ["I2c_1","I2c_2"]
.Type: BMC
.Presence: 1
.IdentifyMode: 2

Connector_PSU_1:
.Buses: ["I2c_3"]
.Type: PSU
.Presence: 0
.IdentifyMode: 2

• 树形部分：通过行首的 ├─、└─、│ 符号表达层级，每个节点即一块板卡的 Connector，对应 SR 文件名为 节点名.sr（如 Connector_PCPU_1.sr）。

• 详情部分：Connector_XXX: 开启一个 Connector 段，其下以 .属性: 值 逐行列出属性。其中 Presence 决定在位标签（1=在位，0=不在位），Buses 决定上游总线连线。

处理流程 ​

1. 解压：调用系统 tar（zip 在 Linux 下用 unzip）将日志包解压到固定临时目录。
2. 查找 connectors.txt：按「解压根目录 → dump_info/AppDump/hwdiscovery/ → 递归子目录」的顺序查找。
3. 解析：拆分树形结构与 Connector 详情段，得到拓扑树骨架与各 Connector 属性。
4. 收集 SR 文件：递归收集同目录下全部 .sr 文件并解析缓存到内存。
5. 构建拓扑：将 Connector 属性与 SR 文件按名称（去除末尾 _序号 后缀）匹配，生成前端拓扑树并渲染。

功能验证 ​

导入完成后，可按以下检查项验证功能是否正常：

常见问题 ​

远程模式连接 BMC 环境 ​

远程模式支持连接真机 BMC 环境，自动从运行时数据（mdbctl 调试命令 + 框架日志）构建整机 CSR 拓扑，实时展示板卡实际在位情况。无需从 BMC 手动导出数据再导入，选择环境即可出图，适用于真机调试、板卡适配验证与在位异常定位。

使用前准备 ​

• 已安装并启用 BMC环境管理 插件（openubmc.bmcstudio-bmc-remote），并添加至少一条 BMC 连接。连接的添加方法参见 BMC环境管理插件 章节。
• 目标 BMC 运行 openUBMC 固件，开放 Telnet 调试通道（23 端口免认证调试 shell），且板上具备 mdbctl 调试命令。
• 开发机无需安装 telnet 客户端，扩展使用内置连接直连。

连接 BMC 环境 ​

1. 在 CSR 拓扑侧边栏视图标题栏，点击「远程调试」按钮。

2. 在顶部弹出的环境选择框中，选择目标 BMC 环境。列表展示全部已配置连接，并实时探测在线状态（在线/离线图标 + 账号信息）。

3. 选择后显示「正在加载 xx 环境的 CSR 拓扑」进度通知，工具自动读取真机运行时的 Connector 对象与 SR 加载记录并构建拓扑。

4. 加载完成后，拓扑图工具栏显示当前连接的环境名称与 IP，主编辑区渲染整机实时拓扑。

查看实时拓扑 ​

• 真实在位状态：拓扑以真机运行时数据为准（而非静态 root.sr 配置），每块板卡显示实际在位/不在位状态。
• EEPROM 板卡：CSR 烧录在 EEPROM（而非 .sr 文件）的板卡会被自动解码，与文件板卡同等展示，双击同样可查看内容。
• 板卡 SR 下钻：双击板卡即可进入单板视图查看该板卡的 SR 内容。
• 在位调试：板卡节点上的在位开关可点击切换，模拟板卡拔插，详见下文「在位调试」。

在位调试 ​

远程模式下，点击板卡节点上的在位开关即可模拟板卡拔插，验证下级板卡的加载逻辑，无需物理操作真机。

普通在位属性 ​

Presence 为固定值（1/0）的板卡，节点上显示单个在位开关。点击开关后：

1. 工具通过 mdbctl setprop 向真机下发修改，更新该 Connector 的 Presence 值；
2. 重新读取运行时在位状态并重建拓扑（不重新读取 SR 文件）；
3. 下级板卡的加载状态随 Presence 变化体现在拓扑上。

同步属性（多开关） ​

Presence 为表达式（引用其他对象属性，如多个物理在位开关共用一个 Connector）时，节点上会按同步源渲染多个开关，每个开关对应一个同步源对象的属性。点击单个开关只修改对应同步源对象的属性值，适用于逐个验证各物理开关对板卡加载的影响。

实现原理 ​

数据来源 ​

远程模式的拓扑数据来自真机运行时，全部通过 Telnet 调试通道（23 端口）自动采集，各数据项来源如下：

通过日志查看 Connector 加载的文件 ​

每个 Connector 实际加载的 SR 文件记录在 BMC 的框架日志 /var/log/framework.log 中，由硬件自发现流程打印，共两类记录：

记录一（init.lua，板卡加载主源）——每个 Connector 加载 SR 时打印，position 即该 Connector 的 GroupPosition：

2026-08-20 10:15:32 hwdiscovery NOTICE: init.lua(152): position: 0101011A, get csr data from /opt/bmc/sr/14100513_pcie_card.sr, ...

记录二（dump.lua，根节点主源）——根板卡的加载只出现在此类记录中：

2026-08-20 10:15:30 hwdiscovery NOTICE: dump.lua(88): start to dump connector: root loading file: /opt/bmc/sr/root.sr

工具解析后的对应关系示例：

也可以在 BMC 上手动执行以下命令核对（与工具解析使用同一数据源）：

grep -E "get csr data from|start to dump connector" /var/log/framework.log

处理流程 ​

1. 连通性自检：通过 Telnet 23 端口连接目标 BMC，探测调试 shell 可用性。
2. 发现 Connector：执行 mdbctl lsobj connector 获取运行时全量 Connector 对象，再批量 mdbctl lsprop 读取每个 Connector 的 Presence 实际值。
3. 解析加载记录：读取 /var/log/framework.log（含历史 .gz 轮转文件），解析「position → SR 文件」与「运行时名 → 文件」两组映射。
4. 建树：按 Connector 的 GroupPosition 属性构建整机层级（去掉末两位十六进制即父节点位置）。
5. 读取 SR 内容：按映射从 /opt/bmc/sr/ 读取 .sr 文件；EEPROM 板卡读取 EEPROM 二进制（CDR 容器）并本地解码出 CSR。
6. 渲染：组装拓扑树、在位状态与 SR 数据，发送到拓扑图视图渲染。

功能验证 ​

连接环境并加载拓扑后，可按以下检查项验证功能是否正常：

常见问题 ​

能效调速配置 ​

能效调速配置功能提供能效调速对象的配置入口，支持通过Excel导入热设计表格解析调速曲线配置，支持对象自动关联及配置检查、CSR片段自动生成。

打开配置页面 ​

点击CSR拓扑侧边栏中的温度计图标即可开启能效调速配置页面。

配置能效调速对象 ​

1. 通过该页面配置能效调速对象，以及配置对象间的关联关系。

2. 点击右上角的"导入Excel"即可导入热设计表格，当前仅支持xlsx格式，若为其他格式请通过Excel另存为xlsx格式文件。完成导入后，温度点与调速曲线等配置可以自动解析。

3. 点击右上角"生成CSR"即可根据当前配置产生CSR代码片段，可以自行填入CSR文件中。生成CSR过程支持配置语法检查，禁止出现ID冲突等问题。

六、事件管理 ​

本章节介绍 openUBMC Studio 的事件管理功能。用户可以在 IDE 中查看和编辑 event_def.json 中的事件信息与描述模板，也可以查看、新增和保存事件与 CSR Event_ 对象的绑定关系。

功能说明 ​

BMC 事件字典定义了整机事件的事件标识、严重级别、事件编码和描述模板等标准信息。事件管理提供以下能力：

• 事件字典管理：查看、筛选和搜索全部事件，编辑基础字段与中英文描述模板，新建自定义事件模板，以及还原或导出差量。
• CSR 绑定管理：查看事件在 SR 文件中绑定的 Event_ 对象，可视化新增、编辑和删除绑定，并批量保存到 SR 文件。

根据打开入口，事件管理提供以下两种视图：

两种视图共用同一套事件字典与编辑能力，仅 CSR 绑定的聚合范围不同。

使用前准备 ​

• 模型配置：已完成产品和规则集选择，事件字典基线来自 Conan 规则包中的 event_def.json。
• 拓扑项目：已通过拓扑侧边栏创建配置并添加 CSR 仓库，当前工作区存在可用的 SR 上下文。

打开事件管理 ​

• 打开整机视图：进入总拓扑页面，单击工具栏中的“事件管理”。

• 打开单板卡视图：进入单 SR 拓扑视图，单击“事件管理”。此时 CSR 绑定范围限定为当前 SR 文件。

事件管理会在独立面板中打开，不影响原拓扑页面。

查看事件管理界面 ​

事件管理界面由工具栏、事件列表、编辑横幅、分页栏和详情面板组成。

• 工具栏：提供新建事件模板、重新拉取、导出、清除全部筛选和搜索功能。
• 事件列表：展示全部事件，支持列头筛选和分页。
• 编辑横幅：存在未导出的编辑时，以黄色或绿色横幅提示导出。
• 详情面板：单击事件行后显示在界面右侧。拖动面板左边缘可以在约 280～700px 范围内调整宽度，单击“×”可以关闭面板。

筛选和搜索事件 ​

查看列表字段 ​

设置筛选条件 ​

1. 单击“级别”“CSR 绑定”“分类”“机型支持”或“恢复上报”列头中的筛选按钮。
2. 勾选需要保留的选项。每个选项会显示对应的事件数量。
3. 如需清空当前列的条件，再次打开筛选菜单并单击“清空筛选”。

右上角搜索框支持按 EventKeyId、事件名称或事件编码进行模糊搜索。存在筛选或搜索条件时，工具栏会显示“清除全部筛选（N）”，单击后可以恢复完整列表。

设置分页 ​

底部分页栏支持将每页数量设置为 20、40、80 或 100 条，也支持按页码跳转。没有事件数据时，可以通过空状态入口新建事件模板；存在数据但被过滤时，可以通过空状态入口清除筛选。

新建和编辑事件 ​

新建事件模板 ​

1. 单击工具栏中的“新建事件模板”。
2. 在右侧详情面板中编辑新模板。

新建的自定义事件会置于列表顶部并自动选中。详情面板底部提供“删除该自定义事件模板”按钮。

编辑基础字段 ​

1. 在事件列表中单击目标事件。

2. 在右侧详情面板中打开“基础信息”页签。

基础字段说明如下：

编辑描述模板 ​

“描述模板”区域提供以下四类内容的中英文编辑，单击右上角的“中”或“EN”可以切换语言：

• Description：描述。
• Cause：可能原因。
• Influence：影响。
• Suggestion：处理建议。

还原事件数据 ​

• 还原单个事件：单击详情面板标题行中的“还原”，丢弃该事件的全部本地编辑并恢复为字典基线值。

• 重新拉取全部事件：单击工具栏中的“重新拉取”，在确认窗口中继续操作。完成后，事件管理会丢弃全部编辑，从 Conan 包重新读取事件字典，并将筛选、搜索和分页恢复为初始状态。

查看并导出修改 ​

存在未同步的编辑时，列表上方会显示编辑横幅。

• 查看修改：打开变化清单后，可以单击事件标识定位到对应事件，也可以单独还原某个事件。
• 导出事件字典：导出的 event_def.json 包含全部事件定义与描述模板，文件版本号末段自动加一，例如从 1.0.0 更新为 1.0.1。导出后，请将文件提交到 VPD 仓库进行同步。
• 导出机型事件清单：导出的 eventDefList.txt 仅包含“机型支持”为“是”的事件标识。

管理 CSR 绑定 ​

CSR 绑定描述事件与 SR 文件中 Event_ 对象的对应关系。在详情面板中打开“CSR 绑定”页签，可以查看和编辑绑定。

查看 CSR 绑定 ​

页签顶部显示当前视图类型和事件的绑定总数。绑定以卡片形式展示，每张卡片会标注所属 SR 文件，悬停后可以查看完整路径。

新增 CSR 绑定 ​

1. 单击详情面板底部的“CSR 绑定”。

2. 在新增卡片中填写绑定字段。

3. 如果当前处于整机视图，选择“目标 SR 文件”。整机根文件 root.sr 不在候选范围内；单板卡视图会自动使用当前 SR 文件。

4. 单击“确定”，批量保存本次绑定修改。

查看绑定字段 ​

验证保存结果 ​

• “确定”仅在存在修改且表单校验通过时可用；单击“取消”会放弃本次全部修改。
• 对象名为空、未以 Event_ 开头或在组内重名时，对应输入框会显示错误。
• 保存成功后，绑定列表和绑定数量会自动刷新，事件列表会定位到当前事件。
• 在编辑器中直接保存 SR 文件后，绑定列表和绑定数量也会自动刷新。

常见问题 ​

• 事件字段是否需要手动保存？ 不需要。字段与描述模板编辑会在停止输入约 1 秒后写入本地缓存，并在关闭面板时落盘；CSR 绑定修改需要单击“确定”保存到 SR 文件。
• 重新拉取后编辑全部消失：此行为符合预期。“重新拉取”会丢弃全部本地差量并恢复到字典基线。
• CSR 绑定提示对象名必须以 Event_ 开头：事件对象名必须带有固定前缀，并且不能只有 Event_ 前缀。
• 整机视图与单板卡视图的绑定数量不一致：两种视图的聚合范围分别为全部 SR 文件和当前 SR 文件，因此数量可能不同。
• 还原事件后列表中的绑定数量未变化：“还原”仅丢弃事件字典的本地差量，不修改 CSR 绑定。
• 导出的文件应提交到哪里？ event_def.json 与 eventDefList.txt 均用于提交到 VPD 仓库，具体流程遵循团队的字典变更管理规范。
• 新建的模板在筛选结果中不可见：新建模板时会自动清空筛选。如模板仍不可见，请检查搜索词和列头筛选条件。

七、日志诊断与告警链条分析 ​

一键日志解析插件（扩展 ID：openubmc.bmcstudio-log-reviewer）用于导入 BMC 一键日志包或 dump 目录，并通过可视化页面和 AI Agent 分析设备状态。用户可以浏览硬件、告警、传感器、性能及原始日志，也可以结合 openUBMC RAG 进行日志体检，或通过告警证据工具分析指定事件的触发链条。

功能说明 ​

日志诊断提供以下使用方式：

使用前准备 ​

如果活动栏中没有“一键日志解析”图标，请先执行以下操作：

1. 在 openUBMC Studio 中打开插件市场，搜索“一键日志解析”。
2. 安装插件，并按照提示重新加载窗口。
3. 确认活动栏中出现“一键日志解析”图标。

使用 Agent 日志体检前，还需要满足以下条件：

• 已登录 openUBMC 社区。
• openubmc-rag 扩展已启用。
• 当前网络可以访问配置的 LightRAG 服务。
• AI Agent 可以访问 openUBMC Studio MCP 工具。

AI Agent 会在读取日志前检查 RAG 状态。未登录、RAG 工具未启用、网络异常或状态响应无法解析时，日志体检会停止并显示处理建议。

打开一键日志 ​

一键日志解析支持 Windows、Linux、WSL、SSH 远程工作区和容器工作区。

支持导入以下内容：

• .tar.gz、.tgz、.tar 或 .zip 格式的 BMC 一键日志压缩包。
• 已解压且包含 AppDump 子目录的 dump 文件夹。

操作步骤如下：

1. 单击活动栏中的“一键日志解析”图标。

2. 根据日志形态，选择“打开 BMC 一键日志压缩包”或“打开 dump 目录”。

3. 选择日志压缩包或 dump 根目录。选择目录时，应选中包含 AppDump 子目录的 dump 根目录。

4. 等待解压和解析完成，确认日志页面已在编辑器区域打开。

也可以通过以下入口打开日志：

• 在资源管理器中右键单击日志压缩包或 dump 文件夹，选择对应的一键日志解析命令。
• 单击“最近打开”中的历史记录，重新打开对应日志。

“最近打开”最多保存 30 条记录。同一日志已经打开时，再次打开只会定位到原页面。删除一条最近记录时，对应的日志页面也会关闭。

查看日志包要求 ​

日志包中必须存在名称完全匹配的 AppDump 目录，典型结构如下：

dump_info/
├── AppDump/
├── LogDump/
├── RTOSDump/
└── OSDump/

插件最多向下查找 6 层目录。AppDump 是导入日志时的必需目录；缺少 LogDump、RTOSDump 或 OSDump 时，日志包仍可能打开，但对应页面会显示无数据或目录缺失。