chore: bump version to 2.12.3

Author: kay-ou

CHANGELOG.md

@@ -5,6 +5,19 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.12.3] - 2026-06-06
+
+### Fixed
+
+- **PTrade market-data compatibility** — `get_history` and `get_price` DataFrame returns now preserve legacy PTrade-style integer positional access for column Series, avoiding pandas `FutureWarning`/`KeyError` when strategies use examples like `series[-1]`.
+- **history cache shape isolation** — `get_history` now distinguishes single-stock string requests from one-element list requests in its cache key, preventing call-order-dependent return shapes.
+- **daily date-index resolution** — prebuilt and lazy daily date indexes now use the same int64 nanosecond contract. Datetime indexes stored at non-nanosecond resolution, including pandas 3 `datetime64[us]`, no longer miss exact dates and fall back to the wrong trading day.
+- **valuation date lookup** — `get_fundamentals(table="valuation")` normalizes datetime-index lookups to nanoseconds before searching, keeping realtime market-cap calculations on the requested trading day.
+
+### Tests
+
+- Added contract tests for lazy vs prebuilt daily date indexes, PTrade market-data return shapes, legacy positional Series access, fundamentals/valuation date behavior, and pandas 3 non-nanosecond datetime indexes.
+
 ## [2.12.2] - 2026-05-27
 
 ### Fixed

README.de.md

@@ -7,7 +7,7 @@
 [![Python](https://img.shields.io/badge/Python-3.9+-blue.svg)](https://www.python.org/)
 [![License](https://img.shields.io/badge/License-AGPL--3.0-blue.svg)](LICENSE)
 [![License: Commercial](https://img.shields.io/badge/License-Commercial--Available-red)](licenses/LICENSE-COMMERCIAL.md)
-[![Version](https://img.shields.io/badge/Version-2.12.2-orange.svg)](#)
+[![Version](https://img.shields.io/badge/Version-2.12.3-orange.svg)](#)
 [![PyPI](https://img.shields.io/pypi/v/simtradelab.svg)](https://pypi.org/project/simtradelab/)
 [![PyPI - Downloads](https://img.shields.io/pypi/dm/simtradelab.svg)](https://pypi.org/project/simtradelab/)
 

README.md

@@ -7,7 +7,7 @@ English | [中文](README.zh-CN.md) | [Deutsch](README.de.md)
 [![Python](https://img.shields.io/badge/Python-3.9+-blue.svg)](https://www.python.org/)
 [![License](https://img.shields.io/badge/License-AGPL--3.0-blue.svg)](LICENSE)
 [![License: Commercial](https://img.shields.io/badge/License-Commercial--Available-red)](licenses/LICENSE-COMMERCIAL.md)
-[![Version](https://img.shields.io/badge/Version-2.12.2-orange.svg)](#)
+[![Version](https://img.shields.io/badge/Version-2.12.3-orange.svg)](#)
 [![PyPI](https://img.shields.io/pypi/v/simtradelab.svg)](https://pypi.org/project/simtradelab/)
 [![PyPI - Downloads](https://img.shields.io/pypi/dm/simtradelab.svg)](https://pypi.org/project/simtradelab/)
 

README.zh-CN.md

@@ -7,7 +7,7 @@
 [![Python](https://img.shields.io/badge/Python-3.9+-blue.svg)](https://www.python.org/)
 [![License](https://img.shields.io/badge/License-AGPL--3.0-blue.svg)](LICENSE)
 [![License: Commercial](https://img.shields.io/badge/License-Commercial--Available-red)](licenses/LICENSE-COMMERCIAL.md)
-[![Version](https://img.shields.io/badge/Version-2.12.2-orange.svg)](#)
+[![Version](https://img.shields.io/badge/Version-2.12.3-orange.svg)](#)
 [![PyPI](https://img.shields.io/pypi/v/simtradelab.svg)](https://pypi.org/project/simtradelab/)
 [![PyPI - Downloads](https://img.shields.io/pypi/dm/simtradelab.svg)](https://pypi.org/project/simtradelab/)
 

poetry.lock

@@ -1,7 +1,7 @@
 # Poetry configuration
 [tool.poetry]
 name = "simtradelab"
-version = "2.12.2"
+version = "2.12.3"
 description = "Lightweight quantitative backtesting framework with PTrade API simulation | 轻量级量化回测框架"
 authors = ["kay <kayou@duck.com>"]
 license = "AGPL-3.0-or-later"

pyproject.toml

@@ -5,8 +5,9 @@
 测试交易API
 """
 
-import pytest
+import numpy as np
 import pandas as pd
+import pytest
 
 from simtradelab.ptrade.lifecycle_controller import LifecyclePhase, PTradeLifecycleError
 
@@ -82,6 +83,21 @@ def test_get_history(self, ptrade_api):
         # 应该返回DataFrame或dict
         assert result is None or isinstance(result, (pd.DataFrame, dict))
 
+    def test_prebuilt_date_index_matches_lazy_contract(self, ptrade_api):
+        """预构建索引应与懒加载索引使用相同的 int64 日期契约。"""
+        stock = '600000.SH'
+        query_dt = pd.Timestamp('2024-01-02 14:30')
+
+        ptrade_api.prebuild_date_index(stocks=[stock])
+
+        date_dict, sorted_i8 = ptrade_api.get_stock_date_index(stock)
+        assert isinstance(sorted_i8, np.ndarray)
+        assert sorted_i8.dtype == np.dtype('int64')
+        assert date_dict[pd.Timestamp('2024-01-02').value] == 1
+
+        stock_df = ptrade_api.data_context.stock_data_dict[stock]
+        assert ptrade_api._resolve_daily_index(stock, stock_df, query_dt) == 1
+
 
 class TestStockStatusAPI:
     """测试股票状态API"""