核心用法
quant-trading-signals 是一个轻量级量化交易信号生成工具，面向个人投资者提供基于经典技术指标的自动化分析。用户通过命令行传入股票代码（如 AAPL、BTC-USD），系统自动拉取数据并计算多维度信号，最终输出综合评分与交易建议。
功能模块
- MACD信号：识别金叉（买入）、死叉（卖出）及顶底背离
- RSI判断：超买（>70）/超卖（<30）区间预警
- KDJ组合：捕捉短期动量变化与交叉信号
- 均线系统：多头排列/空头排列趋势确认
- 布林带：价格突破上轨或下轨的极端行情识别
输出解读
系统以量化加权方式汇总各指标，生成「多头信号」与「空头信号」数值对比，配合星级强度（⭐-⭐⭐⭐⭐⭐）和文字建议（如"可以适当关注"），降低技术门槛。
---
显著优点
| 维度 | 说明 |
|------|------|
| 零配置快速启动 | 仅需安装 `yfinance` 和 `numpy`，单命令即可运行 |
| 多资产覆盖 | 支持股票（AAPL）、加密货币（BTC-USD）等YFinance可获取的标的 |
| 多指标融合 | 避免单一指标误判，综合5类经典技术面工具提升信号可靠性 |
| 结果可视化 | emoji星级与文字建议直观易懂，适合非专业用户 |
---
潜在缺点与局限性
1. 数据源依赖：基于Yahoo Finance免费数据，存在延迟、停牌数据缺失、退市数据异常等问题，不适用于高频或实盘直接下单
2. 参数固化：未暴露MACD快线/慢线周期、RSI阈值、均线周期等核心参数的调整接口，难以适配不同市场（美股/加密货币/期货）的波动特性
3. 回测缺失：无历史信号胜率统计，无法评估策略有效性
4. 信号滞后性：技术指标基于历史价格计算，本质为滞后指标，在剧烈波动或黑天鹅事件中可能产生连续错误信号
5. 无仓位管理：仅输出方向性建议，无止损止盈、仓位比例、资金曲线等风险控制模块
---
适合人群
- 技术分析学习者：希望快速验证指标组合效果的入门用户
- 多标的数据筛选者：需要从大量股票中初步筛选关注标的的业余投资者
- 量化策略原型开发者：作为信号生成模块的MVP（最小可行产品），后续可接入自建回测系统
不适合：追求Alpha的专业量化基金、依赖实时 tick 数据的高频交易者、无编程基础且不愿安装Python环境的纯小白用户。
---
常规风险
- 市场风险：技术指标在趋势行情有效，震荡市可能反复打脸产生连续亏损
- 执行风险：工具本身无交易接口，若用户据此手动下单，存在滑点、延时、委托失败等执行落差
- 过度拟合风险：默认参数可能过度优化历史数据，未来表现未必一致
- 合规风险：部分 jurisdictions 对自动化交易信号分发有监管要求，个人使用需注意当地法规
> ⚠️ 工具明确声明"仅供分析参考，不构成投资建议」，用户需独立判断并承担全部交易后果。