v5.9.8

v5.9.8: 依赖安全更新 + 两轮代码优化 (净 -3.4k 行)

v5.9.7

VisionLink Android v5.9.7

本次更新 · Gemma 4 端侧模型自动下载

• 首次使用 EDGE(端侧) 引擎时自动提示下载 Gemma 4 E2B 模型（约 2.6GB），一键开始
• WorkManager 前台服务下载：切后台 / 杀掉 App 也不中断，通知栏实时显示进度
• 断点续传（HTTP Range + .part 临时文件），网络中断可继续
• 国内镜像加速：优先 hf-mirror.com，免 token 直连；失败自动回退 huggingface
• 主界面进度提示：下载中在主界面实时显示百分比

兼容性

• 签名与 v5.9.6 一致（同一 debug 证书），可直接覆盖更新，无需卸载
• minSdk 31 / targetSdk 35 / compileSdk 35
• release 变体（R8 minify + resource shrink）

说明

端侧 Gemma 首次需下载模型；若只用云端引擎（STEPFUN 等）无需下载。YOLO 视觉避障、OCR 读字、场景描述不受影响。

---

构建：release 变体 · JDK 17 · 由 nieao 协助 MichaelQiu(cpufreestyle) 构建发布。

v5.9.6

VisionLink Android v5.9.6

🐛 修复启动闪退（关键）

v5.9.5 一启动即崩溃。根因：布局使用 MaterialButton，而 AndroidManifest 主题为 Theme.AppCompat，二者不兼容导致 inflate 时崩溃。

修复：主题改为 Theme.MaterialComponents.Light.DarkActionBar.Bridge（Bridge 主题保留 AppCompat 外观，同时支持 Material 组件）。

📦 变更

• AndroidManifest.xml：AppCompat 主题 → MaterialComponents Bridge
• build.gradle.kts：versionCode 595 → 596，versionName 5.9.5 → 5.9.6
• 新增完整项目学习教程（docs/visionlink-tutorial.html，11 章）

📲 安装

下载 visionlink-android-v5.9.6.apk 直接安装（debug 版）。

• SHA256：698c57154bdd25c5d6b6373acfa2556667304ff0cbb4c96725626ced85995b21
• versionCode 596 / versionName 5.9.6

⚠️ 说明

• 本 APK 为本地编译（仓库 CI 的 build-apk workflow 存在 startup_failure，需后续单独修复）。
• 未内嵌任何 API Key / Token（空 key 构建，公开安全）。
• 早期会话的 catch(Throwable) 防御性加固此前因重新 pull 丢失，本次仅重新应用了已确认的崩溃根因修复。

v5.9.5

VisionLink Android v5.9.5

修复内容

崩溃诊断增强

• 嵌入 GitHub Token：CrashReporter 现在自动使用内置 Token 上传崩溃日志到 GitHub Issues，无需手动配置
• Native 库兼容性：启用 extractNativeLibs 和 useLegacyPackaging，解决 ML Kit 等 native 库的加载兼容性问题
• CrashReporter 安全防护：CrashReporter 初始化添加 try-catch 保护

已知问题修复（继承 v5.9.4）

• 移除 YoloDetector 中显式 Delegate 设置（使用 MediaPipe 默认值）
• 添加 OkHttp/Okio ProGuard 规则
• 移除 BOM 字符

如果此版本仍然闪退，崩溃日志将自动上传到 GitHub Issues，开发者可以远程查看并修复。

v5.9.4

VisionLink Android v5.9.4

修复内容

1. 修复 v5.9.3 闪退问题（关键）

• 回退 YoloDetector 中的 Delegate 显式设置，恢复使用 MediaPipe 默认值
• 某些设备上 release 构建中显式设置 Delegate.CPU 会导致初始化崩溃
• 保留初始化前验证模型文件存在的改进
• 保留关键日志使用 Log.w/Log.e 的改进

2. 添加 OkHttp ProGuard 保护

• 新增 okhttp3/okio 的 keep 规则，防止 R8 在 release 构建中误删类
• 防止 ConnectionPool 等 OkHttp 类被混淆导致运行时崩溃

3. 移除文件 BOM 字符

• 修复 MainActivity.kt 中引入的 BOM 字符

注

v5.9.3 的其他改进（模型搜索路径扩展、文件选择器、API 连接池、版本号解析修复）均已保留。

v5.9.3

VisionLink Android v5.9.3

修复内容

1. YOLO 模型初始化失败修复

• 添加显式 CPU 代理（Delegate.CPU），失败后回退 GPU
• 初始化前验证 assets 中模型文件是否存在
• 关键日志改用 Log.w/Log.e，避免 release 构建中被 ProGuard 移除

