FQGate-agent README

The project's README from github.com/fqgate/FQGate-agent. As one markdown file: README.md.

同花顺 Agent

仅支持windows,mac暂时不予考虑支持.

面向同花顺桌面客户端的非官方本机 AI Agent 连接工具

这是一个由独立开发者维护的非官方项目,与同花顺及其关联公司不存在授权、合作或背书关系。

在 Codex、Claude Code、WorkBuddy、ZCode、OpenClaw、DeepSeek Harness、豆包或千问中,直接查询你电脑上的同花顺行情、K 线、持仓、委托和成交数据。

插件不会为你增加任何行情、账户或交易权限。你能看到的数据和能使用的功能,仍以当前登录的同花顺账户、证券账户及相应服务权限为准。

所有功能均免费开放,不设订阅、会员、套餐、试用额度或付费解锁。

项目地址

一句话安装

在你正在使用的 AI 助手中直接发送

安装并配置同花顺插件,项目地址:https://gitee.com/qicuo/tonghuasun-agent.git

选择你使用的 Agent

你可以直接这样问

使用前准备

文档与交流

同花顺 AI Agent 插件交流群二维码,有效期至 2026 年 9 月 17 日

获取本机 API 访问令牌

安装时会自动生成本机 API 访问令牌,并保存在你的电脑上。打开 PowerShell,运行下面的命令即可查看:

(Get-Content "$env:LOCALAPPDATA\TonghuasunCodex\config.json" -Raw | ConvertFrom-Json).localAccessToken

在接口文档的测试窗口或其他 API 客户端中,把获取到的令牌加入请求头:

X-Tonghuasun-Codex-Token: 获取到的令牌

令牌只用于访问当前电脑上的同花顺接口,请不要截图、公开或发送给他人。如果命令提示配置文件不存在或令牌为空,请让 AI 助手执行“修复同花顺插件配置”,无需手动创建令牌。

关于交易功能

交易工具默认关闭,只有你主动开启后才会出现。通过 Agent 下单、撤单或改单时,会先显示交易内容并等待你确认,随后仍需经过同花顺的交易流程;仅查询行情和账户数据不会发起交易。

交易功能尚未经过完整测试,如遇问题,请提交 Issue。

无人值守 REST 交易使用单独的开关,默认同样关闭,不会因为开启 Agent 交易工具而自动启用。

不是投资建议

本项目是一项数据连接和展示工具,不提供个股推荐、收益预测或投资建议。AI 生成的内容可能存在错误或延迟,行情、资金、委托和成交状态请以同花顺、证券公司及交易所的正式记录为准。

数据与隐私

本项目不运营用于接收行情、账户或交易数据的远程服务器。插件读取到的数据只会在你的电脑上处理,并交给当前电脑上调用它的 AI 助手或程序;这些数据不会上传给项目维护者。

本机接口只绑定 127.0.0.1 和当前电脑的私有局域网地址,不使用通配地址,也不接受公网访问。局域网设备调用接口时同样必须提供随机生成的访问令牌;Windows 防火墙只允许专用网络或域网络中的本地子网访问。请只在你信任的局域网中使用,不要通过端口映射、内网穿透或反向代理把接口开放到公网;更换网络后如果电脑的局域网地址发生变化,请重新运行插件配置。插件会从 GitHub 或 Gitee 获取公开版本信息,但请求中不包含行情、账户或交易内容;问财查询会按功能需要访问同花顺服务。使用云端 Agent 或模型时,工具结果可能由你选择的服务处理,具体以该服务的隐私政策和设置为准。

详细说明见隐私政策。

支持项目

如果这个项目对你有帮助,欢迎打赏支持

如果这个项目对你有帮助,欢迎打赏支持。打赏完全自愿,不用于购买任何功能、数据权限、投资建议、问题处理优先级或后续服务承诺。

赞助者:峰-Kevin 峰-Kevin · 阿东 阿东 · 星光 星光 · 許 許 · 序号 序号 · ICE ICE · U_U U_U · wd wd

项目说明

Agent 入口、配置器、传输桥和 SDK 依据 AGPL-3.0-only 开源,C# 开发的同花顺本机插件暂时闭源。许可范围、使用条款和隐私说明见法律与许可说明。

FQGate-agent (fqgate/FQGate-agent)

Searching Database…

这是什么?FQGate-agent 是一个面向同花顺(THS)桌面炒股客户端的非官方本地 AI 代理连接器,让 Codex、Claude Code、DeepSeek 等 AI 助手可以查询你电脑上的实时 A 股行情、K 线图、Level-2 数据、持仓、委托和成交。
它是同花顺官方插件,还是第三方工具?它是一个独立的非官方项目,与同花顺没有任何合作或背书;它只从你已登录的同花顺桌面客户端读取数据,并在本地提供给 AI 工具——绝不会授予你现有权限之外的新行情、账户或交易权限。
怎么安装和配置?你只需把“安装并配置同花顺插件,项目地址:...”这条消息直接发给你的 AI 助手(Codex、Claude Code 等),它就会替你完成安装和配置。
支持哪些 AI 工具?我需要自己的同花顺账号吗?它支持 Codex、Claude Code、WorkBuddy、ZCode、OpenClaw、DeepSeek Harness、Doubao 和 Qwen。你需要已安装并用自己证券账号登录的同花顺桌面客户端,因为该插件只会呈现你本来就有权限访问的数据。
交易功能现在就能直接用了吗?交易工具默认关闭,必须手动启用;每笔下单、撤单或改单在进入同花顺正常交易流程前都会先弹确认,而且交易本身尚未经过完整测试。无人值守的 REST 交易有单独的开关,同样默认关闭。
它在 Mac 上也能用吗?不行——README 明确说明只支持 Windows,目前没有 Mac 支持计划。
使用它要花钱吗?不用,所有功能完全免费,没有订阅、会员、套餐或付费解锁;捐赠是自愿的,也换不来任何额外功能或优先支持。
它给出的数据或分析算是投资建议吗?不是,它纯粹是一个数据连接和展示工具——不提供选股、盈利预测或投资建议,AI 生成的结果也可能有误或滞后。
出问题时我去哪里找本地 API token?安装器会自动生成一个保存在你电脑上的 token,可用一条 PowerShell 命令查看;如果配置似乎丢了,直接让 AI 助手“修复同花顺插件配置”,不要手动创建。
Creator
fqgate
Size
15.2 MB
Stars
257
Age
1mo
Commits · 90 Days