ai-trading-web

AI 多智能体加密货币期货平台是一个面向生产的加密货币期货研究与执行系统，针对 Binance USD-M Futures 和 OKX 永续合约。它采用 pnpm 工作区结构，包含一个 Next.js Web 应用和一个 Node.js API，依赖通过 Prisma 的 PostgreSQL、Redis 和 BullMQ，并随 Docker Compose 配置一起交付。 该平台的核心原则是 AI 仅起咨询作用：智能体不能直接调用交易所适配器，自动化订单必须先经过 Decision/Judge 流水线和确定性风险引擎，交易引擎才能执行它们。 安全与账户。多用户身份验证、基于 Redis 的会话、CSRF 防护、TOTP 双因素认证、审计日志、Argon2id 密码哈希以及 AES-256-GCM 加密的提供商凭据。密码重置通过单一邮件传输配置（SMTP 或带密钥的 Webhook URL）；重置链接 15 分钟后失效、仅限一次使用、永不以明文形式存储或记录，成功修改密码后会撤销该账户的所有现有会话。 交易所集成。Binance Futures 和 OKX 适配器覆盖公开市场数据、私有账户状态、持仓、未成交订单、订单历史、下单、撤单以及在交易所支持时的保护性订单修改。 市场与外部数据。实时市场流、标准化 K 线、技术指标、缺口检测、回填、Redis 快照以及位于 /market 的 Socket.IO 命名空间。另一个摄取层处理新闻、交易所公告、事件、情绪、Reddit 以及宏观日历，配有摄取队列、去重和重要性评分，通过 /external-data 实时事件发布。 AI 基础设施。提供商独立的 AI 层，具备有限工具调用、智能体生命周期管理、Decision Agent、Judge 控制、BullMQ 流水线调度、回放、取消、健康报告和指标。 风险、组合与研究。确定性风险评估、组合敞口控制、策略分配与再平衡、绩效与反思循环、影子/金丝雀自学习、回测、验证、基准测试、模拟、因子发现和量化建议。 执行。基于交易所的 DEMO/LIVE 交易，配有杀死开关、幂等客户端订单 ID、状态同步、TP/SL 保护以及 Position Manager，通过 /live-trading 实时仪表板命名空间暴露。 自适应 TP/SL 与 Position Manager。与总是从环境百分比推导止盈止损不同，确定的 Trade Plan Engine 使用 ATR、支撑/阻力、EMA20/EMA50、ADX、效率比率、突破状态、市场结构、手续费以及配置的风险/回报要求，将市场状态划分为 TREND_UP、TREND_DOWN、RANGING、BREAKOUT 或 HIGH_VOLATILITY，并生成对应的计划类型：趋势回撤入场、区间边界入场与目标、突破/重新测试或波动率控制。引擎会拒绝入场位置不佳、止损结构过大以及净风险/回报低于策略的目标；诸如 STOP_LOSS_PCT 和 RISK_REWARD_RATIO 之类的设定仍作为策略默认值，在 ATR 和结构数据不可用时作为后备。入场后，Position Manager 会同步交易所状态，可将止盈移至盈亏平衡加上手续费缓冲、在出现足够有利波动后按 ATR 追踪止损、在达到 1R 时部分获利了结、保持停滞持仓直至出现明确的保护性、手动、交易所或策略授权平仓，通过适配器修改或取消/重新创建保护性订单，并在持仓关闭后清理孤立保护。LIVE_POSITION_SYNC_INTERVAL_MS 默认为 30 秒；交易所订单历史导入和实时交易仪表板限制为最近 20 条订单，而持仓及安全/防护检查不进行截断。 安全门槛。TRADING_MODE=DEMO 是安全的默认值。执行前系统会检查 GLOBAL_TRADING_ENABLED、LIVE_TRADING_ENABLED、已验证的连接状态、生产环境连接权限、最近身份验证、风险批准 TTL、敞口限制、杠杆限制、冷却时间以及杀死开关状态。LIVE 模式要求 LIVE_TRADING_ENABLED=true，且生产环境的交易所连接在未显式启用前保持禁用。README 建议在验证行为时使用专用的 demo/testnet 凭据，切勿使用具备提款能力的 API 密钥。 安装与运维。要求 Node.js 22.13 或更高版本（pnpm 11 所需）、pnpm 11 或更高版本，以及带 Docker Compose 的 Docker Desktop。本地设置将 .env.example 复制到根目录、apps/api 和 apps/web 目录，安装依赖，通过 Compose 启动 Postgres、Redis 和 Adminer，生成 Prisma 客户端，应用迁移并运行开发服务器；完整栈也可通过 docker compose up -d --build 启动。文档化服务包括：Web 应用监听 3000 端口，API 监听 3001 端口并提供 /api、/docs 和 /api/health 路径，Adminer 监听 8080 端口。脚本涵盖 dev、build、lint、严格的 TypeScript 类型检查、Vitest 单元测试套件、API 集成测试、端到端测试、格式检查，以及 Prisma 生成、迁移和 Studio。额外文档参见 ARCHITECTURE.md、API_CONTRACT.md、DATABASE.md、DIRECTORY_STRUCTURE.md、ROADMAP.md、PROJECT_CONTEXT.md、DEFINITION_OF_DONE.md 和 PROJECT_RULES.md。 项目声明的已知边界。纸面/影子记录存在并用于评估与自学习，但没有可与实盘交易相当的独立纸面交易执行 API。回测、演示运行和模型置信度不保证盈利能力，提升需要足够样本和回撤审查。代码更新不会影响正在运行的容器，直至 API 和 Web 服务被重建或重启。