安全出行 SafeWalk

海阔天空,勇敢去走。

纯本地、无服务器的出行感知工具。不依赖 GMS,不联网,不上传任何数据; 用手机自带加速度计判断「你是不是真的在走路」,再决定要不要提醒你。

  • 运行环境:Android 13+(minSdk 33,targetSdk 35),已适配 HyperOS / MagicOS / ColorOS / OriginOS / HarmonyOS / Flyme / 原生
  • 增强方式:LSPosed 模块(作用域只需勾选「系统界面(SystemUI)」,不需要系统框架); 无障碍相关能力可独立使用,不依赖 root
  • 开源协议:AGPL-3.0(见 LICENSE)
  • 当前版本:5.5.0(2026-11-18)· 下载 APK · 更新日志

📥 安装与更新

方式 说明
直接下载 点上面的「下载 APK」,手动安装;每次更新需重新下载
Obtainium(推荐) 装一个 Obtainium,点下面链接添加,之后每次发版自动提示更新
obtainium://add/https://github.com/Xposed-Modules-Repo/io.github.wumisc.safewalk

本应用没有上架任何应用商店,商店里搜不到是正常的,并非下架。 原因见 docs/distribution.md:这类需要无障碍与后台常驻的工具, 在国内商店属于高风险类目,提交也大概率被拒。


✨ 功能一览

功能 触发 说明
🔋 电量预警 电量 ≤15% 且步行中 提醒充电,1h 冷却
🪪 证件提醒 确认持续步行 证件贴身放好,每日 1 次
🪑 久坐提醒 停止走动满 2h 起身活动,每日 1 次
🚶‍♂️ 久走提醒 累计走满 45min 找地方坐五分钟、喝口水(等红灯不重新计时)
🌙 夜间独行 夜间累计步行 10min 走有灯的一侧,把行程告诉家人
🔦 夜间提醒 22:00~06:00 步行中 通知带「手电筒」按钮,一键开灯
🤝 社交礼仪 确认持续步行 按求职/约会/聚会/旅游给 3 条提示
🚶 行走模式 开始步行 后置摄像头把身后路况叠在屏上,尺寸/位置/文字可自定义
🚑 车祸预警 检测到剧烈撞击 全屏急救卡 + 60s 倒计时,无响应自动求助
🙈 隐藏桌面图标 首页 → 隐私 藏起启动图标防他人随手打开;确认后生效,可可靠恢复(见下)
🗂 最近任务隐藏 首页 → 隐私 本 App 不出现在系统「最近任务 / 概览」列表
💬 功能建议 关于 → 功能建议 写一句想法,带上机型版本直接提交到 GitHub

所有功能共用同一个总开关。关闭时二级菜单里的开关保留设置但不生效。

隐藏桌面图标后如何恢复

隐藏图标只影响桌面入口,所有提醒与急救功能照常运行。恢复入口(任选其一):

  1. 系统设置:设置 → 应用 → 安全出行 → 显示 / 启用图标(系统级路径,不依赖本 App 任何组件);
  2. 控制中心磁贴:下拉控制中心点「自动跟随步行」磁贴 —— 图标隐藏时磁贴会临时变成恢复入口,点一下直接打开本 App,在首页关掉开关即可;
  3. adb 兜底:adb shell am start -n io.github.wumisc.safewalk/.MainActivity。

🎨 界面

3.0 把视觉层收敛成一套语义 token + 一套版式,深色模式不再是补丁:

  • colors.xml 只保留语义命名(bg / card_bg / text_primary / text_body / text_hint / divider / chevron / primary …),values-night 逐项覆盖,只换值不换名
  • 布局与代码一律读资源,没有一处硬编码色值,切换到深色不会再出现「白底刺眼」或「卡片与背景同色」的情况
  • 全部二级页面统一为「卡片 + 行列表」版式:左侧标题、右侧说明与 chevron,分隔线内缩对齐
  • 底部导航为 Compose 液态玻璃,选中态跟随左右滑动实时联动,深色下自动切换前景色
  • 窗口统一 forceDarkAllowed=false,避免系统二次压暗把自定义配色弄脏

⚙️ 核心机制

步态检测(跑在应用进程 WalkPreviewService,不在 SystemUI):靠五重门槛层层收敛—— 幅值上限挡大瞬态、步频窗口 0.52.5Hz、主轴稳定一致率 ≥70%、步数门槛 N、断步重置。 自适应阈值:最近 60 样本 均值+1.8×标准差,钳制 0.62.8 m/s²。

行走模式:SystemUI 只做「指挥」(传感器/步态/显隐广播),App 前台服务负责开相机渲染。 两种形态:全屏叠加(穿透)/ 角落小窗(150×260dp),形态/位置/透明度实时可调。 重启不用重新拨开关:服务被杀或设备重启后,亮屏解锁时 Hook 会经一个透明中转页把预览重新拉起 (绕开 Android 14+ 对 camera 类型前台服务的后台启动限制),无需手动进入 App 操作。

手电筒:夜间提醒通知直接开灯(setTorchMode,无需相机权限);TorchCallback 全局状态同步; 静置超时提醒关灯省电;夜间暗光(<15lx)可自动开灯。

车祸预警:合加速度超阈值且连续 2 次命中判定撞击,60s 冷却防误报;三档灵敏度(1.5/2.0/2.5g); 全屏急救卡 + 60s 倒计时,超时先发含位置短信、再拨紧急联系人,无权限时降级跳转不静默失败。

通知:统一高优先级 IMPORTANCE_HIGH heads-up,可被 HyperOS 超级岛拦截;各通道独立冷却。


📱 国产 UI 适配(小米 / 荣耀 / OPPO / vivo / 华为 / 魅族 + 原生)

功能主干与 ROM 无关:Hook 有 ActivityThread 兜底、前台服务三档降级、悬浮窗显示前复核、 磁贴绕过后台启动限制 —— 这些都不查表。表只管一件事:把用户送到该去的设置页。

自启动 / 后台弹窗这类开关没有公开 API,只能指路。指路表按本机 UI 选候选,运行时逐条 resolveActivity 校验,打不开就换下一条,全失败退应用详情页:

候选(component / action)→ 校验 → 打开 → 换下一条 → 应用详情页兜底

首页那张「系统 UI 适配」卡片只有两行:一行注明本机被识别成哪一家(自动还是手选), 一行七个芯片——自动 / 小米 / 荣耀 / OPPO / vivo / 华为 / 原生。手选只影响「指路与文案」, 不影响功能链路:功能永远在运行时试,不靠版本表判定。

4.3.0 起删掉了原来的「HyperOS 版本适配(自动 / HOS3 / HOS4)」。那三个芯片选的是版本, 而三个真正影响功能的策略(前台服务类型、手电、悬浮窗权限)返回的都是与版本无关的常量, os 参数一次都没被读过——让用户为一个不影响行为的选项做决定,只是困惑来源。 版本号识别(HyperOsCompat.detect())仍保留,但只用来写一句日志。

首次安装的权限引导页会显示「本机 UI:X · 自启动在『…』」,第 4 步按钮也按本机系统名生成, AOSP 上直接写「本系统无此开关(无需设置)」。

图标是矢量三层:渐变背景 + 矢量前景 + 独立 monochrome 剪影。有单色层,桌面开 「主题图标」时本应用才会和其他应用同一风格,而不是被系统糊成一个灰块;主体全部收在 半径 33dp 的安全区内,圆形 / 方圆 / 水滴遮罩都切不到。

关于 targetSdk:停在 35(= Android 15 = HyperOS 3 基座)。Android 16 的破坏性变更 (强制 edge-to-edge、大屏忽略方向、预测性返回默认开启)绝大多数是 targetSdk 36+ 才生效, 停在 35 意味着它们不会作用到本应用。完整矩阵见 docs/hos4-impact.md。

适配进度与真机验证状态见 docs/rom-support-matrix.md: 🟡 表示代码就绪但未真机验证,不会写成「已支持」。华为一列是 4.3.0 新加的, 两条自启动路径只做了静态核对;HarmonyOS NEXT 不兼容 Android 应用,不在适配范围内。


🔁 行走模式保活:被杀了会自己回来

「行走模式运行中」是前台服务通知,通知消失通常意味着服务被系统回收了。4.4.0 起不再只靠 START_STICKY:SystemUI 里的 Hook 每 2 秒巡检,服务每 30 秒发一次心跳,连续 90 秒收不到且开关仍 开着,就自动重新拉起服务 —— 通知会重新出现,并给出一条「已自动恢复」回执。框架没加载时还有 开机 / 解锁 / 覆盖安装 / 划任务自检的静态兜底。

两种「通知消失」要分开看:渠道被关掉时服务其实还在,现在会另发一条提示并给出通知设置入口; 点常驻通知也能直接回主界面确认状态。完整设计、时序与明确做不到的边界(强制停止、深度清理、 后台启动限制、尚未真机验证)见 docs/keepalive.md。


🚀 安装

  1. LSPosed 中启用「安全出行」
  2. 作用域只勾「系统界面(SystemUI)」
  3. 重启系统界面(或重启手机)
  4. 打开 App,授予「身体活动」权限(Android 13+ 另有通知权限)
  5. 打开首页总开关,再按需进二级菜单配置

🔧 编译

工具链(版本不匹配会直接报错,不会静默降级):

项 要求 说明
JDK 21 Miuix 是 Java 21 bytecode(class 65),JDK 17 会报错
Gradle 9.6.0+ AGP 9.4.1 的下限是 9.6.0;仓库已附带 Wrapper,无需自备
Android SDK Platform android-37.2 compileSdk 37 对应新的 minor 版本平台
Build-Tools 36.0.0 AGP 默认;缺失时会自动下载
# 只需指定 JDK 与 SDK,其余交给 wrapper
export JAVA_HOME=<jdk21 路径>
export ANDROID_HOME=<sdk 路径>
echo "sdk.dir=$ANDROID_HOME" > local.properties

./gradlew :app:assembleDebug        # Windows: gradlew.bat

产物:app/build/outputs/apk/debug/app-debug.apk

首次编译会拉全量依赖,约 1.7 GB、十几分钟(取决于网络);之后增量构建只要几十秒。 若 ./gradlew 卡在下载 Gradle 发行包,说明 services.gradle.org 不可达, 可自行下载 gradle-9.6.0-bin.zip 放进 ~/.gradle/wrapper/dists/gradle-9.6.0-bin/<hash>/, 或者直接用本地安装的 Gradle 9.6.0 执行同样的命令。

