feat: scaffold gold_monitor web hub, API, PM2 deploy and docs

2026-10-17 17:43:17 +08:00
commit fb35968a1f
35 changed files with 2080 additions and 0 deletions
@@ -0,0 +1,58 @@
+# 使用文档（gold_monitor）
+
+## 1. 登录网页
+
+浏览器打开：`http://<服务器IP>:5800`  
+默认：`admin` / `admin123`（部署后请修改）。
+
+顶栏：
+
+- **总览**：账户/机器数量、最近成交  
+- **交易复盘**：列表与详情  
+- **下载中心**：通用 exe + 激活码  
+- **账户 / 机器**：标注管理  
+
+## 2. 标注账户与机器
+
+### 账户
+
+「账户」页新增：名称、券商、登录号、类型（模拟/美分/实盘）、备注。  
+用于激活码绑定与复盘归属。
+
+### 机器
+
+可预登记机器名称与备注；也可不登记，**激活时自动创建**并写入设备指纹。
+
+## 3. 下载通用包并首次激活
+
+1. 打开 **下载中心**  
+2. 选择要绑定的 **账户**（可选预绑定机器）→ **生成激活码**  
+3. 下载 `黄金市价辅助.exe`（需管理员已放入 `releases/`）  
+4. 在 Windows 上启动 exe：  
+   - 填写服务器地址，例如 `http://192.168.1.10:5800`  
+   - 输入激活码  
+   - 成功后本地保存 token（后续请求带 `X-Device-Token`）  
+
+同一通用包可装多台机器；**每台使用各自的激活码**。
+
+## 4. 日常交易
+
+1. 先登录本机 MT5  
+2. 打开已激活的辅助 exe 下单 / 保本 / 平仓  
+3. 客户端在成交或平仓时自动上报（接口见技术文档）  
+
+## 5. 网页复盘
+
+1. 打开 **交易复盘**  
+2. 点某笔 **打开复盘**  
+3. 查看成交信息与 **M1 / M5 / M15 / H1** 四图  
+4. 选择 **入场形式**（如「M15关键位+M1强吞没」）并填写备注 → 保存  
+
+> K 线依赖客户端上报缓存。若四图为空，请确认 exe 已上报 bars，或稍后在客户端补传。
+
+## 6. 推荐练手流程
+
+1. 美分/模拟账户在「账户」中建好并标注  
+2. 每台电脑生成激活码并激活  
+3. 按纪律交易，自动上报  
+4. 每日网页复盘：标注亏单共性（位不对 / 形不对 / 违纪）