币安交易机器人

数据库更新（强烈建议使用 MySQL，本项目数据查询较频繁，SQLite 在数据量较大时会有明显延迟）

数据库结构更新已经从正常启动流程中拆分为独立命令。配置好 conf/app.conf 的数据库连接后，执行：

./go_binance_futures sync db

该命令会按当前程序版本完成以下操作：

1. 根据已注册的 Model 同步数据库 Schema，创建缺失的表和字段。
2. 全新数据库会初始化 config、默认策略模板等基础数据。
3. 根据数据库中的版本号执行 command/sql/version/*.sql 版本迁移。
4. 更新数据库版本号并输出同步过程日志。
5. 同步完成后立即退出，不会启动 Web、WebSocket、Scheduler、交易或 Agent 服务。

建议在以下场景执行 sync db：

• 首次部署：配置数据库后，先执行 ./go_binance_futures sync db，成功后再正常启动程序。
• 升级程序版本：替换为新版本二进制后，在启动新版本前执行一次 ./go_binance_futures sync db。
• 恢复或迁移数据库：复制旧 SQLite 数据库、恢复 MySQL/PostgreSQL 备份或切换数据库后，先执行该命令确认 Schema 和版本迁移完成。
• 日志提示数据库版本过旧或未初始化：停止服务并执行该命令，成功后再重新启动。

正常运行：

./go_binance_futures

正常启动不会再自动执行数据库 Schema 或版本迁移。如果数据库尚未初始化，或数据库版本低于当前二进制要求，程序会提示先运行 go_binance_futures sync db。生产环境升级时建议先备份数据库，并在服务停止状态下执行同步命令。

功能

实时推送

dingding, slack, 网页 websocket 通知

• 钉钉

• slack

• 网页 websocket 通知

自定义交易策略

ai 生成策略

说明

UI 可在 合约交易 → 策略模板 中维护技术指标和策略方法，再到 合约交易 → 合约交易 为单个币种选择全局策略或自定义策略。

自定义详情

免责申明

！！！本项目不构成任何投资建议，投资者应独立决策并自行承担风险！！！

功能

Web UI

访问 http://<服务器 IP>:<web.port>/zmkm/index.html，登录后通过左侧菜单进入各功能页。登录账号和密码来自 conf/app.conf 的 web.username、web.password。

UI 页面截图

截图使用当前UI。涉及账户、订单、配置密钥和日志正文的页面只展示安全区域。

配置中心

AI - 单币分析

AI - 任务中心

AI - Skill 管理

AI - 模型配置

合约交易

合约订单

合约账户

本地合约账户

策略模板

测试结果

现货提醒

合约提醒

现货监听

合约监听

资金费率监听

抢新配置

通知配置

系统配置

日志

AI 功能

对话

AI → 对话 是统一的人机交互入口。可显式选择允许在对话使用的 Skill；当使用单币分析时，输入框旁可直接从系统真实合约列表选择 Symbol，发送请求时后端优先使用该 Symbol，因此中文币名、别名或其它自然语言不会再导致币种识别错误。未选择 Symbol 时仍可进行普通对话，只有明确的续问语义才会复用上一轮币种。

单币分析

从真实 USDT 永续合约列表选择一个 Symbol，并可补充希望 AI 重点判断的方向。系统启动 symbol_analysis Skill，读取行情、市场环境和最近一次成功分析，输出结构化 TradingPlan。历史列表展示分析状态、方向、置信度、市场环境、当时价格、当前价格、后续涨跌和总结。

模型配置

LLM 配置保存在数据库中。页面支持 Provider 模板、自定义 Provider、配置名称、API 地址、API Key、模型名称、请求超时和 Temperature，支持连接测试和切换当前模型。Agent 新任务直接读取当前配置，无需重启服务；API Key 不会由接口回传明文。

Skill 管理

Skill 注册与治理配置保存在数据库中。Native 与 Portable Skill 分为两个 Tab，支持搜索、分页、新增、编辑、启停、删除，并提供独立的 对话可用 开关。enabled 控制 Skill 能否运行，chat_enabled 只控制是否出现在对话入口，两者互不替代。Portable Skill 的 allowed-tools 只是权限申请，不能自行获得高风险或交易权限。

MCP 管理

系统可以作为 MCP Client 连接第三方标准 HTTP MCP Server，并将远端 Tool、Resource、Prompt 纳入统一 Runtime、Permission、Trace 与 Context。支持连接测试、Catalog 刷新、认证/OAuth 和按 Skill 授权。外部 MCP 中识别出的真实交易能力会被强制归类为高风险交易能力并保持禁用，不能绕过本项目的受控执行链路。

Memory 管理

长期 Memory 与 Conversation/Task 分离持久化。页面可查看内容、来源、Scope、TTL、状态和更新时间，用于长期上下文维护；Memory 不会获得额外 Tool 或交易权限。

业务 Workflow

业务 Workflow 复用现有 Agent Runtime，不创建第二套 Agent。当前包括：

• market_scan：确定性 Scanner 先筛选候选，再由 Agent 分析少量币种并输出机会集合。
• strategy_review：结合策略模板、已有测试结果、手续费后收益和当前市场环境进行复盘，只提出建议，不直接修改正式模板。
• strategy_experiment：Agent 提议候选策略，系统做确定性表达式校验和固定场景测试，再由 Agent 总结；实验结果不会覆盖正式策略。
• alert_triage：AI 开启时可把同一币种短时间内的多个相关 Signal 归并为 Incident，降低重复通知；AI 关闭或失败时保持确定性 fallback。
• daily_market_brief：聚合市场环境、Scanner 和重要 Signal，生成固定结构的市场摘要；Scheduler 默认关闭。

受控交易

受控交易不是“让 LLM 直接下单”。真实执行固定经过：

成功的 symbol_analysis → Trade Proposal → 确定性 Risk Engine → 人工批准 → 执行前再次 Risk → Execution Service → Binance → Audit。

• 默认真实 AI 执行关闭，允许交易的 Symbol 白名单默认为空。
• Proposal 只能从成功的结构化单币分析创建；LLM 不决定最终 quantity。
• Risk Engine 检查白名单、方向、当前 MarketCondition 及漂移、价格 freshness、Entry Zone、Stop Loss、滑点、已有仓位/挂单、重复订单、cooldown、杠杆、单笔风险、名义金额、总 Exposure 和 Kill Switch。
• 最终 quantity 根据最大风险、止损距离、最大名义金额和交易对 StepSize 计算。
• 即使已经人工批准，真实执行前仍会重新运行 Risk；Broker 提交前还会再次检查 Kill Switch。
• 使用唯一 client_order_id 保证幂等。网络结果不确定时不会自动重复下单，只允许按 client_order_id 对账。
• 所有 Proposal、Risk、批准/拒绝、执行和对账动作都会写入审计。
• 当前受控执行提交的是开仓 MARKET 订单；TradingPlan 中的止盈/止损用于 Risk 与审批依据，暂不会自动创建 Binance 保护性止盈/止损单。

AI 配置

所有 AI 相关运行配置集中在 AI → AI 配置，包括：

• AI 报警 Pipeline、AI 分析开关、最小严重级别、cooldown、并发与每分钟上限。
• 市场环境自动更新和每日市场摘要 Scheduler。
• Agent 每分钟/每小时启动额度、全局 Token 与 Tool 调用预算。
• 受控交易 Kill Switch、Symbol 白名单、最大单笔风险、最大名义金额、总 Exposure、最大杠杆、价格 freshness、滑点、cooldown 和 Proposal TTL。

这些 AI 配置已从“配置中心”迁出；配置中心 只保留非 AI 的交易、行情监听、提醒和系统运行配置。

任务中心与可观测性

• 任务中心：查看 Agent 治理状态、Runtime 直接交易权限与受控执行开关、Scheduler、Task 历史、模型和 Token 等运行信息。
• 可观测性：查看长期 Trace、各 Skill/模型/Tool 指标、错误率、延迟、Token 和变更记录。
• 报警链路历史：查看 Signal 从 Event Bus、Signal Engine、AI 分析/归并到 Notification 或 fallback 的完整处理历史。

合约交易

合约交易 → 合约交易 页面支持每个币种独立配置策略类型、技术指标、策略方法、保证金模式、USDT、杠杆、止盈率、止损率和启用状态。

开启方法

1. 在 配置中心 → 合约交易 打开合约交易总开关和 WebSocket。
2. 根据需要打开 允许做多、允许做空，设置全局策略、持仓限制和下单类型。
3. 进入 合约交易 → 合约交易，确认目标币种的参数和 启用 状态。

注意事项

1. 目标币种的平仓策略会在配置的 止盈率(%) 或 止损率(%) 超过之后才会进行
2. 目标币种配置的策略，会覆盖全局策略
3. 目标币种的 USDT 值得时合约的 保证金

配置项说明

快速波动通知

快速波动通知可配置阈值、恢复阈值、冷却时间和监控窗口。Signal 的 AI 分析、归并、通知和 fallback 记录可在 AI → 报警链路历史 查询。

仓位收益正负转换通知

当某个仓位的收益在正负之间转换时发送通知。仓位或启用币种较多时会增加 API 请求量，请谨慎开启。

允许做多 和 允许做空

这是方向总开关。关闭后，即使策略满足开仓条件，也不会按对应方向自动开仓。

交易策略 和 选币策略

当币种的 策略类型 为全局时，使用配置中心选择的交易策略和选币策略；自定义类型使用币种自身配置。

最大持仓数量

自动化持仓达到限制后不再自动开仓，即使策略满足条件。

最大持仓亏损数量

亏损仓位达到限制后不再自动开仓。自动缩放最大持仓亏损数量 可根据连续盈亏调整限制。

市场趋势

可手动选择市场趋势，也可打开 市场趋势自动更新，供策略判断使用。

排除自动交易的币

在下拉框中选择的币种不会参与自动交易。已有手动仓位但不希望程序自动平仓时，务必加入排除列表。

自动下单类型

LIMIT 为限价挂单，MARKET 为市价单。页面会根据选择显示对应模式。

合约自定义策略的模拟盘测试（无回测功能）

开启方法

在 配置中心 → 合约交易 打开 WebSocket 和 测试策略。模拟交易遵循真实自动交易的策略和限制，但不会操作真实合约账户。结果可通过配置中心的 查看测试结果 按钮，或左侧 合约交易 → 测试结果 查看。

测试自动转换次数限制 非 0 时，连续盈利达到次数后可切换到真实交易；真实交易连续亏损达到次数后切回测试策略。

合约订单与账户

• 合约交易 → 合约订单：查看自动交易订单历史。收益根据下单信息估算，可能与币安实际收益略有差异。
• 合约交易 → 合约账户：查看币安返回的资产、持仓和当前挂单。
• 合约交易 → 本地合约账户：查看程序本地记录，可用于对照本地状态与交易所状态。

策略模板

在 合约交易 → 策略模板 新增或维护模板。模板由技术指标和策略方法组成，可供合约币种和监听策略复用。详细语法请参考 自定义策略说明。

新币抢购

• 币币抢买
• 币币挖矿抢卖
• 合约抢买做多
• 合约抢买做空

先在 配置中心 → 抢新配置 打开对应总开关，再到左侧 抢新配置 页面新增币种规则。

币种通知

现货通知

• 达到预设价格报警通知
• 自动买入或卖出

合约通知

• 达到预设价格报警通知
• 可配置自动交易、保证金模式、USDT、杠杆、止盈价和止损价

先在 配置中心 → 币种提醒 打开总开关，再到 币种提醒 → 现货提醒 或 合约提醒 维护规则。

行情监听

现货监听

• K 线变化监听
• 可配置阈值、通知间隔和启用状态

合约监听

• K 线与技术指标监听
• 自定义策略

先在 配置中心 → 市场监听 打开总开关，再到 市场监听 → 现货监听 或 合约监听 新增规则。

资金费率

• 资金费率查询和历史记录
• 资金费率变化监听

先在 配置中心 → 资金费率监听 打开总开关，再到左侧 资金费率监听 页面查询和配置。

系统设置

• 配置中心：调整保存在数据库中的非 AI 交易、监听、提醒等运行参数和功能开关。
• AI → AI 配置：集中调整 AI 报警、Scheduler、Agent 全局预算和受控交易 Risk Policy。
• 系统配置：在线编辑 conf/app.conf。点击 保存 后，启动期配置仍需点击 重启服务 或手动重启程序才能生效。
• 日志：查看 web.commend_log 配置的命令输出。

系统配置 页面包含 API 密钥、数据库密码和通知令牌等敏感信息，请勿截图、复制到 Issue 或提交到 Git。

使用注意事项

• 网络必须处于大陆之外(因为币安接口大陆正常无法访问), 已添加币安 api 的代理配置(websocket 因为使用组件问题，暂无代理配置， websocket 只是用于后台更新合约币种最新价格)，如果有可用代理也可以正常使用
• 申请api_key地址: 币安API管理页面
• 如果账号已有合约仓位，请在 配置中心 → 合约交易 → 排除自动交易的币 下拉框中选择不希望程序管理的币种，否则程序可能按策略自动平仓
• !!!注意修改app.conf配置后必须重新启动程序，否则配置不会生效!!!
• 请保证账户有足够的 USDT，否则下单会报错
• 钉钉推送 1min 中内不要超过 20 条，否则会被封 ip 一段时间，无法推送成功
• 调整过大的参数(例如同一个 ip 下使用多种组合功能)可能会造成币安 api 请求频率超出限制，会禁用一段时间 ip

如何使用

在 https://github.com/sorry510/go_binance_futures/releases 页面下载最新对应操作系统的发布版解压后配置运行或者使用golang自行编译

常见问题（UI）

1. 登录后从哪里开启自动交易？ 进入 配置中心 → 合约交易，依次检查合约交易总开关、WebSocket、允许做多/允许做空；再到 合约交易 → 合约交易 检查目标币种是否启用。
2. 在哪里查看模拟交易？ 打开 配置中心 → 合约交易 → 测试策略，通过 查看测试结果 按钮或 合约交易 → 测试结果 查看。
3. 修改配置后为什么没有生效？ 配置中心的运行参数通过页面更新；系统配置 编辑的是 conf/app.conf，点击 保存 后，启动期配置仍需重启程序。
4. **合约页面价格为什