Skip to content

Commit 0dbee5b

Browse files
shinny-hongyanshinny-hongyan
authored
Update Version 3.8.8
1 parent 492f56f commit 0dbee5b

17 files changed

+321
-39
lines changed

‎PKG-INFO‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
Metadata-Version: 2.1
22
Name: tqsdk
3-
Version: 3.8.7
3+
Version: 3.8.8
44
Summary: TianQin SDK
55
Home-page: https://www.shinnytech.com/tqsdk
66
Author: TianQin
@@ -10,7 +10,7 @@ Platform: UNKNOWN
1010
Classifier: Programming Language :: Python :: 3
1111
Classifier: License :: OSI Approved :: Apache Software License
1212
Classifier: Operating System :: OS Independent
13-
Requires-Python: >=3.7
13+
Requires-Python: >=3.8
1414
Description-Content-Type: text/markdown
1515
License-File: LICENSE
1616

@@ -20,7 +20,7 @@ License-File: LICENSE
2020
<p align="center">
2121
<img src ="https://img.shields.io/pypi/v/tqsdk?color=blueviolet">
2222
<img src ="https://img.shields.io/badge/platform-windows|linux|macos-green.svg"/>
23-
<img src ="https://img.shields.io/badge/python-3.7+-blue.svg" />
23+
<img src ="https://img.shields.io/badge/python-3.8+-blue.svg" />
2424
<img src ="https://img.shields.io/pypi/dm/tqsdk?color=yellowgreen">
2525
<img src ="https://img.shields.io/github/license/shinnytech/tqsdk-python.svg?color=orange"/>
2626
</p>
@@ -87,7 +87,7 @@ TqSdk提供的功能可以支持从简单到复杂的各类策略程序：
8787

8888
## 安装方法
8989

90-
TqSdk 仅支持 Python 3.7 及更高版本。要安装 TqSdk，可使用 pip：
90+
TqSdk 仅支持 Python 3.8 及更高版本。要安装 TqSdk，可使用 pip：
9191

9292
```bash
9393
pip install tqsdk

‎README.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
<p align="center">
55
<img src ="https://img.shields.io/pypi/v/tqsdk?color=blueviolet">
66
<img src ="https://img.shields.io/badge/platform-windows|linux|macos-green.svg"/>
7-
<img src ="https://img.shields.io/badge/python-3.7+-blue.svg" />
7+
<img src ="https://img.shields.io/badge/python-3.8+-blue.svg" />
88
<img src ="https://img.shields.io/pypi/dm/tqsdk?color=yellowgreen">
99
<img src ="https://img.shields.io/github/license/shinnytech/tqsdk-python.svg?color=orange"/>
1010
</p>
@@ -71,7 +71,7 @@ TqSdk提供的功能可以支持从简单到复杂的各类策略程序：
7171

7272
## 安装方法
7373

74-
TqSdk 仅支持 Python 3.7 及更高版本。要安装 TqSdk，可使用 pip：
74+
TqSdk 仅支持 Python 3.8 及更高版本。要安装 TqSdk，可使用 pip：
7575

7676
```bash
7777
pip install tqsdk

‎doc/advanced/emergency_stop.rst‎

Lines changed: 53 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,53 @@
1+
.. _emergency_stop:
2+
3+
在外出环境下的紧急停止方案
4+
=================================================
5+
6+
在实际交易中, 难免会遇到人在外面、无法第一时间回到电脑前, 但又需要 **立刻阻止策略继续报单** 的情况。
7+
对于这类极端场景, 可以准备一套 **从物理链路上阻断报单** 的“最后一道防线”——使用远程遥控插座控制电脑或网络设备的供电。
8+
9+
.. note::
10+
11+
如果可以正常远程登录到运行环境, 仍然 **优先通过程序自身的退出/风控逻辑** 来停止策略;
12+
本文介绍的方案只用于“网络中断、远程工具失效、程序卡死/死循环”等, 无法正常操作时的 **兜底紧急手段** 。
13+
14+
15+
适用场景
16+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
17+
18+
下面这些场景都可以考虑使用远程遥控插座作为补充手段:
19+
20+
* 人不在机房/办公室, 无法直接操作运行策略的电脑
21+
* 远程桌面/VPN 无法连接, 不能登录服务器手动停止程序
22+
* 运行环境网络异常, 与远程服务器或交易终端的会话建立/恢复失败
23+
* 程序出现死循环、界面无响应, 无法通过常规方式优雅退出
24+
* 需要在数秒～数十秒内阻止程序继续发出新的报单
25+
26+
27+
推荐做法: 使用远程遥控插座
28+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
29+
30+
市面上有很多可以通过手机 App 控制的 **远程遥控插座/智能插座** , 一般具备以下能力:
31+
32+
* 支持 4G/5G 或通过家庭/公司网络连接互联网
33+
* 在手机上安装 App 后, 可以远程开/关插座电源
34+
* 一键断电, 立刻切断下游设备的供电或网络
35+
36+
对于无人监控环境下运行的策略, 可以从物理链路上做如下配置:
37+
38+
* 将 **运行策略的电脑/服务器电源** 接在远程遥控插座上, 需要紧急停机时, 在手机 App 中关断插座电源, 电脑随之断电, 程序立即停止, 不会再继续报单
39+
* 或者, 将 **用于联网的路由器/交换机等网络设备电源** 接在远程遥控插座上, 紧急情况下关闭插座, 网络被切断, 程序虽然暂时仍在运行, 但已无法向交易服务器发送新的报单
40+
41+
42+
重要提示
43+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
44+
45+
.. warning::
46+
47+
通过远程遥控插座断电, 对电脑来说相当于“强制断电”, 可能造成未保存数据丢失,
48+
请只在 **确属紧急情况** 时使用。
49+
50+
该方案的主要目的在于 **尽快阻止程序继续发送报单** , 而不是优雅关闭系统;
51+
日常风险控制仍应依赖合理的仓位管理、风控规则和监控告警, 远程插座仅作为极端情况下的补充。
52+
53+

