Hermes Finance

面向 AI Agent 的多市场金融分析框架。你可以直接对 Claude Code、Codex、Cursor、Gemini、Roo、Cline 等工具说“分析 BTC”或“EURUSD 现在怎么看”，Hermes Finance 会自动识别市场、采集数据、生成结构化分析报告。

它不是单一指标提示器，而是一套分层证据审计流程：行情、合约、链上、宏观、情绪、新闻、交易所价差、缠论确认分层处理。脚本只采集各维度证据，方向由 AI 基于证据逻辑强度综合判断（不用投票计数或权重打分）；证据不足或冲突时输出观望，证据充分时再给偏多/偏空判断、反向审计和交易计划。

支持市场：

• 加密货币：K 线、合约、链上、情绪、宏观、期权、交易所价差、新闻事件
• 商品期货：技术结构、OI/费率、EIA 库存、CFTC 持仓、OVX/DXY 交叉验证
• 外汇：K 线结构、利差、央行事件、CFTC、美元与风险资产环境
• A 股：指数、个股、北向资金、涨跌家数、板块轮动、量化选股
• 美股：个股、ETF、VIX、10Y 美债、公司事件、市场交叉验证

核心能力：

• MCP + Skills 双入口，AI 工具可以直接调用
• 自动市场路由，减少手动选择数据源
• 多源数据采集，缺失数据会在报告里显式标注
• 七维证据采集 + 缠论确认，避免单一技术指标主导结论
• 各维度证据综合判断（不用投票计数或权重打分）、反向审计、情景推演和交易计划
• Crypto 4H 市场架构 HTML 图，绘制父趋势、子趋势、突破和回踩结构

本项目用于技术交流和研究，不构成投资建议。

怎么用

装上就能用

bash install.sh

三种用法

1. 在 AI 工具里用（推荐）

支持 Claude Code、Codex、Cursor、VS Code Copilot、Gemini、Roo、Cline 等。项目里配好了对应的 .mcp.json 等文件，AI 自动识别。

打开 AI 工具，直接说：

"分析 BTC" "EURUSD 现在怎么看" "帮我看看上证指数"

AI 会自动拉数据、过八维、出结论。

2. 命令行用

python3 -m hermes_finance analyze crypto BTC
python3 -m hermes_finance analyze forex EURUSD
python3 -m hermes_finance analyze futures GC
python3 -m hermes_finance analyze us-equity SPY
python3 -m hermes_finance analyze a-share --stock 600519

3. 独立脚本用

python3 skills/crypto-market-analysis/scripts/fetch_data.py BTC all
python3 skills/crypto-market-analysis/scripts/market_structure_chart.py BTC
python3 skills/futures-market-analysis/scripts/futures_fetch.py GC

选交易风格

第一次用的时候，AI 会问你：

短线（1H+15min）、中线（1D+4H）、还是长线（1W+1D）？

选完以后所有缠论分析自动用对应级别。想换随时说"切换到中线模式"。

也可以设环境变量：

export HERMES_TRADING_MODE=medium

怎么分析

不是看一眼 K 线就说涨跌。分六步走：

第一步：认市场

你给个标的——BTC、600519、EURUSD、CL、AAPL——它先判断这是什么市场。不会把 A 股代码当成加密货币，也不会把期货当成美股。

第二步：拉数据

根据市场类型，跑到各个数据源去抓数据。

拿加密货币举例，同时拉八个来源：

每个来源拉成功还是失败都会记下来。缺了什么后面会明确标注。

第三步：缠论算结构

把 K 线数据喂给缠论引擎，按你选的交易频段（短线 1H+15min、中线 1D+4H、长线 1W+1D）做多级别分析：

• 找笔——这段行情是向上还是向下
• 划中枢——多空双方在哪个区间打架
• 判买卖点——一买二买三买出现了吗
• 查背驰——价格创新高了但力度跟不上，要反转吗
• 共振评分——大级别和小级别方向一致吗

（A 股、外汇、期货的 K 线由采集器提供，不依赖币安。非加密市场走同一个缠论引擎，只是数据来源不同。）

第四步：七维证据采集

缠论是第八维。前面七个维度先各自采集证据：

拿加密货币来说：

每个维度独立给出偏多/偏空/中性的证据判断。同类的数据源合并成一个维度，不会重复计入。脚本只负责把证据摆出来，方向不由投票计数决定。

第五步：AI 综合判断方向

