# BlindAssist 更新记录

> 本文件只记录已发布或用户可见的变化。研究候选、数据采集和未晋级实验不构成 release note；其当前状态见 [SANPO_CURRENT_STATUS.md](docs/SANPO_CURRENT_STATUS.md)，迁出的旧研究记录见[项目材料历史](docs/history/project-materials/README.md)。

## Unreleased

- 开源维护新增公开治理规则、引用元数据、Dependabot、默认模型卡和 SHA256/provenance 机器清单；CI 会拒绝社区文件或默认公开资产身份漂移。
- 新增 tag 驱动的 fail-closed GitHub Release 工作流，自动校验 debug evaluation APK 并生成 `SHA256SUMS`、机器 manifest 和证据边界说明；不产生生产签名或安全证明。
- 默认 App 行为和 YOLO11n 模型资产不变；研究候选仍未替换正式 App 默认模型。

## v10.9.0 - SANPO 风险事件闭环

- 补齐中英双语开源首页、真实原型截图、架构图、公共价值、贡献、安全、行为准则和 Issue/PR 模板；这些公开入口明确原型与安全认证、synthetic evidence 与真实用户证据之间的边界。
- 恢复默认分支 CI 的跨平台可配置性和治理一致性；自有 `libblindassist_vision.so` 增加 16KB ELF 对齐，四个 Android ABI 均通过静态发布门禁。该兼容性结果不替代真实 16KB 设备验证。
- 新增纯 Kotlin `RiskEventTracker`：仅跟踪 SANPO 中心走廊分割候选，首次实际反馈后阻断同一事件重复播报；通过/远离或连续 3 帧消失后清除。YOLO 默认检测与模型资产不变。
- `generic obstacle` 增加贴边长条边界形态否决，避免平行路沿泛化；紧凑中心障碍和 `stairs` 保留既有候选路径。
- benchmark 与连续序列标注新增事件阶段、事件 ID/状态、反馈抑制原因、已通过窗口与平行路沿错误提醒统计；`clone_sanpo_event_phase_evalset.py` 为现有已复核集生成不可变事件阶段克隆。固定 90 帧同设备复测仍是训练前硬门禁，尚未在本条记录中宣称通过。
- SM-S9280 90 帧复测证据：`test-artifacts.local/detector-ab-device-benchmark/20260711-205209/`。候选总 P95 `57.581ms`、已通过窗口错误提醒 `0`、报告中的平行路沿错误提醒 `0`，但 alert FP `5.6%`、逐帧 alert recall `5.6%`，推荐仍为 `do_not_replace_default_model`。随后 90 秒 CameraX 回归在 `检测中 | Detecting` 文本等待阶段超时，证据位于 `test-artifacts.local/device-regression/20260711-205421/`。

旧 SANPO v2/v3 研究历史已按原文迁入
[2026-08-13 项目材料归档](docs/history/project-materials/SANPO_RESEARCH_HISTORY_FROM_CHANGELOG_2026-08-13.md)；
该材料不是发布说明，也不恢复任何研究权限。

## v10.4.0 - SANPO Traversability v2 Oracle 第一阶段

- 状态：当前 30 帧否定集门槛通过；`versionCode=36`，`versionName=10.4.0`。
- `curb` 不再作为普通障碍框；无深度的单帧分割证据限制为 `RiskLevel.LOW / ProximityBand.MID`。
- 完整连通域增加中心重叠、底部位置和中心优先选择；mask 降至 256×256，同帧复用 mask 并复用 corridor/visited/queue 缓冲。
- SM-S9280 A/B：错误提醒率 `3.3%`、SANPO 主区域命中 `86.7%`、total P95 `65.919ms`，YOLO 指标无退化，默认模型回归通过。
- 公开正负连续序列扩展完成前保持不训练、不替换默认模型。

## v9.9.0 - 16KB 兼容、离线回放与眼镜模拟中心

- 状态：本地与 4KB Android 16 真机验证完成；`versionCode=35`，`versionName=9.9.0`。
- 16KB：三项旧 `org.tensorflow:*:2.16.1` 依赖迁移为 LiteRT `1.4.2` core/GPU/GPU API；新增 APK/AAB ELF `PT_LOAD`、`zipalign -P 16` 和 bundletool 门禁，最终 APK/AAB 的 16 个 native library 均为 16KB 对齐，AAB 为 `PAGE_ALIGNMENT_16K`。
- 运行策略：LiteRT GPU 在同设备 BlindAssist EvalSet 复跑中将提醒误报率从 `0.037` 提高到 `0.074`，因此按预案临时切换 CPU 兼容模式并保留 GPU delegate 代码与依赖。CPU 模式 100 图结果与历史基线对齐：AP50 `0.289`、关键漏报 `9`、提醒误报率 `0.037`，total P50/P95 `53/55ms`，P95 未退化。
- Replay：新增 `AssistInputSource`、`ReplayScenario`、可空 preview 的 `FrameSource` 契约和 2 FPS `ReplayFrameSource`；stop/shutdown、generation 隔离、错误单次上报和帧独立关闭均有 JVM 测试。四张 CC BY 2.0 COCO 素材只位于 debug assets，进入真实 detector→risk→feedback→overlay→session summary 链路，不伪造检测结果，不要求 CAMERA/存储/网络权限。
- 模拟中心：用全屏眼镜设备模拟中心替换占位弹窗，支持 800ms 模拟连接、82%/15% 电量、模拟断连和重置；debug 连接态可启动离线回放，release 仅展示连接、电量、来源和反馈链路模拟。中英文标题、状态、按钮和 TalkBack 说明均明确“模拟”，不新增 BLE、USB、INTERNET、定位或存储权限。
- 验证：完整 JVM、Lint、debug APK、AndroidTest APK、debug AAB、release assets 和 device-benchmark APK 构建矩阵通过；12 个 Compose 真机测试通过；模型合同、仓库卫生、release replay 排除、最终 APK/AAB 16KB 门禁和 90 秒 CameraX 回归通过。最终真机约 15 FPS，推理 P95 约 33ms。
- 边界：Samsung `SM-S9280` / Android 16 为 4KB 页设备，本轮尚未在真实 16KB Android 15/16 环境执行安装与连续推理；实际场景采集、算法调参和真实眼镜接入继续延期。签名 release 构建仍需要本机缺失的发布 keystore。
- APK：本地归档 `E:\linnan\blind-assist-apk-archive\apks\BlindAssist-v9.9.0-debug-20260710-233951.apk`；Git 里程碑 `releases/apk/BlindAssist-v9.9.0-debug-20260710-233951.apk`；大小 `55,879,856` bytes，SHA256 `53065A54A43ABF6256994CDC9E6C89F2F5680BE5BEA1FC9BDF88CAF26AA77BDD`。

