Getting Started: install → configure → run → read logs

入门教程：安装 → 配置 → 拉起 bot → 看日志。英文为主，每节末尾附中文要点。

1. Install ｜ 安装

1. Download the Windows installer from the home page and verify the file size.
2. Right-click the installer → Run as administrator.
3. Follow the first-run wizard. If your antivirus blocks it, whitelist the installer temporarily.

中文要点：下载安装包 → 管理员身份运行 → 按首次运行向导操作； 杀软拦截时先临时加白。安装失败请收集 %LOCALAPPDATA%\VigilDesk\logs 日志。

2. Configure ｜ 配置

1. Point VigilDesk at your MetaTrader 5 terminal (terminal64.exe) — standard path is C:\Program Files\MetaTrader 5\; broker-branded installs live in their own folder.
2. Pick your AI backend: the bundled local model, a mirror, or your own OpenAI-compatible endpoint (llama-server / ollama) on 127.0.0.1:8080.
3. Set your risk limits: per-trade loss cap and daily drawdown limit.
4. Set trading.symbol to your broker's exact symbol id (e.g. XAUUSDm on Exness).

中文要点：配置四件事——MT5 终端路径、AI 推理端点、风控限额 （单笔亏损上限 / 日内回撤上限）、券商品种代码。全部可回改：设置里随时调整。

3. Run ｜ 拉起 bot

1. First run in dry-run mode: orders are simulated, so you can smoke-test the whole chain without risking money.
2. When dry-run looks right, switch to live guarding. VigilDesk reviews your strategy's orders with the AI confirmer before they go out.
3. Free Watchdog Lite users: start the supervisor with VigilDesk.exe lite (no license, no account, no card) — it keeps the process alive, auto-restarts after crashes, and writes basic alerts. It can also guard any command: VigilDesk.exe lite -- "your command here"
4. Leave it running unattended? Use the same supervisor approach on your VPS — restart cooldown and exponential backoff prevent restart storms.

中文要点：先 dry-run 空跑验证链路，再切实盘守护；免费版用 watchdog-lite 守护进程（崩溃自动拉起 + 基础告警），也可守护任意命令行程序。

4. Read the logs ｜ 看日志

• Bot and guard logs: %LOCALAPPDATA%\VigilDesk\logs (e.g. bot.log, watchdog.log, watchdog_lite.log).
• Decision logs: every AI confirmer decision is recorded with its reason — open the dashboard to review why an order passed or was held.
• Alerts: JSON lines in watchdog_lite.log; optional webhook delivers them to your own endpoint (3s timeout, failures are silent).

中文要点：日志集中在 %LOCALAPPDATA%\VigilDesk\logs； AI 每笔决策都有留痕及理由，可在 dashboard 复盘；告警为 JSON 行，可接自有 webhook。