NOFX AI量化交易系统 - 完整使用手册

第一部分：系统概述

1.1 NOFX是什么？

NOFX是一个基于人工智能的加密货币自动交易系统，它能够：

1. ✅ 24小时自动监控市场：无需人工盯盘
2. ✅ AI智能决策：使用DeepSeek、Qwen等大语言模型分析市场
3. ✅ 多交易所支持：币安、Hyperliquid、Aster DEX
4. ✅ 风险自动控制：内置止损、仓位限制、保证金管理
5. ✅ 完整决策记录：每笔交易都有详细的AI思维链日志
6. ✅ 实时可视化监控：专业的Web仪表盘

1.2 系统架构简图

1.3 核心工作流程

第二部分：环境准备

2.1 硬件要求

最低配置：

1. CPU: 双核 2.0GHz
2. 内存: 2GB RAM
3. 存储: 10GB 可用空间
4. 网络: 稳定的互联网连接

推荐配置：

1. CPU: 四核 2.5GHz+
2. 内存: 4GB RAM
3. 存储: 20GB SSD
4. 网络: 5Mbps+ 带宽

2.2 软件依赖

方式一：Docker部署（强烈推荐）

只需要安装Docker：

Windows/macOS:

1. 访问 Docker Desktop官网
2. 下载对应系统的安装包
3. 双击安装，一路"下一步"
4. 重启计算机

Linux (Ubuntu/Debian):

验证安装：

方式二：手动部署（开发者）

如果你想修改代码或深度定制，需要手动安装：

1. 安装 Go (1.21+)

2. 安装 Node.js (18+)

3. 安装 TA-Lib

2.3 账户准备

（1）币安账户（必需）

步骤：

1. 注册账户
2. 访问：https://www.binance.com/join?ref=TINKLEVIP
3. 使用邮箱或手机号注册
4. 完成邮箱/手机验证
5. 完成KYC认证
6. 进入"用户中心" → "身份认证"
7. 上传身份证/护照
8. 人脸识别验证
9. 等待审核（通常1-24小时）
10. 开通合约交易
11. 访问"衍生品" → "U本位合约"
12. 点击"立即开通"
13. 阅读并同意风险协议
14. 创建API密钥
15. 进入"用户中心" → "API管理"
16. 点击"创建API"
17. 输入标签名称（如：NOFX_Trading）
18. 重要：只勾选"启用合约交易"，不要勾选"提现"
19. 完成二次验证
20. 立即保存API Key和Secret Key（只显示一次！）
21. 绑定IP白名单（强烈推荐）
22. 在API管理页面，找到刚创建的API
23. 点击"编辑"
24. 添加你的服务器IP（如果是本地测试，添加你的公网IP）
25. 保存

资金准备：

1. 测试阶段：建议100-500 USDT
2. 正式运行：建议500-2000 USDT
3. ⚠️ 切记：只投入你能承受损失的资金

（2）AI API密钥（必需）

推荐：DeepSeek（性价比最高）

1. 访问：https://platform.deepseek.com
2. 使用邮箱注册
3. 进入"余额充值"，充值$20-50（推荐）
4. 进入"API Keys"，点击"创建新密钥"
5. 立即复制保存密钥（格式：sk-xxxxxxxxxxxxxxxxxx）

费用参考：

1. 价格：$0.14 / 百万tokens
2. 日消耗：约$1-2（24小时运行，3分钟决策间隔）
3. $50可用约1个月

备选：通义千问 Qwen

1. 访问：https://dashscope.console.aliyun.com
2. 使用阿里云账号登录（需要中国手机号）
3. 开通"DashScope"服务
4. 创建API密钥

第三部分：快速部署

3.1 下载项目

3.2 配置系统

步骤1：创建配置文件

步骤2：编辑配置文件

Windows用户：

macOS/Linux用户：

步骤3：填写基础配置

最简配置示例：

生成随机JWT密钥：

配置项说明：

⚠️ 重要提醒：

1. jwt_secret 必须修改为你自己的随机字符串
2. 币安子账户杠杆最高只能5倍
3. 主账户可以设置更高，但新手不推荐

3.3 启动系统

使用Docker（推荐）

启动成功标志：

使用手动部署

终端1：启动后端

终端2：启动前端

3.4 访问系统

打开浏览器，访问：

首次登录凭证（管理员模式）：

1. 用户名：admin
2. 密码：admin123

⚠️ 安全提示：生产环境必须立即修改密码！

第四部分：Web界面操作

4.1 登录系统

1. 打开 http://localhost:3000
2. 输入用户名和密码
3. 点击"登录"按钮

界面语言切换：

1. 右上角有语言切换按钮
2. 支持：中文、English

4.2 主界面导航

