v1.0.0

v1.0.0 — 2026-08-19

Version Code: 100300
Tag: v1.0.0

Ala Mobile Tool 首个正式版本。自 Beta 5 以来新增完整日志系统与 NPatch 激活确认流程收窄，并修复多项稳定性问题。

Features

• 完整日志系统：新增「启用日志」开关（默认关闭），统一门控 Java/native 两侧文件输出；游戏与模块日志写入统一文件，设置页可一键导出并分享
• NPatch 激活确认流程收窄：激活弹窗收敛为「NPatch 作用域确认」，仅在检测到 NPatch 管理器已安装时弹出；未安装时点击激活卡片 Toast 提示

Bug Fixes

• 修复了响应曲线图表在平板/横屏下高度溢出撑爆卡片的问题（高度钳制到屏幕 50%）
• 修复了 LSPosed 激活检测轮询超时误弹免 Root 弹窗的问题（改为事件驱动）
• 修复了解锁标记文件残留但 PlayerPrefs 丢失时车库车辆锁着的问题（解锁走 SetUnlocked(true) 完整路径重写 PlayerPrefs）
• 修复了应用内检查更新下载不动的问题（kkgithub.com 不镜像 release asset，改用 gh-proxy.com 等多代理 fallback；OkHttp 显式走系统代理，修复挂梯子也不生效的问题）

v1.0.0-Beta-5

v1.0.0 Beta 5 — 2026-08-18

Version Code: 100250
Tag: v1.0.0-Beta-5

新增 V10 引擎声浪替换开场动画背景音、应用内检查更新、游戏版本检测胶囊，修复弹窗返回键失效问题。

Features

• V10 引擎声浪：将开场动画背景音替换为 V10 引擎声浪，默认关闭，可在「配置 → 杂项」中开启
• 应用内检查更新：启动时自动检查 GitHub Releases（官方与镜像站竞速），有新版本自动弹窗并展示 Markdown 格式的 Release Note，支持下载进度显示、调起安装器、跳过该版本
• 更新通道设置：在「设置 → 模块更新通道」可选择稳定版（仅正式 Release）或预览版（含 Pre-release）
• 游戏版本检测胶囊：概览页标题上方显示官版与共存版的版本适配状态，已适配（8.0.4）显示绿色，未适配显示红色，未安装显示黄色
• EULA 启动门控：恢复首次启动强制阅读用户协议，协议弹窗需滚到底部才能点击「同意」
• 弹窗退出动画：EULA、支持开发、检查更新弹窗关闭时播放退出动画
• 支持开发卡片：概览页新增「支持开发」卡片，点击弹出「向开发者捐赠」弹窗
• QQ 群直接拉起：概览页 QQ 群卡片点击后直接拉起 QQ App 群资料页，未安装 QQ 时降级到网页
• 配置页重组：原「功能开关」改名为「游戏原生功能控制」，仅保留解锁付费内容与 TC；替换主菜单音乐与 V10 引擎声浪移至新增的「杂项」分类
• 设置页重组：移除关于卡片，新增「模块更新通道」组与「清除跳过更新标记」项，整体分为模块更新通道、日志、激活/协议三组
• 响应曲线自动收回：线性踏板关闭时响应曲线整个分类自动隐藏，减少无关选项干扰
• 移除显示悬浮窗开关：悬浮窗显示由工具按钮控制，不再需要配置页开关

Bug Fixes

• 修复了所有弹窗按系统返回键不关闭弹窗、直接退到桌面的问题（删除手动创建的 NavigationEventDispatcherOwner，改用 ComponentActivity 自带的 dispatcher）
• 修复了清除激活标记会联动清除 EULA 同意状态的问题，两者现在相互独立

v1.0.0-Beta-4

v1.0.0 Beta 4 — 2026-08-17

Version Code: 100240
Tag: v1.0.0-Beta-4

新增自定义油门/刹车响应曲线编辑器，修复配置实时生效与 native 库加载问题。

Breaking Changes

• 仅支持 Ala Mobile 8.0.4：本版本起模块只适配 8.0.4（versionCode 200146），8.0.0 用户将收到不支持警告，请升级游戏版本

Features

• 自定义油门/刹车响应曲线：可在配置页为油门和刹车分别编辑响应曲线，通过拖拽控制点调整手感，曲线经过所有控制点且保持单调

Bug Fixes

• 修复了修改配置后不立即生效的问题（daemon 旧值覆盖新配置）
• 修复了切换踏板模式后位置/大小丢失的问题
• 修复了 native 库加载失败导致模块不生效的问题

Performance

• 底栏快速切换不再卡顿，切页掉帧问题修复

v1.0.0-Beta-3

v1.0.0 Beta 3 — 2026-08-12

Version Code: 100230

新增毛玻璃 UI、用户协议强制确认、配置页图标自定义，修复了 AI 车油门误控、激活检测误判和非 Root 配置跨进程同步等一系列问题。

Features

