[{"data":1,"prerenderedAt":1831},["ShallowReactive",2],{"\u002Fen\u002Fblogs\u002F20261112UBMC-component-score":3,"content-doc-\u002Fzh\u002Fblogs\u002F20261112UBMC-component-score":4,"surround-\u002Fzh\u002Fblogs\u002F20261112UBMC-component-score":1824},null,{"id":5,"title":6,"author":7,"body":11,"category":1814,"city":3,"company":3,"coverImage":1815,"date":1816,"description":1817,"extension":1818,"footer":3,"header":3,"location":3,"logo":3,"logoDark":3,"meta":1819,"name":3,"navigation":527,"path":1820,"seo":1821,"stem":1822,"version":3,"__hash__":1823},"content\u002Fzh\u002Fblogs\u002F20261112UBMC-component-score.md","一条命令，量化你的部件管理能力 — openUBMC 部件兼容性评分工具实战指南",[8],{"name":9,"description":10},"黄镇玲","昆仑太科 BMC 工程师，深耕 BMC 开发近十年，具备丰富的 BMC 固件开发项目实践经验。",{"type":12,"value":13,"toc":1785},"minimark",[14,18,22,26,29,52,63,67,72,75,86,93,97,164,168,171,177,183,189,192,198,258,265,269,272,278,282,343,347,353,369,373,377,382,418,421,426,429,586,592,596,599,612,615,621,625,630,645,650,670,676,725,731,775,781,847,850,854,861,895,898,902,905,919,925,929,932,993,996,1016,1022,1139,1143,1146,1188,1209,1219,1223,1230,1257,1260,1264,1267,1340,1343,1467,1471,1477,1480,1485,1488,1493,1500,1505,1508,1513,1516,1521,1524,1528,1531,1643,1646,1657,1661,1715,1719,1726,1746,1752,1763,1772,1775,1781],[15,16,17],"h2",{"id":17},"概要",[19,20,21],"p",{},"你的服务器部件接入 BMC 后，管理能力到底处于什么水平？是“能识别就行”，还是“秒级监控 + 带外固件升级 + 故障预测”全都有？过去，这个问题没有标准答案。现在，openUBMC 社区提供了一套自动化评分工具，一条命令跑完测试，直接给出量化得分和等级。",[15,23,25],{"id":24},"一背景为什么需要部件兼容性评分","一、背景：为什么需要部件兼容性评分？",[19,27,28],{},"服务器板卡部件种类繁多——网卡、GPU、NPU、NVMe 硬盘、RAID 卡……不同厂商的部件，与 BMC 的带外管理接口兼容性参差不齐。这带来了三个实际问题：",[30,31,32,40,46],"ul",{},[33,34,35,39],"li",{},[36,37,38],"strong",{},"适配成本高","：每引入一款新部件，都需要大量接口适配与验证工作",[33,41,42,45],{},[36,43,44],{},"管理能力不一致","：同类部件在不同厂商实现下，可监控、可诊断、可升级的能力差异显著",[33,47,48,51],{},[36,49,50],{},"生态碎片化","：缺乏统一的量化标准，部件选型缺少客观依据",[19,53,54,55,58,59,62],{},"openUBMC 社区开发了这套",[36,56,57],{},"部件兼容性评分工具","，目标很明确：",[36,60,61],{},"让部件管理能力可量化、可对比、可追溯","。",[15,64,66],{"id":65},"二评分体系四层能力一个公式","二、评分体系：四层能力，一个公式",[68,69,71],"h3",{"id":70},"_21-三层评价模型","2.1 三层评价模型",[19,73,74],{},"整个评价体系采用三层模型，从微观到宏观逐级汇聚：",[76,77,83],"pre",{"className":78,"code":80,"language":81,"meta":82},[79],"language-text","接口能力等级（L1~L4）→ 部件能力等级（L1~L4）→ 整机兼容性等级（L1~L3）\n","text","",[84,85,80],"code",{"__ignoreMap":82},[19,87,88,89,92],{},"本工具聚焦的是",[36,90,91],{},"第二层——部件能力等级","，即单个部件（如一块网卡、一块 GPU）在 BMC 管理视角下的能力评定。",[68,94,96],{"id":95},"_22-四级管理能力定义","2.2 四级管理能力定义",[98,99,100,116],"table",{},[101,102,103],"thead",{},[104,105,106,110,113],"tr",{},[107,108,109],"th",{},"等级",[107,111,112],{},"名称",[107,114,115],{},"核心能力特征",[117,118,119,131,142,153],"tbody",{},[104,120,121,125,128],{},[122,123,124],"td",{},"L1",[122,126,127],{},"基础管理",[122,129,130],{},"部件可被 BMC 识别，基础信息可读、基础状态可查",[104,132,133,136,139],{},[122,134,135],{},"L2",[122,137,138],{},"标准管理",[122,140,141],{},"支持带外管理通道，具备主动健康检查、秒级监控、带外固件升级",[104,143,144,147,150],{},[122,145,146],{},"L3",[122,148,149],{},"高级管理",[122,151,152],{},"芯片级监控、热插拔感知、SMART 健康评估、故障预测",[104,154,155,158,161],{},[122,156,157],{},"L4",[122,159,160],{},"卓越管理",[122,162,163],{},"AI 辅助预测、寿命评估、自愈决策等智能化自治管理能力",[68,165,167],{"id":166},"_23-评分公式","2.3 评分公式",[19,169,170],{},"工具的评分逻辑非常直观：",[19,172,173,176],{},[36,174,175],{},"每个用例","：PASS = 100 分，FAIL \u002F SKIP = 0 分",[19,178,179,182],{},[36,180,181],{},"部件总分","采用加权计算：",[76,184,187],{"className":185,"code":186,"language":81,"meta":82},[79],"Cs = 0.6 × L1均分 + 0.2 × L2均分 + 0.1 × L3均分 + 0.1 × L4均分\n",[84,188,186],{"__ignoreMap":82},[19,190,191],{},"加权系数体现“基础能力为主、高级能力为加分”的设计理念——L1 占 60% 确保基础管理功能必须扎实，L2~L4 逐级加分，激励厂商提升高级管理能力。",[19,193,194,197],{},[36,195,196],{},"等级映射","：",[98,199,200,212],{},[101,201,202],{},[104,203,204,207,209],{},[107,205,206],{},"总分区间",[107,208,109],{},[107,210,211],{},"含义",[117,213,214,225,235,245],{},[104,215,216,219,222],{},[122,217,218],{},"[0, 60)",[122,220,221],{},"Level1",[122,223,224],{},"基本管理",[104,226,227,230,233],{},[122,228,229],{},"[60, 80)",[122,231,232],{},"Level2",[122,234,138],{},[104,236,237,240,243],{},[122,238,239],{},"[80, 90)",[122,241,242],{},"Level3",[122,244,149],{},[104,246,247,253,256],{},[122,248,249],{},[250,251,252],"span",{},"90, 100",[122,254,255],{},"Level4",[122,257,160],{},[19,259,260],{},[261,262],"img",{"alt":263,"src":264,"title":263},"评分计算流程：从测试结果到等级判定","\u002Fcategory\u002Fblog\u002F20261112UBMC-component-score\u002F1.png",[15,266,268],{"id":267},"三系统架构四个脚本一条流水线","三、系统架构：四个脚本，一条流水线",[19,270,271],{},"整套工具由 4 个脚本组成，各司其职，形成一条完整的自动化流水线：",[19,273,274],{},[261,275],{"alt":276,"src":277,"title":276},"openUBMC 部件兼容性评分工具系统架构总览","\u002Fcategory\u002Fblog\u002F20261112UBMC-component-score\u002F2.png",[68,279,281],{"id":280},"_31-脚本角色一览","3.1 脚本角色一览",[98,283,284,297],{},[101,285,286],{},[104,287,288,291,294],{},[107,289,290],{},"脚本",[107,292,293],{},"角色",[107,295,296],{},"何时使用",[117,298,299,310,321,332],{},[104,300,301,304,307],{},[122,302,303],{},"run_component_score.py",[122,305,306],{},"主脚本：运行用例 → 解析结果 → 计算得分 → 生成报告",[122,308,309],{},"执行认证时",[104,311,312,315,318],{},[122,313,314],{},"check_missing_level.py",[122,316,317],{},"自检工具：扫描用例是否标注了等级标签",[122,319,320],{},"运行评分前",[104,322,323,326,329],{},[122,324,325],{},"check_fingerprint.py",[122,327,328],{},"校验工具：验证 PDF 报告未被篡改",[122,330,331],{},"交付后验收时",[104,333,334,337,340],{},[122,335,336],{},"component_score_common.py",[122,338,339],{},"公共模块：被其他脚本共享的常量和函数",[122,341,342],{},"自动调用",[68,344,346],{"id":345},"_32-脚本协作关系","3.2 脚本协作关系",[76,348,351],{"className":349,"code":350,"language":81,"meta":82},[79],"component_score_config.yaml ──────────────┐\n                                          ↓\ncheck_missing_level.py（独立，运行前自检）\n\nrun_component_score.py（主脚本）\n    ├── 导入 component_score_common.py\n    ├── 读取 config.yaml（BMC\u002FOS 连接信息）\n    ├── 运行 Robot 用例 → results\u002F\u003C型号>\u002Foutput.xml\n    ├── 解析 output.xml → 计算得分\n    └── 生成报告 → reports\u002F\u003C型号>\u002F*.md + *.pdf（含指纹）\n\ncheck_fingerprint.py（独立，交付后校验）\n    ├── 导入 component_score_common.py（同一算法）\n    └── 重新计算指纹 → 与 PDF 页脚指纹比对\n",[84,352,350],{"__ignoreMap":82},[19,354,355,356,358,359,361,362,364,365,368],{},"关键设计：",[84,357,336],{}," 是 ",[84,360,303],{}," 和 ",[84,363,325],{}," 的公共基础，确保",[36,366,367],{},"评分时和校验时使用完全相同的指纹算法","，闭环自然成立。",[15,370,372],{"id":371},"四5-分钟上手从零到报告","四、5 分钟上手：从零到报告",[68,374,376],{"id":375},"_41-环境准备","4.1 环境准备",[19,378,379],{},[36,380,381],{},"第一步：安装依赖",[76,383,387],{"className":384,"code":385,"language":386,"meta":82,"style":82},"language-bash shiki shiki-themes github-light github-dark monokai","cd Test_Code\u002Fcomponent_score\npip install -r requirements.txt\n","bash",[84,388,389,401],{"__ignoreMap":82},[250,390,393,397],{"class":391,"line":392},"line",1,[250,394,396],{"class":395},"sTrkL","cd",[250,398,400],{"class":399},"sstjo"," Test_Code\u002Fcomponent_score\n",[250,402,404,408,411,415],{"class":391,"line":403},2,[250,405,407],{"class":406},"srTi1","pip",[250,409,410],{"class":399}," install",[250,412,414],{"class":413},"s7F3e"," -r",[250,416,417],{"class":399}," requirements.txt\n",[19,419,420],{},"依赖项包括 pyyaml、robotframework、fpdf2 等，一行命令搞定。",[19,422,423],{},[36,424,425],{},"第二步：配置连接信息",[19,427,428],{},"编辑 component_score_config.yaml，只需修改 BMC 和 OS 的 IP \u002F 用户名 \u002F 密码：",[76,430,434],{"className":431,"code":432,"language":433,"meta":82,"style":82},"language-yaml shiki shiki-themes github-light github-dark monokai","BMC:\n  IP: \u003CBMC管理IP>              # 请修改为实际 BMC 管理 IP\n  Username: \u003CBMC用户名>         # 请修改为实际 BMC 用户名\n  Password: \u003CBMC密码>           # 请修改为实际 BMC 密码\n  HTTPS: 443\n  SSH: 22\n  IPMI: 623\n\nOS:\n  IP: \u003COS_IP>                   # 请修改为实际 OS IP\n  Username: \u003COS用户名>           # 请修改为实际 OS 用户名\n  Password: \u003COS密码>             # 请修改为实际 OS 密码\n  SSH_PORT: 22\n","yaml",[84,435,436,446,461,475,489,500,511,522,529,537,550,563,576],{"__ignoreMap":82},[250,437,438,442],{"class":391,"line":392},[250,439,441],{"class":440},"s5clZ","BMC",[250,443,445],{"class":444},"sMOD_",":\n",[250,447,448,451,454,457],{"class":391,"line":403},[250,449,450],{"class":440},"  IP",[250,452,453],{"class":444},": ",[250,455,456],{"class":399},"\u003CBMC管理IP>",[250,458,460],{"class":459},"s8-w5","              # 请修改为实际 BMC 管理 IP\n",[250,462,464,467,469,472],{"class":391,"line":463},3,[250,465,466],{"class":440},"  Username",[250,468,453],{"class":444},[250,470,471],{"class":399},"\u003CBMC用户名>",[250,473,474],{"class":459},"         # 请修改为实际 BMC 用户名\n",[250,476,478,481,483,486],{"class":391,"line":477},4,[250,479,480],{"class":440},"  Password",[250,482,453],{"class":444},[250,484,485],{"class":399},"\u003CBMC密码>",[250,487,488],{"class":459},"           # 请修改为实际 BMC 密码\n",[250,490,492,495,497],{"class":391,"line":491},5,[250,493,494],{"class":440},"  HTTPS",[250,496,453],{"class":444},[250,498,499],{"class":413},"443\n",[250,501,503,506,508],{"class":391,"line":502},6,[250,504,505],{"class":440},"  SSH",[250,507,453],{"class":444},[250,509,510],{"class":413},"22\n",[250,512,514,517,519],{"class":391,"line":513},7,[250,515,516],{"class":440},"  IPMI",[250,518,453],{"class":444},[250,520,521],{"class":413},"623\n",[250,523,525],{"class":391,"line":524},8,[250,526,528],{"emptyLinePlaceholder":527},true,"\n",[250,530,532,535],{"class":391,"line":531},9,[250,533,534],{"class":440},"OS",[250,536,445],{"class":444},[250,538,540,542,544,547],{"class":391,"line":539},10,[250,541,450],{"class":440},[250,543,453],{"class":444},[250,545,546],{"class":399},"\u003COS_IP>",[250,548,549],{"class":459},"                   # 请修改为实际 OS IP\n",[250,551,553,555,557,560],{"class":391,"line":552},11,[250,554,466],{"class":440},[250,556,453],{"class":444},[250,558,559],{"class":399},"\u003COS用户名>",[250,561,562],{"class":459},"           # 请修改为实际 OS 用户名\n",[250,564,566,568,570,573],{"class":391,"line":565},12,[250,567,480],{"class":440},[250,569,453],{"class":444},[250,571,572],{"class":399},"\u003COS密码>",[250,574,575],{"class":459},"             # 请修改为实际 OS 密码\n",[250,577,579,582,584],{"class":391,"line":578},13,[250,580,581],{"class":440},"  SSH_PORT",[250,583,453],{"class":444},[250,585,510],{"class":413},[19,587,588,591],{},[36,589,590],{},"只需改 IP 和账号密码","，其余路径配置保持默认即可。",[68,593,595],{"id":594},"_42-运行前自检","4.2 运行前自检",[19,597,598],{},"在正式跑评分之前，先检查用例是否都标注了等级标签：",[76,600,602],{"className":384,"code":601,"language":386,"meta":82,"style":82},"python check_missing_level.py\n",[84,603,604],{"__ignoreMap":82},[250,605,606,609],{"class":391,"line":392},[250,607,608],{"class":406},"python",[250,610,611],{"class":399}," check_missing_level.py\n",[19,613,614],{},"脚本会扫描所有 .robot 文件，找出缺少 level_L1 ~ level_L4 标签的用例：",[76,616,619],{"className":617,"code":618,"language":81,"meta":82},[79],"扫描目录: Test_Code\u002Fcomponent_drivers\u002Ftest_cases\n    - [TC_001](file:\u002F\u002F\u002Fxxx.robot#15) 行15 缺用例等级标签level_Lx\n    - [TC_002](file:\u002F\u002F\u002Fxxx.robot#28) 行28 缺用例等级标签level_Lx\n\n本目录缺等级标签用例数: 2\n[提示] 请查阅对应接口规范文档补充 level_Lx 等级标签\n",[84,620,618],{"__ignoreMap":82},[68,622,624],{"id":623},"_43-执行评分","4.3 执行评分",[19,626,627,197],{},[36,628,629],{},"查看支持的型号",[76,631,633],{"className":384,"code":632,"language":386,"meta":82,"style":82},"python run_component_score.py run\n",[84,634,635],{"__ignoreMap":82},[250,636,637,639,642],{"class":391,"line":392},[250,638,608],{"class":406},[250,640,641],{"class":399}," run_component_score.py",[250,643,644],{"class":399}," run\n",[19,646,647,197],{},[36,648,649],{},"查看指定型号的可选项",[76,651,653],{"className":384,"code":652,"language":386,"meta":82,"style":82},"python run_component_score.py run --mode SP681\n",[84,654,655],{"__ignoreMap":82},[250,656,657,659,661,664,667],{"class":391,"line":392},[250,658,608],{"class":406},[250,660,641],{"class":399},[250,662,663],{"class":399}," run",[250,665,666],{"class":413}," --mode",[250,668,669],{"class":399}," SP681\n",[19,671,672,675],{},[36,673,674],{},"运行南向测试","（BMC 侧 D-Bus 接口）：",[76,677,679],{"className":384,"code":678,"language":386,"meta":82,"style":82},"python run_component_score.py run --mode SP681 \\\n    --base Base \\\n    --test_cases Test_Code\u002Fcomponent_drivers\u002Ftest_cases\u002Fintegration_test_cases\u002Fhardware\u002FNetwork_Card \\\n    --direction south\n",[84,680,681,697,707,717],{"__ignoreMap":82},[250,682,683,685,687,689,691,694],{"class":391,"line":392},[250,684,608],{"class":406},[250,686,641],{"class":399},[250,688,663],{"class":399},[250,690,666],{"class":413},[250,692,693],{"class":399}," SP681",[250,695,696],{"class":413}," \\\n",[250,698,699,702,705],{"class":391,"line":403},[250,700,701],{"class":413},"    --base",[250,703,704],{"class":399}," Base",[250,706,696],{"class":413},[250,708,709,712,715],{"class":391,"line":463},[250,710,711],{"class":413},"    --test_cases",[250,713,714],{"class":399}," Test_Code\u002Fcomponent_drivers\u002Ftest_cases\u002Fintegration_test_cases\u002Fhardware\u002FNetwork_Card",[250,716,696],{"class":413},[250,718,719,722],{"class":391,"line":477},[250,720,721],{"class":413},"    --direction",[250,723,724],{"class":399}," south\n",[19,726,727,730],{},[36,728,729],{},"运行北向测试","（管理侧接口：CLI \u002F Redfish \u002F SNMP \u002F Web）：",[76,732,734],{"className":384,"code":733,"language":386,"meta":82,"style":82},"python run_component_score.py run --mode SP681 \\\n    --base Base_OCP \\\n    --test_cases Test_Code\u002Fintegration_test\u002Ftest_cases\u002FNetwork_Card \\\n    --direction north\n",[84,735,736,750,759,768],{"__ignoreMap":82},[250,737,738,740,742,744,746,748],{"class":391,"line":392},[250,739,608],{"class":406},[250,741,641],{"class":399},[250,743,663],{"class":399},[250,745,666],{"class":413},[250,747,693],{"class":399},[250,749,696],{"class":413},[250,751,752,754,757],{"class":391,"line":403},[250,753,701],{"class":413},[250,755,756],{"class":399}," Base_OCP",[250,758,696],{"class":413},[250,760,761,763,766],{"class":391,"line":463},[250,762,711],{"class":413},[250,764,765],{"class":399}," Test_Code\u002Fintegration_test\u002Ftest_cases\u002FNetwork_Card",[250,767,696],{"class":413},[250,769,770,772],{"class":391,"line":477},[250,771,721],{"class":413},[250,773,774],{"class":399}," north\n",[19,776,777,780],{},[36,778,779],{},"南向 + 北向合并运行","（一条命令，一份合并报告）：",[76,782,784],{"className":384,"code":783,"language":386,"meta":82,"style":82},"python run_component_score.py run --mode SP681 \\\n    --base Base \\\n    --test_cases Test_Code\u002Fcomponent_drivers\u002Ftest_cases\u002Fintegration_test_cases\u002Fhardware\u002FNetwork_Card \\\n    --direction south \\\n    --base Base_OCP \\\n    --test_cases Test_Code\u002Fintegration_test\u002Ftest_cases\u002FNetwork_Card \\\n    --direction north\n",[84,785,786,800,808,816,825,833,841],{"__ignoreMap":82},[250,787,788,790,792,794,796,798],{"class":391,"line":392},[250,789,608],{"class":406},[250,791,641],{"class":399},[250,793,663],{"class":399},[250,795,666],{"class":413},[250,797,693],{"class":399},[250,799,696],{"class":413},[250,801,802,804,806],{"class":391,"line":403},[250,803,701],{"class":413},[250,805,704],{"class":399},[250,807,696],{"class":413},[250,809,810,812,814],{"class":391,"line":463},[250,811,711],{"class":413},[250,813,714],{"class":399},[250,815,696],{"class":413},[250,817,818,820,823],{"class":391,"line":477},[250,819,721],{"class":413},[250,821,822],{"class":399}," south",[250,824,696],{"class":413},[250,826,827,829,831],{"class":391,"line":491},[250,828,701],{"class":413},[250,830,756],{"class":399},[250,832,696],{"class":413},[250,834,835,837,839],{"class":391,"line":502},[250,836,711],{"class":413},[250,838,765],{"class":399},[250,840,696],{"class":413},[250,842,843,845],{"class":391,"line":513},[250,844,721],{"class":413},[250,846,774],{"class":399},[19,848,849],{},"合并运行时，--mode 只写一次，--base \u002F --test_cases \u002F --direction 按位置配对，最多一个 south + 一个 north。",[68,851,853],{"id":852},"_44-查看报告","4.4 查看报告",[19,855,856,857,860],{},"运行完成后，在 ",[84,858,859],{},"reports\u002F\u003C型号>\u002F"," 下自动生成报告：",[98,862,863,873],{},[101,864,865],{},[104,866,867,870],{},[107,868,869],{},"运行方式",[107,871,872],{},"报告文件",[117,874,875,885],{},[104,876,877,880],{},[122,878,879],{},"单方向",[122,881,882],{},[84,883,884],{},"部件兼容性评分报告-\u003C型号>-\u003C方向>.md \u002F .pdf",[104,886,887,890],{},[122,888,889],{},"南+北合并",[122,891,892],{},[84,893,894],{},"部件兼容性评分报告-\u003C型号>.md \u002F .pdf",[19,896,897],{},"报告内容包括：评分结论、各等级得分明细、状态分布、逐条用例评分详情、评分公式说明，以及——防篡改指纹。",[15,899,901],{"id":900},"五防篡改机制pdf-页脚里的数字签名","五、防篡改机制：PDF 页脚里的“数字签名”",[19,903,904],{},"测评报告的公信力是整个认证体系的生命线。为此，工具在每份 PDF 报告的页脚嵌入了两个值：",[30,906,907,913],{},[33,908,909,912],{},[36,910,911],{},"commit 号","：生成报告时的 git commit（12 位）",[33,914,915,918],{},[36,916,917],{},"fingerprint","：目录级哈希指纹（12 位）",[19,920,921],{},[261,922],{"alt":923,"src":924,"title":923},"PDF 防篡改校验：指纹闭环验证机制","\u002Fcategory\u002Fblog\u002F20261112UBMC-component-score\u002F3.png",[68,926,928],{"id":927},"_51-指纹算法目录级哈希","5.1 指纹算法：目录级哈希",[19,930,931],{},"指纹覆盖以下 7 类目录\u002F文件（全部从 component_score_config.yaml 读取）：",[98,933,934,944],{},[101,935,936],{},[104,937,938,941],{},[107,939,940],{},"类别",[107,942,943],{},"目录",[117,945,946,954,962,970,978,986],{},[104,947,948,951],{},[122,949,950],{},"南向 test_lists",[122,952,953],{},"component_drivers\u002Ftest_lists",[104,955,956,959],{},[122,957,958],{},"南向 test_cases",[122,960,961],{},"component_drivers\u002Ftest_cases\u002Fhardware",[104,963,964,967],{},[122,965,966],{},"北向 test_lists",[122,968,969],{},"integration_test\u002Ftest_lists",[104,971,972,975],{},[122,973,974],{},"北向 test_cases",[122,976,977],{},"integration_test\u002Ftest_cases",[104,979,980,983],{},[122,981,982],{},"test_config × 2",[122,984,985],{},"component_drivers\u002Ftest_config + integration_test\u002Ftest_config",[104,987,988,991],{},[122,989,990],{},"评分脚本",[122,992,303],{},[19,994,995],{},"算法步骤：",[997,998,999,1002,1009],"ol",{},[33,1000,1001],{},"递归收集上述所有目录\u002F文件的 MD5 值",[33,1003,1004,1005,1008],{},"所有 MD5 值",[36,1006,1007],{},"升序排序","后拼接为一个字符串",[33,1010,1011,1012,1015],{},"对该字符串求 MD5，取",[36,1013,1014],{},"前 12 位","作为指纹",[19,1017,1018,1019,1021],{},"核心代码（",[84,1020,336],{},"）：",[76,1023,1026],{"className":1024,"code":1025,"language":608,"meta":82,"style":82},"language-python shiki shiki-themes github-light github-dark monokai","def compute_dir_fingerprint(config):\n    \"\"\"目录级指纹算法 —— 生成方与检查方共用同一函数。\"\"\"\n    # 从 config 读取参与目录\n    dir_paths = []\n    for dir_key in (\"South\", \"North\"):\n        for key in (\"TestLists\", \"TestCases\"):\n            rel = config.get(dir_key, {}).get(key)\n            if rel:\n                dir_paths.append(WORKSPACE_DIR \u002F rel)\n    # ... 加入 test_config、评分脚本 ...\n\n    # 收集所有文件 MD5\n    all_md5 = []\n    for dp in dir_paths:\n        md5s, _ = _collect_dir_md5s(dp)\n        all_md5.extend(md5s)\n\n    # 升序排序 → 拼接 → 二次 MD5 → 取前 12 位\n    all_md5.sort()\n    combined = \"\".join(all_md5)\n    return hashlib.md5(combined.encode(\"utf-8\")).hexdigest()[:12]\n",[84,1027,1028,1033,1038,1043,1048,1053,1058,1063,1068,1073,1078,1082,1087,1092,1098,1104,1110,1115,1121,1127,1133],{"__ignoreMap":82},[250,1029,1030],{"class":391,"line":392},[250,1031,1032],{},"def compute_dir_fingerprint(config):\n",[250,1034,1035],{"class":391,"line":403},[250,1036,1037],{},"    \"\"\"目录级指纹算法 —— 生成方与检查方共用同一函数。\"\"\"\n",[250,1039,1040],{"class":391,"line":463},[250,1041,1042],{},"    # 从 config 读取参与目录\n",[250,1044,1045],{"class":391,"line":477},[250,1046,1047],{},"    dir_paths = []\n",[250,1049,1050],{"class":391,"line":491},[250,1051,1052],{},"    for dir_key in (\"South\", \"North\"):\n",[250,1054,1055],{"class":391,"line":502},[250,1056,1057],{},"        for key in (\"TestLists\", \"TestCases\"):\n",[250,1059,1060],{"class":391,"line":513},[250,1061,1062],{},"            rel = config.get(dir_key, {}).get(key)\n",[250,1064,1065],{"class":391,"line":524},[250,1066,1067],{},"            if rel:\n",[250,1069,1070],{"class":391,"line":531},[250,1071,1072],{},"                dir_paths.append(WORKSPACE_DIR \u002F rel)\n",[250,1074,1075],{"class":391,"line":539},[250,1076,1077],{},"    # ... 加入 test_config、评分脚本 ...\n",[250,1079,1080],{"class":391,"line":552},[250,1081,528],{"emptyLinePlaceholder":527},[250,1083,1084],{"class":391,"line":565},[250,1085,1086],{},"    # 收集所有文件 MD5\n",[250,1088,1089],{"class":391,"line":578},[250,1090,1091],{},"    all_md5 = []\n",[250,1093,1095],{"class":391,"line":1094},14,[250,1096,1097],{},"    for dp in dir_paths:\n",[250,1099,1101],{"class":391,"line":1100},15,[250,1102,1103],{},"        md5s, _ = _collect_dir_md5s(dp)\n",[250,1105,1107],{"class":391,"line":1106},16,[250,1108,1109],{},"        all_md5.extend(md5s)\n",[250,1111,1113],{"class":391,"line":1112},17,[250,1114,528],{"emptyLinePlaceholder":527},[250,1116,1118],{"class":391,"line":1117},18,[250,1119,1120],{},"    # 升序排序 → 拼接 → 二次 MD5 → 取前 12 位\n",[250,1122,1124],{"class":391,"line":1123},19,[250,1125,1126],{},"    all_md5.sort()\n",[250,1128,1130],{"class":391,"line":1129},20,[250,1131,1132],{},"    combined = \"\".join(all_md5)\n",[250,1134,1136],{"class":391,"line":1135},21,[250,1137,1138],{},"    return hashlib.md5(combined.encode(\"utf-8\")).hexdigest()[:12]\n",[68,1140,1142],{"id":1141},"_52-校验命令","5.2 校验命令",[19,1144,1145],{},"检查人员只需一条命令即可验证报告未被篡改：",[76,1147,1149],{"className":384,"code":1148,"language":386,"meta":82,"style":82},"python check_fingerprint.py --commit \u003CPDF页脚commit号> --fingerprint \u003CPDF页脚指纹>\n",[84,1150,1151],{"__ignoreMap":82},[250,1152,1153,1155,1158,1161,1165,1168,1171,1174,1177,1179,1182,1185],{"class":391,"line":392},[250,1154,608],{"class":406},[250,1156,1157],{"class":399}," check_fingerprint.py",[250,1159,1160],{"class":413}," --commit",[250,1162,1164],{"class":1163},"sC2Qs"," \u003C",[250,1166,1167],{"class":399},"PDF页脚commit",[250,1169,1170],{"class":444},"号",[250,1172,1173],{"class":1163},">",[250,1175,1176],{"class":413}," --fingerprint",[250,1178,1164],{"class":1163},[250,1180,1181],{"class":399},"PDF页脚指",[250,1183,1184],{"class":444},"纹",[250,1186,1187],{"class":1163},">\n",[30,1189,1190,1200],{},[33,1191,1192,1195,1196,1199],{},[36,1193,1194],{},"指纹一致"," → ",[250,1197,1198],{},"PASS"," 指纹一致！评测时测试相关文件未被篡改。",[33,1201,1202,1195,1205,1208],{},[36,1203,1204],{},"指纹不一致",[250,1206,1207],{},"FAIL"," 指纹不一致！评测时测试相关文件可能被篡改。",[19,1210,1211,1214,1215,1218],{},[36,1212,1213],{},"设计亮点","：生成方（run_component_score.py）与检查方（check_fingerprint.py）调用",[36,1216,1217],{},"同一个"," compute_dir_fingerprint() 函数，不依赖 output.xml，检查人员无需任何运行产物即可校验，闭环自然成立。",[68,1220,1222],{"id":1221},"_53-跑测试前的自检提醒","5.3 跑测试前的自检提醒",[19,1224,1225,1226,1229],{},"指纹覆盖的目录\u002F文件在跑测试期间",[36,1227,1228],{},"请勿做任何修改","。跑用例前建议先执行：",[76,1231,1233],{"className":384,"code":1232,"language":386,"meta":82,"style":82},"cd \u003C项目根目录>\ngit status\n",[84,1234,1235,1249],{"__ignoreMap":82},[250,1236,1237,1239,1241,1244,1247],{"class":391,"line":392},[250,1238,396],{"class":395},[250,1240,1164],{"class":1163},[250,1242,1243],{"class":399},"项目根目",[250,1245,1246],{"class":444},"录",[250,1248,1187],{"class":1163},[250,1250,1251,1254],{"class":391,"line":403},[250,1252,1253],{"class":406},"git",[250,1255,1256],{"class":399}," status\n",[19,1258,1259],{},"确认上述参与指纹计算的目录和脚本均未被修改。若有改动，请先提交或还原后再跑用例，否则 PDF 页脚指纹会与检查方计算的不一致。",[15,1261,1263],{"id":1262},"六支持的部件类型","六、支持的部件类型",[19,1265,1266],{},"工具覆盖 4 大类板卡部件，每类部件的测试用例按 L1~L4 分级：",[98,1268,1269,1285],{},[101,1270,1271],{},[104,1272,1273,1276,1279,1282],{},[107,1274,1275],{},"部件类型",[107,1277,1278],{},"典型设备",[107,1280,1281],{},"测试方向",[107,1283,1284],{},"关键管理接口",[117,1286,1287,1301,1314,1327],{},[104,1288,1289,1292,1295,1298],{},[122,1290,1291],{},"网卡（NIC）",[122,1293,1294],{},"Intel E810、Mellanox ConnectX-5\u002F6",[122,1296,1297],{},"南向 + 北向",[122,1299,1300],{},"bmc.dev.NetworkAdapter、NetworkPort",[104,1302,1303,1306,1309,1311],{},[122,1304,1305],{},"硬盘（Disk）",[122,1307,1308],{},"NVMe SSD、SATA\u002FSAS",[122,1310,1297],{},[122,1312,1313],{},"bmc.dev.NVMe、Storage.Drive",[104,1315,1316,1319,1322,1324],{},[122,1317,1318],{},"RAID 卡",[122,1320,1321],{},"Broadcom MegaRAID 系列",[122,1323,1297],{},[122,1325,1326],{},"bmc.dev.Storage.Controller、Volume",[104,1328,1329,1332,1335,1337],{},[122,1330,1331],{},"xPU",[122,1333,1334],{},"NVIDIA GPU、华为昇腾 NPU",[122,1336,1297],{},[122,1338,1339],{},"bmc.dev.GPU、NPU、DPUCard",[19,1341,1342],{},"以网卡为例，各等级的测试覆盖：",[98,1344,1345,1360],{},[101,1346,1347],{},[104,1348,1349,1352,1354,1356,1358],{},[107,1350,1351],{},"测试项",[107,1353,124],{},[107,1355,135],{},[107,1357,146],{},[107,1359,157],{},[117,1361,1362,1376,1389,1402,1415,1428,1441,1454],{},[104,1363,1364,1367,1370,1372,1374],{},[122,1365,1366],{},"设备识别（VID\u002FDID\u002F固件版本）",[122,1368,1369],{},"✓",[122,1371,1369],{},[122,1373,1369],{},[122,1375,1369],{},[104,1377,1378,1381,1383,1385,1387],{},[122,1379,1380],{},"链路状态查询",[122,1382,1369],{},[122,1384,1369],{},[122,1386,1369],{},[122,1388,1369],{},[104,1390,1391,1394,1396,1398,1400],{},[122,1392,1393],{},"端口速率枚举与流量统计（秒级）",[122,1395],{},[122,1397,1369],{},[122,1399,1369],{},[122,1401,1369],{},[104,1403,1404,1407,1409,1411,1413],{},[122,1405,1406],{},"主动健康检查与错误统计",[122,1408],{},[122,1410,1369],{},[122,1412,1369],{},[122,1414,1369],{},[104,1416,1417,1420,1422,1424,1426],{},[122,1418,1419],{},"带外固件升级",[122,1421],{},[122,1423,1369],{},[122,1425,1369],{},[122,1427,1369],{},[104,1429,1430,1433,1435,1437,1439],{},[122,1431,1432],{},"热插拔识别与诊断",[122,1434],{},[122,1436],{},[122,1438,1369],{},[122,1440,1369],{},[104,1442,1443,1446,1448,1450,1452],{},[122,1444,1445],{},"光模块故障预测与诊断",[122,1447],{},[122,1449],{},[122,1451,1369],{},[122,1453,1369],{},[104,1455,1456,1459,1461,1463,1465],{},[122,1457,1458],{},"光模块寿命 AI 评估",[122,1460],{},[122,1462],{},[122,1464],{},[122,1466,1369],{},[15,1468,1470],{"id":1469},"七完整认证流程","七、完整认证流程",[19,1472,1473],{},[261,1474],{"alt":1475,"src":1476,"title":1475},"部件测评认证流程：从申请到交付","\u002Fcategory\u002Fblog\u002F20261112UBMC-component-score\u002F4.png",[19,1478,1479],{},"在 openUBMC 社区中，部件测评认证的完整流程如下：",[19,1481,1482],{},[36,1483,1484],{},"第一步：RM SIG 评审（需求接纳）",[19,1486,1487],{},"企业在社区 RM SIG 提交部件管理功能支持需求，明确部件类别、型号、目标等级与交付计划。评审通过后进入开发阶段。",[19,1489,1490],{},[36,1491,1492],{},"第二步：部件驱动开发",[19,1494,1495,1496,1499],{},"依据南向接口规范，实现部件的 ",[84,1497,1498],{},"bmc.dev.*"," 接口与北向呈现能力。",[19,1501,1502],{},[36,1503,1504],{},"第三步：基于测评工具测试，输出测试报告",[19,1506,1507],{},"使用本工具执行南向 + 北向测试，自动计算得分与等级，生成标准化测评报告。",[19,1509,1510],{},[36,1511,1512],{},"第四步：QA SIG 评审",[19,1514,1515],{},"在社区 QA SIG 评审测评报告，确认得分与等级判定结论。",[19,1517,1518],{},[36,1519,1520],{},"第五步：提交 PR 合入",[19,1522,1523],{},"评审通过后，将驱动代码和测评报告分别以 PR 形式提交至 component_drivers 和 QA 代码仓归档。",[15,1525,1527],{"id":1526},"八实际效果示例","八、实际效果示例",[19,1529,1530],{},"以下是几个典型部件的测评结果示例：",[98,1532,1533,1563],{},[101,1534,1535],{},[104,1536,1537,1540,1543,1546,1549,1552,1555,1558,1561],{},[107,1538,1539],{},"部件型号",[107,1541,1542],{},"类型",[107,1544,1545],{},"方向",[107,1547,1548],{},"Ls1",[107,1550,1551],{},"Ls2",[107,1553,1554],{},"Ls3",[107,1556,1557],{},"Ls4",[107,1559,1560],{},"总分",[107,1562,109],{},[117,1564,1565,1593,1619],{},[104,1566,1567,1570,1573,1576,1579,1582,1585,1588,1591],{},[122,1568,1569],{},"SP681",[122,1571,1572],{},"网卡",[122,1574,1575],{},"south",[122,1577,1578],{},"100",[122,1580,1581],{},"95",[122,1583,1584],{},"80",[122,1586,1587],{},"40",[122,1589,1590],{},"87",[122,1592,146],{},[104,1594,1595,1598,1601,1603,1605,1608,1611,1614,1617],{},[122,1596,1597],{},"NVIDIA Tesla T4",[122,1599,1600],{},"GPU",[122,1602,1575],{},[122,1604,1578],{},[122,1606,1607],{},"90",[122,1609,1610],{},"60",[122,1612,1613],{},"0",[122,1615,1616],{},"84",[122,1618,146],{},[104,1620,1621,1624,1627,1629,1631,1633,1635,1638,1641],{},[122,1622,1623],{},"PM9D3A",[122,1625,1626],{},"NVMe",[122,1628,1575],{},[122,1630,1578],{},[122,1632,1578],{},[122,1634,1607],{},[122,1636,1637],{},"50",[122,1639,1640],{},"92",[122,1642,157],{},[19,1644,1645],{},"通过测评报告，厂商可以清晰看到：",[30,1647,1648,1651,1654],{},[33,1649,1650],{},"哪些 L1 基础能力已达标",[33,1652,1653],{},"哪些 L2\u002FL3 能力还有提升空间",[33,1655,1656],{},"具体哪些用例失败，对应的改进方向是什么",[15,1658,1660],{"id":1659},"九常见问题速查","九、常见问题速查",[98,1662,1663,1673],{},[101,1664,1665],{},[104,1666,1667,1670],{},[107,1668,1669],{},"问题",[107,1671,1672],{},"解决方案",[117,1674,1675,1683,1691,1699,1707],{},[104,1676,1677,1680],{},[122,1678,1679],{},"型号找不到",[122,1681,1682],{},"python run_component_score.py run 查看所有支持型号",[104,1684,1685,1688],{},[122,1686,1687],{},"网络连接失败",[122,1689,1690],{},"检查 config.yaml 中 BMC\u002FOS 的 IP、用户名、密码、端口",[104,1692,1693,1696],{},[122,1694,1695],{},"用例等级缺失",[122,1697,1698],{},"python check_missing_level.py 扫描并补充等级标签",[104,1700,1701,1704],{},[122,1702,1703],{},"PDF 生成失败",[122,1705,1706],{},"确认系统有中文字体（Windows 需有 msyh.ttc）",[104,1708,1709,1712],{},[122,1710,1711],{},"指纹校验不一致",[122,1713,1714],{},"检查参与指纹计算的目录是否在测试期间被修改",[15,1716,1718],{"id":1717},"十写在最后共建-openubmc-部件生态","十、写在最后：共建 openUBMC 部件生态",[19,1720,1721,1722,1725],{},"这套评分工具不只是一个测试脚本——它是 openUBMC 社区构建",[36,1723,1724],{},"部件管理生态","的基础设施。通过统一的量化标准和自动化工具，我们希望：",[30,1727,1728,1734,1740],{},[33,1729,1730,1733],{},[36,1731,1732],{},"降低厂商参与门槛","：标准化报告 + 自动化评分，厂商无需手动编写测试文档",[33,1735,1736,1739],{},[36,1737,1738],{},"建立公开的测评结果清单","：为企业部件选型提供客观参考",[33,1741,1742,1745],{},[36,1743,1744],{},"推动接口规范化","：以评促进，激励厂商提升部件管理能力",[19,1747,1748,1751],{},[36,1749,1750],{},"我们邀请更多硬件厂商和开发者加入 openUBMC 社区","，一起推动服务器部件管理接口的标准化。无论你是部件厂商、BMC 开发者还是运维工程师，都欢迎：",[30,1753,1754,1757,1760],{},[33,1755,1756],{},"在社区提交部件驱动代码",[33,1758,1759],{},"使用评分工具完成部件认证",[33,1761,1762],{},"参与社区接口规范的讨论与完善",[19,1764,1765,1766],{},"社区官网：",[1767,1768,1769],"a",{"href":1769,"rel":1770},"https:\u002F\u002Fwww.openubmc.cn",[1771],"nofollow",[19,1773,1774],{},"评分工具代码仓：",[19,1776,1777],{},[1767,1778,1779],{"href":1779,"rel":1780},"https:\u002F\u002Fgitcode.com\u002FopenUBMC\u002FQA\u002Ftree\u002Fmain\u002FTest_Code\u002Fcomponent_score",[1771],[1782,1783,1784],"style",{},"html pre.shiki code .sTrkL, html code.shiki .sTrkL{--shiki-default:#005CC5;--shiki-dark:#79B8FF;--shiki-sepia:#66D9EF}html pre.shiki code .sstjo, html code.shiki .sstjo{--shiki-default:#032F62;--shiki-dark:#9ECBFF;--shiki-sepia:#E6DB74}html pre.shiki code .srTi1, html code.shiki .srTi1{--shiki-default:#6F42C1;--shiki-dark:#B392F0;--shiki-sepia:#A6E22E}html pre.shiki code .s7F3e, html code.shiki .s7F3e{--shiki-default:#005CC5;--shiki-dark:#79B8FF;--shiki-sepia:#AE81FF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html .sepia .shiki span {color: var(--shiki-sepia);background: var(--shiki-sepia-bg);font-style: var(--shiki-sepia-font-style);font-weight: var(--shiki-sepia-font-weight);text-decoration: var(--shiki-sepia-text-decoration);}html.sepia .shiki span {color: var(--shiki-sepia);background: var(--shiki-sepia-bg);font-style: var(--shiki-sepia-font-style);font-weight: var(--shiki-sepia-font-weight);text-decoration: var(--shiki-sepia-text-decoration);}html pre.shiki code .s5clZ, html code.shiki .s5clZ{--shiki-default:#22863A;--shiki-dark:#85E89D;--shiki-sepia:#F92672}html pre.shiki code .sMOD_, html code.shiki .sMOD_{--shiki-default:#24292E;--shiki-dark:#E1E4E8;--shiki-sepia:#F8F8F2}html pre.shiki code .s8-w5, html code.shiki .s8-w5{--shiki-default:#6A737D;--shiki-dark:#6A737D;--shiki-sepia:#88846F}html pre.shiki code .sC2Qs, html code.shiki .sC2Qs{--shiki-default:#D73A49;--shiki-dark:#F97583;--shiki-sepia:#F92672}",{"title":82,"searchDepth":477,"depth":477,"links":1786},[1787,1788,1789,1794,1798,1804,1809,1810,1811,1812,1813],{"id":17,"depth":403,"text":17},{"id":24,"depth":403,"text":25},{"id":65,"depth":403,"text":66,"children":1790},[1791,1792,1793],{"id":70,"depth":463,"text":71},{"id":95,"depth":463,"text":96},{"id":166,"depth":463,"text":167},{"id":267,"depth":403,"text":268,"children":1795},[1796,1797],{"id":280,"depth":463,"text":281},{"id":345,"depth":463,"text":346},{"id":371,"depth":403,"text":372,"children":1799},[1800,1801,1802,1803],{"id":375,"depth":463,"text":376},{"id":594,"depth":463,"text":595},{"id":623,"depth":463,"text":624},{"id":852,"depth":463,"text":853},{"id":900,"depth":403,"text":901,"children":1805},[1806,1807,1808],{"id":927,"depth":463,"text":928},{"id":1141,"depth":463,"text":1142},{"id":1221,"depth":463,"text":1222},{"id":1262,"depth":403,"text":1263},{"id":1469,"depth":403,"text":1470},{"id":1526,"depth":403,"text":1527},{"id":1659,"depth":403,"text":1660},{"id":1717,"depth":403,"text":1718},"essentials","\u002Fcategory\u002Fblog\u002F20261112UBMC-component-score\u002Fcover.webp","2026\u002F11\u002F12","openUBMC 部件兼容性评分工具用一条命令跑完测试，自动输出量化得分与管理能力等级。本文拆解评分体系、系统架构、实操命令与防篡改机制。","md",{},"\u002Fzh\u002Fblogs\u002F20261112UBMC-component-score",{"title":6,"description":1817},"zh\u002Fblogs\u002F20261112UBMC-component-score","1EI5-73xN7lNlFP5HAQyiSxcLoM3yW3WoQRZxWIU6MA",[1825,1828],{"path":1826,"title":1827},"\u002Fzh\u002Fblogs\u002F20260929UBMC-ruantonghuafang","基于 openUBMC 构建 Agent 驱动的 BMC 研发工作流",{"path":1829,"title":1830},"\u002Fzh\u002Fblogs\u002F2026UBMC-Changsha","开源BMC筑基AI算力——openUBMC 走进长沙高校",1794833407429]