更新记录

1.0.0(2026-11-16)

首个版本:换电制 AGV 车队的备电与充电资源测算。按每台车班次耗电推换电请求时刻,按容量与 SOC 窗口推可用能量,按充电功率与效率推充电分钟并向上取整,充电结束再加冷却分钟得到电池周转时间;模拟逐分钟推进,换下即进充电队列,冷却期与充电期都不算可用。最少备电组数用逐步加组并重跑模拟求得,直到没有车因缺包等待;备电足够仍缺包时判定为充电位不足并逐级加到不缺包;最少换电位取模拟中最大同时换电车数。最后用现状配置再跑一遍,给出因缺包等待、换电位排队、充电位排队的分钟数与单班充电量。电池容量、SOC 上限与换电阈值、充电功率与效率、冷却与换电耗时、班次时长与每日班次均可配置,车辆按清单逐台填耗电。结论分够用与缺口两档,缺口时给出备电、充电位、换电位三项还差多少。模拟为确定性,同输入同输出,便于评审复算。Node 22.22.2 实跑 59 项断言,失败 0 项,覆盖单包周转手算、向上取整、单班换电次数、零备电必然缺包、备电递增到不缺包、充电位与换电位不足、五类非法输入与耗电为零边界;HBuilderX launch --compile true 真编译通过并核验 Kotlin 产物。Android 真机未执行(本轮 ADB 无设备);界面截图为 H5 真实渲染。


平台兼容性

uni-app

Vue2 Vue3 Chrome Safari app-vue app-nvue Android iOS 鸿蒙
× √ × × √ × √ × ×
微信小程序 支付宝小程序 抖音小程序 百度小程序 快手小程序 京东小程序 鸿蒙元服务 QQ小程序 飞书小程序 小红书小程序 快应用-华为 快应用-联盟
× × × × × × × × × × × ×

AGV 换电备电组数测算

给厂内物流、自动化与设备工程师的一段离线代码:换电制 AGV 车队到底要配几组备用电池、几个充电位、几个换电位,不用靠经验拍。

解决什么问题

换电制的账不好算:一台车一个班跑多少电、电池从 15% 充回 95% 要多久、换下来还要冷却多久、几台车会不会同时来换。算错的代价很直接——备电不够就是排队停线,备电过多就是压资金,充电位不够则把周转时间拉长,看起来像电池不够用。

本插件把这件事做成分钟级离散模拟:按每台车的班次耗电推换电时刻,按充电功率与冷却时间推电池周转,再逐分钟看有没有车在等电池、有没有车在等换电位。

推算口径

项 口径
可用能量 容量 × (SOC 上限 − 换电阈值) ÷ 100
每车换电次数 由模拟得出:SOC 掉到阈值即提出请求,换到满电后重新计时
充电分钟 可用能量 ÷ (充电功率 × 效率) × 60,向上取整
电池周转 充电分钟 + 冷却分钟;冷却期内不算可用
最少备电组数 逐步增加备电并重跑模拟,直到没有车因缺包等待
最少充电位 备电已足够时仍缺包,说明充电位不足;逐级加到不缺包为止
换电位数量 取模拟中出现过的最大同时换电车数
缺口 最少需求减去现状配置,分别给备电、充电位、换电位三项

模拟是确定性的:同样的输入每次得到同样的结果,便于评审时复算。

公开 API

import { agvPlan, agvVersion } from '@/uni_modules/szhzy-agv-battery'

const out = agvPlan({
  shiftMinutes: 480,        // 班次时长
  shiftsPerDay: 2,
  capacityKwh: 10,          // 单包标称容量
  socMax: 95,               // 允许充到
  swapAtSoc: 15,            // 掉到此值换电
  powerKw: 3,               // 充电机有效功率
  efficiency: 0.9,
  coolMinutes: 15,          // 换下后冷却/静置
  swapMinutes: 6,           // 单次换电耗时(含行驶、举升、对接)
  spare: 2,                 // 现有备电组数(不含车上)
  chargers: 2,              // 现有充电位
  stations: 1,              // 现有换电位
  vehicles: [
    { id: 'A1', energyPerShift: 22 },
    { id: 'A2', energyPerShift: 15 }
  ]
})

out.minSparePacks      // 最少备电组数(不含车上)
out.minChargers        // 最少充电位
out.minStations        // 最少换电位
out.gapPacks           // 还差几组备电
out.turnaroundMinutes  // 电池周转分钟
out.swapsPerShift      // 全车队单班换电次数
out.perVehicle         // 每台车的换电次数
out.verdict            // OK / SHORT
out.waitPackMinutes    // 现状配置下因缺包的等待分钟

返回信封 { ok, code, message, ... },错误用 code 表达,不抛异常:

code 含义
SUCCESS 推算完成
NO_VEHICLE 未录入车辆
BAD_PACK 容量、SOC 窗口或充电能力无效
BAD_SHIFT 班次时长或换电耗时无效
INFEASIBLE 备电加到 40 组仍无法消除缺包

购买前必读

  • 耗电要按实测填,不要按电机功率估。 一个班次的耗电包含行驶、举升、转向、等待与通信,只按牵引功率算会低估。
  • 本插件只做换电制。 机会充电、 depot 充电、混合策略不在范围内;那类场景要看充电窗口与并网容量,算法不同。
  • 不内置电池库,也不判断电池是否该退役。 容量衰减、低温降容、BMS 限流都要你自己在容量与功率里体现。
  • 换电耗时是平均值。 实际会有对接失败、举升卡顿,建议按实测均值上浮后再填。
  • 模拟不含路径拥堵与任务插单。 真实车队的换电请求会分散,本插件按最不利的匀速耗电估算,结果偏保守。
  • 仅支持 Android。 iOS、鸿蒙与各小程序端未实现。

验证状态

  • 编译:cli launch app-android --project <演示工程> --compile true 真编译通过,Kotlin 产物已核对存在与行数。
  • 逻辑:Node 实跑核心逻辑断言,覆盖单包周转手算、单班换电次数、零备电必然缺包、备电递增到不缺包、充电位不足与换电位排队、SOC 窗口非法与超上限,失败 0 项。
  • 界面:H5 渲染真实页面截图,演示数据由插件按车队清单计算得出。
  • Android 真机未执行:本轮 ADB 无在线设备,真机链路未验证。

许可

商用授权范围内可用于任意数量的自有 App。源码授权可二次开发,但不得转售或作为同类插件重新发布。

隐私、权限声明

1. 本插件需要申请的系统权限列表:

无系统权限。

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件不采集、不上传任何数据,不访问网络,不写日志。输入与模拟结果只在本机内存处理。

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

无

暂无用户评论。