• 毛玻璃视觉效果：配置页顶栏和底栏新增模糊毛玻璃效果（Android 12+），界面更现代
• 用户协议强制确认：首次打开配置页必须阅读并同意用户协议，不同意则退出
• 配置页图标自定义：牵引力控制、踏板、刹车曲线等开关换上自定义图标，识别更直观
• 主菜单音乐替换：默认将游戏主菜单音乐替换为 Hans Zimmer - F1（320kbps 高音质）
• 原生牵引力控制（TC）开关：可在配置页独立开启或关闭游戏原生 TC，关闭后模块不再覆写 TC 字段
• 工具按钮改版：悬浮工具按钮改为圆角矩形 + App 图标，支持拖动位置
• NPatch 配置同步：非 Root 用户（NPatch）在游戏不运行时修改配置，启动后自动生效
• 解锁弹窗根治：开启解锁功能后不再弹出游戏内购提示，预设已解锁状态

Bug Fixes

• 修复了 AI 车油门误控：模块不再误控 AI 对手车的油门/刹车，只作用玩家操控的车辆
• 修复了 LSPosed 激活状态误判：彻底解决「清数据后关开关仍显示已激活」和「游戏没跑时显示未激活」的误判
• 修复了首次安装未激活不弹窗：未启用模块时自动弹出配置页引导弹窗
• 修复了音乐替换 MP3 提取失败：改用 assets/ 目录直接读取，避免 release 编译重命名导致资源找不到
• 修复了 WSL2 下 Kotlin 编译卡死：WSL2 环境不再因 Kotlin 编译守护进程网络回环卡死
• 更新 LSPosed 管理器描述为中文：管理器列表显示「Ala Mobile 体验增强模块」

Performance

• 音乐替换音质升级至 320kbps

Known Issues

• NPatch 注入时序依赖：非 Root 用户（NPatch）如果清数据后不打开一次 NPatch 管理器直接开游戏，模块不生效。建议每次清数据后先打开 NPatch 管理器再开游戏。
• ABS 开关暂未实现：配置页的 ABS 开关已注释，待找到正确的 ABS 入口点后恢复（当前 HandleABS 是死代码）
• 手动换挡暂未实现：配置页的手动换挡开关已注释，当前 DoGearShifting hook 会导致车辆无法驶出 P 房

安装

1. 确保已安装 LSPosed，或使用 NPatch / LSPatch / FPA 等免 Root 框架。
2. 从下方 Assets 下载 Ala Mobile Tool v1.0.0 Beta 3.apk。
3. 在 LSPosed 中勾选 Ala Mobile 作为作用域。
4. 启动游戏，进入游戏后点击左上角「工具」按钮显示 overlay。

v1.0.0-Beta-2

概述

Beta 1 之后的第一个预发布，集中在踏板体验、配置同步可靠性和激活状态可视化三块。共 34 个提交，其中 4 个为已 revert 的临时测试 tag，实际功能提交 30 个，覆盖 M7~M16 共 10 个里程碑。

✨ 新功能

踏板拓扑与双踏板

• 踏板拓扑下拉：原"线性踏板"开关升级为下拉，支持 关闭 / 单踏板 / 双踏板 三种模式。
• 双踏板模式：油门和刹车各占一个独立 overlay，可分别拖动定位；引入刹车优先仲裁——同时按下时屏蔽油门输入，避免油门刹车打架。
• 刹车踏板方向反转：双踏板模式下新增开关，刹车红色区域可改为从上往下生长（默认从下往上）。
• 响应曲线温和化：指数曲线 exponent 从 0.42 调到 0.66（30%→45%），手感更线性。

布局编辑

• 长按重置出厂默认：编辑模式下长按编辑层按钮，把 overlay 位置重置到出厂默认位置（不再重置到"上次保存值"）。
• SINGLE/DUAL 位置隔离：单踏板和双踏板的位置分别持久化到独立 JSON 字段，互不串扰（修复了"DUAL 油门继承 SINGLE 拖动位置"的 bug）。

配置同步

• 配置即时生效：在模块设置界面改配置后，游戏内 overlay 立即重建应用，无需重启游戏（M11/M12 遗留的"必须 toggle 才生效"已根治）。
• Remote Preferences 跨进程同步：配置同步迁移到 libxposed API 102 的 getRemotePreferences，经 LSPosed daemon（system uid，可读任意 filesDir）binder，绕开 Android 11+ scoped storage + 包可见性双拦。根治了"首次启动游戏读到旧配置"（M11 广播首次启动滞后的根因）。

概览页

• 激活卡片 UI 重做：照搬 KernelSU HomeMiuix 的对称强调底色（已激活=绿色调，未激活=红色调），Non-root 确认弹窗改用官方 miuix OverlayDialog。
• LSPosed 真激活检测：激活判定从 System.getProperty(MODULE_LOADED_FLAG)（ConfigActivity 进程不可达，死路）改为 App.xposedService != null（daemon 绑定 = Manager 当前启用）。语义实时跟随 Manager 启用态，不需重启进程。
• GitHub/QQ 图标：概览页 LinksCard 内嵌 SVG path 图标——GitHub 行用 Octocat，QQ 群行用 QQ 企鹅 logo（均来自 simple-icons，CC0）。

