search

wukan1986 / thsauto

同花顺手机版模拟炒股自动化测试封装
MIT License
62 stars 20 forks source link

readme

thsauto

同花顺Android版模拟炒股自动化测试封装

目标用户

只适合资金量少的散户。自动化测试技术速度慢，稳定性也一般，达不到专业人士的要求。

资金量大的个人或机构，请使用专业软件。如：迅投QMT、恒生PTrade、掘金量化、卡方科技等，或券商自研软件。 它们带扫文件单功能，能实现批量委托，速度更快。注意：软件虽支持，但券商可能不开放扫单权限，请提前向客户经理认真确认。

起源

THSTrader 项目代码优化不够，安装了大量库效率低。所以决定学习后重写。

对比

easytrader

  1. 原理：pywinauto进行鼠标键盘模拟
  2. 优点：PC版客户端可以设置省略弹出框，所以委托速度还行。下一笔约1~2秒，但赶不上专用软件的扫单功能。
  3. 缺点：PC版新客户端复制列表时需要输入验证码，由于鼠标键盘占用，所以得独占电脑

    THSTrader

  4. 原理：使用Google的UIAutomator技术进行辅助控制。使用easyocr对截图进行文本识别
  5. 优点：Android版比PC版支持的券商更多
  6. 缺点：截图识别效率太低、速度慢。截图对位置大小有要求，分辨率不能随意改动。依赖pytorch等库，还需外网下载识别模型。

    thsauto

  7. 原理：使用Google的UIAutomator技术进行辅助控制。使用XPath进行文字提取，跳过了文本识别
  8. 优点：支持的券商多。支持本地和远程，不占用鼠标键盘，不独占电脑
  9. 缺点：Android版客户端没有跳过弹出对话框的设置，所以速度要慢于PC版。下一笔约3~5秒。目前还无法与无障碍工具联动

uiautomator2的局限

  1. 查询界面时，不可见部分查询不到，需要滑动实现
  2. 无法遍历列表控件，通过滑动变通实现，很难保证不重复、不遗漏
  3. 持仓列表不会重复，委托列表由于报单速度慢，重复的可能性小
  4. 设置分辨率长屏，同时显示更多行，需要滑动的次数少，能缓解此局限
  5. 可惜，目前无法与无障碍服务共存

安装

# 普通版
pip install -U thsauto
# CLI版和Web版
pip install -U thsauto[cli]

或二次开发

git clone --depth=1 https://github.com/wukan1986/thsauto.git
cd thsauto
pip install -e .[cli]

安装雷电模拟器

下载页：https://ldmnq.com/other/version-history-and-release-notes.html
安装包名类似于ldinst_9.0.57.2.exe，约400MB~500MB，而不是ldplayer9_ld_112_ld.exe（约3MB）

模拟器设置分辨率

  1. 软件设置 -> 性能设置 -> 手机版 ->720*1280(dpi 320)
    • 此分变率在weditor显示中正好匹配，可用于二次开发。
  2. 自定义-> 360*1500(dpi 180)
    • 实盘时，此分变率在本人电脑2560*1600下比较合适
    • 宽360小于720，字体小，界面中可以显示更多行
    • 高1500小于1600，能显示更多行，又能防止长屏过长时软件界面压缩导致界面模糊
    • dpi 120与dpi 180显示的委托列表行数一样多，目前使用的dpi 180

安装同花顺APP

下载页：https://m.10jqka.com.cn/ 右上角按钮进行下载。需下载Android版(文件扩展名为apk)

安装配置ADB

将安装路径D:\leidian\LDPlayer9添加到环境变量后可在控制台中使用adb命令

测试连接模拟器

查看模拟器设备名，一般默认值为emulator-5554

adb kill-server
adb devices

演示

本自动化测试工具没有登录和切换账号功能，所以需要用户自己先打开指定界面。

  1. 打开同花顺APP
  2. 最下导航栏 -> 交易
  3. 最上导航栏 -> 模拟 或 A股
  4. 点击中间区域（买入、卖出、撤单、持仓、查询）五个图标按钮中任意一个，即可进入交易界面
  5. 然后可以运行demo.py
  6. 注意：任何步骤执行完毕，都不应当出现弹出对话框未关闭的情况，否则会阻断之后的执行。如果遇到能复现的错误，请截图并保留日志

VSCode运行demo示例

from thsauto import THS

# 初次使用请在`debug=True`模式下多测试几次
# 再次测试在模拟炒股下再开启`debug=False`
# 然后再在其它账号下`debug=True`模式下测试
# 最后是其它账号下`debug=False`下交易
t = THS(debug=True, skip_popup=False)
t.connect(addr="emulator-5554")

# 资产
t.get_balance()
"""
{'总资产': 200202.81,
 '浮动盈亏': 202.81,
 '当日参考盈亏': 89.01,
 '当日参考盈亏率': 0.0004,
 '持仓市值': 12454.0,
 '可用资金': 172459.9,
 '可取资金': 0.0}
"""

# 持仓
t.get_positions()
"""
    名称  市值  盈亏  盈亏率 持仓  可用  成本  现价
0   美的集团    5526.0  2.23    0.00040 100 100 55.238  55.26
1   招商银行    3156.0  11.00   0.00350 100 100 31.450  31.56
2   万科A 2688.0  196.92  0.07908 200 0   12.455  13.44
3   贵州轮胎    705.0   -5.22   -0.00730    100 100 7.102   7.05
4   中国银行    379.0   -2.12   -0.00560    100 100 3.811   3.79
"""

