# 使用文档（gold_monitor）

## 1. 登录网页

浏览器打开：`http://<服务器IP>:5800`  
或在已激活的 exe 上点 **打开复盘**，会用浏览器打开登录页。

默认管理员：`admin` / `admin123`（部署后请立即修改）。  
普通用户由管理员在 **用户** 页创建，**一人绑定一个交易账户**，不可自助注册账户。

### 角色说明

| 角色 | 权限 |
|------|------|
| **管理员** | 创建账户、创建用户、看全部复盘、给任意账户发激活码、管理机器 |
| **普通用户** | 只看自己账户的复盘与下载中心；可为**自己的账户**发放激活码；改自己的登录密码 |

顶栏：

- **总览** / **交易复盘**：按角色过滤数据  
- **下载中心**：下载通用 exe + 生成激活码（用户和管理员都可发）  
- **账户 / 用户 / 机器**：管理员可见；普通用户仅「我的账户」  
- **系统设置**：修改当前登录用户密码  

### 修改用户名 / 密码

1. 登录后打开 **系统设置**  
2. 可改 **用户名**；改密码则填写新密码（至少 6 位，不改留空）  
3. 须填写 **当前密码** 验证 → 保存  
4. 下次用新用户名/密码登录  

> 初始管理员来自部署 `.env`（默认 `admin` / `admin123`）；改过后以系统设置为准。  
> 早期版本会种子创建 1 个示例交易账户「模拟盘-主」；现已不再自动创建。重复项可在账户页删除。

## 2. 管理员：建账户与用户

1. **账户** 页新增交易账户（模拟/美分/实盘），禁止用户自助注册  
2. **用户** 页创建普通用户，并绑定**唯一、尚未占用**的账户  
3. 把登录账号发给该操作员  

## 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. 需要复盘时点 exe 上的 **打开复盘**，浏览器登录网页账号即可  
4. 客户端在成交或平仓时自动上报（接口见技术文档）  
5. 持仓旁可勾选 **自动保本**：价格有利走出 ≥3$ 后，自动把止损拉到开仓价 ±1$（与手动「保本」同一规则；勾选状态保存在本机）  

## 4.1 企业微信推送（管理员）

1. 企业微信群 → 添加群机器人 → 复制 Webhook  
2. 网页 **系统设置** → 填写 Webhook → 勾选启用 → 保存  
3. 可用「发送测试消息」「立即推送今日日报」验证  
4. 生效后：客户端上报的 **开仓 / 平仓** 即时推送；北京时间 **23:00** 自动推送各账户日报（交易次数、已平盈亏、胜率）  
5. 也可在服务器 `.env` 写 `WECOM_WEBHOOK_URL=...`（设置页保存的地址优先）  

## 5. 网页复盘

1. 打开 **交易复盘**（普通用户只看到自己账户的成交）  
2. 点某笔 **打开复盘**  
3. 查看成交信息与 **M1 / M5 / M15 / H1** 四图  
4. 选择 **入场形式** 并填写备注 → 保存  

> K 线依赖客户端上报缓存。若四图为空，请确认 exe 已上报 bars。

## 6. 推荐练手流程

1. 管理员建美分/模拟账户，并创建对应用户  
2. 用户登录 → 下载中心为自己账户生成激活码 → 本机激活  
3. 按纪律交易，自动上报  
4. 每日网页复盘（exe「打开复盘」或浏览器）