币安交易机器人

数据库更新（强烈建议使用 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

截至当前 Stage 7-1～7-4 代码，数据库要求 Schema v19；真实 MySQL 8 的版本与旧 Main 数据无损回归尚未验证，不能以本地 Mock/SQLite 测试代替。

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

功能

实时推送

dingding, slack, 网页 websocket 通知

• 钉钉

• slack

• 网页 websocket 通知

自定义交易策略

ai 生成策略

说明

UI 可在 合约交易 → 策略模板 中维护技术指标和策略方法，再到 合约交易 → 合约交易 为币种应用模板或直接维护策略配置。合约币种固定使用自定义策略，不再提供 global / line_x / custom 策略类型选择，也不再存在全局交易策略。

自定义详情

免责申明

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

功能

Web UI

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

合约带单（Lead 账户，Stage 6 / Stage 7-1～7-4）

当前交付状态：管理界面和独立账户基础设施已完成代码与 Mock/Race 验证；真实 Lead Portfolio、MySQL 8 Schema v19、私有 WS、Algo 条件单和资金交易尚未完成真实环境 Gate。Lead 实盘执行仍锁定。 这不是普通 AI 受控交易，也不是复制跟随者成交的保证。

访问 合约交易 → 合约带单（/futures/lead）。页面采用六个 Card：

系统看板新增只读 Lead 状态摘要、WS 状态、五分钟 REST 请求/权重和进入带单页面的入口。告警队列未接入运行时显示 — 而非 0。页面约每 15 秒刷新本地状态；不会因查看管理页面而启动 Binance 真实订单。

Lead 独立环境配置

Lead 的密钥、风控设置、审计日志不写入 conf/app.conf 或前端代码。运行进程需要从受保护的环境/密钥管理器取得以下变量（示例仅为占位符，不要复制真实 Secret 到 README、Git、日志或 shell history）：

BINANCE_LEAD_CREDENTIAL_KEY=<standard-base64-of-32-random-bytes>
BINANCE_LEAD_CREDENTIAL_FILE=/private/lead/credentials.enc
BINANCE_LEAD_CONFIG_FILE=/private/lead/risk.json
BINANCE_LEAD_AUDIT_FILE=/private/lead/operations.jsonl
# 默认不配置 BINANCE_LEAD_OBSERVER_MODE

• BINANCE_LEAD_CREDENTIAL_KEY 必须是32 个随机字节的标准 Base64 编码，由运维人员安全生成并长期保存。丢失或更换主密钥会导致旧加密凭证无法解密。
• 三个文件路径均须为仓库外的绝对路径；父目录需由部署用户控制，权限建议 0700，目标文件为 0600，不允许符号链接。应用不会隐式创建私有目录或生成主密钥。
• 配好上述环境并部署新版后端后，再通过 UI 保存 Lead 专用凭证、查看只读验证结果和保存独立风险限额。未配置存储时，凭证/配置保存会安全拒绝，不应修改 app.conf 来绕过检查。
• 应在备份、停机并确认目标数据库版本/数据后，才由人工单独执行 ./go_binance_futures sync db。当前代码要求 Schema v19；离线 SQLite/Mock PASS 不能证明实际 MySQL 8 已完成迁移。

只读观察器：明确选择才会连接真实 Binance

默认不设置 BINANCE_LEAD_OBSERVER_MODE，Lead 私有观察器不会读取其凭证或建立私有 WS。完成独立密钥配置、Schema 检查并明确准备做真实只读联调后，才可在运行进程的安全环境中设置：

BINANCE_LEAD_OBSERVER_MODE=read_only

这不是纯本地模拟：开启后新进程真的会向 Binance 请求/续期/关闭 Lead listenKey、建立 User Data 私有 WebSocket，并读取真实账户、持仓及挂单快照，因此要求有效的 Lead Key、权限、网络和代理。它只读检查 Ownership、更新内存镜像；不提交/撤销订单，不修改 managed 成交账本，不解除真实交易门禁。不要将 Testnet 的成功直接当成真实 Lead Portfolio 资格证明。

关闭观察器需从部署环境移除该变量并重启/停止对应进程；凭证轮换会停止旧观察器。观察器当前没有网页上的启停开关，也不自动证明真实 Portfolio 身份。可以通过已鉴权的 GET /futures/lead/status、GET /futures/lead/metrics 查看 read_only_observer、WS generation、镜像健康、审计检查及实际观测到的 REST 数据。

安全手动验收与尚未开放的能力

1. 先核对部署版本和数据库：前端 dist 同步 static 只更新网页资源；新 /futures/lead/* 接口和 Stage 7 只读观察器还必须部署新二进制。不要以旧服务仍在监听端口来推断升级完成。
2. 只做管理/权限测试：打开六个 Card、切换中英、刷新；无 JWT 应拒绝 Lead API；合法 JWT 下仍应显示 enabled=false、allow_new_opens=false。保存风控后检查持久状态；跨账户、非法值及尝试开启交易应拒绝。
3. 暂停测试放在最后：POST /futures/lead/pause 会先设置当前进程单向内存停止标志，再尽力写入配置与审计；成功持久化返回 HTTP 200，未能持久化返回 HTTP 202 和 pause_persisted=false，此时重启/跨进程不保证暂停。没有网页恢复按钮。
4. 只读连接单独验收：仅获准时才配置 read_only 并重启新版后端；检查 WS/快照健康、异常订单的只读巡检、账户归属与 Binance Portfolio 官方页面数据的一致性。所有只读状态均不得显示 live_trade_authorized=true。
5. 真实交易保持禁止：/start、未经权威确认的 /reconcile 和不安全的凭证删除均返回 HTTP 423（若审计/存储未配置，也可能先返回安全的不可用错误）。STOP/TP Algo、动态价格过滤器、部分成交/手工减仓、跨进程重启恢复、双账户真实每 2 秒 API 负载和最小额真实开平仓必须另行完成 Gate 7-5/7-6，并取得人工明确授权。

实现方案和剩余风险见 合约自动带单 Stage 实施方案；各阶段实施/代码审计记录位于 doc/trade/。本功能仅供单用户自用研究和运维，不应以离线测试结果宣称已可实盘带单。

UI 页面截图

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

配置中心

AI - 单币分析

AI - 任务中心

AI - Skill 管理

AI - 模型配置

合约交易

合约订单

合约账户

本地合约账户

策略模板

测试结果

现货提醒

合约提醒

现货监听

合约监听

资金费率监听

抢新配置

通知配置

系统配置

日志

AI 功能

对话

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

单币分析

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

机会

AI → 机会 是 V3-6 Opportunity Watch 的用户入口。系统可以从 FastMove、强平 Signal、MarketEvent/Binance Announcement 和定时 market_scan 主动发现候选，并在去重/冷却后调用现有 symbol_analysis 生成完整 TradingPlanV1。机会默认 60 分钟过期，同一 Symbol + 同类来源默认 30 分钟内只分析一次。

• Opportunity Watch 默认关闭，可在 AI → AI 配置 开启，并配置 Market Scan 周期和最低 Confidence。
• neutral、partial、data_missing、failed 或已过期机会只能查看，不能创建真实交易 Proposal。
• 满足条件的机会可以由用户点击“创建受控交易”，但后续仍固定经过现有 Risk、人工批准和 V3-5 Ownership-safe Execution；Opportunity 本身没有 Binance Submit 路径。
• 打开机会详情可查看原 symbol_analysis 的完整分析，也可跳转单币分析重新分析；完整 AI 结果继续保存在 Agent Task，不复制到 Opportunity 表。

模型配置

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_experime