## v9.4.0 - 安全语义、Session 生命周期与测试架构修复

- 状态：本地与真机验证完成；`versionCode=34`，`versionName=9.4.0`。
- 风险语义：新增 `RiskEvidenceState`，区分没有支持目标证据与支持目标未达阈值；`RiskLevel.NONE` 不再被解释为安全，中英文运行时、无障碍和预览统一改为 `持续检测中 / Monitoring` 及非承诺说明。
- 生命周期：引入单调 `SessionToken` 和 `commitIfCurrent()`，旧 detector 结果不能写入新 session 的 coordinator、反馈、统计、UI 或错误状态；停止先失效 token，shutdown 等最后 lease 结束后再关闭 CameraX executor、detector 和 feedback；新 session 重置 cooldown/fatigue。
- 工程门禁：修复卫生扩展名正则，新增 `.android-home/`、`.kotlin-home/`、`**/__pycache__/`、`work/` 规则与无 Pester 的 13 场景 smoke；CI 在一次 Gradle invocation 中覆盖 JVM、Lint、App、功能测试 APK 和 benchmark APK。
- 测试隔离：新增 `:device-benchmark` test-only 模块并迁移 `DetectorAbDeviceBenchmarkTest` 及资产任务；删除被 A/B 流程覆盖的旧 `Yolo26nDeviceBenchmarkTest`；`:app` AndroidTest 仅保留 11 个 Compose 功能测试。
- 验证：完整 JVM 测试通过；卫生 smoke 与真实工作树检查通过；一次组合 Gradle 构建 319 tasks 成功；模型合同和 APK metadata/signature 检查通过。Samsung `SM-S9280` / Android 16 上 Compose 功能测试 `11/11` 通过。BlindAssist EvalSet 100 图 Detector A/B 完整运行，YOLO26n 因中心风险召回下降、关键漏报增加和误报率翻倍而不替换 YOLO11n；MiDaS Depth-fusion 因误报与延迟显著退化而不晋级。强化后的 90 秒回归自动越过兼容提示和 onboarding、进入 CameraX，断言前台、模型就绪与无 Crash/ANR，持续产生性能帧约 85 秒。
- 后续兼容项：Android 16 系统仍提示 TFLite、image processing、TFLite GPU 和 AndroidX graphics native library 未全部满足 16KB page-size 对齐；不影响本轮 debug 真机验证，但应在后续依赖升级或发布准备中处理。
- APK：本地归档 `E:\linnan\blind-assist-apk-archive\apks\BlindAssist-v9.4.0-debug-20260710-084153.apk`；Git 里程碑 `releases/apk/BlindAssist-v9.4.0-debug-20260710-084153.apk`；大小 `47,297,084` bytes，SHA256 `E4DB467B77F9628F04E4E2CF00AC8737C5FABE95ED60AC6EF6A8ED1518E067BC`。

本文件按真实版本记录 BlindAssist 的功能演进、验证证据和可展示 APK 归档。它用于课程汇报、答辩材料整理和版本对比，不替代 `DEVELOPMENT_LOG.md` 的逐次工作记录。

## v8.9.0 - 几何、深度、运动的保守融合候选层
- 状态：已完成核心 JVM 单测与 androidTest benchmark 编译验证，`versionCode=33`，`versionName=8.9.0`。
- 主要变化：
  - 新增纯 Kotlin `ConservativeRiskFusionPolicy` / `ConservativeRiskFusionConfig`，把深度证据提升和连续帧运动提升收敛为同一个保守策略层。
  - 深度证据默认最多提升 1 档，并拒绝 FAR 到 NEAR/CRITICAL 等大跨度冲突；低置信、非深度来源、不可行动通道和非更近证据都会回退几何基线。
  - 运动趋势只在 `APPROACHING` 时最多提升 1 档，`STABLE`、`RECEDING` 和 `UNKNOWN` 不提升；侧向目标仍不能升为高风险。
  - `RiskScoreBreakdown.fusionSummary` 记录 `GEOMETRY_ONLY`、`DEPTH_PROMOTED`、`DEPTH_REJECTED_*`、`MOTION_PROMOTED` 等稳定原因，`DetectorAbDeviceBenchmarkTest` 在 JSON、per-image CSV 和 Markdown 总表中同步输出融合原因。
  - 默认 App 仍只包含 `yolo11n_fp16_320.tflite` 和 `coco_labels.txt`，不打包或启用深度候选模型；深度模型继续只进入 androidTest/benchmark 路线。
- 验证：
  - `:core:assist:test`：通过；普通沙箱首次因 Kotlin daemon / build 目录权限失败，按仓库已知限制提权重跑后通过。
  - `:app:compileDebugAndroidTestKotlin`：通过，确认 benchmark 输出改动可编译。
  - 本轮未运行完整 100 图真机 DepthFusion A/B；候选是否推广仍需同设备完整验证，默认结论不变。
## v8.8.0 - 综合风险函数与连续帧逼近风险
- 状态：已完成本地单测、lint、构建、同设备 BlindAssist EvalSet benchmark、90 秒真机回归和里程碑 APK 归档，`versionCode=32`，`versionName=8.8.0`。
- 主要变化：
  - `RiskAnalyzer` 从单帧硬阈值升级为可解释综合风险函数，输出 `riskScore` 与 `RiskScoreBreakdown`，保留 `RiskLevel`、`RiskDirection`、`ProximityBand` 和兼容用 `urgencyScore`。
  - 新增纯 Kotlin `TemporalRiskTracker`，在 `AssistEngine` 中位于 `RiskAnalyzer` 与 `RiskStabilizer` 之间，使用最近 5 帧、约 900ms 的同目标轨迹判断 `APPROACHING/STABLE/RECEDING`。
  - 逼近趋势默认使用框底部位置、面积增长、中心连续性和可选距离证据，不新增或替换模型资产；侧向目标最多保持中风险，避免把横向经过误升为高风险。
  - `DetectorAbDeviceBenchmarkTest` 兼容可选序列字段，并新增 `approachRiskRecall`、`approachFalsePositiveRate`、`approachDirectionAccuracy`、`approachCriticalMissCount`、`meanTimeToAlertFrames` 和 `approachLabeledSequenceCount`。
