Merge pull request #435 from fasiondog/release

Release 2.7.3

Author: fasiondog

docs/source/indicator/indicator.rst

@@ -99,6 +99,19 @@
 
     聚合函数: 方差, 可参考 :func:`AGG_STD`
 
+
+.. py:function:: AGG_VWAP([ktype=Query.MIN, fill_null=False, unit=1])
+
+    聚合其他K线成交量加权平均价格(Volume Weighted Average Price)
+    VWAP 是成交量加权的平均价格，计算方式是将每一分钟（或单位时间）的成交量乘以该分钟的成交价格，然后对所有乘积求和，最后除以总成交量。
+
+    :param KQuery.KType ktype: 聚合的K线周期
+    :param bool fill_null: 是否填充缺失值
+    :param int unit: 聚合周期单位 (上下文K线分组单位, 使用日线计算分钟线聚合时, unit=2代表聚合2天的分钟线)
+    :return: 指标数据
+    :rtype: Indicator
+
+
 .. py:function:: AGG_FUNC(ind, agg_func[, ktype=Query.MIN, fill_null=False, unit=1]
       
     使用自定函数聚合其他K线周期的指标。虽然支持python自定义函数, 但python函数需要GIL, 速度较慢慢。建议最好直接使用 C++ 自定义聚合函数。

docs/source/indicator/overview.rst

@@ -166,32 +166,6 @@
 * :py:func:`VIGOR` - 亚历山大.艾尔德力度指数
 
 
-**聚合指标**
-
-* :py:func:`AGG_COUNT` - [VIP]聚合函数: 非空值计数
-* :py:func:`AGG_MAD` - [VIP]聚合函数: 平均绝对偏差
-* :py:func:`AGG_MAX` - [VIP]聚合函数: 最大值
-* :py:func:`AGG_MIN` - [VIP]聚合函数: 最大值
-* :py:func:`AGG_MEAN` - [VIP]聚合函数: 平均值
-* :py:func:`AGG_MEDIAN` - [VIP]聚合函数: 中位数
-* :py:func:`AGG_PROD` - [VIP]聚合函数: 乘积
-* :py:func:`AGG_SUM` - [VIP]聚合函数: 总和
-* :py:func:`AGG_STD` - [VIP]聚合函数: 标准差
-* :py:func:`AGG_VAR` - [VIP]聚合函数: 方差
-* :py:func:`AGG_QUANTILE` - [VIP]聚合函数: 分位数
-* :py:func:`AGG_FUNC` - [VIP]聚合函数: 自定义聚合函数
-
-**分组指标**
-
-* :py:func:`GROUP_COUNT` - [VIP]分组函数: 非空值计数
-* :py:func:`GROUP_MAX` - [VIP]分组函数: 分组累计最大值
-* :py:func:`GROUP_MIN` - [VIP]分组函数: 分组累计最小值
-* :py:func:`GROUP_MEAN` - [VIP]分组函数: 分组累计平均值
-* :py:func:`GROUP_PROD` - [VIP]分组函数: 分组累计乘积
-* :py:func:`GROUP_SUM` - [VIP]分组函数: 分组累计总和
-* :py:func:`GROUP_FUNC` - [VIP]分组函数: 自定义分组计算函数
-
-
 **时间指标**
 
 * :py:func:`DATE` - 取得该周期从1900以来的年月日
@@ -210,6 +184,33 @@
 * :py:func:`ICIR` - 计算因子 IC 的 IR 值
 
 
+**聚合指标[VIP]**
+
+* :py:func:`AGG_COUNT` - 聚合函数: 非空值计数
+* :py:func:`AGG_MAD` - 聚合函数: 平均绝对偏差
+* :py:func:`AGG_MAX` - 聚合函数: 最大值
+* :py:func:`AGG_MIN` - 聚合函数: 最大值
+* :py:func:`AGG_MEAN` - 聚合函数: 平均值
+* :py:func:`AGG_MEDIAN` - 聚合函数: 中位数
+* :py:func:`AGG_PROD` - 聚合函数: 乘积
+* :py:func:`AGG_SUM` - 聚合函数: 总和
+* :py:func:`AGG_STD` - 聚合函数: 标准差
+* :py:func:`AGG_VAR` - 聚合函数: 方差
+* :py:func:`AGG_QUANTILE` - 聚合函数: 分位数
+* :py:func:`AGG_VWAP` - 聚合函数: 成交量加权平均价
+* :py:func:`AGG_FUNC` - 聚合函数: 自定义聚合函数
+
+**分组指标[VIP]**
+
+* :py:func:`GROUP_COUNT` - 分组函数: 非空值计数
+* :py:func:`GROUP_MAX` - 分组函数: 分组累计最大值
+* :py:func:`GROUP_MIN` - 分组函数: 分组累计最小值
+* :py:func:`GROUP_MEAN` - 分组函数: 分组累计平均值
+* :py:func:`GROUP_PROD` - 分组函数: 分组累计乘积
+* :py:func:`GROUP_SUM` - 分组函数: 分组累计总和
+* :py:func:`GROUP_FUNC` - 分组函数: 自定义分组计算函数
+
+
 **其他转换辅助**
 
 * :py:func:`concat_to_df` - 合并指标列表为 DateFrame

docs/source/release.md

@@ -1,5 +1,21 @@
 # 版本发布说明
 
+## 2.7.3 - 2025年1月6日
+
+**🚀 新增特性**
+
+* feat(config): 添加 timeline 和 trans 预加载支持
+* feat(StockManager): 添加根据指数获取板块列表功能
+* feat(plugin_extind): 添加AGG_VWAP指标支持
+
+**🐞 缺陷修复**
+
+* fixed(datetime): 优化UTC偏移量计算性能，该问题导致 linux 平台下 clickhouse 数据加载比其他平台慢了10倍
+* fixed(python): Python实现的SG等子类在赋值给C++类时可能存在临时变量类型降级的问题，导致 sys.sg = B() 缺失python _clone 实现
+* fix(data): 修复本地数据导入时的可能存在结构体解包格式错误
+* fix(trade_sys): 修复安全止损指标ST_Saftyloss在调用SAFTYLOSS函数时缺少CLOSE()参数
+* feat(_Stock): 为set_kdata_from_df方法添加默认列参数（原和文档说明不符），设置默认的列名参数为["datetime", "open", "high", "low", "close", "amount", "volume"]
+
 ## 2.7.2 - 2025年12月24日
 
 **🚀 新增特性**

docs/source/stock_manager.rst

@@ -271,6 +271,14 @@ StockManager/Block/Stock
         :param str category: 板块分类
         :return: 板块列表
         :rtype: BlockList
+
+    .. py:method:: get_block_list_by_index_stock(self, index_stk)
+
+        获取指定指数的板块列表
+
+        :param Stock index_stk: 指数
+        :return: 板块列表
+        :rtype: BlockList        
 
     .. py:method:: get_trading_calendar(self, query[, market='SH'])
     

hikyuu_cpp/hikyuu/utilities/plugin/PluginLoader.h

@@ -55,7 +55,7 @@ class PluginLoader final {
                            GetLastError());
 
 #else
-        m_handle = dlopen(filename.c_str(), RTLD_LAZY | RTLD_GLOBAL);
+        m_handle = dlopen(filename.c_str(), RTLD_LAZY);
         HKU_WARN_IF_RETURN(!m_handle, false, "load plugin({}) failed! {}", filename, dlerror());
 #endif
 

xmake.lua

@@ -6,7 +6,7 @@ set_project("hikyuu")
 add_rules("mode.debug", "mode.release")
 
 -- version
-set_version("2.7.2", {build = "%Y%m%d%H%M"})
+set_version("2.7.3", {build = "%Y%m%d%H%M"})
 
 set_warnings("all")