用途
Scanning Market Movers 是一个用于实时检测和分析加密货币市场中显著价格波动与异常成交量模式的技能。它帮助用户识别涨幅榜、跌幅榜和成交量激增的币种，并按综合显著性评分排序，以便优先关注更具参考价值的市场异动。
主要能力
- 扫描 1000+ 种加密货币寻找价格异动
- 可配置阈值（涨跌幅百分比、成交量激增倍数、市值范围）
- 通过显著性评分进行优先级排序
- 支持类别过滤（DeFi、Layer2、NFT、游戏、Meme）
- 支持多种输出格式（表格、JSON、CSV）
- 支持多种时间框架（如 1 小时、24 小时、7 天）
依赖与准备
该技能使用 market-price-tracker 插件中的 tracking-crypto-prices 技能作为价格数据基础设施。需先安装依赖：
pip install requests pandas
并确保已安装 market-price-tracker 插件且配置了 tracking-crypto-prices 技能。
使用方式
- 快速市场扫描（返回按 24 小时涨跌幅排序的前 20 名涨幅和跌幅币种，含成交量确认）：
python {baseDir}/scripts/scanner.py
- 自定义阈值，例如只显示涨跌超过 10% 且成交量激增超过 3 倍的币种，或按市值过滤：
python {baseDir}/scripts/scanner.py --min-change 10 --volume-spike 3
python {baseDir}/scripts/scanner.py --min-cap 100000000 --max-cap 1000000000
- 类别过滤，例如只看 DeFi 或 Layer2：
python {baseDir}/scripts/scanner.py --category defi
python {baseDir}/scripts/scanner.py --category layer2
可用类别：defi、layer2、nft、gaming、meme。
- 切换时间框架：
python {baseDir}/scripts/scanner.py --timeframe 1h
python {baseDir}/scripts/scanner.py --timeframe 7d
- 导出结果：
python {baseDir}/scripts/scanner.py --format json --output movers.json
python {baseDir}/scripts/scanner.py --format csv --output movers.csv
输出说明
默认表格输出包含涨幅榜与跌幅榜，字段包括排名、交易符号、价格、涨跌幅、成交量比率、市值和评分，并附有扫描汇总信息。JSON 输出包含 gainers、losers 和 meta 三部分，meta 中记录扫描时间、阈值、总扫描数量和匹配数量。
显著性评分
显著性评分范围为 0-100，由三部分加权组合：涨跌幅占 40%，成交量比率占 40%，市值占 20%。评分越高，表示该异动的显著性越高、可信度越强。
配置
可编辑 {baseDir}/config/settings.yaml 调整默认阈值、评分权重和显示设置。可配置项包括最小涨跌幅、成交量激增倍数、最小/最大市值、评分权重、每类结果数量、排序方式以及类别对应的 CoinGecko 类别 ID。
还可在 {baseDir}/config/presets/ 中创建命名预设（如 aggressive、conservative），并通过 --preset 参数调用：
python {baseDir}/scripts/scanner.py --preset aggressive
错误处理
常见错误包括：依赖未找到（需安装 market-price-tracker 插件）、未发现异动（阈值过严，需放宽）、超过速率限制（需等待或使用缓存数据）、部分结果缺失（属正常情况，可继续使用已有数据）。详细错误处理见 {baseDir}/references/errors.md。
示例
python {baseDir}/scripts/scanner.py --timeframe 24h --top 20
python {baseDir}/scripts/scanner.py --volume-spike 5 --min-volume 1000000
python {baseDir}/scripts/scanner.py --category defi --format csv --output defi_movers.csv
python {baseDir}/scripts/scanner.py --min-cap 1000000000 --gainers-only --top 10
与其他技能的集成
可与其他加密货币技能组合使用，例如与 crypto-signal-generator 配合，先获取异动再为涨幅榜生成信号；与 arbitrage-opportunity-finder 配合，成交量激增往往先于套利机会出现，可将异动结果作为套利扫描的输入。
文件结构
scripts/scanner.py：主 CLI 入口scripts/analyzer.py：核心分析逻辑scripts/filters.py：阈值过滤scripts/scorers.py：显著性评分scripts/formatters.py：输出格式化config/settings.yaml：用户配置config/presets/：命名预设配置
参考资源
- PRD.md：产品需求
- ARD.md：架构文档
- 依赖技能：tracking-crypto-prices
- CoinGecko API 文档：https://www.coingecko.com/en/api