对结构求解器的每一项修复,都会改变某个人可能已经用过的数值。原先偏高的屈曲系数现在变低了;原先可以求解的模型现在被拒绝求解。如果修复悄无声息地进入应用,已经交付的计算中仍留着旧的数值,而做出这些计算的工程师没有理由再去查看。
本文介绍 Stabileo 对此所做的事情,从发现缺陷的那一刻,到其修复发布的那一刻。示例都是真实的:2026 年 11 月 4 日和 5 日,十四个结果版本(16 至 29)上线了 stabileo.com。
什么是结果版本
结果版本是一个整数,独立于应用版本。每当有改动上线到网站,使同一个已保存的模型得到不同的数值,或使原先可以求解的模型被拒绝求解,它就加一。每一项这类改动都会登记以下内容:
- 它所属的版本、日期和相关的拉取请求;
- 它涉及哪些模型,以模型特征来描述:带约束的平面模型、杆件上带荷载的 2D 屈曲分析、按 CIRSOC 201 验算的混凝土构件;
- 应用六种语言各一份的标题和面向工程师的说明,其中写明需要重新验算什么;
- 指向完整说明的链接:公告、结果变更说明或更新日志。
每次求解都会在项目上盖上产生该结果的结果版本的戳记,同时记录应用版本、提交、引擎版本、引擎二进制文件的哈希值以及所运行的分析。这个戳记随项目流转:已保存的文件、自动保存、打开的标签页或共享链接都带有它。
版本为什么会变化
多数变化是修复:原先错误的结果现在正确了。有些是拒绝求解:原先能给出数值的模型,现在改为给出明确的提示,因为那个数值没有意义。版本还可以撤销改动:版本 15 撤回了版本 14 中的三项改动,因为它们的评审修复没有随之一起上线;版本 27 至 29 又把它们带了回来,这次已经过评审。用版本 14 求解过的项目会收到关于这两者的通知。
| 版本 | 变更 | 类型 |
|---|---|---|
| 16 | 铝合金:验算弱轴剪力 | 修复 |
| 17 | 钢结构节点:不再忽略弱轴弯矩 | 拒绝求解 |
| 18 | ACI 318 和 EN 1992:有扭矩作用的混凝土构件标为未验算 | 拒绝求解 |
| 19 | 钢筋混凝土柱还会在其最小压力下进行验算(SA-2026-041) | 修复 |
| 20 | 荷载生成器:部分处于低矮屋面结构之下的楼面保留其面荷载(SA-2026-033) | 修复 |
| 21 | 导出的壳图形采用屏幕上的场量和比例 | 修复 |
| 22 | 2D:刚性连接或刚性隔板之后的机构会被拒绝求解 | 拒绝求解 |
| 23 | 沿杆件轴力变化的杆件的 2D 屈曲(SA-2026-042) | 修复 |
| 24 | 绕多个轴发生大转动的 3D 共旋分析(SA-2026-037) | 修复 |
| 25 | 从 Y–Z 或 X–Y 平面截取的 2D 模型的约束(SA-2026-036) | 修复 |
| 26 | 杆件的控制值和 2D 包络读取真实峰值 | 修复 |
| 27–29 | 版本 15 撤回的三项基础模式改动经评审后回归:塑性倒塌、P-Δ 和弯矩影响线的符号 | 修复 |
重新验算通知
打开项目时,应用会把项目的戳记与登记册对比,并列出自那时以来涉及该模型的变更。带屈曲分析的平面框架会收到 2D 屈曲修复的通知;不含混凝土的钢框架则不会收到钢筋混凝土柱验算的通知。这份列表不是会消失的提示:通知没有关闭按钮,不响应 Esc 键,也不响应点击其外部,只有勾选“我已阅读这些变更”,并选择继续或重新运行,才会关闭。

