Update Version 3.8.6

Author: shinny-hongyan

PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: tqsdk
-Version: 3.8.5
+Version: 3.8.6
 Summary: TianQin SDK
 Home-page: https://www.shinnytech.com/tqsdk
 Author: TianQin

doc/conf.py

@@ -48,9 +48,9 @@
 # built documents.
 #
 # The short X.Y version.
-version = u'3.8.5'
+version = u'3.8.6'
 # The full version, including alpha/beta/rc tags.
-release = u'3.8.5'
+release = u'3.8.6'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.

doc/images/context7add_to_cursor.png

@@ -171,6 +171,71 @@ Cursor 继承了 VS Code 强大的调试功能。
 * **分享您的尝试**：如果您已尝试过某些解决方案，告知 AI，这有助于获得更精准的指导。
 * **迭代与追问**：AI 的首次回答可能并非完美，您可以基于其回答进行追问或要求澄清。
 
+使用 Context7 增强 Cursor 文档上下文
+====================================
+
+Context7 简介
+--------------
+
+在使用cursor时，还可以结合 context7 来增强文档上下文，从而减少幻觉，让回答更贴近实际可用的 API 与最佳实践。
+
+Context7 是一款基于 MCP（Model Context Protocol）的“文档与示例检索”工具，由 Upstash 提供。启用后，它会在回答问题前自动检索权威、最新且可指定版本的官方文档与示例代码，并把结果注入到 AI 的上下文中，从而显著减少“幻觉”，让回答更贴近实际可用的 API 与最佳实践。
+
+安装与系统要求
+----------------
+
+* Node.js >= v18.0.0（必需）
+
+建议通过 ``node -v`` 确认本机 Node.js 版本，未满足时请先升级至 18 或更高版本。
+
+在 Cursor 中启用 Context7（MCP 配置）
+-----------------------------------
+访问 `Context7 Github 地址 <https://github.com/upstash/context7>`_ 
+
+在下方找到 Install in Cursor，点击 Add to Cursor 按钮
+
+.. image:: images/github_add_cursor.png
+
+此时会跳转到 Cursor 界面，点击 Install 即安装成功
+
+.. image:: images/context7add_to_cursor.png
+
+
+在对话中使用 Context7
+----------------------
+
+1. 打开聊天（`Ctrl + K` / `Cmd + K`）。
+2. 在说明完你的需求后，在提示末尾添加：**`use context7`**。
+3. 结合本仓库源码一起引用更佳：在问题中同时描述你的代码片段或通过 `@tqsdk/...` 指向相关模块，获得“实现 + 规范”的联合校对与建议。
+
+示例模板（可直接粘贴）
+----------------------
+
+* “请用 TqSdk 获取 SHFE.rb 主力连续的 1 分钟 K 线，并用 pandas 2.2 计算 20/60 均线；代码需兼容 Python 3.11。use context7”
+
+
+能带来哪些好处
+----------------
+
+* **降低幻觉**：基于权威、最新、可指定版本的文档进行回答，显著减少错误建议。
+* **效率更高**：无需频繁切换浏览器查文档，回答可带来源依据，验证成本更低。
+* **与源码联动**：将外部文档与本仓库源码一起纳入上下文，得到“规范 + 实现”的双重视角。
+
+最佳实践与注意事项
+--------------------
+
+* **明确版本**：在提示中写出你正在使用的 Python 与关键依赖版本（如 pandas 2.2、NumPy 2.x）。
+* **问题要聚焦**：一次只问一个核心问题，必要时拆分为多轮对话，逐步演进。
+* **最小上下文**：提供足够但不冗余的代码与背景，避免信息噪声干扰答案质量。
+* **与源码同引用**：当官方文档与实现存在差异时，请在问题中同时 `@` 源码位置，并让 AI 标注差异与原因。
+
+常见问题（FAQ）
+---------------
+
+* “添加后没有生效？”——请在 Cursor 的 MCP 面板确认 `context7` 为 Running；若未运行，检查 Node.js 版本与网络代理；重启 Cursor 再试。
+* “公司网络限制 npx？”——可预先外网安装依赖，或与网络/安全同事沟通放行 `@upstash/context7-mcp` 的获取；必要时使用私有镜像源。
+* “如何停用？”——移除 MCP 配置或在 MCP 面板禁用 `context7`，重启 Cursor。
+
 总结
 =====
 

doc/images/github_add_cursor.png

@@ -2,6 +2,12 @@
 
 版本变更
 =============================
+3.8.6 (2025/08/26)
+
+* 新增：:py:class:`~tqsdk.risk_rule.TqRuleOrderRateLimit` 类，设置一个 API 实例每秒最大订单操作次数限制
+* docs: 优化文档
+
+
 3.8.5 (2025/08/07)
 
 * 修复: websockets 10.0 版本引发的连接失败问题

doc/tqsdk_cursor.rst

