更新优化

mil/core/exceptions.py

@@ -1,26 +1,33 @@
-"""MIL SDK 自定义异常模块"""
+"""MIL SDK 自定义异常模块
+
+约定：
+- 所有 SDK 主动抛出的异常均继承自 MILSDKError，便于上层统一捕获；
+- 异常命名体现"出错阶段"（读取 / 格式 / 用例数据 / 写入），
+  调用方只需按需捕获细分异常，或在外层兜底捕获 MILSDKError。
+"""
 
 
 class MILSDKError(Exception):
-    """MIL SDK 基础异常类"""
+    """MIL SDK 所有自定义异常的根类，UI 层可针对此类型统一兜底。"""
     pass
 
 
 class ExcelReadError(MILSDKError):
-    """Excel 文件读取错误（文件不存在、权限问题等）"""
+    """Excel 读取阶段错误：文件不存在、权限不足、被占用、底层解析失败等。"""
     pass
 
 
 class ExcelFormatError(MILSDKError):
-    """Excel 格式错误（缺少 Sheet、格式不匹配等）"""
+    """Excel 内容格式错误：缺少约定的工作表、缺少 'Source: Input' 标记、
+    模板版本号缺失等结构性异常。"""
     pass
 
 
 class CaseDataError(MILSDKError):
-    """用例数据错误（信号不存在、类型错误等）"""
+    """用例数据语义错误：信号名未在数据字典中找到、步骤时间非数值等。"""
     pass
 
 
 class ExcelWriteError(MILSDKError):
-    """Excel 文件写入错误（权限问题、保存失败等）"""
+    """Excel 写入阶段错误：磁盘权限、文件被占用、保存失败等。"""
     pass