目录
- 1. 整体概览
- 2. 配置与依赖说明
- 3. 核心数据结构解析
- 3.1
confidence_code_table - 3.2
confidence_table_repeat_list（二次检测 / 局部框） - 3.3
confidence_table_default（本地默认置信度）
- 3.1
- 4. 函数逐个解析
- 4.1
get_confidence_table()- 4.1.1 关键逻辑
- 4.1.2 返回值
- 4.2
get_confidence_inner()- 4.2.1 规则
- 4.3
get_confidence_fault()- 4.3.1 拼接故障名
- 4.3.2 局部框优先级处理
- 4.3.3 统一名称（局部 → 大框）
- 4.3.4 判断是否成功获取接口表
- 4.3.5 旧版接口（dict，不带车号）
- 4.3.6 新版接口（list，带车号）
- 4.3.7 异常兜底
- 4.1
- 5. 全局变量初始化
- 6. 最终总结一句话版
1. 整体概览
这份代码的核心目标只有一个：
为“故障类型”计算一个最终置信度（confidence）
这个置信度来源有 三层（优先级从高到低）：
- 远程接口返回的置信度表（可配置、可动态调整）
- 本地默认置信度表
confidence_table_default - 系统兜底默认值
settings.CONFIDENCE_DEFAULT
同时支持：
- 旧版接口（不区分车号）
- 新版接口（区分车号 train_code）
- “二次检测 / 局部框” 的特殊处理
2. 配置与依赖说明
import requests
from config import settings
from config.logger_config import process_logger
requests：用于从接口拉取置信度配置settings：存放接口地址、默认置信度等配置process_logger：统一日志输出
3. 核心数据结构解析
3.1 confidence_code_table
confidence_code_table = {"受流器_集电靴丢失或折断": "0001",...
}
作用：把“故障中文描述”映射为“数据库 / 接口使用的编码”
例如：
受流器_集电靴丢失或折断 → 0001
用途：
- 当接口返回的是
{code: confidence}格式时 - 需要先通过这个表把中文故障名转换成 code，再去接口结果里查
3.2 confidence_table_repeat_list（二次检测 / 局部框）
confidence_table_repeat_list = ["空气弹簧_空气弹簧破损_局部",...
]
含义：
- 这些是“局部框 / 二次检测框”
- 一旦检测到这些类型：
- 直接返回置信度 1.0
- 并且屏蔽对应的大框
代码里的逻辑是：
if fault+"_局部" in confidence_table_repeat_list:return 1.0
这是一个强规则覆盖，优先级非常高。
3.3 confidence_table_default（本地默认置信度）
confidence_table_default = {"受流器_集电靴丢失或折断": 0.5,...
}
作用：当接口拉取失败或未配置某个故障，就使用这里的默认值
这是整个系统的安全兜底核心表。
4. 函数逐个解析
4.1 get_confidence_table()
def get_confidence_table(get_traincode=False):
功能：从远程接口获取置信度配置表
4.1.1 关键逻辑
response = requests.get(settings.API_GET_CONFIDENCE_TABLE_NEW if get_traincode else settings.API_GET_CONFIDENCE_TABLE,headers=headers, verify=False
)
get_traincode=False：- 使用 旧接口
- 返回 dict（不区分车号）
get_traincode=True：- 使用 新接口
- 返回 list（支持车号 trainList）
4.1.2 返回值
- 成功 →
confidence_table - 失败 →
None（后续逻辑会自动走默认置信度）
4.2 get_confidence_inner()
def get_confidence_inner(fault):
功能：从本地默认表中取置信度
4.2.1 规则
- 如果
fault在confidence_table_default- 返回对应值
- 否则
- 打 warning 日志
- 返回
settings.CONFIDENCE_DEFAULT
这是所有异常情况的兜底函数。
4.3 get_confidence_fault()
def get_confidence_fault(area, name, train_code=None):
这是整个文件最重要的函数。
4.3.1 拼接故障名
fault = str(area) + "_" + str(name)
例如：
area = "空气弹簧"
name = "空气弹簧破损"
→ fault = "空气弹簧_空气弹簧破损"
4.3.2 局部框优先级处理
if fault+"_局部" in confidence_table_repeat_list:return 1.0
- 只要是二次检测的局部框
- 直接返回 1.0
- 不再参与后续任何逻辑
4.3.3 统一名称（局部 → 大框）
fault = fault.replace("_局部", "").replace("-局部", "")
目的：
- 局部框的置信度
- 实际使用的是“大框”的配置
4.3.4 判断是否成功获取接口表
if confidence_table is None:return get_confidence_inner(fault)
- 接口失败 → 只用本地默认
4.3.5 旧版接口（dict，不带车号）
if isinstance(confidence_table, dict):
流程：
- 通过
confidence_code_table找到 code - 用 code 去接口表中查
- 返回：
max(接口置信度, 本地默认置信度)
永远不低于本地默认值
4.3.6 新版接口（list，带车号）
elif isinstance(confidence_table, list):
接口返回结构类似：
{"sceneName": "空气弹簧_空气弹簧破损","confidenceLevel": 0.6,"trainList": ["CR400AF", "CRH380A"]
}
规则：
-
sceneName匹配当前 fault -
如果：
train_code在trainList中- 直接返回 1.0
-
否则：
max(接口置信度, 本地默认置信度)
4.3.7 异常兜底
任何异常：
return settings.CONFIDENCE_DEFAULT
5. 全局变量初始化
confidence_table = get_confidence_table(get_traincode=False)
- 程序启动时：立即拉取一次置信度配置
- 后续所有
get_confidence_fault都用这个全局表
6. 最终总结一句话版
这段代码实现了一个多级置信度计算系统，
支持 接口动态配置 + 本地默认兜底 + 二次检测强制覆盖 + 车号定制规则，
并通过get_confidence_fault统一对外提供最终置信度。