简介移动电源HJ-913测试报告是一份面向电源类硬件测试工程师、质检人员及电子相关专业学生的检测文档用于评估该型号移动电源的性能、安全性与可靠性可作为产品验收、研发自测与报告撰写时的参考范本。文档约159KB压缩包内仅含1个doc文件结构完整、目录清晰。内容围绕测试目的与测试条件展开细分为充放电性能与保护功能两大板块充放电部分覆盖充电特性、负载效应、动态负载、放电时间、输出效率与输出纹波保护部分涉及输入输出短路、过流、过压保护及电芯过充、过放、短路保护并延伸至显示、静态功耗、温度与低温可靠性等项目。已有191人学习下载读者可据此快速了解移动电源测试的指标口径、记录方式与验证思路直接套用或改编为同类产品的测试大纲。1. 拿到“移动电源HJ-913测试报告.doc”先看什么一份报告里到底藏了多少可复现的测试项“移动电源HJ-913测试报告.doc”这类文件多数不是测试软件直接导出的而是测试员在 Word 里手工拼的几个表格、几张放电曲线截图、几行手填的数字再套上公司模板另存为 .doc。它看起来像最终结论实际上更接近一次实验的原始记录——凡是没写清测量条件的数据都不能拿来复现。真正决定这份报告价值的是每个数字背后有没有跟着“什么负载、什么温度、什么线缆、什么仪器”这四个前提。做电源验证、代工验收、电芯选型或售后失效分析的人都得把这四件事从报告里抠出来只关心结论的采购看最后一页的“合格”盖章就够了。2. 移动电源HJ-913的核心测试项与可复现的数据口径2.1 容量、额定能量与转换效率的三种口径拿到 HJ-913 的报告最先要分清的是电芯标称容量、额定输出容量和整机转换效率这三个数字。电芯标称容量一般按 3.7V 平台算单位 mAh额定输出容量是 USB 口在 5V 下实际放出来的电量单位也是 mAh但因为升压损耗和线损通常只有标称值的 60% 到 70%而整机转换效率是能量口径的比值必须用 Wh 而不是 mAh 来算混用单位是这类报告里最常见的数据错误。具体口径常见有三种。第一种是电芯侧能量效率输出能量除以电芯放出的能量反映升压电路本身的水平好的方案在 5V/2A 下能到 88% 到 92%。第二种是板端效率只算 PCBA 输入端到输出端排除了电池内阻和保护板的损耗通常比整机高两三个点。第三种是包含充电头在内的一充一放往返效率会再低 10% 以上。很多报告把这三种混着写看的时候必须先把定义对齐否则不同批次的数字根本没有可比性。计算方式固定下来就能复现# 用放电曲线上的采样点计算输出容量与效率 # samples: [(t_s, v_out, i_out, v_cell, i_cell), ...] def capacity_and_efficiency(samples, dt1.0): out_wh 0.0 cell_wh 0.0 for _, v_out, i_out, v_cell, i_cell in samples: # 输出侧能量累加单位换算成 Wh out_wh v_out * i_out * dt / 3600.0 # 电芯侧用实时端电压而不是固定写 3.7V cell_wh v_cell * i_cell * dt / 3600.0 # 输出容量按 5V 折算仅用于和标称 mAh 对比 out_mah out_wh * 1000.0 / 5.0 eff out_wh / cell_wh if cell_wh else 0.0 return round(out_mah, 1), round(eff * 100, 2) # 示例5V/2A 恒流放电到 3.0V 截止 demo [(t, 5.02, 2.00, 3.85 - t * 0.0009, 2.28) for t in range(0, 7200, 1)] print(capacity_and_efficiency(demo))代码里有两个刻意的处理。一是电芯侧用采样到的实时端电压 v_cell而不是直接写 3.7V否则电池内阻带来的压降会被吞掉效率会被高估两到三个百分点。二是 dt 必须和采样间隔一致用 1Hz 采样就传 1.0用 0.1Hz 就传 10.0单位错一位容量就错一个数量级。返回的 out_mah 是按 5V 折算的对比值不是真实放电电荷量把它当成电芯容量就会得出“效率超过 100%”这种笑话。提示报告里写“容量 10000mAh”却没标注 3.7V 还是 5V 口径时一律按电芯标称理解USB 口能放出来的量要用 Wh 再除以 5V 换算。2.2 温升、保护点与纹波的测量条件温升测试的争议几乎全在测点上。HJ-913 这类 10000mAh 级别的产品发热集中在升压电感、同步整流 MOS 和 USB 母座焊盘外壳温度只是传导后的结果。稳妥做法是在电感和 MOS 表面点胶固定热电偶同时在外壳再贴一路记录从 25 度环境开始、满载连续放电 30 分钟的温度曲线。判据一般看两个数元件表面不超 95 度外壳不超 55 度且最后 10 分钟的温升斜率小于 1 度每分钟才算进入稳态。保护点测量要求负载电流可调且能短接。过流保护点通常标在额定输出的 1.3 到 2 倍之间短路保护看的是响应时间一般要求 1ms 内切断并在去掉短路后自动恢复。这里有个容易踩的坑很多报告写“短路保护正常”但没写清楚是用电子负载的短路模式还是直接短接母座两者电流上升率差很多慢断的样机在电子负载下能过、直接短接就可能烧 MOS。纹波的测量条件比数值本身更重要。探头必须用弹簧地针就近接地示波器开 20MHz 带宽限制和 AC 耦合否则会把开关尖峰和空间噪声全算进去。同一台样机用长地线夹测可能读到 200mV换弹簧地针就只剩 40mV。一组可对照的实测条件如下测试项主要仪器关键条件常见限值满载温升多路温度记录仪25±2 度环境满载 30min元件≤95 度外壳≤55 度过流保护可编程电子负载电流步进 0.1A每档保持 3s触发点 1.3~2 倍额定短路保护电子负载短路模式记录切断时间与恢复情况响应≤1ms可自恢复输出纹波示波器弹簧地针20MHz 带宽限制AC 耦合5V/2A 下≤100mVpp转换效率功率计电子负载满载放电至截止板端≥88%把这张表当成核对清单凡是 HJ-913 报告里没写清测点和条件的项判读时都要打问号因为同一批样机换个测法结论可能就翻过来。3. 用 python-docx 解析 HJ-913 测试报告表格并结构化3.1 .doc 与 .docx 的结构差异和解析前预处理python-docx 只能读 OOXML 格式的 .docx遇到老式 .doc 会直接抛异常因为 .doc 是 OLE 复合文档内部是二进制流加 Fib 结构解析难度和 .docx 不在一个量级。所以面对标题里这种 .doc 结尾的报告第一步不是写解析代码而是转格式。常见做法是用 LibreOffice 无头模式批量转换一条命令就能保留表格结构# 批量把 .doc 转成 .docx输出到 out 目录保留表格与样式 soffice --headless --convert-to docx \ --outdir ./out \ 移动电源HJ-913测试报告.doc # 转换结果核对文件头和表格数量 file ./out/*.docx python3 -c from docx import Document; dDocument(./out/移动电源HJ-913测试报告.docx); print(len(d.tables))参数上--headless 避免弹出图形界面--outdir 指定输出目录--convert-to 后面的 docx 也可以用 docx:MS Word 2007 XML 精确指定导出过滤器。转换会在同目录生成同名文件重复执行直接覆盖脚本里最好按时间戳建子目录。转换后用 file 确认文件头是 Zip archive data再看表格数量是否和原报告一致这一步能提前暴露“表格被当成文本框或图片”的问题——手工拼的报告里表格截图贴进去的情况并不少见这种就只能退回去让人补数据。注意LibreOffice 对复杂合并单元格和浮动文本框的还原度不稳定转完必须人工核对一次表头和行数别直接进自动化流程。3.2 把报告表格映射成结构化记录报告里的表格通常是“测试项 | 测试条件 | 实测值 | 判定”这种四列结构表头可能在第 0 行也可能被标题行占掉前两行。稳妥写法是先定位表头行再按列名建映射而不是硬编码列序号。import re, sqlite3 from docx import Document HEADER_KEYS {测试项: item, 测试条件: cond, 实测值: value, 判定: verdict} def find_header(table): for idx, row in enumerate(table.rows[:4]): cells [c.text.strip() for c in row.cells] hit sum(1 for c in cells if c in HEADER_KEYS) if hit 3: # 至少命中三列才认作表头 return idx, [HEADER_KEYS.get(c, c) for c in cells] return None, None def parse_report(path): doc Document(path) records [] for t_idx, table in enumerate(doc.tables): h_idx, header find_header(table) if header is None: continue for row in table.rows[h_idx 1:]: cells [c.text.strip() for c in row.cells] if len(cells) ! len(header): continue # 列数对不上直接丢弃交由校验环节发现 rec dict(zip(header, cells)) rec[table_idx] t_idx records.append(rec) return records def to_sqlite(records, dbhj913.db): conn sqlite3.connect(db) conn.execute(CREATE TABLE IF NOT EXISTS test_item( id INTEGER PRIMARY KEY AUTOINCREMENT, table_idx INTEGER, item TEXT, cond TEXT, value TEXT, verdict TEXT)) conn.executemany( INSERT INTO test_item(table_idx,item,cond,value,verdict) VALUES(:table_idx,:item,:cond,:value,:verdict), records) conn.commit() return conn.total_changes rows parse_report(./out/移动电源HJ-913测试报告.docx) print(入库行数:, to_sqlite(rows))关键点在 find_header它只看前四行用命中列名的数量判断哪一行是真表头这样标题行、单位说明行、空白行都不会被误当成数据。列数不等的行选择跳过而不抛异常是为了让格式不规范的表格不会中断整批解析代价是可能漏数据所以后面必须做行数核对。落库时 value 字段刻意存成文本因为报告里常有“3.85V”“≥88%”“正常”这类混合内容先原样保留归一化放到判定阶段做。3.3 解析结果校验与单位归一化解析完不校验等于把错误放大到下游。三个必查项总行数、表头列命中率、值字段能不能提取出数值。校验项检查方式不通过时的处理表格数量对比转换前后 tables 长度人工确认是否含截图表格数据行数与报告肉眼计数比对检查合并单元格是否打乱列表头命中率命中列数/总列数≥0.75扩充 HEADER_KEYS 别名数值可提取率正则匹配占比补写单位别名字典单位归一化用正则把数值和单位拆开再统一到基准单位U {v: 1.0, mv: 0.001, a: 1.0, ma: 0.001, w: 1.0, mw: 0.001} PAT re.compile(r^\s*([≤≥]?)\s*(-?\d(?:\.\d)?)\s*(mV|V|mA|A|mW|W)?\s*$, re.I) def normalize(text): m PAT.match(text or ) if not m: return None, None, None op, num, unit m.group(1), float(m.group(2)), (m.group(3) or ).lower() return op or , num * U.get(unit, 1.0), unit.lower()这个正则同时吃掉了比较符因为报告里“≥88%”“100mVpp”这类写法很常见直接 float() 会崩。unit 缺省时按基准单位处理但百分号和 Vpp 这类无量纲或复合单位要单独分支别硬套 U 字典。归一化后建议抽查五到十条记录和原报告逐字对照尤其是同一测试项分散在多个表格里的情况合并时容易张冠李戴。4. 基于解析结果自动判定 HJ-913 是否合格4.1 判定阈值表与容差怎么设第 2 章提到的限值需要落成代码里的表。判定不能只抄一个数必须带容差和方向否则同一个值在不同批次之间会来回翻。测试项阈值方向容差说明板端转换效率88%≥±1%取满载稳态 10 分钟均值输出容量标称×0.6≥±3%5V/2A 折算口径满载温升95 度≤±2 度元件表面稳态后取值外壳温度55 度≤±2 度同上输出纹波100mVpp≤±10%20MHz 带宽限制下过流保护点1.3~2 倍区间±0.1A触发点需落在区间内表里的容差不是仪器精度而是判定时允许的边界缓冲。以效率为例实测 87.4% 落在 88% 减 1% 的缓冲带内应该标成“临界合格”而不是直接判失败让复测来定性。把三态合格、临界、失败分开比布尔判定实用得多尤其在批次验收里临界项占比本身就是工艺稳定性的指标。4.2 用 matplotlib 把放电曲线和温升画出来数字表格看不出趋势异常往往藏在曲线拐点里。import matplotlib matplotlib.use(Agg) # 无界面环境下出图必须指定后端 import matplotlib.pyplot as plt def plot_discharge(t, v, i, out_pnghj913_discharge.png): fig, ax1 plt.subplots(figsize(8, 4.5)) ax1.plot(t, v, colortab:blue, label输出电压 (V)) ax1.set_xlabel(放电时间 (min)) ax1.set_ylabel(电压 (V), colortab:blue) ax1.grid(alpha0.3) ax2 ax1.twinx() ax2.plot(t, i, colortab:red, linestyle--, label放电电流 (A)) ax2.set_ylabel(电流 (A), colortab:red) # 标出截止点便于和报告里的结束时间对照 ax1.axvline(t[-1], colorgray, linestyle:, linewidth1) fig.tight_layout() fig.savefig(out_png, dpi150) return out_pngmatplotlib.use(Agg) 是必须的服务器上没有显示设备用默认后端会卡在初始化。双 y 轴是为了把电压和电流画在一张图里方便看恒流段转恒压段的那次切换如果曲线在切换点出现明显下冲通常是线缆压降或负载调整率不达标。axvline 标出截止时刻用来和报告里写的“放电时长 128 分钟”对上差异超过两分钟就要回头查采样间隔设置。出图后把 PNG 嵌回报告比纯文字版更容易让验收方看懂。4.3 用 docxtpl 回写一份可交付的报告判定结果最终要回到 Word 模板里。docxtpl 用 Jinja2 语法在 .docx 模板中占位对原有排版改动最小。from docxtpl import DocxTemplate tpl DocxTemplate(report_template.docx) ctx { model: HJ-913, test_items: [ {item: 板端转换效率, value: 89.2%, verdict: 合格}, {item: 满载温升, value: 88 度, verdict: 合格}, {item: 输出纹波, value: 112mVpp, verdict: 临界}, ], fail_count: 0, borderline_count: 1, } tpl.render(ctx) tpl.save(移动电源HJ-913测试报告_自动生成.docx)test_items 这类列表在模板里用 {% for %} 循环展开成表格行别在 Python 里拼字符串。fail_count 和 borderline_count 单独传进去是为了让首页的结论行不用再遍历列表。模板里所有占位符必须和 ctx 的键完全一致键名打错只会渲染成空字符串而不会报错所以生成后要加一道检查解压生成的 docx确认没有残留的 {{ 或 {% 字符。5. 让 HJ-913 测试报告不再靠手抄SCPI 取数与逐行核对5.1 用 pyvisa 从电子负载直接读取放电数据手工把电子负载上的读数抄进 Word是这类报告错误的头号来源。可编程电子负载基本都支持 SCPI接上 USB 或 LAN 之后用 pyvisa 就能直接读数一次放电测试的采样点全部落盘Word 里只剩结论需要填。import pyvisa, time rm pyvisa.ResourceManager() inst rm.open_resource(USB0::0x2A8D::0x9201::MY00000000::INSTR) inst.timeout 5000 # 毫秒读取超时别设太短 def measure(seconds10, interval1.0): rows [] inst.write(SENS:FUNC VOLT:CURR) # 同时开电压与电流测量 inst.write(SENS:REM ON) # 四线制远端补偿 inst.write(INP ON) for _ in range(int(seconds / interval)): v float(inst.query(MEAS:VOLT?)) i float(inst.query(MEAS:CURR?)) rows.append((time.time(), v, i)) time.sleep(interval) inst.write(INP OFF) return rows print(measure(3, 1.0))资源字符串因仪器型号而异用 rm.list_resources() 先列出来再填别凭印象写。timeout 设 5000 毫秒是给查询留余量SCPI 查询在负载切换量程时会短暂变慢超时太短会读到半截响应。SENS:REM ON 打开远端补偿后读数里已经扣掉了线缆压降和报告里手抄的数字必然有差异这个差异本身就是核对点。5.2 把实测数据与 doc 表格逐行对齐把 5.1 采到的数据和 3.2 解析出的表格按测试项名做左连接凡是同一测试项在两侧都有值、但相对偏差超过 2% 的单独列出来人工复核。实践中最常见的偏差来源有三类报告抄的是屏幕瞬时值而采集是稳态均值、报告用的是两线制读数、报告里的单位换算少了个 0。这三类写成固定检查规则每次生成报告前跑一遍比事后返工便宜得多。本文还有配套的精品资源点击获取 移动电源HJ-913测试报告：Python解析与SCPI自动判定
简介移动电源HJ-913测试报告是一份面向电源类硬件测试工程师、质检人员及电子相关专业学生的检测文档用于评估该型号移动电源的性能、安全性与可靠性可作为产品验收、研发自测与报告撰写时的参考范本。文档约159KB压缩包内仅含1个doc文件结构完整、目录清晰。内容围绕测试目的与测试条件展开细分为充放电性能与保护功能两大板块充放电部分覆盖充电特性、负载效应、动态负载、放电时间、输出效率与输出纹波保护部分涉及输入输出短路、过流、过压保护及电芯过充、过放、短路保护并延伸至显示、静态功耗、温度与低温可靠性等项目。已有191人学习下载读者可据此快速了解移动电源测试的指标口径、记录方式与验证思路直接套用或改编为同类产品的测试大纲。1. 拿到“移动电源HJ-913测试报告.doc”先看什么一份报告里到底藏了多少可复现的测试项“移动电源HJ-913测试报告.doc”这类文件多数不是测试软件直接导出的而是测试员在 Word 里手工拼的几个表格、几张放电曲线截图、几行手填的数字再套上公司模板另存为 .doc。它看起来像最终结论实际上更接近一次实验的原始记录——凡是没写清测量条件的数据都不能拿来复现。真正决定这份报告价值的是每个数字背后有没有跟着“什么负载、什么温度、什么线缆、什么仪器”这四个前提。做电源验证、代工验收、电芯选型或售后失效分析的人都得把这四件事从报告里抠出来只关心结论的采购看最后一页的“合格”盖章就够了。2. 移动电源HJ-913的核心测试项与可复现的数据口径2.1 容量、额定能量与转换效率的三种口径拿到 HJ-913 的报告最先要分清的是电芯标称容量、额定输出容量和整机转换效率这三个数字。电芯标称容量一般按 3.7V 平台算单位 mAh额定输出容量是 USB 口在 5V 下实际放出来的电量单位也是 mAh但因为升压损耗和线损通常只有标称值的 60% 到 70%而整机转换效率是能量口径的比值必须用 Wh 而不是 mAh 来算混用单位是这类报告里最常见的数据错误。具体口径常见有三种。第一种是电芯侧能量效率输出能量除以电芯放出的能量反映升压电路本身的水平好的方案在 5V/2A 下能到 88% 到 92%。第二种是板端效率只算 PCBA 输入端到输出端排除了电池内阻和保护板的损耗通常比整机高两三个点。第三种是包含充电头在内的一充一放往返效率会再低 10% 以上。很多报告把这三种混着写看的时候必须先把定义对齐否则不同批次的数字根本没有可比性。计算方式固定下来就能复现# 用放电曲线上的采样点计算输出容量与效率 # samples: [(t_s, v_out, i_out, v_cell, i_cell), ...] def capacity_and_efficiency(samples, dt1.0): out_wh 0.0 cell_wh 0.0 for _, v_out, i_out, v_cell, i_cell in samples: # 输出侧能量累加单位换算成 Wh out_wh v_out * i_out * dt / 3600.0 # 电芯侧用实时端电压而不是固定写 3.7V cell_wh v_cell * i_cell * dt / 3600.0 # 输出容量按 5V 折算仅用于和标称 mAh 对比 out_mah out_wh * 1000.0 / 5.0 eff out_wh / cell_wh if cell_wh else 0.0 return round(out_mah, 1), round(eff * 100, 2) # 示例5V/2A 恒流放电到 3.0V 截止 demo [(t, 5.02, 2.00, 3.85 - t * 0.0009, 2.28) for t in range(0, 7200, 1)] print(capacity_and_efficiency(demo))代码里有两个刻意的处理。一是电芯侧用采样到的实时端电压 v_cell而不是直接写 3.7V否则电池内阻带来的压降会被吞掉效率会被高估两到三个百分点。二是 dt 必须和采样间隔一致用 1Hz 采样就传 1.0用 0.1Hz 就传 10.0单位错一位容量就错一个数量级。返回的 out_mah 是按 5V 折算的对比值不是真实放电电荷量把它当成电芯容量就会得出“效率超过 100%”这种笑话。提示报告里写“容量 10000mAh”却没标注 3.7V 还是 5V 口径时一律按电芯标称理解USB 口能放出来的量要用 Wh 再除以 5V 换算。2.2 温升、保护点与纹波的测量条件温升测试的争议几乎全在测点上。HJ-913 这类 10000mAh 级别的产品发热集中在升压电感、同步整流 MOS 和 USB 母座焊盘外壳温度只是传导后的结果。稳妥做法是在电感和 MOS 表面点胶固定热电偶同时在外壳再贴一路记录从 25 度环境开始、满载连续放电 30 分钟的温度曲线。判据一般看两个数元件表面不超 95 度外壳不超 55 度且最后 10 分钟的温升斜率小于 1 度每分钟才算进入稳态。保护点测量要求负载电流可调且能短接。过流保护点通常标在额定输出的 1.3 到 2 倍之间短路保护看的是响应时间一般要求 1ms 内切断并在去掉短路后自动恢复。这里有个容易踩的坑很多报告写“短路保护正常”但没写清楚是用电子负载的短路模式还是直接短接母座两者电流上升率差很多慢断的样机在电子负载下能过、直接短接就可能烧 MOS。纹波的测量条件比数值本身更重要。探头必须用弹簧地针就近接地示波器开 20MHz 带宽限制和 AC 耦合否则会把开关尖峰和空间噪声全算进去。同一台样机用长地线夹测可能读到 200mV换弹簧地针就只剩 40mV。一组可对照的实测条件如下测试项主要仪器关键条件常见限值满载温升多路温度记录仪25±2 度环境满载 30min元件≤95 度外壳≤55 度过流保护可编程电子负载电流步进 0.1A每档保持 3s触发点 1.3~2 倍额定短路保护电子负载短路模式记录切断时间与恢复情况响应≤1ms可自恢复输出纹波示波器弹簧地针20MHz 带宽限制AC 耦合5V/2A 下≤100mVpp转换效率功率计电子负载满载放电至截止板端≥88%把这张表当成核对清单凡是 HJ-913 报告里没写清测点和条件的项判读时都要打问号因为同一批样机换个测法结论可能就翻过来。3. 用 python-docx 解析 HJ-913 测试报告表格并结构化3.1 .doc 与 .docx 的结构差异和解析前预处理python-docx 只能读 OOXML 格式的 .docx遇到老式 .doc 会直接抛异常因为 .doc 是 OLE 复合文档内部是二进制流加 Fib 结构解析难度和 .docx 不在一个量级。所以面对标题里这种 .doc 结尾的报告第一步不是写解析代码而是转格式。常见做法是用 LibreOffice 无头模式批量转换一条命令就能保留表格结构# 批量把 .doc 转成 .docx输出到 out 目录保留表格与样式 soffice --headless --convert-to docx \ --outdir ./out \ 移动电源HJ-913测试报告.doc # 转换结果核对文件头和表格数量 file ./out/*.docx python3 -c from docx import Document; dDocument(./out/移动电源HJ-913测试报告.docx); print(len(d.tables))参数上--headless 避免弹出图形界面--outdir 指定输出目录--convert-to 后面的 docx 也可以用 docx:MS Word 2007 XML 精确指定导出过滤器。转换会在同目录生成同名文件重复执行直接覆盖脚本里最好按时间戳建子目录。转换后用 file 确认文件头是 Zip archive data再看表格数量是否和原报告一致这一步能提前暴露“表格被当成文本框或图片”的问题——手工拼的报告里表格截图贴进去的情况并不少见这种就只能退回去让人补数据。注意LibreOffice 对复杂合并单元格和浮动文本框的还原度不稳定转完必须人工核对一次表头和行数别直接进自动化流程。3.2 把报告表格映射成结构化记录报告里的表格通常是“测试项 | 测试条件 | 实测值 | 判定”这种四列结构表头可能在第 0 行也可能被标题行占掉前两行。稳妥写法是先定位表头行再按列名建映射而不是硬编码列序号。import re, sqlite3 from docx import Document HEADER_KEYS {测试项: item, 测试条件: cond, 实测值: value, 判定: verdict} def find_header(table): for idx, row in enumerate(table.rows[:4]): cells [c.text.strip() for c in row.cells] hit sum(1 for c in cells if c in HEADER_KEYS) if hit 3: # 至少命中三列才认作表头 return idx, [HEADER_KEYS.get(c, c) for c in cells] return None, None def parse_report(path): doc Document(path) records [] for t_idx, table in enumerate(doc.tables): h_idx, header find_header(table) if header is None: continue for row in table.rows[h_idx 1:]: cells [c.text.strip() for c in row.cells] if len(cells) ! len(header): continue # 列数对不上直接丢弃交由校验环节发现 rec dict(zip(header, cells)) rec[table_idx] t_idx records.append(rec) return records def to_sqlite(records, dbhj913.db): conn sqlite3.connect(db) conn.execute(CREATE TABLE IF NOT EXISTS test_item( id INTEGER PRIMARY KEY AUTOINCREMENT, table_idx INTEGER, item TEXT, cond TEXT, value TEXT, verdict TEXT)) conn.executemany( INSERT INTO test_item(table_idx,item,cond,value,verdict) VALUES(:table_idx,:item,:cond,:value,:verdict), records) conn.commit() return conn.total_changes rows parse_report(./out/移动电源HJ-913测试报告.docx) print(入库行数:, to_sqlite(rows))关键点在 find_header它只看前四行用命中列名的数量判断哪一行是真表头这样标题行、单位说明行、空白行都不会被误当成数据。列数不等的行选择跳过而不抛异常是为了让格式不规范的表格不会中断整批解析代价是可能漏数据所以后面必须做行数核对。落库时 value 字段刻意存成文本因为报告里常有“3.85V”“≥88%”“正常”这类混合内容先原样保留归一化放到判定阶段做。3.3 解析结果校验与单位归一化解析完不校验等于把错误放大到下游。三个必查项总行数、表头列命中率、值字段能不能提取出数值。校验项检查方式不通过时的处理表格数量对比转换前后 tables 长度人工确认是否含截图表格数据行数与报告肉眼计数比对检查合并单元格是否打乱列表头命中率命中列数/总列数≥0.75扩充 HEADER_KEYS 别名数值可提取率正则匹配占比补写单位别名字典单位归一化用正则把数值和单位拆开再统一到基准单位U {v: 1.0, mv: 0.001, a: 1.0, ma: 0.001, w: 1.0, mw: 0.001} PAT re.compile(r^\s*([≤≥]?)\s*(-?\d(?:\.\d)?)\s*(mV|V|mA|A|mW|W)?\s*$, re.I) def normalize(text): m PAT.match(text or ) if not m: return None, None, None op, num, unit m.group(1), float(m.group(2)), (m.group(3) or ).lower() return op or , num * U.get(unit, 1.0), unit.lower()这个正则同时吃掉了比较符因为报告里“≥88%”“100mVpp”这类写法很常见直接 float() 会崩。unit 缺省时按基准单位处理但百分号和 Vpp 这类无量纲或复合单位要单独分支别硬套 U 字典。归一化后建议抽查五到十条记录和原报告逐字对照尤其是同一测试项分散在多个表格里的情况合并时容易张冠李戴。4. 基于解析结果自动判定 HJ-913 是否合格4.1 判定阈值表与容差怎么设第 2 章提到的限值需要落成代码里的表。判定不能只抄一个数必须带容差和方向否则同一个值在不同批次之间会来回翻。测试项阈值方向容差说明板端转换效率88%≥±1%取满载稳态 10 分钟均值输出容量标称×0.6≥±3%5V/2A 折算口径满载温升95 度≤±2 度元件表面稳态后取值外壳温度55 度≤±2 度同上输出纹波100mVpp≤±10%20MHz 带宽限制下过流保护点1.3~2 倍区间±0.1A触发点需落在区间内表里的容差不是仪器精度而是判定时允许的边界缓冲。以效率为例实测 87.4% 落在 88% 减 1% 的缓冲带内应该标成“临界合格”而不是直接判失败让复测来定性。把三态合格、临界、失败分开比布尔判定实用得多尤其在批次验收里临界项占比本身就是工艺稳定性的指标。4.2 用 matplotlib 把放电曲线和温升画出来数字表格看不出趋势异常往往藏在曲线拐点里。import matplotlib matplotlib.use(Agg) # 无界面环境下出图必须指定后端 import matplotlib.pyplot as plt def plot_discharge(t, v, i, out_pnghj913_discharge.png): fig, ax1 plt.subplots(figsize(8, 4.5)) ax1.plot(t, v, colortab:blue, label输出电压 (V)) ax1.set_xlabel(放电时间 (min)) ax1.set_ylabel(电压 (V), colortab:blue) ax1.grid(alpha0.3) ax2 ax1.twinx() ax2.plot(t, i, colortab:red, linestyle--, label放电电流 (A)) ax2.set_ylabel(电流 (A), colortab:red) # 标出截止点便于和报告里的结束时间对照 ax1.axvline(t[-1], colorgray, linestyle:, linewidth1) fig.tight_layout() fig.savefig(out_png, dpi150) return out_pngmatplotlib.use(Agg) 是必须的服务器上没有显示设备用默认后端会卡在初始化。双 y 轴是为了把电压和电流画在一张图里方便看恒流段转恒压段的那次切换如果曲线在切换点出现明显下冲通常是线缆压降或负载调整率不达标。axvline 标出截止时刻用来和报告里写的“放电时长 128 分钟”对上差异超过两分钟就要回头查采样间隔设置。出图后把 PNG 嵌回报告比纯文字版更容易让验收方看懂。4.3 用 docxtpl 回写一份可交付的报告判定结果最终要回到 Word 模板里。docxtpl 用 Jinja2 语法在 .docx 模板中占位对原有排版改动最小。from docxtpl import DocxTemplate tpl DocxTemplate(report_template.docx) ctx { model: HJ-913, test_items: [ {item: 板端转换效率, value: 89.2%, verdict: 合格}, {item: 满载温升, value: 88 度, verdict: 合格}, {item: 输出纹波, value: 112mVpp, verdict: 临界}, ], fail_count: 0, borderline_count: 1, } tpl.render(ctx) tpl.save(移动电源HJ-913测试报告_自动生成.docx)test_items 这类列表在模板里用 {% for %} 循环展开成表格行别在 Python 里拼字符串。fail_count 和 borderline_count 单独传进去是为了让首页的结论行不用再遍历列表。模板里所有占位符必须和 ctx 的键完全一致键名打错只会渲染成空字符串而不会报错所以生成后要加一道检查解压生成的 docx确认没有残留的 {{ 或 {% 字符。5. 让 HJ-913 测试报告不再靠手抄SCPI 取数与逐行核对5.1 用 pyvisa 从电子负载直接读取放电数据手工把电子负载上的读数抄进 Word是这类报告错误的头号来源。可编程电子负载基本都支持 SCPI接上 USB 或 LAN 之后用 pyvisa 就能直接读数一次放电测试的采样点全部落盘Word 里只剩结论需要填。import pyvisa, time rm pyvisa.ResourceManager() inst rm.open_resource(USB0::0x2A8D::0x9201::MY00000000::INSTR) inst.timeout 5000 # 毫秒读取超时别设太短 def measure(seconds10, interval1.0): rows [] inst.write(SENS:FUNC VOLT:CURR) # 同时开电压与电流测量 inst.write(SENS:REM ON) # 四线制远端补偿 inst.write(INP ON) for _ in range(int(seconds / interval)): v float(inst.query(MEAS:VOLT?)) i float(inst.query(MEAS:CURR?)) rows.append((time.time(), v, i)) time.sleep(interval) inst.write(INP OFF) return rows print(measure(3, 1.0))资源字符串因仪器型号而异用 rm.list_resources() 先列出来再填别凭印象写。timeout 设 5000 毫秒是给查询留余量SCPI 查询在负载切换量程时会短暂变慢超时太短会读到半截响应。SENS:REM ON 打开远端补偿后读数里已经扣掉了线缆压降和报告里手抄的数字必然有差异这个差异本身就是核对点。5.2 把实测数据与 doc 表格逐行对齐把 5.1 采到的数据和 3.2 解析出的表格按测试项名做左连接凡是同一测试项在两侧都有值、但相对偏差超过 2% 的单独列出来人工复核。实践中最常见的偏差来源有三类报告抄的是屏幕瞬时值而采集是稳态均值、报告用的是两线制读数、报告里的单位换算少了个 0。这三类写成固定检查规则每次生成报告前跑一遍比事后返工便宜得多。本文还有配套的精品资源点击获取