更新记录

1.0.0（2026-11-07）

首个版本：串压窗口按「单颗 Vf + 分档 ±% + 温度系数」算最低串压（最高温、分档下限）与最高串压（最低温、分档上限），默认温区 −20…+50℃、分档 ±5%、温漂 −2.5 mV/℃，都可在调用时改，同时给常温典型串压方便对图纸。驱动匹配四道门：恒流值（±5%）、输出电压上限、输出电压下限、额定功率；判定分七档（匹配 / 电流不匹配 / 超出电压上限 / 低于电压下限 / 功率超载 / 余量不足 / 功率过设计），每档给具体改法。输入侧给输入功率、输入电流、1.5 倍上取标准规格的保险丝与驱动自身发热。并联均流按分档差（不是整段温度窗口）折算均流电阻与电阻功耗，功耗超 0.5 W 直接提示改用多路恒流。规格归并：一批型号按电流档与功率档上取，输出采购要备的驱动清单与省下的种数。文本台账认逗号/制表符/分号/竖线，表头与注释自动跳过，列数不足的行丢掉不猜值。导出灯板匹配表 24 列与规格归并表 7 列两份 CSV，UTF-8 带 BOM。UTS→Kotlin 编译通过（index.kt 1246 行、classes.dex 61656 字节），106 项回归测试全部通过；真机未执行（adb devices 为空，测试机不在线），市场截图为 H5 渲染并标注示例数据。

平台兼容性

uni-app

LED 驱动选型与余量校验

给灯具厂的电子与结构工程师：这块灯板要配多大的恒流驱动、余量够不够、并联两串会不会一边亮一边暗。

选驱动最容易出错的不是算功率，而是拿常温典型串压去卡驱动的输出电压范围。灯珠在 −20℃ 时 Vf 比 25℃ 高、在 50℃ 时低，再加上 ±5% 的分档，串压窗口能拉开二十多伏。按典型值选出来的驱动，夏天亮度掉、冬天可能进保护。本插件按最坏情况算窗口，四道门一起判。

它算的四道门

结论分六档：匹配 / 电流不匹配 / 超出电压上限 / 低于电压下限 / 功率超载 / 余量不足 / 功率过设计，每一档都给出怎么改（换电流档、改并联串数、换功率档）。

输入侧与并联

• 输入功率 = 峰值功率 ÷ 效率；输入电流 = 输入功率 ÷ 输入电压；
• 建议保险丝 = 1.5 × 输入电流，上取到标准规格（0.5 / 1 / 1.6 / 2 / 2.5 / 3.15 / 4 / 5 / 6.3 / 8 / 10 / 12 / 16 A）；
• 驱动自身发热 = 输入功率 − 峰值功率，用于判断要不要加散热；
• 并联多串：串间电压差 ÷ 允许电流差，再扣掉串内动态电阻，得到该串的均流电阻与电阻功耗。均流电阻是兜底手段，能用同 bin 同批次解决就别用电阻。

规格归并

一批型号各自算完后，按「电流档 + 额定功率档」归并，输出一张采购清单：几种驱动、每种的电流/电压窗口/额定功率、覆盖哪些型号、组内最大负载率。型号 8 个归成 3 种驱动，采购就少备 5 种。

用法

import { ledCheck, ledNormalize, ledExport } from '@/uni_modules/szhzy-led-driver'

// 一块灯板 + 一个候选驱动
const one = ledCheck({
  boards: [{
    name: '投光灯 150W',
    vf25: 3.0,        // 单颗正向压降，V
    ns: 48,           // 串联颗数
    np: 1,            // 并联串数
    ifMa: 1050,       // 每串驱动电流，mA
    drvIoutMa: 1050,  // 驱动恒流，mA
    drvVoutMin: 120,  // 驱动输出电压下限，V
    drvVoutMax: 160,  // 驱动输出电压上限，V
    drvPratedW: 200   // 驱动额定功率，W
  }]
})
// one.boards[0].verdict === 'ok'，one.boards[0].loadPct 是负载率

// 批量 + 归并
const all = ledNormalize({ boards: rows })
// all.specs 是要备的驱动种数，all.saved 是省下的种数

文本台账一行一块灯板，分隔符逗号/制表符/分号/竖线都认，表头与 # 注释自动跳过：

型号,单颗Vf,串数,并数,电流mA,分档%,温漂mV/℃,最低温,最高温,驱动电流mA,下限V,上限V,额定W
投光灯 150W,3.0,48,1,1050,5,-2.5,-20,50,1050,120,160,200
线条灯 40W,2.8,24,2,700,5,-2.5,-20,50,,,, 

后四列留空就是「还没选驱动」，此时只输出需求规格，不给判定。

参数默认值

验证状态

• 纯逻辑测试：见 docs/led-driver/测试记录.md，覆盖串压窗口、温漂方向、分档、六档判定边界、均流电阻、归并与 CSV 列数。
• UTS → Kotlin 编译：compiled successfully，产物行数与字节数见测试记录。
• 真机：未执行。当前测试机不在线（adb devices 为空），真机运行与真机截图都没有做，市场截图为 H5 渲染并在页面上标注示例数据。不要当成真机验证过。

购买前必读

• 本插件判的是电气匹配，不代替安规（爬电距离、绝缘、SELV）、能效认证与 EMC；出货前仍要按认证口径实测。
• 灯珠 Vf 必须用你自己批次、你自己电流点的实测值，不要用网页上的通用值。插件里所有默认值都是起点，不是结论。
• 均流电阻是按最坏串压差估的保守值，实际可先试同 bin 同批次；电阻功耗算出来超过 0.5 W 时，多半该改成多路恒流而不是硬加电阻。
• 只支持 Android，iOS / 鸿蒙不支持；uni-app Vue3。