- 验证：
  - `.\.venv-export312\Scripts\python.exe scripts\inspect_tflite.py`：通过，默认 yolo11n 输入 `[1, 320, 320, 3] float32`，输出 `[1, 84, 2100] float32`，`assertions=passed`。
  - `:core:assist:test :core:vision:testDebugUnitTest :core:device:testDebugUnitTest :core:ui:testDebugUnitTest :feature:assist:testDebugUnitTest :app:testDebugUnitTest`：通过。
  - `:app:lintDebug :core:vision:lintDebug :core:device:lintDebug :core:ui:lintDebug :feature:assist:lintDebug`：通过。
  - `:app:assembleDebug :app:assembleDebugAndroidTest`：通过。
  - `powershell -ExecutionPolicy Bypass -File .\scripts\run_detector_ab_device_benchmark.ps1 -DatasetKind BlindAssistEvalSet -DatasetRoot test-artifacts.local\datasets\blindassist-evalset-20260527-impl`：通过，设备 `R5CX10M8Y8X`，证据目录 `test-artifacts.local/detector-ab-device-benchmark/20260612-135829`；当前旧 evalset 无序列字段，新增 approach 指标按预期为 `0`。
  - 默认 90 秒真机回归通过，证据目录 `test-artifacts.local/device-regression/20260612-140055`，冷启动 `TotalTime=836` / `WaitTime=840`。
- APK：
  - 本地归档 `E:\linnan\blind-assist-apk-archive\apks\BlindAssist-v8.8.0-debug-20260612-140333.apk`，大小 `47,288,840` bytes，SHA256 `017CF063FFD651270335DDD3033E5018C64A86A8BD78351D2F4B9C1B16D23364`。
  - 里程碑同步 `releases/apk/BlindAssist-v8.8.0-debug-20260612-140333.apk`。

## v8.3.0 - 生命周期串行化、隐私备份与英文无障碍一致性

- 状态：已完成本地单测、lint、构建、Compose 真机用例和 90 秒真机回归验证，`versionCode=31`，`versionName=8.3.0`。
- 主要变化：
  - `feature:assist` 新增 `AssistRuntimeLifecycleGate`，统一串行化相机会话、帧处理和反馈关闭边界；停止/关闭时先拒收新帧，再等待在途帧完成，最后 reset processor、关闭 detector 和 shutdown feedback。
  - `AssistFrameProcessor` 在处理前登记在途帧，stop/shutdown 后的新帧会立即关闭且不进入 detector；`AssistRuntimeEffectExecutor` 在 Start/Stop/Reset/Close 路径中按固定顺序进入 gate。
  - `CameraXFrameSource` 增加 session generation 与 lifecycle lock，late provider callback 在 stop/close/shutdown 后不会重新 bind 或触发过期 `onStarted`；`shutdown()` 继续保持幂等与 analyzer executor 有界等待。
  - `FeedbackController` 用生命周期锁串行 `applySettings`、`notify` 和 `shutdown`，shutdown 后不再触达 speech/haptic output。
  - Manifest 保留 `allowBackup=true`，新增 `dataExtractionRules` 与 `fullBackupContent`，系统备份/设备迁移只 include `sharedpref/blindassist_user_preferences.xml`，不备份帧、日志、缓存、测试证据或其他本地文件。
  - 英文模式下补齐相机返回 `Back to features`、底部导航、Profile 状态、权限/拒绝/眼镜占位弹窗，以及 Compose 测试定位的中英文兼容。
- 验证：
  - `.\.venv-export312\Scripts\python.exe scripts\inspect_tflite.py`：通过，默认 yolo11n 输入 `[1, 320, 320, 3] float32`，输出 `[1, 84, 2100] float32`，`assertions=passed`。
  - `:core:assist:test :core:vision:testDebugUnitTest :core:device:testDebugUnitTest :core:ui:testDebugUnitTest :feature:assist:testDebugUnitTest :app:testDebugUnitTest`：通过。
  - `:app:lintDebug :core:vision:lintDebug :core:device:lintDebug :core:ui:lintDebug :feature:assist:lintDebug`：通过。
  - `:app:assembleDebug :app:assembleDebugAndroidTest`：通过；期间修正 androidTest 中 `assertDoesNotExist` API 兼容、设置页测试标签和 Android 16 debug app 兼容性弹窗处理。
  - `:app:connectedDebugAndroidTest` 完整矩阵未作为通过证据：设备端历史 `DetectorAbDeviceBenchmarkTest` 在约 40 秒后进程被 signal 9 kill，UTP 报 `Process crashed`。随后按类过滤运行本轮相关 Compose instrumentation：`BlindAssistComposeTest` 与 `CameraControlPanelStandaloneTest` 共 11 个用例通过。
  - `powershell -ExecutionPolicy Bypass -File .\scripts\run_device_regression.ps1 -SampleSeconds 90`：通过，证据目录 `test-artifacts.local/device-regression/20260611-173421`。
- APK：
  - 完整本地归档 `E:\linnan\blind-assist-apk-archive\apks\BlindAssist-v8.3.0-debug-20260611-174127.apk`，大小 `47,490,277` bytes，SHA256 `26217859834CE2907288BA38939E50AEDEFFCE9A59735D53C6ACA641C414BE25`。
  - 本轮不默认提交 `releases/apk/` 里程碑 APK。

## v8.2.0 - 相机可靠性与无障碍修复

