feat: settings password change, migrate desktop client with hub activation/report

This commit is contained in:
dekun
2026-10-17 17:50:42 +08:00
parent fb35968a1f
commit 1d4d5b06df
14 changed files with 1933 additions and 26 deletions
+23 -22
View File
@@ -1,31 +1,32 @@
# desktop · MT5 黄金辅助客户端
## 定位
## 功能
- **通用包**:所有机器下载同一个 exe(由网页「下载中心」分发)。
- **首次激活**:启动后输入网页生成的激活码,调用 `POST /api/v1/activate`,本地保存 `token`。
- **运行期**:本机连接已登录的 MT5;成交/快照 `POST /api/v1/trades`;可选上报 K 线 `POST /api/v1/bars`。
- 连接本机已登录 MT5,市价开平、ATR 止损止盈、保本、满仓灰显等(由原 `MT5黄金方案/Desktop` 迁入)
- **通用包 + 首次激活**:启动时填写中控地址与激活码
- **自动上报**:开仓/平仓成功后 `POST /api/v1/trades`,并上传 M1/M5/M15/H1 K 线供网页复盘
## 与现有代码
## 本地配置
当前可从 `E:\仓库\MT5黄金方案\Desktop\gold_order_app.py` 迁移下单逻辑。
本目录后续接入:
激活信息保存在:`%USERPROFILE%\.gold_monitor\device.json`
1. 激活窗 / 本地 `device.json`(token、account_id、machine_id、server)
2. 配置服务器地址(默认 `http://<ubuntu>:5800`)
3. 成交与四周期 bars 上报
## 开发运行
## 激活 API 示例
```http
POST /api/v1/activate
Content-Type: application/json
{
"code": "激活码",
"fingerprint": "机器唯一指纹",
"machine_name": "书房PC"
}
```bat
cd desktop
py -3 gold_order_app.py
```
成功后请求头携带:`X-Device-Token: <token>`
需本机已安装 `MetaTrader5`、`numpy`,并打开登录 MT5。
## 打包
```bat
build_exe.bat
```
产物:`dist\黄金市价辅助.exe`,复制到仓库 `releases\黄金市价辅助.exe` 后由网页下载中心分发。
## 离线模式
激活窗可点「离线使用」:正常下单,但不上报复盘中心。