Releases

版本、发布与获取

🛠️ 工程化 · 🏠 首页 › Releases

---

📑 本页目录

• 1. 版本历史（近期主线）
• 2. 三种获取途径
• 3. APK 变体
• 4. 发布工作流（apk.yml）
• 5. 内置 rootfs 对体积的影响
• 6. 升级注意事项
• 7. 相关页面

当前版本 1.4.4（versionCode 19，发布 tag v1.4.4.x 系列），状态 active · alpha，License TBD。

1. 版本历史（近期主线）

版本	code	关键交付
1.4.4	19	Hub 生态（PR #246）：官方 apex-skill-hub / apex-mcp-hub 仓库直装、内置技能 75→13 瘦身、斜杠两级门控、MCP 配置启动闭环；逆向 MCP Host（#173，v1.4.0 起落地）：手机作为 MCP Server 供 PC 客户端调用；双工位重构（PR #198）：Agent / Coding 引擎拆分；T89 终端大修（PR #205）+ 终端三层拆分（emulator / native / view）；长任务韧性 + mcp.so 社区目录 + 上下文检索增强（PR #249）；增量更新 VCDIFF 自动应用（PR #248）；用量仪表盘 / 诊断中心 / 备份恢复 / 通知中心；混沌审计 P0/P1 修复（PR #204）；UX 审查批次 1：21 处小 Bug 修复（PR #247）
1.4.x（1.4.0–1.4.3）	8–15	模式系统 v2、模板工坊、关于页抽屉化（v1.4.3）、玻璃顶阶动态、T87 终端体验大修（31 套配色 / 扩展键 / 历史）、共情引擎 × 里程碑记忆 × 70 技能矩阵、胶囊流式 CodeStream、模型卡片 MCP stdio 市场重做
1.2.0	4	T83：Ubuntu rootfs 内置 APK 交付（放弃应用内下载安装）；APK 工作流修复（双 APK 中间产物移出 packageRelease 输出目录，避免 Gradle 当作 stale output 清理）
（更早）	—	T82 Ubuntu 产品生命周期编排；T81 终端执行基础设施 2.0；T76 长任务运行时；P83 环境闭环补全；终端交互补齐（窗口标题 / BEL 振动 / 双击选词 / 保持常亮）

2. 三种获取途径

途径	适合	说明
CI 工件	想最快试	Actions → ci.yml 最新版 → 工件 app-debug-apk（保留 14 天）
GitHub Release	想要稳定版	独立发布仓库 Android-Guru-Agent-Release（最新 v1.4.4.x，7 个 ABI 变体资产）；主仓库 push tag 时 apk.yml 亦自动创建 Release，产物名带版本 + commit sha
自己构建	要改代码	见 从源码构建

3. APK 变体

变体	命令	特点
Debug	./gradlew :app:assembleDebug	CI 默认产物
Release	./gradlew :app:assembleRelease	—
单 ABI	-PapexAbi=arm64-v8a	体积更小（每 ABI 约 30MB 的 rootfs 归档只留一份）；Release 推荐

4. 发布工作流（apk.yml）

workflow_dispatch（可选 build_type）+ push 分支/tag
  → Stage bundled Ubuntu rootfs（scripts/fetch_rootfs.sh）
  → 依赖预热
  → 解析变体 / 发布 tag
  → Build APK
  → 产物重命名（版本 + sha）
  → 上传工件 apex-agent-apk
  → tag 构建额外创建 GitHub Release

Note

历史坑：双 APK 的中间产物若留在 packageRelease 输出目录，Gradle 重打包时会把目录内 非本轮产物当作 stale output 清理（v1.2.0 首次 tag 构建实测踩到）。现已把中间产物移出该目录。

5. 内置 rootfs 对体积的影响

ABI	归档大小
arm64-v8a	29,870,567
x86_64	29,989,394
armeabi-v7a	27,088,043

默认三 ABI 全打 → rootfs 贡献约 90MB；单 ABI 包只留一份。详见 Ubuntu rootfs 供给。

6. 升级注意事项

• 记忆库：Room 升级必须显式提供 Migration（仅降级允许 destructive），保护长期记忆；
• rootfs 指纹：三处 sha256 必须一致（脚本表 / rootfs-bundle.sha256 / BundledRootfsSource.kt）；
• targetSdk：不会升到 29+，原因见 终端运行时。

7. 相关页面

• 从源码构建 · CI 流水线 · Ubuntu rootfs 供给
• 路线图 · FAQ

---

🏠 返回首页 · 📚 文档索引 · ❓ FAQ · 🔧 故障排查 · 🗺️ 路线图 · 🐛 提 Issue

_{Android Guru Agent · v1.4.4 · Kotlin 2.0.21 · Compose · PRoot · Room}