- 状态：已完成本地与真机验证，`versionCode=30`，`versionName=8.2.0`。
- 主要变化：
  - 相机关闭时清空运行时的 view-ready 状态和旧 `PreviewView` / overlay 引用，重新打开必须等待新的 `AndroidView` 创建后再绑定 CameraX，避免旧预览 surface 导致黑屏或预览不更新。
  - `CameraXFrameSource.shutdown()` 对 analyzer executor 做有界等待；`TfliteYoloDetector.detectFrame()` 与 `close()` 使用同一把生命周期锁，避免推理与 interpreter/delegate close 交叉。
  - TFLite 初始化把 labels 加载纳入同一失败路径，模型校验失败时会关闭已创建的 interpreter/delegate。
  - 相机页 `CompactAction` 不再给普通动作统一声明“已启用/未启用”；真正的 toggle 和 debug 展开态保留本地化 `stateDescription`。
  - 相机底部面板增加导航栏避让、最大高度和内部滚动，大字体与 debug 展开时仍可访问关键控件。
  - `scripts/inspect_tflite.py` 从只打印升级为断言模型存在、输入 `[1,320,320,3] float32`、输出 `[1,84,2100] float32`，CI 增加模型检查和 `:app:assembleDebugAndroidTest`。
- 验证：
  - `.\.venv-export312\Scripts\python.exe scripts\inspect_tflite.py`：通过，使用 `ai-edge-litert` 后端，输入 `[1, 320, 320, 3] float32`，输出 `[1, 84, 2100] float32`，`assertions=passed`。
  - `:core:assist:test :core:vision:testDebugUnitTest :core:device:testDebugUnitTest :core:ui:testDebugUnitTest :feature:assist:testDebugUnitTest :app:testDebugUnitTest`：通过。
  - `:app:lintDebug :core:vision:lintDebug :core:device:lintDebug :core:ui:lintDebug :feature:assist:lintDebug`：通过。
  - `:app:assembleDebug :app:assembleDebugAndroidTest`：首次因新增大字体 androidTest 缺少 Compose foundation 测试依赖失败；补充 `androidTestImplementation(libs.androidx.compose.foundation)` 后通过。
  - `:app:connectedDebugAndroidTest`：在 Samsung `SM-S9280 - 16` / serial `R5CX10M8Y8X` 上通过，7 个 Compose 仪器测试 0 failures。期间新增大字体组件测试先后暴露 `MainActivity` 已设置 content 与 `FPS` 文本匹配不唯一两个测试写法问题，修正后重跑通过。
  - `powershell -ExecutionPolicy Bypass -File .\scripts\run_device_regression.ps1 -SampleSeconds 90`：通过，证据目录 `test-artifacts.local-device-regression-20260526-231417`。
- APK：
  - 完整本地归档 `E:\linnan\blind-assist-apk-archive\apks\BlindAssist-v8.2.0-debug-20260526-215736.apk`，大小 `47,238,655` bytes，SHA256 `068F2515954F8D96D3BBE92B9D788725ED54872FBB1E54CDCE1DFEA9FC877027`。
  - 本次为 `+0.1` 小版本，未提交 Git 里程碑 APK。

## v8.1.0 - 真实使用体验 UI 升级

- 状态：已完成，`versionCode=29`，`versionName=8.1.0`。
- 主要变化：
  - 功能页改为日常辅助启动台，先展示当前行走任务、场景、提醒档位和 Care Mode 状态，再突出 `使用手机摄像头` 主入口。
  - 日常使用向导继续保留五个既有预设，不新增偏好 key、不改变场景/档位/语音/震动映射。
  - 相机页底部面板重排为主要风险状态、行动建议、场景/模式、检测/语音/震动核心开关优先；快捷调安静、调敏感、场景切换和调试信息降级到更多调整区域。
  - Care Mode 成为低干扰相机体验：放大主要指导语、提高面板对比度、隐藏快捷调节和调试入口，只保留必要控制。
  - 设置页按“界面与辅助、提醒方式、行走场景、调试与记录”分组，保留既有中英文 TalkBack 文案和 Compose testTag 契约。
  - 本轮不修改 CameraX/TFLite/风险规则/反馈策略，不新增联网、蓝牙、定位、存储或新的显示模式偏好。
- 验证：
  - `.\gradlew.bat :core:ui:testDebugUnitTest :feature:assist:testDebugUnitTest :app:testDebugUnitTest --no-daemon --console=plain`：通过。
  - `.\gradlew.bat :app:lintDebug :core:ui:lintDebug :feature:assist:lintDebug :app:assembleDebug :app:assembleDebugAndroidTest --no-daemon --console=plain`：通过。
  - `.\gradlew.bat :app:connectedDebugAndroidTest --no-daemon --console=plain`：首次因设备端旧签名包安装冲突失败，确认包状态清理后重跑通过，`SM-S9280 - 16` 上 6 个 Compose 仪器测试通过。
  - `powershell -ExecutionPolicy Bypass -File .\scripts\run_device_regression.ps1 -SampleSeconds 90`：通过，证据目录 `test-artifacts.local-device-regression-20260525-222502`，冷启动 `TotalTime: 761` / `WaitTime: 762`，设备端包信息 `versionName=8.1.0` / `versionCode=29`。
- APK：
  - `releases/apk/BlindAssist-v8.1.0-debug-20260525-222724.apk`，大小 `47,238,663` bytes，SHA256 `A48769A7A9F5233526DDD936AF40A6DB9321DBFD163E648D098D1F16576F94D8`。

## v7.6.0 - 运行时管线与发布卫生更新
- 状态：已完成，`versionCode=28`，`versionName=7.6.0`。
- 主要变化：
  - `AssistRuntimeController` 收敛为较薄的入口；帧处理、运行时效果执行、相机生命周期适配、渲染、设置/配置同步和帧管线统计拆分到更小的协作者。
  - 实时 CameraX 路径改为传递可关闭的 `VisionFrame` / `RgbaVisionFrame`，避免 analyzer 路径逐帧分配 `Bitmap` 和旋转后的 `Bitmap`。
  - `ImagePreprocessor` 可在采样旋转时直接把 RGBA 帧缓冲写入模型输入 buffer；原有 Bitmap 路径继续保留用于兼容。
  - 运行时性能日志和调试指标新增 dropped-frame rate 以及 P50/P95 推理耗时。
  - 新增真机回归、APK 归档和 APK 校验脚本；release 构建启用 R8/resource shrink，并要求本地未跟踪签名配置。
  - 历史已跟踪 `test-artifacts/` 证据复制到本地归档，并从后续 Git 跟踪中移除。
- 验证：
  - `.\.venv-export312\Scripts\python.exe scripts\inspect_tflite.py`：通过，输入 `[1, 320, 320, 3] float32`，输出 `[1, 84, 2100] float32`。
  - 完整多模块单元测试矩阵通过。
  - 完整多模块 lint 矩阵通过。
  - `:app:assembleDebug :app:assembleDebugAndroidTest` 通过。
  - 缺少 `keystore.properties` 时运行 `:app:assembleRelease`，按预期失败并给出明确的本地签名配置提示。