# 委托
t.get_orders(break_after_done=True)
"""
名称  委托时间    委托价 成交均价    委托量 已成交量    买卖  状态
0   浦发银行    21:16:56    5.00    0.0 100 0   买入  未成交
1   浦发银行    21:14:41    10.50   0.0 100 0   买入  未成交
2   浦发银行    10:07:39    10.50   0.0 100 0   买入  未成交
3   浦发银行    02:15:10    10.50   0.0 100 0   买入  未成交
4   浦发银行    01:50:09    10.50   0.0 100 0   买入  未成交
5   万科A 22:10:22    10.00   0.0 100 0   卖出  未成交
6   万科A 21:48:15    15.00   0.0 100 0   卖出  未成交
7   白云机场    16:58:46    11.76   0.0 200 0   买入  未成交
8   白云机场    16:26:47    11.76   0.0 100 0   买入  未成交
9   白云机场    16:58:37    11.76   0.0 100 0   买入  全部撤单
10  白云机场    16:27:05    11.76   0.0 200 0   买入  全部撤单
"""

# 委托。未处理的原始数据
t.orders
"""
[('浦发银行', '21:16:56', '5.000', '0.000', '100', '0', '买入', '未成交'),
 ('浦发银行', '21:14:41', '10.500', '0.000', '100', '0', '买入', '未成交'),
 ('浦发银行', '10:07:39', '10.500', '0.000', '100', '0', '买入', '未成交'),
 ('浦发银行', '02:15:10', '10.500', '0.000', '100', '0', '买入', '未成交'),
 ('浦发银行', '01:50:09', '10.500', '0.000', '100', '0', '买入', '未成交'),
 ('万  科 A', '22:10:22', '10.000', '0.000', '100', '0', '卖出', '未成交'),
 ('万  科 A', '21:48:15', '15.000', '0.000', '100', '0', '卖出', '未成交'),
 ('白云机场', '16:58:46', '11.760', '0.000', '200', '0', '买入', '未成交'),
 ('白云机场', '16:26:47', '11.760', '0.000', '100', '0', '买入', '未成交'),
 ('白云机场', '16:58:37', '11.760', '0.000', '100', '0', '买入', '全部撤单'),
 ('白云机场', '16:27:05', '11.760', '0.000', '200', '0', '买入', '全部撤单')]
"""

# 支持股票代码
confirm, prompt = t.buy(100, 5, code='600000')
confirm, prompt
"""
({'标题': '委托买入确认',
  '账户': 'A516832234',
  '名称': '浦发银行',
  '代码': '600000',
  '数量': 100,
  '价格': 5.0},
 {'标题': '系统信息', '内容': '委托已提交，合同号为：3672942466'})
"""

# 撤第一条
confirm, prompt = t.cancel_single(t.order_at(0))
confirm, prompt
"""
({'标题': '委托撤单确认',
  '操作': '撤买入单',
  '名称': '浦发银行',
  '代码': '600000',
  '数量': 100,
  '价格': 5.0},
 {})
"""

Web服务

为实现跨语言的调用，还使用FastAPI实现了Web服务。注意：需使用pip install -U thsauto[cli]安装

# 启动Web服务
# python -m thsauto run --host=0.0.0.0 --port=5000
thsauto run --host=0.0.0.0 --port=5000

# 支持的Web请求
curl http://127.0.0.1:5000/connect?addr=emulator-5554
curl http://127.0.0.1:5000/refresh
curl http://127.0.0.1:5000/get_balance
curl http://127.0.0.1:5000/get_positions
curl http://127.0.0.1:5000/get_orders
curl http://127.0.0.1:5000/order_at/0  # get_orders后的顺序
curl http://127.0.0.1:5000/buy?qty=100&price=nan&code=000001
curl http://127.0.0.1:5000/sell?qty=100&price=5.1&code=000001
curl http://127.0.0.1:5000/cancels/all # 支持的参数all buy sell
curl http://127.0.0.1:5000/cancel/0  # get_orders后的顺序

CLI命令

同时还提供了CLI接口，它实际上访问Web服务来实现相应功能，所以需先启动服务。注意：需使用pip install -U thsauto[cli]安装

# 启动Web服务
thsauto run --host=0.0.0.0 --port=5000

# 支持的CLI指令
thsauto connect --addr=emulator-5554
thsauto refresh
thsauto get_balance
thsauto get_positions
thsauto get_orders
thsauto order_at --idx=0
thsauto buy --qty=100 --price=nan --code=000001
thsauto sell --qty=100 --price=5.1 --code=000001
thsauto cancels --opt=all
thsauto cancel --idx=0

如果之前启动时使用的是特殊IP和端口，可以通过环境变量临时设定

# 启动Web服务
thsauto run --host=127.0.0.1 --port=8080

# Windows平台设置环境变量
set THSAUTO_HOST=127.0.0.1
set THSAUTO_PORT=8080
thsauto connect --addr=emulator-5554

# Linux平台设置环境变量
export THSAUTO_HOST=127.0.0.1
export THSAUTO_PORT=8080
thsauto connect --addr=emulator-5554

聚宽远程下单

本功能基于Web服务和CLI命令

  1. Web服务: 安装在远程云服务器上，接收来自聚宽的HTTP请求
  2. CLI命令: 部署在客户端，将Python调用转换成HTTP请求

仅复制cli.py文件或代码到聚宽中，部分修改调用。详情参考joinquant示例