‎doc/advanced/index.rst‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -15,5 +15,6 @@
1515
for_vnpy_user.rst
1616
for_ctp_user.rst
1717
unanttended.rst
18+
emergency_stop.rst
1819
targetpostask2.rst
1920
scheduler.rst

‎doc/conf.py‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -48,9 +48,9 @@
4848
# built documents.
4949
#
5050
# The short X.Y version.
51-
version = u'3.8.7'
51+
version = u'3.8.8'
5252
# The full version, including alpha/beta/rc tags.
53-
release = u'3.8.7'
53+
release = u'3.8.8'
5454

5555
# The language for content autogenerated by Sphinx. Refer to documentation
5656
# for a list of supported languages.

‎doc/index.rst‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,7 @@ TianQin Python Sdk User Guide
2222
tq_trading_unit.rst
2323
advanced/index.rst
2424
tqsdk_cursor.rst
25+
tqsdk_trae.rst
2526
dev_general.rst
2627
dev_framework.rst
2728
profession.rst

‎doc/quickstart.rst‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@
2424
-------------------------------------------------
2525
天勤量化的核心是TqSdk开发包, 在安装天勤量化 (TqSdk) 前, 你需要先准备适当的环境和Python包管理工具, 包括:
2626

27-
* Python >=3.7,3.8,3.9,3.10,3.11,3.12 版本
27+
* Python >= 3.8 版本
2828
* Windows 7 以上版本, Mac Os, 或 Linux
2929

3030

‎doc/tq_trading_unit.rst‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -113,6 +113,16 @@ TqSdk 多策略使用手册
113113
=========
114114
使用 `pip install -U --upgrade-strategy eager tqsdk-zq` 更新多策略功能所有依赖包
115115

116+
.. line-block::
117+
**2025/12/10**
118+
tqsdk-zq: 1.0.3
119+
tqsdk-zq-server: 1.0.6
120+
tqsdk-zq-history: 1.0.0
121+
tqsdk-zq-pgserver: 1.0.0
122+
tqsdk-zq-proxy: 1.0.0
123+
124+
* 修复: 撤单失败的问题
125+
116126
.. line-block::
117127
**2025/06/16**
118128
tqsdk-zq: 1.0.3

‎doc/tqsdk_trae.rst‎