🧪 测试

  • 步态判定:纯 JVM 单元测试 GaitDetectorPureTest,无需真机/外网
  • 界面与逻辑:Robolectric 本地测试 ./gradlew :app:testDebugUnitTest(首次需联网拉依赖)
  • 界面截图:UiShotTest 用 Robolectric 原生渲染把二级页面在浅色/深色下各出一张 PNG,落到临时目录供目视核对

当前共 10 个测试类 / 62 个用例,全部通过(GaitDetectorTest 13、SubPageTest 13、GaitDetectorPureTest 8、NotificationTargetTest 7、StabilityTest 6、MainFlowTest 5、PreviewWindowTest 4、CrashDetectorTest 2、DiagLogTest 2、UiShotTest 2)。


⚠️ 已知限制

# 问题 影响 状态
1 依赖加速度计持续监听 极端后台策略下传感器回调可能被掐断 前台服务缓解
2 全屏叠加个别 ROM 不出画面 已限定透明窗口路径,仍可能被厂商悬浮窗策略拦截 待真机反馈
3 车祸检测靠加速度阈值 手机脱落可能误报,留 60s 倒计时可取消 设计取舍
4 配置 Provider 白名单基于包名 包名被冒充可读开关(不含隐私字段) 残余风险可接受
5 实验区入口是长按「关于」页按钮 新用户找不到 刻意保留
6 六家厂商均无真机验证 兼容性结论来自代码路径 + 清单 + 单测,非实机 已知边界,日志可定位
7 保活是「被杀后自动恢复」而非「永不被杀」 强制停止 / 深度清理 / 未加白名单仍可能杀进程,且复活链路未真机验证 见 docs/keepalive.md

🎖️ 致敬

项目起源 · 祖师爷 —— 「用后置摄像头透视路况」这一思路的最早实践者,本项目由他们发源:

  • 宋思雨(Song Siyu)· Transparent Screen(2012) —— 宋思雨是 2012 年 Transparent Screen(包名 com.ellipselab.android.transparentscreen.free,2012-03-14 发布)的作者,也是「边走路边看手机、用后置摄像头透视前方」这一玩法的最早提出者,本模块「路况预览」由此发源。开山之作。
  • dhiru1602 · NamelessROM On-The-Go Mode —— 把透明屏幕做进 ROM 的先驱,用一个快捷开关让系统整体半透明,证明这条思路可以深入系统层。

建立在 LSPosed / Xposed 之上,算法与架构思路参考:

  • UI 液态玻璃(本项目底部导航栏直接集成):Kyant0/AndroidLiquidGlass —— 液态玻璃材质、拖拽阻尼交互、透镜折射、交互高光全套特效;配套渲染库 io.github.kyant0:backdrop-android
  • 步态检测:bagilevi/android-pedometer、mdeguzis/StepCounter、ashishb/android-step-detector、AccStepCounter、SensorFusion
  • 状态机/传感器:tonyo567/hysteresis-state-machine、p-v/Android-SensorService、UrbanBigDataCentre/meowmotion、KalebKE/FSensor
  • HyperOS 通知:HyperBridge、WidgetEnhancer、HyperLight

所有代码为独立手写重构,仅借鉴思路与算法原理,未直接拷贝上述项目源码。


📄 许可证

AGPL-3.0,见 LICENSE。

Releases

11/19/2026, 2:52:52 PM

SafeWalk v5.5.1 稳定版(versionCode 86)

重要:签名变更,升级方式

本版本起使用独立私有签名(CN=SafeWalk,RSA4096,SHA-256 5f1331d0…),与旧版签名不同,无法直接覆盖安装:

  1. 打开旧版 → 急救卡 → 导出(保存 JSON 文件)
  2. 卸载旧版 → 安装本版 → 急救卡 → 导入
  3. 重新在 LSPosed 中勾选模块并重启 SystemUI

本版更新

  • 步态判定强化:连续行走最低 8 步 + 8 步≥3 秒跨度闸,根治手机晃动/伸懒腰/翻身导致的误触;夜间手电等既有功能不受影响
  • 磁贴还原:行走磁贴恢复为「常显 ↔ 自动跟随」纯切换,移除"点击进 App"分支(通知栏与 LSPosed 均可直达 App)
  • 急救卡导出/导入:SAF 文件通道,JSON 格式(schemaVersion=1),迁移/备份更安心
  • 私有签名:不再复用 debug 密钥,正式构建独立 keystore(密钥文件不入库)
  • 879 项单元测试全部通过

安装

  • 下载下方 APK,仅支持 Android 13+(minSdk 33)
  • LSPosed 作用域:系统界面(SystemUI)+ 本模块自身

校验

  • APK SHA-256: f37337dde7fdc94640f43135b6d1e6a57104dbfe1e22df000c3dd874a46c03a9
  • 签名 SHA-256: 5f1331d0…(CN=SafeWalk)

Assets

1

11/18/2026, 8:16:33 AM

5.5.0(85)稳定版 — 2026-11-18

本 Release 资产已更新为正式 Release 构建(safewalk-v5.5.0-release.apk)。相对此前的 debug 包:非 debuggable、移除调试冗余;沿用同一签名(SHA-256 cf0da72d…),可直接覆盖安装、不丢急救卡加密数据。minifyEnabled false 保留以保护 Xposed hook 的反射与固定类名。817 单测全过。

功能级大版本:医疗急救卡 + 省电专项 + 桌面图标/最近任务隐藏。设计文档见 docs/emergency-medical-card-{PRD,ARCH,ARCH-v1.1}.md。

🚑 医疗急救卡(五大需求)

  1. 车祸预警:保留 CrashDetector 检测骨架,叠加 CrashFusionPolicy 二级融合(速度突变 Δv + 姿态 + 屏幕 + 跌倒排除)降误报。
  2. 锁屏强提醒(四路并用):SystemUI 覆盖层 + 全屏 Activity + FSI 通知 + 关闭遮挡对话框;覆盖层直接渲染关键医疗字段(姓名/血型+Rh/过敏★/疾病/主联系人/年龄,红底 ≥18sp)。
  3. 系统 SOS 联动:候选 Intent 链 + resolveActivity 校验 + ACTION_DIAL 预填 120/110,不静默代拨。
  4. 急救卡字段:血型+Rh/住址/过敏/≥3 联系人/医保/捐献/QR,EncryptedSharedPreferences 加密存储 + 旧明文幂等迁移。
  5. AED 导航:本地 GeoJSON + 500m Haversine 检索 + geo: 步行引导;无数据/无定位 100% 提示拨 120(断网可用)。

🔐 隐私(受控放宽)

  • 医疗源数据永不跨进程/落盘/进日志;ConfigProvider 白名单零医疗字段。
  • 唯一例外:撞击确认后经独立 DisplayProvider 一次性通道(一次性 token 用后即焚 + TTL 20s + system uid/包名双鉴权 + 载荷最小化)送最小字段集到 SystemUI 内存渲染,Activity 可见即退场。两通道物理隔离。
  • 覆盖层直显医疗信息是用户裁决(救助效率优先),20s 窗口内锁屏可见,设置页已明示。
  • 「100%」边界:设备开机 + SystemUI 存活;关机/没电/SystemUI 崩溃不承诺,降级为撞击瞬间预发 SMS 回执。

🔋 省电专项

  • 镜头切换原地换视野:逻辑摄像头机型切主摄/0.6x 超广角只重下发 CaptureRequest,不再 close→open 整个相机 HAL。
  • 前台服务 goForeground 幂等,避免设置页操作时同一秒重复 startForeground。

🙈 桌面图标隐藏 / 最近任务隐藏(首页双开关)

  • 桌面图标隐藏:activity-alias 双别名原子切换;恢复入口四路(LSPosed 模块首推 / 系统设置 / 磁贴 / adb),经 INFO 入口不依赖桌面图标。
  • 最近任务隐藏:运行时 AppTask.setExcludeFromRecents + FLAG_ACTIVITY_EXCLUDE_FROM_RECENTS。

验证

  • 全量单测 817/817 通过(0 失败);Q4 六组安全测试 + 四层安全机制 + 隐私功能测试全覆盖。
  • 真机诊断日志复核无新 bug(HyperOS 4 / SDK 37):急救卡编辑/保存/QR、覆盖层安装、显示客户端安装、升级 v85 重启 SystemUI 均正常。
  • 稳定版 SHA-256:691c4984643df0fdf9caf953a192c704594f8035efdc5f57e48672ec1b1aaf6f

覆盖安装即可,无需卸载。安装后若提示「重启系统界面」,点一下使 Hook 生效。

Assets

1

11/17/2026, 1:48:51 PM

本版内容(累积 5.4.15 / 5.4.16)

  • 小窗自定义新增三项手动方向选择:横屏窗口形状、竖屏窗口形状、后摄转正方向(上0°/右90°/下180°/左270°),放弃自动推断。竖条窗口保持恒不转。
  • 控制中心磁贴改为真正的「自动跟随步行开关」:熄灭后画面常显、不停服务。
  • 后摄转正方向默认改为 left(270°),新装用户横屏开箱即正、无需手选;已配置用户零影响。
  • 应用图标重画为深色风格 + 正面开心小女孩 + 左手✌️剪刀手 + 右手透明伞(矢量 adaptive icon,含主题单色层)。

质量

全量单测 724/724 全绿;assembleDebug 构建;独立审查 APPROVE、0 阻断问题。

校验

  • versionCode 81 / versionName 5.4.16
  • SHA-256: c3c5ddd830698cca1cedf59facdf47ff6159ffaa3ac2c863bdca575b40347ca0

详见 CHANGELOG.md。

Assets

1

11/16/2026, 4:20:06 AM

5.4.0(65)稳定版:竖屏折中填充收窄黑边,累积判停 / 自动跟随修复

竖屏方向已修正。本版把竖屏画面从大留白改为折中填充:中心放大 2.0x,水平保留约一半路面视野、上下留约 17% 窄边——既不再是 5.3.7 的大留白,也不像硬铺满那样把左右裁掉三分之二。方向层、横屏路径、手动取景、相机 buffer 策略均未改动。

