whosellm 0.2.3__tar.gz → 0.2.5__tar.gz

{whosellm-0.2.3 → whosellm-0.2.5}/.bumpversion.toml

@@ -2,7 +2,7 @@
 # 文档 / Documentation: https://callowayproject.github.io/bump-my-version/
 
 [tool.bumpversion]
-current_version = "0.2.3"
+current_version = "0.2.5"
 parse = """(?x)
     (?P<major>0|[1-9]\\d*)\\.
     (?P<minor>0|[1-9]\\d*)\\.
@@ -45,6 +45,12 @@ filename = "whosellm/__init__.py"
 search = "__version__ = \"{current_version}\""
 replace = "__version__ = \"{new_version}\""
 
+# uv.lock 中项目自身的版本号（锚定到 whosellm 包块，避免误改其他依赖的 version）
+[[tool.bumpversion.files]]
+filename = "uv.lock"
+search = "name = \"whosellm\"\nversion = \"{current_version}\""
+replace = "name = \"whosellm\"\nversion = \"{new_version}\""
+
 [tool.bumpversion.parts.pre_l]
 values = ["a", "b", "rc"]
 

{whosellm-0.2.3 → whosellm-0.2.5}/.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.3 → whosellm-0.2.5}/CHANGELOG.md

@@ -2,9 +2,15 @@
 
 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
+- 新增 Claude Mythos-class 模型配置（2026-06-09 发布，官方规格核实）：`claude-fable-5`（公开版）、`claude-mythos-5`（Project Glasswing 受邀版，能力同 Fable 5）。均为 1M 上下文、128K 最大输出、结构化输出 + computer use，自适应思考常开。引入全新顶级变体层级，优先级高于 opus（`haiku=0 < sonnet=3 < opus=5 < fable=6 < mythos=7`），因此 `claude-fable-5 > claude-opus-4-8`（版本 5.0 > 4.8）。新增父模式 `claude-{variant}-{major}@{snapshot}` 以支持单版本号模型的 `@` 日期快照形式
 - 新增 Claude Opus 4.x 模型配置（官方规格核实）：`claude-opus-4-8`、`claude-opus-4-7`（1M 上下文，128K 最大输出，结构化输出 + computer use）、`claude-opus-4-5`（200K 上下文，64K 最大输出）
 
 ### Fixed

{whosellm-0.2.3 → whosellm-0.2.5}/PKG-INFO

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

{whosellm-0.2.3 → whosellm-0.2.5}/pyproject.toml

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

{whosellm-0.2.3 → whosellm-0.2.5}/tests/e2e/test_google.py

@@ -1,7 +1,7 @@
 """Google E2E 元数据测试。
 
 来源: https://ai.google.dev/gemini-api/docs/models
