期货实时监测系统

版权所有 © 天津创锐丰科技有限公司 | 作者：黄军雷 | 官网：www.crf.net.cn

一句话启动本地期货监测仪表盘——覆盖 6 大交易所、90+ 主力合约、零外部依赖。

工作流程

用户请求 → 部署模板文件 → 启动 Python 服务 → 打开浏览器

步骤 1：部署模板文件

将 assets/server.py 和 assets/index.html 复制到工作目录：

{workspace}/futures-monitor/
├── server.py          # 后端服务（从 assets/server.py 复制）
└── static/
    └── index.html     # 前端仪表盘（从 assets/index.html 复制到 static/）

具体操作：

1. 在工作目录下创建 futures-monitor/static/ 目录
2. 将 assets/server.py 复制为 futures-monitor/server.py
3. 将 assets/index.html 复制为 futures-monitor/static/index.html

步骤 2：启动服务

cd {workspace}/futures-monitor
python server.py

服务默认在 http://127.0.0.1:8765 启动，会自动打开浏览器。

可选参数：

• -p 9000 — 自定义端口
• --no-browser — 不自动打开浏览器

步骤 3：确认启动

启动后向用户报告：

• 本机访问地址
• 跟踪品种数量（90+）
• 可用功能：市场概览、涨跌排行、品种详情（日线/分钟线/持仓/仓单/结算/预警/盈亏）

系统功能

技术说明

• 后端：纯 Python 标准库（http.server），无需 pip install
• 前端：HTML/CSS/JS + ECharts 5.5 交互图表，深色主题
• 数据源：通过 WorkBuddy finance-data API 获取
• 性能：LRU 缓存（1000 条上限）+ ThreadPoolExecutor（10 并发）+ 指数退避重试（3 次）
• 图表：ECharts K 线图（candlestick + 成交量 + 持仓线）、分时图（折线 + 标记线），支持 tooltip、缩放、legend
• 快捷键：R 刷新、Esc 关闭弹窗

启动参数

• -p 9000 — 自定义端口
• --no-browser — 不自动打开浏览器
• --workers 10 — 并发线程数（默认 10）
• --cache-size 1000 — 缓存上限（默认 1000）

API 端点

Resources

assets/

• server.py — 后端服务模板（复制到目标目录即可运行）
• index.html — 前端仪表盘模板（需放入 static/ 子目录）

变更日志

v2.1.0（2026-04-12）

新增功能：

• 🔔 价格预警：支持涨破/跌破两种预警类型，触发时弹窗+Toast通知，自动持久化到 alert_rules.json，支持暂停/恢复/删除
• 💰 盈亏计算：选择品种→填入开仓价，自动拉取当前价，一键计算盈亏/收益率/保证金占用，支持"我的持仓"本地保存
• 📊 持仓排名汇总：新增多头大户合计/空头合计/总成交量三个汇总卡片，便于快速判断多空力量对比
• ⏱ 分钟线自动加载：打开品种详情后切换到分钟线 tab，自动加载 5 分钟 K 线，无需手动触发

API 新增：

• GET /api/alerts — 获取全部预警规则
• GET /api/alerts/check — 检查预警触发状态
• POST /api/alerts/add — 新增预警规则
• POST /api/alerts/delete — 删除预警规则
• POST /api/alerts/toggle — 启用/禁用预警规则
• POST /api/pnl — 盈亏计算

v2.0.0（2026-04-09）

• 初始版本，覆盖 6 大期货交易所 90+ 主力合约
• 市场概览、行情表格、涨跌排行
• 品种详情：30天日线、分钟分时图
• 持仓排名、仓单数据、结算参数
• 自动刷新（30秒/1分钟/5分钟）