Lines changed: 181 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,181 @@
1+
.. _tqsdk_trae:
2+
3+
============================================
4+
在 Trae 中高效学习和使用 TqSdk
5+
============================================
6+
7+
8+
9+
Trae：TqSdk 开发与学习的 AI 助手
10+
===================================
11+
12+
Trae 简介
13+
-------------
14+
15+
Trae 是一款 AI 原生的智能开发环境，旨在将大模型的理解、生成与协作能力深度融入日常编码流程。它支持对话式编程（Chat/Agent）、代码补全与多处位点修改、项目级生成（Builder）、实时预览与调试等能力，帮助开发者在同一环境内完成从构思到实现与迭代的闭环。
16+
17+
在 TqSdk 开发中使用 Trae 的好处
18+
----------------------------------
19+
20+
对于 TqSdk 用户而言，使用 Trae 进行开发与学习具有以下优势：
21+
22+
* **快速理解 TqSdk API 与概念**：
23+
* 面向 TqSdk 的类（如 ``TqApi``, ``TqAccount``）、函数或交易概念（如 ``KLine``, ``Backtest``, ``target_pos``）提出问题，获得结构化解释与示例。
24+
* 在编辑器内就地查询函数参数、返回值及常见用法。
25+
* **高效编写与改造策略代码**：
26+
* **对话生成**：用自然语言描述策略需求，如“订阅多个合约的 tick 并统计成交量阈值报警”，“基于布林带的简易开平仓框架”。
27+
* **智能补全与批量修改**：基于上下文提供更契合的补全，并可对多处代码进行一致性修改与重构建议。
28+
* **智能辅助调试**：
29+
* **错误分析与定位**：粘贴错误堆栈和相关代码，获得原因分析与修复建议。
30+
* **深入学习与理解源码**：
31+
* 将 TqSdk 源码加入工作区后，可让 AI 针对具体模块/函数解释实现思路和设计取舍。
32+
* **项目级上下文感知**：结合项目代码结构与依赖，回答更贴合当前工程语境。
33+
34+
开始使用 Trae
35+
================
36+
37+
下载和安装 Trae
38+
-----------------
39+
40+
1. 访问 Trae 官方下载页面（请根据您组织/渠道提供的地址获取安装包）。
41+
2. 根据您的操作系统（Windows, macOS, Linux）下载对应安装包。
42+
3. 按向导完成安装并启动 Trae。
43+
44+
初次启动与界面要点
45+
-------------------
46+
47+
1. **登录/账户**：根据产品要求完成登录或激活。
48+
2. **界面区域**：文件资源管理器、编辑器区、终端/调试区与 AI 对话/智能体入口。
49+
3. **AI 入口**：可通过侧边栏或工具栏打开 Chat/Agent 面板，进行上下文对话与代码指令。
50+
51+
在 Trae 中配置 TqSdk 开发环境
52+
===============================
53+
54+
创建或打开您的 TqSdk 项目
55+
----------------------------
56+
57+
1. 在 Trae 中创建新工程或通过“打开文件夹”导入现有的 TqSdk 项目根目录。
58+
59+
配置 Python 解释器
60+
--------------------
61+
62+
确保 Trae 使用您期望的 Python 解释器/环境来运行 TqSdk 代码。常用做法：
63+
64+
1. 在 Trae 的设置或状态栏中选择目标 Python 解释器（如系统 Python、venv、Conda 环境等）。
65+
2. 或在 Trae 集成终端中激活虚拟环境（例如 ``venv/Scripts/activate`` 或 ``conda activate <env>``）。
66+
67+
安装 TqSdk 库
68+
--------------
69+
70+
在 Trae 的集成终端中（确保已选定正确解释器/已激活环境），执行：::
71+
72+
pip install tqsdk
73+
74+
可用以下命令验证安装： ``python -c "import tqsdk; print(tqsdk.__version__)"`` 。若提示 ``pip`` 未找到，请使用 ``python -m pip install tqsdk`` 或检查环境变量设置。
75+
76+
让 Trae 深度理解 TqSdk：打开源码 (推荐)
77+
=========================================
78+
79+
将 TqSdk 源码加入工作区，可显著提升 AI 对实现细节与 API 的理解质量。
80+
81+
操作步骤
82+
---------
83+
84+
1. **获取 TqSdk 源码**：
85+
* **方式一（深入研究推荐）**：从官方仓库克隆：::
86+
87+
git clone https://github.com/shinnytech/tqsdk-python.git
88+
89+
记下其中的 ``tqsdk`` 源码目录。
90+
* **方式二（快速查阅已安装版本）**：定位到当前 Python 环境的 ``site-packages`` 目录中的 ``tqsdk`` 包路径（如 Windows 的 ``.../Lib/site-packages/tqsdk``）。
91+
2. **添加到 Trae 工作区**：
92+
* 在已打开的项目中，将上述 ``tqsdk`` 源码文件夹添加到工作区（使用“添加文件夹到工作区”或等效入口）。
93+
3. **效果**：
94+
* 之后可直接在工作区浏览 TqSdk 源码，AI 对应答与代码生成将更贴近真实实现。
95+
96+
在 Trae 中提问和学习 TqSdk
97+
=============================
98+
99+
如何提问？
100+
-----------
101+
102+
打开 Trae 的 AI Chat/Agent 面板后，您可以：
103+
104+
* **直接提问**：输入关于 TqSdk 的问题。
105+
* **选中代码后提问**：选中一段 TqSdk 代码并发起对话，让 AI 以上下文模式进行解释、优化或缺陷分析。
106+
107+
提问示例
108+
---------
109+
110+
**基础概念与用法：**
111+
112+
* “TqSdk 中 ``TqApi`` 与 ``TqAccount`` 的关系与区别是什么？”
113+
* “如何获取 ``SHFE.rb2410`` 的 1 分钟 K 线？请给完整示例。”
114+
* “回测 ``TqBacktest`` 的 ``start_dt`` 和 ``end_dt`` 该如何设置？”
115+
* “``insert_order`` 的 ``limit_price`` 与 ``offset`` 参数如何使用？”
116+
117+
**结合源码提问（已将源码加入工作区）：**
118+
119+
* “``@tqsdk/trade.py`` 中 ``TdApi`` 的 ``_on_rsp_order_insert`` 做了什么？”
120+
* “我在看 ``@tqsdk/tools/downloader.py``，该下载器支持哪些数据类型？”
121+
122+
**错误排查：**
123+
124+
* “运行以下代码时报错 ``...``（附完整堆栈），可能原因是什么？如何修复？”
125+
126+
利用 AI 进行 TqSdk 代码生成与修改
127+
---------------------------------
128+
129+
* **生成代码片段**：
130+
* “写个函数，输入合约列表，批量订阅这些合约的盘口行情 ``quote``。”
131+
* “用 ``TqSim`` 做模拟交易，当资金变化超过 5% 时发送通知的框架。”
132+
* **修改现有代码（选中后发起）**：
133+
* “将这段 TqSdk 代码的 ``datetime`` 格式化为 ``YYYY-MM-DD HH:MM:SS``。”
134+
* “为下单逻辑增加条件：只有当最新价大于过去 20 周期均线时才开多。”
135+
* “重构策略：将行情处理与交易决策拆成独立函数。”
136+
137+
调试 TqSdk 代码
138+
----------------
139+
140+
Trae 提供集成调试能力（具体入口与配置以实际版本为准）。
141+
142+
1. **设置断点**：在行号旁点击设置断点。
143+
2. **启动调试**：在运行/调试面板选择相应 Python 配置（如“Python File”或配置的调试任务）。
144+
3. **AI 辅助调试**：调试中若遇到异常或变量状态不明，可将相关片段与变量值粘贴到对话中，请求解释或给出下一步排查建议。
145+
146+
高效提问的技巧
147+
===============
148+
149+
为获得准确与可操作的回答，建议：
150+
151+
* **问题明确具体**：避免过于笼统。
152+
* **提供上下文**：
153+
* 涉及代码时，附上相关片段。
154+
* 发生错误时，附完整堆栈与复现步骤。
155+
* 若已加入 TqSdk 源码，指明相关模块或符号位置（例如 ``@tqsdk/...`` 风格的文件/符号提示）。
156+
* **逐步拆解**：复杂问题分步提问。
157+
* **说明版本**：如 Python 版本、TqSdk 版本、依赖（pandas/NumPy 等）版本。
158+
* **共享尝试**：说明已尝试方案与结果，便于更精准的建议。
159+
* **迭代追问**：基于首次回答继续澄清与收敛。
160+
161+
162+
使用建议
163+
--------
164+
165+
1. 在 AI 对话中说明您的需求与版本信息（如 Python 3.11、pandas 2.2、NumPy 2.x）。
166+
2. 在合适的平台（若支持）启用 Context7 后，配合工作区源码一起提问，获得“规范 + 实现”的双重校对。
167+
3. 在问题末尾添加“use context7”的提示仅在支持的平台/配置生效；在不支持的平台不会生效。
168+
169+
常见问题（FAQ）
170+
---------------
171+
172+
* “环境已选但运行用错解释器？”——在设置与集成终端中同时确认：状态栏解释器与终端激活环境需一致。
173+
* “AI 回答不贴合代码？”——将 TqSdk 源码加入工作区；提问时引用具体模块或函数；粘贴最小可复现片段。
174+
* “网络/镜像问题导致安装失败？”——优先使用内网镜像或 ``python -m pip`` 方式；必要时手动下载离线包安装。
175+
176+
总结
177+
=====
178+
179+
Trae 将 AI 深度融入开发流程，对 TqSdk 用户而言，既能加速理解与编写策略，也能在调试与源码学习上提供持续助力。我们建议您将 TqSdk 源码加入工作区，并充分利用对话生成、智能补全与调试能力，配合明确的问题与上下文描述，以获得更高质量、更高效率的开发体验。
180+
181+

‎doc/usage/kqd_symbol.rst‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,9 +4,9 @@
44
==================================================
55
板块介绍
66
--------------------------------------------------
7-
为了满足投资者对全球市场信息的需求，提供更全面、准确的投资决策支持，快期/天勤专业版上线了外盘行情（延时15分钟）
7+
为了满足投资者对全球市场信息的需求，提供更全面、准确的投资决策支持，快期专业版 / 天勤量化 上线了外盘行情（延时15分钟）
88

9-
在快期专业版总添加方式：【添加板块】 - 【系统报价表】 - 【外盘行情(延时)】
9+
在快期专业版中的添加方式：【添加板块】 - 【系统报价表】 - 【外盘行情(延时)】
1010

1111
.. figure:: /images/foreign01.png
1212

0 commit comments

Comments
 (0)