4.3 配置AI模型

步骤：

1. 进入"交易员管理"页面
2. 点击"AI模型配置"按钮
3. 启用DeepSeek或Qwen

配置DeepSeek：

配置Qwen：

1. 点击"保存配置"

验证成功标志：

1. 看到"配置保存成功"提示
2. AI模型列表中状态显示为"已启用"

4.4 配置交易所

步骤：

1. 在"交易员管理"页面
2. 点击"交易所配置"按钮
3. 选择Binance

配置Binance：

1. 点击"保存配置"

验证连接：

1. 系统会自动测试连接
2. 成功后显示"连接成功"
3. 失败会显示错误信息（检查API密钥是否正确）

第五部分：交易员管理

5.1 创建交易员

步骤：

1. 进入"交易员管理"页面
2. 点击"创建交易员"按钮
3. 填写以下信息：

1. 点击"创建"按钮

命名建议：

1. 描述性命名：如"DeepSeek-保守-5倍杠杆"
2. 包含策略特点：如"Qwen-激进-主流币"
3. 方便多交易员对比

5.2 启动交易员

步骤：

1. 在交易员列表中找到你创建的交易员
2. 点击"启动"按钮
3. 确认弹窗中点击"确定"

启动成功标志：

1. 状态变为"运行中"（绿色）
2. 显示运行时长倒计时
3. 开始出现决策记录

首次决策时间：

1. 通常需要等待3-5分钟（一个扫描周期）
2. 首次决策可能显示"观望"（正常现象）
3. AI需要先分析市场环境

5.3 停止交易员

步骤：

1. 找到正在运行的交易员
2. 点击"停止"按钮
3. 确认弹窗中点击"确定"

停止后行为：

1. ✅ 已有持仓保持不变（不会自动平仓）
2. ✅ 不再产生新的决策
3. ✅ 可以随时重新启动
4. ⚠️ 如需平仓，请在交易所手动操作或使用"一键平仓"功能

5.4 删除交易员

步骤：

1. 确保交易员已停止
2. 点击"删除"按钮
3. 确认弹窗中输入交易员名称
4. 点击"确定"

⚠️ 警告：

1. 删除后无法恢复
2. 决策日志会保留在decision_logs目录
3. 但数据库中的权益历史会被清除

5.5 批量操作

一键启动所有交易员：

一键停止所有交易员：

第六部分：监控与分析

6.1 实时监控面板

账户信息卡片：

字段解释：

1. 总权益：账户总价值 = 可用余额 + 已用保证金 + 未实现盈亏
2. 可用余额：可以用来开新仓的资金
3. 总盈亏：相对初始余额的收益率
4. 保证金使用率：已用保证金 / 总权益（超过90%会限制开仓）
5. 持仓数量：当前持有的仓位个数

6.2 持仓列表

示例：

颜色标识：

1. 🟢 绿色：盈利持仓
2. 🔴 红色：亏损持仓
3. 🟡 黄色：接近强平价（警告）

6.3 权益曲线图

功能：

1. 📈 显示账户价值随时间的变化
2. 🔄 可切换"绝对值"和"百分比"视图
3. 🔍 鼠标悬停查看具体数值
4. 📅 支持时间范围筛选（1天/7天/30天/全部）

分析技巧：

1. 平滑上升：策略稳健，风险控制良好
2. 剧烈波动：杠杆过高或仓位管理不当
3. 持续下跌：市场环境不适合，考虑暂停
4. 台阶式上升：抓住了几次好机会，但频率不高

6.4 AI决策日志

查看方法：

1. 进入"交易员详情"页面
2. 滚动到"AI决策日志"区域
3. 点击任意决策记录的"展开"按钮

日志内容：

日志解读要点：

1. 输入数据：AI看到了什么信息
2. 思维链：AI如何分析市场（最重要）
3. 决策输出：AI最终的指令
4. 执行结果：系统是否成功执行

6.5 统计数据

关键指标：

指标说明：

1. 胜率：盈利交易 / 总交易次数
2. 盈亏比：平均盈利 / 平均亏损（>1说明赚得比亏得多）
3. 夏普比率：风险调整后的收益（>1优秀，>2非常优秀）
4. 最大回撤：从峰值到谷底的最大跌幅

第七部分：高级配置

7.1 自定义交易策略

功能说明： 你可以为交易员添加个性化策略指令，系统会将其追加到AI的Prompt中。

配置方法：

1. 进入"交易员详情"页面
2. 点击"编辑策略"按钮
3. 在文本框中输入你的策略描述

示例1：保守策略

示例2：激进策略

示例3：趋势跟踪

注意事项：

1. 策略描述要清晰明确，避免模糊表达
2. AI会尽量遵守，但仍会结合市场实际情况调整
3. 不能违背系统的硬约束（如风险回报比≥1:3）