- APK：
  - `releases/apk/BlindAssist-v7.6.0-debug-20260525-004833.apk`, size `47,222,231` bytes, SHA256 `2DE5CE894D0C46A8D099000B6E2624DA4B102E61A0E31BE8F501252D102520DC`.

## v7.1.0 - 反馈触达与 CameraX 可靠性更新

- 状态：已完成，`versionCode=27`，`versionName=7.1.0`。
- 主要变化：
  - 反馈链路改为真实触达语义：只有 TTS 或震动输出被系统 API 接受后才返回 `TRIGGERED`，否则返回 `FEEDBACK_UNAVAILABLE` 且不写入冷却/疲劳记录。
  - `core:device` 新增 library manifest 声明 `VIBRATE`，震动实现固定使用 minSdk 26+ 的 `VibrationEffect` 路径，修复多模块 lint 对权限契约的漏检/误报。
  - CameraX analyzer 和 frame processing 异常统一走 `CameraSourceFailed`，进入错误态后停止相机、清空 overlay 并重置会话；runtime 配置改为 atomic 快照，单帧处理使用同一份配置。
  - TTS、震动、CameraX 和 TFLite 可恢复路径会重新抛出 `VirtualMachineError`、`ThreadDeath` 和 `LinkageError` 等 fatal 错误，避免把严重运行时问题吞掉。
  - TFLite YOLO 输出解析拆出可测 helper，并新增 golden JVM 测试覆盖 confidence threshold、label mapping、letterbox 坐标回映射和 same-class NMS。
  - README、CI lint 矩阵和 APK 归档材料同步到多模块验证方式。
- 验证：
  - `.\gradlew.bat :core:assist:test :core:device:testDebugUnitTest :core:vision:testDebugUnitTest :feature:assist:testDebugUnitTest --no-daemon --offline --console=plain`：通过。
  - 完整显式多模块单测、显式多模块 lint、debug/androidTest APK 构建和模型检查均通过；设备端 `connectedDebugAndroidTest` 未运行，因为 `adb devices` 当前无在线设备。
- APK：
  - `releases/apk/BlindAssist-v7.1.0-debug-20260524-162936.apk`，大小 `47,205,843` bytes，SHA256 `5ADA5DC82A71AABDA3438C76CA7E7AA9341C15FDD11308C2861E9695AD75F323`。

## v6.9.0 - 完整多模块架构迁移

- 状态：已完成，`versionCode=25`，`versionName=6.9.0`。
- 主要变化：
  - 将项目从单 `:app` 模块拆分为 `:app`、`:feature:assist`、`:core:assist`、`:core:vision`、`:core:device` 和 `:core:ui`。
  - `:core:assist` 保持纯 Kotlin，承载模型、提醒档位、风险规则、会话编排、定位文案、日常模式和反馈规划契约。
  - `:core:vision` 承载 TFLite YOLO 检测器和图像预处理；`:core:device` 承载 CameraX、ImageProxy 转换、SharedPreferences 偏好和 Android TTS/震动反馈；`:core:ui` 承载 Compose 页面、UI 状态、guidance/summary mapper 和 overlay。
  - `:feature:assist` 承载 Hilt ViewModel、runtime 状态机/controller/config applier 和运行期依赖模块；`:app` 保留启动入口、manifest、资源、模型 assets 和 APK 配置。
  - 本轮为零用户可见行为迁移：UI 流程、权限、YOLO 模型路径、CameraX/TFLite 链路、风险阈值、SharedPreferences key、隐私边界、Room/DataStore、联网、蓝牙和存储行为均保持不变。
- 验证：
  - `.\gradlew.bat :core:assist:test --no-daemon`：通过。
  - `.\gradlew.bat :core:vision:testDebugUnitTest :core:device:testDebugUnitTest :core:ui:testDebugUnitTest :feature:assist:testDebugUnitTest --no-daemon`：通过。
  - `.\gradlew.bat :app:testDebugUnitTest :app:lintDebug :app:assembleDebug --no-daemon`：通过，生成 debug APK。
  - 首次新增 Android library plugin marker 和 AndroidX transitive dependency 时，普通沙箱因网络权限受限失败；随后按仓库已知沙箱限制提权解析依赖后继续验证。
- APK：
  - `releases/apk/BlindAssist-v6.9.0-debug-20260522-204908.apk`，大小 `47,205,843` bytes。

## v6.4.0 - Runtime 状态机与 Hilt 依赖拆分

- 状态：已完成，`versionCode=24`，`versionName=6.4.0`。
- 主要变化：
  - 接入 Hilt：新增 `@HiltAndroidApp` Application，`MainActivity` 改为 `@AndroidEntryPoint`，`BlindAssistViewModel` 改为 `@HiltViewModel`，由 Hilt 提供偏好、反馈、检测器、会话编排和相机源工厂依赖。
  - 新增纯 Kotlin `AssistRuntimeStateMachine`，集中管理 Idle、权限说明、权限请求、启动中、运行中、检测暂停、权限拒绝和错误状态；`AssistRuntimeController` 退为 effect executor。
  - 新增 `AssistRuntimeConfig` 和 `RuntimeConfigApplier`，把反馈开关、Care Mode、提醒档位、场景、语音风格、震动强度、语言和日常模式收敛成单一 runtime 配置快照。
  - 相机页补强状态反馈：相机启动中、模型不可用、检测已暂停、权限拒绝和启动失败都有明确 guidance；主视觉结构、模型、风险阈值、权限集合、SharedPreferences key、Room/DataStore、联网、蓝牙、存储和单模块结构保持不变。
  - Hilt 使用 `2.55` 而不是原计划的 `2.59.2`，因为 `2.59.2` Gradle 插件要求 AGP 9+，当前项目仍保持 AGP `8.7.3` 以避免扩大迁移范围。
- 验证：
  - 已运行 `.\gradlew.bat :app:testDebugUnitTest --no-daemon`，JVM 单元测试通过。
  - 已运行 `.\gradlew.bat :app:lintDebug :app:assembleDebug --no-daemon`，构建成功，lint 结果为 `0 errors, 15 warnings`。
  - 新增 JVM 测试覆盖 runtime 状态机的权限、视图晚到、检测暂停/恢复、启动失败、关闭相机和模型不可用路径，以及 runtime 配置的日常模式、快捷模式、自定义回退和语言/反馈开关同步。