同时累积发布此前未上线的两处修复:

  • 5.3.8(63) 自动跟随步行走路时被误判停下收起:判停改用 GaitDetector.stepActivityTs() 时钟,修掉伪增量导致判停被关掉的问题。
  • 5.3.9(64) 开关从常显切到「自动」后常显窗不消失、步态显隐拿不到控制权:新增一次性显示权交接 handoffToAutoMode(),收起常显窗并复位步态状态,以步态为准显隐。

验证:全量 JVM 单测 449/449 全过(43 类,0 失败 / 0 错误 / 0 跳过)。

升级提示:LSPosed 模块更新后如行为未变化,请重启 SystemUI 或手机,让注入进程加载新类。

Assets

1

11/15/2026, 7:06:13 AM

5.3.5(60)上一版的 90° 校正被自己关掉了:这台机器把传感器读成 0°

5.3.4 装上去,用户回了一句「方向还是不对」,截图里是横条小窗,画面却是竖着
的路面 —— 跟上一次的竖条小窗 + 横向画面正好差 90°。两张截图拼起来,答案就只剩一个:

姿势 窗口 公式算出的旋转 实际看到
竖握 pose=0 竖条 488×845 0 − 0 = 0° 横向路面,歪头看
横握 pose=90 横条 845×488 0 − 90 = 270° 竖向路面,同样歪头

两个式子里的第一个 0 是 SENSOR_ORIENTATION。也就是说,这台 Redmi M332BF
(HyperOS 4)把后摄的传感器朝向读成了 0,而公式又是拿它做减法的被减数,
于是整条链路恒定偏 90°。

上一版为什么没修好:我给自己留了个口子

5.3.4 的 alignToWindow 逻辑是对的,但加了一条豁免:

val sensorCrossMounted = ((sensorOrientation % 180) + 180) % 180 != 0
if (!sensorCrossMounted) return normalized   // 传感器竖装 → 跳过校正

当时想的是「竖装传感器(0/180)的机型竖条窗口本来就该转 0°,硬补 90° 会弄坏」。
这台机器恰好把后摄读成 0,于是校正被整条跳过,现象原样保留。

教训很直接:当一个整数读数的用途是「给另一个整数做减法」时,它报 0 就必须
当成「未知」,而不是「等于 0」
。而这个字段没有任何办法验证真假 —— 它自己
就是被验证的对象。

修法:只认窗口形状

窗口是竖条还是横条,由重力姿态决定,不需要任何相机参数,也是用户肉眼已经
确认过「形状没问题」的那一项。所以旋转角只按它对齐:

  • 竖条窗口 → 画面宽高必须交换,旋转只能是 90 / 270;
  • 横条窗口 → 画面宽高不能交换,旋转只能是 0 / 180。

矛盾就补 90°。alignToWindow 去掉 sensorOrientation 参数,用两个输入就能
决定一切。相位(0 与 180 的差别,也就是「翻转 180°」这一档)在校正中保持不变,
所以用户选了翻转仍然看得到倒过来的画面。

顺手把「方向参数」挪到一定看得见的地方

上一版新加的 方向自洽 | 窗口=… 传感器=… 实转=… 单独占一行,真机日志里
一次都没出现过 —— 它和窗口挂载同一时刻打,赶上日志文件轮转就整段没了。
这次把它挂到首帧那一行上(这行每次都有):

[cam] ✅ 已收到画面 | 窗口=竖条 488x845 传感器=0° 姿态=0° 实转=90° 缓冲=1920x1080

五个数一次说清:窗口形状、传感器读数、姿态、实转角、缓冲尺寸。下次再遇到
朝向问题,一行就能定位是传感器读歪、姿态没样本,还是矩阵没跟上。

测试:391 用例 / 41 类,0 失败。新增/改写:

  • sensorReadingZeroNoLongerSkipsCorrection —— 直接复现本次真机输入。
  • everyCombinationKeepsWindowShapeAndRotationInSync —— 改为穷举 8 组
    (原始角 × 窗口形状),并额外锁一条:同一窗口形状下互差 180° 的输入,
    输出也必须互差 180°,防止校正把「翻转 180°」吃掉。

Assets

1

11/15/2026, 6:40:06 AM

5.3.4(59)小窗形状对了,画面却差 90°:竖屏看到横屏内容

5.3.3 把「画面缩成一小块」修掉了,用户确认「小窗全屏显示了」,但紧接着报出新现象:

竖屏看的是横屏的内容,横屏看的是竖屏的内容。横屏说实话没毛病,但是竖屏
真的是看得很费劲。

两张截图把状态说得很清楚:竖着拿时窗口是竖条(形状对了),里面却是一张
被裁掉两侧的横向路面,得歪着头看;横着拿时窗口是横条,画面正立,所以「没毛病」。

一、形状与画面来自两条链路,谁也不知道对方算出了什么

依据 结果
窗口是竖条还是横条 重力姿态(DevicePosePolicy) 截图里是对的
画面转多少度 传感器方向 − 屏幕方向(rotationDegrees) 算出 0°,不转

两条链路各自都"没抛异常、没报错",合起来就是 90° 错位。竖条窗口 + 不旋转 =
1920×1080 的横向画面按竖窗比例铺满,两侧裁掉大半 —— 正好是截图 2 的样子。

日志这次帮不上忙:[cam] 是 SystemUI 侧打的,回传时只截取了 2553 字符,
方向 | 传感器=… 实转=… 那行根本没到(连 5.3.3 新加的 姿态监听已启动 都没出现,
只剩 [cam] 窗口已挂载 … 5.3.3(58))。所以这次不靠日志推断,改用一个
用户肉眼已经验证过的事实做判据。

二、修法:用「窗口形状」反过来校正旋转角

物理事实:后摄传感器绝大多数横装(SENSOR_ORIENTATION = 90 或 270)。横装意味着

  • 窗口竖条 → 画面宽高必须交换,旋转只能是 90 / 270;
  • 窗口横条 → 画面宽高不能交换,旋转只能是 0 / 180。

PreviewOrientationPolicy.alignToWindow(deg, landscapeWindow, sensorOrientation)
按这条判据复核:算出矛盾就补 90°。窗口形状是用户直接看到、并且已经确认
「形状没问题」的那一项;传感器方向是读出来的整数,读错了没人发现。

传感器竖装(0 / 180,少见但真实存在)不参与校正 —— 那种机型竖条窗口
本来就该转 0°,硬补 90° 会把原本正确的画面弄歪。

三、把「什么时候算的」也堵住

applyFraming() 里加最后一道闸:不看任何缓存,直接用此刻真实的视图宽高
复核一次旋转角(姿态回调、窗口重排、Surface 尺寸变化是三个不同时序的事件,
中间任何一处用旧值,画面就差 90°)。

同时补上一个一直存在的时序缺口:onSurfaceTextureAvailable 里先 applyFraming()
再 openCamera(),方向是在 openCamera 内部才算出来的,算完没有任何一次
矩阵重算 —— 只要窗口尺寸不变就会一直挂着。现在 resolveOrientation() 之后
立刻再 applyFraming() 一次。

单测新增 alignToWindow 一组(真机复现的竖条+0°、已自洽不动的四种、横条被误转的
两种、竖装传感器不校正、脏角度归一),外加一条穷举 24 种组合的断言:
横装传感器时,交换位必须与窗口形状一致。

测试:391 用例 / 41 类,0 失败;lint 505 条全部为存量告警,0 error。

Assets

1

11/15/2026, 5:58:31 AM

5.3.3(58)画面缩成一小块 + 小窗反复收起再弹出

真机日志(2026-11-15 13:28~13:46,1032 行)暴露两件事,都不是"方向算错"。

一、画面只占窗口的一小块,四周大片空

TextureView.setTransform() 收的矩阵作用在窗口坐标上——系统绘制前已经
把相机缓冲按 (viewW/srcW, viewH/srcH) 非等比拉伸铺满了整个 View。
旧代码却把"源像素 → 窗口像素"的绝对映射直接交给它,等于在已经铺满的
画面上再缩一次:

场景 旧 scale 结果
1920×1080 缓冲 / 488×845 竖窗 / 转 90° 0.45 画面缩到四成,贴左上角
同上,取景拉满 0.45 × 2 仍不满窗口

修法:先按 (srcW/viewW, srcH/viewH) 把输入坐标逆拉伸回源像素,再接
原来的"旋转 + 等比铺满 + 取景"。取景一步作用在窗口坐标,不参与逆拉伸。

单测新增 rotatedBufferStillCoversWholeWindow:源图四角换算到窗口坐标后,
包围盒必须完整包住整个窗口——这条断言就是真机那一眼的固化。

二、小窗反复收起又弹出

日志里一个完整循环,13:30 那次:

13:29:56  窗口挂载
13:30:05  计步回调 walking=true(此后用户站着没动)
13:30:12  静置超时 8s → 收起
13:30:15  计步回调 walking=false
13:30:17  冷却 5s 到期 → 再次挂载

两处叠加:

  • 判停门槛 8 秒 < 步态回调周期 10 秒。门槛低于回调周期时,每两个回调
    之间必然出现一段"按时间算早该停了"的窗口,于是必然误收。门槛下限提到
    12 秒(一个回调周期 + 2 秒余量),设置页滑块同步改为 12~30 秒。
  • 收起后冷却只有 5 秒,冷却一过,历史累计步仍然达标就立刻弹回。
    冷却提到 30 秒;真走路 30 秒内能攒够"持续判走"要求的步数,照常显示。

三、姿态监听可能一帧都收不到

5.3.1 用 TYPE_ACCELEROMETER,日志里注册没报错、却一个样本都没有——
ROM 会把 SystemUI 这类后台进程的加速度计限流。改为 TYPE_GRAVITY 优先
(系统融合的虚拟传感器,语义相同),拿不到再退回加速度计。

配套把可观测性补齐,下次回传日志一眼能判断:

[cam] 姿态监听已启动(… type=9),等待首个样本
[cam] 姿态首个样本 ax=0.3 ay=9.7 az=1.2 传感器=…
[cam] 手机姿态 → 90°(横条) 样本=42
[cam] ⚠️ 姿态传感器 3 秒内没有回调(…),方向暂按屏幕旋转判断

