Tonghuasun Agent

同花顺 Agent

这是一个独立开发项目，不是同花顺官方产品

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

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

项目地址

• 国内仓库：Gitee
• GitHub 仓库：GitHub

一句话安装

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

安装并配置同花顺插件，项目地址：

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

选择你使用的 Agent

• 在 Codex 中安装
• 在 Claude Code 中安装
• 在 WorkBuddy 中安装
• 在 ZCode 中安装
• 在 OpenClaw 中安装
• 在 DeepSeek Harness 中安装

你可以直接这样问

• “工业富联今天的盘口怎么样？”
• “查看贵州茅台最近一个月的日 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 提醒更新）

获取本机 API 访问令牌

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

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

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

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

令牌只用于访问当前电脑上的同花顺接口，请不要截图、公开或发送给他人。如果命