## 错误处理

### 输入问题
- 文件不存在：告知用户文件路径有误，请重新上传
- 文件格式不支持：列出支持的格式（pdf、docx、txt），请用户转换后重试
- 文件为空：告知文件内容为空，无法处理

### 执行问题
- 脚本运行失败：将完整错误信息展示给用户，不要隐藏
- 依赖未安装：先尝试自动安装（pip install），若失败则告知用户手动安装
- 超时：若超过 60 秒未完成，输出当前进度并询问用户是否继续等待

### 结果问题
- 输出文件为空：重新检查处理逻辑，向用户说明可能原因
- 输出格式不符合预期：展示实际输出，询问用户是否满意

# 文件路径：scripts/error_handling_demo.py
import json
import sys
import os

class SkillError(Exception):
    """Skill 自定义异常基类"""
    def __init__(self, message: str, code: str):
        self.message = message
        self.code    = code     # 错误码，便于程序判断错误类型
        super().__init__(message)

class InputError(SkillError):
    """输入验证错误"""
    pass

class ProcessError(SkillError):
    """处理过程错误"""
    pass

def validate_input(file_path: str) -> None:
    """验证输入，出错时抛出 InputError"""
    if not file_path:
        raise InputError("未提供文件路径", "MISSING_FILE")
    if not os.path.exists(file_path):
        raise InputError(f"文件不存在：{file_path}", "FILE_NOT_FOUND")
    if os.path.getsize(file_path) == 0:
        raise InputError(f"文件内容为空：{file_path}", "EMPTY_FILE")

def process(file_path: str) -> dict:
    """主处理逻辑"""
    try:
        validate_input(file_path)

        with open(file_path, "r", encoding="utf-8") as f:
            content = f.read()

        # 实际处理逻辑（此处简化为行数统计）
        lines = content.split("\n")
        return {
            "status": "success",
            "data": {
                "file":  file_path,
                "lines": len(lines),
                "chars": len(content)
            }
        }

    except InputError as e:
        # 输入错误：用户可以修正后重试
        return {
            "status":  "input_error",
            "code":    e.code,
            "message": e.message,
            "hint":    "请检查文件路径是否正确，文件是否存在且非空"
        }
    except UnicodeDecodeError:
        # 编码错误：给出具体的修复建议
        return {
            "status":  "process_error",
            "code":    "ENCODING_ERROR",
            "message": "文件编码不是 UTF-8，无法读取",
            "hint":    "请将文件另存为 UTF-8 编码后重试"
        }
    except Exception as e:
        # 未预期的错误：完整记录，便于调试
        return {
            "status":  "unexpected_error",
            "code":    "UNKNOWN",
            "message": str(e),
            "hint":    "请将上述错误信息反馈给开发者"
        }

if __name__ == "__main__":
    file_path = sys.argv[1] if len(sys.argv) > 1 else ""
    result    = process(file_path)
    print(json.dumps(result, ensure_ascii=False, indent=2))

# 文件路径：scripts/auto_install_demo.py
import subprocess
import sys

def ensure_package(package_name: str, import_name: str = None) -> bool:
    """
    确保 Python 包已安装，若未安装则自动安装

    参数：
        package_name: pip 安装时使用的包名（如 "python-docx"）
        import_name:  import 时使用的名称（如 "docx"），默认与 package_name 相同
    """
    import_name = import_name or package_name
    try:
        __import__(import_name)
        return True  # 已安装
    except ImportError:
        print(f"正在安装依赖：{package_name}...")
        result = subprocess.run(
            [sys.executable, "-m", "pip", "install", package_name,
             "--break-system-packages", "--quiet"],
            capture_output=True, text=True
        )
        if result.returncode == 0:
            print(f"安装成功：{package_name}")
            return True
        else:
            print(f"安装失败：{package_name}")
            print(result.stderr)
            return False

# 使用示例：在脚本开头确保所有依赖已就绪
if not ensure_package("pandas"):
    sys.exit(1)
if not ensure_package("openpyxl"):
    sys.exit(1)

# 依赖就绪后，正常 import
import pandas as pd
print("所有依赖已就绪，开始执行...")

# 差的错误信息
raise Exception("Error")

# 好的错误信息
raise InputError(
    "文件 soho_data.csv 未在上传目录中找到。"
    "可能原因：文件名拼写有误，或文件尚未上传。"
    "请重新上传文件后再试。",
    code="FILE_NOT_FOUND"
)