qtmodel 2.6.2__tar.gz → 2.6.4__tar.gz

{qtmodel-2.6.2 → qtmodel-2.6.4}/PKG-INFO

@@ -1,18 +1,22 @@
 Metadata-Version: 2.4
 Name: qtmodel
-Version: 2.6.2
+Version: 2.6.4
 Summary: qtmodel package
 Author: Your Name
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 Requires-Dist: requests>=2.28
 Requires-Dist: psutil>=5.9
+Requires-Dist: matplotlib<4,>=3.8
+Requires-Dist: python-docx<2,>=1.2
 
-> 最新qtmodel版本 2.6.2 - 2026-08-03
+> 最新qtmodel版本 2.6.4 - 2026-08-17
 > pip install --upgrade qtmodel -i https://pypi.org/simple
+- 完善 MCP 批量建模、局部查询与语义操作，新增事务化模型编辑接口。
+- 在 MCP 中提供计算书脚本导出工具（`ReportClient`），声明 python-docx 文档依赖。
 - 调整 `mdb.do_solve()` 默认行为：显示求解窗口、等待求解完成，并默认使用同步求解。
-- 参数化截面字典键统一采用小写，同时兼容历史大小写写法；
-  完善混凝土箱梁、箱梁腹板及钢箱梁截面 Schema，便于 Agent 可靠建模。
+- 参数化截面名称和参数简称严格对齐桥通 `SectionView/Views`，保留简称大小写并兼容历史写法；
+  截面线圈生成严格对齐 `SectionView/Param` 的外圈、孔洞、圆弧和带肋路径。
 - 增加纯 Python 本地截面特性求解：面积、形心、Iy/Iz/Iyz、内外周长、
   包围框、四个控制点、组合截面换算特性和线宽截面特性。
 
@@ -723,22 +727,18 @@ mdb.update_to_post()
 #Returns: 无
 ```  
 ### do_solve
-Run project analysis.
+运行项目分析计算。求解时固定显示模态分析窗口；用户可在窗口中终止分析，正常完成后窗口自动关闭。
 > 参数:  
-> show_view: Show the Qt analysis prompt window while solving.  
-> modal: Reserved for the Qt side when show_view=True.  
-> auto_close: Auto close the prompt window after solving.  
-> read_timeout: Timeout for the start request, in seconds.  
-> wait: Poll and wait for the background solve to finish.  
-> poll_interval: Poll interval when wait=True, in seconds.  
-> max_wait: Max wait time when wait=True, in seconds.  
-> status_read_timeout: Timeout for each status request, in seconds.  
-> sync: Ask backend to run synchronously. Not recommended for large models.  
+> read_timeout: 启动求解请求的超时时间，单位为秒。
+> wait: 是否轮询并等待后台求解完成。
+> poll_interval: 当 wait=True 时，查询求解状态的时间间隔，单位为秒。
+> max_wait: 当 wait=True 时，允许等待求解完成的最长时间，单位为秒。
+> status_read_timeout: 每次查询求解状态请求的超时时间，单位为秒。
+> sync: 是否要求后端同步执行求解。
 ```Python
 # 示例代码
 from qtmodel import *
 mdb.do_solve()
