gold_monitor/docs/usage.md

使用文档（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「打开复盘」或浏览器）