Converting all model Config classes to dataclasses

快速结论：这个报错来自一个 Feature request：把 Transformers 中所有模型 Config 类统一迁移为 dataclass，通常出现在你升级到包含该改动的版本后，自定义 Config 子类或老式 __init__ 写法与新基类不兼容的场景；优先排查自定义 Config 是否仍按旧的 PretrainedConfig 方式继承、是否缺少类型字段声明。

适用环境：Issue 未提供具体的操作系统、Python、CUDA、PyTorch、显卡或依赖版本信息，仅确认涉及工具为 Transformers，最终修复版本为 v5.4.0。

最快修复方案：暂无确认的一步修复方案。Issue 中明确说明该改动已通过 #41250 落地并在 v5.4.0 发布，PreTrainedConfig 现在是 dataclass，并使用 huggingface_hub 的 @strict 校验；自定义 Config 应直接声明带类型的字段，不再需要包装器。

注意事项：该 Issue 最初只是功能请求，讨论中存在多种未验证的临时实现方案（如装饰器包装、仅转换 PretrainedConfig），这些方案均未被官方采纳，不应作为正式修复手段。真正的整体迁移是一次性完成且要求完整向后兼容，无法拆分成多个 PR 分步进行。

问题场景

用户在使用或扩展 Transformers 时，需要为自定义模型编写 Config 类，或升级 Transformers 后原有自定义 Config 开始报错。触发场景通常是把旧式 PretrainedConfig 子类（在 __init__ 中手动设置属性）迁移到已被官方改为 dataclass 的新基类上，或在继承层级中混用 dataclass 与非 dataclass Config。

报错原文

Converting all model Config classes to dataclasses

原因分析

核心变更是把 PreTrainedConfig 从普通类改为 dataclass，并引入 huggingface_hub 的 @strict 校验。可能原因包括：自定义 Config 仍按旧的 __init__ 手工赋值方式编写，未声明带类型的类字段，导致 dataclass 初始化或严格校验失败；或者继承链中部分父类不是 dataclass，破坏了 dataclass 字段的收集。Issue 中讨论还提到，PretrainedConfig 构造函数内包含大量逻辑、property 和 classmethod，并不适合当作教科书式的 dataclass，因此迁移过程中容易出现兼容性问题。

环境排查

确认 Transformers 版本是否为 v5.4.0 或更高，该版本包含 #41250。
确认 huggingface_hub 是否已安装且版本与当前 Transformers 兼容，因为新基类依赖其 @strict 校验。
检查自定义 Config 的继承链：所有父类是否都已迁移为 dataclass。
检查自定义 Config 是否仍使用旧式 def __init__(self, ...) 手动赋值，而不是声明带类型的字段。
Issue 未提供 Python、PyTorch、CUDA、显卡信息，这些不纳入本次排查范围。

解决步骤

升级 Transformers 到 v5.4.0 或更高版本，确保包含 PreTrainedConfig 的 dataclass 改造。
将自定义 Config 的继承对象改为新的 PreTrainedConfig，不要再基于旧式 PretrainedConfig 手工写法扩展。
在自定义 Config 中直接声明带类型的字段，而不是在 __init__ 里逐个 setattr。根据 Issue 说明，自定义 Config 现在无需包装器即可声明类型字段。
如果自定义 Config 属于继承层级中的中间类，确认它的父类和子类都按 dataclass 方式处理，避免混用非 dataclass 父类。
删除此前为绕过问题而写的装饰器包装方案（例如把普通类包装成 PreTrainedConfig 子类的做法），这些方案未被官方合并，可能在 @strict 校验下失效。
如仍失败，回退到自定义 Config 仅声明字段、把复杂初始化逻辑放到 __post_init__ 中，避免在 __init__ 内覆盖父类行为。

验证方法

升级并改写自定义 Config 后，重新实例化该 Config 并确认不会抛出 dataclass 或严格校验相关错误；再把它传入对应的模型类，确认模型能正常加载。如果之前使用了装饰器包装方案，移除后应能正常导入和实例化。最终以 v5.4.0 中 PreTrainedConfig 的 dataclass 行为为基准进行验证。