姿态监听也从"窗口挂载之后"提前到"挂窗口之前":样本要几百毫秒才到,
挂完再测等于第一眼看到的窗口一定是按 display.rotation 猜的(日志里
13:37~13:41 连续五次竖着拿却挂了 845×488 横条)。

四、取景矩阵绕原点缩放的收尾

上一版已改为以窗口中心为锚点,这次把逆拉伸一并合进同一处,并补了
"缓冲尺寸与窗口不一致时也必须铺满"的回归用例。

测试:385 用例 / 41 类,0 失败;lint 505 条全部为存量告警(硬编码文案、apply() 等),0 error。

Assets

1

11/15/2026, 5:37:49 AM

5.3.2(57)修「改了却没生效」:升级也提醒重启 + 版本自证

5.3.0 / 5.3.1 两轮方向修复,真机上都「没变化」。查下来不是代码没改对,是新代码根本没进
SystemUI 进程
:模块在进程启动时注入,覆盖安装只换磁盘上的 APK,那个进程里跑的还是旧类。
而界面上没有任何提示,日志里也没有可以区分版本的证据 —— 看起来就像「修了个寂寞」。

一、日志能自证跑的是哪一版

  • SystemUI 进程 init 收尾打一行 [VER] 模块实际运行版本=5.3.2(57)
  • 小窗挂载日志尾部带版本:窗口已挂载: smallwindow 488x845 … 5.3.2(57)
  • 新增姿态注册回执:姿态监听已启动(加速度计 …),等待首个样本;
    注册被拒会单独打 ⚠️ 加速度计注册被拒。5.3.1 只打了姿态变化,
    真机一片空白时,分不清「没注册」还是「注册了没数据」。

二、覆盖升级也要提醒重启(不只是首次安装)

5.3.0 的判定是「首次安装 且 没点过重启」。升级用户引导页标记早就写完了,
卡片一条都不显示 —— 于是升级等于没升。判定改成 versionCode 是否变大:

  • 引导页卡片:首次安装 / 更新后两套标题与文案,归因分开写
    (首次是「模块还没加载」,升级是「进程里跑的是上个版本」)
  • 首页补一次提示:升级后打开 App 会弹「重启系统界面」对话框,带立即重启按钮,
    不用自己摸进权限页;点「稍后再说」不拦人,下次启动再问
  • 确认标记从布尔改成 versionCode,同版本不再重复打扰

三、测试

新增/改写 RestartReminderPolicyTest 11 例:版本比较、首次与升级的区分、
文案归因、日志描述;总计 384 用例 / 41 类,0 失败;lint 0 error。

Assets

1

11/15/2026, 4:45:49 AM

5.3.1(56)方向改按重力判断 + 小窗跟着换形状

5.3.0 的方向是「修对了原理,挂错了信号」,这一版把信号换掉。

一、为什么 5.3.0 的方向没生效

5.3.0 用 Display.getRotation() 判断手机朝向。用户回传的日志(2026-11-15,
2.5 小时,1637 行)里只有 SCREEN_ON / SCREEN_OFF,一次方向变化都没有 ——
手机开着「旋转锁定」,这个值恒为 0。于是:

  • 手机横过来,系统不转 → 预览也不转 → 画面侧躺;
  • 竖着拿时窗口是 150×260 的竖条,横向的传感器画面塞进去只剩中间一条,
    两侧大片空 —— 这就是「一小块,空余很大」。

旋转锁定是走路时的常态(很多人常年开着),所以朝向必须自己测,
不能问系统要。

二、改成重力判断

新增 DevicePosePolicy(纯逻辑,可单测):

环节 做法
取朝向 加速度计重力向量,θ = atan2(ax, ay),四舍五入到 0/90/180/270
防抖 迟滞 8°:离开当前朝向不足 53° 不换,手腕轻摆不会来回切
防过冲 驻留 450ms:新朝向连续保持 450ms 才生效,转身瞬间不跳
平放 |az| > 7 且明显大于 ax/ay 时整帧丢弃,保持上一次朝向(桌上平放≠横屏)

窗口挂上才开始测姿态,收起就注销监听,不常驻耗电。

三、窗口本身跟着换形状

以前窗口永远竖着,只转画面内容。现在:

拿法 窗口 画面
竖着 150×260 竖条 转正
横着 260×150 横条 转正(传感器本来就是横的,实转 0°)
倒置 260×150 转 180°

用户调的 150dp 是短边,长边按 150:260 换算,所以横竖切换时窗口面积不变、
只是旋转 90°,不会「横屏忽然变成一大块」。

三档模式语义同步调整:

  • 跟随手机(默认):窗口与画面都跟着重力走,系统开不开旋转锁定都生效
  • 锁定竖屏:窗口永远竖条,画面按竖屏姿势摆(夹在支架上固定横放时用)
  • 翻转 180°:窗口跟随,画面在自动结果上再转半圈(少数 ROM 标定相反)

四、测试

新增 DevicePosePolicyTest(13 例):四象限取角、倾斜 20° 仍判竖屏、
平放识别、迟滞带内连喂 3 秒不换、驻留差 1ms 不换、转身过冲后候选清空、
平放保持上次朝向、reset() 清状态、三档模式下窗口形状取舍、横竖尺寸互换。

Assets

1

11/14/2026, 8:50:56 AM

5.3.0(55)横屏方向重定向 + 首次安装重启提醒

两件事:让横屏时的小窗画面正过来,让新装用户知道还差重启这一步。

一、横过来的手机,画面是躺着的

以前预览的输出缓冲直接写成小窗的宽高:

// 旧代码(5.2.0 及之前)
surfaceTexture.setDefaultBufferSize(view.getWidth(), view.getHeight());

这一行有两个问题叠在一起:

  1. 相机传感器是横着装的(绝大多数后摄 SENSOR_ORIENTATION = 90),
    Camera2 的预览流本身不做任何旋转,它把传感器那一帧原样塞进 Surface;
    旧代码没有做旋转补偿。
  2. 竖屏时小窗是 150×260 的竖条,把 4:3 的画面硬缩成 0.58 的长条,
    路面被压扁;靠这个「巧合」勉强能看。一旦横过来,压缩方向反过来,
    画面就变成侧躺 + 拉长。

所以不是「横屏时才坏」,是横屏时才看得出来。

修法是把方向拆成三件独立的事,三件都放进 PreviewOrientationPolicy(纯逻辑、可单测):

环节 做什么 为什么单独拆
旋转角 传感器角度 − 屏幕角度,归一到 0/90/180/270 只依赖两个整数,能穷举断言
缓冲尺寸 从相机支持的尺寸里挑比例最接近的(640×480 起、1080p 内) 不能写窗口宽高,否则 HAL 必然拉伸
变换矩阵 旋转 → 等比铺满 → 取景裁剪,合成一个 3×3 用「源图四角映射到窗口哪里」断言,比看截图可靠

顺带修了一个相邻的老问题:旋转完成后不会重算。现在旋转角一变就走重算路径,
日志里会留一行,出问题一眼能定位是哪一环:

方向 | 传感器=90° 屏幕=90° 模式=auto → 自动=0° 实转=0° 缓冲=1440x1080

二、小窗自定义页新增「画面方向」三档

不是所有横屏场景都该跟着重力转。手机夹在车把/支架上固定横放、或者躺着看,
自动旋转反而帮倒忙,所以给一个开关:

档位 行为 什么时候用
跟随重力(默认) 按传感器与屏幕实际方向转正 绝大多数情况
固定竖屏 忽略屏幕旋转,永远按竖屏姿势 手机固定横装在支架上
自动翻转 在自动结果上再加 180° 少数 ROM 传感器方向标定相反,画面总是倒的

写错的值一律按「跟随重力」处理,不会因为配置脏了就黑屏。

三、首次安装:还差重启一次系统界面

这是装了说没用的头号原因。SafeWalk 的步态判定、悬浮窗、手电联动跑在
SystemUI 进程里,由 LSPosed 在进程启动时把模块代码注入。安装 APK 只是把
代码放到磁盘上,那个进程还在跑旧代码 —— 用户装完直接点开关,看到的是「毫无反应」。

以前这句话只写在文档里,实际没人读。现在放在权限引导页顶部(装完打开 App 的第一屏):

  • 一张卡片说明「为什么还差这一步」,不是一句「请重启」
  • 一个重启系统界面按钮,走已有的 SystemUiRestarter:Hook 自尽 → su 兜底
  • 有 root / 没 root 两套文案:没 root 时明确写出「如果点了没反应,请手动重启手机」,
    不能让人以为按钮必然生效
  • 点「完成」但还没重启 → 二次确认,把后果说清楚(「开关打开了但什么都没发生」),
    但不拦着(用户可能想先去 LSPosed 勾作用域)
  • 只在首次安装出现:升级安装不弹。每次更新都弹一遍会变成狼来了,
    真正需要重启时(改作用域)用户反而不点了

重启成功落一个独立标记(restartSuiAcknowledged),不复用 onboardingDone ——
引导页可以跳过,而「模块到底加载了没有」是另一件事,混用会导致跳过引导页时提醒也一起消失。

四、测试

新增 PreviewOrientationPolicyTest、RestartReminderPolicyTest,前者锁住
四种旋转角的矩阵行为、尺寸挑选的边界(无候选、全太小、超 1080p)、三档模式叠加;
后者锁住「只在首次 + 未确认时提示」的四种组合与两套文案分支。

Assets

1

11/13/2026, 4:48:14 AM

4.8.0(50)

Flyme(魅族)适配

  • 第 6 家生态入表:RomId.FLYME,含魅蓝 mblu
  • 识别词 meizu / flyme / mblu(只写 meizu 会让魅蓝落到「未识别」)
  • 自启动首选 com.meizu.safe/...SHOW_APPSEC,次选 SmartBGActivity,最后回退应用详情
  • 组件跳转统一附加 packageName extra,Flyme 后台管理页可直达本应用
  • 首页芯片改 两行四列(8 格):360dp 宽机型单行 8 格每格仅约 36dp,连「OPPO」都挤不下

无障碍调试面板(开发者工具)

  • 独立服务 A11yInspectorService(canRetrieveWindowContent=true),与主服务分开授权
  • 事件流:全类型事件 + 时间 + 来源包名 + 控件类名 + 文本
  • 节点树:层级、text、contentDescription、viewId、可点击性、屏幕坐标
  • 无标签统计:可点击但既无文字也无描述的节点数(读屏增强的目标清单)
  • onResume 才采集、onPause 立即停;只进内存 300 条,不落盘不联网
  • 入口:首页「功能实验区」(长按)→「无障碍」