7.2 调整杠杆配置

修改方法：

编辑config.json文件：

重启系统生效：

杠杆建议：

⚠️ 警告：

1. 币安子账户最高只能5倍（平台限制）
2. 高杠杆=高风险，可能快速爆仓
3. 建议从保守开始，逐步调整

7.3 自定义币种列表

方法：

编辑config.json：

添加币种要求：

1. 必须是币安合约支持的币种
2. 格式必须为 XXXUSDT（大写）
3. 建议选择流动性好的主流币（日交易量>1亿美元）

查看支持的币种：

1. 访问币安合约官网
2. 查看"U本位合约"列表
3. 确认币种代码

7.4 配置扫描间隔

修改方法：

在创建交易员时设置，或通过Web界面编辑：

费用对比：

1. 3分钟：每天480次决策，AI费用约$2-3
2. 5分钟：每天288次决策，AI费用约$1.5-2
3. 10分钟：每天144次决策，AI费用约$0.8-1

7.5 风险控制参数

编辑config.json：

参数说明：

1. max_daily_loss：当天亏损超过此比例，自动停止交易
2. max_drawdown：从最高点回撤超过此比例，自动停止
3. stop_trading_minutes：风控触发后的冷静期（6小时=360分钟）

7.6 多交易所配置

配置Hyperliquid（去中心化）：

1. 导出MetaMask私钥（移除0x前缀）
2. Web界面"交易所配置"选择Hyperliquid
3. 填写：

配置Aster DEX：

1. 访问 Aster API Wallet
2. 创建API钱包，获取Signer地址和私钥
3. Web界面配置：

第八部分：故障排查

8.1 常见错误及解决方案

问题1：Docker启动失败

错误信息：

解决方法：

问题2：端口被占用

错误信息：

解决方法：

方法1：修改端口

方法2：释放占用端口

问题3：AI API调用失败

错误信息：

可能原因及解决：

1. API密钥错误
2. 检查配置中的API密钥是否正确
3. 确认密钥未过期
4. 余额不足
5. 登录DeepSeek/Qwen后台
6. 检查账户余额
7. 充值
8. 网络问题
9. 检查服务器网络连接
10. 尝试ping api.deepseek.com
11. 如在国内，可能需要配置代理
12. API速率限制
13. 降低扫描频率（改为5分钟或10分钟）
14. 联系AI平台提升限额

问题4：币安API连接失败

错误信息：

解决步骤：

1. 检查API密钥

1. 检查API权限

1. 检查IP白名单

1. 检查时间同步

问题5：Web界面无法访问

错误信息：

解决方法：

1. 检查服务是否运行

1. 检查端口映射

1. 尝试其他端口

问题6：持仓数据不更新

症状：

1. 权益曲线不动
2. 持仓盈亏不变化

解决方法：

1. 强制刷新页面

1. 检查后端连接

1. 重启系统

8.2 日志查看

Docker部署查看日志：

手动部署查看日志：

8.3 数据备份与恢复

备份数据：

恢复数据：

自动备份脚本（Linux）：

设置定时备份（crontab）：

第九部分：最佳实践

9.1 新手起步建议

第1周：测试阶段

第2-4周：观察阶段

1-3个月：优化阶段

9.2 资金管理策略

分级投入：

风险控制：

9.3 监控频率建议

过度监控的坏处：

1. 容易情绪化干预AI决策
2. 增加心理压力
3. 影响正常工作生活

推荐监控频率：

设置警报：

9.4 不同市场环境应对

牛市（持续上涨）：

熊市（持续下跌）：

震荡市（横盘）：

暴涨暴跌（剧烈波动）：

9.5 多交易员组合策略

策略组合示例：

优势：

1. 分散风险
2. 对比不同AI模型和策略
3. 学习不同风格的优劣

第十部分：常见问题FAQ

Q1：系统会自动止损吗？

答： 会！每笔开仓都会自动设置止损订单。

1. AI在做决策时会计算止损价和止盈价
2. 系统执行时会同时下"开仓单"和"止损/止盈单"
3. 触发条件后会自动平仓，无需人工干预

Q2：我可以手动干预吗？

答： 可以！你有完全控制权。

手动平仓：

1. Web界面持仓列表点击"平仓"按钮
2. 或直接在币安APP/网页端操作

手动调整止损止盈：

1. Web界面点击"修改止损止盈"
2. 或在币安端修改委托订单

手动开仓：

1. 建议不要，会干扰AI的整体策略
2. 如需手动交易，建议用另一个账户

Q3：可以同时运行多个交易员吗？

答： 完全可以！

前提条件：

