Skip to content

miaolink/THS_MCP_Quant

Repository files navigation

RHTHS

同花顺 PC 用户的 AI 交易与量化网关非传统 WinGUI 键鼠模拟,采用同花顺进程内原生 ths_api高效、极速、稳定;适配免费版 / 金融大师 / 远航版 / 券商定制版 / 独立下单等,无需任何外部 API 授权,安装即用。专为 OpenClawHermes Agent 及 Cursor 做 AI 交易,并支持 CLI 量化脚本。

在线文档:https://www.miaolink.cn/rhths/index.php · MCP 配置详见 MCP使用说明.md

说人话

只要你当前能在同花顺上可以正常交易的账户(含模拟),不用开通任何权限,本交易网关安装即用,无需任何特殊设置

补充说明

本软件需求你有两年以上的同花顺账号才可以用(同花顺还没有全部用户放开权限)!!!!!!!特别注意!

技术路线:原生 ths_api,不是 WinGUI 自动化

RHTHS 不走市面上常见的「找窗口 → 模拟点击 → OCR 读屏」等 WinGUI / 外挂式 方案,而是在同花顺进程内通过 Hook 直接调用官方策略环境自带的 ths_api,再由本机网关转发给 MCP / CLI。

传统 WinGUI 自动化 RHTHS(原生 ths_api
实现方式 模拟鼠标键盘、控件坐标、图像识别 进程内 API 调用,与策略脚本同源
速度 慢(界面操作、等待渲染) 极速(毫秒级,无界面往返)
稳定性 分辨率/皮肤/弹窗一变就易失效 稳定(不依赖窗口布局)
能力边界 常受界面步骤与脚本条数限制 与 PC 同花顺策略环境一致,查询/模拟无额外接口配额;无「按次购买 API 调用量」
数据一致性 读屏/抓控件易偏差 资金、持仓、委托与客户端内数据一致

说明:「无限制」指不依赖 WinGUI 自动化套路、不设第三方 API 调用配额;查询与模拟下单在网关层不限次数。实盘仍须遵守券商与同花顺规则;RHTHS 标准版对实盘买卖有每日次数保护(高级版无此限制),与「是否 WinGUI」无关。

❌ 传统:AI/脚本 ──► 模拟点击同花顺窗口(慢、脆、难维护)
✅ RHTHS:AI/脚本 ──► 网关 19312 ──► 同花顺进程内 ths_api(快、稳、原生)

联系作者(优先微信)

安装 RHTHS、Hook 部署、MCP/局域网连不上、标准版/高级版激活等问题,请优先联系作者,微信通常比自行排查更快。

项目 内容
联系人 李先生
手机 18670334431
微信 同上号码(推荐:添加时请备注「RHTHS」+ 简要问题)

李先生微信二维码(长按或扫码添加)

说明:交易与资金风险由用户自行承担;技术咨询仅限 RHTHS 安装、配置与产品授权,不提供代客理财或投资建议。

AI 交易(首选:OpenClaw · Hermes Agent)

OpenClawHermes Agent 里配置 RHTHS 的 MCP 服务 rhths-trade 后,用自然语言即可驱动同花顺账户(默认模拟下单,实盘须显式确认):

你可以对 AI 说 MCP 背后能力
「帮我看下资金和持仓」 rh_trade_accountrh_trade_positions
「今天有哪些委托」 rh_trade_orders_today
「模拟买入 100 股某某,最新价」 rh_trade_buydry_run
「问财选市盈率小于 20 的票」 rh_market_wencairh_market_select_stocklist
「恢复策略运行 / 条件单 resume」 rh_condition_resume(需已有 signal_id
「启动下单程序 xiadan」 rh_system_start_xiadan
「切换到实盘模式」(需谨慎) rh_trade_mode_set + confirm_live

完整话术与全部 MCP 工具示例见 AI交易示例.md

推荐客户端(配置方式相同,合并 rhths-trade 即可):

  1. OpenClaw / Claw — 自主 Agent,本机 stdio 或局域网 HTTP 连交易机
  2. Hermes Agent — MCP Agent,本机命令或远程 URL
  3. Cursor、Claude Desktop、Windsurf、Cline、Continue、Cherry Studio 等

机读配置模板: mcp.server.rhths-trade.json · 工具列表:mcp.tools.json · AI 自动安装: AI自动安装MCP与SKill示例.md

你 ──对话──► OpenClaw / Hermes Agent ──MCP──► rhths-mcp.exe ──► 同花顺 (ths_api)
                                              查仓 · 行情 · 下单(可先模拟)

RHTHSRonghui TongHuaShun Gateway)在本机同花顺进程内对接 ths_api,对外暴露统一网关;AI 交易走 MCP量化脚本走 CLI,二者共用同一套交易语义。


适配哪些同花顺?安装即用

以下 同花顺 PC 端 均可使用 RHTHS(只要你能用该软件正常登录并交易即可,不必先申请任何外部 API 授权):

客户端类型 说明
PC 免费版 个人常用免费客户端
金融大师 完整行情与交易环境
远航版 远航系列 PC 客户端
券商定制版 各券商冠名、定制的同花顺 PC 版
独立下单(xiadan) 同花顺独立下单程序,与主客户端配合或单独使用

统一说明:不需要开通任何外部 API 授权(含同花顺官方量化接口、券商独立交易 API、第三方云交易 API 等)。RHTHS 在你本机已登录的同花顺/下单进程内使用内置 ths_api,不是再去申请一套 API Key。

默认安装后可用(三步)

  1. 安装 RHTHS 安装包(含 rhths-gui.exerhths.exerhths-mcp.exe
  2. 在 GUI 中执行 「安装 / 更新 Hook」(或运行安装包自带部署脚本)
  3. 启动同花顺(或独立下单)并登录 → 运行 rhths health 显示正常 → 即可配置 OpenClaw / Hermes Agent 或运行 CLI

无需等待外部 API 审核、无需改券商通道、无需更换交易软件品牌。


谁可以直接用?无需任何外部 API 授权

凡使用上表任一同花顺 PC 客户端、且已能手动登录下单的用户:安装 RHTHS 并完成 Hook 后即可做 AI 交易与量化——无需向同花顺、券商或第三方申请/开通任何 API 授权。

传统做法 RHTHS 做法
WinGUI 模拟点击、易碎且慢 原生 ths_api,高效极速稳定
向同花顺/券商申请量化或交易 API、等待审核 默认安装 + Hook,沿用现有 PC 客户端与账户
为 AI 单独开发交易接口 OpenClaw / Hermes Agent 配 MCP 即可对话查仓、下单
云端 API 与 PC 持仓不一致 本机同花顺内置 ths_api,与软件里看到的一致

不需要: 任何外部 API 开通、第三方云交易接口、迁移到其它交易系统、MySQL 或其它数据库同步(RHTHS 不提供;属其它非标集成)。

与旧 thsQuant 的关系: RHTHS 不连接 :19090 / :18989。若你曾用 thsQuant,请改用本机 http://127.0.0.1:19312rhths / rhths-mcp;能力在 RhThsHost 内对齐,两套程序可并存但互不依赖。

建议先用 模拟(dry-run) 验证 AI 与策略,再按需实盘(风险自负)。


软件能做什么

能力 说明
原生 ths_api 网关 非 WinGUI;进程内调用,极速稳定,查询/模拟无第三方 API 配额限制
AI 交易(MCP) OpenClaw、Hermes Agent 等通过对话查资金/持仓/委托、问财选股、模拟或实盘买卖
量化脚本(CLI) rhths.exe 供 PowerShell、计划任务、Python 等本机自动化
交易查询 资金账号、资金、持仓、当日/历史委托
下单与撤单 买入、卖出、撤单;默认模拟,实盘需 confirm_live
行情与选股 实时行情、K 线、分时、盘口、板块、问财、5 日因子、指标
条件单 / 策略 ths.run / resume 等(进程内信号引擎,经网关 :19312
进程管理 启动/停止 hexin.exexiadan.exe(CLI/MCP/GUI)
自动交易审核 本地 JSON 配置与审核队列(可选,非 MySQL)
图形管理 rhths-gui.exe:Hook、交易面板、激活、升级
产品授权 RHTHS 标准版/高级版(产品注册码,≠ 外部 API 授权);标准版实盘有每日次数保护

两种使用方式

优先级 方式 适用场景
AI 交易 MCP rhths-mcp.exe OpenClaw、Hermes Agent(本机 stdio);笔记本 AI 连家里交易机(HTTP)
量化 / 运维 CLI rhths.exe 本机脚本、批处理、计划任务

核心组件

组件 说明
rhths-mcp.exe AI 交易入口(MCP → 网关 19312)
RhThsHost.dll 同花顺进程内网关 127.0.0.1:19312
rhths.exe CLI 量化 / 调试
rhths-gui.exe 安装 Hook、激活、日常管理
hook/ 注入同花顺的部署文件

环境要求

  • Windows 10/11
  • 同花顺 PC 端之一:免费版 / 金融大师 / 远航版 / 券商定制版 / 独立下单(xiadan),能登录交易即可
  • RHTHS 已安装且 Hook 已部署——无需任何外部 API 授权
  • AI 交易(可选)OpenClaw / Hermes Agent / Cursor + MCP使用说明.md

独立下单(xiadan.exe)必设项(唯一配置入口)

RHTHS 通过 ths_api 程序化下单时,必须在 xiadan.exe 里完成下图设置(其它客户端无此替代路径)。打开方式:独立下单窗口顶部菜单 「设置」 → 选项卡 「快速交易」,将图中标注的 4 项全部设为「否」

设置项 必须值
撤单前是否需要确认
买入时是否需要确认
卖出时是否需要确认
委托成功后是否弹出提示对话框

xiadan 快速交易:买入/卖出/撤单确认与委托成功弹窗须设为「否」

说明: 若上述任一项为「是」,程序化委托可能被确认框或弹窗阻塞,导致 MCP/CLI 下单超时或失败。修改后点击 「确定」 保存,并完全退出后重新启动 xiadan.exe(部署 Hook 后亦须重启)。


快速开始

  1. 启动同花顺并登录
  2. rhths.exe healthok: true
  3. AI 交易:配置 OpenClaw 或 Hermes Agent → MCP使用说明.md · 话术 AI交易示例.md
  4. 量化脚本CLI使用说明.md
  5. 首次安装 → 快速开始.md

文档目录

文档 内容
软件功能图.md 控制台界面截图(概览/交易/激活/设置/MCP 等 9 张功能说明)
AI交易示例.md OpenClaw / Hermes 自然语言话术与全工具示例
SKILL.md Agent 融合指南(MCP + CLI,供 OpenClaw / Hermes 加载)
MCP使用说明.md OpenClaw / Hermes Agent 本机与局域网配置
AI自动安装MCP与SKill示例.md 一句话让 AI 自动安装 MCP + Skill(本机 / 局域网)
快速开始.md 安装检查
CLI使用说明.md 命令行参考
mcp.server.rhths-trade.json MCP 配置模板
mcp.tools.json 工具名与参数摘要

架构示意

同花顺 (ths_api) ──► RhThsHost.dll :19312 ──► rhths-mcp.exe ──► OpenClaw / Hermes / Cursor(AI 交易)
                                            └──► rhths.exe      (CLI 量化)

技术与合规说明(合法使用)

RHTHS 在技术与合规上坚持以下原则,请用户知悉并合规使用:

项目 说明
不含逆向破解 不对同花顺客户端进行逆向工程、脱壳、篡改、外挂注入式破解,不涉及对「任务」模块或交易核心的非法破解
标准调用 已安装且由用户正常启动、登录的同花顺/独立下单进程内,通过官方策略环境提供的 ths_api 标准接口 完成查询与下单,调用方式与 PC 端策略脚本同类,属于标准 API 调用而非模拟破解协议
不破解软件 不破解、不绕过同花顺软件授权与安全机制;不修改同花顺安装包、不提供盗版或破解补丁
Hook 用途 本地 Hook 仅用于在同花顺进程内加载 RhThsHost 网关模块,将 ths_api 能力以本机 HTTP 方式暴露给 CLI/MCP,目的为接入与扩展,而非破坏软件
用户责任 用户须遵守同花顺用户协议券商交易规则及所在地法律法规;实盘风险自负,建议先模拟验证

若同花顺或券商对自动化、程序化交易有额外规定,请以官方最新条款为准;RHTHS 不提供任何规避监管或违规交易的用途。


许可与联系

  • 产品许可:RHTHS 标准版/高级版在 GUI 激活(与「外部 API 授权」无关)。
  • 合规:请在上表前提下使用;禁止将本产品用于破解、盗版、未授权访问他人账户等违法行为。
  • 免责声明:资金与交易风险由用户自行承担,详见本站页面底部 免责声明(PHP 展示)。
  • 技术支持:李先生 · 18670334431(微信同号,二维码见文首 联系作者

面向最终用户AI 助手。开发构建见主仓库 README.mddocs/

About

同花顺AI交易与Quant量化下单网关 — 适配**PC免费版、金融大师、远航版、券商定制版、独立下单(xiadan)**等常见 PC 客户端;**无需开通任何 API**,**默认安装后即可使用**。专为 **OpenClaw**、**Hermes Agent** 及 cloud code 等提供查仓、下单;同时支持 **CLI** 量化脚本。

Resources

Stars

12 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors