战雷全真模式收益计时器 · War Thunder SB Timer
War Thunder 是一款载具对战电子游戏；Bomana 是面向全真模式的多功能计时器。
文中的「炸弹 / 投弹 / CCRP」等均指游戏内虚拟概念，与现实无关。祝你玩得开心！
War Thunder is a vehicle-combat video game; Bomana is a multifunction timer for simulator battles.
Terms like “bomb / bombing / CCRP” here mean in-game virtual concepts only, not anything in the real world. Have fun!
面向日常游玩：如何下载、怎么用、有哪些功能。尽量少用术语。
本声明发布前的旧版本已下架。下载并使用新版，即视为知悉并同意本声明。
Bomana 不会读游戏内存、注入代码、改游戏文件，也不会替你按游戏里的键或自动操作对局。
它只在自己的窗口 / 网页里，读取游戏主动提供在本机的公开数据，帮你计时和做参考。
社区经理 Stona_WT 在 2024 年 5 月 13 日的官方回复中大致表示：
- 用游戏本机提供的数据显示飞行信息、覆盖层，一般可以，不会因此直接封禁。
- 但在无标记模式下，把敌人位置做成罗盘式叠加层、获得相对其他玩家的优势，官方不认可，可能被视为不当辅助。
| 做法 | 态度 |
|---|---|
| 显示自己的速度、高度、油量、收益计时 | 官方表态偏允许 |
| 用本机公开数据做导航、燃油、超速等参考 | 官方表态偏允许（同类工具如 WTRTI 亦属此类） |
| 在无标记模式把敌人画进游戏画面式罗盘 / HUD 叠层 | 不认可 |
| 在独立网页地图里，仅镜像当前官方本机数据里已经返回的敌方单位 | 官方未明确表态，请自行判断是否使用 |
| 读内存、注入、改客户端文件、宏连点、替你操作游戏 | 禁止；Bomana 不提供 |
| 项目 | 说明 |
|---|---|
| 数据从哪来 | 只读游戏在本机开放的信息页（浏览器也可打开 http://localhost:8111 核对）。不读进程内存。 |
| 和游戏进程的关系 | Bomana 是独立程序、独立窗口；不嵌进游戏、不注入 DLL、不改游戏文件。 |
| 热键做什么 | F7–F11 等只控制 Bomana 自己（重置计时、锁窗、角落、声音）。不会往游戏里模拟按键。 |
| 可选「管理员热键」 | 仅当游戏以管理员运行、导致全局热键可能失效时，你手动确认后才会弹出系统授权。拒绝后计时 / 导航 / 窗口按钮仍可用。 |
| 桌面叠加层（可选） | 默认关闭；打开后是 Bomana 自己的透明窗，给己方导航参考。敌方单位不会画进桌面 HUD 或航向带。 |
| 网页地图上的敌方 | 若出现，只来自当前这一帧官方本机地图数据；断线或下一帧没有就去掉。不根据历史推轨迹，也不补齐未见过的目标。 |
| 网页按钮 | 只改 Bomana（计时、角落、声音、面板、可选武器设置等），不遥控游戏客户端。 |
- “技术上安全的实现”≠“官方书面担保永不处罚”。请自行遵守用户协议与对局规则。
- 若你希望更保守：可不开启网页局域网、可不打开画面叠加层、不使用网页地图上的敌方显示相关能力。
- 更细的端点列表、进程查询范围与合同测试见下方 运行时隔离与安全边界。
请你自行了解规则，并为自己的使用方式负责。
全真模式每次出生后有约 15 分钟收益周期。Bomana 会：
- 自动识别出生、着陆、阵亡并开始/重置计时
- 显示当前是第几条命
- 程序重启后尽量接着计
- 临近结束时用语音或提示音提醒
在支持的版本里提供投放距离、时间窗口等估算提示（自由落体炸弹、部分导弹与制导武器等）。
请注意：
- 这些都是参考值，不是游戏内部真实算法
- 需要你手动选择当前武器，程序不会自动猜挂载
- 可在设置里对自由落体路径做简单距离/时间修正
- 图形化航向、距离、预计到达时间
- 对准目标一段时间后可自动锁定
- 返航机场方向与距离；敌方机场可按需显示
- 同一战局复活后，可提示上次损失位置方向
- 在游戏画面之上用 Bomana 自己的透明窗给出主目标方位提示（默认关闭，在设置里打开）
- 这不是改游戏画面，也不注入游戏进程；可调透明度、大小、显示器等
- 敌方单位不会出现在该叠加层
- 油量、油耗与返航油量粗估
- 按机型提示是否接近限速（表速与马赫）
起飞前可勾选的自定义检查项（开引擎、收起落架等）。
| 能力 | 说明 |
|---|---|
| 透明、置顶 | 少挡视线，始终可见 |
| 锁定 | 锁定后鼠标点穿，不影响操作游戏 |
| 拖动与贴边 | 自由摆放，可贴屏幕边缘 |
| 主题与热键 | 明暗主题；F7–F11 可改 |
| 系统托盘 | 可最小化到托盘 |
| 独立文字大小 | 只放大字，不硬撑整窗 |
| 自定义提示音 | 可按类别导入本地音频 |
可在电脑浏览器或同一可信局域网的手机上查看计时、地图、油量、导航等信息，并操作部分 Bomana 自身功能（如重置计时、切换角落、开关声音等）。
- 默认先本机可用；要给手机用时，在程序里开启「局域网访问与控制」
- 开启局域网后，之后配对的设备可控制这些固定功能；关闭后立即失效全部局域网会话
- 网页不会代替你按游戏热键，也不会操控游戏客户端
- 网页地图若显示敌方单位，仅镜像当前官方本机数据；是否使用请结合上方合规说明自行判断
更细的上手步骤见 docs/QUICKSTART.md。
- 系统：Windows
- 先启动 War Thunder 并进入战斗（机库里通常没有可用的飞行数据）
- 一般无需额外开关；游戏进入战斗后，本机数据即可被读取
- 打开 Releases
- 下载
Bomana_launcher_vX.X.X.exe并双击运行（绿色版，无需安装） - 选择功能通道后，启动器会检查并下载对应程序包
| 通道 | 包含什么 | 适合谁 |
|---|---|---|
| Enhanced | 计时 + 导航 + 燃油 + 武器参考 + 网页驾驶舱 | 想要完整功能（推荐） |
| Standard | 计时 + 导航 + 燃油（无武器参考、无网页驾驶舱） | 不需要武器参考与网页控制台 |
| Lite | 仅计时（无网页驾驶舱） | 只要极简界面 |
Standard / Lite 不会打包网页驾驶舱代码；若启动器勾选了网页相关选项，启动时会提示并忽略这些选项（偏好仍可保存，切回 Enhanced 后生效）。
补充说明：
- 首次通常需要联网下载程序包；之后可离线启动已下载版本
- 新版启动器会保留一个上一版本，出问题时可一键回退
- App 8.0.0 及以上需要启动器 3.0.0 及以上
- 程序显示名：
Bomana香焦 - 也可从 官网镜像（国内 CDN）或 GitHub Pages 进入下载
若本机已有 Python / uv 环境，也可直接从源码启动。步骤见下方 从源码运行。
| 按键 | 作用 |
|---|---|
F7 |
手动重置计时（需短时间连按两次） |
F8 |
锁定 / 解锁窗口（锁定后点击穿透） |
F9 |
在四个屏幕角落间切换位置 |
F10 |
总提示音开关 |
F11 |
战区被摧毁提示音开关 |
快捷键可在设置中修改。画面叠加导航只能在设置里开关（默认关）。
关于「管理员热键」：
- Bomana 与启动器始终以普通权限运行，启动时不会自动弹 UAC。
- 仅当游戏以管理员运行（或权限暂时无法判断）时，才可能出现可选授权入口。
- 你确认后，系统才可能要求批准一个仅负责全局热键的小组件；它只把「重置 / 锁定 / 角落 / 声音」等动作通知 Bomana，不会注入游戏、也不会替你按游戏键。
- 拒绝授权：计时、导航、窗口按钮、本机数据读取照常；只是游戏前台时全局 F7–F11 可能失效。
不会。运行时只读游戏本机开放的数据页；独立窗口显示；热键与网页按钮只改 Bomana。没有读内存、注入、改游戏文件、宏连点或模拟游戏按键。细节与自检测试见 运行时隔离与安全边界。
- 计时、己方飞行数据、导航参考等，与官方曾表态「可用本机数据显示覆盖层」的方向一致。
- 不提供把敌人画进游戏式 HUD / 罗盘叠层的能力。
- 独立网页地图上的敌方显示属于官方未明确表态的灰区，请自行决定是否使用。
- 任何第三方工具都无法保证「永不处罚」。请以用户协议与自身风险判断为准。
- 确认游戏已进入战斗
- 浏览器访问
http://localhost:8111，确认有数据 - 仍异常时，重启游戏并重新进战斗
- 按
F9切换角落
- 确认已出生在战场
- 确认上面的本机地址能打开
- 稍等 1–2 秒让程序识别
- 手机和电脑连同一可信局域网（如同一 Wi‑Fi）
- 在 Bomana 主窗口或托盘开启「局域网访问与控制」
- 用主窗口显示的配对码 / 链接在手机浏览器打开
- 若连不上，在 Windows 防火墙提示中允许 Bomana 的专用网络访问（程序不会自动改防火墙）
- 在武器卡片上手动选对当前挂载
- 提示仅为估算，受地图、风速、姿态等影响
- 自由落体路径可在
设置 → 投弹微调距离/时间倍率（只影响该路径）
| Bomana | WTRTI | |
|---|---|---|
| 侧重点 | 全真收益计时 + 导航 / 武器参考 | 通用飞行数据展示 |
| 15 分钟计时 | 有 | 无 |
| 战区导航 / 武器参考 | 有（视通道） | 无 |
| 高度自定义仪表 | 无 | 有 |
两者可同时使用。
见 docs/CHANGELOG.md。源码版本以 bomana/metadata.py 为准；已发布版本见页面顶部的 release 徽章。
启动器会收集匿名使用统计（如设备哈希、安装 ID、版本、通道、事件类型），用于改进产品和统计活跃度。
- 不收集姓名、邮箱、游戏账号、IP、战绩等
- 开源可审查；可按隐私政策禁用
- 完整说明：docs/PRIVACY.md
下载并运行本应用，即表示你知悉上述隐私政策。
MIT License — Copyright (c) 2024-2026 Cheems
可自由使用、复制、修改、分发本软件；须保留版权与许可声明。全文见 LICENSE。
商标： War Thunder® 及相关标识归 Gaijin Entertainment AG 所有。本软件为独立项目，与 Gaijin 无关联、授权或赞助关系。
使用风险： 滥用或不当使用可能违反 Gaijin 用户协议。请自行确保用法合规。
责任限制： 本软件按「现状」提供，作者不对账号处罚、损失或其他后果负责。风险自负。
如果 Bomana 对你有帮助，欢迎微信赞助：
面向贡献者、打包与维护：源码运行、目录、规格、构建与发布。
| 文档 | 内容 |
|---|---|
| docs/QUICKSTART.md | 玩家向快速上手 |
| docs/ARCHITECTURE.md | 代码结构、数据流、构建链路 |
| docs/CONTRIBUTING.md | bd 协作、提交与发布约定 |
| docs/specs/ | 规范正文（8111、签名、线程、配置变体、质量门禁等） |
| docs/specs/version-compatibility.md | App 8 / Launcher 3 版本边界 |
| docs/specs/web-dashboard.md | 网页驾驶舱边界与语义控制 |
| docs/specs/release-signing.md | 发布签名与部署规则 |
| docs/PRIVACY.md | 匿名统计与 Web 本机/LAN 边界 |
| docs/CHANGELOG.md | 版本变更 |
| docs/PITFALLS.md | 已知坑与排障 |
| docs/guides/8111-session-recording.md | 录制 8111 对局用于离线回放 |
| docs/guides/web-cockpit-smoke.md | 网页驾驶舱人工冒烟 |
| tests/README.md | 测试分层与规范映射 |
| Agents.md | Agent / 贡献者路由与质量门禁 |
- Windows
- Python 3.14+（仓库
.python-version默认 pin 3.14.5） - uv
uv sync --python 3.14.5
$env:BOMANA_SOURCE_DEVELOPMENT = "1"
uv run python Bomana.pywBOMANA_SOURCE_DEVELOPMENT=1 仅允许非冻结源码开发跳过启动器身份校验；打包 App 不接受该例外。App 8.0.0+ 运行时要求 Launcher 3.0.0+ 身份。
调试可选管理员热键时，可先构建开发用 Broker（产物在仓库内且通常被忽略）：
uv run python tools/build_hotkey_broker.py --mode dev --output bomana/bin.
├─ Bomana.pyw # App 入口（单实例 / DPI / 启动 UI）
├─ launcher.pyw # 绿色版启动器
├─ bomana_version.py # App / Launcher 共享版本边界
├─ bomana/
│ ├─ config/ # 功能开关、设置、静态配置
│ ├─ core/ # 状态、遥测、弹道、导航逻辑
│ ├─ data/ # CCRP / 武器 / 限速等静态 JSON
│ ├─ assets/web/ # 网页驾驶舱前端
│ ├─ ui/ # Tk 界面与 presenter
│ ├─ web/ # 独立 HTTP 服务与语义控制
│ └─ utils/
├─ launcher/ # 清单、下载缓存、安装事务
├─ native/hotkey_broker/ # 最小特权热键 Broker（Rust）
├─ tools/ # 打包、datamine、发布部署
├─ tests/
└─ docs/
要点：
- 业务逻辑在
bomana/；Bomana.pyw负责启动边界 - Launcher 与 Python App 以普通完整性运行；仅用户确认后，包内固定动作原生 Broker 才可提权
- 限速库：
bomana/data/fm_speed_limits.json；炸弹参数：bomana/data/ccrp_bomb_params.json
见 bomana/config/feature_profile.py：
ENABLE_CCRP = True # 武器 / 投弹参考
ENABLE_ZONES = True # 战区导航
ENABLE_AIRFIELDS = True # 机场导航
ENABLE_FUEL = True # 燃油
ENABLE_CHECKLIST = True # 出击检查清单
ENABLE_ADVANCED_SETTINGS = True # 高级设置统一入口会刷新：
bomana/data/ccrp_bomb_params.jsonbomana/data/weapon_fire_control.jsonbomana/data/fm_speed_limits.json- 各 JSON
meta中的 datamine 来源版本 / commit
git clone https://github.com/gszabi99/War-Thunder-Datamine.git
git -C .\War-Thunder-Datamine pull --ff-only
uv run python tools/update_datamine_assets.py ^
.\War-Thunder-Datamine ^
--no-bomb-report单项调试可直接调用 tools/blkx_extractor.py、tools/fm_speed_extractor.py、tools/weapon_fire_control_extractor.py。
超速分级实现会对照 KaerMorh/WTSpeeder 交叉核验，但 Bomana 独立维护自己的 fm_speed_limits.json。
| 端点 | 内容 |
|---|---|
/indicators |
仪表（速度、油量、有效性等） |
/state |
状态（空速、高度、垂直速度等） |
/map_obj.json |
地图对象（战区、机场、玩家、当前样本中的单位等） |
/map_info.json |
地图元数据 |
/map.img |
官方战术地图缩略图（App 低频、有界、类型校验） |
/icons.ttf |
官方战术图标字体（有界、一次性/低频，签名校验） |
- 基址固定：
http://127.0.0.1:8111（或等价 localhost） - JSON 拉取集中在
bomana/core/telemetry.py；运行时禁止散落的任意requests/urlopen - 规范：docs/specs/runtime-8111-boundary.md
| 文件 | 用途 |
|---|---|
ccrp_bomb_params.json |
自由落体 / 高阻炸弹参数 |
weapon_fire_control.json |
武器目录、挂载与条件表 |
fm_speed_limits.json |
机型 IAS / Mach 限速 |
静态库来自公开 datamine 的构建期提取；运行时只读 JSON，不在对局中打开游戏安装目录或解密客户端包。
- 正常：约 50 ms（20 Hz）
- API 断线：约 1.25 s
- Bomana 是唯一的 8111 读取方；网页不代理、不转发任何 8111 路由
- App 发布筛选后的快照、有界地图位图与 Tk 拥有的控制状态
- 敌方单位仅镜像当前
/map_obj.json样本；不进桌面 HUD / 航向带 - 写入经会话 CSRF、幂等键与主线程再授权，仅固定语义动作（见
bomana/web/control.py白名单） - 默认
127.0.0.1:8777；LAN 时绑定可用 RFC1918 地址，不用0.0.0.0 - 完整规格：docs/specs/web-dashboard.md
[等待] ──检测到玩家──→ [飞行中] ──速度<40km/h 持续约3秒──→ [已着陆]
↑ │ │
│ ↓ │
└───无玩家约1.2秒──[死亡/返回机库]←────约10秒后────────┘
本节对应「只读 8111、与游戏进程隔离、无脚本操控游戏」的实现与自检。玩家向摘要见 合规性声明。
War Thunder ──仅官方本机 HTTP :8111──► Bomana App（普通完整性）
├─ 独立 Tk / HUD 窗口（非游戏子窗口）
├─ 可选 Web 驾驶舱（独立端口，不代理 8111）
└─ 可选 Hotkey Broker（用户确认 UAC 后）
└─ 命名管道：仅 Bomana 动作 ID
| 边界 | 实现要点 |
|---|---|
| 无内存 / 注入 | 运行时不含 ReadProcessMemory、WriteProcessMemory、CreateRemoteThread、pymem、frida 等路径 |
| 无游戏输入合成 | 运行时不含 SendInput / keybd_event 向游戏灌键；Web 合同测试同样禁止 |
| 无改客户端 | 不读/写 game.log、客户端包体、安装目录作为运行时数据源 |
| 窗口 | 独立置顶分层窗；不 SetParent 进游戏 HWND |
| 热键 | RegisterHotKey → 回调只改 Bomana；Broker 同样只 RegisterHotKey，无键盘钩子 / 轮询 |
为判断是否显示「授权管理员热键」入口，App 可以：
- 枚举可见顶层窗口，标题含
War Thunder的候选 - 对候选进程使用
PROCESS_QUERY_LIMITED_INFORMATION - 确认映像名为
aces.exe/aces64.exe/aces_BE.exe - 再
TOKEN_QUERY查看是否提升完整性
不会：进程全表快照、枚举模块、读内存、保留游戏进程句柄作其他用途。规范：docs/specs/startup-elevation.md（ELEV-03 等）。
| 项 | 约束 |
|---|---|
| 何时出现 | 用户点击并确认后才可能 runas；启动从不自动 UAC |
| 路径 | 仅包内 bomana/bin/BomanaHotkeyBroker.exe + 旁路 SHA256 |
| 动作 | 固定：reset / lock / corner / beep / 可选 zones；键位限 F1–F12 |
| IPC | 本机命名管道，帧内仅状态与动作 ID |
| 对 App 进程 | 可用 SYNCHRONIZE | PROCESS_QUERY_LIMITED_INFORMATION 等待退出——目标是 Bomana，不是游戏 |
| 不做的事 | 不钩键盘、不查游戏、不联网、不装服务/计划任务/开机项 |
uv run --extra dev python -m pytest ^
tests/contracts/test_runtime_8111_boundary.py ^
tests/contracts/test_startup_elevation_contract.py ^
tests/contracts/test_web_dashboard_contract.py -q| 测试 | 覆盖 |
|---|---|
test_runtime_8111_boundary |
API 基址、端点白名单、危险 API 字符串、HTTP 集中化、录制/回放边界 |
test_startup_elevation_contract |
普通完整性、探测收窄、Broker 路径/哈希/禁止项 |
test_web_dashboard_contract |
不代理 8111、语义命令矩阵、禁止输入合成 |
开发工具注意：tools/ 下 datamine / 会话录制 / 打包 smoke（含 keybd_event 的 PowerShell）不进入玩家对局运行时；录制默认本机 recordings/ 且不上传。
tools\scripts\build_portable.bat <Enhanced|Standard|Lite> <all|app|launcher> [version]
tools\scripts\build_app_package.bat Enhanced|Standard|Lite
tools\scripts\build_launcher.bat [version]
version为一致性校验，须匹配源码版本；all通常省略单一version- App 包内嵌最小热键 Broker 与 SHA256，无需单独安装器
- 发布构建须设置
BOMANA_RELEASE_ED25519_PRIVATE_KEY、BOMANA_RELEASE_ED25519_PUBLIC_KEY、BOMANA_RELEASE_SIGNING_KEY_ID（默认bomana-release-2026-06） - 未签名清单或不匹配公私钥会被拒绝
| 触发 | 产物 |
|---|---|
标签 vX.Y.Z |
启动器 + 三通道 App |
标签 vX.Y.Z-app |
仅三通道 App |
标签 vX.Y.Z-launcher |
仅启动器 |
workflow_dispatch |
可选 all / app / launcher |
构建使用 GitHub Artifact Attestations 记录来源；无需 Authenticode PFX。签名字段与信任边界见 docs/specs/release-signing.md。
不要用 GitHub Actions 直连腾讯云主机部署。 在本机：
gh secret list --repo Thankyou-Cheems/Bomana
gh release download vX.Y.Z --dir dist
uv run python tools/deploy_update_assets.py --target app|launcher|all --version X.Y.Z公开端点验证必须走 verify_release_manifest_signature。
| 文件 | 作用 |
|---|---|
Bomana_launcher_vX.Y.Z.exe |
固定入口：检查更新、下载校验、自更新、回退 |
launcher_manifest.json |
启动器版本、文件名、SHA256、Ed25519 签名 |
Bomana_app_<Variant>_vX.Y.Z.zip |
实际运行包 |
manifest_<Variant>.json |
App 版本、min_launcher_version、SHA256、签名 |
checksums_*.txt |
完整性校验清单 |
- War Thunder 论坛：8111 工具讨论
- Stona_WT 官方回复（#16）
- Gaijin 用户协议
- WTRTI
- KaerMorh/WTSpeeder
- War Thunder localhost:8111 文档
独立更新 / 统计服务（Docker / FastAPI）在：
- https://github.com/Thankyou-Cheems/bomana-worker
- 路径：
services/bomana-update-service/
本仓库维护主程序与启动器；部署与迭代文档以 bomana-worker 为准。
本仓库生成带 Ed25519 manifest_signature 的清单；服务端不重新签名、不需要发布私钥。部署后用 tools/deploy_update_assets.py 校验公开接口签名。
Made by 猹Cheems for the Space Monkeys community