更新记录
1.0.0(2026-11-18)
首个版本:气弹簧安装点与手力校核。按力矩平衡在柜体与门板安装区内网格搜索,坐标以铰点为原点、门板方向为 +x,门板固定点随开启角转动;推力按伸展力 P1 与压缩力 P2 在行程内线性插值;全行程按采样点均分,输出关闭、半开、全开三点手力与最大最小手力,手力为负表示门自己上顶、需判定反推是否超限;净距为柜体固定点到弹簧轴线的垂距,避免与门板干涉。行程不符、离铰点太近、手力超标、反推超标四类否决分开计数,无方案时能指出卡在哪一条;方案先按全行程最大手力从小到大、再按压缩余量从大到小排序;同时给出该点零手力平衡所需的单支力,便于对着档位表选型;支持单点复核与 CSV 导出。Node 22 实跑 129 项断言,失败 0 项,覆盖单点几何与力矩、推力插值、手力与弹簧数量、单组合判定、入参校验、网格搜索与排序、搜索规模保护、动作建议、汇总与 CSV。Android 真机未执行(无可用设备,且 UTS 插件在标准基座被拒、无自定义基座);界面截图为 H5 真实渲染。
平台兼容性
uni-app
| Vue2 | Vue3 | Chrome | Safari | app-vue | app-nvue | Android | iOS | 鸿蒙 |
|---|---|---|---|---|---|---|---|---|
| × | √ | × | × | √ | × | √ | × | × |
| 微信小程序 | 支付宝小程序 | 抖音小程序 | 百度小程序 | 快手小程序 | 京东小程序 | 鸿蒙元服务 | QQ小程序 | 飞书小程序 | 小红书小程序 | 快应用-华为 | 快应用-联盟 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| × | × | × | × | × | × | × | × | × | × | × | × |
气弹簧安装点与手力校核
给钣金柜体、机箱与设备罩壳的结构设计:上翻门要装气弹簧,装在哪、装多长、门会不会自己往下砸、抬起会不会太费劲——这三件事多数厂还是靠试装,打错孔再补一块板。
本插件在给定的柜体与门板安装区内逐点搜索,按力矩平衡算出每个候选点的全行程手力、弹簧长度与压缩余量,直接给出可施工的固定点坐标与档位。
解决什么问题
- 装在哪:柜体固定点与门板固定点都给到毫米坐标(以铰点为原点,门板方向为 +x),钳工照坐标打孔即可。
- 装多长:给出该点在全行程上的最短与最长长度,反查档位伸展长度与行程,并留压缩余量,避免压到底顶死。
- 抬得动吗:按力矩平衡算关闭、半开、全开三点手力,给出全行程最大与最小手力,超出设定上限的直接判掉。
- 会不会砸下来:手力为负表示门自己往上顶、人要往回拉,超过反推上限判超标。
- 要多大劲的弹簧:给出该点零手力平衡所需的单支力,选型时对着档位表挑最接近的。
- 为什么没方案:行程不符、离铰点太近、手力超标、反推超标四类否决分别计数,不是只回一句「无解」。
算法口径
- 坐标以铰点为原点,关闭位门板方向为 +x。门板固定点在门板上距铰点
a,转到角度 α 时位于(a·cosα, a·sinα);柜体固定点(px, py)固定不动。 - 弹簧长度
s为两点直线距离;推力按伸展力 P1 与压缩力 P2 在行程内线性插值(压力随压缩近似线性上升),未填 P2 时按 P1 等值处理。 - 重力矩
= −m·g·cg·cosα,以开门方向为正;弹簧力矩= n·F·(qx·py − qy·px) / s,n为单门弹簧数量。 - 手力
= −(弹簧力矩 + 重力矩) / 手力半径,负值表示门自己往上顶、需要人往回拉。 - 全行程按设定采样点数均分(至少 3 点)逐点核算,取最大手力判定是否超上限,取最小手力判定是否超反推上限。
- 净距为柜体固定点到弹簧轴线的垂距(线段距离),小于设定值时判离铰点太近,避免与门板干涉。
- 搜索按步长遍历门板距离与柜体区域(含边缘余量),超出规模上限时截断并提示放大步长。
接口
import { gasSpringPlan, gasSpringCheck, gasSpringExportCsv } from '@/uni_modules/szhzy-gas-spring'
const out = gasSpringPlan({
door: { massKg: 12, cgMm: 300, handMm: 500, startDeg: 0, openDeg: 100, maxHandN: 60, maxPushN: 30, springCount: 2 },
doorZone: { xMin: 200, xMax: 500, yMin: 0, yMax: 0 },
frameZone: { xMin: -80, xMax: 60, yMin: 100, yMax: 300 },
search: { marginMm: 15, stepMm: 20, samples: 21, clearMm: 12, strokeMarginMm: 5, maxPlans: 8 },
specs: [{ id: 'GS400-250', extendedMm: 400, strokeMm: 250, forceExtN: 160, forceCompN: 240 }]
})
// out.rows[i]:门板距离、柜体坐标、档位、关闭/半开/全开手力、最大最小手力、长度区间、压缩余量、净距、判定
单点复核算已有设计:
const one = gasSpringCheck({ door: {...}, spec: {...}, aMm: 320, pxMm: -10, pyMm: 180, angleDeg: 50 })
// one: lenMm / armMm / forceN / handN / clearMm / inStroke / holdOk
gasSpringExportCsv(options) 把候选方案表写成 CSV,默认落在应用私有 documents 目录,bom 传 true 时补 BOM。
判定码
| 码 | 含义 | 现场动作 |
|---|---|---|
| OK | 行程、净距、手力、反推全部合格 | 按坐标打孔,按档位下单 |
| STROKE | 该点行程不够或压缩余量不足 | 换更长行程档位,或把固定点往里挪 |
| CLEAR | 弹簧轴线离铰点太近 | 固定点外移,避开与门板干涉 |
| HAND | 全行程手力超上限 | 加大单支力、增加支数,或改安装点 |
| PUSH | 门自己往上顶的力超反推上限 | 减小单支力,或加阻尼/限位 |
购买前必读
- 必须自己填门体参数。重心半径与手力半径按实际门体量,附件的重量要算进去;填错这两个数,结论一定错。
- 只算平面力矩,不做结构强度。不算门板刚度、铰链承载、支架焊缝与螺钉强度,也不做干涉三维检查。
- 档位力值用厂家实测曲线。插件按 P1/P2 线性插值,实际气弹簧有温升与摩擦差异,选型后仍要试装复测。
- 不做平开与下翻门。仅覆盖上翻门(含起始角不为 0 的斜置工况),不做抽屉、翻板与多连杆机构。
验证状态
- 纯逻辑层 Node 22 实跑断言,覆盖单点几何与力矩、推力插值、手力与弹簧数量、单组合判定、入参校验、网格搜索与排序、搜索规模保护、动作建议、汇总与 CSV;失败 0 项,项数见「测试记录」。
- HBuilderX 真编译(
launch app-android --compile true)通过并核验 Kotlin 产物,见发布清单。 - Android 真机未执行:
adb devices无可用设备,且 UTS 插件在标准基座被拒(原生配置不能生效),无自定义基座。 - 市场截图为 H5 真实渲染,不是真机截图。
- 仅支持 Android;iOS、鸿蒙与多语言未实现。
许可
普通授权可在自有或受托开发的 App 中使用,不得再分发源码;源码授权可修改与二次开发,不得转售或作为同类插件重新发布。

收藏人数:
购买源码授权版(
试用
赞赏(0)
下载 15
赞赏 0
下载 12771027
赞赏 1959
赞赏
京公网安备:11010802035340号