行走语音播报(视力障碍)

  • 走路时用 TTS 轻播来电与重要消息,不弹窗、不遮挡画面,给盲人用户用
  • 复用主无障碍服务,开关打开时才动态订阅通知事件,关闭立即取消
  • 四道闸门:只在行走中 / 只在亮屏 / 尊重勿扰 / 全局 15s + 同源 60s 双重冷却
  • 只识别来电与白名单即时消息,广告推送一律不念
  • 播报走 USAGE_ASSISTANCE_ACCESSIBILITY、语速 0.92,目标是「听得清但不吓人」
  • 智能提醒页新增独立开关(第 7 项)

读屏增强:方案已定,本体下批
新增 docs/a11y-readscreen-plan.md,说明三件事:

  • 无障碍无法替代 LSPosed + root(改 SystemUI / 拦系统弹窗 / 静默授权都做不到)
  • 无障碍无法把补的描述喂给 TalkBack(节点是只读快照,写不回去)
  • 可行路线是自己做读屏助手用 TTS 播报,不与 TalkBack 抢焦点

本轮确认暂不引入 OCR(包体 42MB → 62MB),先做基于 viewId + 类名 + 兄弟节点的语义增强。

验证

  • 单元测试 271 项全部通过(新增 44 项:Flyme 11 / 面板格式化 13 / 语音策略 19)
  • lint 0 Error
  • versionCode 50 / versionName 4.8.0

未做真机验证。Flyme 的自启动组件名、语音播报的冷却体感、面板在复杂页面上的表现,
都需要真机确认。

Assets

1

11/12/2026, 7:49:33 AM

4.7.0(49)

关于页精简

  • 删除「保存壁纸」与「出门踩坑指南」,首页/关于页不再有入口
  • 新增「感谢名单」入口,与「致敬名单」并列

感谢名单(二级页)

  • 圆形头像 + 名字 + 来源 + 一句说明,数据驱动
  • 首批:我是寂寞的花(酷安,配合调试)、小鳥游星野酱(酷安,提出 HyperOS 3 适配问题)

智能提醒 · 低头提醒
参考 Pixel 数字健康 Heads Up。同时满足四条才触发:已确认行走、屏幕亮、屏幕法线与水平面 ≤45°、持续 8 秒;3 分钟冷却。任一条件不成立立即清零,不累积。纯逻辑 HeadDownPolicy + 12 项单测,未改动任何既有步态/防误触判据。

急救卡重构

  • 保存 apply() → commit(),避免点完即退丢失
  • 空卡拒绝保存;电话有效数字不足 5 位提示
  • 新增「过敏史」「慢性病 / 长期用药」两项医疗关键字段
  • 诚实说明「锁屏时看不到这张卡」,并提供一键复制,方便粘贴进系统紧急信息
  • 车祸预警权限状态可视化(权限 X/4 · 缺少…)
  • 隐私边界不变:急救卡字段仍不进入 ConfigProvider 白名单

验证

  • 单元测试 227 项全部通过(新增 12 项 HeadDownPolicy)
  • lint 0 Error
  • versionCode 49 / versionName 4.7.0

未做真机验证;低头提醒的 45°/8 秒/3 分钟为经验值,实机体感可能需要微调。

Assets

1

11/11/2026, 3:30:22 PM

4.6.0(48)支持捐赠页改版

双码并列
支付宝 / 微信两个收款码由竖排改为等宽双列并排,一屏同见两码;长按仍可保存到相册。

捐赠名单(头像 + 名字)
二维码下方新增「捐赠名单」区块,数据驱动渲染:圆形头像(无图时用名字首字母徽标,色相轮换;有图时圆形裁切)+ 名字。当前尚无捐赠者,展示空状态提示,不渲染空容器。

一并包含 4.5.0 修复

  • 日志洪泛:hardwareStepConfirm() 的 n == 0 分支按帧直写日志导致一秒 80+ 条,改走 DiagThrottle 统一节流
  • 步数探针误报:区分「原始回调数」与「合格步数」,有回调无步不再误报传感器失效
  • 复活即收起:新增 sessionStartTs 会话基线,旧会话时间戳作废,新会话 30s 宽限

验证

  • 单元测试 215 项全部通过(新增 31 项)
  • lint 0 Error(325 Warning 为历史存量)
  • versionCode 48 / versionName 4.6.0

说明:本轮为 UI / 展示变更 + 日志链路修复,未改动计步、防误触、保活的任何判定逻辑。未做真机验证,建议刷入后复现验证。

Assets

1

11/11/2026, 10:19:44 AM

[4.4.0] - 2026-11-11 通知消失能自己回来:行走模式看门狗保活

一、问题

用户反馈:「保活还是不够,这个通知消失,就证明行走模式停止运行了」。

截图里那条「行走模式运行中」是 WalkPreviewService 的前台服务通知。服务被杀 → 系统撤销通知,
这个判断基本成立;但反过来不成立:通知渠道被关掉 / 被 ROM 折叠时,服务还活着,通知同样会消失。
两种情况用户看到的是同一个画面,却需要完全不同的处理。

更关键的是,4.3.1 之前服务一旦被杀就没有任何可靠的自动恢复路径:

手段 实际情况
START_STICKY 国产 ROM 一键清理 / 电池优化后基本不重建
Hook 开机自启 autoStartLaunched 一次性标志,每个 SystemUI 进程只拉一次
Hook 每 60s 补发 SHOW 发给 App 的动态接收器,进程死了就没人收,也拉不起进程
开机 / 解锁 / 划任务兜底 不存在

二、这一版做了什么

  1. 心跳看门狗(主力):服务每 30s 向 SystemUI 发一次心跳;Hook 每 2s 巡检,连续 90s
    收不到且开关仍开着,就重新拉起透明 AutoStartActivity 合法重启 camera 前台服务。
    判定与冷却抽成 KeepAlivePolicy(纯逻辑,新增 15 条单测)。
  2. 静态兜底(第二条腿):KeepAliveReceiver 监听开机、覆盖安装、解锁(尽力而为)与划任务自检,
    框架没加载 / SystemUI 正在重启时也能恢复。
  3. 通知渠道自检:检测到 safewalk_walk 被设成 IMPORTANCE_NONE,换 HIGH 渠道明确提示
    「服务还在,只是通知不显示了」,点击直达应用通知设置。
  4. 常驻通知可点击:原来没设 contentIntent,点了没反应;现在点击回主界面。
  5. 自动恢复回执:被杀后重新拉起会弹「已自动恢复」,10 分钟内最多一条。
  6. 顺手修两处:onDestroy 清掉 INSTANCE 弱引用(isAlive() 原本会短暂误报);
    AutoStartActivity 用 App 自己的 SP 再判一次开关,防 Hook 的 60s 配置缓存滞后误启。

三、诚实的边界

  • 做不到「永不被杀」:用户手动「强制停止」后系统把应用标为 STOPPED,广播与闹钟都不再投递;
    ROM 深度清理 / 未加电池白名单仍可能杀进程。这套机制做的是「被杀后尽快自己起来」。
  • 从广播 / 闹钟里拉透明页受 Android 10+ 后台启动 Activity 限制,可能被拦;主力仍是 SystemUI 看门狗。
    心跳显式投递到 com.android.systemui(并补 com.miui.systemui 变体);若 ROM 用第三种包名,
    看门狗进入「盲区」模式把重试压到 3 分钟一次,不会每 90 秒闪一下透明窗。
  • 用户关掉开关绝不复活:KeepAlivePolicy.desired() 只认 masterEnable && enableRearCamera,
    两条关闭路径都会把后者写成 false。
  • 全部未真机验证:本轮只有静态核对 + 184 条单测(新增 15 条)+ lint + APK 产物校验,
    没有真机复现「杀进程 → 自动恢复」。详见 docs/keepalive.md。

四、怎么看有没有生效

diag.log 里搜 [keep]:收到心跳、判定失联、拉起透明页、自动恢复回执都会留痕。

Assets

1

11/11/2026, 3:12:21 AM

SafeWalk 4.3.0 国产 UI 适配封面

[4.3.1] - 2026-11-11 修订更新说明(代码与 4.3.0 完全一致)

这版没有功能改动,改的是「给人看的字」。GitHub Release 的说明就是用户眼里的更新说明,
写不准比不写更糟,所以单独发一版把它改对。

位置 之前 现在
4.3.0 说明 · 华为路径 「EMUI 5 到 HarmonyOS 4 都是这条」——读起来像已经验过 「社区与既有代码显示…,未真机验证」
4.3.0 说明 · 测试数 「…共 169 条全绿」——读起来像新增 169 条 「本轮新增/改写 5 条;全套 169 条通过」
4.3.0 说明 · 范围 「另外四家用户」 「其它厂商的用户」(现在是五家 + 原生)

两条为什么要较真:

  1. 「都是这条」会让人以为华为已经验过。实际两条自启动 component 只做过静态核对,
    真机上命中哪一条还不知道;写成肯定句,等于把 🟡 说成 ✅。
  2. 「169 条」是总数不是增量。本轮真正新写的是 5 条断言,其余 164 条是既有回归;
    混在一起写,会让后来的人误判测试覆盖的实际增量。

安装包与 4.3.0 功能完全相同(versionCode 45,可直接覆盖安装,无需卸载)。
唯一区别是 versionName 与这份说明——留着旧包的用户不必重装。

Assets

2

11/10/2026, 11:43:05 PM

[4.3.0] - 2026-11-11 首页改成「五厂商 + 原生」两行,删掉 HyperOS 版本选择

一、为什么删「HyperOS 版本适配」

那三个芯片(自动 / HOS3 / HOS4)选的是版本,而三个真正影响功能的策略函数
(前台服务类型 / 手电 / 悬浮窗权限)返回的都是与版本无关的常量,os 参数一次都没被读过。
让用户为一个不影响行为的选项做决定,只是困惑来源;更糟的是,它让其它厂商的用户看到一张
「HyperOS 版本适配」卡片,既不知道跟自己有没有关系,也不敢点。

