whosellm 0.2.2__tar.gz → 0.2.3__tar.gz

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

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

whosellm-0.2.3/.claude/settings.json

@@ -0,0 +1,5 @@
+{
+  "enabledPlugins": {
+    "turingfocus-toolkit@turingfocus-skills": true
+  }
+}

{whosellm-0.2.2 → whosellm-0.2.3}/CHANGELOG.md

@@ -2,6 +2,27 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.2.3] - Unreleased
+
+### Added
+- 新增 Claude Opus 4.x 模型配置（官方规格核实）：`claude-opus-4-8`、`claude-opus-4-7`（1M 上下文，128K 最大输出，结构化输出 + computer use）、`claude-opus-4-5`（200K 上下文，64K 最大输出）
+
+### Fixed
+- 修复 Claude 4.x 别名版本解析回退 bug：`claude-opus-4-5` / `4-7` / `4-8` 等**无日期别名**此前被 `claude-opus-4-{snapshot:8d}` 模式的"最大宽度"语义把单个数字 minor 误吞为 snapshot，导致版本回退为 `4.0`。改用精确 8 位的 `{snapshot:snapshot}` 自定义类型（`patterns._convert_snapshot`）后，单字段 snapshot 不再吞掉 minor，现存与未来未注册别名均能解析出正确版本（如 `4.8`），版本比较稳定可用
+
+## [0.2.2] - 2026-04-24
+
+### Added
+- DeepSeek V4 系列模型支持：`deepseek-v4-flash`、`deepseek-v4-pro`（1M 上下文，384K 最大输出，支持思考/非思考双模式）
+- DeepSeek 官方 Provider 支持版本号命名模式（`deepseek-v{major}.{minor}-{variant}` 等），V4 起可通过版本号直接调用
+- 腾讯云 DeepSeek-V3.2（GA 版，685B MoE，稀疏注意力）
+
+### Changed
+- `deepseek-chat` / `deepseek-reasoner` 能力基线升级为 V4-flash 非思考/思考模式别名（1M 上下文，384K 输出）
+
+### Fixed
+- 腾讯云 `deepseek-r1-0528` 的 `supports_function_calling` 修正为 `False`（官方文档明确列为不支持）
+
 ## [Unreleased]
 
 ### Added

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

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

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

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

whosellm-0.2.3/tests/test_claude_4x_versions.py