1. 每个交易员需要独立的交易所账户
2. 或使用不同交易所（一个币安，一个Hyperliquid）

示例配置：

这样可以实现AI模型PK，非常有趣！

Q4：夜间会自动交易吗？

答： 会！这正是AI的优势。

1. 24小时自动运行
2. 不会错过任何机会
3. 不受情绪影响

但要注意：

1. 确保服务器/电脑不关机
2. 网络连接稳定
3. 建议部署到云服务器

Q5：亏损了怎么办？

答： 冷静分析，理性应对。

短期亏损（-5%以内）：

1. 正常波动，观察几天
2. 查看AI决策日志，分析原因
3. 检查是否遇到不利市场环境

中期亏损（-10%左右）：

1. 降低杠杆倍数
2. 减少交易频率
3. 考虑调整策略Prompt

严重亏损（-20%以上）：

1. 立即停止交易员
2. 全面复盘所有交易
3. 判断是策略问题还是市场环境问题
4. 必要时暂停一段时间

记住：止损是为了保护本金！

Q6：哪个AI模型更好？

答： 没有绝对答案，各有特点。

DeepSeek：

1. ✅ 便宜（$0.14/百万tokens）
2. ✅ 快速（响应<2秒）
3. ✅ 稳定，适合保守策略
4. ❌ 有时过于谨慎

Qwen（通义千问）：

1. ✅ 中文理解好
2. ✅ 有时更激进，收益可能更高
3. ❌ 风险也相对更大
4. ❌ 可能需要中国手机号注册

建议：

1. 新手先用DeepSeek
2. 有经验后可以同时运行两个对比

Q7：能保证盈利吗？

答： 不能！必须实话实说。

AI能做的：

1. ✅ 24小时监控，不错过机会
2. ✅ 纪律执行，不情绪化
3. ✅ 多维度分析，决策更全面
4. ✅ 自学习优化，避免重复错误

AI做不到的：

1. ❌ 预测黑天鹅事件
2. ❌ 对抗市场大趋势
3. ❌ 100%胜率

实际表现（用户反馈）：

1. 震荡市/牛市：60%用户盈利
2. 熊市：约40%用户盈利
3. 年化收益：-20%到+50%不等

重要： 只投入你能承受损失的资金！

Q8：API密钥安全吗？

答： 遵守安全规则就安全。

安全措施：

1. ✅ 只开"合约交易"权限，不开"提现"
2. ✅ 绑定IP白名单
3. ✅ 定期更换API密钥
4. ✅ 不要分享给任何人
5. ✅ config.json不要上传到公开仓库

即使泄露：

1. 黑客最多只能帮你交易（亏损）
2. 无法提现你的资金
3. 发现后立即在币安端删除API

Q9：可以用于股票/期货吗？

答： 目前不行，但未来会支持。

当前支持：

1. ✅ 加密货币合约（币安、Hyperliquid、Aster）

计划支持（Roadmap）：

1. 🔜 美股、A股
2. 🔜 商品期货
3. 🔜 外汇市场
4. 🔜 期权交易

架构上支持扩展，只需要对接新的交易所API。

Q10：系统开源吗？

答： 完全开源！

1. GitHub：https://github.com/tinkle-community/nofx
2. 代码可审计、可修改
3. MIT许可证
4. 欢迎贡献代码

好处：

1. 透明，没有后门
2. 社区驱动，持续改进
3. 可以自己定制功能

附录A：快速参考卡

常用命令

关键配置

重要端口

目录结构

附录B：支持资源

学习资源

1. 量化交易入门：《量化投资：以Python为工具》
2. 技术分析：《日本蜡烛图技术》
3. 风险管理：《交易心理分析》
4. 加密货币：CoinMarketCap学院

附录C：更新日志

v3.0.0 (2025-10-30) - 重大更新

核心改进：

1. ✅ 完全数据库驱动（SQLite）
2. ✅ Web界面配置（无需编辑JSON）
3. ✅ 用户认证系统（JWT + 2FA）
4. ✅ 多AI模型、多交易所灵活组合
5. ✅ 增强的API层

结语

恭喜你读完这份使用手册！🎉

现在你应该已经掌握了：

1. ✅ NOFX的基本原理和工作流程
2. ✅ 如何部署和配置系统
3. ✅ 如何创建和管理交易员
4. ✅ 如何监控和分析交易表现
5. ✅ 常见问题的解决方法
6. ✅ 最佳实践和风险控制策略

记住最重要的三点：

1. 从小做起 - 用100-200U测试，不要着急投入大资金
2. 持续学习 - 每周复盘AI决策日志，理解其逻辑
3. 风险控制 - 设置止损阈值，不要贪婪，保护本金

下一步建议：

祝你使用愉快，交易顺利！🚀

​