-采集日期: 2026-04-12
+采集日期: 2026-04-12（2026-08-20 增补 3.5/3.6/3.7 Flash、Nano Banana 2 系列、Live/TTS 等新模型）
 """
 
 import pytest
@@ -17,7 +17,7 @@ from .conftest import assert_model_metadata
 
 GEMINI_3X_MODELS = [
     (
-        "gemini-3-1-pro-preview",
+        "gemini-3.1-pro-preview",
         {
             "provider": Provider.GOOGLE,
             "family": ModelFamily.GEMINI,
@@ -53,7 +53,7 @@ GEMINI_3X_MODELS = [
         },
     ),
     (
-        "gemini-3-1-flash-lite-preview",
+        "gemini-3.1-flash-lite-preview",
         {
             "provider": Provider.GOOGLE,
             "family": ModelFamily.GEMINI,
@@ -93,6 +93,195 @@ GEMINI_3X_MODELS = [
     ),
 ]
 
+# ============================================================================
+# Gemini Family — 2026-08 新增（GA Flash 主线 / Nano Banana 2 / Live / TTS）
+# 来源: https://ai.google.dev/gemini-api/docs/models/gemini-3.7-flash 等（2026-08-20 采集）
+# ============================================================================
+
+GEMINI_2026_NEW_MODELS = [
+    (
+        "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,
+        },
+    ),
+]
+
 # ============================================================================
 # Gemini Family — Version 2.5 (Stable)
 # 来源: https://ai.google.dev/gemini-api/docs/models/gemini-2.5-flash
@@ -206,7 +395,7 @@ GEMINI_20_MODELS = [
 # 聚合 + 参数化
 # ============================================================================
 
-ALL_MODELS = GEMINI_3X_MODELS + GEMINI_25_MODELS + GEMINI_20_MODELS
+ALL_MODELS = GEMINI_3X_MODELS + GEMINI_2026_NEW_MODELS + GEMINI_25_MODELS + GEMINI_20_MODELS
 
 
 @pytest.mark.e2e

{whosellm-0.2.3 → whosellm-0.2.5}/tests/e2e/test_openai.py

@@ -11,8 +11,9 @@ from whosellm import ModelFamily, Provider
 from .conftest import assert_model_metadata
 
 # ============================================================================
-# GPT Family (latest: 5.4)
-# 来源: https://developers.openai.com/api/docs/models/gpt-5.4
+# GPT Family (latest: 5.6)
+# 来源: https://developers.openai.com/api/docs/models/gpt-5.4（2026-04-12 采集）
+#       https://developers.openai.com/api/docs/models/gpt-5.6-sol（2026-08-20 采集 5.5/5.6）
 # ============================================================================
 
 GPT_MODELS = [
@@ -85,6 +86,119 @@ GPT_MODELS = [
             "max_tokens": 128_000,
         },
     ),
+    # ------------------------------------------------------------------
+    # GPT-5.5 系列（2026-08-20 采集）
+    # 来源: https://developers.openai.com/api/docs/models/gpt-5.5
+    # ------------------------------------------------------------------
+    (
+        "gpt-5.5",
+        {
+            "provider": Provider.OPENAI,
+            "family": ModelFamily.GPT,
+            "version": "5.5",
+            "variant": "base",
+            "supports_thinking": True,
+            "supports_vision": True,
+            "supports_streaming": True,
+            "supports_function_calling": True,
+            "supports_structured_outputs": True,
+            "supports_computer_use": True,
+            "context_window": 1_050_000,
+            "max_tokens": 128_000,
+        },
+    ),
+    (
+        "gpt-5.5-pro",
+        {
+            # 仅 Responses API（含 Batch），不支持 Chat Completions 与 streaming
+            "provider": Provider.OPENAI,
+            "family": ModelFamily.GPT,
+            "version": "5.5",
+            "variant": "pro",
+            "supports_thinking": True,
+            "supports_vision": True,
+            "supports_streaming": False,
+            "supports_function_calling": True,
+            "supports_structured_outputs": True,
+            "supports_code_interpreter": True,
+            "supports_computer_use": False,
+            "context_window": 1_050_000,
+            "max_tokens": 128_000,
+        },
+    ),
+    # ------------------------------------------------------------------
+    # GPT-5.6 天体档位系列（2026-08-20 采集）
+    # sol≈无后缀档 / terra≈mini / luna≈nano，三档能力一致
+    # 来源: https://developers.openai.com/api/docs/models/gpt-5.6-sol
+    # ------------------------------------------------------------------
+    (
+        "gpt-5.6",
+        {
+            "provider": Provider.OPENAI,
+            "family": ModelFamily.GPT,
+            "version": "5.6",
+            "variant": "base",
+            "supports_thinking": True,
+            "supports_vision": True,
+            "supports_streaming": True,
+            "supports_function_calling": True,
+            "supports_structured_outputs": True,
+            "supports_computer_use": True,
+            "context_window": 1_050_000,
+            "max_tokens": 128_000,
+        },
+    ),
+    (
+        "gpt-5.6-sol",
+        {
+            "provider": Provider.OPENAI,
+            "family": ModelFamily.GPT,
+            "version": "5.6",
+            "variant": "sol",
+            "supports_thinking": True,
+            "supports_vision": True,
+            "supports_streaming": True,
+            "supports_function_calling": True,
+            "supports_structured_outputs": True,
+            "supports_computer_use": True,
+            "context_window": 1_050_000,
+            "max_tokens": 128_000,
+        },
+    ),
+    (
+        "gpt-5.6-terra",
+        {
+            "provider": Provider.OPENAI,
+            "family": ModelFamily.GPT,
+            "version": "5.6",
+            "variant": "terra",
+            "supports_thinking": True,
+            "supports_vision": True,
+            "supports_streaming": True,
+            "supports_function_calling": True,
+            "supports_structured_outputs": True,
+            "supports_computer_use": True,
+            "context_window": 1_050_000,
+            "max_tokens": 128_000,
+        },
+    ),
+    (
+        "gpt-5.6-luna",
+        {
+            "provider": Provider.OPENAI,
+            "family": ModelFamily.GPT,
+            "version": "5.6",
+            "variant": "luna",
+            "supports_thinking": True,
+            "supports_vision": True,
+            "supports_streaming": True,
+            "supports_function_calling": True,
+            "supports_structured_outputs": True,
+            "supports_computer_use": True,
+            "context_window": 1_050_000,
+            "max_tokens": 128_000,
+        },
+    ),
 ]
 
 # ============================================================================