现在改成「哪一家 UI」——这件事确实影响行为:决定自启动页跳哪儿、引导第 4 步文案怎么写、
用哪张相机包名表。版本识别(HyperOsCompat.detect())保留,但只写日志。

二、界面:严格两行

行 内容
第一行 一行注明:「本机 UI:ColorOS · 自动识别」/「本机 UI:HyperOS · 手动指定(仅影响指路)」
第二行 七个芯片:自动 · 小米 · 荣耀 · OPPO · vivo · 华为 · 原生

芯片上写厂商短名而不是 UI 全名:360dp 宽的机器每个芯片只有约 43dp,
「OriginOS」「HarmonyOS」放不下;UI 全名在上一行注明里给。仍然保留 autoSizeTextType,
窄屏再缩字号也不会截成「Orig…」。

三、补上华为(EMUI / HarmonyOS 4 及更早)

RomId.HARMONYOS + 独立档案:自启动首选 com.huawei.systemmanager 的
StartupNormalAppListActivity(社区与既有代码显示 EMUI 5~HarmonyOS 4 都是这条,未真机验证),备选旧的
ProtectActivity,外加应用详情页兜底;相机包名 com.huawei.camera。

判定加了 huawei / harmony / emui 三个关键字,并排在荣耀之后:荣耀老机型的
MANUFACTURER 还是 HUAWEI、BRAND 是 HONOR,两个关键字会同时命中,
顺序保证它落在 MagicOS(那正是 MagicUI 的档案)而不是华为。这条有单测锁着。

HarmonyOS NEXT(5.0 起)不兼容 Android 应用,本模块根本装不上,不在适配范围内。

四、文案:别把三星说成「原生」

三星 One UI、摩托 MyOS、索尼都落在 AOSP 兜底,但如果在首页写「本机 UI:原生」,
用户第一眼就知道不对。现在这种情况写「未识别系统 UI · 按原生处理(可手动指定)」,
既说了实话,也暗示可以往下手动指定。

五、顺手清掉的技术债

  • MainActivity 里芯片 key 数组原本在「绑定点击」与「刷新高亮」两处各写一遍,
    漏改一处就变成「点了华为、高亮小米」,且不报错 —— 抽成 ROM_CHIP_KEYS 单一来源。
  • WalkPreviewService.fgsOsTag() 不再读 hyperOsMode,固定用自动识别。
  • 单测:本轮新增/改写 5 条(华为判定、华为/荣耀不串台、五厂商 + 原生数量、短名与 displayName 一致性),
    全套 169 条通过。

Assets

1

11/10/2026, 4:15:25 PM

4.2.0(43)P2+P3:图标换矢量三层,相机包名补全(顺手抓到一个真 bug)

一、图标:1024 位图 → 矢量三层

旧图标的问题不是"不好看",是工程上错了:

问题 后果
前景是 1024×1024 PNG,靠密度拉伸 48dp 下细节糊成一团,APK 里白占 1.17 MB
缺 <monochrome> 层 系统开「主题图标」时只能把彩色图整体去色,HyperOS 3 / MagicOS / ColorOS 15 / OriginOS 5 上都是一个灰糊块
没有安全区概念 圆形 / 水滴遮罩会切到伞边

现在:矢量前景(渐变伞面 + 顶部高光 + 三道伞骨)+ 渐变背景 + 独立 monochrome 剪影。
主体收在以画布中心为心、半径 33dp 的安全圆内,四种遮罩都切不到。

monochrome 不是把前景去色,而是重画:去掉雨滴与伞骨(小尺寸会变噪点),
伞柄加粗到 2.6dp,保证 48dp 下仍是干净的「一个人打着伞」。

顺带删掉 5 个密度的 legacy PNG 与 1.17 MB 旧前景位图(minSdk 33 下永不读取):
APK 44.0 MB → 42.3 MB。

二、相机包名:三星那条写错了

CameraAppPolicy 里原本是 com.samsung.android.camera,三星实际用的是
com.sec.android.app.camera。后果很隐蔽:三星用户打开相机,小窗照样盖在取景框上,
自己的预览会话还占着摄像头,对方 CAMERA_IN_USE —— 日志里一切正常,极难排查。

补全(都是「打开后会独占摄像头」的真·相机):三星 sec 包名、AOSP 第二个真实包名
com.android.camera2、一加氧 OS com.oneplus.camera、Moto camera2/camera3、索尼、华硕。

社交类(微信 / WhatsApp / Telegram)刻意不进表:它们只在视频通话时占相机,
平时收起小窗属于误伤。这条约定有测试守着。

三、自启动候选:按开源项目核对了一遍

参考 judemanutd/AutoStarter(Apache-2.0,跨 OEM 自启动跳转库)的路径表,补齐三条真实缺口:

生态 之前缺的 为什么重要
ColorOS ...safecenter.permission.startup.StartupAppListActivity ColorOS 11 及更早的唯一入口
ColorOS com.oneplus.security 链式启动页 + BACKGROUND_OPTIMIZE 一加氧 OS / 早期合并版仍用它
OriginOS com.iqoo.secure 白名单页 iQOO 的自启动管理在自己独立的包里
MagicOS com.huawei.systemmanager 两条 MagicUI 时代的老荣耀

因为跳转是「逐条 resolveActivity → 打不开换下一条」,多写一条的代价只是一次失败尝试。
致谢页新增「国产 UI 适配」分区,把参考来源挂上可点链接。

验证

  • 单测 144 / 144(新增 RomOemCandidatesTest 6 条 + CameraAppPolicyTest 2 条)
  • lint 0 error / 322 warning(4.1.0 是 327,减少的 5 条正是 legacy 图标的 IconLauncherShape)
  • versionCode 43 / 4.2.0 / targetSdk 35(apkanalyzer 实测)
  • 自适应图标三层齐全(aapt2 dump xmltree 确认 background / foreground / monochrome 都在)

真机仍未验:docs/rom-support-matrix.md 的图标一栏是 🟡 —— 五家桌面的主题图标效果
需要拿到真机才能下结论。

Assets

1

11/10/2026, 3:38:08 PM

4.1.0(42)国产 UI 适配 P1:不再对荣耀用户说「请开启 HyperOS 自启动」

这一版只做一件事:把首次安装引导页里的指路从写死小米,改成按本机 UI 查表。

用户能直接看到的变化

位置 之前 现在
第 4 步按钮 写死「自启动 / 后台活动(HyperOS)」 按本机判定生成:HyperOS / MagicOS / ColorOS / OriginOS;AOSP 写「本系统无此开关,可跳过」
点「去开启」后 只试小米两条私有页 查表 → 逐条校验能否打开 → 打不开换下一条 → 全失败退应用详情页
权限清单 ③ 「避免 HyperOS 后台杀掉…」 「避免系统在后台杀掉…」
权限清单 ④ 永远红字「需手动确认」 AOSP 上显示「本系统无此开关(无需设置)」,不再计入待处理
首屏 无 多一行「本机 UI:ColorOS · 自启动在『手机管家 → 自启动管理』」

荣耀 / OPPO / vivo / 原生用户不会再被指引去找一个只存在于小米手机上的页面。

三个刻意的取舍

1. 表坏了不能让引导页白屏。 适配表是 Kotlin object,表里一条 spec 写错会在首次访问时抛
ExceptionInInitializerError(属于 Error,不是 Exception)。所有访问点都用 Throwable
兜住并退回通用文案 —— 用户装完 App 打开的第一屏,不能因为一张指路表崩掉。