-mdb.do_solve(show_view=True)
 mdb.do_solve(wait=True, max_wait=1800)
 #Returns:
 ```  

{qtmodel-2.6.2 → qtmodel-2.6.4}/README.md

@@ -1,33 +1,35 @@
-> 最新qtmodel版本 2.6.2 - 2026-08-03
-> pip install --upgrade qtmodel -i https://pypi.org/simple
-- 调整 `mdb.do_solve()` 默认行为：显示求解窗口、等待求解完成，并默认使用同步求解。
-- 参数化截面字典键统一采用小写，同时兼容历史大小写写法；
-  完善混凝土箱梁、箱梁腹板及钢箱梁截面 Schema，便于 Agent 可靠建模。
-- 增加纯 Python 本地截面特性求解：面积、形心、Iy/Iz/Iyz、内外周长、
-  包围框、四个控制点、组合截面换算特性和线宽截面特性。
-
-## 本地截面特性计算
-
-本地求解不要求打开桥通，不发送 HTTP 请求。所有坐标和厚度单位为 m，
-面积单位为 m²，惯性矩单位为 m⁴。
-
-```Python
-from qtmodel import mdb
-
-result = mdb.get_parameter_section_property_local(
-    sec_type="矩形",
-    sec_info={"w": 2.0, "h": 1.0},
-)
-print(result.property.Ax, result.property.Iy, result.bounding_box.to_dict())
-
-line_result = mdb.get_section_property_local(
-    sec_type="自定义线宽截面",
-    sec_lines=[[0, 0, 2, 0, 0.02]],
-)
-```
-
-当前本地求解器仅填写可由二维几何严格积分的字段。``Ix``、``Ay``、``Az``、
-剪心和静矩保持为零，完整截面求解仍使用 ``odb.get_section_property``。
+> 最新qtmodel版本 2.6.4 - 2026-08-17
+> pip install --upgrade qtmodel -i https://pypi.org/simple
+- 完善 MCP 批量建模、局部查询与语义操作，新增事务化模型编辑接口。
+- 在 MCP 中提供计算书脚本导出工具（`ReportClient`），声明 python-docx 文档依赖。
+- 调整 `mdb.do_solve()` 默认行为：显示求解窗口、等待求解完成，并默认使用同步求解。
+- 参数化截面名称和参数简称严格对齐桥通 `SectionView/Views`，保留简称大小写并兼容历史写法；
+  截面线圈生成严格对齐 `SectionView/Param` 的外圈、孔洞、圆弧和带肋路径。
+- 增加纯 Python 本地截面特性求解：面积、形心、Iy/Iz/Iyz、内外周长、
+  包围框、四个控制点、组合截面换算特性和线宽截面特性。
+
+## 本地截面特性计算
+
+本地求解不要求打开桥通，不发送 HTTP 请求。所有坐标和厚度单位为 m，
+面积单位为 m²，惯性矩单位为 m⁴。
+
+```Python
+from qtmodel import mdb
+
+result = mdb.get_parameter_section_property_local(
+    sec_type="矩形",
+    sec_info={"w": 2.0, "h": 1.0},
+)
+print(result.property.Ax, result.property.Iy, result.bounding_box.to_dict())
+
+line_result = mdb.get_section_property_local(
+    sec_type="自定义线宽截面",
+    sec_lines=[[0, 0, 2, 0, 0.02]],
+)
+```
+
+当前本地求解器仅填写可由二维几何严格积分的字段。``Ix``、``Ay``、``Az``、
+剪心和静矩保持为零，完整截面求解仍使用 ``odb.get_section_property``。
 # 建模操作 
 ##  节点操作
 ### generate_curve_node_data
@@ -713,22 +715,18 @@ mdb.update_to_post()
 #Returns: 无
 ```  
 ### do_solve
-Run project analysis.
+运行项目分析计算。求解时固定显示模态分析窗口；用户可在窗口中终止分析，正常完成后窗口自动关闭。
 > 参数:  
-> show_view: Show the Qt analysis prompt window while solving.  
-> modal: Reserved for the Qt side when show_view=True.  
-> auto_close: Auto close the prompt window after solving.  
-> read_timeout: Timeout for the start request, in seconds.  
-> wait: Poll and wait for the background solve to finish.  
-> poll_interval: Poll interval when wait=True, in seconds.  
-> max_wait: Max wait time when wait=True, in seconds.  
-> status_read_timeout: Timeout for each status request, in seconds.  
-> sync: Ask backend to run synchronously. Not recommended for large models.  
+> read_timeout: 启动求解请求的超时时间，单位为秒。
+> wait: 是否轮询并等待后台求解完成。
+> poll_interval: 当 wait=True 时，查询求解状态的时间间隔，单位为秒。
+> max_wait: 当 wait=True 时，允许等待求解完成的最长时间，单位为秒。
+> status_read_timeout: 每次查询求解状态请求的超时时间，单位为秒。
+> sync: 是否要求后端同步执行求解。
 ```Python
 # 示例代码
 from qtmodel import *
 mdb.do_solve()
-mdb.do_solve(show_view=True)
 mdb.do_solve(wait=True, max_wait=1800)
 #Returns:
 ```  

{qtmodel-2.6.2 → qtmodel-2.6.4}/pyproject.toml

@@ -4,15 +4,17 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "qtmodel"
-version = "2.6.2"
+version = "2.6.4"
 description = "qtmodel package"
 readme = "README.md"
 requires-python = ">=3.9"
-authors = [{name = "Your Name"}]
-dependencies = [
-    "requests>=2.28",
-    "psutil>=5.9",
-]
+authors = [{name = "Your Name"}]
+dependencies = [
+    "requests>=2.28",
+    "psutil>=5.9",
+    "matplotlib>=3.8,<4",
+    "python-docx>=1.2,<2",
+]
 
 [tool.setuptools]
 package-dir = {"" = "src"}
@@ -26,4 +28,4 @@ where = ["src"]
 # py -m pip install -U pip build twine
 # py -m build
 # py -m twine check dist/*
