whosellm 0.2.4__tar.gz → 0.2.6__tar.gz

{whosellm-0.2.4 → whosellm-0.2.6}/.bumpversion.toml

@@ -2,7 +2,7 @@
 # 文档 / Documentation: https://callowayproject.github.io/bump-my-version/
 
 [tool.bumpversion]
-current_version = "0.2.4"
+current_version = "0.2.6"
 parse = """(?x)
     (?P<major>0|[1-9]\\d*)\\.
     (?P<minor>0|[1-9]\\d*)\\.

{whosellm-0.2.4 → whosellm-0.2.6}/.claude/skills/review-provider-model/providers/gemini.md

@@ -63,3 +63,12 @@ description: Google Gemini 模型信息采集指南
 - `supports_file_search` 和 `supports_code_interpreter` 并非所有变体都支持，flash-lite 和 2.0 系列通常不支持 code_interpreter
 - 大部分 Gemini 模型的 `context_window` 为 `1048576`（1M tokens），但特殊变体例外
 - `supports_web_search` 在 2.0 flash 及以上版本可用，2.0 flash-lite 不支持
+
+## 采集经验（2026-08-20 更新）
+
+- **3.1 及以后的官方 ID 一律用点号**：`gemini-3.1-pro-preview`、`gemini-3.5-flash` 等。曾误注册短横线 `gemini-3-1-pro-preview`，导致真实 ID 走泛型 pattern、variant 解析错误
+- **弃用时间线看 `deprecations` 页**：`https://ai.google.dev/gemini-api/docs/deprecations` 有每个模型的发布日期、关停日期、推荐替代品，比模型列表页信息更全
+- **部分模型详情页没有规格卡**（如 gemini-3.1-flash-lite、gemini-3.1-flash-live-preview）。Live API 模型的上下文上限在 `live-api/capabilities` 页（原生音频输出模型 128k）；其余可参照官方指定的迁移源模型规格，并在配置注释中说明数据来源
+- **模型详情页与总览页的 model code 可能不一致**（如 gemini-omni-flash vs gemini-omni-flash-preview），两个都收录进 patterns
+- `capabilities.py` 的默认值中 `supports_structured_outputs/Json_outputs/streaming` 默认 True，受限模型（image/TTS/live 特化版）必须显式置 False
+- 特化端点别名也应收录：如 `gemini-3.1-pro-preview-customtools`

{whosellm-0.2.4 → whosellm-0.2.6}/CHANGELOG.md

@@ -2,6 +2,11 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.2.4] - Unreleased
+
+### Added
+- 新增 Claude 5 代模型配置（官方规格核实）：`claude-sonnet-5`（2026-06-30 GA，$2/$10）、`claude-opus-5`（2026-07-24 GA，$5/$25）。两者均 1M 上下文（默认且最大）、128K 最大输出、自适应思考默认开启（映射 `supports_thinking=True`），支持结构化输出 + computer use。版本 5.0 高于 4.8/4.6（如 `claude-opus-5 > claude-opus-4-8`），同版本下变体优先级维持 `mythos > fable > opus > sonnet`
+
 ## [0.2.3] - Unreleased
 
 ### Added

{whosellm-0.2.4 → whosellm-0.2.6}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: whosellm
-Version: 0.2.4
+Version: 0.2.6
 Summary: A unified LLM model version and capability management library
 Author-email: JQQ <jqq1716@gmail.com>
 License: MIT

{whosellm-0.2.4 → whosellm-0.2.6}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "whosellm"
-version = "0.2.4"
+version = "0.2.6"
 description = "A unified LLM model version and capability management library"
 authors = [
     {name = "JQQ", email = "jqq1716@gmail.com"}

{whosellm-0.2.4 → whosellm-0.2.6}/tests/e2e/test_anthropic.py

@@ -1,7 +1,7 @@
 """Anthropic E2E 元数据测试。
 
 来源: https://platform.claude.com/docs/en/docs/about-claude/models
