通达信金融数据专家
任务目标
本 Skill 用于通过通达信数据接口获取金融市场的实时行情、历史K线数据及财务报表信息，支持A股、指数、期货等市场。
能力包含
- 实时行情快照：获取股票、指数、期货的实时价格、成交量等数据
- 历史K线数据：支持多种时间周期（日线、分钟线）的历史数据查询
- 财务数据解析：资产负债表、利润表、现金流量表数据获取
- 本地数据读取：直接读取通达信客户端本地存储的数据
触发条件
- 用户请求查询股票或指数的实时行情（如"查看600519的当前价格"）
- 用户请求获取历史K线数据（如"获取贵州茅台最近30天的日线"）
- 用户需要分析财务数据（如"查看600519的资产负债表"）
- 用户需要读取本地通达信数据（如"读取本地日线数据"）
前置准备
依赖安装
确保 Python 版本为 3.8 或以上，建议使用虚拟环境：
# 直接PIP安装
pip install mootdx[all]>=1.2.0 pandas>=1.3.0 retry>=0.9.2
服务器配置优化
技能初始化时会自动执行 mootdx bestip -v 测试并选择最快的行情服务器，将最快IP写入配置文件以提升连接稳定性。若自动优选失败，将回退至默认配置。
操作步骤
1. 获取实时行情快照
调用 scripts/quotes_client.py 的 get_quotes 方法：
from tdx_financial_expert.scripts.quotes_client import get_quotes
result = get_quotes(symbol="600519") # 贵州茅台
- 智能体解析用户自然语言中的股票代码
- 调用脚本获取实时数据
- 提取关键字段：代码、名称、开盘价、收盘价、最高价、最低价、成交量
- 返回 Markdown 表格格式，附带摘要信息
2. 获取历史K线数据
调用 scripts/quotes_client.py 的 get_kline 方法：
from tdx_financial_expert.scripts.quotes_client import get_kline
result = get_kline(symbol="600519", frequency=9, offset=0, count=10)
- frequency 参数映射见 references/frequency-mapping.md
- 支持分页查询：通过 offset 和 count 控制数据范围
- 返回带时间索引的 Markdown 表格
3. 获取指数和分钟数据
调用相应方法获取指数数据或分钟线数据：
# 获取指数数据
from tdx_financial_expert.scripts.quotes_client import get_index
index_data = get_index(symbol="000001") # 上证指数
# 获取分钟数据
from tdx_financial_expert.scripts.quotes_client import get_minute
minute_data = get_minute(symbol="600519")
4. 解析财务数据
调用 scripts/financial_parser.py 获取财务报表：
from tdx_financial_expert.scripts.financial_parser import (
get_balance_sheet,
get_profit_statement,
get_cash_flow
)
# 资产负债表
balance_sheet = get_balance_sheet(symbol="600519")
# 利润表
profit_statement = get_profit_statement(symbol="600519")
# 现金流量表
cash_flow = get_cash_flow(symbol="600519")
5. 读取本地通达信数据
调用 scripts/offline_reader.py 读取本地数据：
from tdx_financial_expert.scripts.offline_reader import (
get_daily,
get_minute as get_offline_minute
)
# 读取日线数据（需提供正确的通达信安装路径）
daily_data = get_daily(
tdx_path="D:/new_tdx",
symbol="600519"
)
# 读取分钟线数据
minute_data = get_offline_minute(
tdx_path="D:/new_tdx",
symbol="600519",
suffix="1min"
)
资源索引
必要脚本
- scripts/quotes_client.py：行情客户端封装，提供实时行情、K线数据、指数数据、分钟数据获取功能
- scripts/offline_reader.py：本地数据读取器，支持从通达信安装目录读取日线和分钟线数据
- scripts/financial_parser.py：财务数据解析器，提供资产负债表、利润表、现金流量表数据获取
领域参考
- references/frequency-mapping.md：频率参数映射表，定义K线数据的frequency参数取值
- references/error-handling.md：错误处理指南，常见错误及解决方案
输出资产
- assets/config-template.txt：配置文件模板，用于参考服务器IP配置格式
注意事项
异常处理
- 所有网络请求均包含
try...except异常捕获，并返回友好的错误提示 - 自动重试机制：单次请求失败后最多重试3次，采用指数退避策略
- 出现连接超时时，建议用户手动运行
mootdx bestip -v更新服务器列表
资源管理
- 所有脚本在使用完 Quotes 客户端后会自动调用
client.close()释放连接 - 确保每次请求后资源被正确释放
数据质量
- 所有返回的数据都转换为 Pandas DataFrame 格式后，再转换为 Markdown 表格或 JSON 输出
- 时间列自动设置为索引，方便后续量化分析
- 数据格式验证确保后续处理的稳定性
服务器列表更新
技能初始化时会自动执行服务器优选；若仍遇到连接失败，用户可手动从通达信官方客户端的 connect.cfg 文件中提取最新服务器IP，更新到 mootdx 配置文件中。
使用示例
示例1：查询实时行情
用户请求："查看贵州茅台的当前行情"
执行方式：智能体解析股票代码 → 调用 get_quotes("600519") → 返回 Markdown 表格
示例2：获取历史K线
用户请求："获取600519最近20天的日线数据"
执行方式：智能体解析参数 → 调用 get_kline("600519", frequency=9, offset=0, count=20) → 返回带摘要的数据
示例3：分析财务数据
用户请求："查看600519的最新资产负债表"
执行方式：智能体识别需求 → 调用 get_balance_sheet("600519") → 解析并展示关键指标