-# py -m twine upload -r pypi --non-interactive --verbose dist/*
+# py -m twine upload -r pypi --non-interactive --verbose dist/*

{qtmodel-2.6.2 → qtmodel-2.6.4}/src/qtmodel/__init__.py

@@ -1,33 +1,46 @@
 from .bridge import bridge, Bridge
 from .cdb import cdb, Cdb
-from .core.qt_server import QtServer
-from .core.section_db import SectionDB, SectionParameter, SectionProperty, SectionSchema
-from .core.section_geometry import SectionGeometryDB
-from .core.section_property_solver import (
-    SectionBoundingBox,
-    SectionControlPoint,
-    SectionPartProperty,
-    SectionPropertyResult,
-    SectionPropertySolver,
-)
-from .core.section_shape import (
-    SectionLine,
-    SectionLoopSegment,
-    SectionPoint,
-    SectionShape,
-    SectionShapePart,
-)
+from .core.qt_server import QtServer
+from .core.section_db import SectionDB, SectionParameter, SectionProperty, SectionSchema
+from .core.section_geometry import SectionGeometryDB
+from .core.section_property_solver import (
+    SectionBoundingBox,
+    SectionControlPoint,
+    SectionPartProperty,
+    SectionPropertyResult,
+    SectionPropertySolver,
+)
+from .core.section_shape import (
+    SectionLine,
+    SectionLoopSegment,
+    SectionPoint,
+    SectionShape,
+    SectionShapePart,
+)
 from .mdb import mdb, Mdb
 from .odb import odb, Odb
+from .report import (
+    HighwayPcDocxGenerator,
+    MatplotlibPlotRenderer,
+    Report,
+    ReportClient,
+    ReportGenerationResult,
+    ReportOptions,
+    ReportProtocolError,
+    report,
+)
 
-__version__ = QtServer.QT_VERSION
-
-__all__ = [
-    "Bridge", "bridge", "Cdb", "cdb", "Mdb", "mdb", "Odb", "odb",
-    "SectionDB", "SectionParameter", "SectionProperty", "SectionSchema",
-    "SectionGeometryDB",
-    "SectionBoundingBox", "SectionControlPoint", "SectionPartProperty",
-    "SectionPropertyResult", "SectionPropertySolver",
-    "SectionPoint", "SectionLoopSegment", "SectionLine", "SectionShapePart",
-    "SectionShape",
-]
+__version__ = QtServer.QT_VERSION
+
+__all__ = [
+    "Bridge", "bridge", "Cdb", "cdb", "Mdb", "mdb", "Odb", "odb",
+    "SectionDB", "SectionParameter", "SectionProperty", "SectionSchema",
+    "SectionGeometryDB",
+    "SectionBoundingBox", "SectionControlPoint", "SectionPartProperty",
+    "SectionPropertyResult", "SectionPropertySolver",
+    "SectionPoint", "SectionLoopSegment", "SectionLine", "SectionShapePart",
+    "SectionShape",
+    "HighwayPcDocxGenerator", "MatplotlibPlotRenderer",
+    "Report", "report", "ReportClient", "ReportGenerationResult",
+    "ReportOptions", "ReportProtocolError",
+]

{qtmodel-2.6.2 → qtmodel-2.6.4}/src/qtmodel/cdb/__init__.py

@@ -2,9 +2,8 @@ from .cdb_concrete_check import CdbConcreteCheck
 from .cdb_steel_box_check import CdbSteelBoxCheck
 from .cdb_steel_truss_check import CdbSteelTrussCheck
 from qtmodel.core.qt_server import QtServer
-from .cdb_anti_overturn_check import CdbAntiOverturnCheck
 
-class Cdb(CdbConcreteCheck, CdbSteelBoxCheck, CdbSteelTrussCheck, CdbAntiOverturnCheck):
+class Cdb(CdbConcreteCheck, CdbSteelBoxCheck, CdbSteelTrussCheck):
     """聚合所有 Cdb 能力的门面类（Facade）。"""
     @staticmethod
     def update_model():

{qtmodel-2.6.2 → qtmodel-2.6.4}/src/qtmodel/cdb/cdb_concrete_check.py