2. Gemma 4 模型检测修复

• 大幅扩展 .litertlm 模型文件搜索路径
  • 新增 context.filesDir/models/、getExternalFilesDir/Download/、/sdcard/ 根目录
  • 新增 Google AI Edge Gallery 存储路径
  • 递归深度从 2 层增加到 3 层
• 新增文件选择器：通过 更多 > 选择模型文件 手动指定 .litertlm 模型
  • 自动复制到应用内部存储并切换到 Gemma 4 引擎
  • 支持语音引导操作流程

3. StepFun API 断断续续修复

• 添加 ConnectionPool 保持长连接复用
• 启用 retryOnConnectionFailure
• 连接超时从 15s 增加到 20s，读取超时从 60s 增加到 90s

4. 自动更新无法检测修复（关键）

• 修复 parseVersionCode 逻辑：
  • 旧版: major*10+minor（不含 patch），5.9.2 → 59
  • 新版: major100+minor10+patch，5.9.2 → 592
  • versionCode 同步更新为 593
  • 此前因 59 < 61 导致永远检测不到更新

5. AICore 诊断信息优化

• 诊断结果改为中文显示
• 明确提示 AICore 为可选功能，不可用不影响正常使用

下载

• 下载 APK 安装即可，无需卸载旧版本

v5.9.2

v5.9.2 更新内容

UI 重构

• 底部按钮布局重构：从17个按钮的横向滚动条改为两行固定网格布局（4+4），无需滑动即可看到所有核心按钮
• 第一行：障碍物检测 / 文字识别 / 场景描述 / 指向引导
• 第二行：拍照分析 / 连续检测 / 引擎切换 / 更多
• 次要功能（声纹、眼镜、初始化AI、下载模型、测试等）移入「更多」弹窗菜单
• 模式按钮高亮：当前选中的模式按钮以红色高亮，视觉反馈清晰

核心修复

• 启动自动初始化 YOLO：相机就绪后自动初始化 YOLO 引擎（内置模型，无需网络/下载），用户可以直接拍照和连续检测
• 拍照自动初始化：点击拍照按钮时如 AI 未初始化，自动初始化 YOLO 并执行拍照，不再仅提示"请先初始化AI"
• 模式切换实际生效：切换模式后重置播报指纹，确保连续检测立即使用新模式，不再出现"场景不切换"问题

技术细节

• 版本号：5.9.2 (versionCode 61)

VisionLink Android v5.9.1

v5.9.1 更新内容

Bug 修复

• 摄像头权限问题修复：将通知权限（POST_NOTIFICATIONS）从必须权限中分离，用户拒绝通知权限不再阻止相机启动
• 连续检测播报修复：优化场景变化检测灵敏度（指纹从60字符缩短到30字符），重播间隔从12秒缩短到8秒，增加1.5秒最小间隔防刷屏
• 错误提示优化：相机重启失败提示不再误导为权限问题

优化

• 障碍物检测输出格式：匹配设计规范，输出格式为"前方两米有台阶，偏左"，方位信息更自然
• 距离估算优化：使用尺寸先验+小孔成像模型估算米数，无先验时退回步数估计
• 端侧 OCR：集成 ML Kit Text Recognition，YOLO 引擎下模式2可直接离线识别文字
• API Prompt 优化：各模式 prompt 更精确，输出格式更符合视障辅助场景

技术细节

• 权限分为必须（CAMERA + RECORD_AUDIO）和可选（POST_NOTIFICATIONS）
• 版本号：5.9.1 (versionCode 60)

VisionLink Android v5.9.0

v5.9.0 更新内容

新功能

• 双源自动更新：同时检测 GitHub 和 Gitee 仓库，并发请求取最优版本，提升国内更新可用性
• AppUpdateChecker 重构为协程并发架构，支持多源竞速

修复

• Release 页面乱码修复：修复 v5.5.0 / v5.6.0 / v5.7.0 release notes 中的中文乱码问题
• v5.5.0 body 误写入 PowerShell 对象的问题已修正
• v5.6.0 / v5.7.0 中文显示为 ??? 的编码问题已修正

技术细节

• 使用 async/await 实现多源更新检测竞速
• 更新弹窗显示更新来源（GitHub / Gitee）
• 版本号：5.9.0 (versionCode 59)

v5.8.0

v5.8.0 更新内容

修复

• StepFun 模型更新：旧模型 step-1-flash / step-1v-8k 已下线，更新为：
  • 文本模型：step-3.5-flash
  • 视觉模型：step-1o-turbo-vision

说明

• API 测试现在可以正常工作
• 平台地址：https://platform.stepfun.com/step-plan