import psutil


def PID_取CPU占用(pid: int | str, 间隔秒数: float = 0.0) -> float:
    """
    根据进程 PID 获取 CPU 占用率。

    功能说明：
        - 返回值为百分比数值，例如 12.5 表示 12.5%。
        - 可通过“间隔秒数”控制采样时长，默认 0.0 表示立即返回当前采样结果。
        - 参数无效、进程不存在、无权限访问或发生异常时返回 0.0。

    Args:
        pid (int | str): 要查询的进程 PID。
        间隔秒数 (float): CPU 占用率采样间隔秒数，默认为 0.0。

    Returns:
        float: 成功返回 CPU 占用率；失败返回 0.0。
    """
    try:
        pid = int(pid)
        间隔秒数 = float(间隔秒数)
        return float(psutil.Process(pid).cpu_percent(interval=间隔秒数))
    except Exception:
        return 0.0
