本系统采用最小人工干预的设计理念，摒弃传统的硬编码交易规则，让 AI 模型基于原始市场数据进行自主学习和决策。

┌─────────────────────────────────────────────────────────┐
│                   Trading Agent (AI)                    │
│              (DeepSeek V3.2 / Gork4 / Claude)           │
└─────────────────┬───────────────────────────────────────┘
                  │
                  ├─── Market Data Analysis
                  ├─── Position Management
                  └─── Trade Execution Decisions
                  
┌─────────────────┴───────────────────────────────────────┐
│                    VoltAgent Core                       │
│              (Agent Orchestration & Tool Routing)       │
└─────────┬───────────────────────────────────┬───────────┘
          │                                   │
┌─────────┴──────────┐            ┌───────────┴───────────┐
│    Trading Tools   │            │   Gate.io API Client  │
│                    │            │                       │
│ - Market Data      │◄───────────┤ - Order Management    │
│ - Account Info     │            │ - Position Query      │
│ - Trade Execution  │            │ - Market Data Stream  │
└─────────┬──────────┘            └───────────────────────┘
          │
┌─────────┴──────────┐
│   LibSQL Database  │
│                    │
│ - Account History  │
│ - Trade Signals    │
│ - Agent Decisions  │
└────────────────────┘

本项目依赖 Gate.io 交易所 API。如果您还没有账户，请先完成注册：

推荐注册方式：

• 立即注册 Gate.io
• 邀请码：VVVEA10LVQ

通过上方邀请码注册，您可享受交易返佣优惠，同时为开源项目的持续发展提供支持。

新手建议：先注册并使用测试网环境学习，零风险体验完整功能。

• Node.js >= 20.19.0
• npm 或 pnpm 包管理器
• Git 版本控制工具

# 克隆仓库
git clone <repository-url>
cd open-nof1.ai

# 安装依赖
npm install

在项目根目录创建 .env 文件:

# 服务器配置
PORT=3100

# 交易参数
TRADING_INTERVAL_MINUTES=5      # 交易循环间隔
MAX_LEVERAGE=10                 # 最大杠杆倍数
MAX_POSITIONS=5                 # 最大持仓数量
MAX_HOLDING_HOURS=36            # 最大持有时长(小时)
INITIAL_BALANCE=2000            # 初始资金(USDT)

# 数据库
DATABASE_URL=file:./.voltagent/trading.db

# Gate.io API 凭证(建议先使用测试网!)
GATE_API_KEY=your_api_key_here
GATE_API_SECRET=your_api_secret_here
GATE_USE_TESTNET=true

# AI 模型提供商（OpenAI 兼容 API）
OPENAI_API_KEY=your_api_key_here
OPENAI_BASE_URL=https://openrouter.ai/api/v1  # 可选
AI_MODEL_NAME=deepseek/deepseek-v3.2-exp      # 模型名称

# 账户回撤风控配置
# 当账户资产相比峰值回撤达到以下百分比时的风控措施：
ACCOUNT_DRAWDOWN_WARNING_PERCENT=20          # 警告阈值：发出风险警告提醒
ACCOUNT_DRAWDOWN_NO_NEW_POSITION_PERCENT=30  # 禁止开仓阈值：停止开新仓位，只允许平仓
ACCOUNT_DRAWDOWN_FORCE_CLOSE_PERCENT=50      # 强制平仓阈值：自动平掉所有仓位，保护剩余资金

API 密钥获取:

• OpenRouter: https://openrouter.ai/keys
• OpenAI: https://platform.openai.com/api-keys
• DeepSeek: https://platform.deepseek.com/api_keys
• Gate.io 测试网: https://www.gate.io/testnet
• Gate.io 正式网: https://www.gatesite.org/signup/VVVEA10LVQ?ref_type=103

提示: 通过上方邀请链接或使用邀请码 VVVEA10LVQ 注册 Gate.io 账户，您将获得交易佣金返还优惠。

npm run db:init

# 开发模式(热重载)
npm run dev

# 生产模式
npm run trading:start

在浏览器中访问 http://localhost:3100

完整文档请参考：

• 英文完整文档 – 完整功能列表、API 参考、故障排查指南
• 中文完整文档 – 完整功能列表、API 参考、故障排查指南
• 日文完整文档 – 完全な機能リスト、APIリファレンス、トラブルシューティング

• ✅ 详细功能说明
• ✅ 完整配置指南
• ✅ 所有命令参考
• ✅ 生产部署指南
• ✅ 故障排查和常见问题
• ✅ API 文档
• ✅ 最佳实践
• ✅ 贡献指南

• 模型支持: DeepSeek V3.2, Grok4, Claude 4.5, Gemini Pro 2.5
• 自主分析: 无预配置交易信号
• 多时间框架: 跨多个时间窗口聚合数据
• 风险管理: AI 控制的仓位规模和杠杆管理

• 支持资产: BTC, ETH, SOL, BNB, XRP, DOGE, GT, TRUMP, ADA, WLFI
• 合约类型: USDT 结算永续合约
• 杠杆范围: 1倍至10倍(可配置)
• 订单类型: 市价单、止损、止盈

• Web 仪表板: 实时账户指标和持仓概览
• AI 决策日志: 透明展示模型推理过程
• 交易历史: 完整的交易记录与时间戳

⚠️ 本系统仅供教育和研究目的。加密货币交易具有重大风险,可能导致资金损失。

• 务必先在测试网测试策略
• 仅投资您能承受损失的资金
• 用户对所有交易活动承担全部责任
• 系统性能不提供任何保证或担保

本项目采用 GNU Affero General Public License v3.0 (AGPL-3.0) 协议。

• 免费使用: 您可以出于任何目的使用本软件
• 开源要求: 任何修改必须在 AGPL-3.0 下发布
• 网络使用: 如果作为服务提供必须公开源代码
• 无担保: 软件按”原样”提供

完整条款请参见 LICENSE 文件。

如果您还没有 Gate.io 账户，强烈建议通过以下方式注册：

注册方式：

• 邀请链接: https://www.gatesite.org/signup/VVVEA10LVQ?ref_type=103
• 邀请码: VVVEA10LVQ

双赢方案：

• 您的优势：获得交易手续费返佣，长期使用可节省可观成本
• 项目支持：您的使用将帮助维护这个开源项目的持续开发
• 无额外费用：完全免费，不影响您的任何交易体验

提示：测试网和正式网可以用同一个账户，建议您先在测试网充分测试后再进行真实交易。

• VoltAgent 文档
• OpenRouter 模型目录
• Gate.io API 参考
• Gate.io 测试网

欢迎贡献！请参考完整文档了解贡献指南。