FinHub 信号跟单客户端
连接服务器的信号源，在本机按信号方向下单。 分组 / 档口 / 倍数全部本地计算，服务器只发信号—— 你看到的就是你实际执行的口径，服务器不参与你的档位推进。 按成交股数计费：1 股 = 1 额度，没成交不扣。
一、系统要求
- Windows 10 / 11（64 位）
- 无需安装任何环境——Python、pip、依赖全部已内置在 EXE 里
- 能访问 api.wanminguo.top（国内网络直连即可，客户端自带隧道）
二、快速开始（3 步）
- 下载上面的 EXE，放到任意目录（例如 D:\finhub-client）
- 双击 FinHubClient.exe 启动（首次会提示防火墙，点「允许访问」； 命令行窗口是程序日志，别关它）
- 浏览器打开 http://127.0.0.1:8787 进入本机面板
面板默认端口 8787，可用 --port 8788 参数换端口 （快捷方式里加在 exe 路径后面）。
三、界面功能说明
3.1 多配置折叠卡片（顶部）
一个配置 = 一个市场 = 一把 KEY = 一个钱包。可以点「＋ 新增配置」建 N 个配置， 每个配置独立保存 / 启动 / 关闭。各字段：
| 字段 | 说明 |
|---|---|
| 配置名 | 给自己看的名字，例如「BTC 实盘」「ETH 模拟」 |
| 信号 API KEY | 在平台 用户中心订阅策略后领到的 pm_live_… 钥匙。一个 KEY 对应一个市场； 填错市场会提示 KEY 不匹配 |
| 市场 | BTC / ETH / SOL / XRP / DOGE / BNB / HYPE 的 5 分钟涨跌盘 |
| 模式 | 模拟盘（paper，不花真钱、不回传计费） / 实盘（live，真下单） |
| 倍数 | ×1 / ×2 / ×5 / ×10，作用于档口股数：第 1 档 ×1 = 1 股，第 15 档 ×10 = 6330 股 |
| 钱包私钥 | Polymarket 钱包私钥，只在本机保存，绝不发往服务器（实盘必填） |
| 钱包地址 | Polymarket 地址 / Funder，用于查余额 |
| 交易 API | 可选；与钱包配套的 Polymarket API |
| API Token ID / Secret | 钱包的 API 凭证（L2 签名用），实盘下单需要 |
| 策略 | 当前默认「低位回中 · 马丁阶梯」。客户端只读信号， 分组 / 档口 / 倍数由本机计算，不读取服务器的档位 |
每张卡片底部四个按钮：保存并应用（存到本机 config.json 并设为激活）、 启动此配置（用这张卡运行）、关闭程序（只停引擎、不下单不连信号， 面板端口保持开启）、重置分组/档口（清掉本市场的分组档口，从第 1 组第 1 档重新开始）。
3.2 连接池表格
一行一个配置，一眼看清：配置 / 运行市场 / 模式 / 账号剩余额度(股) / PM 余额 / 份数倍数 / 下单次数 / 成交(股) / 盈亏 / 状态。 配置多了之后，谁在跑、谁赚谁亏，这里最直观。 额度是账号用户池：KEY 不单独设限，任一 KEY 下单都从账号总额度扣。
3.3 市场统计
按市场聚合：订单数 · 胜率 · 累计盈亏（绿涨红跌）。 以后加 15 分钟 / 1 小时市场，这里自动按市场分卡片。
3.4 最近信号 · 回执 · 本地下单台账
每次下单自动落盘到本机 ~/.finhub/orders.jsonl，倒序显示最近 100 条： 时间 / 配置 / 市场 / 方向 / 份数(档口×倍数) / 成交(股) / 档口 / 均价 / 扣次 / 状态 / 信号 / 盈亏。 窗口结算后自动补上这笔的 win / pnl（待结算显示灰字）。
四、计费规则
- 按成交股数计费：成交 1 股扣 1 额度，633 股 = 633 额度
- 单笔额度 = 档口股数 × 倍数；倍数越大越难在盘口吃满，实际成交多少算多少
- 模拟盘回执不扣额度；没成交不扣额度
- 单个 KEY 本身没有额度概念，额度按账号名下所有 KEY 的成交汇总扣减， 可在用户中心看进度条与每日柱状图
- 余额不足会提示充值（额度 ≠ 钱包 USDC：额度是平台信号计费， USDC 是你在 Polymarket 下单用的真钱）
五、安全说明
- 钱包私钥 / Token Secret 只保存在你本机，客户端不会把它发到服务器
- 出网走本机 127.0.0.1 白名单隧道（TLS 端到端），不是通用代理
- 实盘前请确认：信号方向、钱包 USDC 余额、限价与滑点都符合你的预期
- 建议先跑模拟盘熟悉流程，再切实盘