@@ -0,0 +1,124 @@
+# filename: test_claude_4x_versions.py
+"""
+回归测试：Claude 4.x 别名版本解析 + 版本比较稳定性
+Regression tests: Claude 4.x alias version parsing + version-comparison stability
+
+背景 / Context:
+    TFRobotV2 需要门控 Claude 4.6+ 移除的 assistant prefill。决定**用版本比较**判断
+    （`family == CLAUDE and parse_version(version) >= (4, 6)`），而非依赖能力位。
+    因此 whosellm 必须保证 4.x 别名（含未注册的新别名）版本解析正确、比较稳定。
+
+    根因：parse 的 ``{snapshot:8d}`` 是最大宽度，会把 ``claude-opus-4-5`` 的 ``5`` 当 snapshot，
+    使 minor 被吞、版本回退 4.0。修复后通过精确 8 位 snapshot 自定义类型解决。
+"""
+
+import pytest
+
+from whosellm import LLMeta
+from whosellm.models.base import ModelFamily, parse_version
+
+# 官方 prefill 真值表（platform.claude.com，逐字核实）：不支持 prefill 的恰为版本 >= 4.6
+# Authoritative prefill truth table: models WITHOUT prefill are exactly version >= 4.6
+_PREFILL_REMOVED = {
+    "claude-opus-4-8",
+    "claude-opus-4-7",
+    "claude-opus-4-6",
+    "claude-sonnet-4-6",
+}
+_PREFILL_SUPPORTED = {
+    "claude-opus-4-5",
+    "claude-opus-4-1",
+    "claude-opus-4-0",
+    "claude-sonnet-4-5",
+    "claude-sonnet-4-0",
+    "claude-haiku-4-5",
+    "claude-3-7-sonnet",
+    "claude-3-5-haiku",
+}
+
+
+class TestClaude4xAliasVersionParsing:
+    """未注册/新增的 Claude 4.x 别名应解析出正确版本，而非回退 family 默认 4.0"""
+
+    @pytest.mark.parametrize(
+        "model_name,expected_version,expected_variant",
+        [
+            ("claude-opus-4-8", "4.8", "opus"),
+            ("claude-opus-4-7", "4.7", "opus"),
+            ("claude-opus-4-6", "4.6", "opus"),
+            ("claude-opus-4-5", "4.5", "opus"),
+            ("claude-opus-4-5-20251101", "4.5", "opus"),
+            ("claude-haiku-4-5-20251001", "4.5", "haiku"),
+            ("claude-sonnet-4-6", "4.6", "sonnet"),
+            ("claude-sonnet-4-5", "4.5", "sonnet"),
+        ],
+    )
+    def test_alias_version(self, model_name: str, expected_version: str, expected_variant: str):
+        meta = LLMeta(model_name)
+        assert meta.version == expected_version, f"{model_name} 解析出错误版本 {meta.version}"
+        assert meta.variant == expected_variant
+        assert meta.family == ModelFamily.CLAUDE
+
+    def test_dated_4_0_snapshot_still_resolves_to_4_0(self):
+        """带 8 位日期的原始 4.0 snapshot 仍应识别为 4.0，不被精确宽度修复破坏"""
+        meta = LLMeta("claude-opus-4-20250514")
+        assert meta.version == "4.0"
+        assert meta.variant == "opus"
+
+    def test_short_digit_not_swallowed_as_snapshot(self):
+        """根因回归：单个数字 minor 不得被 {snapshot} 吞掉"""
+        assert LLMeta("claude-opus-4-5").version == "4.5"
+        assert LLMeta("claude-opus-4-7").version == "4.7"
+        assert LLMeta("claude-opus-4-8").version == "4.8"
+
+
+class TestClaude4xCapabilities:
+    """新增模型应带官方真实能力（非臆测/镜像）"""
+
+    @pytest.mark.parametrize(
+        "model_name,ctx,max_out",
+        [
+            ("claude-opus-4-8", 1000000, 128000),
+            ("claude-opus-4-7", 1000000, 128000),
+            ("claude-opus-4-5", 200000, 64000),
+        ],
+    )
+    def test_new_model_specs(self, model_name: str, ctx: int, max_out: int):
+        caps = LLMeta(model_name).capabilities
+        assert caps.context_window == ctx
+        assert caps.max_tokens == max_out
+        assert caps.supports_structured_outputs is True
+        assert caps.supports_computer_use is True
+
+
+class TestClaude4xVersionComparison:
+    """版本比较稳定可用——TFRobotV2 门控的基石"""
+
+    def test_monotonic_opus_chain(self):
+        assert LLMeta("claude-opus-4-5") < LLMeta("claude-opus-4-6")
+        assert LLMeta("claude-opus-4-6") < LLMeta("claude-opus-4-7")
+        assert LLMeta("claude-opus-4-7") < LLMeta("claude-opus-4-8")
+
+    def test_cross_minor(self):
+        assert LLMeta("claude-opus-4-1") < LLMeta("claude-opus-4-6")
+        assert LLMeta("claude-opus-4-0") < LLMeta("claude-opus-4-5")
+
+    def test_dated_alias_equivalent_version(self):
+        """带日期与不带日期解析出相同版本元组"""
+        assert LLMeta("claude-opus-4-5").version == LLMeta("claude-opus-4-5-20251101").version
+
+
+class TestVersionGateMatchesPrefillTruth:
+    """关键：纯版本门控 `parse_version(version) >= (4, 6)` 的真假必须与官方 prefill 真值表完全一致"""
+
+    @pytest.mark.parametrize("model_name", sorted(_PREFILL_REMOVED))
+    def test_no_prefill_models_are_ge_4_6(self, model_name: str):
+        meta = LLMeta(model_name)
+        assert meta.family == ModelFamily.CLAUDE
+        assert parse_version(meta.version) >= (4, 6), f"{model_name} 应被版本门控判为不支持 prefill"
+
+    @pytest.mark.parametrize("model_name", sorted(_PREFILL_SUPPORTED))
+    def test_prefill_models_are_lt_4_6(self, model_name: str):
+        meta = LLMeta(model_name)
+        assert meta.family == ModelFamily.CLAUDE
+        assert parse_version(meta.version) < (4, 6), f"{model_name} 应被版本门控判为支持 prefill"

