xmpy-datarecorder 1.0.0__tar.gz

xmpy_datarecorder-1.0.0/.gitignore

@@ -0,0 +1,132 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# IDE
+.idea/
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/

xmpy_datarecorder-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015-present, Xiaoyou Chen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

xmpy_datarecorder-1.0.0/PKG-INFO

@@ -0,0 +1,50 @@
+Metadata-Version: 2.4
+Name: xmpy_datarecorder
+Version: 1.0.0
+Summary: xmpy框架的数据记录应用。
+Project-URL: Homepage, https://github.com/InkAbyss/xmpy_datarecorder
+Project-URL: Issues, https://github.com/InkAbyss/xmpy_datarecorder/issues
+Author-email: bhzy <2024305928@qq.com>
+License: MIT
+License-File: LICENSE
+Keywords: algotrading,investment,quant,quantitative,trading
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: Chinese (Simplified)
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Topic :: Office/Business :: Financial :: Investment
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: xmpy>=1.0.0
+Description-Content-Type: text/markdown
+
+# xmpy框架的行情录制模块
+
+## 说明
+
+xmpy_datarecorder是用于实时行情记录的模块，用户可以利用该模块记录实时Tick数据和K线数据，并自动写入保存到数据库中。
+
+记录的数据可以用于历史回测，以及策略的实盘初始化。
+
+## 安装
+
+安装环境推荐基于4.0.0版本以上的【[**VeighNa Studio**](https://www.vnpy.com)】。
+
+直接使用pip命令：
+
+```
+pip install xmpy_datarecorder
+```
+
+
+或者下载源代码后，解压后在cmd中运行：
+
+```
+pip install .
+```

xmpy_datarecorder-1.0.0/README.md

@@ -0,0 +1,24 @@
+# xmpy框架的行情录制模块
+
+## 说明
+
+xmpy_datarecorder是用于实时行情记录的模块，用户可以利用该模块记录实时Tick数据和K线数据，并自动写入保存到数据库中。
+
+记录的数据可以用于历史回测，以及策略的实盘初始化。
+
+## 安装
+
+安装环境推荐基于4.0.0版本以上的【[**VeighNa Studio**](https://www.vnpy.com)】。
+
+直接使用pip命令：
+
+```
+pip install xmpy_datarecorder
+```
+
+
+或者下载源代码后，解压后在cmd中运行：
+
+```
+pip install .
+```

xmpy_datarecorder-1.0.0/pyproject.toml

@@ -0,0 +1,103 @@
+[project]
+# name: 包的发布名称，将在PyPI上显示，必须唯一且只包含ASCII字母、数字、连字符和下划线
+name = "xmpy_datarecorder"
+# dynamic: 指定动态从其他来源获取的字段，这里version将从__init__.py文件中提取
+dynamic = ["version"]
+# description: 包的简短描述，用于PyPI等平台展示
+description = "xmpy框架的数据记录应用。"
+# readme: 项目README文件的路径，包含详细文档和用法说明
+readme = "README.md"
+# license: 包的开源许可证信息，这里使用MIT许可证
+license = {text = "MIT"}
+# authors: 包的作者信息列表，包含姓名和联系方式
+authors = [{name = "bhzy", email = "2024305928@qq.com"}]
+# classifiers: PyPI分类器列表，帮助用户搜索和筛选包
+classifiers = [
+    "Development Status :: 5 - Production/Stable",      # 开发状态：稳定版
+    "License :: OSI Approved :: MIT License",           # MIT许可证认证
+    "Operating System :: OS Independent",               # 跨平台兼容
+    "Programming Language :: Python :: 3",              # 支持Python3
+    "Programming Language :: Python :: 3.10",           # 支持Python 3.10
+    "Programming Language :: Python :: 3.11",           # 支持Python 3.11
+    "Programming Language :: Python :: 3.12",           # 支持Python 3.12
+    "Programming Language :: Python :: 3.13",           # 支持Python 3.13
+    "Topic :: Office/Business :: Financial :: Investment",  # 主题：金融投资
+    "Programming Language :: Python :: Implementation :: CPython",  # CPython实现
+    "Natural Language :: Chinese (Simplified)",         # 支持简体中文
+    "Typing :: Typed",                                  # 使用类型注解
+]
+# requires-python: 支持的Python版本范围
+requires-python = ">=3.10"
+# dependencies: 项目运行时依赖的第三方包列表
+dependencies = [
+    "xmpy>=1.0.0",  # 依赖xmpy库，版本>=1.0.0
+]
+# keywords: 关键词列表，用于在PyPI上搜索和分类
+keywords = ["quant", "quantitative", "investment", "trading", "algotrading"]
+
+# [project.urls] 节定义项目的相关URL链接
+[project.urls]
+Homepage = "https://github.com/InkAbyss/xmpy_datarecorder"      # 项目地址
+Issues = "https://github.com/InkAbyss/xmpy_datarecorder/issues"
+
+# [build-system] 节指定构建系统配置
+[build-system]
+# requires: 构建系统需要的依赖包
+requires = ["hatchling>=1.27.0", "babel>=2.17.0"]
+# build-backend: 构建后端工具
+build-backend = "hatchling.build"
+
+# [tool.hatch.version] 节配置Hatch版本管理
+[tool.hatch.version]
+# path: 版本信息所在的文件路径
+path = "xmpy_datarecorder/__init__.py"
+# pattern: 从文件中提取版本号的正则表达式模式
+pattern = "__version__ = ['\"](?P<version>[^'\"]+)['\"]"
+
+# [tool.hatch.build.targets.wheel] 节配置Wheel包构建
+[tool.hatch.build.targets.wheel]
+# packages: 包含在分发中的包列表
+packages = ["xmpy_datarecorder"]
+# include-package-data: 是否包含包数据文件
+include-package-data = true
+
+# [tool.hatch.build.targets.sdist] 节配置源码分发
+[tool.hatch.build.targets.sdist]
+# include: 包含在源码分发中的文件模式
+include = ["xmpy_datarecorder*"]
+
+# [tool.ruff] 节配置Ruff代码检查工具
+[tool.ruff]
+# target-version: 目标Python版本
+target-version = "py310"
+# output-format: 输出格式
+output-format = "full"
+
+# [tool.ruff.lint] 节配置Ruff的lint规则
+[tool.ruff.lint]
+# select: 启用的检查规则集合
+select = [
+    "B",  # flake8-bugbear - 发现可能的bug和设计问题
+    "E",  # pycodestyle error - 代码格式错误
+    "F",  # pyflakes - 发现Python代码中的错误
+    "UP",  # pyupgrade - 升级Python语法到最新版本
+    "W",  # pycodestyle warning - 代码格式警告
+]
+# ignore: 忽略的规则
+ignore = ["E501"]     # E501: 忽略行长度限制
+
+# [tool.mypy] 节配置Mypy静态类型检查工具
+[tool.mypy]
+python_version = "3.10"             # python_version: 目标Python版本
+warn_return_any = true              # warn_return_any: 当函数返回Any类型时警告
+warn_unused_configs = true          # warn_unused_configs: 当有未使用的配置时警告
+disallow_untyped_defs = true        # disallow_untyped_defs: 不允许未类型注解的函数定义
+disallow_incomplete_defs = true     # disallow_incomplete_defs: 不允许不完整的函数定义
+check_untyped_defs = true           # check_untyped_defs: 检查未类型注解的函数定义
+disallow_untyped_decorators = true  # disallow_untyped_decorators: 不允许未类型注解的装饰器
+no_implicit_optional = true         # no_implicit_optional: 不允许隐式的Optional类型
+strict_optional = true              # strict_optional: 严格检查Optional类型
+warn_redundant_casts = true         # warn_redundant_casts: 当有冗余的类型转换时警告
+warn_unused_ignores = true          # warn_unused_ignores: 当有未使用的类型忽略注释时警告
+warn_no_return = true               # warn_no_return: 当函数可能没有返回值时警告
+ignore_missing_imports = true       # ignore_missing_imports: 忽略缺失导入的错误

xmpy_datarecorder-1.0.0/xmpy_datarecorder/__init__.py

@@ -0,0 +1,24 @@
+from pathlib import Path
+
+from xmpy.包_交易核心.模块_应用 import 类_基础应用
+
+from .数据记录引擎 import 类_记录引擎,应用名称
+
+__all__ = [
+    "类_记录引擎",
+    "应用名称",
+    "类_数据记录应用"
+]
+
+__version__ = "1.0.0"
+
+class 类_数据记录应用(类_基础应用):  # 类名中文化
+    """行情记录应用"""
+
+    应用名称: str = 应用名称  # 使用从 数据记录引擎模块 导入的中文常量
+    应用模块: str = __module__
+    应用路径: Path = Path(__file__).parent
+    显示名称: str = "行情记录"  # 界面显示名称保持中文不变
+    引擎类: 类_记录引擎 = 类_记录引擎  # 使用中文引擎类名
+    组件名称: str = "数据记录管理界面"  # 保持原始控件类名不变（需确保对应控件已汉化）
+    图标名称: str = str(应用路径.joinpath("ui", "recorder.ico"))  # 图标路径保持不变

xmpy_datarecorder-1.0.0/xmpy_datarecorder//346/225/260/346/215/256/350/256/260/345/275/225/345/274/225/346/223/216.py

@@ -0,0 +1,390 @@
+import traceback
+from threading import Thread
+from queue import Queue, Empty
+from copy import copy
+from collections import defaultdict
+from typing import Optional
+from datetime import datetime, timedelta
+
+from xmpy.包_事件引擎 import 类_事件,类_事件引擎
+from xmpy.包_交易核心 import 模块_对象
+from xmpy.包_交易核心.模块_主引擎 import 基础引擎, 类_主引擎, 日志引擎
+from xmpy.包_交易核心.模块_常数 import 类_交易所
+from xmpy.包_交易核心.模块_对象 import (
+    类_订阅请求,
+    类_行情数据,
+    类_K线数据,
+    类_合约数据,
+    类_日志数据,
+    类_价差项
+)
+from xmpy.包_交易核心.模块_事件类型 import 事件类型_行情,事件类型_合约,事件类型_定时
+from xmpy.包_交易核心.模块_工具 import 加载json文件,保存json文件,类_K线生成器,爬取主力合约表格,处理合约信息
+from xmpy.包_交易核心.模块_基础数据库 import 获取数据库,数据库时区
+
+
+应用名称 = "数据记录器"
+
+事件类型_记录日志 = "记录日志"
+事件类型_记录更新 = "记录更新"
+事件类型_记录异常 = "记录异常"
+事件类型_价差数据 = "价差数据更新"
+
+
+class 类_记录引擎(基础引擎):
+    """数据记录引擎，用于运行数据记录功能"""
+
+    配置文件名 = "自选合约配置.json"
+
+    def __init__(self, 主引擎: 类_主引擎, 事件引擎: 类_事件引擎) -> None:
+        """构造函数"""
+        super().__init__(主引擎, 事件引擎, 应用名称)
+
+        self.所有策略: dict = {}  # 策略名称: 策略实例
+        self.策略配置: dict = {}  # 策略名称: 配置字典
+
+        self.任务队列: Queue = Queue()
+        self.工作线程 = Thread(target=self.运行)
+        self.运行状态 = False
+
+        self.tick记录字典 = {}
+        self.k线记录字典 = {}
+        self.k线生成器字典 = {}
+
+        self.定时计数 = 0
+        self.定时间隔 = 10
+
+        self.tick缓存: dict[str, list[类_行情数据]] = defaultdict(list)
+        self.k线缓存: dict[str, list[类_K线数据]] = defaultdict(list)
+
+        self.过滤时间 = datetime.now(数据库时区)
+        self.过滤窗口 = 60
+        self.时间差 = None
+
+        self.数据库 = 获取数据库()
+
+        self.加载配置()
+        self.注册事件()
+        self.启动()
+        爬取主力合约表格()
+
+        self.发送更新事件()
+
+    def 加载配置(self) -> None:
+        """加载配置文件"""
+        配置 = 加载json文件(self.配置文件名)
+        self.tick记录字典 = 配置.get("tick", {})
+        self.k线记录字典 = 配置.get("K线", {})
+
+        self.过滤窗口 = 配置.get("过滤窗口", 60)
+        self.时间差 = timedelta(seconds=self.过滤窗口)
+
+    def 保存配置(self) -> None:
+        """保存配置文件"""
+        配置 = {
+            "tick": self.tick记录字典,
+            "K线": self.k线记录字典,
+        }
+        保存json文件(self.配置文件名, 配置)
+
+    def 更新配置(self, 策略名称: str, 配置字典: dict) -> None:
+        """更新策略配置到文件"""
+        策略实例 = self.所有策略[策略名称]
+        self.策略配置[策略名称] = {
+            "class_name": 策略实例.__class__.__name__,
+            "vt_symbol": 策略实例.合约标识,
+            "setting": 配置字典,
+        }
+        保存json文件(self.配置文件名, self.策略配置)
+
+    def 运行(self) -> None:
+        """工作线程主循环"""
+        while self.运行状态:
+            try:
+                任务: 模块_对象 = self.任务队列.get(timeout=1)
+                任务类型, 数据 = 任务
+
+                if 任务类型 == "tick":
+                    self.数据库.保存Tick数据(数据, 流式存储 = True)
+                elif 任务类型 == "k线":
+                    self.数据库.保存K线数据(数据, 流式存储 = True)
+
+            except Empty:
+                continue
+
+            except Exception:
+                self.运行状态 = False
+                异常信息 = traceback.format_exc()
+                事件 = 类_事件(事件类型_记录异常, 异常信息)
+                self.事件引擎.放入事件(事件)
+
+    def 关闭(self) -> None:
+        """关闭引擎"""
+        self.运行状态 = False
+        if self.工作线程.is_alive():
+            self.工作线程.join()
+
+    def 启动(self) -> None:
+        """启动引擎"""
+        self.运行状态 = True
+        self.工作线程.start()
+
+    def 启动自选合约采集(self) -> None:
+        # 合并两个字典的键，避免重复处理
+        所有合约键 = set(self.k线记录字典.keys()) | set(self.tick记录字典.keys())
+
+        for 代码_交易所 in 所有合约键:
+            # 检查是否为本地数据
+            if 类_交易所.本地数据.value not in 代码_交易所:
+                # 非本地数据合约需要订阅
+                合约: Optional[类_合约数据] = self.主引擎.获取合约详情(代码_交易所)
+                if not 合约:
+                    self.记录日志(f"找不到合约：{代码_交易所}")
+                    continue  # 继续处理其他合约，而不是直接返回
+
+                self.订阅合约(合约)
+            else:
+                # 本地数据合约初始化字典
+                self.k线记录字典[代码_交易所] = {}
+                self.tick记录字典[代码_交易所] = {}
+
+    def 启动主力合约采集(self, tick记录 = True, K线记录 = True, 交易所名称: str = "全部"):
+        主力合约列表 = 处理合约信息(交易所名称)
+
+        for 代码_交易所 in 主力合约列表:
+            if 类_交易所.本地数据.value not in 代码_交易所:
+                # 非本地数据合约需要订阅
+                合约: Optional[类_合约数据] = self.主引擎.获取合约详情(代码_交易所)
+                if not 合约:
+                    self.记录日志(f"找不到合约：{代码_交易所}")
+                    continue  # 继续处理其他合约，而不是直接返回
+
+                if tick记录:
+                    self.tick记录字典[代码_交易所] = {
+                        "合约代码": 合约.代码,
+                        "交易所": 合约.交易所.value,
+                        "网关名称": 合约.网关名称
+                    }
+                if K线记录:
+                    self.k线记录字典[代码_交易所] = {
+                        "合约代码": 合约.代码,
+                        "交易所": 合约.交易所.value,
+                        "网关名称": 合约.网关名称
+                    }
+
+                self.订阅合约(合约)
+
+            else:
+                # 本地数据合约初始化字典
+                self.k线记录字典[代码_交易所] = {}
+                self.tick记录字典[代码_交易所] = {}
+
+    def 清理过期自选合约(self) -> None:
+        # 合并两个字典的键，避免重复处理
+        所有合约键 = set(self.k线记录字典.keys()) | set(self.tick记录字典.keys())
+
+        for 代码_交易所 in 所有合约键:
+            # 检查是否为本地数据
+            if 类_交易所.本地数据.value not in 代码_交易所:
+                # 非本地数据合约需要订阅
+                合约: Optional[类_合约数据] = self.主引擎.获取合约详情(代码_交易所)
+                if not 合约:
+                    self.记录日志(f"存在过期合约：{代码_交易所}，开始进行移除")
+                    self.移除自选Tick合约(代码_交易所)
+                    self.移除自选K线合约(代码_交易所)
+                    continue  # 继续处理其他合约，而不是直接返回
+
+    def 添加自选K线合约(self, 代码_交易所: str) -> None:
+        """添加K线记录"""
+        if 代码_交易所 in self.k线记录字典:
+            self.记录日志(f"已在K线记录列表中：{代码_交易所}")
+
+        if 类_交易所.本地数据.value not in 代码_交易所:
+            合约: Optional[类_合约数据] = self.主引擎.获取合约详情(代码_交易所)
+            if not 合约:
+                self.记录日志(f"找不到合约：{代码_交易所}")
+                return
+
+            self.k线记录字典[代码_交易所] = {
+                "合约代码": 合约.代码,
+                "交易所": 合约.交易所.value,
+                "网关名称": 合约.网关名称
+            }
+            self.订阅合约(合约)
+        else:
+            self.k线记录字典[代码_交易所] = {}
+
+        self.保存配置()
+        self.发送更新事件()
+        self.记录日志(f"添加K线记录成功：{代码_交易所}")
+
+    def 添加自选Tick合约(self, 代码_交易所: str) -> None:
+        """添加Tick记录"""
+        if 代码_交易所 in self.tick记录字典:
+            self.记录日志(f"已在Tick记录列表中：{代码_交易所}")
+
+        if 类_交易所.本地数据.value not in 代码_交易所:
+            合约: Optional[类_合约数据] = self.主引擎.获取合约详情(代码_交易所)
+            if not 合约:
+                self.记录日志(f"找不到合约：{代码_交易所}")
+                return
+
+            self.tick记录字典[代码_交易所] = {
+                "合约代码": 合约.代码,
+                "交易所": 合约.交易所.value,
+                "网关名称": 合约.网关名称
+            }
+            self.订阅合约(合约)
+        else:
+            self.tick记录字典[代码_交易所] = {}
+
+        self.保存配置()
+        self.发送更新事件()
+        self.记录日志(f"添加Tick记录成功：{代码_交易所}")
+
+    def 移除自选K线合约(self, 代码_交易所: str) -> None:
+        """移除K线记录"""
+        if 代码_交易所 not in self.k线记录字典:
+            self.记录日志(f"不在K线记录列表中：{代码_交易所}")
+            return
+
+        self.k线记录字典.pop(代码_交易所)
+        self.保存配置()
+        self.发送更新事件()
+        self.记录日志(f"移除K线记录成功：{代码_交易所}")
+
+    def 移除自选Tick合约(self, 代码_交易所: str) -> None:
+        """移除Tick记录"""
+        if 代码_交易所 not in self.tick记录字典:
+            self.记录日志(f"不在Tick记录列表中：{代码_交易所}")
+            return
+
+        self.tick记录字典.pop(代码_交易所)
+        self.保存配置()
+        self.发送更新事件()
+        self.记录日志(f"移除Tick记录成功：{代码_交易所}")
+
+    def 注册事件(self) -> None:
+        """注册事件监听"""
+        self.事件引擎.注册类型处理器(事件类型_定时, self.处理定时事件)
+        self.事件引擎.注册类型处理器(事件类型_行情, self.处理tick事件)
+        self.事件引擎.注册类型处理器(事件类型_合约, self.处理合约事件)
+        self.事件引擎.注册类型处理器(事件类型_价差数据, self.处理价差事件)
+
+        获取日志引擎: 日志引擎 = self.主引擎.获取引擎("日志")
+        self.事件引擎.注册类型处理器(事件类型_记录日志, 获取日志引擎.处理日志事件)
+
+    def 更新Tick数据(self, tick: 类_行情数据) -> None:
+        """更新Tick数据"""
+        tick时间差 = abs(tick.时间戳 - self.过滤时间)
+
+        if abs(tick时间差) >= self.时间差:
+            print(f'进入更新Tick数据，空判断，{tick.代码_交易所}')
+            return
+
+        if tick.代码_交易所 in self.tick记录字典:
+            self.记录Tick(copy(tick))
+
+        if tick.代码_交易所 in self.k线记录字典:
+            k线生成器: 类_K线生成器 = self.获取k线生成器(tick.代码_交易所)
+            k线生成器.更新Tick(copy(tick))
+
+    def 处理定时事件(self, 事件: 类_事件) -> None:
+        """处理定时事件"""
+        self.过滤时间 = datetime.now(数据库时区)
+
+        self.定时计数 += 1
+        if self.定时计数 < self.定时间隔:
+            return
+        self.定时计数 = 0
+
+        for k线列表 in self.k线缓存.values():
+            self.任务队列.put(("k线", k线列表))
+        self.k线缓存.clear()
+
+        for tick列表 in self.tick缓存.values():
+            self.任务队列.put(("tick", tick列表))
+        self.tick缓存.clear()
+
+    def 处理tick事件(self, 事件: 类_事件) -> None:
+        """处理Tick事件"""
+        tick: 类_行情数据 = 事件.数据
+        self.更新Tick数据(tick)
+
+    def 处理合约事件(self, 事件: 类_事件) -> None:
+        """处理合约事件"""
+        合约: 类_合约数据 = 事件.数据
+        合约代码: str = 合约.代码
+
+        if 合约代码 in self.tick记录字典 or 合约代码 in self.k线记录字典:
+            self.订阅合约(合约)
+
+    def 处理价差事件(self, 事件: 类_事件) -> None:
+        """处理价差数据事件"""
+        价差项: 类_价差项 = 事件.数据
+        tick数据: 类_行情数据 = 类_行情数据(
+            代码 = 价差项.名称,
+            交易所 = 类_交易所.本地数据,
+            时间戳 = 价差项.时间,
+            名称 = 价差项.名称,
+            最新价 = (价差项.买价 + 价差项.卖价) / 2,
+            买一价 = 价差项.买价,
+            卖一价 = 价差项.卖价,
+            买一量 = 价差项.买量,
+            卖一量 = 价差项.卖量,
+            本地时间 = 价差项.时间,
+            网关名称 = "价差"
+        )
+
+        if tick数据.时间戳:
+            self.更新Tick数据(tick数据)
+
+    def 记录日志(self, 内容: str) -> None:
+        """记录引擎日志"""
+
+        日志实例 = 类_日志数据(消息内容=内容, 网关名称=应用名称)
+        事件 = 类_事件(类型=事件类型_记录日志, 数据=日志实例)
+        self.事件引擎.放入事件(事件)
+
+    def 发送更新事件(self) -> None:
+        """推送状态更新事件"""
+        tick代码列表 = list(self.tick记录字典.keys())
+        tick代码列表.sort()
+
+        k线代码列表 = list(self.k线记录字典.keys())
+        k线代码列表.sort()
+
+        数据 = {
+            "tick": tick代码列表,
+            "k线": k线代码列表
+        }
+
+        事件 = 类_事件(事件类型_记录更新, 数据)
+        self.事件引擎.放入事件(事件)
+
+    def 记录Tick(self, tick数据: 类_行情数据) -> None:
+        """记录Tick数据到缓存"""
+        self.tick缓存[tick数据.代码_交易所].append(tick数据)
+
+    def 记录K线(self, k线数据: 类_K线数据) -> None:
+        """记录K线数据到缓存"""
+        # self.记录日志(f'K线：{k线数据}')
+        self.k线缓存[k线数据.代码_交易所].append(k线数据)
+
+    def 获取k线生成器(self, 代码_交易所: str) -> 类_K线生成器:
+        """获取K线生成器"""
+        生成器: Optional[类_K线生成器] = self.k线生成器字典.get(代码_交易所, None)
+
+        if not 生成器:
+            生成器 = 类_K线生成器(self.记录K线)
+            self.k线生成器字典[代码_交易所] = 生成器
+
+        return 生成器
+
+    def 订阅合约(self, 合约: 类_合约数据) -> None:
+        """订阅合约行情"""
+        请求: 类_订阅请求 = 类_订阅请求(
+            代码 = 合约.代码,
+            交易所 = 合约.交易所
+        )
+        self.主引擎.订阅行情(请求, 合约.网关名称)