核心用法
股票技术分析技能是一款面向A股、港股、美股及基金（ETF/LOF/开放式）的专业技术分析工具，通过命令行接口提供实时技术指标计算与量化评分。
基础操作：支持单只证券分析（如python stock_analysis.py 600519）、批量并发分析（-b参数），以及持仓列表管理（--add/--remove/--watchlist）。自动识别市场与资产类型，无需手动指定。
技术指标覆盖：完整实现MA、MACD（含顶/底背离检测）、RSI、KDJ、布林带（含收窄检测）、ATR、成交量分析（量比/VMA）、支撑压力位及缺口检测共8大类指标。
量化评分系统：0-100分综合评分，基于均线趋势、价格位置、MACD、RSI、布林带、KDJ、成交量6个维度，输出5档趋势判断（强势上涨/上涨/震荡/下跌/强势下跌）。
输出灵活性：默认终端表格模式，支持JSON/--pretty格式化、--ascii英文标签模式、文件输出，以及--test离线模拟数据模式。
---
显著优点
1. 多市场统一接口：A股/港股/美股/基金全覆盖，代码自动识别规则成熟（6位数字规则、前缀识别等），降低用户使用门槛
2. 数据源韧性设计：新浪财经/yfinance为主源，akshare为备用，均配置3次重试机制，网络波动场景可用性高
3. 技术指标完整度高：MACD背离、布林带收窄、缺口检测等进阶功能均有实现，超越基础行情工具
4. 评分体系可解释：6维度±分值规则透明，用户可反推评分构成，非黑盒AI推荐
5. 工程化细节到位：并发批量分析（8线程）、持仓配置持久化、环境自检--check、依赖缺失友好提示
---
潜在缺点与局限性
1. 数据时效性瓶颈：免费数据源存在15-20分钟延迟，无法满足高频交易或打板需求；开放式基金更是日频更新
2. 数据源稳定性风险：新浪财经/yfinance均为非官方API，存在接口变更或限流可能，虽有多层备用但仍依赖第三方服务连续性
3. 评分算法主观性：权重固定（如均线±20、MACD±15），未针对不同市场（A股vs美股）、不同风格（价值vs成长）进行自适应调整
4. 无基本面数据：纯技术分析，缺乏PE/PB、财报、资金流向等基本面信息，难以支撑长期价值投资决策
5. 合规风险提示不足：虽v1.6.0已弱化"建议买入"等措辞，但评分输出仍可能被误解为投资推荐，需用户自行承担决策责任
6. 离线模式功能受限：--test模式仅提供模拟数据，无法用于真实分析
---
适合人群
- 个人投资者：需要快速获取多维度技术指标、进行持仓批量复盘的用户
- 量化入门学习者：希望理解经典技术指标计算逻辑、评分体系设计的开发者
- 自动化脚本需求者：JSON输出/
--quiet模式适合接入自有工作流或通知系统
---
常规风险
| 风险类型 | 说明 | 缓释建议 |
|---------|------|---------|
| **数据延迟风险** | 15-20分钟延迟可能导致信号滞后 | 仅用于日级及以上周期决策，避免短线交易依赖 |
| **数据源中断风险** | 新浪/yfinance接口变更可能导致功能失效 | 关注更新日志，及时升级；关键决策交叉验证 |
| **过度交易风险** | 频繁信号可能诱发非理性操作 | 结合基本面与仓位管理，避免唯技术指标论 |
| **模型过拟合风险** | 评分权重基于历史回测，未来市场风格可能失效 | 关注评分有效性，定期复盘信号准确率 |
| **合规风险** | 技术分析结果被误认为投资建议 | 明确"仅供参考"定位，留存免责声明 |