- APK：
  - `app/build/outputs/apk/debug/app-debug.apk`，大小 `47,205,607` bytes。

## v5.9.0 - 测试稳定性与相机调试控件修复

- 状态：已完成，`versionCode=23`，`versionName=5.9.0`。
- 主要变化：
  - 修复 v5.8.0 真机完整测试中发现的相机页 `展开调试信息` ADB 点击不稳定问题：调试开关改用与其他相机控制一致的 `CompactAction` 按钮，位置上移到 Care Mode 和场景切换之前，并暴露明确的 `展开相机调试信息` / `收起相机调试信息` content description。
  - 修复设备端 Compose 测试在相机路径上的等待条件：测试现在显式授予相机权限，识别文本和 content description，打开相机前重置为 通用日常，避免 Care Mode 隐藏 Debug 控件，并在相机路径用例结束后关闭相机页。
  - 本轮不修改 YOLO 模型、CameraX/TFLite 推理链路、风险阈值、权限、联网、蓝牙、存储、Hilt、多模块、Room 或 DataStore。
- 验证：
  - 已按本仓库已知 Gradle 沙箱限制直接提权运行 `:app:testDebugUnitTest :app:assembleDebug --no-daemon`，构建成功。
  - JVM 单元测试结果：105 tests，0 failures，0 errors，0 skipped。
  - 已按本仓库已知 Gradle/设备测试沙箱限制直接提权运行 `:app:connectedDebugAndroidTest --no-daemon`，在 `SM-S9280 - 16` 上完成 6 个 Compose 仪器测试，0 failures，0 errors，0 skipped。
  - 已安装 v5.9.0 debug APK 到 `SM-S9280`，包信息核对为 `versionCode=23`、`versionName=5.9.0`，冷启动返回 `Status: ok`、`LaunchState: COLD`、`TotalTime: 676`。
  - 已用 ADB/UIAutomator 复测相机页 Debug 开关：点击 `展开相机调试信息` 后 UI 变为 `收起相机调试信息`，确认修复 v5.8.0 中的可点击性问题。
- APK：
  - `releases/apk/BlindAssist-v5.9.0-debug-20260519-174352.apk`

## v5.8.0 - 日常使用向导与一键模式

- 状态：已完成，`versionCode=22`，`versionName=5.8.0`。
- 主要变化：
  - Features 页新增日常使用向导，提供 通用日常、室内慢行、走廊通行、密集区域、户外慢行 五个日常预设。
  - 预设只映射到现有本地偏好：使用场景、提醒档位、语音风格、震动强度和 Care Mode；不新增单独模式持久化 key，手动调整后的组合显示为 自定义 / Custom。
  - 相机页显示当前日常模式，并将原来的提醒档位循环按钮改为 调安静 / 调敏感 两个明确快捷操作；两者保留当前场景，只调整提醒强度组合。
  - 新增中英文文案、TalkBack action-oriented content description、48dp+ 触控目标和 Compose 测试覆盖。
  - 本轮不修改 YOLO 模型、CameraX/TFLite 链路、风险阈值、权限、联网、蓝牙、存储、Hilt、多模块、Room 或 DataStore。
- 验证：
  - 已按本仓库已知 Gradle 沙箱限制直接提权运行 `:app:testDebugUnitTest :app:assembleDebug --no-daemon`，命令退出码为 0。
  - JVM 单元测试结果：105 tests，0 failures，0 errors，0 skipped。
  - debug APK 已安装到 `SM-S9280`，包信息核对为 `versionCode=22`、`versionName=5.8.0`，冷启动命令返回 `Status: ok`、`LaunchState: COLD`、`TotalTime: 679`。
  - `connectedDebugAndroidTest` 未执行：设备在线且重复 wireless ADB serial 已断开，但窗口状态仍为 `mDreamingLockscreen=true`、焦点在 `NotificationShade`，不适合运行 Compose 仪器测试。
- APK：
  - `releases/apk/BlindAssist-v5.8.0-debug-20260519-120747.apk`

## v5.3.0 - TalkBack、大字体与中英文切换

- 状态：已完成，`versionCode=21`，`versionName=5.3.0`。
- 主要变化：
  - 新增持久化 `AppLanguage` 偏好，设置页提供 `中文` / `English` App 内语言切换，默认仍为中文。
  - 核心体验文案支持中英文：语音提醒模板、提醒档位、使用场景、语音风格、震动强度、相机状态、风险解释、现场测试摘要和 TalkBack 语义。
  - `FeedbackController` 根据 App 内语言切换 TTS locale，中文使用 `Locale.CHINA`，英文使用 `Locale.US`。
  - 设置页选择器改为更适合大字体的 48dp+ 全宽控件，并补强 state description、action-oriented content description 和 heading 语义。
  - 本轮不修改 YOLO 模型、风险阈值、场景策略、权限、联网、蓝牙、存储、Hilt、多模块、Room 或 DataStore。
- 验证：
  - 已按本仓库已知 Gradle 沙箱限制直接提权运行 `:app:testDebugUnitTest :app:assembleDebug --no-daemon`，构建和 JVM 单元测试通过。
  - 首次 `connectedDebugAndroidTest` 在 `SM-S9280` wireless ADB 设备在线时尝试执行，但由于重复 mDNS serial / UTP 状态卡住，在约 184 秒后超时。
  - 随后断开重复的 `(2)` wireless ADB serial，只保留 `adb-R5CX10M8Y8X-nkVxqz._adb-tls-connect._tcp`，安装 v5.3.0 APK 到 `SM-S9280`，包信息核对为 `versionCode=21`、`versionName=5.3.0`，应用冷启动成功。
  - 设置 `ANDROID_SERIAL` 后重跑 `:app:connectedDebugAndroidTest --no-daemon`，在 `SM-S9280 - 16` 上完成 5 个 Compose 仪器测试，0 skipped，0 failed，`BUILD SUCCESSFUL in 45s`。
- APK：
  - `releases/apk/BlindAssist-v5.3.0-debug-20260519-113731.apk`

## v4.8.0 - 单模块质量升级

