diff --git a/VBA/ClassModules/clsBOMManager.cls b/VBA/ClassModules/clsBOMManager.cls
index 2b742c2..a601dc1 100644
--- a/VBA/ClassModules/clsBOMManager.cls
+++ b/VBA/ClassModules/clsBOMManager.cls
@@ -356,14 +356,50 @@ Private Sub PrintCategory(ws As Worksheet, cat As clsCategory, _
 End Sub
 ' ========================================
 ' GetMaterialsByModel 方法
-' 功能: 根据产品型号获取符合条件的物料清单
-' 参数:
+'
+' 【功能概述】
+'   根据产品型号字符串自动解析规格参数,并返回符合这些规格的所有物料清单。
+'   这是BOM系统的核心方法,实现了从"产品型号"到"物料清单"的智能转换。
+'
+' 【工作流程】
+'   1. 型号解析 (clsModelParser) → 将产品型号字符串拆解为结构化参数
+'   2. 条件提取 (clsConditionExtractor) → 从型号参数中提取匹配条件变量
+'   3. 物料筛选 (clsConditionMatcher) → 根据条件从物料库中筛选符合条件的物料
+'
+' 【参数说明】
 '   modelStr - 产品型号字符串
-'   categoryName - 可选，指定类别名称。为空则返回所有类别的物料
-' 返回: Collection对象，包含符合条件的clsMaterialItem对象
-' 示例:
-'   Set materials = bomMgr.GetMaterialsByModel("YTHN-100.A0.532.M203.M16.Y3")
-'   Set materials = bomMgr.GetMaterialsByModel("YTHN-100.A0.532.M203.M16.Y3", "部件")
+'              格式: [型号]-[口径].[安装].[表壳].[连接].[量程]|[表盘]|[附件]|[法兰]
+'              示例: "YTHN-100.A0.532.M203.M16.Y3|BP-095.2312.M16.PA3"
+'              说明: 必须是完整的型号字符串,不能为空
+'
+'   categoryName - 类别名称(可选参数,默认为空字符串)
+'              为空字符串 "": 返回所有类别的符合条件物料(默认行为)
+'              指定类别名:  仅返回该类别下的符合条件物料
+'              示例: "部件"、"表壳"、"接头"、"机芯"
+'
+' 【返回值】
+'   返回类型: Collection对象
+'   元素类型: Collection中的每个元素都是 clsMaterialItem 对象
+'
+'   clsMaterialItem 对象属性:
+'     .code      - String  - 物料代号(如: "01011019001")
+'     .Name      - String  - 物料名称(如: "低压接头部件")
+'     .Quantity  - Double  - 物料数量(如: 1, 2, 0.5)
+'     .Condition - String  - 选择条件(如: "lcfw=M02 AND gclj=Z12")
+'     .Category  - String  - 所属类别名称
+'     .ParentCategory - String - 上层类别名称
+'
+' 【注意事项】
+'   1. 调用前必须先执行 LoadData() 方法加载BOM数据
+'   2. 型号字符串必须完整且符合格式要求
+'   3. 返回的Collection可能为空(没有符合条件的物料),需要判断Count属性
+'   4. 调试信息会输出到VBA的"立即窗口"(Ctrl+G查看)
+'   5. 物料的Condition属性为空表示该物料无条件限制(所有型号都使用)
+'
+' 【相关方法】
+'   - GetMaterialsByCategoryAndModel: 结合了类别层级逻辑的物料获取
+'   - GetMaterialsForPicking: 纯粹按类别获取物料(不进行型号匹配)
+'   - ParseModelAndExtractConditions: 仅解析型号并返回条件字典
 ' ========================================
 Public Function GetMaterialsByModel(modelStr As String, _
                                    Optional categoryName As String = "") As collection