TuShare Stock Skill

核心用法

Tushare Stock 是面向 A 股市场的专业数据获取与分析技能，通过 Python 脚本封装了 Tushare Pro 平台的 200+ 数据接口。核心使用方式分为三类：

1. 数据查询：支持股票列表、日线/周线/月线/分钟行情、财务三表、每日指标、资金流向、龙虎榜等基础数据拉取
2. 个股分析：内置估值分析、财务质量评估、成长性判断、趋势跟踪、股东行为监测五大分析维度
3. 交易观察：提供快档（趋势+量价+资金流+技术指标）和深档（额外叠加龙虎榜+机构席位扫描）两种模式，覆盖均线、RSI、KDJ、布林线、MACD 等常用技术指标

脚本通过环境变量 TUSHARE_TOKEN 完成认证，支持智能参数解析（如将"贵州茅台"自动映射为 600519.SH）、日期区间规范化、季度表达转换等预处理。

显著优点

• 数据维度完整：覆盖行情、基本面、资金面、情绪面、技术面五大数据域，单股分析可调用 50+ 指标交叉验证
• 分析分层合理：区分「快档/深档」交易观察模式，平衡响应速度与信息深度；自动识别"分析" vs "查询"意图，输出格式适配场景
• 权限管控透明：对积分不足或需额外权限的接口做显式拦截，避免调用失败；不再写入本地 token 缓存，降低凭证泄露风险
• 扩展机制清晰：技术指标通过装饰器注册，新增计算逻辑仅需修改 trading_analysis.py 即可被主技能识别

潜在局限

• 数据源单一：完全依赖 Tushare 平台，数据质量与更新时效受第三方制约，无跨源校验机制
• A股限域：明确排除 ETF、指数、基金、期货、期权、宏观数据，跨市场分析需切换其他技能
• Token 门槛：所有接口需有效 Pro Token，免费额度有限；高频调用或深度历史数据需较高积分等级
• 分析深度边界：交易观察以信号输出为主，不提供策略回测、仓位建议或自动化交易执行

适合人群

• 量化研究员与基本面分析师：需要结构化财务数据与标准化估值框架
• 主观交易者：关注龙虎榜、游资动向、技术形态与资金面变化
• 投研中台：构建选股因子、监控预警、定期财报跟踪的自动化流程

常规风险

1. 数据风险：Tushare 数据可能存在复权调整误差、财报更正滞后、分钟线缺失等情况，关键决策建议交叉验证
2. 权限风险：积分不足时接口返回空值或错误，脚本虽已拦截但用户需理解「有权限≠有数据」的区别
3. 时效风险：实时行情与盘后数据存在 15 分钟至数小时延迟，不适合高频实时决策
4. 合规风险：数据仅供研究分析，禁止用于非法证券咨询或操纵市场行为

核心用法

本Skill是Tushare A股股票数据的统一查询与分析入口，通过自然语言驱动Python脚本完成数据获取。主要能力包括：

数据查询类：股票列表、日线/周线/月线/分钟行情、复权数据、daily_basic每日指标、完整财务报表（三大表）、业绩预告、分红送配、审计意见、十大股东变动、股权质押/回购/解禁、大宗交易、股东人数、券商盈利预测、筹码分布、CCASS港股通持股、AH比价等。

市场数据类：融资融券、转融通、资金流向、龙虎榜、涨跌停明细、同花顺(THS)/东方财富(DC)/通达信(TDX)/开盘啦(KPL)题材板块数据。

分析功能类：个股估值分析（PE/PB分位）、财务质量评估（ROE/现金流/偿债能力）、成长性分析（营收利润增速）、趋势判断（均线排列、动量）、股东行为监测、综合风险提示。技术分析支持RSI、KDJ、MACD、布林带、均线系统等常用指标计算。

交易观察模式：分快档（趋势+量价+资金流+技术指标，默认）和深档（追加龙虎榜+机构席位扫描）两档，后者仅在用户明确要求时触发。

命令格式统一为 python scripts/tushare_stock.py run --text "<请求>"，脚本自动处理股票名称到ts_code的解析、日期区间规范化、接口选择与权限拦截。

显著优点

1. 接口覆盖全面：几乎涵盖Tushare Pro股票数据区的全部核心接口，从基础行情到深度财务、从资金流向到龙虎榜机构席位，一站式满足投研需求。

2. 自然语言交互：用户无需记忆具体接口名和参数格式，用日常表达如"分析宁德时代估值和成长性"即可触发对应功能。

3. 智能分析路由：自动识别请求类型——查询类返回原始数据，分析类返回结论+关键指标+风险提示，交易观察类聚焦量价信号，避免信息过载。

4. 安全Token管理：通过环境变量或配置文件获取TUSHARE_TOKEN，不硬编码、不缓存到代码，符合安全最佳实践。

5. 积分权限拦截：对需额外权限或高积分的接口做显式拦截和提示，避免无效调用。

潜在局限

1. Token依赖门槛：必须持有有效的Tushare Pro API Token，且部分高级接口需足够积分，免费用户可能受限。

2. 仅覆盖A股：明确不处理ETF、指数、基金、期货、期权、宏观、新闻类请求，多资产用户需配合其他工具。

3. 分钟级行情限制：分钟数据依赖Tushare积分等级，高频交易需求可能无法满足。

4. 分析结论为辅助性质：技术指标和财务分析输出基于历史数据的量化计算，不构成投资建议，需结合主观判断。

5. Python环境依赖：需预装pandas、tushare、requests、beautifulsoup4等库，非Python用户配置成本较高。

适合人群

• 量化投研人员：需要程序化获取A股结构化数据进行策略回测和因子挖掘
• 基本面分析师：关注个股财务质量、估值分位、股东变动、盈利预测等深度信息
• 活跃交易者：需要龙虎榜、资金流向、融资融券、技术因子等交易辅助数据
• 个人投资者：希望通过自然语言快速查询持仓股票的多维度信息，替代手动翻查多个终端

常规风险

1. 数据延迟风险：Tushare免费/低积分接口存在数据延迟（日线通常T+1，实时行情需高权限），不宜用于高频交易决策。

2. API稳定性依赖：数据源来自Tushare官方，服务中断或接口变更会影响本Skill可用性。

3. 积分消耗风险：部分接口（分钟行情、龙虎榜详情、历史分笔）积分消耗较高，大量调用可能导致额度快速耗尽。

4. 分析信号误读：技术指标存在滞后性，财务数据可能受会计处理影响，机器分析的"买入/卖出"倾向需人工复核。

5. 配置泄露风险：虽无硬编码密钥，但用户自行配置的.env文件若权限设置不当，存在本地Token泄露可能，建议设置文件权限600。