更新记录

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),钳工照坐标打孔即可。
  • 装多长:给出该点在全行程上的最短与最长长度,反查档位伸展长度与行程,并留压缩余量,避免压到底顶死。
  • 抬得动吗:按力矩平衡算关闭、半开、全开三点手力,给出全行程最大与最小手力,超出设定上限的直接判掉。
  • 会不会砸下来:手力为负表示门自己往上顶、人要往回拉,超过反推上限判超标。
  • 要多大劲的弹簧:给出该点零手力平衡所需的单支力,选型时对着档位表挑最接近的。
  • 为什么没方案:行程不符、离铰点太近、手力超标、反推超标四类否决分别计数,不是只回一句「无解」。

算法口径

  1. 坐标以铰点为原点,关闭位门板方向为 +x。门板固定点在门板上距铰点 a,转到角度 α 时位于 (a·cosα, a·sinα);柜体固定点 (px, py) 固定不动。
  2. 弹簧长度 s 为两点直线距离;推力按伸展力 P1 与压缩力 P2 在行程内线性插值(压力随压缩近似线性上升),未填 P2 时按 P1 等值处理。
  3. 重力矩 = −m·g·cg·cosα,以开门方向为正;弹簧力矩 = n·F·(qx·py − qy·px) / s,n 为单门弹簧数量。
  4. 手力 = −(弹簧力矩 + 重力矩) / 手力半径,负值表示门自己往上顶、需要人往回拉。
  5. 全行程按设定采样点数均分(至少 3 点)逐点核算,取最大手力判定是否超上限,取最小手力判定是否超反推上限。
  6. 净距为柜体固定点到弹簧轴线的垂距(线段距离),小于设定值时判离铰点太近,避免与门板干涉。
  7. 搜索按步长遍历门板距离与柜体区域(含边缘余量),超出规模上限时截断并提示放大步长。

接口

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 中使用,不得再分发源码;源码授权可修改与二次开发,不得转售或作为同类插件重新发布。

隐私、权限声明

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

无系统权限。

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

插件不采集、不上传任何数据,不访问网络,不写日志。门体参数、安装区与档位表只在本机内存处理。

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

无

暂无用户评论。