- 状态：已完成，`versionCode=20`，`versionName=4.8.0`。
- 主要变化：
  - 保持单模块、原生 Android/Kotlin、CameraX、TFLite、Compose 和 SharedPreferences，不引入 Hilt、多模块、新权限、联网、蓝牙、定位、Room 或 DataStore。
  - 新增 `ObjectDetector`、`DetectorFrameResult`、`FrameSource`、`CameraXFrameSource`、`AssistSessionCoordinator`、`FpsTracker`、`CameraGuidanceMapper` 和 `FieldTestSummaryMapper`，把检测输出、相机取流、会话编排、FPS 统计和 UI 状态映射从 `MainActivity` 中拆出。
  - `MainActivity` 缩减为生命周期、权限、Compose 绑定和用户设置转发入口；v4.3.0 移除 App 内展示中心的主界面形态继续保留。
  - 新增 JVM 测试覆盖会话编排、FPS 统计、风险指导 UI 映射和现场测试摘要映射。
- 验证：
  - `:app:testDebugUnitTest` 和 `:app:assembleDebug` 构建验证通过。
  - `connectedDebugAndroidTest` 已尝试两次：mDNS serial 未被 Gradle 识别，普通 Wi-Fi serial 随后变为 `offline`，因此本轮未获得仪器测试通过结果。
- APK：
  - `releases/apk/BlindAssist-v4.8.0-debug-20260519-005155.apk`

## v4.3.0 - 移除项目展示中心

- 状态：已完成，`versionCode=19`，`versionName=4.3.0`。
- 主要变化：
  - 暂时移除 Features 页里的 App 内“项目展示中心”，减少当前主界面的展示包装。
  - Features 页保留 `使用手机摄像头`、`连接眼镜设备` 占位、安全边界和模型/版本状态。
  - 新手引导回放继续保留在 Settings 页，课堂/答辩材料继续保留在 `README.md`、`CHANGELOG.md`、`DEMO_GUIDE.md` 和 APK 归档中。
  - 本轮不修改 CameraX/TFLite 检测链路、场景化提醒策略、权限、联网、蓝牙、存储或架构形态。
- 验证：
  - `:app:testDebugUnitTest`、`:app:assembleDebug` 和 `:app:assembleDebugAndroidTest` 构建验证通过。
  - debug APK 已安装到 `SM-S9280`，包信息核对为 `versionCode=19`、`versionName=4.3.0`。
  - Compose 仪器测试删除展示中心专项覆盖，保留底部导航、手机摄像头入口、设置反馈控件和相机页场景/风险解释区域覆盖。
- APK：
  - `releases/apk/BlindAssist-v4.3.0-debug-20260519-003109.apk`

## v4.2.0 - 场景化提醒与风险解释

- 状态：已完成，`versionCode=18`，`versionName=4.2.0`。
- 主要变化：
  - 新增手动 `使用场景` 偏好：通用、室内慢行、走廊通行、密集区域、户外慢行。
  - 通用场景保持 v4.1.0 提醒行为；其他场景只调整规则层的中风险确认、提醒保持、近距冷却和震动时长。
  - 相机控制面板显示当前场景和最近风险解释，说明已触发、未稳定、距离较远、冷却中、提醒保持或暂无可反馈风险等原因。
  - 现场测试摘要追加当前场景和最近解释；Care Mode 下保留简短解释，不暴露性能调试细节。
  - 本轮不新增自动场景识别、联网、定位、蓝牙、存储权限、模型变更或大型架构框架。
- 验证：
  - `:app:testDebugUnitTest` 和 `:app:assembleDebug` 构建验证通过。
  - debug APK 已安装到 `SM-S9280`，包信息核对为 `versionCode=18`、`versionName=4.2.0`。
  - Compose 仪器测试增加使用场景选择和相机页解释区域覆盖；本轮 `connectedDebugAndroidTest` 已尝试执行，但设备处于锁屏/Bouncer 状态，报告 `No compose hierarchies found in the app`，未作为通过证据。
- APK：
  - `releases/apk/BlindAssist-v4.2.0-debug-20260519-000200.apk`

## v4.1.0 - 展示交付加强

- 状态：已完成，`versionCode=17`，`versionName=4.1.0`。
- 主要变化：
  - 新增 App 内“项目展示中心”，集中说明本地识别、语音/震动提醒、现场测试摘要和原型安全边界。
  - 展示中心提供“开始演示”和“查看引导”操作，复用现有手机摄像头权限说明与新手引导流程。
  - 新增 `DEMO_GUIDE.md`，整理课堂/答辩演示脚本、环境准备、无设备 fallback、隐私与安全边界。
  - 扩展 Compose 仪器测试，覆盖底部导航、展示中心、相机演示入口和新手引导入口。
- 验证：
  - `:app:testDebugUnitTest`、`:app:assembleDebug` 和 `:app:assembleDebugAndroidTest` 构建验证通过。
  - 重新连接设备后，`connectedDebugAndroidTest` 已在 `SM-S9280 - 16` 上完成 4 个 Compose 仪器测试并通过。
  - debug APK 已安装到 `SM-S9280`，包信息核对为 `versionCode=17`、`versionName=4.1.0`。
- APK：
  - `releases/apk/BlindAssist-v4.1.0-debug-20260518-231542.apk`

## v3.6.0 - 日常使用体验增强

- 主要变化：
  - 新增语音风格：简短、标准、详细。
  - 新增震动强度：轻柔、标准、强。
  - 新增非迫近近距提醒疲劳控制，减少连续提醒打扰。
  - Overlay 检测框增加显示层平滑，风险规则近距阈值略收紧。
  - 新增并修复最小 Compose 仪器测试宿主。
- 验证：
  - JVM 单元测试、debug APK 构建、`connectedDebugAndroidTest` 和手机安装均通过。
- APK：
  - `releases/apk/BlindAssist-v3.6.0-debug-20260518-214947.apk`

## v3.5.0 - ViewModel 与 StateFlow 轻量状态拆分

- 主要变化：
  - Compose 可观察状态集中到 `BlindAssistViewModel`，通过只读 `StateFlow` 暴露。
  - `MainActivity` 保留 CameraX、权限、TFLite、反馈控制和生命周期边界。
- 验证：
  - JVM 单元测试、debug APK 构建和手机安装均通过。
