WucaiTrade-hk - 港美交易助手
================================

使用方法:
  1. 双击 start.bat 启动
  2. 浏览器自动打开 http://127.0.0.1:5589
  3. 首次启动会弹"用户协议与免责声明", 仔细阅读并勾选确认
  4. 用账号登录
  5. 登录后即可对话 AI / 看行情 / 写策略 / 跑回测

启动参数 (高级用户):
  WucaiTrade-hk.exe --port 5589             指定端口 (默认 5589)
  WucaiTrade-hk.exe --no-browser            启动不自动开浏览器
  WucaiTrade-hk.exe --no-agent              不启动 deepagents AI 后端 (排查端口冲突时用)

AI 对话:
  AI 对话走云端 LLM 网关, 不需要本地配 key, 登录后直接聊.

持仓同步:
  本机 IB Gateway 只读同步持仓, 实盘只提醒不下单.
  本地数据: %USERPROFILE%\.wucai-trade-hk\users\<id>\
  - live/  实盘数据 (持仓 / 路由 / 计划)
  - sim/   模拟盘数据
  - agents/deepagents/  AI 对话历史 (jsonl)

常见问题:
  Q: 启动报"端口 5589 被占用"
  A: 上次进程没退干净, 重启电脑或在任务管理器里结束 WucaiTrade-hk.exe

  Q: 浏览器打开 127.0.0.1:5589 是空白页, F12 控制台报 ERR_ADDRESS_IN_USE
  A: Windows 临时端口被占满了 (常见于装了 Hyper-V/Docker/WSL2).
     双击同目录"修复网络问题.bat", 按提示同意管理员权限. 修复后关浏览器重开.
     还不行就重启电脑.

  Q: 登录提示"网络错误"
  A: 客户端默认连香港 AWS 5011, 检查网络 / 防火墙

  Q: AI 对话一直转圈不出字
  A: 一般是云端 LLM 网关偶发抖动, 等 1 分钟重试

  Q: 数据存在哪? 怎么备份?
  A: 全在 %USERPROFILE%\.wucai-trade-hk\, 整个目录拷走就是备份
