Bitcoin War
中文名「比特币战争」。这是一个独立的、非官方的实现，灵感来自 Newhedge 的「Bitcoin Battlefield」（https://newhedge.io/bitcoin/battlefield，推文 https://x.com/newhedge_io/status/2104903265959760161）；本项目与 Newhedge 没有任何关联，也未获其认可。BTC 价格就是战线，盘口挂单就是兵力，主动成交、爆仓和期权成交会变成战场上的炮击。
Bitcoin War is an independent, unofficial implementation inspired by Newhedge's Bitcoin Battlefield. It is not affiliated with or endorsed by Newhedge.
运行
pnpm install
pnpm dev # http://localhost:5173 实时行情
# http://localhost:5173/?sim 离线模拟行情
pnpm test # 单元测试（解析器使用真实抓取的交易所消息）
pnpm verify:feeds [秒] # 在 Node 里跑真实交易所连接，输出指数/盘口/事件检查（默认 45 秒）
pnpm build && pnpm verify:screens # 无头 Chrome 截图 + FPS/报错收集，输出到 verification/
pnpm capture:fixtures [秒] # 抓取真实交易所消息到 tests/fixtures/_capture/，用来刷新测试夹具
pnpm build && pnpm verify:audio # 音频检查，并渲染试听文件 verification/audio-preview.wav
pnpm build && pnpm verify:mobile # 手机/平板/窄窗口布局检查：遮挡、出界、文字溢出，截图在 verification/mobile/
URL 参数
| 参数 | 说明 | 默认 |
|---|
sim | 使用离线模拟行情 | 关 |
seed, speed | 模拟行情的随机种子和速度 | 7, 1 |
range | 一回合的半宽（%），价格打到 ±range 即胜 | 0.25 |
big | 大单阈值（USD，按同一主动单合并后计算） | 25000 |
sources | 逗号分隔的数据源，如 coinbase,kraken,okx | 全部 |
light | auto / golden / day / night | auto（按本地时间） |
lang | zh / en 界面语言（也可点右上角按钮或按 L 切换，选择会记住） | 跟随浏览器 |
post | 0 关闭后期处理（泛光、移轴、暗角） | 开 |
q | 画质：不填则按设备自动选档并随帧率升降（桌面从 5 档起，手机平板从 4 档起）；1–5 或 high 固定档位；low 固定最省模式（关阴影和后期，1x 像素比） | 自动 |
sound | 0 关闭声音（不记住选择；按钮和 M 键的选择会记住） | 开（浏览器允许时自动播放，否则点击画面任意位置后出声） |
操作
拖动旋转，滚轮缩放，W/A/S/D 平移，Q/E 环绕，C 切换电影镜头，F 回到前线，L 切换中英文，M 开关声音。
画面效果
- 后期：泛光（Bloom）、移轴微缩模糊（电影镜头下更强）、暗角、按光照预设调色、4x MSAA。
- 单位：行军摆腿、开枪后坐、坦克炮管后坐和行驶扬尘，受击闪光后倒地再爬起。
- 交火：前线士兵按主动成交流量对射（曳光弹、枪口火光）；大单、爆仓是炮击，带碎块、焦痕、冲击波、镜头震动。
- 环境：树木随风摆动、云影掠过地面、前线硝烟、战线流光脉冲，价格变动时战线闪多空颜色。
- 回合：攻陷后败方旗帜降下、换成胜方颜色再升起，基地上空连环爆炸。
- 声音（默认开启）：管弦配乐随行情切换，平静时是 M2「暗涌」，激战时是 M1「铁血进行曲」，胜利时是 M3「破晓冲锋」；多层合成的步枪和机枪（牛熊音色不同）、坦克炮、四档爆炸、爆仓炮弹呼啸、信号弹、开战号角、胜利号曲，都按画面位置做立体声，远处更闷。详见 docs/audio/README.md，致谢见 CREDITS.md。
结构
src/data/feeds/exchanges.ts 各交易所解析器（纯函数）+ 连接配置
src/data/feeds/wsFeed.ts WebSocket：指数退避重连、心跳、看门狗
src/data/orderbook.ts L2 订单簿（快照/增量、按深度截断、去交叉）
src/data/market.ts MarketHub：USDT→USD、成交量加权指数、离群剔除、
主动单合并（大单）、爆仓/期权事件、深度分桶、流量
src/data/sim.ts 离线模拟行情（同一套事件接口）
src/game/battle.ts 回合/胜负、战况播报
src/game/field.ts 价格 → 战场坐标、前线波动函数（与着色器共用）
src/game/armies.ts 深度 → 前线士兵 / 方阵 / 坦克 / 基地储备
src/render/* Three.js：地形与领土着色器、实例化兵力、特效、
基地、光照预设、镜头导演
src/render/post.ts 后期处理（泛光、移轴、暗角、调色）
src/ui/* HUD（价格、战况条、深度图、流水、交易所状态）、中英文字典 i18n.ts
映射规则
- 战线 = 聚合价格。价格低于战线的一侧（买盘）是牛方领土，高于战线的一侧（卖盘）是熊方领土。
- 回合：开局时以当前价为中心，在 ±0.25% 处各设一个基地。价格打到熊方基地即牛方获胜，反之熊方获胜；6 秒后以新价格开下一局。
- 兵力：总深度在场上约折合 1100 名士兵，1 名士兵对应的金额取 1/2/2.5/5 的整数档；1 辆坦克等于 25 名士兵的金额，由单桶挂单墙生成。
- 前线 3 个分桶内的挂单组成贴着战线的士兵排。
- 场内挂单按其价格位置排成方阵。
- 基地以外、±1% 以内的挂单算作储备。
- 事件：
- 主动大单：己方坦克或士兵开炮。
- 爆仓：从后方打来的重炮。空头爆仓时炮弹落在熊方阵地，多头爆仓时落在牛方阵地。
- 期权大单：信号弹。
- 金额很大的事件会让电影镜头切过去特写。
访问统计
线上页面会加载 Cloudflare Web Analytics 的 beacon（src/analytics.ts），用来统计访问量。它不使用 Cookie，不采集个人信息；只在 battle.ondream.ai 域名下加载，本地开发、预览和验证脚本不会上报。
许可
本仓库作者自己的作品（代码、文档、音频、图片）以 PolyForm Noncommercial License 1.0.0 发布：
- 可以：复制、分发、修改，用于非商业目的，例如个人学习、研究、爱好项目，以及慈善组织、教育机构、公共研究机构、政府机构的使用。分发时必须附上许可条款（或其网址），以及
LICENSE.md 顶部的 Required Notice 版权声明。
- 不可以：商业用途。需要商业授权请通过 GitHub 联系仓库所有者。
- 第三方组件（three.js、Inter 字体、MuseScore_General 音色库等）按各自的许可证，见 CREDITS.md。「Bitcoin Battlefield」和 Newhedge 的名称、标识归其所有者，本许可不授予任何第三方权利。
以上只是摘要，以 LICENSE.md 英文原文为准。