🐛 修复

• 方向键/摇杆转向失灵（M14 核心 bug）：native input_writer_thread 以 ~500Hz 持续写 0.0f 到油门/刹车字段，覆盖了游戏自带的转向辅助输入，导致 ButtonsSteering（屏幕方向键）模式的 steerHelp/LockSteerAtVelocity/TractionFilter 失效，方向键不转向。陀螺仪模式不依赖油门/刹车做转向，故不受影响。修复：writer 在用户未按踏板时早退（不写任何值），活动→非活动切换时主动 clear 一次。
• CI lint 假绿：M11/M12/M13 的 ContextCompat.registerReceiver 在 else 分支漏传 RECEIVER_EXPORTED flag 触发 UnspecifiedRegisterReceiverFlag，CI lintDebug 失败。统一改用 ContextCompat.registerReceiver(context, receiver, filter, RECEIVER_EXPORTED)（AndroidX 自动按 SDK_INT 分发）。

⚙️ 技术细节

• raw/mapped 值分离（M11）：PedalOverlayView 区分 rawThrottle/rawBrake（手指位移，驱动绘制，视觉跟手）和 mappedThrottle/mappedBrake（曲线变换后送 native，非线性游戏输入）。这使得双踏板仲裁能"视觉同时显示两指、游戏只收一侧输入"。
• 左下角坐标系（M12）：默认位置改为用户直觉的左下角原点百分比（pedal (80,55)(95,5)、brake (5,55)(20,5)），内部存储仍是 Android 原生左上角原点，只改默认值，转换 helper 不变。
• 废弃 IPC 路径：ConfigProvider.kt 在广播方案落地后已废弃，Remote Preferences 方案下更无用，待后续清理。

⚠️ 升级须知

• 配置文件格式有变更（enable_control_replacement bool → pedal_mode 枚举，pedal_curve → throttle_curve/brake_curve），模块在读取时会自动迁移旧字段，无需手动处理。
• 单/双踏板位置现已独立存储，从旧版本升级后单踏板位置保持，首次切到双踏板会用默认位置。

完整变更

Beta 1 (v1.0.0-Beta-1) 到 Beta 2 (v1.0.0-Beta-2) 共 30 个功能提交，详见 Beta 1...Beta 2 对比。

v1.0.0-Beta-1

安装

1. 确保已安装 LSPosed。
2. 从下方 Assets 下载 app-release.apk（正式签名版）或 app-debug.apk（调试版，稍后上传）。
3. 在 LSPosed 中勾选 Ala Mobile 作为作用域。
4. 启动游戏，进入游戏后点击左上角「工具」按钮显示 overlay。

Release APK 由维护者本地构建后上传，CI 暂不支持自动构建（compileSdk=37 需 Android 17 preview platform，SDK 仓库暂未发布）。

Full Changelog: TakotsuboChen/ala-mobile-tool@v1.0.0-Alpha-2...v1.0.0-Beta-1

v1.0.0-Alpha-2

变更内容

UI 重构

• 采用 KernelSU 风格的三页布局（概览/配置/设置）
• 修复深色模式显示问题
• 优化激活状态卡片视觉效果

功能完善

• 修复开关和滑条的即时反馈
• 修复下拉菜单闪退问题
• 禁用开发中功能（自动 DRS、关闭自动换挡）

其他改进

• 更新 QQ 群邀请链接
• 优化性能和稳定性

v1.0.0-Alpha-1

v1.0.0-Alpha-1

这是 Ala Mobile Tool 的首个预览版本，仅用于早期测试。

功能

• 踏板覆盖：在屏幕右侧叠加双区线性踏板（上半油门、下半刹车），支持死区、过渡点和响应曲线调节。
• 换挡按钮：在屏幕左侧提供升档/降档按钮，用于手动换挡。
• 自动 DRS / 主动空力：拦截游戏 DRS 开关，未来会基于 telemetry 自动判断开启时机；当前仅作开关拦截。

已知 Bug / 未完成项

• 换挡按钮会调用游戏内换挡方法，但当前不会关闭游戏的自动换挡，因此手动换挡可能与自动换挡产生冲突。
• 自动 DRS 仅拦截开关，尚未实现基于赛道 telemetry 的自动判断。
• 使用踏板覆盖时，行驶过程中可能出现高频顿挫，具体原因待排查。
• 当前 release APK 使用临时签名，正式发布前会替换为正式签名。

适用版本

• Ala Mobile 8.0.0 (versionCode 200142)

安装要求

• Android 8.0+，已安装 LSPosed / LSPosed 分支框架。
• 目标应用：com.Vince.AlamobileFormula

注意

本模块为 Alpha 版本，仅供测试，可能存在稳定性问题。