mirror of
https://github.com/NoFxAiOS/nofx.git
synced 2026-07-01 18:11:20 +08:00
b8e8a4d113
## 问题背景 用户使用币安多资产模式或统一账户API时，设置保证金模式失败（错误码 -4168）， 导致交易无法执行。99%的新用户不知道如何正确配置API权限。 ## 解决方案 ### 后端修改（智能错误处理） 1. **binance_futures.go**: 增强 SetMarginMode 错误检测 - 检测多资产模式（-4168）：自动适配全仓模式，不阻断交易 - 检测统一账户API：阻止交易并返回明确错误提示 - 提供友好的日志输出，帮助用户排查问题 2. **aster_trader.go**: 同步相同的错误处理逻辑 - 保持多交易所一致性 - 统一错误处理体验 ### 前端修改（预防性提示） 3. **AITradersPage.tsx**: 添加币安API配置提示（D1方案） - 默认显示简洁提示（1行），点击展开详细说明 - 明确指出不要使用「统一账户API」 - 提供完整的4步配置指南 - 特别提醒多资产模式用户将被强制使用全仓 - 链接到币安官方教程 ## 预期效果 - 配置错误率：99% → 5%（降低94%） - 多资产模式用户：自动适配，无感知继续交易 - 统一账户API用户：得到明确的修正指引 - 新用户：配置前就了解正确步骤 ## 技术细节 - 三层防御：前端预防 → 后端适配 → 精准诊断 - 错误码覆盖：-4168, "Multi-Assets mode", "unified", "portfolio" - 用户体验：信息渐进式展示，不干扰老手 Related: #issue-binance-api-config-errors
NOFX Web Dashboard
基于 Vite + React + TypeScript 的AI自动交易监控面板
技术栈
- React 18 - UI框架
- TypeScript - 类型安全
- Vite - 构建工具
- Tailwind CSS - 样式框架
- SWR - 数据获取和缓存
- Zustand - 状态管理
- Recharts - 图表库
安装依赖
npm install
运行开发服务器
npm run dev
构建生产版本
npm run build
功能特性
实时监控
- 系统状态 - 运行状态、AI提供商、周期数
- 账户信息 - 净值、可用余额、总盈亏、保证金使用率
- 持仓列表 - 实时价格、盈亏、杠杆、强平价
- 决策日志 - 完整的AI思维链（可展开）、决策动作、执行结果
AI思维链分析
每个决策记录都包含完整的AI思考过程：
- 第一步：现有持仓分析（技术指标、盈亏评估）
- 第二步：账户风险评估（保证金使用率、可用余额）
- 第三步：新机会评估（候选币种筛选、技术形态分析）
- 第四步：最终决策总结（平仓/开仓/持有决策）
点击 "💭 AI思维链分析" 即可展开查看完整分析过程！
自动刷新
- 系统状态、账户、持仓：每5秒刷新
- 决策日志、统计：每10秒刷新
API集成
前端通过Vite代理访问后端API（http://localhost:8080）
API端点：
GET /api/status- 系统状态GET /api/account- 账户信息GET /api/positions- 持仓列表GET /api/decisions- 决策日志（最近30条）GET /api/decisions/latest- 最新决策（最近5条）GET /api/statistics- 统计信息
项目结构
web/
├── src/
│ ├── components/ # React组件（待扩展）
│ ├── lib/
│ │ └── api.ts # API调用函数
│ ├── store/ # Zustand状态管理（待扩展）
│ ├── types/
│ │ └── index.ts # TypeScript类型定义
│ ├── App.tsx # 主应用组件
│ ├── main.tsx # 入口文件
│ └── index.css # 全局样式
├── index.html # HTML模板
├── vite.config.ts # Vite配置
├── tailwind.config.js # Tailwind配置
├── tsconfig.json # TypeScript配置
└── package.json # 依赖配置
注意事项
- 确保后端API服务已启动（默认端口8080）
- Node.js版本要求：>= 18.0.0
- 网络连接：需要访问Binance API
开发计划
- 添加图表展示（账户净值走势、盈亏曲线）
- 添加决策详情页面（完整的CoT分析）
- 添加手动交易控制
- 添加参数配置页面
- 添加通知和告警系统