"""在本机检查一页 Gemini REST 模型目录，按指定方法区分已列支持、未列支持、资料缺失。"""
import argparse
import json
from pathlib import Path
import sys

DEMO = {
    "models": [
        {"name": "models/demo-text", "supportedGenerationMethods": ["generateContent"]},
        {"name": "models/demo-vector", "supportedGenerationMethods": ["embedContent"]},
        {"name": "models/demo-unknown"},
    ],
    "nextPageToken": "demo-next",
}


def inspect_page(page, method):
    if not isinstance(page, dict) or "error" in page or not isinstance(page.get("models"), list):
        raise ValueError("需要 REST models.list 成功响应，顶层应有 models 数组。")
    token = page.get("nextPageToken", "")
    if not isinstance(token, str):
        raise ValueError("nextPageToken 应为字符串。")

    groups = {"已列支持": [], "未列支持": [], "资料缺失": []}
    for index, entry in enumerate(page["models"], 1):
        if not isinstance(entry, dict):
            raise ValueError(f"第 {index} 条模型记录应为对象。")
        name = entry.get("name")
        if not isinstance(name, str) or not name.startswith("models/") or not name[7:]:
            raise ValueError(f"第 {index} 条缺少 models/ 开头的资源名。")
        methods = entry.get("supportedGenerationMethods")
        if methods is None:
            group = "资料缺失"
        elif not isinstance(methods, list) or not all(isinstance(m, str) for m in methods):
            raise ValueError(f"第 {index} 条 supportedGenerationMethods 应为字符串数组。")
        else:
            group = "已列支持" if method in methods else "未列支持"
        groups[group].append(name)
    return {"方法": method, "本页条数": len(page["models"]), **groups, "还有下一页": bool(token)}


def main():
    parser = argparse.ArgumentParser(description=__doc__)
    inputs = parser.add_mutually_exclusive_group(required=True)
    inputs.add_argument("--demo", action="store_true", help="使用内置的三个虚构模型")
    inputs.add_argument("--file", type=Path, help="UTF-8 编码的一页 models.list 响应文件")
    parser.add_argument("--method", choices=["generateContent", "embedContent"], default="generateContent")
    args = parser.parse_args()
    try:
        page = DEMO if args.demo else json.loads(args.file.read_text(encoding="utf-8-sig"))
        print(json.dumps(inspect_page(page, args.method), ensure_ascii=False, indent=2))
    except (ValueError, OSError) as exc:
        print(f"无法核对：{exc}", file=sys.stderr)
        return 1
    return 0


if __name__ == "__main__":
    sys.exit(main())
