快速开始
按需求选一个梯度即可，三个梯度层层递进、互不冲突。完全不会命令行的 Windows 用户见 Windows 安装。
环境要求
| 组件 | 要求 | 说明 |
|---|---|---|
| Python | >= 3.12 | 配合 uv 管理依赖 |
| Node.js + npm | 较新的 LTS | 仅前端开发时需要 |
| 主数据库 | 默认 SQLite | 零外部依赖 |
| 行情仓库 | 默认 SQLite，可选 TimescaleDB | 全市场同步 / 重度 5m 历史建议切 TimescaleDB |
| LLM API key | 自备 | DeepSeek / Kimi / 通义 / Anthropic / LM Studio 等 |
| 操作系统 | macOS / Linux / Windows | QMT 实盘链路必须跑在 Windows |
梯度零：一条命令装完即用（推荐）
macOS / Linux：
curl -fsSL https://raw.githubusercontent.com/renjiegod/doyoutrade/main/install.sh | sh
中国网络访问 GitHub 不稳定时，优先用 Gitee 镜像（或设 DOYOUTRADE_MIRROR=gitee）：
curl -fsSL https://gitee.com/renjie-god/doyoutrade/raw/main/install.sh | sh
# 等价强制镜像：
DOYOUTRADE_MIRROR=gitee sh install.sh
安装脚本在未指定 DOYOUTRADE_INSTALL_SOURCE 时会短超时探测 GitHub；不通则自动改用 Gitee。也可用 DOYOUTRADE_MIRROR=github|gitee 强制一侧。
Windows（PowerShell）：
irm https://raw.githubusercontent.com/renjiegod/doyoutrade/main/install.ps1 | iex
Gitee：
irm https://gitee.com/renjie-god/doyoutrade/raw/main/install.ps1 | iex
想先审阅再执行：
irm https://raw.githubusercontent.com/renjiegod/doyoutrade/main/install.ps1 -OutFile install.ps1
irm https://raw.githubusercontent.com/renjiegod/doyoutrade/main/install-win.ps1 -OutFile install-win.ps1
powershell -NoProfile -ExecutionPolicy Bypass -File install-win.ps1
请用 install-win.ps1 做 -File 入口，不要直接 -File install.ps1。
install.ps1 必须保持「UTF-8 无 BOM」才能让 irm | iex 正常工作；中文 Windows 上的 Windows PowerShell 5.1 用 -File 读无 BOM 脚本时会按系统 ANSI（GBK）解码并 ParserError。install-win.ps1 是纯 ASCII 包装，会把 install.ps1 转成带 BOM 的临时副本再执行。
装完后在终端运行：
doyoutrade
doyoutrade 默认按操作系统选择启动内容：
- Windows →
--mode both（同进程起 DoYouTrade:8000 + 内置 qmt-proxy:8001） - macOS / Linux →
--mode doyoutrade（只跑本体）
可用 --mode {both,doyoutrade,qmt-proxy} 或环境变量 DOYOUTRADE_LAUNCH_MODE 覆盖。
首次启动会：自动执行数据库迁移（默认 SQLite）→ 进入安装向导（选大模型供应商 + API Key）→ 启动服务。浏览器打开 http://localhost:8000 即是完整控制台（前端与 API 同源）。
- 已配置过模型则向导自动跳过。
- 非交互启动（后台 / Docker / CI）不会被向导阻塞。
- 升级：
uv tool upgrade doyoutrade；卸载：uv tool uninstall doyoutrade。
已装 uv、想跳过脚本：uvx --from git+https://github.com/renjiegod/doyoutrade doyoutrade（即跑即用，不持久安装）。
梯度一：克隆源码本地开发
想改代码 / 跑测试 / 开发前端时走这条。除了一个 LLM API key，不需要任何数据库服务、行情源 token、券商账户或 Windows。
git clone https://github.com/renjiegod/doyoutrade.git
# 中国网络也可：git clone https://gitee.com/renjie-god/doyoutrade.git
cd doyoutrade
make install # = uv sync --extra doc-processing + npm --prefix frontend ci
（可选）性能升级：全市场同步或重度 5m 历史时，建议 PostgreSQL + TimescaleDB：
docker run -d --name doyoutrade-timescaledb \
-e POSTGRES_USER=doyoutrade -e POSTGRES_PASSWORD=doyoutrade -e POSTGRES_DB=doyoutrade \
-p 5432:5432 timescale/timescaledb:latest-pg16
在仓库根写 config.yaml（与默认配置深合并）：
market_data:
database_url: postgresql+asyncpg://doyoutrade:doyoutrade@localhost:5432/doyoutrade
启动：
uv run doyoutrade # API server，默认 0.0.0.0:8000
make frontend # 另开终端：Vite，http://localhost:5173
配置 LLM：打开 http://localhost:5173/settings/models，新建 Provider → Route → 在 Agents 页绑定默认智能体。
跑通第一个回测：见 一次典型对话。
mock 数据源生成确定性合成行情，不代表真实市场；模拟盘走内存撮合，不触碰真实资金。
梯度二：免费真实行情
auto 链天然落在免 token 的 baostock / akshare：
uv run doyoutrade-cli data run 600519.SH --period 3m
uv run doyoutrade-cli stock lookup 茅台
回测把 --data-provider 留成 auto（或显式 akshare）即可。有 Tushare Pro token 时设 TUSHARE_TOKEN 即自动纳入降级链。
能力边界：以日线为主；无实盘账户 / 持仓 / 下单。实时行情与实盘见 QMT 实盘链路。
下一步
- Windows 安装 — 图形安装包与双击脚本
- QMT 实盘链路 — 实时行情 / 真实下单
- 你能用它做什么
- CLI 参考