BlitzkriegBot

独立交易者的 TradingOS

市场可以变化，策略可以迭代，你的交易内核永远稳定可靠。

用 Rust 重构散户高频交易基础设施：策略开发、风控执行、多市场扩展全面统一。

Build Once, Trade Everywhere. 让个人拥有机构级交易能力。

开始模拟 · 创建第一条策略 · 查看验证范围

从节点连线到 Lua 策略包，让交易逻辑看得见、改得动。

默认 dry 模拟，策略安装后默认关闭。实盘涉及真实资金风险，需要充分验证与明确授权；本项目不构成投资建议。

目前建议优先考虑的实盘策略是 late_favorite（只做 BTC，结算前 45–120 秒 taker 买入 0.80–0.90 的一边并持有到结算）。未看过的 2026-09-26 至 09-30 窗口：351 笔，胜率 97.72%，盈亏比 6.74，净利 +382.40 美元，最大回撤 15.67 美元。这是回放，不是实盘承诺。DRY_RUN 默认 true。说明见 docs/late-favorite.md。

TradingOS 的分层

策略层可换，内核不变。

层	是什么	换掉它意味着什么
策略包（Blueprint / Lua）	把交易想法写成可运行的规则	迭代想法：改 Lua、调参数、换策略，内核零改动
市场扩展（Polymarket / Kalshi / predict.fun / PolySimulator）	一个场地一个扩展 crate，接 market_api 契约	迁移市场：写一个扩展 crate，内核不改一行
交易内核（Rust）	OME 订单引擎 · 风控 · 持仓 · 结算 · 对账	永远稳定可靠：市场无关、无交易所 SDK、dry/live 同一本账

市场可以变化 ──────────────► 换扩展 crate
策略可以迭代 ──────────────► 换 Lua 策略包
交易内核 ──────────────────► 永远稳定可靠（Build Once, Trade Everywhere）

从一个想法开始

创建策略 → 回测评估 → 模拟运行 → 满足验证与授权条件后实盘

你要做什么	在 BlitzkriegBot 中怎么做
把想法写成规则	在 Blueprint 连接数据源、条件与动作；需要更灵活的逻辑时编写 Lua。
检查策略是否值得继续	用支持的回放与回测入口评估历史表现，核对费用、回撤和成交假设。
观察它如何运行	在 dry 模式按账户启用，查看订单、持仓、账本与拒单原因。
决定是否进入实盘	对照功能证据与场地限制完成验证，再明确授权；模拟盈利不是实盘收益保证。

Blueprint：先搭出你的第一条策略

打开蓝图页，从节点面板选择输入、条件、守卫逻辑和动作，连接成一条规则：

数据源 / 常量 → 条件比较 → 且 / 或组合 → 买入 / 卖出 / 持有

1. 搭逻辑：拖入节点、连接端口，在属性面板调整参数。
2. 检查输出：查看生成的 Lua 与编译结果；编译通过说明代码可加载，不代表策略有效。
3. 保存并试跑：保存为策略包，在策略页选择账户，在 dry 模式启用并观察结果。

蓝图支持 JSON 导入与导出。手写 Lua 包也可以用源码模式打开，继续编辑。

一套策略包，逐步验证

Build Once：同一个策略包跨回放、模拟、实盘三个入口复用，改想法不用维护三套实现。核心账务路径有 dry/live 对拍门禁，验证范围见 功能证据表。

复用代码，不等于复现市场。 实盘仍受流动性、滑点、费用、网络延迟和场地规则影响；离线测试、dry 实况与部分真实下单验证分别说明不同范围，不能替代完整的实盘验收。

Lua：从现有示例改起

不必先学习 Rust。一个带 manifest.json 的目录就是策略包，官方 Lua 示例 提供配对、动量、做市等逻辑，方便阅读和修改。

• 改策略：编辑 Lua 与参数声明，由策略宿主加载。
• 管参数：声明可调参数域后，通过面板调整；支持的参数可用于影子进化。
• 控执行：内嵌沙箱限制内存与指令预算，帮助限制失控脚本的影响。

示例是研究起点，是否启用应由验证结果决定。

Risk First：机构级风控，个人可拥有

• 订单先过风控：持仓数、单笔名义额等限制由内核强制执行，策略不能自行豁免——策略再失控，也超不出你定的边界。
• 默认先模拟：出厂 dry，策略安装不等于启用，按账户分别控制。
• 异常可追踪：无法归属的成交与现金异动进入告警和审计，便于核对账本。
• 可以只观察：--readonly 结构性只读，连下单通道都不构造——个人也有 fail-safe。

从面板看到策略实际做了什么

Web 面板提供行情、订单、持仓、账本和策略管理；TUI 支持终端查看与操作。账户切换帮助你分别观察不同策略与场地的执行情况——机构级的审计视野，个人也能拥有。

行情页展示倒计时与盘口深度。截图中的账户未绑定提示属于配置状态，使用前需完成账户与场地绑定。

