核心用法
Tushare skill 是一个面向中国金融市场的数据获取工具，通过调用 Tushare Pro API 提供股票、期货及宏观经济数据服务。用户需先注册 Tushare 账号获取 API Token 并配置为环境变量 TUSHARE_TOKEN，安装 tushare 和 pandas 依赖后即可使用。
主要功能模块包括：
- 股票数据：基础信息（
stock_basic）、日/周/月线行情（daily/weekly/monthly）、实时行情（realtime）、资金流向（moneyflow）及公司信息 - 期货数据：合约基础信息（
fut_basic）、日线行情（fut_daily）、持仓排名（fut_holding），覆盖中金所、上期所、大商所、郑商所四大交易所 - 宏观经济：GDP、CPI、PPI 等官方统计数据
命令行接口统一通过 python3 scripts/market.py <command> 调用，支持交易所过滤、日期范围指定、股票代码精确查询等参数。
显著优点
1. 数据覆盖全面：整合中国主要金融市场的股票、期货、宏观数据，一站式满足投研需求
2. 接口设计规范：采用标准 RESTful API 风格，命令参数清晰，支持多时间维度行情获取
3. 来源权威可信：Tushare 是运营多年的知名金融数据平台，数据源自上交所、深交所、中金所等官方渠道
4. 安全认证良好：静态分析95分，无危险函数、无硬编码敏感信息，依赖库均为知名开源项目
5. 隐私合规：采用用户自主配置的 Token 认证模式，不主动收集敏感个人信息
潜在缺点与局限性
1. Token 权限门槛：部分高级接口需积分或付费，免费用户存在数据权限限制
2. 外部依赖风险：依赖 tushare、pandas 第三方包，存在供应链攻击潜在风险（当前未锁定版本）
3. 网络依赖性强：所有数据实时从云端获取，无本地缓存机制，网络波动时可用性下降
4. 查询行为可追踪：股票代码、日期等查询参数会传输至 Tushare 服务器，敏感策略存在暴露风险
5. 错误处理较简单：API 失败时仅打印基础错误，缺少超时重试、Token 失效细分提示等机制
适合人群
- 金融分析师、量化研究员需要获取中国 A 股、期货市场结构化数据
- 开发者构建财经数据 pipeline、投研系统或可视化面板
- 学术研究者获取宏观经济指标进行经济分析
- 个人投资者进行基础行情查询与数据回测
常规风险
| 风险类型 | 等级 | 说明 |
|---------|------|------|
| 供应链攻击 | 低 | 依赖包被篡改风险，建议锁定版本 |
| 数据泄露 | 低 | 查询行为被第三方记录，敏感策略谨慎使用 |
| Token 泄露 | 中 | Token 硬编码或误提交可能导致账户被盗用 |
| 服务可用性 | 低 | 依赖 Tushare 平台稳定性，存在单点故障 |
| 合规风险 | 低 | 金融数据使用需遵守相关法规，禁止非法传播 |