TuShare Stock Skill

核心用法

Tushare Stock Skill 是面向中国A股市场的专业化数据工具，通过Python CLI提供三类核心能力：

1. 数据查询：覆盖日线/周线/月线行情、财务指标（daily_basic）、财务报表、股东数据、资金流向、龙虎榜等Tushare主流接口。支持自然语言解析（如"贵州茅台近一年daily_basic指标"）和显式API调用（fetch --endpoint模式）。

2. 综合分析：自动识别"估值/基本面/趋势/风险"类请求，返回结构化结论、关键指标摘要与风险提示，整合财务质量、成长性、筹码分布等多维数据。

3. 交易观察：区分快档（趋势、量价、资金流、基础技术指标）与深档（叠加龙虎榜、机构席位扫描），支持RSI/KDJ/MACD/布林线等技术指标自动计算。

显著优点

• 精准定位：刻意收窄至A股个股单主线，不做"大而全"的ETF/期货/宏观覆盖，接口深度优于广度
• 智能路由：自然语言自动匹配最佳接口，处理日期区间、股票名称→ts_code转换、积分权限预判
• 透明可控：显式声明调用接口与积分门槛，不隐式缓存token，安全边界清晰
• 双模式输出：查询场景返原始数据，分析场景返结论+支撑数据，满足不同用户需求

潜在局限

• 强依赖外部服务：完全依赖Tushare Pro API稳定性与数据质量，历史数据完整性受平台限制
• 积分门槛制约：高频/分钟级数据、龙虎榜深度、部分财务明细需较高积分或额外权限，技能仅做拦截提示无法绕过
• A股限定：不支持港股、美股、加密货币等市场，跨市场投资者需另寻工具
• 技术指标局限：内建指标基于Tushare提供的基础数据计算，复杂衍生品定价、高频因子需自行扩展

适合人群

• A股基本面研究者：需批量提取财务数据、盈利预测、股东变动做模型输入
• 交易型用户：关注资金流向、龙虎榜异动、技术信号的日常盯盘需求
• 量化入门开发者：学习Tushare接口规范、理解A股数据结构的实践工具

常规风险

• 数据延迟风险：免费/低积分档位行情数据存在15分钟至数小时延迟，不适用于实盘高频决策
• 权限变动风险：Tushare接口权限规则可能调整，历史可用接口未来可能需额外积分
• 环境泄露风险：TUSHARE_TOKEN需妥善保管，技能虽避免主动生成缓存文件，但用户通过env文件传入时需自行管理文件权限
• 分析结论局限：自动生成的"估值/趋势/风险"结论基于规则化模板，非投资建议，重大决策需交叉验证

核心用法

Tushare A股研究技能是一个面向中国A股市场的高度专业化数据工具，通过自然语言或显式接口调用实现股票数据获取与分析。核心入口为 python scripts/tushare_stock.py run --text "<请求>"，支持三大使用模式：

数据查询模式：直接获取日线/周线/月线/分钟级行情、每日指标（daily_basic）、财务报表、业绩预告、股东数据、两融资金流向、龙虎榜等原始数据，优先返回结构化JSON。

个股分析模式：对"分析宁德时代估值和成长性"类请求，自动综合估值指标、财务质量、成长性、趋势判断与风险提示，输出结论+关键指标摘要。

交易观察模式：区分"快档"（量价结构、均线、RSI、KDJ、布林线、MACD、资金流）与"深档"（补充龙虎榜、机构席位扫描），根据请求深度自动切换。

技术实现上，技能通过环境变量TUSHARE_TOKEN认证（不生成本地token缓存），自动解析股票名称到ts_code，规范化日期区间与频率参数，并对积分门槛接口做显式拦截提示。

显著优点

1. 垂直深耕策略：刻意放弃"大而全"路线，专注A股个股研究单点，覆盖数据查询→估值分析→财务质量→趋势判断→风险提示→交易观察完整闭环
2. 双模交互设计：既支持自然语言直达，也支持显式fetch/analyze命令，兼顾探索灵活性与生产可复现性
3. 安全凭证管理：强制环境变量传参，不扫描家目录配置，不显式调用ts.set_token()避免本地缓存泄露
4. 透明边界控制：明确声明网络访问范围（api.waditu.com、tushare.pro）、积分限制、权限拦截规则，输出中标注实际调用接口与限制条件
5. 技术指标可扩展：通过@register_indicator装饰器注册新指标，主技能自动识别

潜在缺点与局限性

• 资产类别受限：明确不支持ETF、基金、期货、期权、宏观数据、海外市场，跨市场研究者需配合其他工具
• 积分成本敏感：Tushare Pro采用积分制，高频或深档查询可能触发额度限制；免费用户功能受限
• 实时性依赖上游：行情数据质量与延迟完全依赖Tushare官方服务，无独立数据源校验
• 个人项目维护风险：来源为GitHub个人开发者（T3级别），长期维护承诺与更新频率存在不确定性
• 缓存安全需关注：默认/tmp目录缓存，多用户环境需注意目录权限（0700）配置

适合人群

• A股基本面研究者：需要批量提取财务指标、估值数据、股东结构进行量化筛选
• 技术派交易者：依赖均线、RSI、KDJ、MACD、布林线、筹码分布等信号做交易决策
• 投研自动化开发者：需要结构化API调用、可复现的数据管道，而非临时脚本
• 风控与合规岗位：需要监控个股质押、解禁、大宗交易、龙虎榜异动等风险信号

常规风险

1. API Token泄露风险：若错误地将TUSHARE_TOKEN写入shell历史、日志文件或版本控制，可能导致账户被盗用
2. 积分耗尽导致服务中断：高频自动化调用可能快速消耗积分配额，建议监控调用量
3. 数据解读依赖专业能力：技能返回原始数据或分析结论，但投资决策仍需用户独立判断，工具不构成投资建议
4. 网络可用性依赖：Tushare官方服务中断或限速将直接影响技能可用性