from typing import Any, Dict


def 删除指定值(
    数据: Dict[str, Any],
    目标值: Any
) -> int:
    """
    删除字典中值等于目标值的所有键，并返回删除数量。

    本函数用于对字典执行“按值清理”的批量删除操作，
    适合处理占位值、无效值、统一标记值等场景。

    设计特性：
        - 若传入对象不是字典类型，直接返回 0；
        - 操作为原地删除，不创建新的字典对象；
        - 删除依据为 `==` 比较结果；
        - 仅删除最外层键，不递归检查嵌套结构内部成员；
        - 不抛出任何异常，适合作为底层清洗工具函数使用。

    行为说明：
        - 数据为 dict                → 删除所有值等于目标值的键并返回数量；
        - 数据不是 dict              → 返回 0；
        - 无任何目标值命中           → 返回 0。

    Args:
        数据 (dict): 需要处理的字典对象。
        目标值: 需要删除的目标值。

    Returns:
        int:
            - 成功：返回实际删除的键数量；
            - 失败：返回 0。
    """
    try:
        if not isinstance(数据, dict):
            return 0

        待删除键列表 = [
            键
            for 键, 值 in 数据.items()
            if 值 == 目标值
        ]

        for 键 in 待删除键列表:
            del 数据[键]

        return len(待删除键列表)
    except Exception:
        return 0