-采集日期: 2026-04-12
+采集日期: 2026-04-12（2026-09-04 增补 Fable 5.1 / Mythos 5.1）
 """
 
 import pytest
@@ -11,7 +11,50 @@ from whosellm import ModelFamily, Provider
 from .conftest import assert_model_metadata
 
 # ============================================================================
-# Claude Family — Latest (version 4.6)
+# Claude Family — Version 5.1 (2026-09-01 发布 / Released 2026-09-01)
+# 来源: https://platform.claude.com/docs/en/models/fable-5-1/overview
+# ============================================================================
+
+CLAUDE_51_MODELS = [
+    (
+        "claude-fable-5-1",
+        {
+            "provider": Provider.ANTHROPIC,
+            "family": ModelFamily.CLAUDE,
+            "version": "5.1",
+            "variant": "fable",
+            "supports_thinking": True,
+            "supports_vision": True,
+            "supports_streaming": True,
+            "supports_function_calling": True,
+            "supports_structured_outputs": True,
+            "supports_computer_use": True,
+            "context_window": 1_000_000,
+            "max_tokens": 128_000,
+        },
+    ),
+    (
+        "claude-mythos-5-1",
+        {
+            # Glasswing 受邀版，与 Fable 5.1 同规格 / Glasswing invite-only, same specs as Fable 5.1
+            "provider": Provider.ANTHROPIC,
+            "family": ModelFamily.CLAUDE,
+            "version": "5.1",
+            "variant": "mythos",
+            "supports_thinking": True,
+            "supports_vision": True,
+            "supports_streaming": True,
+            "supports_function_calling": True,
+            "supports_structured_outputs": True,
+            "supports_computer_use": True,
+            "context_window": 1_000_000,
+            "max_tokens": 128_000,
+        },
+    ),
+]
+
+# ============================================================================
+# Claude Family — Version 4.6
 # 来源: https://platform.claude.com/docs/en/docs/about-claude/models/overview
 # ============================================================================
 
@@ -190,7 +233,7 @@ CLAUDE_30_MODELS = [
 # 聚合 + 参数化
 # ============================================================================
 
-ALL_MODELS = CLAUDE_LATEST_MODELS + CLAUDE_45_MODELS + CLAUDE_41_MODELS + CLAUDE_40_MODELS + CLAUDE_30_MODELS
+ALL_MODELS = CLAUDE_51_MODELS + CLAUDE_LATEST_MODELS + CLAUDE_45_MODELS + CLAUDE_41_MODELS + CLAUDE_40_MODELS + CLAUDE_30_MODELS
 
 
 @pytest.mark.e2e

whosellm-0.2.6/tests/e2e/test_google.py

@@ -0,0 +1,458 @@
+"""Google E2E 元数据测试。
+
+来源: https://ai.google.dev/gemini-api/docs/models
+采集日期: 2026-04-12（2026-08-20 增补 3.5/3.6/3.7 Flash、Nano Banana 2 系列、Live/TTS 等新模型）
+"""
+
+import pytest
+
+from whosellm import ModelFamily, Provider
+
+from .conftest import assert_model_metadata
+
+# ============================================================================
+# Gemini Family — Version 3.x (Preview)
+# 来源: https://ai.google.dev/gemini-api/docs/gemini-3
+# ============================================================================
+
+GEMINI_3X_MODELS = [
+    (
+        "gemini-3.1-pro-preview",
+        {
+            "provider": Provider.GOOGLE,
+            "family": ModelFamily.GEMINI,
+            "version": "3.1",
+            "variant": "pro",
+            "supports_thinking": True,
+            "supports_vision": True,
+            "supports_audio": True,
+            "supports_video": True,
+            "supports_streaming": True,
+            "supports_function_calling": True,
+            "supports_structured_outputs": True,
+            "context_window": 1_048_576,
+            "max_tokens": 65_536,
+        },
+    ),
+    (
+        "gemini-3-flash-preview",
+        {
+            "provider": Provider.GOOGLE,
+            "family": ModelFamily.GEMINI,
+            "version": "3.0",
+            "variant": "flash",
+            "supports_thinking": True,
+            "supports_vision": True,
+            "supports_audio": True,
+            "supports_video": True,
+            "supports_streaming": True,
+            "supports_function_calling": True,
+            "supports_structured_outputs": True,
+            "context_window": 1_048_576,
+            "max_tokens": 65_536,
+        },
+    ),
+    (
+        "gemini-3.1-flash-lite-preview",
+        {
+            "provider": Provider.GOOGLE,
+            "family": ModelFamily.GEMINI,
+            "version": "3.1",
+            "variant": "flash-lite",
+            "supports_thinking": True,
+            "supports_vision": True,
+            "supports_audio": True,
+            "supports_video": True,
+            "supports_streaming": True,
+            "supports_function_calling": True,
+            "supports_structured_outputs": True,
+            "context_window": 1_048_576,
+            "max_tokens": 65_536,
+        },
+    ),
+    (
+        # NOTE: 官方文档标注 thinking=Supported，但实测 image-preview 模型开启
+        # thinking 存在问题，因此保持 False。
+        "gemini-3-pro-image-preview",
+        {
+            "provider": Provider.GOOGLE,
+            "family": ModelFamily.GEMINI,
+            "version": "3.0",
+            "variant": "pro-image",
+            "supports_thinking": False,
+            "supports_vision": True,
+            "supports_audio": False,
+            "supports_video": False,
+            "supports_streaming": True,
+            "supports_function_calling": False,
+            "supports_structured_outputs": True,
+            "supports_image_generation": True,
+            "context_window": 65_536,
+            "max_tokens": 32_768,
+        },
+    ),
+]
+
+# ============================================================================
+# Gemini Family — 2026-08/09 新增（GA Flash 主线 / Nano Banana 2 / Live / TTS / Transcribe）
+# 来源: https://ai.google.dev/gemini-api/docs/models/gemini-3.7-flash 等（2026-08-20 采集）
+#       https://ai.google.dev/gemini-api/docs/models/gemini-3.8-flash（2026-09-04 采集 3.8/transcribe/omni-1.1）
+# ============================================================================
+
+GEMINI_2026_NEW_MODELS = [
+    (
+        "gemini-3.8-flash",
+        {
+            "provider": Provider.GOOGLE,
+            "family": ModelFamily.GEMINI,
+            "version": "3.8",
+            "variant": "flash",
+            "supports_thinking": True,
+            "supports_vision": True,
+            "supports_audio": True,
+            "supports_video": True,
+            "supports_streaming": True,
+            "supports_function_calling": True,
+            "supports_structured_outputs": True,
+            "context_window": 1_048_576,
+            "max_tokens": 65_536,
+        },
+    ),
+    (
+        "gemini-3.7-flash",
+        {
+            "provider": Provider.GOOGLE,
+            "family": ModelFamily.GEMINI,
+            "version": "3.7",
+            "variant": "flash",
+            "supports_thinking": True,
+            "supports_vision": True,
+            "supports_audio": True,
+            "supports_video": True,
+            "supports_streaming": True,
+            "supports_function_calling": True,
+            "supports_structured_outputs": True,
+            "context_window": 1_048_576,
+            "max_tokens": 65_536,
+        },
+    ),
+    (
+        "gemini-3.6-flash",
+        {
+            "provider": Provider.GOOGLE,
+            "family": ModelFamily.GEMINI,
+            "version": "3.6",
+            "variant": "flash",
+            "supports_thinking": True,
+            "supports_vision": True,
+            "supports_audio": True,
+            "supports_video": True,
+            "supports_streaming": True,
+            "supports_function_calling": True,
+            "supports_structured_outputs": True,
+            "context_window": 1_048_576,
+            "max_tokens": 65_536,
+        },
+    ),
+    (
+        "gemini-3.5-flash",
+        {
+            "provider": Provider.GOOGLE,
+            "family": ModelFamily.GEMINI,
+            "version": "3.5",
+            "variant": "flash",
+            "supports_thinking": True,
+            "supports_vision": True,
+            "supports_audio": True,
+            "supports_video": True,
+            "supports_streaming": True,
+            "supports_function_calling": True,
+            "supports_structured_outputs": True,
+            "context_window": 1_048_576,
+            "max_tokens": 65_536,
+        },
+    ),
+    (
+        "gemini-3.5-flash-lite",
+        {
+            "provider": Provider.GOOGLE,
+            "family": ModelFamily.GEMINI,
+            "version": "3.5",
+            "variant": "flash-lite",
+            "supports_thinking": True,
+            "supports_vision": True,
+            "supports_audio": True,
+            "supports_video": True,
+            "supports_streaming": True,
+            "supports_function_calling": True,
+            "supports_structured_outputs": True,
+            "context_window": 1_048_576,
+            "max_tokens": 65_536,
+        },
+    ),
+    (
+        "gemini-3.1-flash-lite",
+        {
+            "provider": Provider.GOOGLE,
+            "family": ModelFamily.GEMINI,
+            "version": "3.1",
+            "variant": "flash-lite",
+            "supports_thinking": True,
+            "supports_vision": True,
+            "supports_audio": True,
+            "supports_video": True,
+            "supports_streaming": True,
+            "supports_function_calling": True,
+            "supports_structured_outputs": True,
+            "context_window": 1_048_576,
+            "max_tokens": 65_536,
+        },
+    ),
+    (
+        # Nano Banana 2：官方卡片 thinking=Supported，但接口不支持配置 thinking 行为，按家族惯例置 False
+        "gemini-3.1-flash-image",
+        {
+            "provider": Provider.GOOGLE,
+            "family": ModelFamily.GEMINI,
+            "version": "3.1",
+            "variant": "flash-image",
+            "supports_thinking": False,
+            "supports_vision": True,
+            "supports_audio": False,
+            "supports_streaming": True,
+            "supports_function_calling": False,
+            "supports_structured_outputs": False,
+            "supports_image_generation": True,
+            "context_window": 131_072,
+            "max_tokens": 32_768,
+        },
+    ),
+    (
+        "gemini-3.1-flash-lite-image",
+        {
+            "provider": Provider.GOOGLE,
+            "family": ModelFamily.GEMINI,
+            "version": "3.1",
+            "variant": "flash-lite-image",
+            "supports_thinking": False,
+            "supports_vision": True,
+            "supports_audio": False,
+            "supports_streaming": True,
+            "supports_function_calling": True,
+            "supports_structured_outputs": False,
+            "supports_image_generation": True,
+            "context_window": 65_536,
+            "max_tokens": 4_096,
+        },
+    ),
+    (
+        # Nano Banana Pro（GA）
+        "gemini-3-pro-image",
+        {
+            "provider": Provider.GOOGLE,
+            "family": ModelFamily.GEMINI,
+            "version": "3.0",
+            "variant": "pro-image",
+            "supports_thinking": False,
+            "supports_vision": True,
+            "supports_audio": False,
+            "supports_streaming": True,
+            "supports_function_calling": False,
+            "supports_structured_outputs": False,
+            "supports_image_generation": True,
+            "context_window": 65_536,
+            "max_tokens": 32_768,
+        },
+    ),
+    (
+        # 官方详情页未附规格卡：ctx 取 Live API 原生音频模型约束 128k，max 参照迁移源 12-2025
+        "gemini-3.1-flash-live-preview",
+        {
+            "provider": Provider.GOOGLE,
+            "family": ModelFamily.GEMINI,
+            "version": "3.1",
+            "variant": "flash-live",
+            "supports_thinking": True,
+            "supports_audio": True,
+            "supports_video": True,
+            "supports_streaming": True,
+            "supports_function_calling": True,
+            "supports_audio_generation": True,
+            "context_window": 131_072,
+            "max_tokens": 8_192,
+        },
+    ),
+    (
+        "gemini-3.1-flash-tts-preview",
+        {
+            "provider": Provider.GOOGLE,
+            "family": ModelFamily.GEMINI,
+            "version": "3.1",
+            "variant": "flash-tts",
+            "supports_thinking": False,
+            "supports_vision": False,
+            "supports_audio": False,
+            "supports_streaming": True,
+            "supports_structured_outputs": False,
+            "supports_audio_generation": True,
+            "context_window": 8_192,
+            "max_tokens": 16_384,
+        },
+    ),
+    (
+        # 官方无 token 上限说明（按音频时长限制）；live 端点走 Live API
+        "gemini-3.5-transcribe",
+        {
+            "provider": Provider.GOOGLE,
+            "family": ModelFamily.GEMINI,
+            "version": "3.5",
+            "variant": "transcribe",
+            "supports_audio": True,
+            "supports_thinking": False,
+            "supports_function_calling": False,
+            "supports_streaming": True,
+            "supports_structured_outputs": False,
+        },
+    ),
+    (
+        "gemini-omni-1.1-flash",
+        {
+            "provider": Provider.GOOGLE,
+            "family": ModelFamily.GEMINI,
+            "version": "3.0",
+            "variant": "omni-flash",
+            "supports_vision": True,
+            "supports_video": True,
+            "supports_thinking": False,
+            "supports_streaming": True,
+            "supports_structured_outputs": False,
+            "context_window": 1_048_576,
+        },
+    ),
+]
+
+# ============================================================================
+# Gemini Family — Version 2.5 (Stable)
+# 来源: https://ai.google.dev/gemini-api/docs/models/gemini-2.5-flash
+#        https://ai.google.dev/gemini-api/docs/models/gemini-2.5-pro
+#        https://ai.google.dev/gemini-api/docs/models/gemini-2.5-flash-lite
+# ============================================================================
+
+GEMINI_25_MODELS = [
+    (
+        "gemini-2.5-pro",
+        {
+            "provider": Provider.GOOGLE,
+            "family": ModelFamily.GEMINI,
+            "version": "2.5",
+            "variant": "pro",
+            "supports_thinking": True,
+            "supports_vision": True,
+            "supports_audio": True,
+            "supports_video": True,
+            "supports_streaming": True,
+            "supports_function_calling": True,
+            "supports_structured_outputs": True,
+            "context_window": 1_048_576,
+            "max_tokens": 65_536,
+        },
+    ),
+    (
+        "gemini-2.5-flash",
+        {
+            "provider": Provider.GOOGLE,
+            "family": ModelFamily.GEMINI,
+            "version": "2.5",
+            "variant": "flash",
+            "supports_thinking": True,
+            "supports_vision": True,
+            "supports_audio": True,
+            "supports_video": True,
+            "supports_streaming": True,
+            "supports_function_calling": True,
+            "supports_structured_outputs": True,
+            "context_window": 1_048_576,
+            "max_tokens": 65_536,
+        },
+    ),
+    (
+        "gemini-2.5-flash-lite",
+        {
+            "provider": Provider.GOOGLE,
+            "family": ModelFamily.GEMINI,
+            "version": "2.5",
+            "variant": "flash-lite",
+            "supports_thinking": True,
+            "supports_vision": True,
+            "supports_audio": True,
+            "supports_video": True,
+            "supports_streaming": True,
+            "supports_function_calling": True,
+            "supports_structured_outputs": True,
+            "context_window": 1_048_576,
+            "max_tokens": 65_536,
+        },
+    ),
+]
+
+# ============================================================================
+# Gemini Family — Version 2.0 (Deprecated)
+# 来源: https://ai.google.dev/gemini-api/docs/models/gemini-2.0-flash
+#        https://ai.google.dev/gemini-api/docs/models/gemini-2.0-flash-lite
+# ============================================================================
+
+GEMINI_20_MODELS = [
+    (
+        "gemini-2.0-flash",
+        {
+            "provider": Provider.GOOGLE,
+            "family": ModelFamily.GEMINI,
+            "version": "2.0",
+            "variant": "flash",
+            "supports_thinking": True,
+            "supports_vision": True,
+            "supports_audio": True,
+            "supports_video": True,
+            "supports_streaming": True,
+            "supports_function_calling": True,
+            "supports_structured_outputs": True,
+            "context_window": 1_048_576,
+            "max_tokens": 8_192,
+        },
+    ),
+    (
+        "gemini-2.0-flash-lite",
+        {
+            "provider": Provider.GOOGLE,
+            "family": ModelFamily.GEMINI,
+            "version": "2.0",
+            "variant": "flash-lite",
+            "supports_thinking": False,
+            "supports_vision": True,
+            "supports_audio": True,
+            "supports_video": True,
+            "supports_streaming": True,
+            "supports_function_calling": True,
+            "supports_structured_outputs": True,
+            "context_window": 1_048_576,
+            "max_tokens": 8_192,
+        },
+    ),
+]
+
+# ============================================================================
+# 聚合 + 参数化
+# ============================================================================
+
+ALL_MODELS = GEMINI_3X_MODELS + GEMINI_2026_NEW_MODELS + GEMINI_25_MODELS + GEMINI_20_MODELS
+
+
+@pytest.mark.e2e
+@pytest.mark.parametrize(
+    "model_name,expected",
+    ALL_MODELS,
+    ids=[m[0] for m in ALL_MODELS],
+)
+def test_model_metadata(model_name: str, expected: dict) -> None:  # type: ignore[type-arg]
+    """验证 Google 模型元数据与官方文档一致。"""
+    assert_model_metadata(model_name, expected)