Oracle-X

Oracle-XAI 驱动的加密货币交易冷静层 + 全链路投资分析工具在你执行交易前，让 AI 为你把关。📖 项目简介Oracle-X 包含三个终端，共同构成完整的交易决策辅助体系：终端技术作用Web AppNext.js 14 + React 18实时行情、K 线图、技术指标、AI 分析弹窗Desktop AppElectron + SQLite全局监控、AI 截图分析、钱包分析、拦截引擎、i18n 双语Chrome ExtensionManifest V3交易平台按钮拦截、Smart Intercept 智能分析、冷静层弹窗🎯 核心功能Web App接入 Binance API 获取实时行情和 K 线数据技术指标面板（RSI、MACD、布林带、ATR）Twitter 社交情绪分析AI 流式分析 + 三级风险建议（🟢建议执行 / 🟡建议观望 / 🔴高风险）Decision Log 看板（筛选、导出 JSON/CSV、复盘指标）Desktop App零配置启动 — SQLite 本地存储，无需安装数据库侧边栏分析面板 — 截图 → AI 分析 → 右侧滑出展示（平台识别 / 风险等级 / 建议操作）拦截引擎 — 结合用户交易习惯 + 实时市场分析的智能风险评估堆叠通知系统 — 多条通知同时显示，渐变配色 + 自动消失i18n 双语支持 — 中文 / English 界面切换全局截图监控 + 交易按钮检测（MiniMax Vision AI）钱包分析（ETH/BSC/SOL/Polygon/Arbitrum）CSV/XLSX 交易记录导入（支持 8+ 交易所格式）全局快捷键（⌘+Shift+O 截图 / ⌘+Shift+S 分析）系统托盘常驻 + 开机自启 + 隐私权限分级引导Chrome Extension自动拦截 8 大交易平台买卖按钮🆕 Smart Intercept 两阶段智能分析Stage 1：本地快速评分（波动率 + 频率 + RSI + 杠杆，< 500ms）Stage 2：AI 深度分析（SSE 流式，仅中/高风险触发）渐进式干预：低风险气泡通知 → 中风险极速弹窗 → 高风险强制冷静截图 → 视觉 AI 分析 → NoFOMO 冲动评估设置页面配置 API 地址、风险参数、智能拦截灵敏度🚀 快速开始Web App# 安装依赖 cd Oracle-X && npm install # 配置环境变量 cp .env.example .env.local # 编辑 .env.local，填入 STEP_API_KEY、AI_BASE_URL 等 # 启动开发服务器 npm run dev # 访问 http://localhost:3000Desktop Appcd desktop && npm install npm run dev首次启动会自动创建 SQLite 数据库于 ~/Library/Application Support/Oracle-X/oraclex.db，无需额外配置。Chrome Extension详见 Extension 使用文档打开 chrome://extensions/，开启开发者模式加载已解压的扩展程序 → 选择 extension/ 目录右键扩展图标 → 选项 → 配置 API 地址和风险参数📡 API 接口路由方法说明/api/analyzePOST核心 AI 分析（SSE 流式返回）/api/marketGET聚合市场数据（ticker + 指标 + 情绪）/api/decisionPOSTNoFOMO 决策评估/api/decision-logGET决策日志查询/api/trade/historyPOST交易历史 CSV 分析/api/data/refinePOST多源数据聚合/api/recognizePOST截图视觉识别/api/klinesGETBinance K 线代理/api/tickerGETBinance Ticker 代理/api/twitterGETTwitter 情绪分析/api/healthGET健康检查/api/config-statusGET配置状态检查详细请求/响应格式参见 API 文档🏗️ 技术栈层级技术Web 前端Next.js 14 + React 18 + TypeScript图表lightweight-charts (TradingView)技术分析technicalindicators (RSI/MACD/BB/ATR)AI 引擎MiniMax / Step AI（兼容 OpenAI 格式）桌面端Electron + better-sqlite3 + uiohook-napi浏览器扩展Chrome Manifest V3国际化自研 i18n（中文/English）数据源Binance API + RapidAPI (Twitter) + CoinGecko打包electron-builder (Mac/Win/Linux)测试Jest + 自定义 TestRunner📁 目录结构Oracle-X/ ├── app/ # Next.js Web App │ ├── api/ # 12 个 API 路由 │ ├── components/ # React 组件 │ ├── hooks/ # 自定义 Hooks │ └── decision-log/ # 决策日志页面 ├── lib/ # 核心业务逻辑（AI Client、指标计算、验证器等） ├── desktop/ # Electron 桌面端 │ ├── src/ │ │ ├── main.js # Electron 主进程 │ │ ├── preload.js # 上下文桥接 │ │ ├── analyzer/ # AI 分析（截图、钱包、风险引擎、交易分析器） │ │ ├── core/ # 核心（拦截引擎） │ │ ├── data/ # 数据层（SQLite、CSV 导入、市场数据、设置存储） │ │ ├── monitor/ # 监控（全局监听、截图捕获） │ │ ├── ocr/ # OCR（Vision AI 识别） │ │ └── system/ # 系统（托盘、通知、自启动、快捷键、权限管理） │ └── renderer/ # 渲染进程 │ ├── index.html # 主页面 │ ├── renderer.js # 渲染脚本 │ ├── styles.css # 样式 │ ├── i18n.js # 国际化引擎 │ └── locales/ # 语言包（zh-CN / en） ├── extension/ # Chrome Extension │ ├── content/ # Content Script（平台拦截 + 快速评分） │ ├── intercept/ # 极速拦截弹窗 │ ├── sidepanel/ # Side Panel 分析面板 │ └── settings/ # 设置页面 ├── tests/ # 测试套件 ├── test_data/ # 测试 CSV 数据 ├── docs/ # 项目文档 └── types/ # TypeScript 类型定义🔧 环境变量# === 必填 === STEP_API_KEY=your_api_key # AI API Key AI_BASE_URL=https://... # AI 网关地址 AI_MODEL=model_name # 文本模型 # === 可选 === AI_VISION_MODEL=vision_model # 视觉模型（截图分析） AI_TEMPERATURE=0.3 # 温度参数 AI_MAX_TOKENS=1000 # 最大令牌数 HTTP_PROXY= # HTTP 代理（留空则直连） RAPIDAPI_KEY= # Twitter API