frytrader 0.1.0__tar.gz

frytrader-0.1.0/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2018 shidenggui
+Copyright (c) 2024-2026 Fryt1 (Frytrader fork)
+
+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.

frytrader-0.1.0/MANIFEST.in

@@ -0,0 +1,3 @@
+include README.md
+recursive-include easytrader/config *.json *.ahk
+recursive-include easytrader/native *.c *.def *.ps1 *.dll *.exe

frytrader-0.1.0/PKG-INFO

@@ -0,0 +1,237 @@
+Metadata-Version: 2.4
+Name: frytrader
+Version: 0.1.0
+Summary: 中国券商 GUI 交易适配器，支持同花顺远航版后台只读模式。
+Home-page: https://github.com/Fryt1/Frytrader
+Author: Fryt1
+License: MIT
+Project-URL: Source, https://github.com/Fryt1/Frytrader
+Project-URL: Tracker, https://github.com/Fryt1/Frytrader/issues
+Project-URL: Upstream, https://github.com/shidenggui/easytrader
+Keywords: china stock trade,easytrader,ths,同花顺
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Win32 (MS Windows)
+Classifier: Intended Audience :: Financial and Insurance Industry
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Office/Business :: Financial :: Investment
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.25.0
+Requires-Dist: six>=1.15.0
+Requires-Dist: easyutils>=0.1.7
+Requires-Dist: flask>=1.1.0
+Requires-Dist: pywinauto==0.6.6; sys_platform == "win32"
+Requires-Dist: pillow>=8.0.0
+Requires-Dist: pandas>=1.1.0
+Requires-Dist: pytesseract>=0.3.7
+Requires-Dist: beautifulsoup4>=4.9.0
+Requires-Dist: bs4>=0.0.1
+Requires-Dist: certifi>=2020.6.20
+Requires-Dist: chardet>=3.0.4
+Requires-Dist: click>=7.0
+Requires-Dist: cssselect>=1.1.0
+Requires-Dist: dill>=0.3.0
+Requires-Dist: idna>=2.10
+Requires-Dist: itsdangerous>=1.1.0
+Requires-Dist: jinja2>=2.11.0
+Requires-Dist: lxml>=4.6.0
+Requires-Dist: markupsafe>=1.1.0
+Requires-Dist: numpy>=1.19.0
+Requires-Dist: pyperclip>=1.8.0
+Requires-Dist: pyquery>=1.4.0
+Requires-Dist: python-dateutil>=2.8.0
+Requires-Dist: pytz>=2020.1
+Requires-Dist: urllib3>=1.26.0
+Requires-Dist: werkzeug>=1.0.0
+Provides-Extra: miniqmt
+Requires-Dist: xtquant; extra == "miniqmt"
+Provides-Extra: background
+Requires-Dist: pyvda<0.7,>=0.6.0; sys_platform == "win32" and extra == "background"
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# Frytrader
+
+[![standard-readme compliant](https://img.shields.io/badge/readme%20style-standard-brightgreen.svg?style=flat-square)](https://github.com/RichardLitt/standard-readme)
+
+中国券商 GUI 交易适配器，支持同花顺远航版免打扰后台只读模式。
+
+Frytrader 是 [EasyTrader](https://github.com/shidenggui/easytrader) 的 fork，在保留上游交易核心和 `import easytrader` 导入名的前提下，增强了验证码识别、表格导出和后台只读能力。发行包名为 `frytrader`，与 PyPI 上游的 `easytrader` 区分；Python 导入名仍为 `easytrader`，已有代码无需修改。
+
+## Table of Contents
+
+- [安全](#安全)
+- [背景](#背景)
+- [安装](#安装)
+- [用法](#用法)
+- [API](#api)
+- [配置](#配置)
+- [测试](#测试)
+- [维护者](#维护者)
+- [致谢](#致谢)
+- [贡献](#贡献)
+- [许可证](#许可证)
+
+## 安全
+
+**本库可以驱动真实券商客户端并提交真实委托。误用会造成资金损失。**
+
+- 不要将账号、密码、验证码截图或其他凭证提交到 Git、Issue 或日志。
+- 不要把交易服务暴露到公网。仓库内的 `easytrader/server.py` **无鉴权**且提供 `/buy`、`/sell`、`/cancel_entrust`，默认监听 `0.0.0.0`，不要直接对外运行。
+- GUI 自动化会遇到弹窗、客户端升级、焦点丢失和结果不明。下单前必须自行验证委托状态，不能仅凭界面返回判断成功，**结果未知时不要盲目重试**。
+- 本软件按 MIT 许可证「按原样」提供，不附带任何担保。交易决策和损失由使用者自行承担。
+
+## 背景
+
+EasyTrader 提供多种券商 GUI、雪球和 MiniQMT 适配器。Frytrader 保留上游交易核心，并针对通用 Windows GUI 客户端做了三类增强：
+
+1. **验证码识别**：多图变体 OCR、按位投票，减少误识别。
+2. **表格导出**：修正空行丢弃、陈旧数据判断和失败诊断。
+3. **后台只读模式**：任务视图隔离 + 定向控件消息 + 线程激活保护，在不抢键盘、鼠标、前台和任务视图桌面的前提下读取资金、持仓、委托与成交。
+
+本项目不是券商原生 API。GUI 路线适合低频操作，不适合高频交易。MiniQMT 是可选的另一条路径，安装 Python 依赖不授予券商权限，也不会解除券商端限制。
+
+## 安装
+
+需要 Python 3.8 或更高。GUI 客户端自动化仅在 Windows 上可用。
+
+从 PyPI 安装：
+
+```console
+$ pip install frytrader
+```
+
+从本仓库安装开发版：
+
+```console
+$ git clone https://github.com/Fryt1/Frytrader.git
+$ cd Frytrader
+$ python -m venv .venv
+$ .\.venv\Scripts\Activate.ps1
+$ python -m pip install -e .
+```
+
+安装后台模式依赖：
+
+```console
+$ python -m pip install -e ".[background]"
+```
+
+安装可选 MiniQMT 依赖：
+
+```console
+$ python -m pip install -e ".[miniqmt]"
+```
+
+验证码识别需要另行安装 [Tesseract OCR](https://github.com/UB-Mannheim/tesseract/wiki)，让 `tesseract.exe` 可从 `PATH` 访问，或在配置中指定路径。
+
+后台只读模式还需要 [AutoHotkey v2](https://www.autohotkey.com/)。程序按 `ahk_path` 参数 → `FRYTRADER_AHK` 环境变量 → `%LOCALAPPDATA%\Frytrader\runtime\AutoHotkey64.exe` → `PATH` → 常规安装目录依次查找，**不会在运行时自动下载或安装软件**。
+
+## 用法
+
+查询账户：
+
+```python
+import easytrader
+
+user = easytrader.use("universal_client")
+user.prepare(config_path="config.json")
+
+print(user.balance)
+print(user.position)
+```
+
+同花顺远航版后台只读模式（不抢焦点）：
+
+```python
+import easytrader
+
+user = easytrader.use("ths", background=True)
+try:
+    user.connect()          # 连接已登录的远航版，不启动新客户端
+    print(user.balance)
+    print(user.position)
+    print(user.today_entrusts)
+    print(user.today_trades)
+finally:
+    user.close()
+```
+
+后台模式的用时数据来自本机登录态实测：公开接口连续两轮 8 次读取全部成功，零桌面和前台干扰。资金约 0.44 秒，三类表格 1.2–6.7 秒（取决于验证码重试次数）。详见 [`docs/background.md`](docs/background.md)。
+
+**尚未验证**：非空持仓/委托/成交数据、长时间无人值守稳定性、非 x86 客户端、非 Windows 平台。
+
+## API
+
+入口为 `easytrader.use(broker)`。账户对象提供 `balance`、`position`、`today_entrusts`、`today_trades` 等查询属性，以及上游定义的 `buy`、`sell`、撤单等方法。
+
+支持的客户端类型和交易方法见 [`docs/usage.md`](docs/usage.md)，MiniQMT 见 [`docs/miniqmt.md`](docs/miniqmt.md)。
+
+后台只读模式限制：
+
+- `background=True` 仅支持 `ths`。传给其他适配器会抛 `NotImplementedError`，不会静默退回前台模式。
+- 后台模式不继承下单能力，`buy`、`sell`、`cancel_entrust`、`prepare`、`login`、`auto_ipo` 等一律抛 `PermissionError`。
+- 默认 `close()` 只停止后台执行器，不取消验证码、不搬回窗口。需要恢复窗口位置时显式调用 `user.restore_windows()`。
+
+## 配置
+
+复制 [`config.json.example`](config.json.example) 为 `config.json` 并填写账号、密码和客户端路径。`config.json` 已加入 `.gitignore`。
+
+验证码选项位于 `captcha` 对象：
+
+- `mode`：`fast`、`balanced` 或 `accurate`
+- `manual_input`：OCR 失败后是否等待手动输入；无人值守时应保持 `false`
+- `save_debug_samples`：是否把样本保存到本地 `captcha_debug` 目录，默认关闭
+- `tesseract_path`：Tesseract 可执行文件路径；`null` 表示使用系统 `PATH`
+
+这些选项只影响通用 GUI 客户端的 XLS 表格读取器，不改变券商端校验，也不赋予任何交易权限。
+
+## 测试
+
+运行离线测试（不连接真实账户）：
+
+```console
+$ python -m unittest discover -s tests -p "test_*.py"
+```
+
+`tests/test_easytrader.py` 中的集成测试受 `EZ_TEST_CLIENTS` 环境变量控制，会连接真实账户。没有隔离测试账户时不要启用。不要把真实委托作为 CI 测试。
+
+## 维护者
+
+[Fryt1](https://github.com/Fryt1)。问题请提交到 [Issues](https://github.com/Fryt1/Frytrader/issues)。
+
+## 致谢
+
+感谢 [shidenggui](https://github.com/shidenggui) 及 [EasyTrader](https://github.com/shidenggui/easytrader) 的所有贡献者提供上游项目和交易适配器。Frytrader 的发行基于其 MIT 许可证条款，原始版权声明保留在 [`LICENSE`](LICENSE) 中。
+
+## 贡献
+
+欢迎提交 Issue 和 Pull Request。提交前请：
+
+1. 说明使用的券商客户端版本和复现步骤。
+2. 移除日志、配置和截图中的账号、密码、资金等敏感信息。
+3. 涉及 GUI 或 OCR 的改动附带脱离真实账户的测试。
+
+### Contributors
+
+<a href="https://github.com/Fryt1/Frytrader/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=Fryt1/Frytrader" alt="Contributors" />
+</a>
+
+## 许可证
+
+[MIT](LICENSE) © 2018 shidenggui, © 2024-2026 Fryt1。

frytrader-0.1.0/README.md

@@ -0,0 +1,171 @@
+# Frytrader
+
+[![standard-readme compliant](https://img.shields.io/badge/readme%20style-standard-brightgreen.svg?style=flat-square)](https://github.com/RichardLitt/standard-readme)
+
+中国券商 GUI 交易适配器，支持同花顺远航版免打扰后台只读模式。
+
+Frytrader 是 [EasyTrader](https://github.com/shidenggui/easytrader) 的 fork，在保留上游交易核心和 `import easytrader` 导入名的前提下，增强了验证码识别、表格导出和后台只读能力。发行包名为 `frytrader`，与 PyPI 上游的 `easytrader` 区分；Python 导入名仍为 `easytrader`，已有代码无需修改。
+
+## Table of Contents
+
+- [安全](#安全)
+- [背景](#背景)
+- [安装](#安装)
+- [用法](#用法)
+- [API](#api)
+- [配置](#配置)
+- [测试](#测试)
+- [维护者](#维护者)
+- [致谢](#致谢)
+- [贡献](#贡献)
+- [许可证](#许可证)
+
+## 安全
+
+**本库可以驱动真实券商客户端并提交真实委托。误用会造成资金损失。**
+
+- 不要将账号、密码、验证码截图或其他凭证提交到 Git、Issue 或日志。
+- 不要把交易服务暴露到公网。仓库内的 `easytrader/server.py` **无鉴权**且提供 `/buy`、`/sell`、`/cancel_entrust`，默认监听 `0.0.0.0`，不要直接对外运行。
+- GUI 自动化会遇到弹窗、客户端升级、焦点丢失和结果不明。下单前必须自行验证委托状态，不能仅凭界面返回判断成功，**结果未知时不要盲目重试**。
+- 本软件按 MIT 许可证「按原样」提供，不附带任何担保。交易决策和损失由使用者自行承担。
+
+## 背景
+
+EasyTrader 提供多种券商 GUI、雪球和 MiniQMT 适配器。Frytrader 保留上游交易核心，并针对通用 Windows GUI 客户端做了三类增强：
+
+1. **验证码识别**：多图变体 OCR、按位投票，减少误识别。
+2. **表格导出**：修正空行丢弃、陈旧数据判断和失败诊断。
+3. **后台只读模式**：任务视图隔离 + 定向控件消息 + 线程激活保护，在不抢键盘、鼠标、前台和任务视图桌面的前提下读取资金、持仓、委托与成交。
+
+本项目不是券商原生 API。GUI 路线适合低频操作，不适合高频交易。MiniQMT 是可选的另一条路径，安装 Python 依赖不授予券商权限，也不会解除券商端限制。
+
+## 安装
+
+需要 Python 3.8 或更高。GUI 客户端自动化仅在 Windows 上可用。
+
+从 PyPI 安装：
+
+```console
+$ pip install frytrader
+```
+
+从本仓库安装开发版：
+
+```console
+$ git clone https://github.com/Fryt1/Frytrader.git
+$ cd Frytrader
+$ python -m venv .venv
+$ .\.venv\Scripts\Activate.ps1
+$ python -m pip install -e .
+```
+
+安装后台模式依赖：
+
+```console
+$ python -m pip install -e ".[background]"
+```
+
+安装可选 MiniQMT 依赖：
+
+```console
+$ python -m pip install -e ".[miniqmt]"
+```
+
+验证码识别需要另行安装 [Tesseract OCR](https://github.com/UB-Mannheim/tesseract/wiki)，让 `tesseract.exe` 可从 `PATH` 访问，或在配置中指定路径。
+
+后台只读模式还需要 [AutoHotkey v2](https://www.autohotkey.com/)。程序按 `ahk_path` 参数 → `FRYTRADER_AHK` 环境变量 → `%LOCALAPPDATA%\Frytrader\runtime\AutoHotkey64.exe` → `PATH` → 常规安装目录依次查找，**不会在运行时自动下载或安装软件**。
+
+## 用法
+
+查询账户：
+
+```python
+import easytrader
+
+user = easytrader.use("universal_client")
+user.prepare(config_path="config.json")
+
+print(user.balance)
+print(user.position)
+```
+
+同花顺远航版后台只读模式（不抢焦点）：
+
+```python
+import easytrader
+
+user = easytrader.use("ths", background=True)
+try:
+    user.connect()          # 连接已登录的远航版，不启动新客户端
+    print(user.balance)
+    print(user.position)
+    print(user.today_entrusts)
+    print(user.today_trades)
+finally:
+    user.close()
+```
+
+后台模式的用时数据来自本机登录态实测：公开接口连续两轮 8 次读取全部成功，零桌面和前台干扰。资金约 0.44 秒，三类表格 1.2–6.7 秒（取决于验证码重试次数）。详见 [`docs/background.md`](docs/background.md)。
+
+**尚未验证**：非空持仓/委托/成交数据、长时间无人值守稳定性、非 x86 客户端、非 Windows 平台。
+
+## API
+
+入口为 `easytrader.use(broker)`。账户对象提供 `balance`、`position`、`today_entrusts`、`today_trades` 等查询属性，以及上游定义的 `buy`、`sell`、撤单等方法。
+
+支持的客户端类型和交易方法见 [`docs/usage.md`](docs/usage.md)，MiniQMT 见 [`docs/miniqmt.md`](docs/miniqmt.md)。
+
+后台只读模式限制：
+
+- `background=True` 仅支持 `ths`。传给其他适配器会抛 `NotImplementedError`，不会静默退回前台模式。
+- 后台模式不继承下单能力，`buy`、`sell`、`cancel_entrust`、`prepare`、`login`、`auto_ipo` 等一律抛 `PermissionError`。
+- 默认 `close()` 只停止后台执行器，不取消验证码、不搬回窗口。需要恢复窗口位置时显式调用 `user.restore_windows()`。
+
+## 配置
+
+复制 [`config.json.example`](config.json.example) 为 `config.json` 并填写账号、密码和客户端路径。`config.json` 已加入 `.gitignore`。
+
+验证码选项位于 `captcha` 对象：
+
+- `mode`：`fast`、`balanced` 或 `accurate`
+- `manual_input`：OCR 失败后是否等待手动输入；无人值守时应保持 `false`
+- `save_debug_samples`：是否把样本保存到本地 `captcha_debug` 目录，默认关闭
+- `tesseract_path`：Tesseract 可执行文件路径；`null` 表示使用系统 `PATH`
+
+这些选项只影响通用 GUI 客户端的 XLS 表格读取器，不改变券商端校验，也不赋予任何交易权限。
+
+## 测试
+
+运行离线测试（不连接真实账户）：
+
+```console
+$ python -m unittest discover -s tests -p "test_*.py"
+```
+
+`tests/test_easytrader.py` 中的集成测试受 `EZ_TEST_CLIENTS` 环境变量控制，会连接真实账户。没有隔离测试账户时不要启用。不要把真实委托作为 CI 测试。
+
+## 维护者
+
+[Fryt1](https://github.com/Fryt1)。问题请提交到 [Issues](https://github.com/Fryt1/Frytrader/issues)。
+
+## 致谢
+
+感谢 [shidenggui](https://github.com/shidenggui) 及 [EasyTrader](https://github.com/shidenggui/easytrader) 的所有贡献者提供上游项目和交易适配器。Frytrader 的发行基于其 MIT 许可证条款，原始版权声明保留在 [`LICENSE`](LICENSE) 中。
+
+## 贡献
+
+欢迎提交 Issue 和 Pull Request。提交前请：
+
+1. 说明使用的券商客户端版本和复现步骤。
+2. 移除日志、配置和截图中的账号、密码、资金等敏感信息。
+3. 涉及 GUI 或 OCR 的改动附带脱离真实账户的测试。
+
+### Contributors
+
+<a href="https://github.com/Fryt1/Frytrader/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=Fryt1/Frytrader" alt="Contributors" />
+</a>
+
+## 许可证
+
+[MIT](LICENSE) © 2018 shidenggui, © 2024-2026 Fryt1。

frytrader-0.1.0/easytrader/__init__.py

@@ -0,0 +1,11 @@
+# -*- coding: utf-8 -*-
+import urllib3
+
+from easytrader import exceptions
+from easytrader.api import use, follower
+from easytrader.log import logger
+
+urllib3.disable_warnings(urllib3.exceptions.InsecureRequestWarning)
+
+__version__ = "0.1.0"
+__author__ = "shidenggui, Fryt1"

frytrader-0.1.0/easytrader/api.py

@@ -0,0 +1,128 @@
+# -*- coding: utf-8 -*-
+import logging
+import sys
+
+import six
+
+from easytrader.joinquant_follower import JoinQuantFollower
+from easytrader.log import logger
+from easytrader.ricequant_follower import RiceQuantFollower
+from easytrader.xq_follower import XueQiuFollower
+from easytrader.xqtrader import XueQiuTrader
+
+if sys.version_info <= (3, 5):
+    raise TypeError("不支持 Python3.5 及以下版本，请升级")
+
+
+def use(broker, debug=False, **kwargs):
+    """用于生成特定的券商对象
+    :param broker: 券商名支持 
+        例如 ['miniqmt', 'xq', '雪球', 'gj_client', '国金客户端', "universal_client", "通用同花顺客户端", "ths", "同花顺客户端"] 等
+    :param debug: 控制 debug 日志的显示, 默认为 False
+    :param initial_assets: [雪球参数] 控制雪球初始资金，默认为一百万
+    :return the class of trader
+
+    Usage::
+
+        >>> import easytrader
+        >>> user = easytrader.use('xq')
+        >>> user.prepare('xq.json')
+    """
+    if "background" in kwargs:
+        if not isinstance(kwargs["background"], bool):
+            raise TypeError("background 必须是布尔值")
+        if kwargs["background"] and broker.lower() not in (
+            "ths", "同花顺客户端"
+        ):
+            raise NotImplementedError("后台只读模式仅支持 ths 远航版")
+
+    if debug:
+        logger.setLevel(logging.DEBUG)
+
+    if broker.lower() in ["xq", "雪球"]:
+        return XueQiuTrader(**kwargs)
+
+    if broker.lower() in ["yh_client", "银河客户端"]:
+        from .yh_clienttrader import YHClientTrader
+
+        return YHClientTrader()
+
+    if broker.lower() in ["ht_client", "华泰客户端"]:
+        from .ht_clienttrader import HTClientTrader
+
+        return HTClientTrader()
+
+    if broker.lower() in ["wk_client", "五矿客户端"]:
+        from easytrader.wk_clienttrader import WKClientTrader
+
+        return WKClientTrader()
+
+    if broker.lower() in ["htzq_client", "海通证券客户端"]:
+        from easytrader.htzq_clienttrader import HTZQClientTrader
+
+        return HTZQClientTrader()
+
+    if broker.lower() in ["gj_client", "国金客户端"]:
+        from .gj_clienttrader import GJClientTrader
+
+        return GJClientTrader()
+
+    if broker.lower() in ["gf_client", "广发客户端"]:
+        from .gf_clienttrader import GFClientTrader
+
+        return GFClientTrader()
+
+    if broker.lower() in ["universal_client", "通用同花顺客户端"]:
+        from easytrader.universal_clienttrader import UniversalClientTrader
+
+        return UniversalClientTrader()
+
+    if broker.lower() in ["ths", "同花顺客户端"]:
+        background = kwargs.pop("background", False)
+        if not isinstance(background, bool):
+            raise TypeError("background 必须是布尔值")
+        if background:
+            from .background_trader import BackgroundThsTrader
+
+            return BackgroundThsTrader(**kwargs)
+        from .clienttrader import ClientTrader
+
+        return ClientTrader()
+    
+    if broker.lower() in ["miniqmt"]:
+        try:
+            import xtquant
+        except:
+            logger.error("miniqmt 相关组件 xtqimt 未安装, 请执行 pip install easytrader[xtquant]安装")
+        from easytrader.miniqmt.miniqmt_trader import MiniqmtTrader
+
+        return MiniqmtTrader()
+
+    raise NotImplementedError
+
+
+def follower(platform, **kwargs):
+    """用于生成特定的券商对象
+    :param platform:平台支持 ['jq', 'joinquant', '聚宽’]
+    :param initial_assets: [雪球参数] 控制雪球初始资金，默认为一万,
+        总资金由 initial_assets * 组合当前净值 得出
+    :param total_assets: [雪球参数] 控制雪球总资金，无默认值,
+        若设置则覆盖 initial_assets
+    :return the class of follower
+
+    Usage::
+
+        >>> import easytrader
+        >>> user = easytrader.use('xq')
+        >>> user.prepare('xq.json')
+        >>> jq = easytrader.follower('jq')
+        >>> jq.login(user='username', password='password')
+        >>> jq.follow(users=user, strategies=['strategies_link'])
+    """
+    if platform.lower() in ["rq", "ricequant", "米筐"]:
+        return RiceQuantFollower()
+    if platform.lower() in ["jq", "joinquant", "聚宽"]:
+        return JoinQuantFollower()
+    if platform.lower() in ["xq", "xueqiu", "雪球"]:
+        return XueQiuFollower(**kwargs)
+    raise NotImplementedError