Trade Everywhere：一个内核，四个市场

Polymarket、Kalshi、predict.fun、PolySimulator 连接器各自验证范围见 功能证据表；换交易所 = 写一个扩展 crate，内核不改一行。技术细节在 开发者文档。

交易核心与服务进程使用 Rust，策略宿主内嵌 Lua，Web 面板使用 Vue。运行预编译发行包无需另装 Node 或 Python；开发与构建依赖见下方文档。

开始模拟

路线 A：运行预编译发行包

到 Releases 下载对应平台（Linux x86_64 / macOS aarch64）的 tar.gz，解压后：

cd <解压目录>
cp .env.example .env
# 编辑 .env，填入 BLITZKRIEG_PANEL_USER 与 BLITZKRIEG_PANEL_PASSWORD（不出厂默认凭证）
bin/blitzkrieg run

浏览器打开 http://127.0.0.1:51888/panel 并用 .env 里的凭证登录。先核对运行模式为 dry，再在面板配置账户与风控（写入 SQLite data/blitzkrieg.sqlite）；启用前不会自动运行策略。

路线 B：源码构建（开发者）

git clone https://github.com/ceer-quant/BlitzkriegBot.git
cd BlitzkriegBot && cargo build --release --workspace --locked
(cd ui/webapp/webui && npm ci && npm run build)   # 必需：Vue 面板产物 dist 不入库
bash scripts/install-blitzkrieg-shim.sh          # 可选：把 blitzkrieg 装进 PATH
blitzkrieg run

下一步：创建或选择策略，确认账户绑定及 dry 模式，再按账户启用。

1. 管理员 PowerShell 执行 wsl --install，重启（老机器先确认 wsl -l -v 的 VERSION 是 2）。
2. Ubuntu 里装工具链：

   sudo apt update && sudo apt install -y build-essential pkg-config libssl-dev git curl
   curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
   source "$HOME/.cargo/env"
   

3. 代码必须放在 WSL 文件系统里（~ 下），不要放 /mnt/c/...（9P 跨盘 I/O 慢一个数量级）：

   git clone https://github.com/ceer-quant/BlitzkriegBot.git && cd BlitzkriegBot
   cargo build --release --workspace --locked && bash scripts/install-blitzkrieg-shim.sh && blitzkrieg run
   

4. Windows 浏览器直接打开 http://127.0.0.1:51888/panel（WSL2 localhost 自动转发，wsl hostname -I 的内部 IP 不用）。

三个 WSL 特有坑：wsl --shutdown 或最后一个 WSL 进程退出约 8 秒后会杀掉机器人（长跑保持 Ubuntu 窗口开着，或用 Windows 任务计划执行 wsl -e bash -lc "cd ~/BlitzkriegBot && blitzkrieg run"）；重启电脑后需手动 blitzkrieg run；数据在 \\wsl$\Ubuntu\home\<用户名>\BlitzkriegBot\data\ 可从 Windows 直接备份。内存紧张可在 %UserProfile%\.wslconfig 写 [wsl2] + memory=4GB。

安全默认与红线

• dry 出厂默认；唯一碰真钱的开关是 DRY_RUN=false / --mode live，且需真人明确授权——项目硬性规则。
• --readonly 结构性只读：压过一切 live 请求，连下单通道都不构造。
• 策略出厂全关：内核 0 个启用策略；装包只是「已安装」，启用真值是「账户 × 策略」复合键。
• 密钥只走环境变量或数据库：.env 被 git 忽略，绝不入库；账户凭证以 AES-256-GCM 密文存入 SQLite（主密钥 BLITZKRIEG_DB_KEY 放 .env，缺失 = 解密拒绝、绝不静默明文回退）；安全问题走 SECURITY.md 私下披露。
• 数据与你自己的判断归你：本项目按「现状」提供，不构成投资建议，不对任何损失负责。

FAQ

Q：我要装 Node.js 吗？ 运行预编译发行包不需要。前端开发与构建需要 Node 和相应 npm 依赖；交易核心使用 Rust，Lua 运行时内嵌在策略宿主中。

Q：面板打不开？ 先 blitzkrieg stop 再 blitzkrieg run（端口被旧栈占着时新栈绑不上）；地址是 http://127.0.0.1:51888/panel。源码克隆若从没跑过前端构建（cd ui/webapp/webui && npm ci && npm run build），面板其实打得开，但会退化成内置 HTML 面板（旧版界面）——浏览器里看不到 /panel/assets/*.js 就是这个原因，补跑构建再 blitzkrieg stop && blitzkrieg run 即可。

Q：策略装了为什么不动？ 三道门：包在 user_layer/strategies_lua/（安装）→ 面板策略页按账户打开开关（启用）→ 请求了策略但一个都没加载成功时内核拒绝启动（保护）。启动日志逐包打印装载与启用状态。

以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