证据采集完，由 AI 基于各维度证据的逻辑强度综合判断方向，而不是数票数：

1. 证据充分性——关键维度（如 K 线）缺失时不给方向
2. 证据一致性——多维度同向且无硬反证时，给偏多/偏空
3. 硬反证优先——比如美元暴涨 + 美股暴跌同时出现，方向打架就观望

第六步：缠论确认

前七维证据采集完，再看缠论：

• 缠论也同方向 → 增强信心
• 缠论反方向 → 降级，标出来"缠论冲突"
• 缠论跑不了（缺 K 线）→ 标"缠论不足"，仍以前七维为准

缠论永远不主导方向。 它是确认层，不是决策层。

结论怎么出

过了证据判断的给方向，证据不够的就观望。观望不是失败——证据不够还硬给方向才是问题。

输出的报告里有：

• 数据完整性——哪些拉到了，哪些缺了
• 各维度证据——每个维度偏多还是偏空
• 方向判断依据——证据充分性、一致性、硬反证逐项列出来
• 反向审计——做多之前先看做空的最强理由是什么
• 缠论确认——共振还是背驰还是不可用
• 最终方向——偏多、偏空、震荡、观望
• 情景推演——如果涨了怎么办，如果跌了怎么办
• 交易计划——证据充分时才给入场/止损/止盈

八个市场

项目结构

hermes-finance/
├── hermes_finance/          # 共享核心（CLI/MCP/Skills 都用它）
├── hermes_finance_mcp/      # MCP server（给 AI 工具调用）
├── scripts/                 # 可执行脚本
│   ├── czsc_analyze.py      #   缠论引擎
│   └── shared_ta.py         #   共享技术分析
├── skills/                  # 8 个分析技能（每个都有 SKILL.md + 采集脚本 + 分析脚本）
└── bin/                     # 入口脚本

更新日志

完整日志见 Releases 和 CHANGELOG.md。

技术结构逻辑图和 HTML 形态图说明见 docs/TECHNICAL_ARCHITECTURE.md。

v1.3.1 — 全市场移除投票决策：脚本只采集各维度证据，方向由 AI 基于证据逻辑强度综合判断（不用投票计数或权重打分）

v1.3.0 — Crypto 移除投票决策：脚本只采集各维度证据，方向由 AI 综合判断

v1.2.13 — Crypto 趋势矩阵补强：扩散震荡遇到主高点后回调时保留父级上轨延伸，真正下降反转仍走峰值后下降链

v1.2.12 — Crypto 形态图轨道改为直线延伸：父级上轨不再被 6/16 后 lower-high 折下去，回调链作为子趋势绘制

v1.2.11 — Crypto 形态图统一改为外沿包络线：上轨包住摆高、下轨托住摆低，避免单币锚点补丁

v1.2.10 — 修复 Crypto 下降/楔形上轨：使用峰值后的 lower high 链，BTC 上轨不再被早期高点带偏

v1.2.9 — Crypto 市场架构图新增子趋势层：父级通道保留，最近回调/反弹通道单独绘制

v1.2.8 — 修复 Crypto 底部趋势模式上轨：连接主升有效摆高，跳过回调 lower high

v1.2.7 — 优化 Crypto 市场架构图：底部趋势线优先，ZEC 这类 2026-06-05 起涨结构从关键低点开始连线

v1.2.6 — 修复 Crypto 市场架构图：保留父级上升/下降趋势，短线反向摆点只作为扰动，结构线从有效摆点起画

v1.2.5 — 新增 Crypto 4H 市场架构 HTML 形态图（上轨/下轨/中轨/摆点/突破触发）

v1.2.4 — 新增技术结构 Mermaid 逻辑图文档

v1.2.3 — 新增 Crypto 4H 市场架构识别（通道/箱体/楔形/扩散结构）

v1.2.2 — 修复 Crypto 技术结构“偏空但缺失”的矛盾判定

v1.2.1 — CZSC 稳定性修复、版本锁定、动态 K 线窗口、测试恢复

v1.2.0 — 交易频段系统（短线/中线/长线）、shared_ta 消除重复、默认 1H+15m

v1.1.x — Crypto 新闻基本面、反向审计、AI 客户端适配

v1.0.x — 首次发布，15 项修复

⚠️ 免责声明

本项目仅用于技术交流和学习研究，不构成投资建议。市场有风险，投资需谨慎。