@@ -8,7 +8,7 @@
 
 setuptools.setup(
     name='tqsdk',
-    version="3.8.5",
+    version="3.8.6",
     description='TianQin SDK',
     author='TianQin',
     author_email='[email protected]',

doc/version.rst

@@ -1 +1 @@
-__version__ = '3.8.5'
+__version__ = '3.8.6'

setup.py

@@ -71,7 +71,7 @@
 from tqsdk.risk_rule import TqRiskRule
 from tqsdk.ins_schema import ins_schema, basic, derivative, future, option
 from tqsdk.symbols import TqSymbols
-from tqsdk.tradeable import TqAccount, TqZq, TqKq, TqKqStock, TqSim, TqSimStock, BaseSim, BaseOtg, TqCtp, TqRohon, TqJees, TqYida
+from tqsdk.tradeable import TqAccount, TqZq, TqKq, TqKqStock, TqSim, TqSimStock, BaseSim, BaseOtg, TqCtp, TqRohon, TqJees, TqYida, TqTradingUnit
 from tqsdk.trading_status import TqTradingStatus
 from tqsdk.tqwebhelper import TqWebHelper
 from tqsdk.utils import _generate_uuid, _query_for_quote, BlockManagerUnconsolidated, _quotes_add_night, _bisect_value, \
@@ -81,7 +81,11 @@
 from .__version__ import __version__
 
 
-UnionTradeable = Union[TqAccount, TqKq, TqZq, TqKqStock, TqSim, TqSimStock, TqCtp, TqRohon, TqJees, TqYida]
+# todo:
+# 在 python 文档中对 type alias 的定义有多种：TypeAliasType, TypeAlias 以及 simple assignment https://docs.python.org/3.13/library/typing.html#type-aliases
+# Union 类型支持嵌套 Union 类型，但是不支持嵌套 Union TypeAliasType 类型：https://docs.python.org/3.13/library/typing.html#typing.Union
+# 但是 Union 文档没有明说是否支持嵌套 Union simple assignment 类型，从实现上看，目前所有版本都支持（最新 3.13）
+UnionTradeable = Union[TqAccount, TqKq, TqZq, TqKqStock, TqSim, TqSimStock, TqCtp, TqRohon, TqJees, TqYida, TqTradingUnit]
 
 
 class TqApi(TqBaseApi):
@@ -124,9 +128,11 @@ def __init__(self, account: Optional[Union[TqMultiAccount, UnionTradeable]] = No
 
                 * :py:class:`~tqsdk.TqYida` : 使用易达账号
 
+                * :py:class:`~tqsdk.TqTradingUnit` : 使用交易单元账号
+
                 * :py:class:`~tqsdk.TqMultiAccount` : 多账户列表，列表中支持 :py:class:`~tqsdk.TqAccount`、:py:class:`~tqsdk.TqKq`、:py:class:`~tqsdk.TqKqStock`、\
                   :py:class:`~tqsdk.TqSim`、:py:class:`~tqsdk.TqSimStock`、:py:class:`~tqsdk.TqZq`、:py:class:`~tqsdk.TqRohon`、:py:class:`~tqsdk.TqJees`、\
-                  :py:class:`~tqsdk.TqYida` 和 :py:class:`~tqsdk.TqCtp` 中的 0 至 N 个或者组合
+                  :py:class:`~tqsdk.TqYida` 、:py:class:`~tqsdk.TqTradingUnit` 和 :py:class:`~tqsdk.TqCtp` 中的 0 至 N 个或者组合
 
             auth (TqAuth/str): [必填]用户快期账户:
                 * :py:class:`~tqsdk.TqAuth` : 添加快期账户类，例如：TqAuth("[email protected]", "123456")
@@ -1478,6 +1484,9 @@ def cancel_order(self, order_or_order_id: Union[str, Order], account: Optional[U
             "user_id": self._account._get_account_id(account),
             "order_id": order_id,
         }
+        # 风控检查
+        self._risk_manager._could_cancel_order(msg)
+        self._risk_manager._on_cancel_order(msg)
         self._send_pack(msg)
 
     # ----------------------------------------------------------------------

tqsdk/__version__.py

@@ -3,12 +3,15 @@
 __time__ = '2020/8/5 22:45'
 __author__ = 'Hong Yan'
 
-from typing import List, Union, Optional
+from typing import List, Union, Optional, TYPE_CHECKING
 
 from shinny_structlog import ShinnyLoggerAdapter
 
+if TYPE_CHECKING:
+    from tqsdk.api import UnionTradeable
+
 from tqsdk.channel import TqChan
-from tqsdk.tradeable import TqAccount, TqKq, TqKqStock, TqSim, TqSimStock, BaseSim, TqZq, TqCtp, TqRohon, TqJees, TqYida, TqTradingUnit
+from tqsdk.tradeable import TqSim, BaseSim
 from tqsdk.tradeable.mixin import StockMixin
 
 
@@ -27,7 +30,7 @@ class TqMultiAccount(object):
 
     """
 
-    def __init__(self, accounts: Optional[List[Union[TqAccount, TqKq, TqZq, TqKqStock, TqSim, TqSimStock, TqZq, TqCtp, TqRohon, TqJees, TqYida, TqTradingUnit]]] = None):
+    def __init__(self, accounts: Optional[List['UnionTradeable']] = None):
         """
         创建 TqMultiAccount 实例
 
@@ -85,7 +88,7 @@ def _has_duplicate_account(self):
         account_set = set([a._account_key for a in self._account_list])
         return len(account_set) != len(self._account_list)
 
-    def _check_valid(self, account: Union[str, TqAccount, TqKq, TqKqStock, TqSim, TqSimStock, None]):
+    def _check_valid(self, account: Union[str, 'UnionTradeable', None]):
         """
         查询委托、成交、资产、委托时, 需要指定账户实例
         account: 类型 str 表示 account_key，其他为账户类型或者 None