2. 按钮不显示括号补充。「开启特殊权限 4/6 · 自启动 / 后台活动(本系统无此开关,可跳过)」
在单行按钮上会被截成「…(本系统无此开」。清单里保留完整说明,按钮只留短名。

3. 没有真机就不写「已支持」。 docs/rom-support-matrix.md 里自启动一栏仍是 🟡:
代码路径已通 + 有单测守着顺序与兜底,不等于在 ColorOS 上实测能开。

验证

  • 单测 136 / 136(新增 RomPageLauncherTest 10 条)
  • lint 0 error,327 warning 与 4.0.1 同量,无新增
  • versionCode 42 / 4.1.0 / targetSdk 35(apkanalyzer 实测)

仍未做

P2 包名补全(iQOO / realme / POCO 子品牌机型名)、P3 图标(三层自适应 + monochrome
主题图标)、P4 真机验证。EmergencyCardActivity 里的紧急呼叫路径仍是独立清单,
其中华为 com.huawei.emergency 不在五家表内,合并前需要先决定是否新增 EMUI 档案。

Assets

1

11/10/2026, 2:42:14 PM

4.0.1(41):向前兼容补丁

一句话:4.0 的 HyperOS 3 适配不影响 HyperOS 4,也不会因为 HyperOS 5 出现而复发。

这次修的是什么

你去问「会不会影响 HyperOS 4」的时候,我把识别层重新查了一遍,发现一个真实短板:

正则写死 [34],遇到 ro.mi.os.version.name = HyperOS 5.0 会一个版本号都匹配不到,
只能掉进 SDK_INT >= 36 → HOS4 的兜底。结果碰巧对,但日志会写成
「未从 prop 提取到 3/4」——排查的人会以为 prop 读坏了。

项 4.0 4.0.1
识别范围 [34] 写死 3 ~ 6,HyperOS 5/6 直接读出
major >= 4 只处理 == 4 统一并入 HOS4 分支(策略同构,不新增枚举)
用户文案 「HyperOS 4」 「HyperOS 4 及更新版本」
误读防护 有 (?![0-9]) 追加单测锁死 V816 / V35 / V9 / V12
单测 6 条 +8 条(HyperOsVersionParseTest),累计 112/112

为什么"不影响 HyperOS 4"不是口头保证

三个真正影响功能的策略(前台服务类型、手电、悬浮窗权限)全部与 ROM 版本无关:

fun foregroundServiceStrategy(os: Os): String = FGS_CHAIN   // "camera→specialUse→none"
fun torchOpenStrategy(os: Os): String = "inSession"
fun overlayPermissionStrategy(os: Os): String = "verifyBeforeShow"

os 参数一次都没被读。真正的决策在 WalkPreviewService.goForeground():
逐档 startForeground(),哪一档不抛异常就用哪一档。由系统当时的反应决定,不由版本号决定。

版本识别的结论只流向四处文案(首页摘要、能不能用的一句话、保活提示、root 注意事项)。
识别错了,最坏结果是首页写错一行字,功能一行代码都不会变。

关于 targetSdk 停在 35

这是刻意的。Android 16(HyperOS 4 基座)的破坏性变更——edge-to-edge 强制、
大屏忽略方向锁定、预测性返回默认开启、JobScheduler 配额——绝大多数是
targetSdk 36+ 才生效。停在 35,它们在 HyperOS 4 上不会作用到本应用。

compileSdk 是 37,所以编译期能看到最新 API,运行期仍按 35 的规则走。

完整的 Android 16 × SafeWalk 影响矩阵、以及"什么条件下才需要改代码":
docs/hos4-impact.md

已知边界

没有 HyperOS 4 真机,以上结论来自代码路径 + 清单 + 单测,不是实机跑出来的。
真遇到厂商额外拦截时,日志里会写清是哪一档被拒([FGS] 前缀)——这正是 4.0
把决策放在运行时、而不是放在版本号上的原因。

校验

  • versionCode 41 / versionName 4.0.1 / targetSdk 35(apkanalyzer 实测)
  • 单测 112/112,BUILD SUCCESSFUL
  • 功能零改动,只是识别层 + 文档

完整安装包: SafeWalk-v4.0.1.apk(43 MB,debug 签名,与 4.0 一致)

Assets

1

11/10/2026, 1:12:14 PM

4.0 稳定版 · HyperOS 3 / HyperOS 4 双版本适配

这是第一个真正按运行时结果适配的版本。之前的 3.3~3.5 里有一张很完整的兼容表
(HOS3 用 specialUse、HOS4 用 plain、手电 releasePreviewFirst、悬浮窗 strict),
但那些值只出现在日志里,startForeground 一直硬编码 CAMERA —— 等于展示了方案、没落地。
4.0 把它改成了真正执行的链路。

HyperOS 3:标准路径,无需绕行

系统基座 targetSdk 实际路径
HyperOS 3 Android 15 35(与本机一致) camera 前台服务 / 常显小窗 / 悬浮窗,一次降级都不会触发
HyperOS 4 Android 16 35(低一档) 同上,但 camera 被拒时自动降级到 specialUse

先给结论:HyperOS 3 是本项目最不需要特殊照顾的版本。本应用 targetSdk 35,
在 HOS3(Android 15)上 targetSdk 与系统版本一致,行为完全标准;HOS4(Android 16)
因为 targetSdk 低一档、加上厂商对 camera 型前台服务拦截更积极,才需要降级链。

降级链(不猜版本,只看结果)

startForeground(CAMERA)        ← 后台能用相机的唯一合法类型
   ↓ 被拒(ForegroundServiceStartNotAllowedException)
startForeground(SPECIAL_USE)   ← 不带相机语义,但保住进程与悬浮窗
   ↓ 仍被拒
startForeground(无 type)

判定依据只有「上一次调用有没有抛异常」。好处:HOS3 上第一档就过、不进降级分支;
HOS5 换了限制也不用改代码。降级时会弹一次通知说明「后台相机被限制,建议加电池白名单」。

其他 HyperOS 相关修复

  • 悬浮窗权限复核:每次显示前真的查 Settings.canDrawOverlays()。HOS 在系统升级、
    一键清理后会悄悄回收这个权限,以前的表现是「走起来没反应」——因为 addView 抛的
    BadTokenException 被外层吞掉了。现在会拦下并通知去重新授权。
  • 补 FOREGROUND_SERVICE_SPECIAL_USE 权限:lint 抓到的真缺陷。只声明
    foregroundServiceType="specialUse" 而不声明这条权限,运行时 startForeground(..., SPECIAL_USE) 直接抛 SecurityException —— 降级链会在最需要它的那一刻断掉。
  • 手电策略:明确为 inSession。3.2 起灯就开在预览会话内(FLASH_MODE_TORCH),
    releasePreviewFirst 描述的那一步已不存在。

导航栏:浅色毛边终于修对

3.5 只调了描边颜色,深色立刻变好、浅色几乎没变。因为根因判断错了:

毛边不是"圆角没设好",而是 AGSL 直接栅格化、圆角处不做覆盖率采样,边界上输出一条
宽 1~2dp 的半透明带。深色底上暗+暗看不见,浅色底上就是一圈灰箍。3.5 的白描边画在形状
内侧、且浅色下与背景同色,盖不住它。

4.0 改为 graphicsLayer(shape = TabsShape, clip = true):让 RenderNode 按同一个圆角做
硬件 outline 裁剪(自带抗锯齿),把那条半透明带连同外溢的模糊采样一起切掉。
配套:浅色 blur 8→6dp,描边降为白 0.55→0.10(只留边光,不成白框)。

已知代价:按住导航栏时的 +5% 膨胀会被裁掉,只剩高亮与透镜。

验证

  • assembleDebug BUILD SUCCESSFUL;单测 104/104(新增 HyperOsCompatStrategyTest 6 条
    防回归:camera 必须排第一、HOS3/HOS4 必须共用同一条链、文案里不许出现内部代号、
    不许写"完美支持")
  • lintDebug 0 error
  • 清单实测 foregroundServiceType=0x40000040(camera | specialUse)
  • versionCode 40 / versionName 4.0

关于「HyperOS 3 到底能不能用」的边界

我没有 HyperOS 3 真机,上面的结论来自代码路径分析 + 清单校验 + 单元测试,不是真机跑通。
因此这份说明不写"完美支持 / 100% 兼容",只说清三件事:走的是标准路径;任何一次被系统
拒绝都会降级而不是崩溃;日志 [FGS] 会写明哪一档被拒、为什么。

如果你在 HOS3 上遇到问题,开行走模式走 10 步,把 diag.log 发到 issue 即可。

Assets

1

11/10/2026, 9:17:04 AM

3.5(35)磁贴改为「自动跟随步行」+ 导航栏圆角收口

🔧 磁贴语义修正(3.4 理解错了)

3.4 的磁贴切的是「行走模式总开关」,实际应该是自动跟随步行(走起来才显示、停下收起)。

  • 点亮:enableRearCamera=true + rearCamAuto=true;熄灭:两者都 false
    (只关 auto 会留下「总开关开 + 常显」,下次开机自启就常显小窗,等于关不干净);
  • 磁贴只在「预览开 + 自动跟随开」时高亮;App 里只开常显档时磁贴为灰;
  • 服务已在跑时只切档位、不闪中转页,并提示「走起来才显示」;服务没跑才经透明中转页起 camera FGS。

✨ 液态玻璃导航栏圆角收口

  • Capsule()(50% 百分比)→ 显式 RoundedCornerShape(28.dp),半径落整像素,圆角起弧不再抖;
  • 新增 cleanEdge():在玻璃图层之上描 1dp 同色渐变边,盖住 AGSL shader 栅格化台阶与
    8dp 模糊混入的透明像素——这就是「毛边」的来源。亮色白 0.85→0.25,暗色白 0.22→0.05,
    看起来是玻璃自然边光,不像加了个框;
  • 玻璃主体 1dp、滑块 0.9dp;不用 clip()(硬裁切同样有单像素锯齿,还会裁掉滑块外阴影)。

验证:BUILD SUCCESSFUL,单测 98/98(新增 6 条磁贴状态测试),lint 0 error。

Assets

1

11/10/2026, 7:14:50 AM

3.4(34)新增:控制中心磁贴

下拉控制中心点一下就能开关「行走模式」,不用再进应用。

一点就开

  • 开:经透明中转页启动预览服务。WalkPreviewService 是 camera 类型前台服务,
    QS 面板展开时应用在后台,Android 14+ 直接 startForegroundService 会抛
    ForegroundServiceStartNotAllowedException;官方稳定豁免是「启动瞬间有可见 Activity」,
    中转页存在 450ms,服务提起前台后自行退出,用户无感。
  • 关:写配置 + 发 STOP,面板不收起,磁贴当场变灰。

状态与文案

  • 总开关关闭时磁贴置灰(STATE_UNAVAILABLE)——此时点开也不会生效,不能做成「看着能点、点了没反应」;
  • 副标题:点击开启身后路况 / 身后路况已开启 / 已开启 · 预览未运行,点一下关闭;
  • 与 App 内开关双向同步(requestListeningState),不必等下次拉开面板;
  • 长按磁贴直达「行走模式」页。

如何添加

行走模式页 →「快捷入口 → 添加到控制中心」→ 系统弹框点「添加」
(StatusBarManager.requestAddTileService,API 33+)。失败时提示手动添加。

验证:BUILD SUCCESSFUL,单测 97/97(新增 5 条),lint 0 error。

Assets

1

11/10/2026, 6:58:08 AM

3.3(33)全量缺陷排查

1. 系统「无障碍」里找不到本应用(用户反馈)

应用从未声明任何 AccessibilityService,系统列表自然没有条目;引导页状态还读的是
ACCESSIBILITY_ENABLED 总开关,开着任意第三方无障碍服务就误报「已开启」。

  • 新增 SafeWalkA11yService:只订阅 TYPE_WINDOW_STATE_CHANGED,canRetrieveWindowContent=false
    (不读屏、不注入手势、不联网),settingsActivity 指向主界面 —— 系统条目点「设置」即可打开 App;
  • 职责:前台是相机 / 录像 / 视频通话类应用时收起角落小窗(不依赖 Xposed 的备用通道);
  • 引导页「无障碍」改为直达本服务详情页,状态按 ENABLED_ACCESSIBILITY_SERVICES 精确判断。

2. 长按图标没有快捷方式

res/xml/shortcuts.xml 写了两个快捷方式,但清单缺 android.app.shortcuts meta-data,系统不读。

3. 到达提醒后台从不触发

只申请了前台定位,Android 10 起应用进后台就停回调 —— 而「到达某地」几乎总在屏幕黑着时发生。
补 ACCESS_BACKGROUND_LOCATION + 引导页「后台定位」项(位置选「始终允许」)。

4. 其他

  • AutoStartActivity 在 Android 13 读 API 34 的 launchedFromUid → uid=-1 误报「被不可信拉起」;
  • 清单补 PACKAGE_USAGE_STATS(Hook 前台检测第四级兜底原本每次抛 SecurityException);
  • 「关于」页新增常驻入口「权限与无障碍」(引导页只弹一次,此前无法补授权);
  • 消除 5 条 lint error,lintDebug 0 error。

验证:BUILD SUCCESSFUL,单测 92/92(新增 CameraAppPolicyTest 4 条)。

Assets

1

11/10/2026, 6:16:47 AM

3.2(32)修复:自动跟随全程不触发

上一轮防沙发误触把纯加速度门槛定成 >= max(确认步数×2, 15),而 GaitDetector.confirmedStepCount() 是滑动窗口大小、队列上限写死 10 —— >=15 永不成立,在该机型上等价于关闭自动跟随(真机 14 分钟 0 次激活、968 行拦截日志)。

修复

  • 新增 WalkConfirmPolicy:门槛 clamp(用户步数×2, 8, 10),单测锁死「不得超过采集窗口上限」;
  • 判据从「累计多少步」改为步流形态:连续 810 步、最大步间隔 ≤1.6s、平均间隔 3501400ms、跨度 ≥4s、离散度受控;平放(LAY_FLAT)仍一票否决;
  • accelStepTs 记录每个合格步时间戳(stepTick 或计数增长时入队,断步 3s 清空)。

顺带

  • 日志洪泛:accelOnlyConfirm() 968 行/9 秒 → 约 1 行/10 秒;shouldShowNow() 加 5 秒节流;
  • [STEP] 的「本帧合格步=false」改为「最近10s出步=N」(旧文案会误读成没走成);
  • 新增一次性诊断「本机走纯加速度判定 | 计步传感器=有/无 已出步=0」,区分没传感器与没给「身体活动」权限;
  • Hook [torch:time] 文案「步态联动」→「小窗联动」。

验证:BUILD SUCCESSFUL,单测 88/88(新增 10 条)。

Assets

1

11/10/2026, 5:43:23 AM

SafeWalk 修复版 v3.1 · 提醒改为「到达场所」触发

现象

在家走动、沙发上起身都会收到两条通知:

  • SafeWalk 证件提醒:身份证、护照等重要证件一定要贴身放好。
  • SafeWalk 社交提示:【求职】优先青旅,只订1晚,现场看房;精简行李,面试仅带小包;每日预算定额…

语义明明是「到了某类场合该注意什么」,却被挂在 Hook 的 triggerMovement() 上——
只要判定「正在持续步行」就无条件推送,跟人在哪儿毫无关系。触发条件与内容语义完全错配。

修复:触发权从「步态」交给「地点」

新增 App 侧 PlaceArrivalMonitor:低频定位(NETWORK 优先,60s / 150m)→ 系统 Geocoder 反编码
→ 复用内置地点词库判类(求职 / 约会 / 聚会 / 旅游)→ 停留确认 → 按类别发一条对应提醒。

ArrivalJudge 三道闸:

闸门 作用
连续 2 次命中同一类别 单次命中只是路过,或被反编码带进邻近商圈的名字
同类别 6 小时冷却 同一商圈里反复进出餐厅/商场不会连环弹
离开即清空候选 走开再回来要重新确认,不靠「刚才来过」放行

地点去重按约 1.1km 网格(arriveSeenPlaces):旅游类 24 小时内同一地点提一次(出差常去同一车站,隔天该再提);
求职/约会/聚会 30 天内同一地点提一次(否则每天通勤到公司都会弹面试礼仪)。

内容也一起修对了

TravelTemplate.getArrivalTips() 新增「到场提示」,只留当下这一刻用得上的礼节:

  • 求职 →「进门先在访客机登记、出示身份证」「手机调静音,称呼用姓+职位」
  • 约会 →「到了先找好位置并告知对方」「不打探收入与感情过往,买单主动开口 AA」
  • 聚会 →「先跟主人和长辈打招呼」「不强行劝酒,离开前说一声并确认返程」
  • 旅游 →「证件与贵重物品贴身,人多处背包前置」「记下住宿地址与前台电话」

原先直接取出发前清单前 3 条拼成一大段,到站收到的是「优先青旅,只订1晚」——两套内容现已拆开。

其他

  • triggerMovement() 删除这两段(只保留夜间手电),走路不再念提醒
  • 通知标题带场景:「SafeWalk 证件提醒 · 旅游」「SafeWalk 到场提示 · 求职」
  • 设置页文案改为「到达车站/机场/景区/酒店时提醒证件」「到达面试/约会/聚会时提一条礼节」
  • 定位在 App 常驻服务里注册,服务停止即注销;反编码在后台单线程 + busy 标记,不碰主线程

验证

assembleDebug BUILD SUCCESSFUL,单测 78/78 通过(新增 8 条到达判定回归)。
APK(versionCode 31 / versionName 3.1)dex 确认 PlaceArrivalMonitor / ArrivalJudge /
arriveSeenPlaces / getArrivalTips 进包,旧文案「三条提醒的开关都关着」「确认步行出门后」已消失。

历史修复

沙发误唤醒根治、急救卡安全加固、重启丢设置、夜间手电单开关、锁屏误报修复、
对比度进度条、液态玻璃导航跟随、实时保存。

安装:LSPosed 激活模块(含 SystemUI 作用域),授予相机 / 无障碍 / 通知 / 身体活动 / 定位 权限。

Assets

1

11/8/2026, 12:48:29 PM

SafeWalk v3.0 正式版

界面重构

  • 色板重写为单一语义 token(bg / card_bg / text_primary / text_body / text_hint / divider / primary …),深色模式由 values-night 逐项覆盖,不再维护三套互相打架的配色
  • 全部二级页面统一为卡片式行列表版式:功能实验区、出门踩坑指南、设置、关于、致敬名单
  • 主界面底部导航栏与左右滑动联动,选中项跟随页面切换
  • 功能实验区重做为行式列表(修复按钮宽度归零导致控件整体不可见的问题)
  • 出门踩坑指南重做:2x2 磁贴改为行式入口 + 内容卡片
  • 新应用图标(去白边透明处理)

功能与稳定性

  • Hook 侧四层初始化入口 + 四级前台应用检测,换机型不再静默失效
  • 初始化失败可重试(2s→60s 退避,最多 20 次)
  • 配置读取移出主线程,避免 SystemUI 卡顿
  • 广播加签名级权限校验,外部应用无法伪造指令
  • 预览服务失败后可自动恢复(修复回执卡死后永不恢复的问题)

安装说明

  • versionCode 30 / versionName 3.0,最低 Android 13(API 33)
  • 本包为 debug 签名,与 2.x 版本签名不同,安装前需先卸载旧版(配置会清空)
  • 安装后请在模块内点「重启系统界面」使 Hook 生效

Assets

2

11/2/2026, 12:04:03 PM

🏗 架构:相机彻底搬离 SystemUI

  • 新增 WalkPreviewService(App 进程相机前台服务),RearCameraOverlay 随之迁移
  • Hook 端删除全部相机逻辑,只保留「该显示 / 该收起」的指挥广播(带令牌)
  • 解决系统界面无相机权限、CameraService 限制、崩溃连带系统界面三个根本问题
  • 预览服务回传真实显示状态,修正 Hook 端去重状态与实况脱节导致「手动关一次后再也不自动开」

✨ 新增:车祸预警(Pixel 风格)

  • CrashDetector:合加速度阈值 + 连续 2 次命中 + 60 秒冷却
  • 三档灵敏度:低 ≈2.5g / 中 ≈2.0g / 高 ≈1.5g
  • EmergencyAlertActivity:全屏急救卡 + 60 秒倒计时,超时先发含位置短信再拨号
  • 无权限时降级为跳转短信/拨号界面,不静默失败
  • 急救卡页面新增开关与灵敏度设置,权限按需申请

📝 日志链路重做

  • 日志路径改为 /storage/emulated/0/Android/Travel safely/diag.log(用户可见)
  • 目录判定由不可靠的 canWrite() 改为探针写入(真写一字节再删)
  • 三级降级:用户目录 → 应用私有目录 → 仅 logcat,结果打进 logcat
  • 授予「所有文件访问」后运行期热切换,不用重启
  • App 启动时向 Hook 索要内存日志,写入同一文件(步态/手电/车祸都在那个进程)

🐛 关键修复

  • 首页与二级页状态矛盾:总开关卡片无开关控件、点击静默翻转;关闭后磁贴文案被覆盖成「总开关已关闭」,掩盖真实设置 → 改为明确文案 + 切换提示
  • 全屏预览黑屏:TextureView 所在悬浮窗缺 FLAG_HARDWARE_ACCELERATED,一帧都上不了屏
  • 全屏尺寸用 displayMetrics(应用可用区)→ 改真实屏幕像素 + FLAG_LAYOUT_IN_SCREEN
  • 视图 0×0 只重试一次 → 200ms × 3 退避
  • 手电两套开关(开/关各自独立)合并为绝对开关;通知按钮 action 统一
  • 夜间手电丢失「屏幕亮」与「预览避让相机」两个门槛,导致开了行走模式就永不提醒
  • 总开关关闭时仍能拉起预览 → 改为只记录不弹并说明原因
  • exportConfig 无 try/catch,存储异常直接崩 UI 线程
  • 配置回退路径硬编码 /data/data/<包名>/ → 改用 ctx.filesDir
  • 实验区手电开关用本地布尔记账 → 改读 TorchCallback 真实状态
  • 急救卡缺 onResume 刷新,改完总开关回来仍显示旧状态
  • 行走模式页诊断行、testRearCam* 死字段清理

🧪 测试与验证

  • 单测扩展到 43 项 / 8 个类,新增 PreviewWindowTest、CrashDetectorTest、DiagLogTest
  • Lint 0 error
  • 实验区夜间手电测试改为真实通知链路(带可点击的「手电筒」按钮),不再是纯文本通知

Assets

1

10/26/2026, 8:09:25 AM

安全出行 v1.7
行走安全 LSPosed 模块,注入 SystemUI。

  • 后置摄像头路况(全屏半透明 / 角落小窗,可切换,触摸穿透)
  • 自动模式:检测步行节奏自动开关,坐下/停下自动收起
  • 低头看路提醒(Toast,默认 3 秒,20 秒节流)
  • 相机避让:前台进入相机/微信/支付宝等自动收起,冷却后自动恢复
  • 深色模式跟随系统,省电优化
    作用域:系统界面 (com.android.systemui)

Assets

1