M2 — hyper_parallel/config/ 配置系统

提供 torchtitan 风格的 ConfigManager + tyro CLI + 通用 *Config dataclass；与现存 trainer/config.py:HyperTrainerConfig 字段建立双向映射。新 / 旧两条入口并存，旧 yaml 路径 0 改动。

1. 目标

1. 提供新的 CLI 入口语法（--module qwen3_5_v2 --config qwen3_5_v2_4b --training.steps=10）。
2. 提供 torchtitan 风格的通用配置 dataclass（TrainingConfig / ParallelismConfig / ...）。
3. 通过 _legacy_to_trainer_config 把旧 yaml 字段映射到新结构，老用户脚本不破坏。

2. 任务边界（新增文件）

新增包目录 hyper_parallel/config/：

3. 字段对照表（旧 yaml ↔ 新 *Config）

旧字段来自 hyper_parallel/trainer/config.py，行号已标注。

转换函数 _legacy_to_trainer_config 必须双向 round-trip 等价（即 legacy → new → legacy 字段值不变，由 test_legacy_roundtrip.py 保障）。

4. 核心设计：ConfigManager.parse_args 双入口

class ConfigManager:
    def parse_args(self, argv: list[str] | None = None) -> "Configurable.Config":
        argv = argv if argv is not None else sys.argv[1:]

        # 1. 新风格：--module X --config Y [--field=value]
        if argv and argv[0].startswith("--module"):
            return self._parse_new(argv)

        # 2. 旧风格：yaml + dot-path（兼容现有 train_lm.py）
        return self._parse_legacy(argv)

    def _parse_new(self, argv):
        try:
            import tyro
        except ImportError as exc:
            raise ImportError(
                "New CLI requires `tyro`. Install with: pip install tyro"
            ) from exc
        install_tyro_rules()

        # 解析 --module / --config，从 config_registry 取 recipe
        head, remaining = _extract_module_config(argv)
        module_name, config_name = head["module"], head["config"]
        registry = importlib.import_module(
            f"hyper_parallel.models.{module_name}.config_registry"
        )
        default = getattr(registry, config_name)()    # HyperTrainer.Config 实例

        from hyper_parallel.trainer.trainer_config import HyperTrainer
        return tyro.cli(HyperTrainer.Config, args=remaining, default=default)

    def _parse_legacy(self, argv):
        from hyper_parallel.trainer.config import parse_args, HyperTrainerConfig
        from hyper_parallel.config.legacy_adapter import _legacy_to_trainer_config
        legacy = parse_args(HyperTrainerConfig)        # 现有 :547 逻辑
        return _legacy_to_trainer_config(legacy)

5. 与 torchtitan 接口差异说明

6. 开发步骤

1. Step 1（1 d）：configs.py —— 7 个 dataclass，按字段对照表逐项落地，写 __post_init__ 校验（如 local_batch_size > 0、tensor_parallel_degree >= 1）。
2. Step 2（0.5 d）：function.py + dtype_map.py。
3. Step 3（1 d）：manager.py 的双入口 + tyro_rules.py。
4. Step 4（0.5 d）：legacy_adapter.py。

7. 验证标准

新建 tests/torch/ut/config/：

通过门槛：

• 6 个 UT 全绿。
• 旧路径 parse_args(HyperTrainerConfig)（trainer/config.py:547）行为 0 改动。
• hyper_parallel.config 可独立 import；hyper_parallel/__init__.py 不导出。

8. 工期 & 依赖