@@ -1078,7 +1078,7 @@ class CdbConcreteCheck:
         Returns:
             list[ElementTorsionStirrupData]: 单元抗扭箍筋数据列表。
         """
-        json_str = QtServer.get_json_str("GET-ELEMENT-TORSION-DATA", {
+        json_str = QtServer.get_json_str("GET-ELEMENT-TORSION-STIRRUP-DATA", {
             "ele_id": ele_id,
             "ele_ids": ele_ids or []
         })
@@ -1417,10 +1417,10 @@ class CdbConcreteCheck:
             element_id: 单元编号，可选参数，仅详表需要
             beam_end_mark: 梁端标记，0 为 I 端，1 为 J 端，2 为 IJ 端，可选参数，仅详表需要
             shear_direction_type: 剪切方向类型，可选参数，仅斜截面抗剪总表需要 0-Vertical  1-Lateral  2-Bidirectional
-        Example:
-            cdb.get_check_case_result_info(result_type="正截面承载力", table_type=1)
-        Returns:
-            QtServer.send_dict 的返回值。
+        Example:
+            cdb.get_check_case_result_info(result_type="正截面承载力", table_type=1)
+        Returns:
+            QtServer.send_dict 的返回值。
         """
         return CdbConcreteCheck._send("GET-CHECK-CASE-RESULT-INFO", {
             "result_type": result_type,
@@ -1461,13 +1461,13 @@ class CdbConcreteCheck:
 
     @staticmethod
     def get_normal_section_bearing_analysis_setting():
-        """
-        获取正截面承载力分析设置。
-        Args: 无
-        Example:
-           setting = cdb.get_normal_section_bearing_analysis_setting()
-        Returns:
-            dict: 包含 normal_section_bearing_calculation_type，枚举取值含义与对应更新接口一致。
+        """
+        获取正截面承载力分析设置。
+        Args: 无
+        Example:
+           setting = cdb.get_normal_section_bearing_analysis_setting()
+        Returns:
+            dict: 包含 normal_section_bearing_calculation_type，枚举取值含义与对应更新接口一致。
         """
         return CdbConcreteCheck._send("GET-NORMAL-SECTION-BEARING-ANALYSIS-SETTING", {})
 
@@ -1503,14 +1503,14 @@ class CdbConcreteCheck:
 
     @staticmethod
     def get_oblique_section_shear_bearing_analysis_setting():
-        """
-        获取斜截面抗剪承载力分析设置。
-        Args: 无
-        Example:
-           setting = cdb.get_oblique_section_shear_bearing_analysis_setting()
-        Returns:
-            dict: 包含 reinforcement_height_multiple、is_consider_as_simple_support、
-                shear_strength_material_factor、oblique_section_shear_direction_type。
+        """
+        获取斜截面抗剪承载力分析设置。
+        Args: 无
+        Example:
+           setting = cdb.get_oblique_section_shear_bearing_analysis_setting()
+        Returns:
+            dict: 包含 reinforcement_height_multiple、is_consider_as_simple_support、
+                shear_strength_material_factor、oblique_section_shear_direction_type。
         """
         return CdbConcreteCheck._send("GET-OBLIQUE-SECTION-SHEAR-BEARING-ANALYSIS-SETTING", {})
 
@@ -1546,14 +1546,14 @@ class CdbConcreteCheck:
 
     @staticmethod
     def get_limit_state_method_analysis_setting():
-        """
-        获取极限状态法分析设置。
-        Args: 无
-        Example:
-           setting = cdb.get_limit_state_method_analysis_setting()
-        Returns:
-            dict: 包含 cal_fatigue、fatigue_limit_steel_bar、fatigue_limit_prestress、
-                is_consider_as_simple_support、is_consider_construction_load。
+        """
+        获取极限状态法分析设置。
+        Args: 无
+        Example:
+           setting = cdb.get_limit_state_method_analysis_setting()
+        Returns:
+            dict: 包含 cal_fatigue、fatigue_limit_steel_bar、fatigue_limit_prestress、
+                is_consider_as_simple_support、is_consider_construction_load。
         """
         return CdbConcreteCheck._send("GET-LIMIT-STATE-METHOD-ANALYSIS-SETTING", {})
 
@@ -1591,15 +1591,15 @@ class CdbConcreteCheck:
 
     @staticmethod
     def get_normal_stress_analysis_setting():
-        """
-        获取正应力分析设置。
-        Args: 无
-        Example:
-           setting = cdb.get_normal_stress_analysis_setting()
-        Returns:
-            dict: 包含 aashto2020_normal_stress_rebar_type、tendon_allowable_stress_amplitude、
-                flange_web_slenderness_ratio、construction_stage_concrete_tensile_limit、
-                service_combination3_concrete_tension_limit。
+        """
+        获取正应力分析设置。
+        Args: 无
+        Example:
+           setting = cdb.get_normal_stress_analysis_setting()
+        Returns:
+            dict: 包含 aashto2020_normal_stress_rebar_type、tendon_allowable_stress_amplitude、
+                flange_web_slenderness_ratio、construction_stage_concrete_tensile_limit、
+                service_combination3_concrete_tension_limit。
         """
         return CdbConcreteCheck._send("GET-NORMAL-STRESS-ANALYSIS-SETTING", {})
 
@@ -1693,17 +1693,17 @@ class CdbConcreteCheck:
 
     @staticmethod
     def get_crack_width_analysis_setting():
-        """
-        获取裂缝宽度分析设置。
-        Args: 无
-        Example:
-           setting = cdb.get_crack_width_analysis_setting()
-        Returns:
-            dict: 包含 highway_environment_category_type、railway_environment_category_type、
-                railway_limit_environment_category_type、crack_setting_type、clear_protective_thickness、
-                steel_bar_type、effect_coefficient_type、user_specified_effect_coefficient、
-                is_epoxy_resin_rebar、is_welded_rebar_skeleton、mq_mg、protective_thickness、
-                exposure_coefficient。
+        """
+        获取裂缝宽度分析设置。
+        Args: 无
+        Example:
+           setting = cdb.get_crack_width_analysis_setting()
+        Returns:
+            dict: 包含 highway_environment_category_type、railway_environment_category_type、
+                railway_limit_environment_category_type、crack_setting_type、clear_protective_thickness、
+                steel_bar_type、effect_coefficient_type、user_specified_effect_coefficient、
+                is_epoxy_resin_rebar、is_welded_rebar_skeleton、mq_mg、protective_thickness、
+                exposure_coefficient。
         """
         return CdbConcreteCheck._send("GET-CRACK-WIDTH-ANALYSIS-SETTING", {})
 
@@ -1734,13 +1734,13 @@ class CdbConcreteCheck:
 
     @staticmethod
     def get_moment_curvature_curve_analysis_setting():
-        """
-        获取弯矩曲率曲线分析设置。
-        Args: 无
-        Example:
-           setting = cdb.get_moment_curvature_curve_analysis_setting()
-        Returns:
-            dict: 包含 moment_curvature_type、moment_curvature_model_type，枚举取值含义与对应更新接口一致。
+        """
+        获取弯矩曲率曲线分析设置。
+        Args: 无
+        Example:
+           setting = cdb.get_moment_curvature_curve_analysis_setting()
+        Returns:
+            dict: 包含 moment_curvature_type、moment_curvature_model_type，枚举取值含义与对应更新接口一致。
         """
         return CdbConcreteCheck._send("GET-MOMENT-CURVATURE-CURVE-ANALYSIS-SETTING", {})
 
@@ -1770,13 +1770,13 @@ class CdbConcreteCheck:
 
     @staticmethod
     def get_bearing_curve_analysis_setting():
-        """
-        获取承载力曲线分析设置。
-        Args: 无
-        Example:
-           setting = cdb.get_bearing_curve_analysis_setting()
-        Returns:
-            dict: 包含 bearing_curve_count、angle_between_m_and_y_axis、force_p。
+        """
+        获取承载力曲线分析设置。
+        Args: 无
+        Example:
+           setting = cdb.get_bearing_curve_analysis_setting()
+        Returns:
+            dict: 包含 bearing_curve_count、angle_between_m_and_y_axis、force_p。
         """
         return CdbConcreteCheck._send("GET-BEARING-CURVE-ANALYSIS-SETTING", {})
 

{qtmodel-2.6.2 → qtmodel-2.6.4}/src/qtmodel/cdb/cdb_steel_truss_check.py

@@ -6,40 +6,6 @@ class CdbSteelTrussCheck:
     用于钢桁架结构检查
     """
 
-    # region 钢桁架检查
-    @staticmethod
-    def check_steel_truss_member():
-        """
-        检查钢桁架杆件
-        Args:无
-        Example:
-            cdb.check_steel_truss_member()
-        Returns: 无
-        """
-        QtServer.send_dict(header="CHECK-STEEL-TRUSS-MEMBER")
-
-    @staticmethod
-    def check_steel_truss_joint():
-        """
-        检查钢桁架节点
-        Args:无
-        Example:
-            cdb.check_steel_truss_joint()
-        Returns: 无
-        """
-        QtServer.send_dict(header="CHECK-STEEL-TRUSS-JOINT")
-
-    @staticmethod
-    def check_steel_truss_stability():
-        """
-        检查钢桁架稳定性
-        Args:无
-        Example:
-            cdb.check_steel_truss_stability()
-        Returns: 无
-        """
-        QtServer.send_dict(header="CHECK-STEEL-TRUSS-STABILITY")
-
     @staticmethod
     def extract_member_design_data(member_ids: list[int], load_cases: list[str]):
         """