FQGate-agent

# 同花顺免费开源AI插件FQGate (QQ群-14546787) <p align="center"> <img src="assets/brand/fqgate-level2-banner.jpg" alt="FQGate 2.0 Level 2 本地金融 AI Gateway" width="100%"> </p> > 面向 Codex、Claude Code、WorkBuddy、ZCode、OpenClaw、DeepSeek Harness、豆包和千问的本机 A 股行情与量化数据插件 > **1.0.0 升级提醒：** 配套的 FQGate 1.0.0 主程序只提供行情，不再提供交易 API 和交易 MCP 工具。下文的账户查询、交易技能和交易示例仅适用于仍提供这些接口的旧版主程序；连接 1.0.0 时请以实际工具列表为准。 --- ## 🚀🚀🚀 一句话安装｜复制后发给 AI 🚀🚀🚀 > ⭐⭐⭐ **复制下面这句话，发送给你正在使用的 AI 助手** ⭐⭐⭐ ```text 请按仓库说明安装并配置同花顺免费开源AI插件FQGate：https://gitee.com/qicuo/tonghuasun-agent.git。请先读取 README 和对应 AI 工具的安装说明，根据网络环境选择国内或国外 FQGate 官方下载源，安装主程序和插件、创建桌面快捷方式、启动 FQGate，并确认 fqgate 连接成功且能读取工具列表或完成健康检查；任何一步失败都请报告具体原因，不要把只下载或解压文件当作安装完成。 ``` ### 👆👆👆 复制上面这句话即可开始安装 👆👆👆 > ✅ 读取仓库和对应工具说明　✅ 选择正确的主程序下载源　✅ 安装 FQGate 正式版　✅ 安装 AI 插件　✅ 创建桌面快捷方式　✅ 启动并检查连接 --- ### 数据来自同花顺，响应更快、运行更稳定 通过本插件，你可以在常用 AI 助手中直接查询 A 股实时行情、分时、K 线、Level-2 逐笔数据、资讯公告、证券资料、账户资产、持仓、委托和成交数据，为您的股票交易提供决策依据。 > **更名说明：** 本项目原插件名为 `tonghuasun-agent`，现已更名为 `fqgate-agent`。GitHub 和 Gitee 仓库地址继续沿用原名称，方便旧用户、已有收藏和外部链接继续访问。 所有 AI 插件入口、安装适配、技能和界面组件均免费开源，不设订阅、会员、套餐、试用额度或付费解锁。FQGate 作为本机量化网关单独提供编译包，并适用其随包许可。 这是一个由独立开发者维护的非官方项目，与同花顺及其关联公司不存在授权、合作或背书关系。插件不会增加任何行情、账户或交易权限，你能看到的数据和能使用的功能仍以当前账户及相应服务权限为准。 > **当前插件版本为 `1.0.0`，要求 FQGate `0.1.0` 或更高版本。** AI 插件安装包可以从 GitHub 或 Gitee 下载；FQGate 主程序请从下方的官方下载页获取。 ## 项目地址 - 国内仓库：[Gitee](https://gitee.com/qicuo/tonghuasun-agent) - GitHub 仓库：[GitHub](https://github.com/zhuyifang/tonghuasun-agent) ## 安装说明 ### 给 AI 助手的安装规则 如果你是 AI 助手，用户要求“安装”“配置”或“一句话安装”时，必须按下面的顺序执行，不要只回复安装命令： 1. 先确认用户的操作系统和当前使用的 AI 工具，再阅读本 README 与下方对应的工具安装说明。 2. 根据用户网络环境选择 FQGate 主程序下载源：国内网络优先使用 Gitee，国外网络优先使用 GitHub；下载失败时可以切换到另一个官方源,如果下载源使用的时Github,但是下载失败,则可以尝试考虑复用用户本机的系统代理。 3. 打开对应的官方发行页面，选择当前稳定版和与用户电脑匹配的正式安装包； 4. 安装并启动 FQGate；再安装插件并完成当前 AI 工具的连接配置。 5. 为 FQGate 创建桌面快捷方式，便于用户以后启动本机网关。 6. 最后检查名为 `fqgate` 的连接是否成功，并读取工具列表或完成健康检查。只有这一步通过，才能告诉用户安装完成；如果只完成了文件安装，必须明确说明“插件文件已安装，但 FQGate 尚未连接”。 7. 重启AI工具，提示指导用户完成行情登录。 8. 根据我们的Skill 给用户提供一些使用示范。 ### FQGate 主程序下载 - 国内下载：[Gitee FQGate 正式发行页](https://gitee.com/qicuo/fqgate-releases/releases) - 国外下载：[GitHub FQGate 正式发行页](https://github.com/zhuyifang/fqgate-releases/releases) ### 手动安装 Windows 用户可以直接运行一条命令： ```powershell powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\installer\runtime\install-fqgate.ps1 ``` 这条命令会自动选择正式版本，下载并检查 FQGate，把程序放到当前用户的应用目录，创建桌面快捷方式，启动主程序并检查连接。使用已经解压的插件安装包时，把脚本路径换成 `.\scripts\install-fqgate.ps1`。 安装结束前，AI 应确认 FQGate 已经启动、名为 `fqgate` 的连接已经成功，并且能够读取工具列表或完成健康检查。如果连接尚未成功，应直接告诉用户“插件文件已安装，但 FQGate 尚未连接”。 AI 助手会根据你使用的工具选择对应的正式安装包并完成配置。自动安装失败时，可以前往 [GitHub 发行页面](https://github.com/zhuyifang/tonghuasun-agent/releases) 或 [Gitee 发行页面](https://gitee.com/qicuo/tonghuasun-agent/releases) 手动下载。 ## 选择你使用的 AI 工具 - [在 Codex 中安装](./AI-plugins/codex/README.md) - [在 Claude Code 中安装](./AI-plugins/claude-code/README.md) - [在 WorkBuddy 中安装](./AI-plugins/workbuddy/README.md) - [在 ZCode 中安装](./AI-plugins/zcode/README.md) - [在 OpenClaw 中安装](./AI-plugins/openclaw/README.md) - [在 DeepSeek Harness 中安装](./AI-plugins/deepseek-harness/README.md) - [在豆包中安装](./AI-plugins/doubao/README.md) - [在千问中安装](./AI-plugins/qianwen/README.md) ## 你可以直接这样问 插件只提供两个清晰入口：“同花顺免费实时数据代理”负责行情、资讯、行情登录和连接处理；“同花顺实盘交易代理”负责账户、持仓和实盘交易。登录和配置不会单独显示成技能。 - “查看航天机电的当前行情。” - “显示贵州茅台最近一个月的日 K 线。” - “同时对比工业富联、招商银行和宁德时代的行情。” - “查看这只股票今天的盘口和 Level-2 逐笔委托。” - “汇总我的账户资产和当前持仓。” - “显示今天的委托、成交和撤单记录。” ## 为什么选择 FQGate > **响应更快、运行更稳定** > > [FQGate](https://github.com/zhuyifang/fqgate-releases) 是本项目使用的本机量化网关。与常见的网页抓取、脚本转发或多层接口封装方案相比，FQGate 最核心的优势是**响应更快、运行更稳定**：它以本机常驻服务直接连接行情与交易会话，减少中间转发和重复初始化，再通过统一的超时、错误码、请求编号和日志机制，让长时间运行时的失败边界更明确、问题更容易定位。 - 一个 FQGate 实例可以同时服务多个 AI 工具，不需要为每个工具重复维护数据连接。 - 行情、账户、交易和插件界面使用统一接口，不同 AI 工具之间的体验更一致。 - 本机接口默认只监听 `127.0.0.1`，不会为了接入 AI 工具而开放公网服务。 ## 使用前准备 - 安装并启动 FQGate `0.1.0` 或更高版本。 - 在 FQGate 中完成行情登录；查询账户或交易时，还需要单独登录对应券商账户。 - 首次安装或升级插件后，如果当前任务没有显示新工具，请新建任务或重新加载插件。 - 核心程序目前未使用代码签名，Windows 可能显示安全提示；如果不能接受闭源且未签名的本机组件，请不要安装或开启交易功能。 ## 界面组件 插件已提供行情登录、个股行情、资讯、多股行情和 Level-2 逐笔委托界面。界面直接连接本机 FQGate，不提供模拟行情；是否显示相应数据，取决于当前登录状态和账户权限。 [交易接口演示](./examples/trading-demo/README.md)可用于查看账户、资产、持仓和交易记录，并核对委托等操作的请求与返回结果。 ## 文档与交流 - 本机接口文档：[127.0.0.1:17281/docs](http://127.0.0.1:17281/docs) - QQ 群：[免费AI量化数据](https://qm.qq.com/q/ZQSuiYQZ4Q)，群号：`14546787` - 微信群：同花顺 AI Agent 插件交流（当前二维码有效期至 2026 年 9 月 25 日；失效后请提交 Issue 提醒更新） <p align="center"> <img src="./assets/community/wechat-agent-group-qr.png" alt="同花顺 AI Agent 插件交流群二维码，有效期至 2026 年 9 月 25 日" width="280"> </p> ## 关于交易功能 交易工具默认隐藏，只有你主动开启后才会出现。下单、撤单、申购或划转前，AI 必须展示完整操作内容并等待你单独确认；结果未知时不会自动重试。 交易功能涉及真实资金，请先用查询功能核对账户和权限，并以券商及交易所的最终记录为准。 ## 不是投资建议 本项目是一项数据连接和展示工具，不提供个股推荐、收益预测或投资建议。AI 生成的内容可能存在错误或延迟，行情、资金、委托和成交状态请以同花顺、证券公司及交易所的正式记录为准。 ## 数据与隐私 FQGate 默认只监听当前电脑的 `127.0.0.1:17281`，AI 插件不会连接公网或局域网中的 FQGate 地址。行情、账户和交易数据不会上传给项目维护者。 使用云端 AI 服务时，工具结果可能由你选择的服务处理，具体以该服务的隐私政策和设置为准。详细说明见[隐私政策](./docs/legal/PRIVACY.md)，软件风险见[使用条款](./docs/legal/TERMS.md)。 ## 支持项目 <p align="center"> <a href="./assets/support/support-banner.png"> <img src="./assets/support/support-banner.png" alt="如果这个项目对你有帮助，欢迎打赏支持" width="100%"> </a> </p> 如果这个项目对你有帮助，欢迎打赏支持。打赏完全自愿，不用于购买任何功能、数据权限、投资建议、问题处理优先级或后续服务承诺。 赞赏者：<img src="./assets/sponsors/feng-kevin.jpg" alt="峰-Kevin" width="32" height="32"> **峰-Kevin** · <img src="./assets/sponsors/adong.jpg" alt="阿东" width="32" height="32"> **阿东** · <img src="./assets/sponsors/xingguang.jpg" alt="星光" width="32" height="32"> **星光** · <img src="./assets/sponsors/xu.jpg" alt="許" width="32" height="32"> **許** · <img src="./assets/sponsors/xuhao.jpg" alt="序号" width="32" height="32"> **序号** · <img src="./assets/sponsors/ice.jpg" alt="ICE" width="32" height="32"> **ICE** · <img src="./assets/sponsors/u_u.jpg" alt="U_U" width="32" height="32"> **U_U** · <img src="./assets/sponsors/wd.jpg" alt="wd" width="32" height="32"> **wd** · <img src="./assets/sponsors/betterme.png" alt="@BetterMe（借钱勿扰）" width="32" height="32"> **@BetterMe（借钱勿扰）** ## 版本与开源说明 - 版本兼容关系及下载校验信息：[FQGate 集成信息](./fqgate/README.md) - 当前版本说明：[RELEASE_NOTES.md](./RELEASE_NOTES.md) - 插件界面项目：[AI-plugins/ui-apps](./AI-plugins/ui-apps/README.md) AI 插件入口、安装适配、技能、界面组件和可选 SDK 依据 AGPL-3.0-only 开源。FQGate 编译包适用其随包许可，详细范围见[法律与许可说明](./docs/legal/)。