Skip to content

Repository files navigation

同花顺 Agent

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

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

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

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

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

项目地址

一句话安装

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

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

  • 按提示选择同花顺安装目录,完成后重启同花顺;如果当前任务没有显示新工具,新建一个任务即可,只有刷新异常时才需要重启 AI 助手;
  • 如果自动安装失败,再前往 GitHub 最新版下载页Gitee 发行版下载页 下载对应的安装包手动安装。

选择你使用的 Agent

你可以直接这样问

  • “工业富联今天的盘口怎么样?”
  • “查看贵州茅台最近一个月的日 K 线。”
  • “汇总我的账户资产和当前持仓。”
  • “显示今天的委托、成交和撤单记录。”
  • “持续观察这只股票的逐笔成交变化。”

使用前准备

  • 使用 Windows 10 或 Windows 11。
  • 电脑上已安装同花顺远航版,下载地址:https://download.10jqka.com.cn/index/download/id/275/
  • 当前开发与验证环境为同花顺远航版 11.4.1.3;配置器会识别本机客户端和版本信息,其他版本如遇兼容问题请提交 Issue。
  • 核心插件目前尚未使用 Windows 代码签名,发行包提供 SHA-256 清单供你核对文件;如果不能接受闭源且未签名的组件,请不要安装或开启交易功能。
  • 查询实时行情、账户或交易数据时,请保持同花顺已登录并正常运行。
  • 首次安装或升级后,请重启同花顺;如果 Agent 没有显示新工具,请先新建任务或重新加载插件,只有刷新异常时才重启 Agent。

文档与交流

  • 本机接口文档:127.0.0.1:17180/docs
  • 微信群:同花顺 AI Agent 插件交流(当前二维码有效期至 2026 年 9 月 1 日;失效后请提交 Issue 提醒更新)

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

获取本机 API 访问令牌

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

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

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

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

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

关于交易功能

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

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

不是投资建议

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

数据与隐私

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

本机接口只接受当前电脑的访问,并使用随机生成的访问令牌。插件会从 GitHub 或 Gitee 获取公开版本信息,但请求中不包含行情、账户或交易内容;问财查询会按功能需要访问同花顺服务。使用云端 Agent 或模型时,工具结果可能由你选择的服务处理,具体以该服务的隐私政策和设置为准。

详细说明见隐私政策

支持项目

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

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

赞助者:I'm Kim I'm Kim · 阿东 阿东 · 星光 星光

项目说明

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

About

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

Resources

Stars

135 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages