预制楼梯模具配置方案
概述
将一栋/一个项目里多种规格的预制楼梯，按"可共用模具"的原则归并，得出最少模具套数与每套模具的覆盖范围。
默认采用严格共用规则：长度、踏步高度、踏步宽度、厚度、起步宽度、顶部宽度这六项全部相同（仅梯段板宽不同）的楼梯共用一套模具——模具规格宽度取组内最大宽度，侧模可调兼容较窄规格。
- 若源表不含几何参数列（厚度/起步宽度/顶部宽度），严格模式自动退化为"长度+踏步高度+踏步宽度相同即共用"，与普通模式结果一致，无需额外处理。
- 如需退回"仅按长度+踏步分组"的宽松模式（忽略几何参数差异），运行时加
--loose参数。
何时使用
- 用户提供楼梯参数统计表（Excel），要求配置/选型/分组模具
- 源数据更新（新增/修改行）后要求重新配置
- 关键词：配置模具、模具分组、共用模具、楼梯模具、预制楼梯、踏步、最优方案
输入数据格式
Excel 单表，列顺序与含义：
| 列 | 含义 | 示例 |
|---|---|---|
| 楼梯间 | 楼梯间编号（主分组标签） | 9#-3 |
| 自行编号 | 该楼梯间内自编序号 | 1 |
| 编号 | 细码编号（双标识场景作为子编号，进入"涵盖楼梯编号"列） | 13#-1#-1-1 |
| 长度 | 楼梯长度(mm)，可空（空时从踏步宽总值推算） | 3080 |
| 宽度 / 梯段板宽 | 梯段板宽度(mm) | 1330 |
| 踏步高度 | 踏步高×级数，如 166.7*9 或 163.6*11=1800 |
166.7*9 |
| 踏步宽度 | 踏步宽(踏面深)×踏数，如 260*8 或 270*10=2700 |
260*8 |
| 厚度 / 起步宽度 / 顶部宽度 | 几何参数：严格模式作为共用判定项，并原样保留到明细 | 160 / 280 / 450 |
| 数量 | 该规格需生产的件数 | 2 |
列顺序无关，脚本按表头同义词自动识别；多出的附加列也会原样保留到明细表。
工作流程
1. 读取与校正
执行 scripts/gen_mold_config.py，或按以下逻辑自行实现：
- 用 openpyxl 读取 Excel（
data_only=True）。 - 填反自动校正：若某行"踏步高度"首值 > "踏步宽度"首值（如踏步高度=
260*8、踏步宽度=166.7*9），判定两列填反并交换。判定依据：踏步高度值通常 150~175，踏步宽度值通常 260~280。 - 完全重复行检测：同楼梯间+同编号+同长度+同宽度+同踏步高度+同踏步宽度+同数量视为重复，标记但不自动删除（可能是不同单元/梯段的真实需求），在输出中标红提示用户核对。
2. 分组归并
- 严格模式（默认）分组键 =
(长度, 踏步高度, 踏步宽度, 厚度, 起步宽度, 顶部宽度)，宽度为组内可变量。 - 宽松模式（
--loose）分组键 =(长度, 踏步高度, 踏步宽度)，忽略几何参数差异。 - 每组 = 一套模具。组内收集所有不同宽度，模具规格宽度 =
max(宽度)。 - "涵盖楼梯编号"列：列出该模具覆盖的所有细码编号（如
13#-3-1-1（1080）、13#-3-1-1（1105）），便于追溯。 - 排序：按长度 → 踏步级数 → 踏步高度值 → 踏步宽度值 升序，赋予模具编号 M01、M02……
3. 建议套数估算
按"1套模具每天生产1件、工期40天"粗估：建议套数 = max(1, ceil(组内总数量 / 40))。仅参考，实际按项目工期与周转计划调整。需向用户说明这是估算。
4. 输出
生成两个文件，放在当前工作目录：
楼梯模具配置方案.xlsx（3 个工作表）：
1.模具配置方案：每套模具一行（编号、长度、踏步高度/宽度规格、踏步级数、[厚度/起步宽度/顶部宽度]、适用宽度、模具规格宽度、涵盖楼梯间、涵盖楼梯编号、记录数、总数量、建议套数），多宽度共用模具整行标绿，末尾合计行。
2.楼梯-模具对应表：每条原始记录映射到所属模具编号，含厚度/起步/顶部宽度等附加列，重复行备注标红。
3.原始数据(已校正)：校正后的原始数据，含厚度/起步/顶部宽度等附加列、填反/重复标记列。楼梯模具配置方案.html：可视化报告，含统计卡片、配置总表（绿色=共用、红色=重复）、逐条对应明细，便于直接预览。
可复用脚本
scripts/gen_mold_config.py：完整实现上述流程。用法：
# 严格模式（默认）：几何参数纳入共用判定
python scripts/gen_mold_config.py <源Excel路径> <输出目录>
# 宽松模式：仅按长度+踏步分组，忽略几何参数差异
python scripts/gen_mold_config.py <源Excel路径> <输出目录> --loose
- 源 Excel 路径：楼梯参数统计表 .xlsx
- 输出目录：生成的 xlsx 与 html 存放目录（默认当前目录）
脚本依赖 openpyxl（安装到隔离 venv：<python>/Scripts/pip install openpyxl）。脚本自带表头自动识别、填反校正、重复检测、几何参数分组（默认严格）、Excel/HTML 生成，源数据增删行后重跑即可一键更新方案。
关键判断要点
- 共用边界（严格）：长度、踏步高度、踏步宽度、厚度、起步宽度、顶部宽度六项必须全部相同才能共用；仅梯段板宽可不同。任一项不同则单独成模。例如 166.7×9 与 165×9 虽仅差 1.7mm，但踏步高度规格不同，模具踏步型面不同，不可共用，需各自成套。
- 厚度/起步/顶部宽度：属板厚与端部节点，一般靠垫块/端部构造处理；严格模式将其纳入判定会使模具套数略增（13# 项目由 19→20 套，且原本 1330/1430 宽度共用被拆开）。如厂内允许端部差异兼容，用
--loose可更少套数。 - 重复行：务必提示用户核对，不要擅自合并或删除——数量若按行累加，重复行会使总量翻倍。
- 大宽度共用：组内宽度差异大（如 780/980/1980）仍可共用，靠侧模可调，这正是本方案节省模具的关键场景。
