qtmodel 2.9.2__tar.gz → 2.9.3__tar.gz

{qtmodel-2.9.2/src/qtmodel.egg-info → qtmodel-2.9.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: qtmodel
-Version: 2.9.2
+Version: 2.9.3
 Summary: Python API and local engineering utilities for Qiaotong bridge software
 Author: Qiaotong
 Keywords: bridge,finite-element,qiaotong,engineering
@@ -19,7 +19,7 @@ Requires-Dist: psutil>=5.9
 `qtmodel` 是桥通软件的 Python API 包，提供有限元模型创建与修改、模型查询、
 求解结果读取、结构检算，以及不依赖桥通进程的截面几何和截面特性计算。
 
-> 当前版本：`2.9.2` · Python：`3.10+` · 文档生成日期：`2026-09-22`
+> 当前版本：`2.9.3` · Python：`3.10+` · 文档生成日期：`2026-10-13`
 > 本文件由 `tools/create_readme.py` 从源码签名和 docstring 自动生成，请勿手工维护函数清单。
 
 ## 安装
@@ -40,16 +40,17 @@ print(QtServer.get_connection_status())
 - `odb`：读取分析结果并控制结果绘图和视图；
 - 2.x 仍保留部分 `odb` 模型查询兼容入口，新代码应统一改用 `mdb`；
 - `cdb`：调用结构检算接口；
+- 历史 SDK 中仍存在的 17 个未开放命令会在连接前返回 `API_NOT_OPEN`；方法存在不代表当前桌面服务端已开放。
 - 迁移说明：[`ODB` 模型查询迁移到 `MDB`](https://gitee.com/jack0443/qtmodel-release/blob/master/packages/qtmodel/docs/mdb-odb-query-migration.md)。
 
 ## API 数量
 
 | 命名空间 | 公开方法数 |
 | --- | ---: |
-| `mdb` | 423 |
+| `mdb` | 446 |
 | `odb` | 40 |
-| `cdb` | 126 |
-| **合计** | **589** |
+| `cdb` | 127 |
+| **合计** | **613** |
 
 Core 类与 `bridge` 门面的 API 未在本页展开，完整参考见：
 [`docs/api-reference.md`](https://gitee.com/jack0443/qtmodel-release/blob/master/packages/qtmodel/docs/api-reference.md)。
@@ -783,14 +784,14 @@ mdb.add_general_elastic_support_property(name = "特性1", data_matrix=[i for i
 mdb.add_general_elastic_support(node_id=None, property_name: str='', group_name: str='默认边界组', index: int=-1)
 ```
 
-添加一般弹性支承特性
+添加一般弹性支承；相同边界组和节点时覆盖已有支承。
 
 #### 参数
 
->     node_id: 节点号,支持整数或整数型列表且支持XtoYbyN形式字符串
+>     node_id: 节点号，支持整数、整数列表和XtoYbyN形式字符串；重复节点只处理一次
 >     property_name: 一般弹性支承特性名
 >     group_name: 一般弹性支承边界组名
->     index: 起始对象编号，-1 表示自动分配
+>     index: 起始对象编号，-1 表示覆盖时保留原编号、新增时自动分配
 
 #### 示例
 
@@ -808,20 +809,21 @@ mdb.add_general_elastic_support(node_id=1, property_name = "特性1",group_name=
 源码：`qtmodel/mdb/mdb_boundary.py` · `MdbBoundary.add_general_support`
 
 ```python
-mdb.add_general_support(node_id: Union[int, str, list[int]]=1, boundary_info: Union[list[bool], list[int]]=None, group_name: str='默认边界组', index: int=-1, coordinate=None, extra_enabled=None, extra_parameters=None)
+mdb.add_general_support(node_id: Union[int, str, list[int]]=1, boundary_info: Optional[Union[list[bool], list[int]]]=None, group_name: str='默认边界组', index: int=-1, coordinate: Optional[int]=None, extra_enabled: Optional[bool]=None, extra_parameters: Optional[list[float]]=None)
 ```
 
-添加一般支承
+添加一般支承；相同边界组和节点时覆盖已有支承。
 
 #### 参数
 
->     node_id: 节点编号,支持整数或整数型列表且支持XtoYbyN形式字符串
+>     node_id: 节点编号，支持整数、整数列表和XtoYbyN形式字符串；重复节点只处理一次
 >     boundary_info: 边界信息  [X,Y,Z,Rx,Ry,Rz]  True-固定 False-自由,也可传数值列表(0-自由 1-固定)
 >     group_name: 边界组名,默认为默认边界组
->     index: 对象编号，-1 表示自动分配
->     coordinate: 0整体坐标系、1节点坐标系；省略使用默认值
->     extra_enabled: 是否启用支座附加参数
->     extra_parameters: 静摩擦、动摩擦、Dx/Dy/Dz/Rx/Ry/Rz，共8项
+>     index: 对象编号，-1 表示覆盖时保留原编号、新增时自动分配
+>     coordinate: 0整体坐标系、1节点坐标系；覆盖时省略则保留原设置。
+>     extra_enabled: 是否启用支座附加参数；省略时，提供 extra_parameters 会自动启用，
+>         否则覆盖保留原设置；False 会清空附加参数。
+>     extra_parameters: 按静摩擦、动摩擦、Dx、Dy、Dz、Rx、Ry、Rz 排列的8个有限数值。
 
 #### 示例
 
@@ -841,22 +843,39 @@ mdb.add_general_support(node_id="1to100", boundary_info=[1,1,1,0,0,0])
 源码：`qtmodel/mdb/mdb_boundary.py` · `MdbBoundary.add_elastic_support`
 
 ```python
-mdb.add_elastic_support(node_id, support_type: int=1, boundary_info=None, group_name: str='默认边界组', index: int=-1, coordinate=None, extra_enabled=None, extra_parameters=None, axis_direction=None)
+mdb.add_elastic_support(node_id: Union[int, str, list[int]], support_type: int=1, boundary_info: Optional[list[float]]=None, group_name: str='默认边界组', index: int=-1, coordinate: Optional[int]=None, extra_enabled: Optional[bool]=None, extra_parameters: Optional[list[float]]=None, axis_direction: Optional[int]=None)
 ```
 
-添加弹性支承；相同组和节点由 API 覆盖，自动编号时保留已有编号。
+添加弹性支承；相同边界组和节点时覆盖已有支承。
+
+#### 参数
 
-线性刚度为6项；单向刚度为[方向(1/2/3),刚度]。
-省略坐标系和附加参数时，覆盖保留原值、新增使用默认值。
-axis_direction: 0/1=正/负X，2/3=正/负Y，4/5=正/负Z，仅用于单向支承。
+>     node_id: 节点编号，支持整数、整数列表和XtoYbyN形式字符串；重复节点只处理一次。
+>     support_type: 1线性支承、2只受拉、3只受压。
+>     boundary_info: 线性支承传[Kx,Ky,Kz,Krx,Kry,Krz]；单向支承传[轴向,刚度]，
+>         轴向为1=X、2=Y、3=Z，刚度须大于0。
+>     group_name: 边界组名，默认使用“默认边界组”。
+>     index: 起始对象编号；-1表示覆盖时保留原编号、新增时自动分配。
+>     coordinate: 0整体坐标系、1节点坐标系；覆盖时省略则保留原设置。
+>     extra_enabled: 是否启用支座附加参数；省略时，提供 extra_parameters 会自动启用，
+>         否则覆盖保留原设置；False 会清空附加参数。
+>     extra_parameters: 按静摩擦、动摩擦、Dx、Dy、Dz、Rx、Ry、Rz 排列的8个有限数值。
+>     axis_direction: 单向支承的正负方向，0/1=正/负X、2/3=正/负Y、4/5=正/负Z；
+>         须与 boundary_info 的轴向一致，线性支承不使用。
 
 #### 示例
 
 ```python
 from qtmodel import mdb
-result = mdb.add_elastic_support(node_id=...)
+mdb.add_elastic_support(node_id=1, support_type=1,
+                        boundary_info=[1e6,1e6,1e6,0,0,0],
+                        extra_parameters=[0.2,0.1,0,0,0,0,0,0])
 ```
 
+#### 返回
+
+> 服务端返回的执行结果。
+
 ### `mdb.add_elastic_link`
 
 源码：`qtmodel/mdb/mdb_boundary.py` · `MdbBoundary.add_elastic_link`
@@ -1045,7 +1064,7 @@ mdb.add_node_axis(input_type=3,node_id=1,coord_info=[[0,0,1],[0,1,0]])
 源码：`qtmodel/mdb/mdb_boundary.py` · `MdbBoundary.update_general_support`
 
 ```python
-mdb.update_general_support(index: int, node_id: int, boundary_info: list[bool], group_name: str='默认边界组', new_id: int=-1, new_group_name: str='', coordinate: int=None, extra_enabled: bool=None, extra_parameters: list[float]=None)
+mdb.update_general_support(index: int, node_id: int, boundary_info: list[bool], group_name: str='默认边界组', new_id: int=-1, new_group_name: str='', coordinate: Optional[int]=None, extra_enabled: Optional[bool]=None, extra_parameters: Optional[list[float]]=None)
 ```
 
 编辑一般支承；新组须已存在，省略坐标系和附加参数时保留原值。
@@ -1059,9 +1078,9 @@ mdb.update_general_support(index: int, node_id: int, boundary_info: list[bool],
 >     new_id: 修改后的编号，-1 表示保留原编号
 >     new_group_name: 修改后的边界组名称，空字符串表示保留原组
 >     coordinate: 0=整体坐标系，1=节点坐标系。
->     extra_enabled: 是否启用附加参数，None 保留原设置，False 清空附加参数
+>     extra_enabled: 是否启用附加参数；省略时，提供 extra_parameters 会自动启用，
+>         否则保留原设置；False 会清空附加参数。
 >     extra_parameters: 静摩擦、动摩擦、Dx、Dy、Dz、Rx、Ry、Rz，共8项。
->     extra_enabled=False 清空附加参数；new_id=-1 保留编号。
 
 #### 示例
 
@@ -1079,21 +1098,39 @@ mdb.update_general_support(index=1, node_id=1, boundary_info=[True] * 6)
 源码：`qtmodel/mdb/mdb_boundary.py` · `MdbBoundary.update_elastic_support`
 
 ```python
-mdb.update_elastic_support(index: int, node_id: int, support_type: int, boundary_info, group_name: str='默认边界组', new_id: int=-1, new_group_name: str='', coordinate=None, extra_enabled=None, extra_parameters=None, axis_direction=None)
+mdb.update_elastic_support(index: int, node_id: int, support_type: int, boundary_info: list[float], group_name: str='默认边界组', new_id: int=-1, new_group_name: str='', coordinate: Optional[int]=None, extra_enabled: Optional[bool]=None, extra_parameters: Optional[list[float]]=None, axis_direction: Optional[int]=None)
 ```
 
-编辑弹性支承并可迁移节点/分组；省略可选属性时保留原值。
+编辑弹性支承并可迁移节点或边界组。
 
-coordinate: 0整体/1节点；extra_parameters: 静摩擦、动摩擦、Dx/Dy/Dz/Rx/Ry/Rz。
-extra_enabled=False 清空附加参数；axis_direction为0至5的正负X/Y/Z方向。
+#### 参数
+
+>     index: 已有弹性支承编号。
+>     node_id: 修改后的节点编号。
+>     support_type: 1线性支承、2只受拉、3只受压。
+>     boundary_info: 线性支承传[Kx,Ky,Kz,Krx,Kry,Krz]；单向支承传[轴向,刚度]。
+>     group_name: 原边界组名。
+>     new_id: 修改后的编号，-1表示保留原编号。
+>     new_group_name: 新边界组名，空字符串表示保留原组。
+>     coordinate: 0整体坐标系、1节点坐标系；省略则保留原设置。
+>     extra_enabled: 是否启用附加参数；省略时，提供 extra_parameters 会自动启用，
+>         否则保留原设置；False 会清空附加参数。
+>     extra_parameters: 按静摩擦、动摩擦、Dx、Dy、Dz、Rx、Ry、Rz 排列的8个有限数值。
+>     axis_direction: 单向支承的正负方向，0/1=正/负X、2/3=正/负Y、4/5=正/负Z。
 
 #### 示例
 
 ```python
 from qtmodel import mdb
-result = mdb.update_elastic_support(index=..., node_id=..., support_type=..., boundary_info=...)
+mdb.update_elastic_support(index=7, node_id=8, support_type=1,
+                           boundary_info=[1e6,1e6,1e6,0,0,0],
+                           extra_parameters=[0.2,0.1,0,0,0,0,0,0])
 ```
 
+#### 返回
+
+> 服务端返回的执行结果。
+
 ### `mdb.update_elastic_link`
 
 源码：`qtmodel/mdb/mdb_boundary.py` · `MdbBoundary.update_elastic_link`
@@ -2964,6 +3001,514 @@ mdb.remove_spectrum_function(name="工况名")
 
 > 无
 
+## `mdb_effective_width`
+
+### `mdb.get_flange_width_lines`
+
+源码：`qtmodel/mdb/mdb_effective_width.py` · `MdbEffectiveWidth.get_flange_width_lines`
+
+```python
+mdb.get_flange_width_lines(section_id: int, position: int=0)
+```
+
+查询自定义翼缘定义使用的截面线段编号及几何数据，不修改模型。
+
+#### 参数
+
+>     section_id: 已存在的截面编号，支持自定义线圈、线宽及组合梁截面。
+>     position: 0 I端、1 J端；变截面分别查询两端，等截面两者相同。
+>         返回 line_id 与翼缘定义 UI 的线段编号一致，从 1 开始。
+
+#### 示例
+
+```python
+from qtmodel import mdb
+lines = mdb.get_flange_width_lines(section_id=10, position=0)
+```
+
+#### 返回
+
+>     list[dict]: 每行包含 line_id、start=[x,y]、end=[x,y]、thickness，尺寸单位 m。
+>         截面坐标为 UI 截面平面的 x、y 坐标，不是模型的全局节点坐标。
+
+### `mdb.set_flange_width`
+
+源码：`qtmodel/mdb/mdb_effective_width.py` · `MdbEffectiveWidth.set_flange_width`
+
+```python
+mdb.set_flange_width(section_id: int, top_line_ids: list[int], web_lines: list[dict], bottom_line_ids: Optional[list[int]]=None, top_ribs: Optional[list[dict]]=None, bottom_ribs: Optional[list[dict]]=None, b0: float=0.0, top_name: str='顶缘', bottom_name: str='底缘', end_j: Optional[dict]=None)
+```
+
+添加或覆盖自定义截面的翼缘宽度定义，默认覆盖同一截面的已有定义。
+
+#### 参数
+
+>     section_id: 自定义截面编号。参数化截面自动识别翼缘，不接受手工定义。
+>     top_line_ids: 顶缘线段编号，不能为空；用 get_flange_width_lines 查询编号。
+>     web_lines: 腹板定义列表，每项为字典：name 名称、direction 方向、
+>         left_ids 左侧线段编号、right_ids 右侧线段编号。
+>         direction 为 0 竖直、1 沿腹板斜率；默认 0。left_ids 必须非空，
+>         混凝土/组合梁还须提供非空 right_ids；钢梁省略 right_ids 时沿用 left_ids。
+>         同一列表中 name 不得重复，省略时自动生成名称。
+>     bottom_line_ids: 底缘线段编号，默认 None 表示没有底缘。
+>     top_ribs: 钢梁上翼缘加劲肋，字典格式与 web_lines 相同；默认 None 表示无。
+>         加劲肋必须指定 left_ids，省略 right_ids 时沿用 left_ids；混凝土/组合梁不接受此参数。
+>     bottom_ribs: 钢梁下翼缘加劲肋，格式同 top_ribs；默认 None 表示无。
+>     b0: 翼缘定义中的剪力连接件距离，单位 m，默认 0；非负有限数。
+>         钢梁固定为 0；有效宽度计算使用 calculate_effective_width 的 b0 参数。
+>     top_name: 顶缘线名称，默认 "顶缘"。
+>     bottom_name: 底缘线名称，默认 "底缘"。
+>     end_j: 变截面 J端定义，包含 top_line_ids、web_lines 及上述可选字段，
+>         尺寸单位 m；默认 None 在 J端采用 I端的线号和设置，并重新计算宽度。
+>         等截面禁止单独指定 end_j；两端线号均须在对应截面中存在。
+
+#### 示例
+
+```python
+from qtmodel import mdb
+mdb.set_flange_width(section_id=10, top_line_ids=[1], bottom_line_ids=[3],
+    web_lines=[{"name": "腹板1", "left_ids": [2], "right_ids": [4]}])
+mdb.update_model()
+```
+
+#### 返回
+
+>     dict: section_id 为完成设置的截面编号。定义无效时不覆盖原数据。
+
+### `mdb.get_flange_width`
+
+源码：`qtmodel/mdb/mdb_effective_width.py` · `MdbEffectiveWidth.get_flange_width`
+
+```python
+mdb.get_flange_width(section_ids: Optional[Union[int, str, list[int]]]=None)
+```
+
+查询已保存的自定义截面翼缘定义，不修改模型。
+
+#### 参数
+
+>     section_ids: 截面编号，支持单个编号、列表及 "1to10" 字符串。
+>         默认 None 返回全部定义，空列表返回空结果，未定义的截面不返回记录。
+
+#### 示例
+
+```python
+from qtmodel import mdb
+definitions = mdb.get_flange_width(section_ids=None)
+for definition in definitions:
+    mdb.set_flange_width(**definition)
+```
+
+#### 返回
+
+>     list[dict]: 每项与 set_flange_width 的参数对应，可直接回写；b0 单位 m。
+
+### `mdb.remove_flange_width`
+
+源码：`qtmodel/mdb/mdb_effective_width.py` · `MdbEffectiveWidth.remove_flange_width`
+
+```python
+mdb.remove_flange_width(section_ids: Union[int, str, list[int]])
+```
+
+删除指定截面的翼缘定义，保留截面和已计算的有效宽度系数。
+
+#### 参数
+
+>     section_ids: 明确指定的截面编号，支持单个编号、列表及 "1to10" 字符串。
+>         空列表不删除任何内容；不允许 None，未定义的截面会跳过。
+
+#### 示例
+
+```python
+from qtmodel import mdb
+mdb.remove_flange_width(section_ids=[10, 11])
+mdb.update_model()
+```
+
+#### 返回
+
+>     str: 服务端执行确认信息。
+
+### `mdb.get_effective_width_spans`
+
+源码：`qtmodel/mdb/mdb_effective_width.py` · `MdbEffectiveWidth.get_effective_width_spans`
+
+```python
+mdb.get_effective_width_spans()
+```
+
+查询有效宽度计算可选的已定义跨度信息。
+
+#### 参数
+
+>     无参数。
+
+#### 示例
+
+```python
+from qtmodel import mdb
+spans = mdb.get_effective_width_spans()
+```
+
+#### 返回
+
+>     list[dict]: 每项包含 span_id、name、element_ids、support_node_ids。
+>         span_id 用于 calculate_effective_width；未定义跨度时返回空列表。
+
+### `mdb.calculate_effective_width`
+
+源码：`qtmodel/mdb/mdb_effective_width.py` · `MdbEffectiveWidth.calculate_effective_width`
+
+```python
+mdb.calculate_effective_width(span_id: int, code: int=0, b0: float=0.0, rib_type: int=0, top_k: Optional[list[float]]=None, bottom_k: Optional[list[float]]=None, group_name: str='')
+```
+
+按已定义跨度计算有效宽度，并生成或覆盖边界组中的有效宽度系数。
+
+#### 参数
+
+>     span_id: get_effective_width_spans 返回的跨度编号，必须已存在。
+>         跨度须含连续杆系单元及支承节点，自定义截面须先设置翼缘定义。
+>     code: 0 公路混凝土(JTG 3362-2018)，1 铁路混凝土(TB 10092-2017)，
+>         2 公路钢混组合梁(JTG/T D64-01-2015)，3 铁路结合梁(TB 10024-2025)，
+>         4 公路钢梁(JTG D64-2015)。默认 0，调用与 UI 相同的计算器。
+>     b0: 仅 code=2、3 使用，单位 m；公路为剪力连接件距离，铁路为承托总宽度。
+>         默认 0，为非负有限数；其他 code 须为 0。
+>     rib_type: 仅 code=4 使用，0 刚性加劲肋、1 柔性加劲肋，默认 0。
+>     top_k: 钢梁顶缘各母板段的弹性屈曲系数，按 UI 从左到右顺序排列，
+>         各项须为正有限数，数量须与两端截面的顶缘分段数一致；code=4 必填。
+>     bottom_k: 钢梁底缘各母板段的弹性屈曲系数，要求同 top_k；code=4 必填，
+>         没有底缘时传 []；其他 code 的 top_k、bottom_k 必须为 None。
+>     group_name: 默认空字符串，混凝土/组合梁生成 "跨度名_EW边界组"；
+>         非空时直接用作边界组名。钢梁生成三组："前缀_EW上下局部稳定"、
+>         "前缀_EW剪力滞和上部局稳"、"前缀_EW剪力滞和下部局稳"，
+>         前缀为 group_name 或跨度名。同名组只覆盖有效宽度系数，保留其他边界。
+>         日志只输出本次计算语句；计算或写入失败时撤销本次新增命令。
+
+#### 示例
+
+```python
+from qtmodel import mdb
+result = mdb.calculate_effective_width(span_id=1, code=0)
+steel = mdb.calculate_effective_width(span_id=2, code=4, top_k=[4, 4], bottom_k=[4])
+mdb.update_model()
+```
+
+#### 返回
+
+>     dict: 包含 span_id、code、element_count、boundary_group_names、widths、factors。
+>         widths 每行含 element_id、position(0 I端/1 J端)、variant(0 混凝土/组合梁；
+>         1 上下局稳、2 剪力滞和上部局稳、3 剪力滞和下部局稳)，
+>         actual_widths、effective_widths、top_actual、bottom_actual、top_effective、
+>         bottom_effective，宽度单位 m。factors 每行含 group_name、element_id、
+>         factor_i/j(Y惯性矩)、factor_i_z/j_z(Z惯性矩)、factor_i_ax/j_ax(面积)比值，
+>         dz_i/j、dy_i/j 为形心偏移，单位 m。后续仍需 update_model 提交。
+
+## `mdb_element_factor`
+
+### `mdb.add_mass_factor`
+
+源码：`qtmodel/mdb/mdb_element_factor.py` · `MdbElementFactor.add_mass_factor`
+
+```python
+mdb.add_mass_factor(name: str, factor: float=1.0, element_ids: Optional[Union[int, str, list[int]]]=None, group_names: Optional[Union[str, list[str]]]=None, index: int=-1)
+```
+
+添加或覆盖单元质量系数，选择方式与 UI 的指定单元、指定结构组一致。
+
+#### 参数
+
+>     name: 定义名称，不能为空；质量系数定义内须唯一。
+>     factor: 无量纲质量缩放系数，默认 1 表示不调整；允许 0，必须为非负有限数。
+>     element_ids: 单元编号，支持单个编号、列表和 "1to10by2" 字符串，默认 None。
+>         必须引用已存在单元；与 group_names 二选一，至少一种非空。
+>     group_names: 结构组名称或名称列表，默认 None；必须引用已存在结构组。
+>         保留组引用，组内单元增删后自动改变生效范围；重复选择会去重。
+>     index: 默认 -1 按名称覆盖已有定义，或自动分配新编号；正整数按编号覆盖。
+>         按编号覆盖可改名；新名称被其他编号占用时抛出异常，不修改原数据。
+
+#### 示例
+
+```python
+from qtmodel import mdb
+mdb.add_mass_factor(name="主梁质量", factor=1.1, group_names=["主梁"])
+mdb.add_mass_factor(name="局部质量", factor=0.9, element_ids="1to10", index=2)
+mdb.update_model()
+```
+
+#### 返回
+
+>     dict: 包含 index、name、factor、selection_type(0 单元/1 结构组)、
+>         element_ids(显式选择)、group_names、effective_element_ids(当前实际单元编号)、
+>         element_count(去重后的实际单元数量)。不同质量定义覆盖同一单元时，编号最大者生效。
+
+### `mdb.update_mass_factor`
+
+源码：`qtmodel/mdb/mdb_element_factor.py` · `MdbElementFactor.update_mass_factor`
+
+```python
+mdb.update_mass_factor(index: int, name: Optional[str]=None, factor: Optional[float]=None, element_ids: Optional[Union[int, str, list[int]]]=None, group_names: Optional[Union[str, list[str]]]=None)
+```
+
+修改已存在的质量系数，保留未提供的名称、系数和选择范围。
+
+#### 参数
+
+>     index: 已存在的质量系数编号，必须为正整数；不存在时抛出异常。
+>     name: 新名称，默认 None 保留原名称；不能为空或与其他编号重名。
+>     factor: 新质量系数，默认 None 保留原值；必须为非负有限数，允许 0。
+>     element_ids: 新单元范围，默认 None。与 group_names 都为 None 时保留原范围。
+>         传值时整体替换范围，不追加；支持编号、列表、范围字符串。
+>     group_names: 新结构组范围，默认 None；支持名称或名称列表。
+>         指定任一范围时只使用本次提供的范围；两种非空范围不能同时指定，也不能都为空。
+
+#### 示例
+
+```python
+from qtmodel import mdb
+mdb.update_mass_factor(index=1, factor=1.2)
+mdb.update_mass_factor(index=1, group_names=["主梁", "横梁"])
+mdb.update_model()
+```
+
+#### 返回
+
+>     dict: 修改后的完整定义，字段与 add_mass_factor 返回值相同。
+
+### `mdb.get_mass_factor`
+
+源码：`qtmodel/mdb/mdb_element_factor.py` · `MdbElementFactor.get_mass_factor`
+
+```python
+mdb.get_mass_factor(indices: Optional[Union[int, str, list[int]]]=None)
+```
+
+查询质量系数定义及当前生效单元范围，不修改模型。
+
+#### 参数
+
+>     indices: 质量系数定义编号，支持单个编号、列表和范围字符串。
+>         默认 None 返回全部定义，[] 返回空列表；不存在的编号跳过。
+
+#### 示例
+
+```python
+from qtmodel import mdb
+rows = mdb.get_mass_factor(indices=None)
+```
+
+#### 返回
+
+>     list[dict]: 按编号排序，每行含 index、name、factor、selection_type、element_ids、
+>         group_names、effective_element_ids、element_count。系数无量纲，组引用会实时展开。
+
+### `mdb.remove_mass_factor`
+
+源码：`qtmodel/mdb/mdb_element_factor.py` · `MdbElementFactor.remove_mass_factor`
+
+```python
+mdb.remove_mass_factor(indices: Union[int, str, list[int]])
+```
+
+删除指定质量系数定义，不删除单元或结构组。
+
+#### 参数
+
+>     indices: 明确指定质量系数定义编号，支持单个编号、列表和范围字符串。
+>         [] 不执行删除，不允许 None；任一编号不存在时整次请求失败。
+
+#### 示例
+
+```python
+from qtmodel import mdb
+mdb.remove_mass_factor(indices=[1, 2])
+mdb.update_model()
+```
+
+#### 返回
+
+>     str: 服务端执行确认信息。
+
+### `mdb.add_stiffness_factor`
+
+源码：`qtmodel/mdb/mdb_element_factor.py` · `MdbElementFactor.add_stiffness_factor`
+
+```python
+mdb.add_stiffness_factor(name: str, factor: float=1.0, element_ids: Optional[Union[int, str, list[int]]]=None, group_names: Optional[Union[str, list[str]]]=None, index: int=-1)
+```
+
+添加或覆盖单元整体刚度系数，选择方式与 UI 一致。
+
+#### 参数
+
+>     name: 定义名称，不能为空；刚度系数定义内须唯一，可与质量系数同名。
+>     factor: 无量纲整体刚度缩放系数，默认 1；允许 0，必须为非负有限数。
+>         对应 UI 的单一刚度系数，不是分别设置各刚度分量的数组。
+>     element_ids: 单元编号，支持编号、列表和范围字符串，默认 None。
+>         与 group_names 二选一，至少一种非空；单元须已存在。
+>     group_names: 结构组名称或名称列表，默认 None；保留动态组引用，组须已存在。
+>     index: 默认 -1 按名称覆盖已有定义或自动编号；正整数按编号覆盖并可改名。
+>         新名称被其他编号占用时抛出异常，保持原数据。
+
+#### 示例
+
+```python
+from qtmodel import mdb
+mdb.add_stiffness_factor(name="主梁刚度", factor=0.8, group_names="主梁")
+mdb.update_model()
+```
+
+#### 返回
+
+>     dict: 包含 index、name、factor、selection_type(0 单元/1 结构组)、element_ids、
+>         group_names、effective_element_ids、element_count。重叠定义按最大编号生效。
+
+### `mdb.update_stiffness_factor`
+
+源码：`qtmodel/mdb/mdb_element_factor.py` · `MdbElementFactor.update_stiffness_factor`
+
+```python
+mdb.update_stiffness_factor(index: int, name: Optional[str]=None, factor: Optional[float]=None, element_ids: Optional[Union[int, str, list[int]]]=None, group_names: Optional[Union[str, list[str]]]=None)
+```
+
+修改已存在的刚度系数，保留未提供的字段。
+
+#### 参数
+
+>     index: 已存在的刚度系数编号，必须为正整数。
+>     name: 新名称，默认 None 保留原名称；不能为空或与其他编号重名。
+>     factor: 新整体刚度系数，默认 None 保留原值；非负有限数，允许 0。
+>     element_ids: 新单元范围，默认 None，支持编号、列表和范围字符串。
+>         与 group_names 都为 None 时保留原范围；传值时整体替换。
+>     group_names: 新结构组范围，默认 None，支持名称或名称列表。
+>         改变选择方式时只使用本次范围，不能同时提供两种非空范围或清空所有范围。
+
+#### 示例
+
+```python
+from qtmodel import mdb
+mdb.update_stiffness_factor(index=1, factor=0.7)
+mdb.update_model()
+```
+
+#### 返回
+
+>     dict: 修改后的完整定义，字段与 add_stiffness_factor 返回值相同。
+
+### `mdb.get_stiffness_factor`
+
+源码：`qtmodel/mdb/mdb_element_factor.py` · `MdbElementFactor.get_stiffness_factor`
+
+```python
+mdb.get_stiffness_factor(indices: Optional[Union[int, str, list[int]]]=None)
+```
+
+查询刚度系数定义及当前生效单元范围，不修改模型。
+
+#### 参数
+
+>     indices: 刚度系数定义编号，支持编号、列表和范围字符串。
+>         默认 None 返回全部定义，[] 返回空列表；不存在的编号跳过。
+
+#### 示例
+
+```python
+from qtmodel import mdb
+rows = mdb.get_stiffness_factor(indices=None)
+```
+
+#### 返回
+
+>     list[dict]: 按编号排序，每行含 index、name、factor、selection_type、element_ids、
+>         group_names、effective_element_ids、element_count；系数无量纲。
+
+### `mdb.remove_stiffness_factor`
+
+源码：`qtmodel/mdb/mdb_element_factor.py` · `MdbElementFactor.remove_stiffness_factor`
+
+```python
+mdb.remove_stiffness_factor(indices: Union[int, str, list[int]])
+```
+
+删除指定刚度系数定义，不删除单元或结构组。
+
+#### 参数
+
+>     indices: 明确指定刚度系数定义编号，支持编号、列表和范围字符串。
+>         [] 不执行删除，不允许 None；任一编号不存在时整次请求失败。
+
+#### 示例
+
+```python
+from qtmodel import mdb
+mdb.remove_stiffness_factor(indices=1)
+mdb.update_model()
+```
+
+#### 返回
+
+>     str: 服务端执行确认信息。
+
+### `mdb.set_element_factor`
+
+源码：`qtmodel/mdb/mdb_element_factor.py` · `MdbElementFactor.set_element_factor`
+
+```python
+mdb.set_element_factor(kind: str, index: int=-1, name: str='', factor: float=1.0, element_ids: Optional[Union[int, str, list[int]]]=None, group_names: Optional[Union[str, list[str]]]=None)
+```
+
+执行旧通用单元系数命令，兼容以前生成的 set_element_factor 日志。
+
+#### 参数
+
+>     kind: "mass" 质量系数或 "stiffness" 刚度系数。
+>     index: 默认 -1 按名称覆盖或自动编号，正整数按编号覆盖。
+>     name: 定义名称，默认空字符串但调用时必须提供非空名称。
+>     factor: 无量纲非负有限系数，默认 1，允许 0。
+>     element_ids: 指定单元编号、列表或范围字符串，默认 None。
+>     group_names: 指定结构组名称或名称列表，默认 None；与 element_ids 二选一且非空。
+
+#### 示例
+
+```python
+from qtmodel import mdb
+mdb.set_element_factor(kind="mass", index=1, name="质量", factor=1.1, element_ids=[1])
+mdb.update_model()
+```
+
+#### 返回
+
+>     str: 服务端确认信息；新脚本也可使用 add_mass_factor、add_stiffness_factor。
+
+### `mdb.remove_element_factor`
+
+源码：`qtmodel/mdb/mdb_element_factor.py` · `MdbElementFactor.remove_element_factor`
+
+```python
+mdb.remove_element_factor(kind: str, indices: Union[int, str, list[int]])
+```
+
+执行旧通用单元系数删除命令，兼容以前生成的日志。
+
+#### 参数
+
+>     kind: "mass" 质量系数或 "stiffness" 刚度系数。
+>     indices: 明确指定定义编号，支持编号、列表和范围字符串。
+>         [] 不删除，不允许 None；不存在的编号使整次请求失败。
+
+#### 示例
+
+```python
+from qtmodel import mdb
+mdb.remove_element_factor(kind="stiffness", indices=[1])
+mdb.update_model()
+```
+
+#### 返回
+
+>     str: 服务端执行确认信息。
+
 ## `mdb_international_live_load`
 
 ### `mdb.add_international_vehicle`
@@ -5090,6 +5635,38 @@ mdb.get_tendon_data()
 >         - ``track_group``：轨迹线定位所用结构组。
 >         - ``projection``：直线定位时是否投影到结构线上。
 
+### `mdb.get_load_statistics`
+
+源码：`qtmodel/mdb/mdb_model_load.py` · `MdbModelLoad.get_load_statistics`
+
+```python
+mdb.get_load_statistics(case_names: Optional[Union[str, List[str]]]=None)
+```
+
+获取查询栏中的荷载统计表数据，不打开表格窗口。
+
+#### 参数
+
+>     case_names: 荷载工况名称筛选条件，默认 ``None`` 查询全部荷载工况。
+>         支持单个名称或名称列表；空列表也表示全部，重复名称只统计一次。
+>         名称必须与模型完全一致，不能为空；不存在的工况由服务端报错。
+
+#### 示例
+
+```python
+from qtmodel import mdb
+mdb.get_load_statistics()
+mdb.get_load_statistics(case_names=["自重", "二期恒载"])
+```
+
+#### 返回
+
+> list[dict]: 按工况编号升序排列，每行包含 ``case_id`` 工况号、
+>     ``case_name`` 工况名及整体坐标系合力 ``fx``、``fy``、``fz``，固定单位为 ``N``。
+>     与查询栏口径一致，仅统计节点力、梁单元集中/分布荷载、板单元集中/面/线荷载；
+>     自重、预应力、温度、位移及力矩不纳入这三个力分量，只有这些荷载时合力为 ``0``。
+>     无荷载工况时返回空列表。换算为 ``kN`` 时将力分量除以 ``1000``。
+
 ### `mdb.get_load_case_names`
 
 源码：`qtmodel/mdb/mdb_model_load.py` · `MdbModelLoad.get_load_case_names`
@@ -5562,6 +6139,38 @@ mdb.get_deviation_load_data()
 
 ## `mdb_model_material`
 
+### `mdb.get_material_statistics`
+
+源码：`qtmodel/mdb/mdb_model_material.py` · `MdbModelMaterial.get_material_statistics`
+
+```python
+mdb.get_material_statistics()
+```
+
+获取查询栏中的材料重量统计表数据，不打开表格窗口。
+
+#### 参数
+
+>     无
+
+#### 示例
+
+```python
+from qtmodel import mdb
+mdb.get_material_statistics()
+```
+
+#### 返回
+
+> list[dict]: 全部已定义材料按材料号升序排列，每行包含：
+>     ``material_id`` 材料号；``material_type`` 材料类型中文名称；
+>     ``material_name`` 材料名称；``frame_weight`` 梁及桁架等线单元重量；
+>     ``plate_weight`` 板单元重量；``total_weight`` 两项重量之和。
+>     重量固定为 ``N``，包含材料构造系数，换算为 ``kN`` 时除以 ``1000``。
+>     变截面组采用对应单元平均面积，普通变截面采用两端计重面积平均值，
+>     组合截面采用计重面积，加劲板采用计重厚度；缺少计重属性的单元重量为 ``0``。
+>     未使用的材料也返回一行，重量为 ``0``；无材料时返回空列表。
+
 ### `mdb.get_material_data`
 
 源码：`qtmodel/mdb/mdb_model_material.py` · `MdbModelMaterial.get_material_data`
@@ -6902,26 +7511,67 @@ mdb.get_group_elements()
 源码：`qtmodel/mdb/mdb_model_structure.py` · `MdbModelStructure.get_element_weight`
 
 ```python
-mdb.get_element_weight(ids=None)
+mdb.get_element_weight(ids: Optional[Union[int, str, List[Union[int, str]]]]=None)
 ```
 
 获取指定或全部单元的自重。
 
 #### 参数
 
->     ids: 单元号；``None`` 或空列表表示全部。
+>     ids: 单元号筛选条件，默认 ``None`` 查询全部单元。
+>         支持单个整数、编号列表以及 ``"1to10by2"`` 编号字符串；空列表也表示全部。
+>         重复编号只返回一次，不存在的编号跳过。
 
 #### 示例
 
 ```python
 from qtmodel import mdb
 mdb.get_element_weight()
+mdb.get_element_weight(ids=[1, 2])
 ```
 
 #### 返回
 
-> dict[int, float]: ``{单元号: 重量}``。JSON 对象键经解析后可能表现为
->     字符串，使用前可按需要转换为 ``int``；重量采用当前力单位。
+> dict[str, float]: ``{"单元号": 重量}``，HTTP JSON 对象的键为字符串。
+>     重量固定为 ``N``，包含材料构造系数，不随界面显示单位改变。
+>     使用 ``weights["1"]`` 读取 1 号单元；换算为 ``kN`` 时除以 ``1000``。
+
+### `mdb.get_element_weight_table`
+
+源码：`qtmodel/mdb/mdb_model_structure.py` · `MdbModelStructure.get_element_weight_table`
+
+```python
+mdb.get_element_weight_table(ids: Optional[Union[int, str, List[Union[int, str]]]]=None)
+```
+
+获取查询栏中的单元重量表数据，不打开表格窗口。
+
+#### 参数
+
+>     ids: 单元号筛选条件，默认 ``None`` 查询全部单元。
+>         支持单个整数、编号列表以及 ``"1to10by2"`` 编号字符串；空列表也表示全部。
+>         重复编号只返回一次，不存在的编号跳过。
+
+#### 示例
+
+```python
+from qtmodel import mdb
+mdb.get_element_weight_table()
+mdb.get_element_weight_table(ids="1to10by2")
+```
+
+#### 返回
+
+> list[dict]: 按单元号升序排列，每行包含：
+>     ``element_id`` 单元号；``material_id`` 材料号；``material_name`` 材料名称；
+>     ``geometry_type`` 几何属性类型（``section`` 截面、``thickness`` 板厚）；
+>     ``geometry_id`` 截面号或板厚号；``geometry_name`` 截面或板厚名称；
+>     ``geometry_size`` 特征尺寸（线单元长度或板单元面积）；
+>     ``geometry_size_unit`` 特征尺寸单位（``m`` 或 ``m^2``）；
+>     ``element_weight`` 单元重量，固定为 ``N``，包含材料构造系数。
+>     缺少材料或截面/板厚时重量为 ``0``；不支持重量计算的单元类型也返回 ``0``。
+>     无单元时返回空列表，不附加混合类型的“合计”行；
+>     总重量可用 ``sum(row["element_weight"] for row in rows)`` 计算。
 
 ### `mdb.get_span_data`
 
@@ -10429,6 +11079,33 @@ mdb.merge_nodes()
 
 > 无
 
+### `mdb.merge_node_groups`
+
+源码：`qtmodel/mdb/mdb_structure.py` · `MdbStructure.merge_node_groups`
+
+```python
+mdb.merge_node_groups(node_groups: list[list[int]])
+```
+
+按指定分组合并节点，与 UI 分组合并使用同一复合操作。
+
+#### 参数
+
+>     node_groups: 节点编号分组，每组至少两个正整数，各组不能重叠或重复。
+>         保留节点由模型端依据板单元及连接关系选取；不可合并的分组会跳过。
+>         日志只记录本次合并语句，不展开内部节点、单元、边界等联动命令。
+
+#### 示例
+
+```python
+from qtmodel import mdb
+mdb.merge_node_groups(node_groups=[[1, 2], [3, 4]])
+```
+
+#### 返回
+
+>     dict[str, int]: merged_count 为实际删除的节点数，0 表示没有节点被合并。
+
 ### `mdb.move_nodes`
 
 源码：`qtmodel/mdb/mdb_structure.py` · `MdbStructure.move_nodes`
@@ -10457,6 +11134,35 @@ mdb.move_nodes(ids=1,offset_x=1.5,offset_y=1.5,offset_z=1.5)
 
 > 无
 
+### `mdb.move_nodes_by_offsets`
+
+源码：`qtmodel/mdb/mdb_structure.py` · `MdbStructure.move_nodes_by_offsets`
+
+```python
+mdb.move_nodes_by_offsets(node_ids: Union[int, str, list[Union[int, str]]], offsets: list[list[float]], intersected: bool=False)
+```
+
+按一一对应的偏移量批量移动节点，日志只记录本次复合操作。
+
+#### 参数
+
+>     node_ids: 明确指定的节点编号，支持列表及 "1to10" 字符串；不能为空或重复。
+>     offsets: 与节点顺序对应的 [dx, dy, dz] 列表，采用全局坐标及模型输入单位，
+>         每项必须包含三个有限数值。模型端统一校验移动后的单元几何形状。
+>     intersected: 是否用移动后的节点分割关联杆系单元，默认 False。
+>         日志重放保留此选项；省略时仅移动节点，不自动改变单元拓扑。
+
+#### 示例
+
+```python
+from qtmodel import mdb
+mdb.move_nodes_by_offsets(node_ids=[1, 2], offsets=[[1, 0, 0], [1, 0, 0]])
+```
+
+#### 返回
+
+>     str: 服务端执行确认信息。
+
 ### `mdb.translate_nodes`
 
 源码：`qtmodel/mdb/mdb_structure.py` · `MdbStructure.translate_nodes`
@@ -10913,6 +11619,67 @@ mdb.update_element_node(2,[1,2,3,4])
 
 > 无
 
+### `mdb.merge_frame_elements`
+
+源码：`qtmodel/mdb/mdb_structure.py` · `MdbStructure.merge_frame_elements`
+
+```python
+mdb.merge_frame_elements(ids: Optional[Union[int, str, list[Union[int, str]]]]=None, delete_free_nodes: bool=True, accept_warnings: bool=False)
+```
+
+合并共线且首尾相连的杆系单元，并等效转移原单元及中间节点上的荷载。
+
+#### 参数
+
+>     ids: 梁、杆或索单元编号，支持单个编号、列表及 "1to10" 字符串。
+>         默认 None 或空列表时选择全部杆系单元；互不相连的单元分组处理。
+>         同组类型、材料、截面、β角及相关属性必须满足 UI 的合并条件。
+>     delete_free_nodes: 是否删除合并后不再关联结构的自由节点，默认 True。
+>     accept_warnings: 是否接受全量索力张拉、制造偏差等特殊荷载的合并提示，
+>         默认 False；需要确认的操作会报错，API 不弹窗。设为 True 表示接受。
+>         操作成功后日志只输出本合并语句，保留最小单元号。
+
+#### 示例
+
+```python
+from qtmodel import mdb
+mdb.merge_frame_elements(ids=[1, 2, 3], delete_free_nodes=True)
+for element_ids in ([1, 2], [5, 6]):
+    mdb.merge_frame_elements(ids=element_ids)
+mdb.update_model()
+```
+
+#### 返回
+
+>     dict[str, int]: merged_count 为实际删除的单元数，0 表示没有可合并的分组。
+
+### `mdb.merge_plate_elements`
+
+源码：`qtmodel/mdb/mdb_structure.py` · `MdbStructure.merge_plate_elements`
+
+```python
+mdb.merge_plate_elements(ids: Union[int, str, list[Union[int, str]]])
+```
+
+合并选中的共面板单元，与 UI 合并板单元使用同一复合操作。
+
+#### 参数
+
+>     ids: 至少两个不同的板单元编号，支持列表及 "1to10" 字符串。
+>         材料、板厚必须一致；保留最小单元号，删除其他板单元及其关联荷载。
+>         不删除自由节点，不适用于任意非矩形区域。日志只输出本合并语句。
+
+#### 示例
+
+```python
+from qtmodel import mdb
+mdb.merge_plate_elements(ids=[1, 2])
+```
+
+#### 返回
+
+>     dict[str, int]: merged_count 为实际删除的板单元数。
+
 ### `mdb.remove_elements`
 
 源码：`qtmodel/mdb/mdb_structure.py` · `MdbStructure.remove_elements`
@@ -12125,18 +12892,19 @@ mdb.remove_tendon_property()
 mdb.remove_pre_stress(tendon_name: str='')
 ```
 
-删除预应力
+按钢束名称删除预应力荷载，保留钢束及钢束组定义。
 
 #### 参数
 
->     tendon_name: 钢束组,默认则删除所有预应力荷载
+>     tendon_name: 钢束名称，对应钢束定义的 name，例如 "钢束1"。
+>         默认空字符串 "" 表示删除所有预应力荷载；省略参数时同样删除全部。
 
 #### 示例
 
 ```python
 from qtmodel import mdb
 mdb.remove_pre_stress(tendon_name="钢束1")
-mdb.remove_pre_stress()
+mdb.remove_pre_stress()  # 删除所有预应力荷载
 ```
 
 #### 返回
@@ -13085,478 +13853,511 @@ odb.get_tendon_length_result()
 源码：`qtmodel/odb/odb_result_plot.py` · `OdbResultPlot.plot_reaction_result`
 
 ```python
-odb.plot_reaction_result(file_path: str='', stage_id: int=1, case_name: str='', show_increment: bool=False, envelop_type: int=1, component: int=1, show_number: bool=True, text_rotation=0, max_min_kind: int=-1, show_legend: bool=True, digital_count=3, text_exponential: bool=True, arrow_scale: float=1, is_time_history: bool=False, time_kind: int=1, time_tick: float=1.0)
+odb.plot_reaction_result(file_path: Optional[str]='', stage_id: int=1, case_name: str='', show_increment: bool=False, envelop_type: int=1, component: int=1, show_number: bool=True, text_rotation: float=0, max_min_kind: int=-1, show_legend: bool=True, digital_count: int=3, text_exponential: bool=True, arrow_scale: float=1, is_time_history: bool=False, time_kind: int=1, time_tick: float=1.0)
 ```
 
-保存结果图片到指定文件甲
+绘制结果图并返回 PNG Base64，可选保存到被控端文件
 
 #### 参数
 
->     file_path: 保存路径名
->     stage_id: 0-施工阶段包络 n-施工阶段号 -1-运营阶段(负数均代表运营阶段)
->     case_name: 详细荷载工况名,参考桥通结果输出,例如： CQ:成桥(合计)
->     show_increment: 是否显示增量结果
->     envelop_type: 施工阶段包络类型 1-最大 2-最小
->     component: 分量编号 1-Fx 2-Fy 3-Fz 4-Fxyz 5-Mx 6-My 7-Mz 8-Mxyz
->     show_number: 数值选项卡开启
->     show_legend: 图例选项卡开启
->     text_rotation: 数值选项卡内文字旋转角度
->     max_min_kind: 数值选项卡内最大最小值显示 0-不显示最大最小值  1-显示最大值和最小值  2-最大绝对值 3-最大值 4-最小值
->     digital_count: 小数点位数
->     text_exponential: 指数显示开启
->     arrow_scale:箭头大小
->     is_time_history:是否为时程分析结果
->     time_kind:时程分析类型 1-时刻 2-最大 3-最小
->     time_tick:时程分析时刻
+>     file_path (Optional[str]): 可选的被控端 PNG 完整保存路径，默认空字符串。
+>         省略、传 ``""`` 或 ``None`` 时不写文件，直接返回 PNG Base64；
+>         非空路径时同时在被控端保存文件，父目录须存在。
+>     stage_id (int): 0-施工阶段包络 n-施工阶段号 -1-运营阶段(负数均代表运营阶段)
+>     case_name (str): 详细荷载工况名,参考桥通结果输出,例如： CQ:成桥(合计)
+>     show_increment (bool): 是否显示增量结果
+>     envelop_type (int): 施工阶段包络类型 1-最大 2-最小
+>     component (int): 分量编号 1-Fx 2-Fy 3-Fz 4-Fxyz 5-Mx 6-My 7-Mz 8-Mxyz
+>     show_number (bool): 数值选项卡开启
+>     show_legend (bool): 图例选项卡开启
+>     text_rotation (float): 数值选项卡内文字旋转角度
+>     max_min_kind (int): 数值选项卡内最大最小值显示 0-不显示最大最小值  1-显示最大值和最小值  2-最大绝对值 3-最大值 4-最小值
+>     digital_count (int): 小数点位数
+>     text_exponential (bool): 指数显示开启
+>     arrow_scale (float): 箭头大小
+>     is_time_history (bool): 是否为时程分析结果
+>     time_kind (int): 时程分析类型 1-时刻 2-最大 3-最小
+>     time_tick (float): 时程分析时刻
 
 #### 示例
 
 ```python
 from qtmodel import odb
-odb.plot_reaction_result(file_path=r"D:\图片\反力图.png",component=1,case_name="CQ:成桥(合计)",stage_id=-1)
+image_base64 = odb.plot_reaction_result(component=1,case_name="CQ:成桥(合计)",stage_id=-1)
 ```
 
 #### 返回
 
-> Base64字符串
+>     str: PNG 二进制内容的纯 Base64 字符串，不含 data URI 前缀；
+>         可在控制端通过 base64.b64decode 解码显示或保存。
 
 ### `odb.plot_displacement_result`
 
 源码：`qtmodel/odb/odb_result_plot.py` · `OdbResultPlot.plot_displacement_result`
 
 ```python
-odb.plot_displacement_result(file_path: str='', stage_id: int=1, case_name: str='', show_increment: bool=False, envelop_type: int=1, component: int=1, show_deformed: bool=True, deformed_scale: float=1.0, deformed_actual: bool=False, show_number: bool=True, text_rotation=0, max_min_kind: int=1, show_legend: bool=True, digital_count=3, text_exponential: bool=True, show_undeformed: bool=True, is_time_history: bool=False, deform_kind: int=1, time_kind: int=1, time_tick: float=1.0)
+odb.plot_displacement_result(file_path: Optional[str]='', stage_id: int=1, case_name: str='', show_increment: bool=False, envelop_type: int=1, component: int=1, show_deformed: bool=True, deformed_scale: float=1.0, deformed_actual: bool=False, show_number: bool=True, text_rotation: float=0, max_min_kind: int=1, show_legend: bool=True, digital_count: int=3, text_exponential: bool=True, show_undeformed: bool=True, is_time_history: bool=False, deform_kind: int=1, time_kind: int=1, time_tick: float=1.0)
 ```
 
-保存结果图片到指定文件甲
+绘制结果图并返回 PNG Base64，可选保存到被控端文件
 
 #### 参数
 
->     file_path: 保存路径名
->     stage_id: 0-施工阶段包络 n-施工阶段号 -1-运营阶段(负数均代表运营阶段)
->     case_name: 详细荷载工况名,参考桥通结果输出,例如： CQ:成桥(合计)
->     show_increment: 是否显示增量结果
->     envelop_type: 施工阶段包络类型 1-最大 2-最小
->     component: 位移分量编号 1-Dx 2-Dy 3-Dz 4-Rx 5-Ry 6-Rz
+>     file_path (Optional[str]): 可选的被控端 PNG 完整保存路径，默认空字符串。
+>         省略、传 ``""`` 或 ``None`` 时不写文件，直接返回 PNG Base64；
+>         非空路径时同时在被控端保存文件，父目录须存在。
+>     stage_id (int): 0-施工阶段包络 n-施工阶段号 -1-运营阶段(负数均代表运营阶段)
+>     case_name (str): 详细荷载工况名,参考桥通结果输出,例如： CQ:成桥(合计)
+>     show_increment (bool): 是否显示增量结果
+>     envelop_type (int): 施工阶段包络类型 1-最大 2-最小
+>     component (int): 位移分量编号 1-Dx 2-Dy 3-Dz 4-Rx 5-Ry 6-Rz
 >         7-Dxy 8-Dyz 9-Dxz 10-Dxyz
->     show_deformed: 变形选项卡开启
->     deformed_scale:变形比例
->     deformed_actual:是否显示实际变形
->     show_number: 数值选项卡开启
->     text_rotation: 数值选项卡内文字旋转角度
->     max_min_kind: 数值选项卡内最大最小值显示 0-不显示最大最小值  1-显示最大值和最小值  2-最大绝对值 3-最大值 4-最小值
->     show_legend: 图例选项卡开启
->     digital_count: 小数点位数
->     text_exponential: 指数显示开启
->     show_undeformed: 显示变形前
->     is_time_history:是否为时程分析结果
->     time_kind:时程分析类型 1-时刻 2-最大 3-最小
->     deform_kind:时程分析变形类型 1-位移 2-速度 3-加速度
->     time_tick:时程分析时刻
+>     show_deformed (bool): 变形选项卡开启
+>     deformed_scale (float): 变形比例
+>     deformed_actual (bool): 是否显示实际变形
+>     show_number (bool): 数值选项卡开启
+>     text_rotation (float): 数值选项卡内文字旋转角度
+>     max_min_kind (int): 数值选项卡内最大最小值显示 0-不显示最大最小值  1-显示最大值和最小值  2-最大绝对值 3-最大值 4-最小值
+>     show_legend (bool): 图例选项卡开启
+>     digital_count (int): 小数点位数
+>     text_exponential (bool): 指数显示开启
+>     show_undeformed (bool): 显示变形前
+>     is_time_history (bool): 是否为时程分析结果
+>     time_kind (int): 时程分析类型 1-时刻 2-最大 3-最小
+>     deform_kind (int): 时程分析变形类型 1-位移 2-速度 3-加速度
+>     time_tick (float): 时程分析时刻
 
 #### 示例
 
 ```python
 from qtmodel import odb
-odb.plot_displacement_result(file_path=r"D:\图片\变形图.png",component=1,case_name="CQ:成桥(合计)",stage_id=-1)
+image_base64 = odb.plot_displacement_result(component=1,case_name="CQ:成桥(合计)",stage_id=-1)
 ```
 
 #### 返回
 
-> Base64字符串
+>     str: PNG 二进制内容的纯 Base64 字符串，不含 data URI 前缀；
+>         可在控制端通过 base64.b64decode 解码显示或保存。
 
 ### `odb.plot_beam_element_force`
 
 源码：`qtmodel/odb/odb_result_plot.py` · `OdbResultPlot.plot_beam_element_force`
 
 ```python
-odb.plot_beam_element_force(file_path: str='', stage_id: int=1, case_name: str='合计', show_increment: bool=False, envelop_type: int=1, component: int=1, show_line_chart: bool=True, line_scale: float=1.0, flip_plot: bool=True, show_deformed: bool=True, deformed_actual: bool=False, deformed_scale: float=1.0, show_number: bool=False, text_rotation: int=0, max_min_kind: int=1, show_legend: bool=True, digital_count: int=3, text_exponential: bool=True, show_undeformed: bool=False, position: int=1, is_time_history: bool=False, time_kind: int=1, time_tick: float=1.0)
+odb.plot_beam_element_force(file_path: Optional[str]='', stage_id: int=1, case_name: str='合计', show_increment: bool=False, envelop_type: int=1, component: int=1, show_line_chart: bool=True, line_scale: float=1.0, flip_plot: bool=True, show_deformed: bool=True, deformed_actual: bool=False, deformed_scale: float=1.0, show_number: bool=False, text_rotation: int=0, max_min_kind: int=1, show_legend: bool=True, digital_count: int=3, text_exponential: bool=True, show_undeformed: bool=False, position: int=1, is_time_history: bool=False, time_kind: int=1, time_tick: float=1.0)
 ```
 
-绘制梁单元结果图并保存到指定文件
+绘制梁单元内力图并返回 PNG Base64
 
 #### 参数
 
->     file_path: 保存路径名
->     stage_id: 0-施工阶段包络 n-施工阶段号 -1-运营阶段(负数均代表运营阶段)
->     case_name: 详细荷载工况名,参考桥通结果输出,例如： CQ:成桥(合计)
->     show_increment: 是否显示增量结果
->     envelop_type: 施工阶段包络类型 1-最大 2-最小
->     component: 梁内力分量，仅支持 1-Fx 2-Fy 3-Fz 4-Mx 5-My 6-Mz；
+>     file_path (Optional[str]): 可选的被控端 PNG 完整保存路径，默认空字符串。
+>         省略、传 ``""`` 或 ``None`` 时不写文件，直接返回 PNG Base64；
+>         非空路径时同时在被控端保存文件，父目录须存在。
+>     stage_id (int): 0-施工阶段包络 n-施工阶段号 -1-运营阶段(负数均代表运营阶段)
+>     case_name (str): 详细荷载工况名,参考桥通结果输出,例如： CQ:成桥(合计)
+>     show_increment (bool): 是否显示增量结果
+>     envelop_type (int): 施工阶段包络类型 1-最大 2-最小
+>     component (int): 梁内力分量，仅支持 1-Fx 2-Fy 3-Fz 4-Mx 5-My 6-Mz；
 >         旧文档中的 Dx/Dy 等位移分量不适用于本方法
->     show_line_chart: 折线图选项卡开启
->     line_scale:折线图比例
->     flip_plot:反向绘制
->     show_deformed: 变形选项卡开启
->     deformed_scale:变形比例
->     deformed_actual:是否显示实际变形
->     show_number: 数值选项卡开启
->     text_rotation: 数值选项卡内文字旋转角度
->     digital_count: 小数点位数
->     text_exponential: 指数显示开启
->     max_min_kind: 数值选项卡内最大最小值显示 0-不显示最大最小值  1-显示最大值和最小值  2-最大绝对值 3-最大值 4-最小值
->     show_legend: 图例选项卡开启
->     show_undeformed: 显示变形前
->     position: 位置编号 1-始端 2-末端 3-绝对最大 4-全部
->     is_time_history:是否为时程分析结果
->     time_kind:时程分析类型 1-时刻 2-最大 3-最小
->     time_tick:时程分析时刻
+>     show_line_chart (bool): 折线图选项卡开启
+>     line_scale (float): 折线图比例
+>     flip_plot (bool): 反向绘制
+>     show_deformed (bool): 变形选项卡开启
+>     deformed_scale (float): 变形比例
+>     deformed_actual (bool): 是否显示实际变形
+>     show_number (bool): 数值选项卡开启
+>     text_rotation (int): 数值选项卡内文字旋转角度
+>     digital_count (int): 小数点位数
+>     text_exponential (bool): 指数显示开启
+>     max_min_kind (int): 数值选项卡内最大最小值显示 0-不显示最大最小值  1-显示最大值和最小值  2-最大绝对值 3-最大值 4-最小值
+>     show_legend (bool): 图例选项卡开启
+>     show_undeformed (bool): 显示变形前
+>     position (int): 位置编号 1-始端 2-末端 3-绝对最大 4-全部
+>     is_time_history (bool): 是否为时程分析结果
+>     time_kind (int): 时程分析类型 1-时刻 2-最大 3-最小
+>     time_tick (float): 时程分析时刻
 
 #### 示例
 
 ```python
 from qtmodel import odb
-odb.plot_beam_element_force(file_path=r"D:\图片\梁内力.png",component=1,case_name="CQ:成桥(合计)",stage_id=-1)
+image_base64 = odb.plot_beam_element_force(component=1,case_name="CQ:成桥(合计)",stage_id=-1)
 ```
 
 #### 返回
 
-> Base64字符串
+>     str: PNG 二进制内容的纯 Base64 字符串，不含 data URI 前缀；
+>         可在控制端通过 base64.b64decode 解码显示或保存。
 
 ### `odb.plot_truss_element_force`
 
 源码：`qtmodel/odb/odb_result_plot.py` · `OdbResultPlot.plot_truss_element_force`
 
 ```python
-odb.plot_truss_element_force(file_path: str='', stage_id: int=1, case_name: str='合计', show_increment: bool=False, envelop_type: int=1, component: int=1, show_line_chart: bool=True, line_scale: float=1.0, flip_plot: bool=True, show_deformed: bool=True, deformed_actual: bool=False, deformed_scale: float=1.0, show_number: bool=False, text_rotation: int=0, max_min_kind: int=1, show_legend: bool=True, digital_count: int=3, text_exponential: bool=True, show_undeformed: bool=False, position: int=1, is_time_history: bool=False, time_kind: int=1, time_tick: float=1.0)
+odb.plot_truss_element_force(file_path: Optional[str]='', stage_id: int=1, case_name: str='合计', show_increment: bool=False, envelop_type: int=1, component: int=1, show_line_chart: bool=True, line_scale: float=1.0, flip_plot: bool=True, show_deformed: bool=True, deformed_actual: bool=False, deformed_scale: float=1.0, show_number: bool=False, text_rotation: int=0, max_min_kind: int=1, show_legend: bool=True, digital_count: int=3, text_exponential: bool=True, show_undeformed: bool=False, position: int=1, is_time_history: bool=False, time_kind: int=1, time_tick: float=1.0)
 ```
 
-绘制杆单元结果图并保存到指定文件
+绘制杆单元结果图并返回 PNG Base64
 
 #### 参数
 
->     file_path: 保存路径名
->     stage_id: 0-施工阶段包络 n-施工阶段号 -1-运营阶段(负数均代表运营阶段)
->     case_name: 详细荷载工况名,参考桥通结果输出,例如： CQ:成桥(合计)
->     show_increment: 是否显示增量结果
->     envelop_type: 施工阶段包络类型 1-最大 2-最小
->     component: 分量编号 0-N 1-Fx 2-Fy 3-Fz
->     show_line_chart: 折线图选项卡开启
->     line_scale:折线图比例
->     flip_plot:反向绘制
->     show_deformed: 变形选项卡开启
->     deformed_scale:变形比例
->     deformed_actual:是否显示实际变形
->     show_number: 数值选项卡开启
->     text_rotation: 数值选项卡内文字旋转角度
->     digital_count: 小数点位数
->     text_exponential: 指数显示开启
->     max_min_kind: 数值选项卡内最大最小值显示 0-不显示最大最小值  1-显示最大值和最小值  2-最大绝对值 3-最大值 4-最小值
->     show_legend: 图例选项卡开启
->     show_undeformed: 显示变形前
->     position: 位置编号 1-始端 2-末端 3-绝对最大 4-全部
->     is_time_history:是否为时程分析结果
->     time_kind:时程分析类型 1-时刻 2-最大 3-最小
->     time_tick:时程分析时刻
+>     file_path (Optional[str]): 可选的被控端 PNG 完整保存路径，默认空字符串。
+>         省略、传 ``""`` 或 ``None`` 时不写文件，直接返回 PNG Base64；
+>         非空路径时同时在被控端保存文件，父目录须存在。
+>     stage_id (int): 0-施工阶段包络 n-施工阶段号 -1-运营阶段(负数均代表运营阶段)
+>     case_name (str): 详细荷载工况名,参考桥通结果输出,例如： CQ:成桥(合计)
+>     show_increment (bool): 是否显示增量结果
+>     envelop_type (int): 施工阶段包络类型 1-最大 2-最小
+>     component (int): 分量编号 0-N 1-Fx 2-Fy 3-Fz
+>     show_line_chart (bool): 折线图选项卡开启
+>     line_scale (float): 折线图比例
+>     flip_plot (bool): 反向绘制
+>     show_deformed (bool): 变形选项卡开启
+>     deformed_scale (float): 变形比例
+>     deformed_actual (bool): 是否显示实际变形
+>     show_number (bool): 数值选项卡开启
+>     text_rotation (int): 数值选项卡内文字旋转角度
+>     digital_count (int): 小数点位数
+>     text_exponential (bool): 指数显示开启
+>     max_min_kind (int): 数值选项卡内最大最小值显示 0-不显示最大最小值  1-显示最大值和最小值  2-最大绝对值 3-最大值 4-最小值
+>     show_legend (bool): 图例选项卡开启
+>     show_undeformed (bool): 显示变形前
+>     position (int): 位置编号 1-始端 2-末端 3-绝对最大 4-全部
+>     is_time_history (bool): 是否为时程分析结果
+>     time_kind (int): 时程分析类型 1-时刻 2-最大 3-最小
+>     time_tick (float): 时程分析时刻
 
 #### 示例
 
 ```python
 from qtmodel import odb
-odb.plot_truss_element_force(file_path=r"D:\图片\杆内力.png",case_name="CQ:成桥(合计)",stage_id=-1)
+image_base64 = odb.plot_truss_element_force(case_name="CQ:成桥(合计)",stage_id=-1)
 ```
 
 #### 返回
 
-> Base64字符串
+>     str: PNG 二进制内容的纯 Base64 字符串，不含 data URI 前缀；
+>         可在控制端通过 base64.b64decode 解码显示或保存。
 
 ### `odb.plot_plate_element_force`
 
 源码：`qtmodel/odb/odb_result_plot.py` · `OdbResultPlot.plot_plate_element_force`
 
 ```python
-odb.plot_plate_element_force(file_path: str='', stage_id: int=1, case_name: str='合计', show_increment: bool=False, envelop_type: int=1, force_kind: int=1, component: int=1, show_number: bool=False, text_rotate: int=0, max_min_kind: int=1, show_deformed: bool=True, deformed_scale: float=1.0, deformed_actual: bool=False, show_legend: bool=True, digital_count: int=3, text_exponential: bool=True, show_undeformed: bool=False, is_time_history: bool=False, time_kind: int=1, time_tick: float=1.0)
+odb.plot_plate_element_force(file_path: Optional[str]='', stage_id: int=1, case_name: str='合计', show_increment: bool=False, envelop_type: int=1, force_kind: int=1, component: int=1, show_number: bool=False, text_rotate: int=0, max_min_kind: int=1, show_deformed: bool=True, deformed_scale: float=1.0, deformed_actual: bool=False, show_legend: bool=True, digital_count: int=3, text_exponential: bool=True, show_undeformed: bool=False, is_time_history: bool=False, time_kind: int=1, time_tick: float=1.0)
 ```
 
-绘制板单元结果图并保存到指定文件
+绘制板单元结果图并返回 PNG Base64
 
 #### 参数
 
->     file_path: 保存路径名
->     component: 分量编号 1-Fxx 2-Fyy 3-Fxy 4-Mxx 5-Myy 6-Mxy
->     force_kind: 内力选项 1-单元 2-节点平均
->     case_name: 详细荷载工况名
->     stage_id: 阶段编号
->     envelop_type: 包络类型
->     show_number: 是否显示数值
->     show_deformed: 是否显示变形形状
->     show_undeformed: 是否显示未变形形状
->     deformed_actual: 是否显示实际变形
->     deformed_scale: 变形比例
->     show_legend: 是否显示图例
->     text_rotate: 数值选项卡内文字旋转角度
->     digital_count: 小数点位数
->     text_exponential: 是否以指数形式显示
->     max_min_kind: 最大最小值显示类型
->     show_increment: 是否显示增量结果
->     is_time_history:是否为时程分析结果
->     time_kind:时程分析类型 1-时刻 2-最大 3-最小
->     time_tick:时程分析时刻
+>     file_path (Optional[str]): 可选的被控端 PNG 完整保存路径，默认空字符串。
+>         省略、传 ``""`` 或 ``None`` 时不写文件，直接返回 PNG Base64；
+>         非空路径时同时在被控端保存文件，父目录须存在。
+>     component (int): 分量编号 1-Fxx 2-Fyy 3-Fxy 4-Mxx 5-Myy 6-Mxy
+>     force_kind (int): 内力选项 1-单元 2-节点平均
+>     case_name (str): 详细荷载工况名
+>     stage_id (int): 阶段编号
+>     envelop_type (int): 包络类型
+>     show_number (bool): 是否显示数值
+>     show_deformed (bool): 是否显示变形形状
+>     show_undeformed (bool): 是否显示未变形形状
+>     deformed_actual (bool): 是否显示实际变形
+>     deformed_scale (float): 变形比例
+>     show_legend (bool): 是否显示图例
+>     text_rotate (float): 数值选项卡内文字旋转角度
+>     digital_count (int): 小数点位数
+>     text_exponential (bool): 是否以指数形式显示
+>     max_min_kind (int): 最大最小值显示类型
+>     show_increment (bool): 是否显示增量结果
+>     is_time_history (bool): 是否为时程分析结果
+>     time_kind (int): 时程分析类型 1-时刻 2-最大 3-最小
+>     time_tick (float): 时程分析时刻
 
 #### 示例
 
 ```python
 from qtmodel import odb
-odb.plot_plate_element_force(file_path=r"D:\图片\板内力.png",component=1,case_name="CQ:成桥(合计)",stage_id=-1)
+image_base64 = odb.plot_plate_element_force(component=1,case_name="CQ:成桥(合计)",stage_id=-1)
 ```
 
 #### 返回
 
-> Base64字符串
+>     str: PNG 二进制内容的纯 Base64 字符串，不含 data URI 前缀；
+>         可在控制端通过 base64.b64decode 解码显示或保存。
 
 ### `odb.plot_composite_beam_force`
 
 源码：`qtmodel/odb/odb_result_plot.py` · `OdbResultPlot.plot_composite_beam_force`
 
 ```python
-odb.plot_composite_beam_force(file_path: str='', stage_id: int=1, case_name: str='合计', show_increment: bool=False, envelop_type: int=1, mat_type: int=1, component: int=1, show_line_chart: bool=True, line_scale: float=1.0, flip_plot: bool=True, show_deformed: bool=True, deformed_actual: bool=False, deformed_scale: float=1.0, show_number: bool=False, text_rotation: int=0, max_min_kind: int=1, show_legend: bool=True, digital_count: int=3, text_exponential: bool=True, show_undeformed: bool=False, position: int=1)
+odb.plot_composite_beam_force(file_path: Optional[str]='', stage_id: int=1, case_name: str='合计', show_increment: bool=False, envelop_type: int=1, mat_type: int=1, component: int=1, show_line_chart: bool=True, line_scale: float=1.0, flip_plot: bool=True, show_deformed: bool=True, deformed_actual: bool=False, deformed_scale: float=1.0, show_number: bool=False, text_rotation: int=0, max_min_kind: int=1, show_legend: bool=True, digital_count: int=3, text_exponential: bool=True, show_undeformed: bool=False, position: int=1)
 ```
 
-绘制组合梁单元结果图并保存到指定文件
+绘制组合梁单元结果图并返回 PNG Base64
 
 #### 参数
 
->     file_path: 保存路径名
->     stage_id: 0-施工阶段包络 n-施工阶段号 -1-运营阶段(负数均代表运营阶段)
->     case_name: 详细荷载工况名,参考桥通结果输出,例如： CQ:成桥(合计)
->     show_increment: 是否显示增量结果
->     envelop_type: 施工阶段包络类型 1-最大 2-最小
->     mat_type: 材料类型 1-主材 2-辅材 3-主材+辅材
->     component: 分量编号 1-Fx 2-Fy 3-Fz 4-Mx 5-My 6-Mz
->     show_line_chart: 折线图选项卡开启
->     line_scale:折线图比例
->     flip_plot:反向绘制
->     show_deformed: 变形选项卡开启
->     deformed_scale:变形比例
->     deformed_actual:是否显示实际变形
->     show_number: 数值选项卡开启
->     text_rotation: 数值选项卡内文字旋转角度
->     digital_count: 小数点位数
->     text_exponential: 指数显示开启
->     max_min_kind: 数值选项卡内最大最小值显示 0-不显示最大最小值  1-显示最大值和最小值  2-最大绝对值 3-最大值 4-最小值
->     show_legend: 图例选项卡开启
->     show_undeformed: 显示变形前
->     position: 位置编号 1-始端 2-末端 3-绝对最大 4-全部
+>     file_path (Optional[str]): 可选的被控端 PNG 完整保存路径，默认空字符串。
+>         省略、传 ``""`` 或 ``None`` 时不写文件，直接返回 PNG Base64；
+>         非空路径时同时在被控端保存文件，父目录须存在。
+>     stage_id (int): 0-施工阶段包络 n-施工阶段号 -1-运营阶段(负数均代表运营阶段)
+>     case_name (str): 详细荷载工况名,参考桥通结果输出,例如： CQ:成桥(合计)
+>     show_increment (bool): 是否显示增量结果
+>     envelop_type (int): 施工阶段包络类型 1-最大 2-最小
+>     mat_type (int): 材料类型 1-主材 2-辅材 3-主材+辅材
+>     component (int): 分量编号 1-Fx 2-Fy 3-Fz 4-Mx 5-My 6-Mz
+>     show_line_chart (bool): 折线图选项卡开启
+>     line_scale (float): 折线图比例
+>     flip_plot (bool): 反向绘制
+>     show_deformed (bool): 变形选项卡开启
+>     deformed_scale (float): 变形比例
+>     deformed_actual (bool): 是否显示实际变形
+>     show_number (bool): 数值选项卡开启
+>     text_rotation (int): 数值选项卡内文字旋转角度
+>     digital_count (int): 小数点位数
+>     text_exponential (bool): 指数显示开启
+>     max_min_kind (int): 数值选项卡内最大最小值显示 0-不显示最大最小值  1-显示最大值和最小值  2-最大绝对值 3-最大值 4-最小值
+>     show_legend (bool): 图例选项卡开启
+>     show_undeformed (bool): 显示变形前
+>     position (int): 位置编号 1-始端 2-末端 3-绝对最大 4-全部
 
 #### 示例
 
 ```python
 from qtmodel import odb
-odb.plot_composite_beam_force(file_path=r"D:\图片\组合梁内力.png",mat_type=0,component=1,case_name="CQ:成桥(合计)",stage_id=-1)
+image_base64 = odb.plot_composite_beam_force(mat_type=0,component=1,case_name="CQ:成桥(合计)",stage_id=-1)
 ```
 
 #### 返回
 
-> Base64字符串
+>     str: PNG 二进制内容的纯 Base64 字符串，不含 data URI 前缀；
+>         可在控制端通过 base64.b64decode 解码显示或保存。
 
 ### `odb.plot_beam_element_stress`
 
 源码：`qtmodel/odb/odb_result_plot.py` · `OdbResultPlot.plot_beam_element_stress`
 
 ```python
-odb.plot_beam_element_stress(file_path: str='', stage_id: int=1, case_name: str='合计', show_increment: bool=False, envelop_type: int=1, component: int=1, show_line_chart: bool=True, line_scale: float=1.0, flip_plot: bool=True, show_deformed: bool=True, deformed_actual: bool=False, deformed_scale: float=1.0, show_number: bool=False, text_rotation: int=0, max_min_kind: int=1, show_legend: bool=True, digital_count: int=3, text_exponential: bool=True, show_undeformed: bool=False, position: int=1)
+odb.plot_beam_element_stress(file_path: Optional[str]='', stage_id: int=1, case_name: str='合计', show_increment: bool=False, envelop_type: int=1, component: int=1, show_line_chart: bool=True, line_scale: float=1.0, flip_plot: bool=True, show_deformed: bool=True, deformed_actual: bool=False, deformed_scale: float=1.0, show_number: bool=False, text_rotation: int=0, max_min_kind: int=1, show_legend: bool=True, digital_count: int=3, text_exponential: bool=True, show_undeformed: bool=False, position: int=1)
 ```
 
-绘制梁单元应力结果图并保存到指定文件
+绘制梁单元应力结果图并返回 PNG Base64
 
 #### 参数
 
->     file_path: 保存路径名
->     stage_id: 0-施工阶段包络 n-施工阶段号 -1-运营阶段(负数均代表运营阶段)
->     case_name: 详细荷载工况名,参考桥通结果输出,例如： CQ:成桥(合计)
->     show_increment: 是否显示增量结果
->     envelop_type: 施工阶段包络类型 1-最大 2-最小
->     component: 分量编号 1-轴力 2-Mzx 3-My 4-组合包络 5-左上 6-右上 7-右下 8-左下
->     show_line_chart: 折线图选项卡开启
->     line_scale:折线图比例
->     flip_plot:反向绘制
->     show_deformed: 变形选项卡开启
->     deformed_scale:变形比例
->     deformed_actual:是否显示实际变形
->     show_number: 数值选项卡开启
->     text_rotation: 数值选项卡内文字旋转角度
->     digital_count: 小数点位数
->     text_exponential: 指数显示开启
->     max_min_kind: 数值选项卡内最大最小值显示 0-不显示最大最小值  1-显示最大值和最小值  2-最大绝对值 3-最大值 4-最小值
->     show_legend: 图例选项卡开启
->     show_undeformed: 显示变形前
->     position: 位置编号 1-始端 2-末端 3-绝对最大 4-全部
+>     file_path (Optional[str]): 可选的被控端 PNG 完整保存路径，默认空字符串。
+>         省略、传 ``""`` 或 ``None`` 时不写文件，直接返回 PNG Base64；
+>         非空路径时同时在被控端保存文件，父目录须存在。
+>     stage_id (int): 0-施工阶段包络 n-施工阶段号 -1-运营阶段(负数均代表运营阶段)
+>     case_name (str): 详细荷载工况名,参考桥通结果输出,例如： CQ:成桥(合计)
+>     show_increment (bool): 是否显示增量结果
+>     envelop_type (int): 施工阶段包络类型 1-最大 2-最小
+>     component (int): 分量编号 1-轴力 2-Mzx 3-My 4-组合包络 5-左上 6-右上 7-右下 8-左下
+>     show_line_chart (bool): 折线图选项卡开启
+>     line_scale (float): 折线图比例
+>     flip_plot (bool): 反向绘制
+>     show_deformed (bool): 变形选项卡开启
+>     deformed_scale (float): 变形比例
+>     deformed_actual (bool): 是否显示实际变形
+>     show_number (bool): 数值选项卡开启
+>     text_rotation (int): 数值选项卡内文字旋转角度
+>     digital_count (int): 小数点位数
+>     text_exponential (bool): 指数显示开启
+>     max_min_kind (int): 数值选项卡内最大最小值显示 0-不显示最大最小值  1-显示最大值和最小值  2-最大绝对值 3-最大值 4-最小值
+>     show_legend (bool): 图例选项卡开启
+>     show_undeformed (bool): 显示变形前
+>     position (int): 位置编号 1-始端 2-末端 3-绝对最大 4-全部
 
 #### 示例
 
 ```python
 from qtmodel import odb
-odb.plot_beam_element_stress(file_path=r"D:\图片\梁应力.png",show_line_chart=False,component=1,case_name="CQ:成桥(合计)",stage_id=-1)
+image_base64 = odb.plot_beam_element_stress(show_line_chart=False,component=1,case_name="CQ:成桥(合计)",stage_id=-1)
 ```
 
 #### 返回
 
-> Base64字符串
+>     str: PNG 二进制内容的纯 Base64 字符串，不含 data URI 前缀；
+>         可在控制端通过 base64.b64decode 解码显示或保存。
 
 ### `odb.plot_truss_element_stress`
 
 源码：`qtmodel/odb/odb_result_plot.py` · `OdbResultPlot.plot_truss_element_stress`
 
 ```python
-odb.plot_truss_element_stress(file_path: str='', stage_id: int=1, case_name: str='合计', show_increment: bool=False, envelop_type: int=1, show_line_chart: bool=True, line_scale: float=1.0, flip_plot: bool=True, show_deformed: bool=True, deformed_actual: bool=False, deformed_scale: float=1.0, show_number: bool=False, text_rotation: int=0, max_min_kind: int=1, show_legend: bool=True, digital_count: int=3, text_exponential: bool=True, show_undeformed: bool=False, position: int=1)
+odb.plot_truss_element_stress(file_path: Optional[str]='', stage_id: int=1, case_name: str='合计', show_increment: bool=False, envelop_type: int=1, show_line_chart: bool=True, line_scale: float=1.0, flip_plot: bool=True, show_deformed: bool=True, deformed_actual: bool=False, deformed_scale: float=1.0, show_number: bool=False, text_rotation: int=0, max_min_kind: int=1, show_legend: bool=True, digital_count: int=3, text_exponential: bool=True, show_undeformed: bool=False, position: int=1)
 ```
 
-绘制杆单元结果图并保存到指定文件
+绘制杆单元结果图并返回 PNG Base64
 
 #### 参数
 
->     file_path: 保存路径名
->     stage_id: 0-施工阶段包络 n-施工阶段号 -1-运营阶段(负数均代表运营阶段)
->     case_name: 详细荷载工况名,参考桥通结果输出,例如： CQ:成桥(合计)
->     show_increment: 是否显示增量结果
->     envelop_type: 施工阶段包络类型 1-最大  2-最小
->     show_line_chart: 折线图选项卡开启
->     line_scale:折线图比例
->     flip_plot:反向绘制
->     show_deformed: 变形选项卡开启
->     deformed_scale:变形比例
->     deformed_actual:是否显示实际变形
->     show_number: 数值选项卡开启
->     text_rotation: 数值选项卡内文字旋转角度
->     digital_count: 小数点位数
->     text_exponential: 指数显示开启
->     max_min_kind: 数值选项卡内最大最小值显示 0-不显示最大最小值  1-显示最大值和最小值  2-最大绝对值 3-最大值 4-最小值
->     show_legend: 图例选项卡开启
->     show_undeformed: 显示变形前
->     position: 位置编号 1-始端 2-末端 3-绝对最大 4-全部
+>     file_path (Optional[str]): 可选的被控端 PNG 完整保存路径，默认空字符串。
+>         省略、传 ``""`` 或 ``None`` 时不写文件，直接返回 PNG Base64；
+>         非空路径时同时在被控端保存文件，父目录须存在。
+>     stage_id (int): 0-施工阶段包络 n-施工阶段号 -1-运营阶段(负数均代表运营阶段)
+>     case_name (str): 详细荷载工况名,参考桥通结果输出,例如： CQ:成桥(合计)
+>     show_increment (bool): 是否显示增量结果
+>     envelop_type (int): 施工阶段包络类型 1-最大  2-最小
+>     show_line_chart (bool): 折线图选项卡开启
+>     line_scale (float): 折线图比例
+>     flip_plot (bool): 反向绘制
+>     show_deformed (bool): 变形选项卡开启
+>     deformed_scale (float): 变形比例
+>     deformed_actual (bool): 是否显示实际变形
+>     show_number (bool): 数值选项卡开启
+>     text_rotation (int): 数值选项卡内文字旋转角度
+>     digital_count (int): 小数点位数
+>     text_exponential (bool): 指数显示开启
+>     max_min_kind (int): 数值选项卡内最大最小值显示 0-不显示最大最小值  1-显示最大值和最小值  2-最大绝对值 3-最大值 4-最小值
+>     show_legend (bool): 图例选项卡开启
+>     show_undeformed (bool): 显示变形前
+>     position (int): 位置编号 1-始端 2-末端 3-绝对最大 4-全部
 
 #### 示例
 
 ```python
 from qtmodel import odb
-odb.plot_truss_element_stress(file_path=r"D:\图片\杆应力.png",case_name="CQ:成桥(合计)",stage_id=-1)
+image_base64 = odb.plot_truss_element_stress(case_name="CQ:成桥(合计)",stage_id=-1)
 ```
 
 #### 返回
 
-> Base64字符串
+>     str: PNG 二进制内容的纯 Base64 字符串，不含 data URI 前缀；
+>         可在控制端通过 base64.b64decode 解码显示或保存。
 
 ### `odb.plot_composite_beam_stress`
 
 源码：`qtmodel/odb/odb_result_plot.py` · `OdbResultPlot.plot_composite_beam_stress`
 
 ```python
-odb.plot_composite_beam_stress(file_path: str='', stage_id: int=1, case_name: str='合计', show_increment: bool=False, envelop_type: int=1, mat_type: int=0, component: int=1, show_line_chart: bool=True, line_scale: float=1.0, flip_plot: bool=True, show_deformed: bool=True, deformed_actual: bool=False, deformed_scale: float=1.0, show_number: bool=False, text_rotation: int=0, max_min_kind: int=1, show_legend: bool=True, digital_count: int=3, text_exponential: bool=True, show_undeformed: bool=False, position: int=1)
+odb.plot_composite_beam_stress(file_path: Optional[str]='', stage_id: int=1, case_name: str='合计', show_increment: bool=False, envelop_type: int=1, mat_type: int=0, component: int=1, show_line_chart: bool=True, line_scale: float=1.0, flip_plot: bool=True, show_deformed: bool=True, deformed_actual: bool=False, deformed_scale: float=1.0, show_number: bool=False, text_rotation: int=0, max_min_kind: int=1, show_legend: bool=True, digital_count: int=3, text_exponential: bool=True, show_undeformed: bool=False, position: int=1)
 ```
 
-绘制组合梁单元结果图并保存到指定文件
+绘制组合梁单元结果图并返回 PNG Base64
 
 #### 参数
 
->     file_path: 保存路径名
->     stage_id: 0-施工阶段包络 n-施工阶段号 -1-运营阶段(负数均代表运营阶段)
->     case_name: 详细荷载工况名,参考桥通结果输出,例如： CQ:成桥(合计)
->     show_increment: 是否显示增量结果
->     envelop_type: 施工阶段包络类型 1-最大 2-最小
->     mat_type: 材料类型 1-主材 2-辅材
->     component: 分量编号 1-轴力分量 2-Mz分量 3-My分量 4-包络 5-左上 6-右上 7-左下 8-右下
->     show_line_chart: 折线图选项卡开启
->     line_scale:折线图比例
->     flip_plot:反向绘制
->     show_deformed: 变形选项卡开启
->     deformed_scale:变形比例
->     deformed_actual:是否显示实际变形
->     show_number: 数值选项卡开启
->     text_rotation: 数值选项卡内文字旋转角度
->     digital_count: 小数点位数
->     text_exponential: 指数显示开启
->     max_min_kind: 数值选项卡内最大最小值显示 0-不显示最大最小值  1-显示最大值和最小值  2-最大绝对值 3-最大值 4-最小值
->     show_legend: 图例选项卡开启
->     show_undeformed: 显示变形前
->     position: 位置编号 1-始端 2-末端 3-绝对最大 4-全部
+>     file_path (Optional[str]): 可选的被控端 PNG 完整保存路径，默认空字符串。
+>         省略、传 ``""`` 或 ``None`` 时不写文件，直接返回 PNG Base64；
+>         非空路径时同时在被控端保存文件，父目录须存在。
+>     stage_id (int): 0-施工阶段包络 n-施工阶段号 -1-运营阶段(负数均代表运营阶段)
+>     case_name (str): 详细荷载工况名,参考桥通结果输出,例如： CQ:成桥(合计)
+>     show_increment (bool): 是否显示增量结果
+>     envelop_type (int): 施工阶段包络类型 1-最大 2-最小
+>     mat_type (int): 材料类型 1-主材 2-辅材
+>     component (int): 分量编号 1-轴力分量 2-Mz分量 3-My分量 4-包络 5-左上 6-右上 7-左下 8-右下
+>     show_line_chart (bool): 折线图选项卡开启
+>     line_scale (float): 折线图比例
+>     flip_plot (bool): 反向绘制
+>     show_deformed (bool): 变形选项卡开启
+>     deformed_scale (float): 变形比例
+>     deformed_actual (bool): 是否显示实际变形
+>     show_number (bool): 数值选项卡开启
+>     text_rotation (int): 数值选项卡内文字旋转角度
+>     digital_count (int): 小数点位数
+>     text_exponential (bool): 指数显示开启
+>     max_min_kind (int): 数值选项卡内最大最小值显示 0-不显示最大最小值  1-显示最大值和最小值  2-最大绝对值 3-最大值 4-最小值
+>     show_legend (bool): 图例选项卡开启
+>     show_undeformed (bool): 显示变形前
+>     position (int): 位置编号 1-始端 2-末端 3-绝对最大 4-全部
 
 #### 示例
 
 ```python
 from qtmodel import odb
-odb.plot_composite_beam_stress(file_path=r"D:\图片\组合梁应力.png",component=1,case_name="CQ:成桥(合计)",stage_id=-1)
+image_base64 = odb.plot_composite_beam_stress(component=1,case_name="CQ:成桥(合计)",stage_id=-1)
 ```
 
 #### 返回
 
-> Base64字符串
+>     str: PNG 二进制内容的纯 Base64 字符串，不含 data URI 前缀；
+>         可在控制端通过 base64.b64decode 解码显示或保存。
 
 ### `odb.plot_plate_element_stress`
 
 源码：`qtmodel/odb/odb_result_plot.py` · `OdbResultPlot.plot_plate_element_stress`
 
 ```python
-odb.plot_plate_element_stress(file_path: str='', stage_id: int=1, case_name: str='合计', show_increment: bool=False, envelop_type: int=1, stress_kind: int=0, component: int=1, show_number: bool=False, text_rotate: int=0, max_min_kind: int=1, show_deformed: bool=True, deformed_scale: float=1.0, deformed_actual: bool=False, show_legend: bool=True, digital_count: int=3, text_exponential: bool=True, show_undeformed: bool=False, position: int=1)
+odb.plot_plate_element_stress(file_path: Optional[str]='', stage_id: int=1, case_name: str='合计', show_increment: bool=False, envelop_type: int=1, stress_kind: int=0, component: int=1, show_number: bool=False, text_rotate: int=0, max_min_kind: int=1, show_deformed: bool=True, deformed_scale: float=1.0, deformed_actual: bool=False, show_legend: bool=True, digital_count: int=3, text_exponential: bool=True, show_undeformed: bool=False, position: int=1)
 ```
 
-绘制板单元结果图并保存到指定文件
+绘制板单元结果图并返回 PNG Base64
 
 #### 参数
 
->     file_path: 保存路径名
->     component: 分量编号 1-Fxx 2-Fyy 3-Fxy 4-Mxx 5-Myy 6-Mxy
->     stress_kind: 力类型 1-单元 2-节点平均
->     case_name: 详细荷载工况名
->     stage_id: 阶段编号
->     envelop_type: 包络类型
->     show_number: 是否显示数值
->     show_deformed: 是否显示变形形状
->     show_undeformed: 是否显示未变形形状
->     deformed_actual: 是否显示实际变形
->     deformed_scale: 变形比例
->     show_legend: 是否显示图例
->     text_rotate: 数值选项卡内文字旋转角度
->     digital_count: 小数点位数
->     text_exponential: 是否以指数形式显示
->     max_min_kind: 最大最小值显示类型
->     show_increment: 是否显示增量结果
->     position: 位置 1-板顶 2-板底 3-绝对值最大
+>     file_path (Optional[str]): 可选的被控端 PNG 完整保存路径，默认空字符串。
+>         省略、传 ``""`` 或 ``None`` 时不写文件，直接返回 PNG Base64；
+>         非空路径时同时在被控端保存文件，父目录须存在。
+>     component (int): 分量编号 1-Fxx 2-Fyy 3-Fxy 4-Mxx 5-Myy 6-Mxy
+>     stress_kind (int): 力类型 1-单元 2-节点平均
+>     case_name (str): 详细荷载工况名
+>     stage_id (int): 阶段编号
+>     envelop_type (int): 包络类型
+>     show_number (bool): 是否显示数值
+>     show_deformed (bool): 是否显示变形形状
+>     show_undeformed (bool): 是否显示未变形形状
+>     deformed_actual (bool): 是否显示实际变形
+>     deformed_scale (float): 变形比例
+>     show_legend (bool): 是否显示图例
+>     text_rotate (float): 数值选项卡内文字旋转角度
+>     digital_count (int): 小数点位数
+>     text_exponential (bool): 是否以指数形式显示
+>     max_min_kind (int): 最大最小值显示类型
+>     show_increment (bool): 是否显示增量结果
+>     position (int): 位置 1-板顶 2-板底 3-绝对值最大
 
 #### 示例
 
 ```python
 from qtmodel import odb
-odb.plot_plate_element_stress(file_path=r"D:\图片\板应力.png",component=1,case_name="CQ:成桥(合计)",stage_id=-1)
+image_base64 = odb.plot_plate_element_stress(component=1,case_name="CQ:成桥(合计)",stage_id=-1)
 ```
 
 #### 返回
 
-> Base64字符串
+>     str: PNG 二进制内容的纯 Base64 字符串，不含 data URI 前缀；
+>         可在控制端通过 base64.b64decode 解码显示或保存。
 
 ### `odb.plot_modal_result`
 
 源码：`qtmodel/odb/odb_result_plot.py` · `OdbResultPlot.plot_modal_result`
 
 ```python
-odb.plot_modal_result(file_path: str='', mode: int=1, mode_kind: int=1, show_number: bool=True, text_rotate: float=0, max_min_kind: int=1, show_legend: bool=True, digital_count: int=3, text_exponential: bool=True, show_undeformed: bool=False)
+odb.plot_modal_result(file_path: Optional[str]='', mode: int=1, mode_kind: int=1, show_number: bool=True, text_rotate: float=0, max_min_kind: int=1, show_legend: bool=True, digital_count: int=3, text_exponential: bool=True, show_undeformed: bool=False)
 ```
 
-绘制模态结果，可选择自振模态和屈曲模态结果
+绘制自振或屈曲模态图并返回 PNG Base64
 
 #### 参数
 
->    file_path: 保存路径名
->    mode: 模态号
->    mode_kind: 1-自振模态 2-屈曲模态
->    show_number: 是否显示数值
->    show_undeformed: 是否显示未变形形状
->    show_legend: 是否显示图例
->    text_rotate: 数值选项卡内文字旋转角度
->    digital_count: 小数点位数
->    text_exponential: 是否以指数形式显示
->    max_min_kind: 最大最小值显示类型
+>     file_path (Optional[str]): 可选的被控端 PNG 完整保存路径，默认空字符串。
+>         省略、传 ``""`` 或 ``None`` 时不写文件，直接返回 PNG Base64；
+>         非空路径时同时在被控端保存文件，父目录须存在。
+>     mode (int): 模态号
+>     mode_kind (int): 1-自振模态 2-屈曲模态
+>     show_number (bool): 是否显示数值
+>     show_undeformed (bool): 是否显示未变形形状
+>     show_legend (bool): 是否显示图例
+>     text_rotate (float): 数值选项卡内文字旋转角度
+>     digital_count (int): 小数点位数
+>     text_exponential (bool): 是否以指数形式显示
+>     max_min_kind (int): 最大最小值显示类型
 
 #### 示例
 
 ```python
 from qtmodel import odb
-odb.plot_modal_result(file_path=r"D:\图片\自振模态.png",mode=1)
-odb.plot_modal_result(file_path=r"D:\图片\屈曲模态.png",mode=1,mode_kind=2)
+image_base64 = odb.plot_modal_result(mode=1)
+image_base64 = odb.plot_modal_result(mode=1,mode_kind=2)
 ```
 
 #### 返回
 
-> Base64字符串
+>     str: PNG 二进制内容的纯 Base64 字符串，不含 data URI 前缀；
+>         可在控制端通过 base64.b64decode 解码显示或保存。
 
 ## `odb_view`
 
@@ -13756,26 +14557,29 @@ odb.reset_display()
 源码：`qtmodel/odb/odb_view.py` · `OdbView.save_png`
 
 ```python
-odb.save_png(file_path: str)
+odb.save_png(file_path: Optional[str]='')
 ```
 
-将当前模型窗口保存为 PNG；路径为空时直接返回图像 Base64。
+获取当前窗口 PNG 的 Base64，可选地在被控端保存文件。
 
 #### 参数
 
->     file_path (str): PNG 完整路径；父目录应已存在。传 ``""`` 时不写盘，
->         返回当前窗口 PNG 的 Base64 字符串。
+>     file_path (Optional[str]): 被控端的 PNG 完整保存路径，父目录应已存在。
+>         默认 ``""``；省略、传 ``""`` 或 ``None`` 时不写文件，直接返回
+>         PNG Base64，适用于控制端与桥通不在同一台电脑的情况。
 
 #### 示例
 
 ```python
 from qtmodel import odb
+image_base64 = odb.save_png()
 odb.save_png(file_path="D:\QT\aa.png")
 ```
 
 #### 返回
 
->     str: 非空路径时为服务端保存确认信息；空路径时为 PNG Base64 字符串。
+>     str: 空路径时为 PNG 二进制内容的纯 Base64 字符串，不含
+>         ``data:image/png;base64,`` 前缀；非空路径时保留原有保存确认信息。
 
 ### `odb.set_render`
 
@@ -13863,7 +14667,7 @@ odb.change_construct_stage(stage=1)
 odb.get_current_png()
 ```
 
-获取当前窗口 PNG 图像的 Base64 编码。
+获取当前模型或结果窗口的 PNG Base64，无需指定保存路径。
 
 #### 参数
 
@@ -13873,12 +14677,16 @@ odb.get_current_png()
 
 ```python
 from qtmodel import odb
-odb.get_current_png()
+import base64
+from pathlib import Path
+image_base64 = odb.get_current_png()
+Path("模型.png").write_bytes(base64.b64decode(image_base64, validate=True))
 ```
 
 #### 返回
 
->     str: PNG 二进制内容的 Base64 字符串，通常不含文件路径。
+>     str: PNG 二进制内容的纯 Base64 字符串，不含
+>         ``data:image/png;base64,`` 前缀；可在控制端解码显示或保存。
 
 # CDB：结构检算
 
@@ -14100,51 +14908,39 @@ cdb.import_concrete_check_case(case_name="混凝土检算")
 源码：`qtmodel/cdb/cdb_concrete_check.py` · `CdbConcreteCheck.solve_concrete_check`
 
 ```python
-cdb.solve_concrete_check(show_view: bool=False, modal: bool=True, auto_close: bool=True, read_timeout: int=600, wait: bool=False, poll_interval: float=2.0, max_wait: Optional[float]=None, status_read_timeout: int=30, sync: bool=False)
+cdb.solve_concrete_check(read_timeout: int=600, wait: bool=False, poll_interval: float=2.0, max_wait: Optional[float]=None, status_read_timeout: int=30)
 ```
 
-执行混凝土检算分析。
+启动后台混凝土检算，默认显示非模态进度窗口。
+用户可点击“终止分析”停止计算并关闭窗口；计算完成、失败或准备失败时窗口自动关闭。
 
 #### 参数
 
->     show_view: 是否显示混凝土检算分析进度窗口。
->         True  - 显示分析进度窗口，并通过窗口执行/展示检算过程。
->         False - 不显示分析进度窗口，直接执行混凝土检算分析。
->
->     modal: 是否以模态窗口方式显示，仅当 show_view=True 时有效。
->         True  - 使用 ShowDialog 显示窗口，窗口关闭后才返回。
->         False - 使用 Show 显示窗口，窗口显示后立即返回。
->     auto_close: 计算完成后是否自动关闭分析窗口，仅当 show_view=True 时有效（默认自动关闭，手动关闭不及时可能影响程序运行）
 >     read_timeout: 等待 Qt 后端响应的超时时间，单位为秒。
 >     wait: 是否在 Python 侧轮询等待后台检算完成。False 时只启动任务并立即返回启动状态。
 >     poll_interval: wait=True 时的轮询间隔，单位为秒。
 >     max_wait: wait=True 时的最大等待时间，单位为秒；None 表示不限制。
 >     status_read_timeout: 查询检算状态接口的超时时间，单位为秒。
->     sync: 是否要求后端同步执行旧逻辑。长模型不推荐使用，可能再次触发 HTTP 502/超时。
 
 #### 示例
 
 ```python
 from qtmodel import cdb
-# 启动后台混凝土检算，不显示分析窗口
+# 启动后台混凝土检算，自动显示可终止的非模态进度窗口
 cdb.solve_concrete_check()
 # 启动后轮询等待完成
 cdb.solve_concrete_check(wait=True, max_wait=1800)
-# 显示分析窗口并执行混凝土检算
-cdb.solve_concrete_check(show_view=True)
-# 显示模态分析窗口，计算完成自动关闭，等待 1800 秒
-cdb.solve_concrete_check(
-    show_view=True,
-    modal=True,
-    auto_close=True,
-    read_timeout=1800
-)
 ```
 
 #### 返回
 
 >     wait=False 时返回启动状态；wait=True 时返回最终状态。
 
+#### 异常
+
+>     RuntimeError: wait=True 时检算失败或用户终止分析。
+>     TimeoutError: wait=True 时等待超过 max_wait；超时不会自动取消后端计算。
+
 ### `cdb.get_concrete_check_solve_status`
 
 源码：`qtmodel/cdb/cdb_concrete_check.py` · `CdbConcreteCheck.get_concrete_check_solve_status`
@@ -14911,13 +15707,29 @@ cdb.update_element_table_info(element_info: Optional[list[float]]=None)
 
 #### 参数
 
->     element_info: 单个单元基本信息行
+>     element_info: 长度固定为12的单个单元基本信息行，不能为空；各项顺序如下
+>         （方括号内为从0开始的Python列表下标）：
+>         [0] 单元号，必须为单元基本信息表中已有的单元编号。
+>         [1] 混凝土材料号，引用检算材料表中已有的混凝土材料。
+>         [2] I端截面号，引用检算截面表中已有的截面。
+>         [3] J端截面号，引用检算截面表中已有的截面。
+>         [4] I端Y向（竖向）箍筋号，引用已有的箍筋编号。
+>         [5] I端X向（横向）箍筋号，引用已有的箍筋编号。
+>         [6] J端Y向（竖向）箍筋号，引用已有的箍筋编号。
+>         [7] J端X向（横向）箍筋号，引用已有的箍筋编号。
+>         [8] I端计算长度Ly，单位m。
+>         [9] I端计算长度Lz，单位m。
+>         [10] J端计算长度Ly，单位m。
+>         [11] J端计算长度Lz，单位m。
+>         前8项必须为整数值，单元号和混凝土材料号必须大于0；后4项为计算长度数值。
+>         本方法将12项整行写入已有单元，不新增单元；计算长度传0会写入0，不表示保留原值。
 
 #### 示例
 
 ```python
 from qtmodel import cdb
-cdb.update_element_table_info(element_info=[1, 1, 1, 1, 1, 1, 1, 1, 0, 0, 0, 0])
+# 单元1、混凝土材料1；I/J端截面均为3，四个箍筋号均为1，四个计算长度均为0m。
+cdb.update_element_table_info(element_info=[1, 1, 3, 3, 1, 1, 1, 1, 0, 0, 0, 0])
 ```
 
 #### 返回
@@ -15952,7 +16764,9 @@ cdb.add_parameter_reinforcement(sec_id: int, position: int=0, has_outer: bool=Tr
 #### 参数
 
 >     sec_id: 截面编号
->     position: 变截面专用参数 0-I端  1-J端
+>     position: 截面端部位置，只允许0或1，默认0；0表示变截面I端，1表示变截面J端。
+>         等截面不区分端部，通常传0；tapper_sec_group=True时操作由
+>         tapper_interpolation_id指定的插值截面，position不用于选择插值位置，通常传0。
 >     has_outer: 是否包含外侧配筋
 >     has_inner: 是否包含内侧配筋
 >     outer_type: 外侧配筋类型 0-按照间距  1-按照数量
@@ -15987,7 +16801,9 @@ cdb.add_part_parameter_reinforcement(sec_id: int, position: int=0, base_line_id:
 #### 参数
 
 >     sec_id: 截面编号
->     position: 布置位置类型
+>     position: 截面端部位置，只允许0或1，默认0；0表示变截面I端，1表示变截面J端。
+>         等截面不区分端部，通常传0；tapper_sec_group=True时操作由
+>         tapper_interpolation_id指定的插值截面，position不用于选择插值位置，通常传0。
 >     base_line_id: 由截面分段生成的基准线号，从 1 开始。
 >     distribution_type: 分布方式，0-按间距分布，1-按数量分布。
 >     direction_type: 布置方向，0-向内布置，1-向外布置。
@@ -16026,7 +16842,8 @@ cdb.remove_part_parameter_reinforcement(sec_id: int, position: int=0, base_line_
 #### 参数
 
 >     sec_id: 截面号。
->     position: 截面位置，变截面时 0-I 端，1-J 端。
+>     position: 截面端部位置，只允许0或1，默认0；0表示变截面I端，1表示变截面J端。
+>         等截面不区分端部，通常传0。
 >     base_line_id: 基准线号。小于 0 时删除该截面全部局部参数化钢筋。
 
 #### 示例
@@ -16053,7 +16870,9 @@ cdb.add_reinforcement_by_point(sec_id: int, position: int=0, bar_data: Optional[
 #### 参数
 
 >     sec_id: 截面编号
->     position: 布置位置类型
+>     position: 截面端部位置，只允许0或1，默认0；0表示变截面I端，1表示变截面J端。
+>         等截面不区分端部，通常传0；tapper_sec_group=True时操作由
+>         tapper_interpolation_id指定的插值截面，position不用于选择插值位置，通常传0。
 >     bar_data: 钢筋数据列表，格式为 [(x, y, 直径, 材料号)]
 >     tapper_sec_group: 是否操作变截面组中的插值截面；为 True 时 sec_id 表示变截面组编号。
 >     tapper_interpolation_id: 变截面组中的插值截面编号，从 1 开始；tapper_sec_group=True 时必填。
@@ -16063,7 +16882,9 @@ cdb.add_reinforcement_by_point(sec_id: int, position: int=0, bar_data: Optional[
 
 ```python
 from qtmodel import cdb
-cdb.add_reinforcement_by_point(sec_id=1, bar_data=[(0, 0, 20, 1)])
+cdb.add_reinforcement_by_point(sec_id=1, position=0, bar_data=[(0, 0, 20, 1)])
+# sec_id=2为变截面编号时，向其J端截面添加钢筋。
+cdb.add_reinforcement_by_point(sec_id=2, position=1, bar_data=[(0, 0, 20, 1)])
 ```
 
 #### 返回
@@ -16083,7 +16904,8 @@ cdb.update_reinforcement_by_point(sec_id: int, position: int=0, bar_data: Option
 #### 参数
 
 >     sec_id: 截面号。
->     position: 截面位置，变截面时 0-I 端，1-J 端。
+>     position: 截面端部位置，只允许0或1，默认0；0表示变截面I端，1表示变截面J端。
+>         等截面不区分端部，通常传0。
 >     bar_data: 钢筋点列表，格式为 [(x, y, 直径, 材料号)]。
 
 #### 示例
@@ -16097,6 +16919,31 @@ cdb.update_reinforcement_by_point(sec_id=1, bar_data=[(0, 0, 20, 1)])
 
 > QtServer.send_dict 的返回值
 
+### `cdb.remove_section_reinforcement`
+
+源码：`qtmodel/cdb/cdb_concrete_check.py` · `CdbConcreteCheck.remove_section_reinforcement`
+
+```python
+cdb.remove_section_reinforcement(sec_id: int, position: int=0)
+```
+
+删除截面的全部纵向配筋。
+
+#### 参数
+
+>     sec_id: 截面编号。
+>     position: 变截面端部，0 为 I 端、1 为 J 端；等截面通常传 0。
+>
+> 对应后端已注册的 REMOVE-SECTION-REINFORCEMENT 接口。
+> 该接口不支持变截面组中的插值截面。
+
+#### 示例
+
+```python
+from qtmodel import cdb
+result = cdb.remove_section_reinforcement(sec_id=...)
+```
+
 ### `cdb.add_check_stirrup`
 
 源码：`qtmodel/cdb/cdb_concrete_check.py` · `CdbConcreteCheck.add_check_stirrup`