[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-terryso--nof1-tracker":3,"tool-terryso--nof1-tracker":62},[4,18,28,36,45,54],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":24,"last_commit_at":25,"category_tags":26,"status":17},9989,"n8n","n8n-io\u002Fn8n","n8n 是一款面向技术团队的公平代码（fair-code）工作流自动化平台，旨在让用户在享受低代码快速构建便利的同时，保留编写自定义代码的灵活性。它主要解决了传统自动化工具要么过于封闭难以扩展、要么完全依赖手写代码效率低下的痛点，帮助用户轻松连接 400 多种应用与服务，实现复杂业务流程的自动化。\n\nn8n 特别适合开发者、工程师以及具备一定技术背景的业务人员使用。其核心亮点在于“按需编码”：既可以通过直观的可视化界面拖拽节点搭建流程，也能随时插入 JavaScript 或 Python 代码、调用 npm 包来处理复杂逻辑。此外，n8n 原生集成了基于 LangChain 的 AI 能力，支持用户利用自有数据和模型构建智能体工作流。在部署方面，n8n 提供极高的自由度，支持完全自托管以保障数据隐私和控制权，也提供云端服务选项。凭借活跃的社区生态和数百个现成模板，n8n 让构建强大且可控的自动化系统变得简单高效。",184740,2,"2026-04-19T23:22:26",[16,14,13,15,27],"插件",{"id":29,"name":30,"github_repo":31,"description_zh":32,"stars":33,"difficulty_score":10,"last_commit_at":34,"category_tags":35,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":24,"last_commit_at":42,"category_tags":43,"status":17},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",161147,"2026-04-19T23:31:47",[14,13,44],"语言模型",{"id":46,"name":47,"github_repo":48,"description_zh":49,"stars":50,"difficulty_score":51,"last_commit_at":52,"category_tags":53,"status":17},8272,"opencode","anomalyco\u002Fopencode","OpenCode 是一款开源的 AI 编程助手（Coding Agent），旨在像一位智能搭档一样融入您的开发流程。它不仅仅是一个代码补全插件，而是一个能够理解项目上下文、自主规划任务并执行复杂编码操作的智能体。无论是生成全新功能、重构现有代码，还是排查难以定位的 Bug，OpenCode 都能通过自然语言交互高效完成，显著减少开发者在重复性劳动和上下文切换上的时间消耗。\n\n这款工具专为软件开发者、工程师及技术研究人员设计，特别适合希望利用大模型能力来提升编码效率、加速原型开发或处理遗留代码维护的专业人群。其核心亮点在于完全开源的架构，这意味着用户可以审查代码逻辑、自定义行为策略，甚至私有化部署以保障数据安全，彻底打破了传统闭源 AI 助手的“黑盒”限制。\n\n在技术体验上，OpenCode 提供了灵活的终端界面（Terminal UI）和正在测试中的桌面应用程序，支持 macOS、Windows 及 Linux 全平台。它兼容多种包管理工具，安装便捷，并能无缝集成到现有的开发环境中。无论您是追求极致控制权的资深极客，还是渴望提升产出的独立开发者，OpenCode 都提供了一个透明、可信",144296,1,"2026-04-16T14:50:03",[13,27],{"id":55,"name":56,"github_repo":57,"description_zh":58,"stars":59,"difficulty_score":24,"last_commit_at":60,"category_tags":61,"status":17},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",109154,"2026-04-18T11:18:24",[14,15,13],{"id":63,"github_repo":64,"name":65,"description_en":66,"description_zh":67,"ai_summary_zh":68,"readme_en":69,"readme_zh":70,"quickstart_zh":71,"use_case_zh":72,"hero_image_url":73,"owner_login":74,"owner_name":75,"owner_avatar_url":76,"owner_bio":77,"owner_company":78,"owner_location":79,"owner_email":80,"owner_twitter":81,"owner_website":82,"owner_url":83,"languages":84,"stars":93,"forks":94,"last_commit_at":95,"license":96,"difficulty_score":24,"env_os":97,"env_gpu":98,"env_ram":99,"env_deps":100,"category_tags":106,"github_topics":107,"view_count":24,"oss_zip_url":78,"oss_zip_packed_at":78,"status":17,"created_at":109,"updated_at":110,"faqs":111,"releases":152},9929,"terryso\u002Fnof1-tracker","nof1-tracker","A command-line tool for tracking nof1.ai AI Agent trading signals and automatically executing Binance futures trades","nof1-tracker 是一款专为加密货币交易者设计的命令行工具，旨在自动跟踪 nof1.ai 平台上的 AI 量化代理交易信号，并在币安（Binance）合约市场执行实时跟单操作。它有效解决了人工监控多个 AI 策略耗时费力、容易错过最佳进出场时机的问题，通过自动化流程实现从信号识别到订单执行的全链路闭环。\n\n该工具特别适合具备一定技术基础的开发者、量化交易爱好者以及希望尝试 AI 辅助交易的进阶用户。使用者只需配置好币安 API 密钥，即可让系统 24 小时不间断地监控包括 GPT-5、DeepSeek、Gemini 等在内的七个主流 AI 代理动向。其核心技术亮点在于智能识别开仓、平仓、换仓及止盈止损等复杂交易行为，并支持自定义盈利目标自动退出与重新入场机制。此外，nof1-tracker 还提供了安全的“风险控制模式”，允许用户在未投入真实资金的情况下模拟运行，验证策略有效性；配合 Telegram 消息推送功能，让用户能随时掌握账户动态。需要注意的是，由于 nof1.ai 近期策略转向美股，当前版本主要针对历史或特定场景下的加密货币期货交易，用户在使用前建议结合最新项目动态","nof1-tracker 是一款专为加密货币交易者设计的命令行工具，旨在自动跟踪 nof1.ai 平台上的 AI 量化代理交易信号，并在币安（Binance）合约市场执行实时跟单操作。它有效解决了人工监控多个 AI 策略耗时费力、容易错过最佳进出场时机的问题，通过自动化流程实现从信号识别到订单执行的全链路闭环。\n\n该工具特别适合具备一定技术基础的开发者、量化交易爱好者以及希望尝试 AI 辅助交易的进阶用户。使用者只需配置好币安 API 密钥，即可让系统 24 小时不间断地监控包括 GPT-5、DeepSeek、Gemini 等在内的七个主流 AI 代理动向。其核心技术亮点在于智能识别开仓、平仓、换仓及止盈止损等复杂交易行为，并支持自定义盈利目标自动退出与重新入场机制。此外，nof1-tracker 还提供了安全的“风险控制模式”，允许用户在未投入真实资金的情况下模拟运行，验证策略有效性；配合 Telegram 消息推送功能，让用户能随时掌握账户动态。需要注意的是，由于 nof1.ai 近期策略转向美股，当前版本主要针对历史或特定场景下的加密货币期货交易，用户在使用前建议结合最新项目动态进行评估。","# Nof1 AI Agent 跟单交易系统\n\n> 由于nof1.ai新一季是炒美股, 所以本脚本暂时没用了 \u003C\u002Fbr>\n> 如果想用自己的大模型来执行自动交易, 可以使用 https:\u002F\u002Fgithub.com\u002Fterryso\u002FLLM-trader-test 这个项目\n\n中文 | [English](.\u002FREADME_EN.md)\n\n![TypeScript](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Ftypescript-5.0%2B-blue)\n![Node.js](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fnode-%3E%3D18.0.0-green)\n![License](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-MIT-blue)\n\n一个用于跟踪 nof1.ai AI Agent 交易信号并自动执行 Binance 合约交易的命令行工具。支持7个AI量化Agent的实时跟单，自动识别开仓、平仓、换仓和止盈止损信号。\n\n[![ko-fi](https:\u002F\u002Fko-fi.com\u002Fimg\u002Fgithubbutton_sm.svg)](https:\u002F\u002Fko-fi.com\u002FF1F11HO935)\n\n\u003Cimg width=\"220\" height=\"286\" alt=\"b7c0054cf81fe6735d60ab5de48243e5\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fterryso_nof1-tracker_readme_09888277b53c.png\" \u002F>\n\n## 🏢 代部署服务\n\n**不想自己部署？我们提供代部署服务！**\n\n### 服务器部署的优势\n- 🖥️ **无需本地电脑运行** - 服务器24小时自动运行，无需保持自己的电脑开着\n- 🌍 **无需翻墙** - 推荐的服务器在国外环境，访问Binance API和nof1.ai更稳定\n- 🔋 **省心省力** - 专业配置，自动运行，无需担心环境配置和网络问题\n\n### 服务费用\n- 💰 **服务器成本低** - 一个服务器月租仅需40元人民币\n- 🛠️ **部署服务费面议** - 根据具体需求进行配置和部署\n\n### 联系方式\n📱 **有意者请加微信**: `gptkit`\n\n> 备注：代部署服务包含完整的环境配置、系统部署、运行测试和使用指导。\n\n## ⚡ 快速开始\n\n```bash\n# 1. 安装和构建\nnpm install && npm run build\n\n# 2. 配置环境变量\ncp .env.example .env\n# 编辑 .env 文件，填入 Binance API 密钥（必须启用合约交易权限）\n\n# 3. 查看可用的AI Agent\nnpm start -- agents\n\n# 4. 测试Telegram通知（可选）\nnpm start -- telegram-test\n\n# 5. 开始跟单（风险控制模式，不会真实交易）\nnpm start -- follow deepseek-chat-v3.1 --risk-only\n\n# 6. 持续监控跟单（每30秒检查一次）\nnpm start -- follow gpt-5 --interval 30\n\n# 7. 查看盈利统计\nnpm start -- profit\n```\n\n## 🚀 功能特性\n\n- **🤖 AI Agent跟单**: 支持7个AI量化交易Agent（GPT-5、Gemini、DeepSeek等）\n- **📊 实时监控**: 可配置轮询间隔，持续跟踪Agent交易动作\n- **🔄 智能跟单**: 自动识别开仓、平仓、换仓（OID变化）和止盈止损\n- **🎯 盈利目标退出**: 支持设置自定义盈利目标，达到后自动平仓退出\n- **🔄 自动重新跟单**: 可选的自动重新跟单功能，支持盈利退出和手工平仓后自动重新入场\n- **⚡ 合约交易**: 完整支持Binance USDT永续合约，支持1x-125x杠杆\n- **📈 盈利统计**: 精确的盈利分析，基于真实交易数据计算（含手续费统计）\n- **🛡️ 风险控制**: 支持`--risk-only`模式，只观察不执行交易\n\n## 📊 实盘跟踪\n\n**deepseek-chat-v3.1 Agent 实盘跟踪面板**: [https:\u002F\u002Fnof1-tracker-dashboard.onrender.com](https:\u002F\u002Fnof1-tracker-dashboard.onrender.com)\n\n实时查看 deepseek-chat-v3.1 AI Agent 的交易表现、持仓情况和盈亏统计。\n\nDashboard项目地址: https:\u002F\u002Fgithub.com\u002Fterryso\u002Fnof1-tracker-dashboard\n\n## 🤖 支持的AI Agent\n\n| Agent名称 |\n|----------|\n| **gpt-5** |\n| **gemini-2.5-pro** |\n| **deepseek-chat-v3.1** |\n| **claude-sonnet-4-5** |\n| **buynhold_btc** |\n| **grok-4** |\n| **qwen3-max** |\n\n\n## ⚙️ 配置\n\n### 1. Binance API 密钥配置（重要）\n\n本系统使用 **Binance 合约交易API**，必须正确配置权限：\n\n#### 创建API密钥\n1. 首先先注册一个币安帐号: https:\u002F\u002Fwww.maxweb.red\u002Freferral\u002Fearn-together\u002Frefer2earn-usdc\u002Fclaim?hl=zh-CN&ref=GRO_28502_ACBRJ&utm_source=default\n2. 登录 [Binance](https:\u002F\u002Fwww.binance.com\u002F) → [API Management](https:\u002F\u002Fwww.binance.com\u002Fen\u002Fmy\u002Fsettings\u002Fapi-management)\n3. 创建新API密钥，完成安全验证\n   \n\n#### 配置权限（关键）\n- ✅ **Enable Futures** - 启用合约交易（必选）\n- ✅ **Enable Reading** - 启用读取权限（必选）\n- ❌ **Enable Withdrawals** - 不需要提现权限\n\n#### 测试网环境（推荐新手）\n1. 访问 [Binance Testnet](https:\u002F\u002Ftestnet.binancefuture.com\u002F)\n2. 创建测试网API密钥\n3. 在`.env`中设置：\n   ```env\n   BINANCE_TESTNET=true\n   BINANCE_API_KEY=测试网API密钥\n   BINANCE_API_SECRET=测试网Secret密钥\n   ```\n\n### 2. 环境变量配置\n\n```env\n# Binance API Configuration - 必须支持合约交易\nBINANCE_API_KEY=your_binance_api_key_here\nBINANCE_API_SECRET=your_binance_api_secret_here\nBINANCE_TESTNET=true  # true=测试网, false=正式网\n\n# 其他配置选项\nLOG_LEVEL=INFO  # 日志级别\nTELEGRAM_API_TOKEN=  # Telegram Bot Token (可选)\nTELEGRAM_CHAT_ID=    # Telegram Chat ID (可选)\nTELEGRAM_ENABLED=false\n```\n\n## 📖 使用方法\n\n### 核心命令\n\n#### 1. 查看可用的AI Agent\n```bash\nnpm start -- agents\n```\n\n#### 2. Telegram通知配置（可选）\n\n如果您想在交易执行时收到Telegram通知，请按以下步骤配置：\n\n**创建Telegram Bot**：\n1. 在Telegram中搜索 `@BotFather`\n2. 发送 `\u002Fnewbot` 创建新机器人\n3. 按提示设置机器人名称和用户名\n4. 获取Bot Token（格式：`1234567890:ABCdefGHIjklMNOpqrsTUVwxyz`）\n\n**获取Chat ID**：\n1. 在Telegram中搜索 `@userinfobot`\n2. 发送任意消息获取您的Chat ID\n3. 或者发送消息给您的机器人，然后访问：`https:\u002F\u002Fapi.telegram.org\u002Fbot\u003CTOKEN>\u002FgetUpdates`\n\n**环境变量配置**：\n```bash\n# 在 .env 文件中添加\nTELEGRAM_BOT_TOKEN=1234567890:ABCdefGHIjklMNOpqrsTUVwxyz\nTELEGRAM_CHAT_ID=123456789\n```\n\n**测试Telegram通知**：\n```bash\nnpm start -- telegram-test\n```\n\n#### 3. 跟单AI Agent（核心功能）\n\n**基础用法**：\n```bash\n# 单次执行\nnpm start -- follow deepseek-chat-v3.1\n\n# 持续监控（每30秒轮询）\nnpm start -- follow gpt-5 --interval 30\n\n# 风险控制模式（只观察不执行）\nnpm start -- follow claude-sonnet-4-5 --risk-only\n```\n\n**高级选项**：\n```bash\n# 设置总保证金（默认10 USDT）\nnpm start -- follow gpt-5 --total-margin 5000\n\n# 设置每个币种固定保证金（固定金额分配模式）\nnpm start -- follow gpt-5 --fixed-amount-per-coin 100\n\n# 设置价格容差（默认1.0%）\nnpm start -- follow deepseek-chat-v3.1 --price-tolerance 1.0\n\n# 盈利目标退出（达到30%盈利时自动平仓）\nnpm start -- follow gpt-5 --profit 30\n\n# 盈利目标退出 + 自动重新跟单\nnpm start -- follow deepseek-chat-v3.1 --profit 30 --auto-refollow\n\n# 设置保证金模式（逐仓模式）\nnpm start -- follow gpt-5 --margin-type ISOLATED\n\n# 设置保证金模式（全仓模式，默认）\nnpm start -- follow deepseek-chat-v3.1 --margin-type CROSSED\n\n# 组合使用\nnpm start -- follow gpt-5 --interval 30 --total-margin 2000 --profit 25 --auto-refollow --margin-type ISOLATED\n\n# 固定金额分配模式组合使用\nnpm start -- follow gpt-5 --interval 30 --fixed-amount-per-coin 100 --profit 25 --auto-refollow\n```\n\n**命令选项说明**：\n- `-r, --risk-only`: 只评估不执行交易（安全模式）\n- `-i, --interval \u003Cseconds>`: 轮询间隔（秒），默认30秒\n- `-t, --price-tolerance \u003Cpercentage>`: 价格容差百分比，默认1.0%\n- `-m, --total-margin \u003Camount>`: 总保证金（USDT），默认10\n- `--fixed-amount-per-coin \u003Camount>`: 每个币种固定保证金（USDT），固定金额分配模式\n- `--profit \u003Cpercentage>`: 盈利目标百分比，达到后自动平仓退出\n- `--auto-refollow`: 自动重新跟单，支持盈利退出和手工平仓后自动重新入场（默认关闭）\n- `--margin-type \u003Ctype>`: 保证金模式，ISOLATED（逐仓）或 CROSSED（全仓，默认）\n\n**资金分配模式说明**：\n\n1. **总保证金模式（默认）**: `--total-margin 5000`\n   - 将总保证金按比例分配给所有跟单的币种\n   - 适合分散投资，自动平衡各个仓位的资金分配\n\n2. **固定金额分配模式**: `--fixed-amount-per-coin 100`\n   - 为每个币种分配固定金额的保证金\n   - 资金不足时按优先级顺序分配，先到先得\n   - 严格控制每个仓位的最大风险\n\n⚠️ **注意**: `--total-margin` 和 `--fixed-amount-per-coin` 不能同时使用，只能选择一种分配模式。\n\n#### 4. 盈利统计分析\n```bash\n# 统计跟单开始以来的总盈利（默认包含浮动盈亏）\nnpm start -- profit\n\n# 统计指定时间范围的盈利\nnpm start -- profit --since 7d        # 最近7天\nnpm start -- profit --since 2024-01-01 # 从2024年1月1日开始\nnpm start -- profit --since 1704067200000 # 使用时间戳\n\n# 指定交易对统计\nnpm start -- profit --pair BTCUSDT\n\n# JSON格式输出\nnpm start -- profit --format json\n\n# 强制刷新缓存数据\nnpm start -- profit --refresh\n\n# 包含当前仓位的浮动盈亏（默认行为）\nnpm start -- profit\n\n# 仅显示当前仓位的浮动盈亏（不含已实现交易）\nnpm start -- profit --unrealized-only\n\n# 排除浮动盈亏（仅分析已实现交易）\nnpm start -- profit --exclude-unrealized\n```\n\n**profit命令选项说明**：\n- `-s, --since \u003Ctime>`: 时间筛选器，支持\"7d\"（最近7天）、\"2024-01-01\"（指定日期）、时间戳格式。不指定则使用order-history.json的创建时间\n- `-p, --pair \u003Csymbol>`: 指定交易对（如BTCUSDT）\n- `--group-by \u003Ctype>`: 分组方式：symbol（按交易对）或all（全部）\n- `--format \u003Ctype>`: 输出格式：table（表格）或json（JSON）\n- `--refresh`: 强制刷新缓存，获取最新数据\n- `--exclude-unrealized`: 排除当前仓位的浮动盈亏，仅分析已实现交易\n- `--unrealized-only`: 仅显示当前仓位的浮动盈亏\n\n**输出统计信息**：\n- **基础统计**: 总交易次数、已实现盈亏（扣除手续费）、胜率、平均盈利\u002F亏损\n- **浮动盈亏**: 当前仓位数量、总浮动盈亏、详细仓位信息（默认包含，使用--exclude-unrealized时排除）\n- **总盈亏**: 已实现盈亏 + 浮动盈亏的完整盈利情况\n- **手续费分析**: 总手续费支出、平均每笔手续费\n- **风险指标**: 最大单笔盈利、最大单笔亏损、浮动盈亏风险提示\n- **分组统计**: 按交易对分组的详细盈利情况\n\n#### 4. 系统状态检查\n```bash\nnpm start -- status\n```\n\n### 跟单策略说明\n\n系统自动识别4种交易信号：\n\n1. **📈 新开仓 (ENTER)** - Agent开新仓位时自动跟单\n2. **📉 平仓 (EXIT)** - Agent平仓时自动跟单\n3. **🔄 换仓 (OID变化)** - 检测到entry_oid变化时，先平旧仓再开新仓\n4. **🎯 止盈止损** - 价格达到profit_target或stop_loss时自动平仓\n\n### 🎯 盈利目标退出和自动重新跟单\n\n#### 盈利目标退出\n设置自定义盈利目标，当仓位达到指定盈利百分比时自动平仓退出：\n\n```bash\n# 当盈利达到30%时自动平仓\nnpm start -- follow gpt-5 --profit 30\n\n# 当盈利达到50%时自动平仓\nnpm start -- follow deepseek-chat-v3.1 --profit 50\n```\n\n**特点**：\n- ✅ 实时监控每个仓位的盈利百分比\n- ✅ 达到目标后立即执行市价平仓\n- ✅ 支持多头和空头仓位的盈利计算\n- ✅ 完整的盈利退出事件记录\n\n#### 自动重新跟单（增强版）\n`--auto-refollow` 选项现在支持两种自动重新跟单场景：\n\n**1. 盈利目标退出后重新跟单**：\n```bash\n# 盈利30%退出后，自动重新跟单\nnpm start -- follow gpt-5 --profit 30 --auto-refollow\n\n# 组合使用：持续监控 + 盈利目标 + 自动重新跟单\nnpm start -- follow deepseek-chat-v3.1 --interval 30 --profit 25 --auto-refollow\n```\n\n**2. 手工平仓后自动重新跟单（新功能）**：\n```bash\n# 启用手工平仓检测和自动重新跟单\nnpm start -- follow deepseek-chat-v3.1 --auto-refollow\n\n# 即使不设置盈利目标，也会检测手工平仓\nnpm start -- follow gpt-5 --interval 30 --auto-refollow\n```\n\n**手工平仓检测原理**：\n- 🔍 系统比对 NOF1 API 数据和币安实际仓位\n- 🔧 当 NOF1 显示有仓位但币安无仓位时，判定为手工平仓\n- 📝 自动记录手工平仓事件\n- 🔄 重置订单历史，允许重新跟单\n- ⏭️ 当 NOF1 再次开仓时，自动跟随\n\n**工作流程**：\n\n*盈利退出场景*：\n1. 🔍 检测到仓位盈利达到目标（如30%）\n2. 💰 立即执行市价平仓，锁定盈利\n3. 📝 记录盈利退出事件到历史\n4. 🔄 重置该symbol的订单处理状态\n5. ⏭️ 下个轮询周期检测到OID变化，自动重新跟单\n\n*手工平仓场景*：\n1. 👤 用户在币安 App 手工平仓\n2. 🔍 下次轮询时系统检测到仓位差异\n3. 📝 记录手工平仓事件到历史\n4. 🔄 重置该symbol的订单处理状态\n5. ⏭️ 当 NOF1 再次开仓时，自动跟随\n\n**安全特性**：\n- 🛡️ 重新跟单前进行价格容忍度检查\n- 📊 保留agent原始的止盈止损计划\n- 🔄 可选功能，默认关闭避免意外影响\n- 📝 完整的操作日志记录\n- 🔒 手工平仓检测仅在启用 `--auto-refollow` 时激活\n\n**使用场景**：\n- 🎯 **仅盈利退出**：`--profit 30` （达到30%盈利时平仓，不重新跟单）\n- 🔄 **盈利退出+重新跟单**：`--profit 30 --auto-refollow` （盈利退出后自动重新跟单）\n- 🔧 **手工平仓+重新跟单**：`--auto-refollow` （检测手工平仓并自动重新跟单）\n- 🚀 **完整自动化**：`--profit 30 --auto-refollow` （同时支持盈利退出和手工平仓的重新跟单）\n\n**使用建议**：\n- 🎯 保守策略：`--profit 20` （20%盈利退出，不重新跟单）\n- ⚖️ 平衡策略：`--profit 30 --auto-refollow` （30%盈利退出并重新跟单）\n- 🚀 积极策略：`--auto-refollow` （灵活手工干预，自动重新跟单）\n- 💎 专业策略：`--profit 50 --auto-refollow` （高盈利目标+手工平仓支持）\n\n### 使用示例\n\n**新手入门**：\n```bash\n# 1. 检查系统配置\nnpm start -- status\n\n# 2. 查看可用Agent\nnpm start -- agents\n\n# 3. 风险控制模式测试\nnpm start -- follow buynhold_btc --risk-only\n\n# 4. 单次跟单测试\nnpm start -- follow deepseek-chat-v3.1\n\n# 5. 查看盈利统计\nnpm start -- profit\n```\n\n**持续监控**：\n```bash\n# 每30秒检查一次\nnpm start -- follow gpt-5 --interval 30\n\n# 多Agent并行监控（不同终端）\nnpm start -- follow gpt-5 --interval 30\nnpm start -- follow deepseek-chat-v3.1 --interval 45\nnpm start -- follow claude-sonnet-4-5 --interval 60 --risk-only\n```\n\n**盈利分析**：\n```bash\n# 查看总盈利情况（默认包含浮动盈亏）\nnpm start -- profit\n\n# 仅查看已实现盈利（排除浮动盈亏）\nnpm start -- profit --exclude-unrealized\n\n# 仅查看当前仓位的浮动盈亏\nnpm start -- profit --unrealized-only\n\n# 按不同时间范围分析\nnpm start -- profit --since 1d      # 最近1天\nnpm start -- profit --since 7d      # 最近1周\nnpm start -- profit --since 30d     # 最近1月\n\n# 按交易对分析\nnpm start -- profit --pair BTCUSDT --since 7d\nnpm start -- profit --pair ETHUSDT --format json\n\n# JSON格式输出（默认包含浮动盈亏）\nnpm start -- profit --format json\n\n# 仅浮动盈亏的JSON格式输出\nnpm start -- profit --unrealized-only --format json\n```\n\n## 📊 架构概览\n\n```\nsrc\u002F\n├── commands\u002F               # 命令处理器\n│   ├── agents.ts          # 获取AI Agent列表\n│   ├── follow.ts          # 跟单命令（核心）\n│   ├── profit.ts          # 盈利统计分析\n│   ├── status.ts          # 系统状态检查\n│   └── telegram.ts        # Telegram通知命令\n├── services\u002F              # 核心服务\n│   ├── api-client.ts      # Nof1 API客户端\n│   ├── binance-service.ts # Binance API集成\n│   ├── trading-executor.ts # 交易执行引擎\n│   ├── position-manager.ts # 仓位管理\n│   ├── profit-calculator.ts # 盈利计算引擎\n│   ├── trade-history-service.ts # 交易历史服务\n│   ├── order-history-manager.ts # 订单历史管理\n│   ├── futures-capital-manager.ts # 合约资金管理\n│   └── telegram-service.ts # Telegram通知服务\n├── scripts\u002F\n│   └── analyze-api.ts     # API分析引擎（跟单策略）\n├── types\u002F                 # TypeScript类型定义\n├── utils\u002F                 # 工具函数\n└── index.ts               # CLI入口点\n```\n\n**核心流程**：\n```\n跟单流程：\n用户命令 → follow命令处理器 → ApiAnalyzer分析Agent信号\n         ↓\n    识别交易动作（开仓\u002F平仓\u002F换仓\u002F止盈止损）\n         ↓\n    生成FollowPlan → TradingExecutor执行\n         ↓\n    BinanceService → Binance API → 交易完成\n         ↓\n    TelegramService → Telegram通知（可选）\n\n盈利分析流程：\n用户命令 → profit命令处理器 → TradeHistoryService获取历史交易\n         ↓\n    ProfitCalculator计算盈利（基于realizedPnl和手续费）\n         ↓\n    生成统计报告（基础统计、分组统计、风险指标）\n         ↓\n    输出结果（表格\u002FJSON格式）\n```\n\n## ⚠️ 重要提示\n\n### 风险提示\n\n- **⚠️ 合约交易风险**: 合约交易使用杠杆，可能导致快速亏损，请谨慎使用\n- **🧪 测试环境**: 强烈建议先在 Binance Testnet 测试\n- **📊 风险管理**: 建议杠杆≤10x，使用专门的交易账户\n- **💡 风险控制模式**: 新手建议先使用`--risk-only`模式观察\n- **📈 跟单风险**: AI Agent的策略不保证盈利，请自行评估风险\n\n### 安全建议\n\n- 设置IP白名单限制访问\n- 定期更换API密钥\n- 不要在代码中硬编码密钥\n- 避免投入无法承受损失的资金\n\n## 🔍 故障排除\n\n### 常见问题\n\n**1. 合约交易权限不足**\n```\nError: Insufficient permissions\n```\n- ✅ 确保在Binance API管理页面启用了 **Enable Futures** 权限\n- ✅ 确保启用了 **Enable Reading** 权限\n- 重新创建API密钥并正确配置权限\n\n**2. Agent不存在**\n```\nError: Agent xxx not found\n```\n- 使用`npm start -- agents`查看可用Agent列表\n- 确认Agent名称拼写正确（区分大小写）\n\n**3. 网络连接问题**\n```\nError: timeout\n```\n- 检查网络连接和防火墙设置\n- 如果在中国大陆，可能需要使用VPN访问Binance API\n\n**4. API密钥错误**\n```\nError: Invalid API Key\n```\n- 检查`.env`文件中的API密钥是否正确\n- 确认API密钥没有过期\n- 验证是否复制了完整的密钥（没有多余空格）\n\n## 🔧 开发\n\n```bash\n# 运行测试\nnpm test\n\n# 开发模式（自动重启）\nnpm run dev\n\n# 构建\nnpm run build\n\n# 代码检查\nnpm run lint\n```\n\n## 📚 更多文档\n\n- **[详细跟单策略文档](.\u002Fdocs\u002Ffollow-strategy.md)** - 完整的跟单策略和风险评估\n- **[快速参考手册](.\u002Fdocs\u002Fquick-reference.md)** - 常用命令快速查询\n- **[自动重新跟单功能说明](.\u002Fdocs\u002Fauto-refollow-manual-close.md)** - 手工平仓检测和自动重新跟单详细说明\n- **[数据提供者抽象层](.\u002Fdocs\u002Fdata-provider-abstraction.md)** - 如何切换到其他数据源（当 nof1 API 停用时）\n\n## ⭐ Star History\n\n[![Star History Chart](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fterryso_nof1-tracker_readme_1eb9f995373f.png)](https:\u002F\u002Fwww.star-history.com\u002F#terryso\u002Fnof1-tracker&type=date&legend=top-left)\n\n## 📄 许可证\n\nMIT License - 查看 [LICENSE](LICENSE) 文件了解详情\n\n---\n\n**免责声明**: 本工具仅供学习和测试使用。实际交易存在资金损失风险，请谨慎使用并遵守相关法律法规。\n","# Nof1 AI Agent 跟单交易系统\n\n> 由于nof1.ai新一季是炒美股, 所以本脚本暂时没用了 \u003C\u002Fbr>\n> 如果想用自己的大模型来执行自动交易, 可以使用 https:\u002F\u002Fgithub.com\u002Fterryso\u002FLLM-trader-test 这个项目\n\n中文 | [English](.\u002FREADME_EN.md)\n\n![TypeScript](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Ftypescript-5.0%2B-blue)\n![Node.js](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fnode-%3E%3D18.0.0-green)\n![License](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-MIT-blue)\n\n一个用于跟踪 nof1.ai AI Agent 交易信号并自动执行 Binance 合约交易的命令行工具。支持7个AI量化Agent的实时跟单，自动识别开仓、平仓、换仓和止盈止损信号。\n\n[![ko-fi](https:\u002F\u002Fko-fi.com\u002Fimg\u002Fgithubbutton_sm.svg)](https:\u002F\u002Fko-fi.com\u002FF1F11HO935)\n\n\u003Cimg width=\"220\" height=\"286\" alt=\"b7c0054cf81fe6735d60ab5de48243e5\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fterryso_nof1-tracker_readme_09888277b53c.png\" \u002F>\n\n## 🏢 代部署服务\n\n**不想自己部署？我们提供代部署服务！**\n\n### 服务器部署的优势\n- 🖥️ **无需本地电脑运行** - 服务器24小时自动运行，无需保持自己的电脑开着\n- 🌍 **无需翻墙** - 推荐的服务器在国外环境，访问Binance API和nof1.ai更稳定\n- 🔋 **省心省力** - 专业配置，自动运行，无需担心环境配置和网络问题\n\n### 服务费用\n- 💰 **服务器成本低** - 一个服务器月租仅需40元人民币\n- 🛠️ **部署服务费面议** - 根据具体需求进行配置和部署\n\n### 联系方式\n📱 **有意者请加微信**: `gptkit`\n\n> 备注：代部署服务包含完整的环境配置、系统部署、运行测试和使用指导。\n\n## ⚡ 快速开始\n\n```bash\n# 1. 安装和构建\nnpm install && npm run build\n\n# 2. 配置环境变量\ncp .env.example .env\n# 编辑 .env 文件，填入 Binance API 密钥（必须启用合约交易权限）\n\n# 3. 查看可用的AI Agent\nnpm start -- agents\n\n# 4. 测试Telegram通知（可选）\nnpm start -- telegram-test\n\n# 5. 开始跟单（风险控制模式，不会真实交易）\nnpm start -- follow deepseek-chat-v3.1 --risk-only\n\n# 6. 持续监控跟单（每30秒检查一次）\nnpm start -- follow gpt-5 --interval 30\n\n# 7. 查看盈利统计\nnpm start -- profit\n```\n\n## 🚀 功能特性\n\n- **🤖 AI Agent跟单**: 支持7个AI量化交易Agent（GPT-5、Gemini、DeepSeek等）\n- **📊 实时监控**: 可配置轮询间隔，持续跟踪Agent交易动作\n- **🔄 智能跟单**: 自动识别开仓、平仓、换仓（OID变化）和止盈止损\n- **🎯 盈利目标退出**: 支持设置自定义盈利目标，达到后自动平仓退出\n- **🔄 自动重新跟单**: 可选的自动重新跟单功能，支持盈利退出和手工平仓后自动重新入场\n- **⚡ 合约交易**: 完整支持Binance USDT永续合约，支持1x-125x杠杆\n- **📈 盈利统计**: 精确的盈利分析，基于真实交易数据计算（含手续费统计）\n- **🛡️ 风险控制**: 支持`--risk-only`模式，只观察不执行交易\n\n## 📊 实盘跟踪\n\n**deepseek-chat-v3.1 Agent 实盘跟踪面板**: [https:\u002F\u002Fnof1-tracker-dashboard.onrender.com](https:\u002F\u002Fnof1-tracker-dashboard.onrender.com)\n\n实时查看 deepseek-chat-v3.1 AI Agent 的交易表现、持仓情况和盈亏统计。\n\nDashboard项目地址: https:\u002F\u002Fgithub.com\u002Fterryso\u002Fnof1-tracker-dashboard\n\n## 🤖 支持的AI Agent\n\n| Agent名称 |\n|----------|\n| **gpt-5** |\n| **gemini-2.5-pro** |\n| **deepseek-chat-v3.1** |\n| **claude-sonnet-4-5** |\n| **buynhold_btc** |\n| **grok-4** |\n| **qwen3-max** |\n\n\n## ⚙️ 配置\n\n### 1. Binance API 密钥配置（重要）\n\n本系统使用 **Binance 合约交易API**，必须正确配置权限：\n\n#### 创建API密钥\n1. 首先先注册一个币安帐号: https:\u002F\u002Fwww.maxweb.red\u002Freferral\u002Fearn-together\u002Frefer2earn-usdc\u002Fclaim?hl=zh-CN&ref=GRO_28502_ACBRJ&utm_source=default\n2. 登录 [Binance](https:\u002F\u002Fwww.binance.com\u002F) → [API Management](https:\u002F\u002Fwww.binance.com\u002Fen\u002Fmy\u002Fsettings\u002Fapi-management)\n3. 创建新API密钥，完成安全验证\n   \n\n#### 配置权限（关键）\n- ✅ **Enable Futures** - 启用合约交易（必选）\n- ✅ **Enable Reading** - 启用读取权限（必选）\n- ❌ **Enable Withdrawals** - 不需要提现权限\n\n#### 测试网环境（推荐新手）\n1. 访问 [Binance Testnet](https:\u002F\u002Ftestnet.binancefuture.com\u002F)\n2. 创建测试网API密钥\n3. 在`.env`中设置：\n   ```env\n   BINANCE_TESTNET=true\n   BINANCE_API_KEY=测试网API密钥\n   BINANCE_API_SECRET=测试网Secret密钥\n   ```\n\n### 2. 环境变量配置\n\n```env\n# Binance API Configuration - 必须支持合约交易\nBINANCE_API_KEY=your_binance_api_key_here\nBINANCE_API_SECRET=your_binance_api_secret_here\nBINANCE_TESTNET=true  # true=测试网, false=正式网\n\n# 其他配置选项\nLOG_LEVEL=INFO  # 日志级别\nTELEGRAM_API_TOKEN=  # Telegram Bot Token (可选)\nTELEGRAM_CHAT_ID=    # Telegram Chat ID (可选)\nTELEGRAM_ENABLED=false\n```\n\n## 📖 使用方法\n\n### 核心命令\n\n#### 1. 查看可用的AI Agent\n```bash\nnpm start -- agents\n```\n\n#### 2. Telegram通知配置（可选）\n\n如果您想在交易执行时收到Telegram通知，请按以下步骤配置：\n\n**创建Telegram Bot**：\n1. 在Telegram中搜索 `@BotFather`\n2. 发送 `\u002Fnewbot` 创建新机器人\n3. 按提示设置机器人名称和用户名\n4. 获取Bot Token（格式：`1234567890:ABCdefGHIjklMNOpqrsTUVwxyz`）\n\n**获取Chat ID**：\n1. 在Telegram中搜索 `@userinfobot`\n2. 发送任意消息获取您的Chat ID\n3. 或者发送消息给您的机器人，然后访问：`https:\u002F\u002Fapi.telegram.org\u002Fbot\u003CTOKEN>\u002FgetUpdates`\n\n**环境变量配置**：\n```bash\n# 在 .env 文件中添加\nTELEGRAM_BOT_TOKEN=1234567890:ABCdefGHIjklMNOpqrsTUVwxyz\nTELEGRAM_CHAT_ID=123456789\n```\n\n**测试Telegram通知**：\n```bash\nnpm start -- telegram-test\n```\n\n#### 3. 跟单AI Agent（核心功能）\n\n**基础用法**：\n```bash\n# 单次执行\nnpm start -- follow deepseek-chat-v3.1\n\n# 持续监控（每30秒轮询）\nnpm start -- follow gpt-5 --interval 30\n\n# 风险控制模式（只观察不执行）\nnpm start -- follow claude-sonnet-4-5 --risk-only\n```\n\n**高级选项**：\n```bash\n# 设置总保证金（默认10 USDT）\nnpm start -- follow gpt-5 --total-margin 5000\n\n# 设置每个币种固定保证金（固定金额分配模式）\nnpm start -- follow gpt-5 --fixed-amount-per-coin 100\n\n# 设置价格容差（默认1.0%）\nnpm start -- follow deepseek-chat-v3.1 --price-tolerance 1.0\n\n# 盈利目标退出（达到30%盈利时自动平仓）\nnpm start -- follow gpt-5 --profit 30\n\n# 盈利目标退出 + 自动重新跟单\nnpm start -- follow deepseek-chat-v3.1 --profit 30 --auto-refollow\n\n# 设置保证金模式（逐仓模式）\nnpm start -- follow gpt-5 --margin-type ISOLATED\n\n# 设置保证金模式（全仓模式，默认）\nnpm start -- follow deepseek-chat-v3.1 --margin-type CROSSED\n\n# 组合使用\nnpm start -- follow gpt-5 --interval 30 --total-margin 2000 --profit 25 --auto-refollow --margin-type ISOLATED\n\n# 固定金额分配模式组合使用\nnpm start -- follow gpt-5 --interval 30 --fixed-amount-per-coin 100 --profit 25 --auto-refollow\n```\n\n**命令选项说明**：\n- `-r, --risk-only`: 只评估不执行交易（安全模式）\n- `-i, --interval \u003Cseconds>`: 轮询间隔（秒），默认30秒\n- `-m, --total-margin \u003Camount>`: 总保证金（USDT），默认10\n- `--fixed-amount-per-coin \u003Camount>`: 每个币种固定保证金（USDT），固定金额分配模式\n- `--profit \u003Cpercentage>`: 盈利目标百分比，达到后自动平仓退出\n- `--auto-refollow`: 自动重新跟单，支持盈利退出和手工平仓后自动重新入场（默认关闭）\n- `--margin-type \u003Ctype>`: 保证金模式，ISOLATED（逐仓）或 CROSSED（全仓，默认）\n\n**资金分配模式说明**：\n\n1. **总保证金模式（默认）**: `--total-margin 5000`\n   - 将总保证金按比例分配给所有跟单的币种\n   - 适合分散投资，自动平衡各个仓位的资金分配\n\n2. **固定金额分配模式**: `--fixed-amount-per-coin 100`\n   - 为每个币种分配固定金额的保证金\n   - 资金不足时按优先级顺序分配，先到先得\n   - 严格控制每个仓位的最大风险\n\n⚠️ **注意**: `--total-margin` 和 `--fixed-amount-per-coin` 不能同时使用，只能选择一种分配模式。\n\n#### 4. 盈利统计分析\n```bash\n# 统计跟单开始以来的总盈利（默认包含浮动盈亏）\nnpm start -- profit\n\n# 统计指定时间范围的盈利\nnpm start -- profit --since 7d        # 最近7天\nnpm start -- profit --since 2024-01-01 # 从2024年1月1日开始\nnpm start -- profit --since 1704067200000 # 使用时间戳\n\n# 指定交易对统计\nnpm start -- profit --pair BTCUSDT\n\n# JSON格式输出\nnpm start -- profit --format json\n\n# 强制刷新缓存数据\nnpm start -- profit --refresh\n\n# 包含当前仓位的浮动盈亏（默认行为）\nnpm start -- profit\n\n# 仅显示当前仓位的浮动盈亏（不含已实现交易）\nnpm start -- profit --unrealized-only\n\n# 排除浮动盈亏（仅分析已实现交易）\nnpm start -- profit --exclude-unrealized\n```\n\n**profit命令选项说明**：\n- `-s, --since \u003Ctime>`: 时间筛选器，支持\"7d\"（最近7天）、\"2024-01-01\"（指定日期）、时间戳格式。不指定则使用order-history.json的创建时间\n- `-p, --pair \u003Csymbol>`: 指定交易对（如BTCUSDT）\n- `--group-by \u003Ctype>`: 分组方式：symbol（按交易对）或all（全部）\n- `--format \u003Ctype>`: 输出格式：table（表格）或json（JSON）\n- `--refresh`: 强制刷新缓存，获取最新数据\n- `--exclude-unrealized`: 排除当前仓位的浮动盈亏，仅分析已实现交易\n- `--unrealized-only`: 仅显示当前仓位的浮动盈亏\n\n**输出统计信息**：\n- **基础统计**: 总交易次数、已实现盈亏（扣除手续费）、胜率、平均盈利\u002F亏损\n- **浮动盈亏**: 当前仓位数量、总浮动盈亏、详细仓位信息（默认包含，使用--exclude-unrealized时排除）\n- **总盈亏**: 已实现盈亏 + 浮动盈亏的完整盈利情况\n- **手续费分析**: 总手续费支出、平均每笔手续费\n- **风险指标**: 最大单笔盈利、最大单笔亏损、浮动盈亏风险提示\n- **分组统计**: 按交易对分组的详细盈利情况\n\n#### 4. 系统状态检查\n```bash\nnpm start -- status\n```\n\n### 跟单策略说明\n\n系统自动识别4种交易信号：\n\n1. **📈 新开仓 (ENTER)** - Agent开新仓位时自动跟单\n2. **📉 平仓 (EXIT)** - Agent平仓时自动跟单\n3. **🔄 换仓 (OID变化)** - 检测到entry_oid变化时，先平旧仓再开新仓\n4. **🎯 止盈止损** - 价格达到profit_target或stop_loss时自动平仓\n\n### 🎯 盈利目标退出和自动重新跟单\n\n#### 盈利目标退出\n设置自定义盈利目标，当仓位达到指定盈利百分比时自动平仓退出：\n\n```bash\n# 当盈利达到30%时自动平仓\nnpm start -- follow gpt-5 --profit 30\n\n# 当盈利达到50%时自动平仓\nnpm start -- follow deepseek-chat-v3.1 --profit 50\n```\n\n**特点**：\n- ✅ 实时监控每个仓位的盈利百分比\n- ✅ 达到目标后立即执行市价平仓\n- ✅ 支持多头和空头仓位的盈利计算\n- ✅ 完整的盈利退出事件记录\n\n#### 自动重新跟单（增强版）\n`--auto-refollow` 选项现在支持两种自动重新跟单场景：\n\n**1. 盈利目标退出后重新跟单**：\n```bash\n# 盈利30%退出后，自动重新跟单\nnpm start -- follow gpt-5 --profit 30 --auto-refollow\n\n# 组合使用：持续监控 + 盈利目标 + 自动重新跟单\nnpm start -- follow deepseek-chat-v3.1 --interval 30 --profit 25 --auto-refollow\n```\n\n**2. 手工平仓后自动重新跟单（新功能）**：\n```bash\n# 启用手工平仓检测和自动重新跟单\nnpm start -- follow deepseek-chat-v3.1 --auto-refollow\n\n# 即使不设置盈利目标，也会检测手工平仓\nnpm start -- follow gpt-5 --interval 30 --auto-refollow\n```\n\n**手工平仓检测原理**：\n- 🔍 系统比对 NOF1 API 数据和币安实际仓位\n- 🔧 当 NOF1 显示有仓位但币安无仓位时，判定为手工平仓\n- 📝 自动记录手工平仓事件\n- 🔄 重置订单历史，允许重新跟单\n- ⏭️ 当 NOF1 再次开仓时，自动跟随\n\n**工作流程**：\n\n*盈利退出场景*：\n1. 🔍 检测到仓位盈利达到目标（如30%）\n2. 💰 立即执行市价平仓，锁定盈利\n3. 📝 记录盈利退出事件到历史\n4. 🔄 重置该symbol的订单处理状态\n5. ⏭️ 下个轮询周期检测到OID变化，自动重新跟单\n\n*手工平仓场景*：\n1. 👤 用户在币安 App 手工平仓\n2. 🔍 下次轮询时系统检测到仓位差异\n3. 📝 记录手工平仓事件到历史\n4. 🔄 重置该symbol的订单处理状态\n5. ⏭️ 当 NOF1 再次开仓时，自动跟随\n\n**安全特性**：\n- 🛡️ 重新跟单前进行价格容忍度检查\n- 📊 保留agent原始的止盈止损计划\n- 🔄 可选功能，默认关闭避免意外影响\n- 📝 完整的操作日志记录\n- 🔒 手工平仓检测仅在启用 `--auto-refollow` 时激活\n\n**使用场景**：\n- 🎯 **仅盈利退出**：`--profit 30` （达到30%盈利时平仓，不重新跟单）\n- 🔄 **盈利退出+重新跟单**：`--profit 30 --auto-refollow` （盈利退出后自动重新跟单）\n- 🔧 **手工平仓+重新跟单**：`--auto-refollow` （检测手工平仓并自动重新跟单）\n- 🚀 **完整自动化**：`--profit 30 --auto-refollow` （同时支持盈利退出和手工平仓的重新跟单）\n\n**使用建议**：\n- 🎯 保守策略：`--profit 20` （20%盈利退出，不重新跟单）\n- ⚖️ 平衡策略：`--profit 30 --auto-refollow` （30%盈利退出并重新跟单）\n- 🚀 积极策略：`--auto-refollow` （灵活手工干预，自动重新跟单）\n- 💎 专业策略：`--profit 50 --auto-refollow` （高盈利目标+手工平仓支持）\n\n### 使用示例\n\n**新手入门**：\n```bash\n# 1. 检查系统配置\nnpm start -- status\n\n# 2. 查看可用Agent\nnpm start -- agents\n\n# 3. 风险控制模式测试\nnpm start -- follow buynhold_btc --risk-only\n\n# 4. 单次跟单测试\nnpm start -- follow deepseek-chat-v3.1\n\n# 5. 查看盈利统计\nnpm start -- profit\n```\n\n**持续监控**：\n```bash\n# 每30秒检查一次\nnpm start -- follow gpt-5 --interval 30\n\n# 多Agent并行监控（不同终端）\nnpm start -- follow gpt-5 --interval 30\nnpm start -- follow deepseek-chat-v3.1 --interval 45\nnpm start -- follow claude-sonnet-4-5 --interval 60 --risk-only\n```\n\n**盈利分析**：\n```bash\n# 查看总盈利情况（默认包含浮动盈亏）\nnpm start -- profit\n\n# 仅查看已实现盈利（排除浮动盈亏）\nnpm start -- profit --exclude-unrealized\n\n# 仅查看当前仓位的浮动盈亏\nnpm start -- profit --unrealized-only\n\n# 按不同时间范围分析\nnpm start -- profit --since 1d      # 最近1天\nnpm start -- profit --since 7d      # 最近1周\nnpm start -- profit --since 30d     # 最近1月\n\n# 按交易对分析\nnpm start -- profit --pair BTCUSDT --since 7d\nnpm start -- profit --pair ETHUSDT --format json\n\n# JSON格式输出（默认包含浮动盈亏）\nnpm start -- profit --format json\n\n# 仅浮动盈亏的JSON格式输出\nnpm start -- profit --unrealized-only --format json\n```\n\n## 📊 架构概览\n\n```\nsrc\u002F\n├── commands\u002F               # 命令处理器\n│   ├── agents.ts          # 获取AI Agent列表\n│   ├── follow.ts          # 跟单命令（核心）\n│   ├── profit.ts          # 盈利统计分析\n│   ├── status.ts          # 系统状态检查\n│   └── telegram.ts        # Telegram通知命令\n├── services\u002F              # 核心服务\n│   ├── api-client.ts      # Nof1 API客户端\n│   ├── binance-service.ts # Binance API集成\n│   ├── trading-executor.ts # 交易执行引擎\n│   ├── position-manager.ts # 仓位管理\n│   ├── profit-calculator.ts # 盈利计算引擎\n│   ├── trade-history-service.ts # 交易历史服务\n│   ├── order-history-manager.ts # 订单历史管理\n│   ├── futures-capital-manager.ts # 合约资金管理\n│   └── telegram-service.ts # Telegram通知服务\n├── scripts\u002F\n│   └── analyze-api.ts     # API分析引擎（跟单策略）\n├── types\u002F                 # TypeScript类型定义\n├── utils\u002F                 # 工具函数\n└── index.ts               # CLI入口点\n```\n\n**核心流程**：\n```\n跟单流程：\n用户命令 → follow命令处理器 → ApiAnalyzer分析Agent信号\n         ↓\n    识别交易动作（开仓\u002F平仓\u002F换仓\u002F止盈止损）\n         ↓\n    生成FollowPlan → TradingExecutor执行\n         ↓\n    BinanceService → Binance API → 交易完成\n         ↓\n    TelegramService → Telegram通知（可选）\n\n盈利分析流程：\n用户命令 → profit命令处理器 → TradeHistoryService获取历史交易\n         ↓\n    ProfitCalculator计算盈利（基于realizedPnl和手续费）\n         ↓\n    生成统计报告（基础统计、分组统计、风险指标）\n         ↓\n    输出结果（表格\u002FJSON格式）\n```\n\n## ⚠️ 重要提示\n\n### 风险提示\n\n- **⚠️ 合约交易风险**: 合约交易使用杠杆，可能导致快速亏损，请谨慎使用\n- **🧪 测试环境**: 强烈建议先在 Binance Testnet 测试\n- **📊 风险管理**: 建议杠杆≤10x，使用专门的交易账户\n- **💡 风险控制模式**: 新手建议先使用`--risk-only`模式观察\n- **📈 跟单风险**: AI Agent的策略不保证盈利，请自行评估风险\n\n### 安全建议\n\n- 设置IP白名单限制访问\n- 定期更换API密钥\n- 不要在代码中硬编码密钥\n- 避免投入无法承受损失的资金\n\n## 🔍 故障排除\n\n### 常见问题\n\n**1. 合约交易权限不足**\n```\nError: Insufficient permissions\n```\n- ✅ 确保在Binance API管理页面启用了 **Enable Futures** 权限\n- ✅ 确保启用了 **Enable Reading** 权限\n- 重新创建API密钥并正确配置权限\n\n**2. Agent不存在**\n```\nError: Agent xxx not found\n```\n- 使用`npm start -- agents`查看可用Agent列表\n- 确认Agent名称拼写正确（区分大小写）\n\n**3. 网络连接问题**\n```\nError: timeout\n```\n- 检查网络连接和防火墙设置\n- 如果在中国大陆，可能需要使用VPN访问Binance API\n\n**4. API密钥错误**\n```\nError: Invalid API Key\n```\n- 检查`.env`文件中的API密钥是否正确\n- 确认API密钥没有过期\n- 验证是否复制了完整的密钥（没有多余空格）\n\n## 🔧 开发\n\n```bash\n# 运行测试\nnpm test\n\n# 开发模式（自动重启）\nnpm run dev\n\n# 构建\nnpm run build\n\n# 代码检查\nnpm run lint\n```\n\n## 📚 更多文档\n\n- **[详细跟单策略文档](.\u002Fdocs\u002Ffollow-strategy.md)** - 完整的跟单策略和风险评估\n- **[快速参考手册](.\u002Fdocs\u002Fquick-reference.md)** - 常用命令快速查询\n- **[自动重新跟单功能说明](.\u002Fdocs\u002Fauto-refollow-manual-close.md)** - 手工平仓检测和自动重新跟单详细说明\n- **[数据提供者抽象层](.\u002Fdocs\u002Fdata-provider-abstraction.md)** - 如何切换到其他数据源（当 nof1 API 停用时）\n\n## ⭐ Star History\n\n[![Star History Chart](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fterryso_nof1-tracker_readme_1eb9f995373f.png)](https:\u002F\u002Fwww.star-history.com\u002F#terryso\u002Fnof1-tracker&type=date&legend=top-left)\n\n## 📄 许可证\n\nMIT License - 查看 [LICENSE](LICENSE) 文件了解详情\n\n---\n\n**免责声明**: 本工具仅供学习和测试使用。实际交易存在资金损失风险，请谨慎使用并遵守相关法律法规。","# nof1-tracker 快速上手指南\n\nnof1-tracker 是一个命令行工具，用于跟踪 nof1.ai 的 AI 量化交易 Agent 信号，并自动在币安（Binance）合约市场执行跟单交易。\n\n> **⚠️ 重要提示**：由于 nof1.ai 新一季策略转向美股，本脚本针对加密货币合约的跟单功能目前可能无法获取有效信号。如需使用大模型进行自动交易，建议参考 [LLM-trader-test](https:\u002F\u002Fgithub.com\u002Fterryso\u002FLLM-trader-test) 项目。以下内容仅作为工具部署和技术参考。\n\n## 环境准备\n\n在开始之前，请确保您的开发环境满足以下要求：\n\n*   **Node.js**: 版本 >= 18.0.0\n*   **npm**: 随 Node.js 安装\n*   **币安账户**: 需要拥有币安账户，并开通 **合约交易（Futures）** 权限。\n*   **网络环境**: 访问 Binance API 和 nof1.ai 可能需要稳定的网络连接（中国大陆用户可能需要配置代理或使用海外服务器）。\n\n## 安装步骤\n\n### 1. 克隆项目与安装依赖\n\n打开终端，执行以下命令下载项目并安装依赖：\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fterryso\u002Fnof1-tracker.git\ncd nof1-tracker\nnpm install\nnpm run build\n```\n\n*(国内用户若 npm 安装缓慢，可临时切换镜像源：`npm config set registry https:\u002F\u002Fregistry.npmmirror.com`)*\n\n### 2. 配置环境变量\n\n复制示例配置文件并编辑：\n\n```bash\ncp .env.example .env\n```\n\n使用文本编辑器打开 `.env` 文件，填入您的币安 API 密钥：\n\n```env\n# Binance API Configuration\nBINANCE_API_KEY=你的 API_KEY\nBINANCE_API_SECRET=你的 API_SECRET\n\n# 运行环境设置\nBINANCE_TESTNET=true  # 新手强烈建议设为 true 使用测试网，实盘请改为 false\nLOG_LEVEL=INFO\n```\n\n**🔑 API 权限关键设置：**\n在币安官网创建 API 时，务必勾选以下权限：\n*   ✅ **Enable Futures** (启用合约交易) - **必须**\n*   ✅ **Enable Reading** (启用读取权限) - **必须**\n*   ❌ **Enable Withdrawals** (提现权限) - **严禁开启**\n\n## 基本使用\n\n### 1. 查看支持的 AI Agent\n\n首先确认当前可用的 AI 交易模型列表：\n\n```bash\nnpm start -- agents\n```\n\n### 2. 风险控制模式测试（推荐新手）\n\n在正式交易前，建议使用 `--risk-only` 模式运行。此模式会模拟跟单逻辑并输出日志，但**不会真实下单**。\n\n```bash\n# 跟踪 deepseek-chat-v3.1 模型，仅观察不交易\nnpm start -- follow deepseek-chat-v3.1 --risk-only\n```\n\n### 3. 启动自动跟单\n\n确认无误后，移除 `--risk-only` 参数开始真实跟单。以下示例为每 30 秒检查一次信号：\n\n```bash\n# 跟踪 gpt-5 模型，每 30 秒轮询一次\nnpm start -- follow gpt-5 --interval 30\n```\n\n**常用参数说明：**\n*   `--interval 30`: 设置轮询间隔为 30 秒。\n*   `--total-margin 100`: 设置总保证金为 100 USDT（默认分配给所有仓位）。\n*   `--profit 30`: 设置盈利目标，达到 30% 盈利时自动平仓。\n*   `--margin-type ISOLATED`: 使用逐仓模式（默认为全仓 CROSSED）。\n\n### 4. 查看盈利统计\n\n随时运行以下命令查看当前的交易盈亏情况（包含已实现盈亏和浮动盈亏）：\n\n```bash\nnpm start -- profit\n```","一位全职交易员希望利用 nof1.ai 上多个顶尖 AI Agent（如 GPT-5、DeepSeek）的量化策略进行币安合约跟单，以捕捉全天候的市场机会。\n\n### 没有 nof1-tracker 时\n- **人工盯盘效率低**：需要每隔几分钟手动刷新网页查看 7 个不同 AI 的信号，极易错过最佳开仓或平仓时机。\n- **执行延迟高风险大**：发现信号后需手动登录币安输入参数下单，在剧烈波动行情中，几秒的延迟可能导致滑点巨大甚至亏损。\n- **多策略管理混乱**：难以同时跟踪多个 Agent 的换仓和止盈止损动作，容易混淆持仓状态，导致操作失误。\n- **无法全天候运行**：受限于个人精力和本地网络稳定性，夜间或外出时无法持续监控，错失全球市场的夜间波动红利。\n- **数据统计缺失**：缺乏自动化的盈亏统计和手续费计算，难以客观评估各 AI Agent 的真实实战表现。\n\n### 使用 nof1-tracker 后\n- **自动化实时跟单**：配置一次后，工具每 30 秒自动轮询并识别开仓、平仓及换仓信号，实现毫秒级响应，彻底解放双眼。\n- **精准自动执行**：直接调用币安 API 自动完成合约交易，消除人为手误和延迟，确保严格按 AI 策略执行，支持 1x-125x 杠杆灵活配置。\n- **智能状态同步**：自动处理复杂的换仓（OID 变化）和止盈止损逻辑，清晰管理多 Agent 并行持仓，让多策略组合井井有条。\n- **服务器 24\u002F7 运行**：部署在海外服务器上，无需本地电脑开机或担心网络波动，真正实现无人值守的全天候自动交易。\n- **可视化盈利分析**：内置精确的盈利统计功能，自动扣除手续费计算净收益，并可结合 Telegram 实时推送通知，让每一笔盈亏都清晰可查。\n\nnof1-tracker 将繁琐的人工盯盘转化为高效的自动化流程，让交易者能真正低成本地复用顶尖 AI 的量化能力。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fterryso_nof1-tracker_960d7eb6.png","terryso","NEE","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fterryso_697ebfd7.png","Fullstack Dev、iOS Reverse Engineering、小红书逆向培训。",null,"China","oxtiger@gmail.com","suchuanyi","https:\u002F\u002Fgptkit.eth.limo\u002F","https:\u002F\u002Fgithub.com\u002Fterryso",[85,89],{"name":86,"color":87,"percentage":88},"TypeScript","#3178c6",99.2,{"name":90,"color":91,"percentage":92},"JavaScript","#f1e05a",0.8,747,204,"2026-04-12T12:45:19","MIT","Linux, macOS, Windows","不需要 GPU","未说明",{"notes":101,"python":102,"dependencies":103},"该项目是基于 Node.js 的命令行工具，非本地运行的大模型，无需配置显卡或下载模型文件。主要依赖 Binance API 和 nof1.ai 接口。使用前需配置 Binance 合约交易权限（Enable Futures），建议新手先在币安测试网（Testnet）环境运行。若在中国大陆使用，可能需要网络代理以稳定访问 Binance API。","不需要 Python",[104,105],"Node.js >= 18.0.0","TypeScript >= 5.0",[13,27],[108],"nof1","2026-03-27T02:49:30.150509","2026-04-20T10:24:16.101698",[112,117,122,127,132,137,142,147],{"id":113,"question_zh":114,"answer_zh":115,"source_url":116},44580,"项目启动时遇到 API Key 格式无效（API-key format invalid）错误怎么办？","这通常是因为配置错误或临时状态问题。请尝试以下步骤：\n1. 确认是否已正确设置环境变量 `BINANCE_TESTNET=true`（如果是测试网）。\n2. 检查 API Key 和 Secret 是否复制完整，没有多余空格。\n3. 如果确认配置无误但仍报错，尝试重新启动程序，许多用户反馈重启后问题自动解决。","https:\u002F\u002Fgithub.com\u002Fterryso\u002Fnof1-tracker\u002Fissues\u002F21",{"id":118,"question_zh":119,"answer_zh":120,"source_url":121},44581,"运行时报错\"Request failed: timeout of 10000ms exceeded\"或无法连接币安接口如何解决？","这通常是网络代理或账户权限问题，请按顺序排查：\n1. **配置代理**：如果在本地 Node.js 环境运行且需要梯子，需设置代理环境变量。例如 PowerShell 命令：\n   `$env:http_proxy = \"http:\u002F\u002F127.0.0.1:12334\"`\n   `$env:https_proxy = \"http:\u002F\u002F127.0.0.1:12334\"`\n   `$env:all_proxy = \"socks5:\u002F\u002F127.0.0.1:12334\"`\n2. **开启合约权限**：确保你的币安账户已开通合约账户并存入资金。在 API 管理页面中，必须勾选\"允许合约\"（Enable Futures）选项，否则接口会拒绝连接。","https:\u002F\u002Fgithub.com\u002Fterryso\u002Fnof1-tracker\u002Fissues\u002F34",{"id":123,"question_zh":124,"answer_zh":125,"source_url":126},44582,"提示\"This account is inactive\"或无法访问接口，但账号显示正常是什么原因？","这通常是由于币安对特定地区（如新加坡）的合约交易限制导致的。即使账号状态正常，如果服务器节点位于受限地区，也会报此错误。\n**解决方案**：更换服务器节点地区，建议使用中国香港或其他支持合约交易的地区节点重新部署或运行。","https:\u002F\u002Fgithub.com\u002Fterryso\u002Fnof1-tracker\u002Fissues\u002F13",{"id":128,"question_zh":129,"answer_zh":130,"source_url":131},44583,"为什么检测到的仓位数量比实际少（例如有 6 个仓位只出现 3 个买单）？","这通常是因为本地缓存的历史订单数据（order-history.json）与当前网络状态不一致导致的（例如之前在测试网运行过，切换到正式网后数据冲突）。\n**解决方案**：删除项目目录下的 `data\u002Forder-history.json` 文件（或直接删除整个 `data` 目录），然后重新启动脚本，程序会重新同步所有仓位数据。","https:\u002F\u002Fgithub.com\u002Fterryso\u002Fnof1-tracker\u002Fissues\u002F15",{"id":133,"question_zh":134,"answer_zh":135,"source_url":136},44584,"日志显示\"Risk assessment: FAILED - Trade skipped\"且提示价格差异超过容忍度怎么办？","这是因为当前市场价格与 Agent 开仓时的价格差异超过了设定的容忍度（默认通常为 1%），为了防止滑点过大，程序自动跳过了该笔交易。\n**解决方案**：如果你希望强行跟单，可以在启动参数中提高价格容忍度（Tolerance），例如增加相关配置参数以允许更大的价差范围。","https:\u002F\u002Fgithub.com\u002Fterryso\u002Fnof1-tracker\u002Fissues\u002F14",{"id":138,"question_zh":139,"answer_zh":140,"source_url":141},44585,"修改参数后重新启动项目，是否需要手动在币安清仓或删除数据？","视情况而定：\n1. **仅调整普通参数**（如跟随策略微调）：可以直接关闭程序并重新启动，无需额外操作。\n2. **调整投入资金**（如修改保证金 `-m` 参数）：建议执行以下操作以确保数据一致：\n   - 手动在币安 APP 或网页端平掉所有持仓。\n   - 删除本地 `data` 目录下的所有文件。\n   - 使用新参数重新启动脚本。","https:\u002F\u002Fgithub.com\u002Fterryso\u002Fnof1-tracker\u002Fissues\u002F38",{"id":143,"question_zh":144,"answer_zh":145,"source_url":146},44586,"如何手动一键平仓止盈？是否必须等到达到设定的利润目标（如 25%）？","目前主要依赖自动化的利润目标触发平仓。如果你想提前止盈，可以采用“变相”方法：\n重新运行脚本，并将利润目标参数（`--profit`）设置为低于当前已实现收益率的值。例如，当前收益为 6%，你可以运行 `--profit 5`，程序检测到当前收益已超过新设定的目标，从而触发平仓逻辑。","https:\u002F\u002Fgithub.com\u002Fterryso\u002Fnof1-tracker\u002Fissues\u002F35",{"id":148,"question_zh":149,"answer_zh":150,"source_url":151},44587,"nof1.ai 的数据更新是否有 1 小时的延迟？","不是每小时更新一次。接口返回的数据是实时变化的。\n日志中的 `lastHourlyMarker` 参数仅用于分页，表示获取该时间点之后的数据，并不代表数据本身有 1 小时的延迟。每次请求接口都会获取最新的账户和仓位信息。","https:\u002F\u002Fgithub.com\u002Fterryso\u002Fnof1-tracker\u002Fissues\u002F8",[]]