- APK：
  - `releases/apk/BlindAssist-v3.5.0-debug-20260518-193819.apk`

## v3.4.0 - 现场测试摘要与无障碍语义

- 主要变化：
  - 新增内存态现场测试摘要，展示运行时长、风险次数、提醒次数、FPS、推理耗时和当前提醒档位。
  - 设置页、相机控制区和摘要标题补充更自然的 TalkBack 语义。
- 验证：
  - JVM 单元测试、debug APK 构建和手机安装均通过。
- APK：
  - `releases/apk/BlindAssist-v3.4.0-debug-20260518-192333.apk`

## v3.3.0 - 首次使用引导与相机权限说明

- 主要变化：
  - 新增三页新手引导，说明手机摄像头本地识别、语音/震动提醒和原型安全边界。
  - 相机权限请求前增加应用内解释，说明不上传、不联网、不保存视频。
- 验证：
  - JVM 单元测试和 debug APK 构建通过；该轮手机安装因 ADB 无设备未完成。
- APK：
  - `releases/apk/BlindAssist-v3.3.0-debug-20260518-154943.apk`

## v3.2.0 - 相机返回路径与个人主页精简

- 主要变化：
  - 相机沉浸页支持系统返回手势，统一关闭相机并回到主界面。
  - 个人主页移除展示说明卡，保留用户、设备、版本和偏好状态。
- 验证：
  - JVM 单元测试、debug APK 构建和手机安装均通过。
- APK：
  - `releases/apk/BlindAssist-v3.2.0-debug-20260518-152635.apk`

## v3.1.0 - Compose 应用壳层与界面革新

- 主要变化：
  - 引入 Compose + Material 3 主壳、品牌启动页、底部导航、功能页、个人主页、设置页和沉浸式相机子页。
  - 保留原有 CameraX、TFLite、风险分析、提醒档位、语音和震动链路。
- 验证：
  - JVM 单元测试、debug APK 构建和手机安装均通过。
- APK：
  - `releases/apk/BlindAssist-v3.1.0-debug-20260518-151146.apk`

## v2.6.0 - 显示可信度打磨

- 主要变化：
  - 区分当前帧检测和短暂保持提醒。
  - 默认用户文案隐藏数值 urgency，调试信息保留详细指标。
  - 中心区域改为观察参考区，避免误解为真实检测框。
- 验证：
  - debug APK 构建和手机安装均通过。
- APK：
  - `releases/apk/BlindAssist-v2.6.0-debug-71f921d-current.apk`

## v2.5.0 - 现场可测助行体验

- 主要变化：
  - 新增纯 Kotlin `AssistEngine` 和 `SessionTrace`，把检测结果、风险分析、稳定策略和反馈决策串成可测试会话层。
  - 调试区显示最近会话摘要，近处和迫近语音更偏行动提示。
- 验证：
  - JVM 单元测试、debug APK 构建和手机安装均通过。
- APK：
  - `releases/apk/BlindAssist-v2.5.0-debug-e803d1f-rebuilt.apk`

## v2.0.0 - 提醒档位与 CameraX API 更新

- 主要变化：
  - 新增 Quiet、Standard、Sensitive 三档提醒策略。
  - 风险稳定、语音冷却、震动时长随档位调整。
  - CameraX 分析分辨率迁移到 `ResolutionSelector`。
- 验证：
  - JVM 单元测试、debug APK 构建和手机安装均通过。
- APK：
  - `releases/apk/BlindAssist-v2.0.0-debug-52a0c93-rebuilt.apk`

## v1.5.0 - 用户偏好持久化

- 主要变化：
  - 持久化语音提醒、震动提醒和关怀模式。
  - 检测开关保持 session-only，每次启动默认开启。
- 验证：
  - JVM 单元测试、debug APK 构建和手机安装均通过。
- APK：
  - `releases/apk/BlindAssist-v1.5.0-debug-f6b6d5e-rebuilt.apk`

## v1.4.0 - 相机画面填充与覆盖层映射

- 主要变化：
  - 预览画面改为填满屏幕，减少顶部黑边。
  - Overlay 坐标映射对齐填充裁剪后的预览。
- 验证：
  - debug APK 构建通过。
- APK：
  - `releases/apk/BlindAssist-v1.4.0-debug-f96c6f7-rebuilt.apk`

## v1.3.0 - 相机界面重设计

- 主要变化：
  - 新增品牌/状态头部、风险徽章、两行控制区和关怀模式。
  - 关怀模式放大指导语、提高对比度并隐藏调试细节。
- 验证：
  - debug APK 构建通过。
- APK：
  - `releases/apk/BlindAssist-v1.3.0-debug-e29b99a-rebuilt.apk`

## v0.8.0 - 实时界面交互升级

- 主要变化：
  - 分离主风险状态、控制开关和可折叠调试信息。
  - 改善检测、语音、震动开关的可访问描述。
- 验证：
  - debug APK 构建通过。
- APK：
  - `releases/apk/BlindAssist-v0.8.0-debug-4bf9ad2-rebuilt.apk`

## v0.7.0 - 相对距离风险提醒

- 主要变化：
  - 新增 FAR、MID、NEAR、CRITICAL 相对距离分层和 urgency score。
  - FAR/MID 主要用于视觉状态，NEAR/CRITICAL 才进入语音和震动提醒路径。
- 验证：
  - JVM 单元测试、debug APK 构建和手机安装均通过。
- APK：
  - `releases/apk/BlindAssist-v0.7.0-debug-d948f6b-rebuilt.apk`

## v0.2.0 - 风险提醒稳定化

- 主要变化：
  - 新增 `RiskStabilizer`，高风险单帧确认，中风险需要连续帧确认。
  - 短暂漏检时保持已确认提醒，减少语音/震动抖动。
- 验证：
  - JVM 单元测试和 debug APK 构建通过。
- APK：
  - `releases/apk/BlindAssist-v0.2.0-debug-fb937da-rebuilt.apk`

## v0.1.0 - 第一版本地检测原型

- 主要变化：
  - CameraX 获取实时摄像头画面。
  - 本地加载 YOLO11n TFLite 模型，解析检测框并绘制 overlay。
  - 初版规则层生成助盲避障提醒。
- 验证：
  - debug APK 构建通过。
- APK：
  - `releases/apk/BlindAssist-v0.1.0-debug-958d5a9-rebuilt.apk`