在模型重新求解之前,其结果会被标记为已过期:页面上有横幅说明,其间导出的每一份报告、工作簿和 CSV 在其来源信息中都会打印 STALE 警告。“重新运行分析和设计”会再次求解,并且在 PRO 中,会用已经选定的配筋重新验算混凝土构件;它不会重新设计这些构件,因为那会覆盖工程师选定的钢筋。
自 11 月 4 日起(#1406),通知会以读者的语言解释每一项变更,应用的六种语言全部覆盖。在此之前,德语、法语和土耳其语的读者看到的标题和说明是英文:已登记的 72 项变更中,有 66 项在这些语言中没有文本。每一份译文都经过检查:不看原文,把它翻译回英文,再比较含义,包括数值、符号、哪一种荷载、哪一项验算、偏安全还是偏不安全。这一检查纠正了三种语言中的句子,还发现有四条英文说明在源头上就有歧义;这些都已在六种语言中修正。
修复之前:警告或拒绝求解
缺陷通常是在修复之前被发现的,有时早几天。在这段时间里,受它影响的结果仍显示在屏幕上。我们遵循的规则是先遏制,后修复(issue #447):每一个可能给出错误结果的未解决缺陷,在它影响的每一个入口处,都要有警告或拒绝求解。
- 警告保留结果,并在旁边显示哪个已知问题可能影响它,以及需要手工检查什么。
- 当数值可能错出很大倍数,而又无法从输出中察觉时,拒绝求解会暂不提供结果并说明原因,例如系数会随杆件编号而变化数倍的情形。

遏制措施记录在一份登记册中,列出每一个未解决的安全问题、它的警告或拒绝求解、触发它的条件,以及证明它会触发的测试,或者说明无需遏制的依据。一项测试保证登记册与引擎的已知问题清单保持一致,一个定时任务则把登记册与 GitHub 上未关闭的 issue 对比。条件是有意收得很窄的:在结果语料库的 39 个模型中,每条警告最多只对其中两个触发。为每一个未解决的 issue 补全这份登记册的拉取请求(#807)已于 11 月 5 日合入,早于 0.5.0 版本发布。
遏制在其修复合入时结束,并且在同一个拉取请求中结束。本周,#1295 取消了对 3D 转 2D 截取的拒绝求解,该拒绝求解针对的是使杆件绕错误轴弯曲的情形,因为现在截取已经正确;#1301 把对每一次 3D 共旋求解都出现的警告,换成只在杆端相对其弦线转动超过 0.02 rad 时才触发的警告,因为剩余的近似只有在此时才可能产生影响。
本周的修复
杆件上带轴向荷载的 2D 屈曲(#1324,版本 23)。每根杆件的几何刚度使用的是其平均轴力。当压力朝转动最大的一端增大时,例如斜梁承受重力,或跨内有轴向集中荷载,得出的屈曲系数偏高,而没有任何警告。现在每根杆件都对其变化的轴力进行积分。
| 算例 | 精确值 | 修复前 | 现在 |
|---|---|---|---|
| 悬臂,压力由支座处的 0 增大到端部的 P | 3.477 | 4.972 (+43 %) | 3.542 (+1.9 %) |
| 悬臂,端部有推力 P,跨中有反向的轴向荷载 P:只有从跨中到端部才有压力 P | 2.961 | 4.972 (+68 %) | 3.056 (+3.2 %) |
| 欧拉重力柱,压力在支座处最大 | 7.837 | 4.972 (−37 %) | 7.889 (+0.7 %) |
剩下的百分之几是每根杆件一个单元的通常离散误差,随着杆件被划分得更细而减小。P-Δ 分析仍使用平均轴力,而杆件上带荷载的 3D 屈曲在其自身修复完成之前仍保留警告。
3D 共旋分析(#1301,版本 24)。杆端转角此前是作为转动向量相减的,只有当所有转动共轴时这才是精确的。Bathe–Bolourchi 的 45° 弯曲算例与其已发表的解相差 1.3 %,而且加密网格会使其远离参考解,而不是趋近。现在转动按旋转矩阵复合:同一个弯曲算例与两个独立的已发表解相差都在 0.4 % 以内,并在二者之间收敛。两端相对转动超过 0.9π 的杆件会被拒绝求解,因为结果无法说明所指的是转了整整几圈。
2D 中的隐藏机构(#1298,版本 22)。从一个所有杆件都为铰接的节点引出的刚性连接或刚性隔板,连到桁架杆件的端部,就构成机构,但求解器用一个很小的人工弹簧把它约束住,返回了数百公里的位移,而证书还对其作了认证。现在这样的模型会被拒绝求解。这次修复没有提出公告:在所发现的算例中,位移荒谬,约为 10⁵ m,并且伴有应用给出的可能存在机构的警告。这是对那些算例的判断,而不是没有任何受影响的结果看起来合理的证明。错的是证书的声明,而版本条目会告知它所涉及的项目。之后又发现了一个类似的案例,是通过连接件而不是刚性连接出现的(#1414);其修复(#1415)已于 11 月 5 日合入。
把 3D 模型截取为 2D(#1295)。截取时对每根杆件都使用了各截面的强轴惯性矩,因此 Y–Z 截取中的柱、X–Y 截取中的梁以及旋转 90° 的杆件都绕错误的轴弯曲:一个立在 Y–Z 平面中的 IPN 300 门式刚架,2D 下侧移 0.96 mm,而 3D 下为 13.0 mm。现在每根杆件在 2D 中绕其在 3D 中弯曲所绕的轴弯曲,平面模型无法表示的截取会被拒绝求解。这项修复没有结果版本,这是有意为之:已保存的 2D 模型的求解结果与之前完全一致,因为错的是截取所产生的模型。重新验算通知无法触及这些文件,因此渠道是公告(SA-2026-035):从 3D 重新截取模型,或者直接用 3D 求解。
修复之后:公告
凡是在已发布版本中可能产生错误或偏不安全结果的缺陷,都会发布安全公告:哪里出了错,影响哪些模型,如何识别它们,对已交付的结果需要重新验算什么,以及能复现它的算例。本周这些修复的公告已在代码仓库中起草,将随 0.5.0 版本一并发布,正如 SA-2026-001 至 024 随 0.3.0 和 0.4.0 发布一样。
| 公告 | 哪里出了错 | 严重程度 |
|---|---|---|
| SA-2026-033 | 当一根低矮的构件立在某层楼面的一部分之上时,荷载生成器漏掉了该层的面荷载 | 高 |
| SA-2026-034 | 对于漏掉了部分荷载的校核,平衡校核依然显示吻合 | 中 |
| SA-2026-035 | 3D 转 2D 截取使杆件绕错误的截面轴弯曲 | 高 |
| SA-2026-036 | 在 Y–Z 或 X–Y 上的 3D 转 2D 截取,把约束按框架立在 X–Z 平面中来读取 | 高 |
| SA-2026-037 | 3D 共旋分析把转动向量相减 | 中 |
| SA-2026-040 | ACI 318 和 EN 1992 验算在没有验算扭矩的情况下让混凝土构件通过 | 高 |
| SA-2026-041 | 钢筋混凝土柱验算只把最大弯矩与最大压力配对 | 高 |
| SA-2026-042 | 2D 屈曲高估了压力沿杆件增大的杆件的屈曲系数 | 高 |

这套机制做不到什么
- 通知只知道已登记的变更。尚未发现的缺陷不在任何登记册中;这正是求解器背后的验证所要解决的,也是一旦发现问题后遏制措施所涵盖的。
- 它从已保存的文件中读取模型的特征,无法判断时,就把该特征视为存在:多一次通知,好过一项变更对其所涉及的模型隐而不报。
- 数值一旦离开应用,出现在图纸、电子表格或已交付的报告中,它就无法再追踪。这正是公告的作用。
- 无论是被遏制、被拒绝求解还是已修复,结果在签字之前仍然要由工程师检查。