ClassyGitShadowzzh

config.py

config.py
"""
实验 8-6 配置模块:统一读取 API Key、构造 OpenAI 客户端。

支持以下 OpenAI 兼容服务(按 PROVIDER 选择):
- openai   (默认,读 OPENAI_API_KEY,默认模型 gpt-5.6-luna)
- moonshot (读 MOONSHOT_API_KEY,Kimi,默认 kimi-k3)
- ark      (读 ARK_API_KEY,火山方舟)

统一的 OpenRouter 兜底(fallback):
    若所选 provider 自己的 Key 缺失,但设置了 OPENROUTER_API_KEY,则自动改走
    OpenRouter(https://openrouter.ai/api/v1),并把模型名映射到 OpenRouter 命名:
        gpt-*     -> openai/gpt-*
        claude-*  -> anthropic/claude-opus-4.8
        含 "/"    -> 原样透传
        其它      -> openai/gpt-5.6-luna
    这样在没有 OpenAI 直连 Key 时也能一键跑通。
"""

import os
from typing import Optional

from dotenv import load_dotenv
from openai import OpenAI

load_dotenv()

OPENROUTER_BASE_URL = "https://openrouter.ai/api/v1"


# 各 provider 的 base_url 与默认模型
_PROVIDERS = {
    "openai": {
        "key_env": "OPENAI_API_KEY",
        "base_url": None,  # OpenAI 官方默认地址
        "default_model": "gpt-5.6-luna",
    },
    "moonshot": {
        "key_env": "MOONSHOT_API_KEY",
        "base_url": "https://api.moonshot.cn/v1",
        "default_model": "kimi-k3",
    },
    "ark": {
        "key_env": "ARK_API_KEY",
        "base_url": "https://ark.cn-beijing.volces.com/api/v3",
        "default_model": "doubao-seed-1-6-250615",
    },
}


def _to_openrouter_model(model: str) -> str:
    """把常见模型名映射到 OpenRouter 命名空间。"""
    if not model:
        return "openai/gpt-5.6-luna"
    if "/" in model:
        return model
    if model.startswith("gpt-"):
        return "openai/" + model
    if model.startswith("claude-"):
        return "anthropic/claude-opus-4.8"
    return "openai/gpt-5.6-luna"


class Config:
    # 被测 Agent(工具创造)默认模型
    PROVIDER: str = os.getenv("PROVIDER", "openai").lower()
    AGENT_MODEL: str = os.getenv("AGENT_MODEL", "gpt-5.6-luna")
    # LLM-as-a-Judge 使用的模型(第 3 层工具创造质量打分)
    JUDGE_MODEL: str = os.getenv("JUDGE_MODEL", "gpt-5.6-luna")
    TEMPERATURE: float = float(os.getenv("TEMPERATURE", "0.2"))

    @classmethod
    def provider_meta(cls) -> dict:
        if cls.PROVIDER not in _PROVIDERS:
            raise ValueError(
                f"未知 PROVIDER={cls.PROVIDER},可选:{list(_PROVIDERS)}"
            )
        return _PROVIDERS[cls.PROVIDER]

    @classmethod
    def _use_openrouter(cls) -> bool:
        """所选 provider 的 Key 缺失、但有 OPENROUTER_API_KEY 时,走 OpenRouter 兜底。"""
        meta = cls.provider_meta()
        return (not os.getenv(meta["key_env"])) and bool(os.getenv("OPENROUTER_API_KEY"))

    @classmethod
    def map_model(cls, model: str) -> str:
        """在 OpenRouter 兜底路径下,把模型名映射到 OpenRouter 命名;否则原样返回。"""
        return _to_openrouter_model(model) if cls._use_openrouter() else model

    @classmethod
    def get_client(cls) -> OpenAI:
        """构造并返回 OpenAI 兼容客户端(优先直连,缺 Key 时走 OpenRouter 兜底)。"""
        meta = cls.provider_meta()
        if cls._use_openrouter():
            return OpenAI(
                api_key=os.getenv("OPENROUTER_API_KEY"),
                base_url=OPENROUTER_BASE_URL,
            )
        api_key = os.getenv(meta["key_env"], "")
        if not api_key:
            raise RuntimeError(
                f"未找到 {meta['key_env']},也未设置 OPENROUTER_API_KEY。"
                f"请在 .env 中配置其一(OpenRouter 可作为统一兜底)。"
            )
        kwargs = {"api_key": api_key}
        if meta["base_url"]:
            kwargs["base_url"] = meta["base_url"]
        return OpenAI(**kwargs)

    @classmethod
    def resolve_default_model(cls, override: Optional[str] = None) -> str:
        """解析被测 Agent 的模型:处理 provider 默认回退与 OpenRouter 命名映射。"""
        meta = cls.provider_meta()
        model = override or cls.AGENT_MODEL
        # 非 openai provider 下若仍是 gpt-* 默认值,则回退到该 provider 的默认模型
        if not override and cls.PROVIDER != "openai" and model.startswith("gpt-"):
            model = meta["default_model"]
        return cls.map_model(model)