{whosellm-0.2.2 → whosellm-0.2.3}/uv.lock

@@ -968,7 +968,7 @@ wheels = [
 
 [[package]]
 name = "whosellm"
-version = "0.2.2"
+version = "0.2.3"
 source = { editable = "." }
 dependencies = [
     { name = "parse" },

{whosellm-0.2.2 → whosellm-0.2.3}/whosellm/__init__.py

@@ -7,7 +7,7 @@
 LLMeta - 统一的大语言模型版本和能力管理库 / A unified LLM model version and capability management library
 """
 
-__version__ = "0.2.2"
+__version__ = "0.2.3"
 
 from whosellm.capabilities import ModelCapabilities
 from whosellm.model_version import LLMeta

{whosellm-0.2.2 → whosellm-0.2.3}/whosellm/models/config.py

@@ -189,6 +189,11 @@ class ModelFamilyConfig:
             else:
                 type_spec = ""
 
+            # 自定义 snapshot 类型要求精确 8 位（见 patterns._convert_snapshot）
+            # Custom snapshot type requires exactly 8 digits (see patterns._convert_snapshot)
+            if type_spec == "snapshot":
+                return "20240101"
+
             if type_spec.endswith("d"):
                 width_str = type_spec[:-1].strip()
                 width = int(width_str) if width_str.isdigit() else 1

{whosellm-0.2.2 → whosellm-0.2.3}/whosellm/models/families/anthropic.py

@@ -23,14 +23,14 @@ CLAUDE = ModelFamilyConfig(
     variant_default="sonnet",
     variant_priority_default=(3,),  # sonnet 的默认优先级 / default priority for sonnet
     patterns=[
-        "claude-{variant:variant}-{major:d}-{minor:d}@{snapshot:8d}",
-        "claude-{variant:variant}-{major:d}-{minor:d}-{snapshot:8d}",
+        "claude-{variant:variant}-{major:d}-{minor:d}@{snapshot:snapshot}",
+        "claude-{variant:variant}-{major:d}-{minor:d}-{snapshot:snapshot}",
         "claude-{variant:variant}-{major:d}-{minor:d}",
-        "claude-{variant:variant}-{major:d}-{snapshot:8d}",
+        "claude-{variant:variant}-{major:d}-{snapshot:snapshot}",
         "claude-{variant:variant}-{major:d}",
-        "claude-{major:d}-{minor:d}-{variant:variant}-{snapshot:8d}",
+        "claude-{major:d}-{minor:d}-{variant:variant}-{snapshot:snapshot}",
         "claude-{major:d}-{minor:d}-{variant:variant}",
-        "claude-{major:d}-{variant:variant}-{snapshot:8d}",
+        "claude-{major:d}-{variant:variant}-{snapshot:snapshot}",
         "claude-{major:d}-{variant:variant}",
     ],
     capabilities=ModelCapabilities(
@@ -42,6 +42,46 @@ CLAUDE = ModelFamilyConfig(
         context_window=200000,
     ),
     specific_models={
+        "claude-opus-4-8": SpecificModelConfig(
+            version_default="4.8",
+            variant_default="opus",
+            variant_priority=(5,),
+            capabilities=ModelCapabilities(
+                supports_vision=True,
+                supports_thinking=True,
+                supports_function_calling=True,
+                supports_streaming=True,
+                supports_structured_outputs=True,
+                supports_computer_use=True,
+                max_tokens=128000,
+                context_window=1000000,
+            ),
+            patterns=[
+                "claude-opus-4-8-{snapshot:snapshot}",
+                "claude-opus-4-8",
+                "claude-opus-4-8@{snapshot:snapshot}",
+            ],
+        ),
+        "claude-opus-4-7": SpecificModelConfig(
+            version_default="4.7",
+            variant_default="opus",
+            variant_priority=(5,),
+            capabilities=ModelCapabilities(
+                supports_vision=True,
+                supports_thinking=True,
+                supports_function_calling=True,
+                supports_streaming=True,
+                supports_structured_outputs=True,
+                supports_computer_use=True,
+                max_tokens=128000,
+                context_window=1000000,
+            ),
+            patterns=[
+                "claude-opus-4-7-{snapshot:snapshot}",
+                "claude-opus-4-7",
+                "claude-opus-4-7@{snapshot:snapshot}",
+            ],
+        ),
         "claude-opus-4-6": SpecificModelConfig(
             version_default="4.6",
             variant_default="opus",
@@ -57,9 +97,9 @@ CLAUDE = ModelFamilyConfig(
                 context_window=1000000,
             ),
             patterns=[
-                "claude-opus-4-6-{snapshot:8d}",
+                "claude-opus-4-6-{snapshot:snapshot}",
                 "claude-opus-4-6",
-                "claude-opus-4-6@{snapshot:8d}",
+                "claude-opus-4-6@{snapshot:snapshot}",
             ],
         ),
         "claude-sonnet-4-6": SpecificModelConfig(
@@ -77,9 +117,9 @@ CLAUDE = ModelFamilyConfig(
                 context_window=1000000,
             ),
             patterns=[
-                "claude-sonnet-4-6-{snapshot:8d}",
+                "claude-sonnet-4-6-{snapshot:snapshot}",
                 "claude-sonnet-4-6",
-                "claude-sonnet-4-6@{snapshot:8d}",
+                "claude-sonnet-4-6@{snapshot:snapshot}",
             ],
         ),
         "claude-sonnet-4-5": SpecificModelConfig(
@@ -97,7 +137,11 @@ CLAUDE = ModelFamilyConfig(
                 max_tokens=64000,
                 context_window=200000,
             ),
-            patterns=["claude-sonnet-4-5-{snapshot:8d}", "claude-sonnet-4-5", "claude-sonnet-4-5@{snapshot:8d}"],
+            patterns=[
+                "claude-sonnet-4-5-{snapshot:snapshot}",
+                "claude-sonnet-4-5",
+                "claude-sonnet-4-5@{snapshot:snapshot}",
+            ],
         ),
         "claude-haiku-4-5": SpecificModelConfig(
             version_default="4.5",
@@ -114,7 +158,32 @@ CLAUDE = ModelFamilyConfig(
                 max_tokens=64000,
                 context_window=200000,
             ),
-            patterns=["claude-haiku-4-5-{snapshot:8d}", "claude-haiku-4-5", "claude-haiku-4-5@{snapshot:8d}"],
+            patterns=[
+                "claude-haiku-4-5-{snapshot:snapshot}",
+                "claude-haiku-4-5",
+                "claude-haiku-4-5@{snapshot:snapshot}",
+            ],
+        ),
+        "claude-opus-4-5": SpecificModelConfig(
+            version_default="4.5",
+            variant_default="opus",
+            variant_priority=(5,),
+            capabilities=ModelCapabilities(
+                supports_vision=True,
+                supports_pdf=True,
+                supports_thinking=True,
+                supports_function_calling=True,
+                supports_streaming=True,
+                supports_structured_outputs=True,
+                supports_computer_use=True,
+                max_tokens=64000,
+                context_window=200000,
+            ),
+            patterns=[
+                "claude-opus-4-5-{snapshot:snapshot}",
+                "claude-opus-4-5",
+                "claude-opus-4-5@{snapshot:snapshot}",
+            ],
         ),
         "claude-opus-4-1": SpecificModelConfig(
             version_default="4.1",
@@ -131,7 +200,7 @@ CLAUDE = ModelFamilyConfig(
                 max_tokens=32000,
                 context_window=200000,
             ),
-            patterns=["claude-opus-4-1-{snapshot:8d}", "claude-opus-4-1", "claude-opus-4-1@{snapshot:8d}"],
+            patterns=["claude-opus-4-1-{snapshot:snapshot}", "claude-opus-4-1", "claude-opus-4-1@{snapshot:snapshot}"],
         ),
         "claude-sonnet-4-0": SpecificModelConfig(
             version_default="4.0",
@@ -148,7 +217,11 @@ CLAUDE = ModelFamilyConfig(
                 max_tokens=64000,
                 context_window=200000,
             ),
-            patterns=["claude-sonnet-4-{snapshot:8d}", "claude-sonnet-4-0", "claude-sonnet-4-0@{snapshot:8d}"],
+            patterns=[
+                "claude-sonnet-4-{snapshot:snapshot}",
+                "claude-sonnet-4-0",
+                "claude-sonnet-4-0@{snapshot:snapshot}",
+            ],
         ),
         "claude-3-7-sonnet": SpecificModelConfig(
             version_default="3.7",
@@ -165,7 +238,7 @@ CLAUDE = ModelFamilyConfig(
                 max_tokens=64000,
                 context_window=200000,
             ),
-            patterns=["claude-3-7-sonnet-{snapshot:8d}", "claude-3-7-sonnet-latest", "claude-3-7-sonnet"],
+            patterns=["claude-3-7-sonnet-{snapshot:snapshot}", "claude-3-7-sonnet-latest", "claude-3-7-sonnet"],
         ),
         "claude-opus-4-0": SpecificModelConfig(
             version_default="4.0",
@@ -182,7 +255,7 @@ CLAUDE = ModelFamilyConfig(
                 max_tokens=32000,
                 context_window=200000,
             ),
-            patterns=["claude-opus-4-{snapshot:8d}", "claude-opus-4-0", "claude-opus-4-0@{snapshot:8d}"],
+            patterns=["claude-opus-4-{snapshot:snapshot}", "claude-opus-4-0", "claude-opus-4-0@{snapshot:snapshot}"],
         ),
         "claude-3-5-haiku": SpecificModelConfig(
             version_default="3.5",
@@ -198,7 +271,7 @@ CLAUDE = ModelFamilyConfig(
                 max_tokens=8000,
                 context_window=200000,
             ),
-            patterns=["claude-3-5-haiku-{snapshot:8d}", "claude-3-5-haiku-latest", "claude-3-5-haiku"],
+            patterns=["claude-3-5-haiku-{snapshot:snapshot}", "claude-3-5-haiku-latest", "claude-3-5-haiku"],
         ),
         "claude-3-haiku": SpecificModelConfig(
             version_default="3.0",
@@ -213,7 +286,7 @@ CLAUDE = ModelFamilyConfig(
                 max_tokens=4096,
                 context_window=200000,
             ),
-            patterns=["claude-3-haiku-{snapshot:8d}"],
+            patterns=["claude-3-haiku-{snapshot:snapshot}"],
         ),
     },
 )

{whosellm-0.2.2 → whosellm-0.2.3}/whosellm/models/patterns.py

@@ -35,7 +35,20 @@ def _convert_variant(text: str) -> str:
     return text
 
 
-DEFAULT_EXTRA_TYPES: dict[str, Any] = {"variant": _convert_variant}
+@parse.with_pattern(r"\d{8}")
+def _convert_snapshot(text: str) -> int:
+    """快照日期戳：精确 8 位（YYYYMMDD） / Snapshot date stamp: exactly 8 digits (YYYYMMDD)
+
+    使用自定义类型而非 parse 内置 ``{:8d}``：后者的宽度是"最多 8 位"，会把单个数字（如
+    ``claude-opus-4-5`` 里的 ``5``）误当作 snapshot 匹配，导致 minor 版本号被吞、版本回退。
+    Using a custom type instead of parse's built-in ``{:8d}``: the latter's width means
+    "up to 8 digits" and would wrongly swallow a single digit (e.g. the ``5`` in
+    ``claude-opus-4-5``) as a snapshot, dropping the minor version.
+    """
+    return int(text)
+
+
+DEFAULT_EXTRA_TYPES: dict[str, Any] = {"variant": _convert_variant, "snapshot": _convert_snapshot}
 
 
 def _merge_extra_types(extra_types: dict[str, Any] | None) -> dict[str, Any]: