cls（类方法）的使用场景非常明确，让我详细说明：

使用 cls 的典型场景

1. 工厂方法（Factory Methods） ⭐ 最常见

场景：提供多种创建对象的方式

class SkillMetadata:
    def __init__(self, skill_id, robot_type, description, ...):
        self.skill_id = skill_id
        self.robot_type = robot_type
        # ...
    
    # 从 YAML 文件创建
    @classmethod
    def from_yaml(cls, yaml_path):
        data = load_yaml(yaml_path)
        return cls(
            skill_id=data["skill_id"],
            robot_type=data["robot_type"],
            # ...
        )
    
    # 从字典创建
    @classmethod
    def from_dict(cls, data):
        return cls(
            skill_id=data["skill_id"],
            robot_type=data["robot_type"],
            # ...
        )
    
    # 从 JSON 创建
    @classmethod
    def from_json(cls, json_string):
        data = json.loads(json_string)
        return cls.from_dict(data)

使用：

# 多种创建方式，而不是只有一个 __init__
skill1 = SkillMetadata.from_yaml("skill.yaml")
skill2 = SkillMetadata.from_dict({"skill_id": "...", ...})
skill3 = SkillMetadata.from_json('{"skill_id": "..."}')

---

2. 备选构造器（Alternative Constructors）

场景：提供更直观、更便捷的对象创建方式

class Person:
    def __init__(self, name, age):
        self.name = name
        self.age = age
    
    # 从出生年份创建
    @classmethod
    def from_birth_year(cls, name, birth_year):
        age = 2026 - birth_year
        return cls(name, age)
    
    # 从字符串创建
    @classmethod
    def from_string(cls, person_string):
        # "John-1990"
        name, birth_year = person_string.split('-')
        return cls.from_birth_year(name, int(birth_year))

使用：

# 直接用年龄
person1 = Person("Alice", 25)

# 用出生年份（更直观）
person2 = Person.from_birth_year("Bob", 1995)

# 从字符串解析
person3 = Person.from_string("Charlie-2000")

---

3. 数据加载/反序列化

场景：从不同数据源加载对象

class Model:
    def __init__(self, weights, config):
        self.weights = weights
        self.config = config
    
    @classmethod
    def load_from_checkpoint(cls, checkpoint_path):
        """从检查点文件加载模型"""
        data = torch.load(checkpoint_path)
        return cls(data['weights'], data['config'])
    
    @classmethod
    def load_pretrained(cls, model_name):
        """从预训练模型库加载"""
        weights = download_weights(model_name)
        config = load_default_config(model_name)
        return cls(weights, config)

使用：

model1 = Model.load_from_checkpoint("model.pth")
model2 = Model.load_pretrained("bert-base")

---

4. 操作类变量（Class Variables）

场景：跟踪或修改所有实例共享的数据

class Database:
    connection_count = 0  # 类变量：所有实例共享
    
    def __init__(self, host, port):
        self.host = host
        self.port = port
        Database.connection_count += 1
    
    @classmethod
    def get_connection_count(cls):
        """获取总连接数"""
        return cls.connection_count
    
    @classmethod
    def reset_connections(cls):
        """重置计数器"""
        cls.connection_count = 0

使用：

db1 = Database("localhost", 5432)
db2 = Database("remote", 5432)

print(Database.get_connection_count())  # 2
Database.reset_connections()
print(Database.get_connection_count())  # 0

---

5. 配置管理

场景：管理全局配置或设置

class Config:
    _instance = None
    debug_mode = False
    
    @classmethod
    def set_debug(cls, enabled):
        """设置调试模式"""
        cls.debug_mode = enabled
    
    @classmethod
    def is_debug(cls):
        """检查是否调试模式"""
        return cls.debug_mode
    
    @classmethod
    def get_instance(cls):
        """单例模式"""
        if cls._instance is None:
            cls._instance = cls()
        return cls._instance

使用：

Config.set_debug(True)
if Config.is_debug():
    print("Debug mode enabled")

config = Config.get_instance()  # 总是返回同一个实例

---

6. 验证和校验

场景：在创建对象前进行验证

class Email:
    def __init__(self, address):
        self.address = address
    
    @classmethod
    def from_string(cls, email_string):
        """验证并创建邮箱对象"""
        if "@" not in email_string:
            raise ValueError("Invalid email format")
        if not email_string.endswith((".com", ".org", ".edu")):
            raise ValueError("Invalid email domain")
        return cls(email_string)

使用：

# 自动验证
email = Email.from_string("user@example.com")  # ✅
email = Email.from_string("invalid")  # ❌ 抛出异常

---

7. 支持继承

场景：确保子类也能正确使用工厂方法

class BaseSkill:
    @classmethod
    def from_yaml(cls, yaml_path):
        data = load_yaml(yaml_path)
        return cls(data)  # cls 会自动是子类

class PickSkill(BaseSkill):
    pass

class PlaceSkill(BaseSkill):
    pass

# cls 自动识别子类
pick = PickSkill.from_yaml("pick.yaml")  # 返回 PickSkill 实例
place = PlaceSkill.from_yaml("place.yaml")  # 返回 PlaceSkill 实例

---

总结：何时使用 @classmethod 和 cls？

场景	是否使用 cls	原因
创建实例的多种方式（工厂方法）	✅ 使用	提供便捷的构造器
从文件/数据加载对象	✅ 使用	封装复杂的初始化逻辑
操作类变量（共享数据）	✅ 使用	访问类级别的数据
单例模式	✅ 使用	控制实例创建
需要支持继承的工厂方法	✅ 使用	cls 自动识别子类
只操作实例数据	❌ 用 self	普通实例方法即可
不需要访问类或实例	❌ 用普通函数	静态方法或独立函数

核心原则：当方法需要创建类的实例或操作类本身时，使用 @classmethod 和 cls。