简体中文 · English
真·适配 HyperOS 4
一个主区域,多个真实副任务,把正在做的事留在眼前。
1.0.3 HyperOS 2 / 3 / 4 Android 14+ ARM64 Root + LSPosed 源码公开 · 非商用
下载 1.0.3 · 功能详解 · 安装与上手 · 项目缘起
1.0.3 正式版新增澎湃 OS 2 与平板适配、模块设置、两种主副交换模式、底部唤出手势和锁屏保留工作区,并完善问题诊断。完整改动及升级说明见1.0.3 更新日志。
兼容范围按系统接口与实机证据分别记录。 本轮已验证部分澎湃 OS 2 / Android 15 手机及 OS 4 / Android 17 手机、平板;最低安装版本 Android 14 不代表所有 ROM 均已验收。详情见1.0.3 验证说明。
查资料时留着笔记,看视频时顺手回消息,在几个应用之间来回处理同一件事——我想要的,是把这些事情放在一个看得见、切得动的工作区里。
Mi Step 参考锤子科技 One Step「一步」的交互思路,为小米 HyperOS 4 适配前台多任务体验。 当前桌面或应用显示在主区域,旁边留出三个副任务位置,上方放常用应用、控制中心、音乐和工具。需要操作哪个任务,就点它换到主区域。
主区域保留当前桌面或应用的操作空间;三个副任务按格排列,与主区域并排显示,方便同时查看几个应用的内容。
空格上的「+」用来收纳当前主应用。 先在主区域打开要留下的应用,再点一个空副任务格,它就会进入那个位置。继续打开其它应用、继续收纳,逐步搭好自己的工作区。主区域是桌面时,会提示先打开应用。
副任务承载的是系统中的真实应用任务。切换围绕已有任务进行,保留任务当前的页面;应用自身的刷新、后台回收和播放策略仍由应用及系统决定。
点击已有副任务,它会进入主区域,原主应用则交给副任务区。用完再点另一个任务,就能继续接着做事。
- 主区域负责完整操作:点击、滚动、输入文字和使用键盘。
- 副任务区负责选择与管理:点按交换、向外滑出。
- 点击常用应用栏中已在副区的应用,也会将已有任务换回主区域。
主区域保持输入焦点;任务交接时保留短暂的输入保护,完成后继续操作,减少误触或键盘跑到副任务上的情况。
暂时不用某个副任务时,向它所在的屏幕外侧滑出:副区在左边就向左,副区在右边就向右。
滑出完成后,该位置恢复为空格,任务交回系统并留在后台,不主动结束应用。之后可以从桌面、最近任务或常用应用入口继续打开它。
顶部应用栏优先显示自定义固定的应用,其余按最近七天的前台使用情况排列;无法读取使用统计时,使用应用名称等信息保持稳定排序。长按图标可搜索、多选并保存自定义应用,再次长按取消勾选即可移除固定项。
| 操作 | 作用 |
|---|---|
| 点击应用图标 | 在主区域打开应用;已在副区时交换已有任务 |
| 左右滑动应用栏 | 浏览当前没有露出的图标 |
| 长按应用图标 | 打开自定义应用选择框,多选后点完成;自定义应用固定在最前 |
| 点击工具栏的前后箭头 | 切换到上一个或下一个快捷应用 |
不用离开当前工作区,就能处理常用开关和系统快捷入口。顶部面板支持左右滑动,在控制页与音乐页之间切换。
| 控制页内容 | 可以做什么 |
|---|---|
| Wi-Fi、移动数据、蓝牙 | 查看对应状态,调用系统开关 |
| VPN | 打开系统 VPN 设置入口 |
| 音量 | 调整媒体音量,并显示当前百分比 |
| 亮度 | 调整屏幕亮度,并显示当前百分比 |
| 扫一扫 | 选择微信或支付宝的扫一扫入口 |
| 付款码、乘车码 | 选择对应应用或系统钱包入口 |
| 机型信息 | 在面板中央显示当前设备名称 |
扫码、付款和乘车能力依赖已安装应用与当前系统接口。微信乘车码需要先在微信里将相应入口添加到桌面;模块沿用已有快捷方式,不生成付款或乘车凭据。
音乐页接入 HyperOS 4 的原生媒体控件,跟随系统当前选择的媒体会话,显示封面、歌名、歌手及播放状态。播放/暂停、切歌、进度拖动和输出设备入口沿用原生控件;实际可用按钮取决于播放器提供给系统的能力。
歌词在音乐卡片内随播放进度显示,当前行高亮,旁边保留上下文。优先读取媒体会话自带歌词,缺失时再尝试在线匹配;无匹配、纯音乐或服务不可用时,会显示相应占位提示。
取词不需要额外勾选播放器的 LSPosed 作用域。 当前实现可查询网易云音乐、酷狗、汽水音乐及 LRCLIB 等来源,在线查询涉及的歌曲信息见 数据与安全说明。
点击剪贴板图标,可查看最近复制的文本:点击条目重新复制,支持单条删除和一键清空。
- 最多保留 24 条,重复文本移到前面。
- 历史仅保存在当前进程内存中,不写入历史文件。
- 不收录被来源应用标记为敏感的条目;锁屏时不读取剪贴板。
- 熄屏时收起面板,切换系统用户时清空历史。
工具栏把常用操作放在工作区内,左右布局下会调整按钮位置。
| 工具 | 作用 |
|---|---|
| 退出箭头 | 退出 Mi Step,恢复普通系统界面 |
| 齿轮 | 在主区域打开系统设置 |
| 剪贴板 | 展开或收起文本历史面板 |
| 截图 | 调用系统截图功能 |
| 录屏 | 调用系统录屏功能 |
| 手电筒 | 切换系统手电筒 |
| 前后箭头 | 在快捷应用之间切换 |
工作区使用桌面壁纸生成模糊背景,配合圆角和玻璃质感;更换壁纸后会更新背景。模糊素材来自壁纸,不取当前应用画面。
当前版本在普通竖屏状态栏可见时允许角部入口。沉浸全屏中先滑出原生状态栏,保持通知与快捷面板未展开,再另起角部手势呼出一步;未拉出状态栏时拒绝。此规则也适用于横屏,横屏游戏实际效果仍待验收。从左上角向右滑动,副任务区在左;从右上角向左滑动,副任务区在右,可以按左右手习惯选择。
应用在一步主区域内进入横屏时,工作区会协调页面方向、触摸映射、主副交换和悬浮键盘位置。1.0.0 已包含横屏拖动方向、键盘左右移动范围、交换时旋转归属,以及横竖屏状态栏动画越界的修正。
这里的横屏指一步区域内的应用横屏。不同应用的横屏策略、输入法和系统版本仍可能带来兼容差异,具体测试边界见 发行说明。
| 项目 | 当前要求 |
|---|---|
| 系统 | 最低安装版本 Android 14 / API 34;适配 HyperOS 2 / 3 / 4,实际验证范围见 1.0.3 验证说明 |
| 架构 | ARM64 |
| 框架 | 已配置可用的 Root + LSPosed |
| 开发与验证设备 | Xiaomi 17 Pro Max、Redmi Note 11T Pro |
相同机型、不同 ROM 也可能有接口差异;当前适配范围不等于全机型兼容承诺。
模块包名统一为 com.jiusis.mistep,后续版本继续使用这个包名。已安装旧包名版本时,先退出工作区并在 LSPosed 中停用旧模块,再安装此包、启用新模块并重新选择作用域,最后正常重启;确认正常后可卸载旧模块。旧包名版本无法直接覆盖升级,请避免同时启用两个模块。
- 从 1.0.3 发行页 下载
MiStep-1.0.3.apk,可用同页的SHA256SUMS.txt核对文件。 - 安装后,在 LSPosed 中启用 Mi Step,选择模块推荐作用域。
- 正常重启手机,使系统进程加载模块。
- 在竖屏界面用上角横滑手势打开工作区,先在主区域打开一个应用,再点副格「+」收纳。
推荐作用域如下:
| 作用域 | 包名 | 说明 |
|---|---|---|
| 系统框架 | android |
系统任务、主区域缩放与输入适配 |
| 系统界面 | com.android.systemui |
工作区、工具栏与原生控件 |
| 设置 | com.android.settings |
仅提供系统设置首页的 Mi Step 入口 |
使用小米输入法且需要阻止横屏时自动变成悬浮键盘,可另行选择 com.xiaomi.type。这是现有输入法内部策略的可选兼容项,普通应用显示和输入不依赖它。“设置”仅用于模块入口;抖音和播放器不需要加入作用域;旧的抖音TOP图片专用补丁已撤回。升级不会代替用户清除LSPosed中保存的旧勾选,可自行取消多余项。职责与未迁移项见作用域与系统适配。
从 系统设置 → Mi Step 打开模块设置页,无独立桌面图标。可分别控制控制中心和标题栏按钮的显示,并在“主副交换逻辑”中选择 原地放大(默认)或 固定主区域。按钮显示修改后同步到工作台,交换模式从下一次交换开始生效;退出或重启后保留选择。设置页采用统一的澎湃 OS 4 风格,支持浅色与深色主题。“运行日志”支持刷新近期模块记录并导出 ZIP 诊断包,用于问题反馈;首次读取系统侧日志需授予 Mi Step Root 权限。问题录制最长 60 秒,支持跨锁屏复现并导出 ZIP 诊断包。工作台仍通过上述手势进入,工作台齿轮按钮打开系统设置。覆盖升级、签名与停用恢复步骤见 完整使用说明。
在主区域打开浏览器,点空格「+」收纳;再打开笔记,收进第二格;然后回到聊天应用。现在可以看着资料回消息,点笔记换到主区域补几句,再点聊天换回来。需要腾位置时,把暂时不用的副任务向外滑出即可。
做 Mi Step 的起因其实很简单:我一直觉得小米的悬挂小窗不太顺手,也一直惦记着锤子原版的一步 3.0。
我是个“艺体文”,在 AI 出现之前,敲代码这件事对我来说实在太遥远。今年五月接触到 DS 和 MiMo 后,我才发现,AI 能让我获得一些以前很难拥有的能力和效率。后来有了 GPT 老师,学得更快了,我就不断地和它交流、学习,把自己的想法一点点讲清楚。
到现在,我还是不会熟练地敲代码。但我慢慢学着站在产品助理的位置上,描述需求、安排任务、观察效果、反馈问题。就这样,前前后后也做出了三四个小“玩具”。
Mi Step 则是在我体验了社区大佬的 OneStep4 和 Van Step 之后,才真正想动手做的。感谢他们把作品带到社区,也让我更确定了自己想要的体验:我想找回的,是自己记忆里锤子原版一步 3.0 的那种顺手。
于是,我试着用自然语言编程,做一个更贴近自己想法的一步。没想到,还真做出来了,初版效果也让我觉得值得继续。我给它取名 Mi Step。这名字可能会让人联想到“小米步数”,但我的意思是:既然脱胎于 One Step 的想法,那就叫它“小米的步伐”。
本“许愿工程师”相信,知识分享才会带来头脑风暴。把做过的东西、踩过的坑和摸索出来的经验拿出来交流,总比各自关起门来走弯路好。
我也希望,我们还能找回当年“酷市场”和“MIUI 论坛”里那种纯粹的交流氛围。社区少一点戾气,多一点互相帮助;作品可以讨论,问题可以指出,每个人也都可以在别人的帮助下往前走一步。
| 项目 | 与 Mi Step 的关系 |
|---|---|
| SmartisanTech / android | 锤子科技官方开源入口;One Step 的交互思路是本项目的参考起点 |
| SangLuoCN / OneStep4 | 我体验过、并促使我动手尝试的社区作品 |
| Van Step | 我体验过、并促使我动手尝试的社区作品 |
Mi Step 是个人项目,并非小米、锤子科技或上述社区项目的官方产品。对社区作品的致谢表示体验与创作启发,不代表它们参与开发、为本项目背书或提供兼容保证。
| 想了解什么 | 从这里开始 |
|---|---|
| 安装、手势、升级与恢复 | 使用说明 |
| 1.0.3 更新日志与升级说明 | 发行说明 |
| 1.0.1 更新日志与升级说明 | 发行说明 |
| 1.0.0 历史发行说明 | 发行说明 |
| 从源码构建和运行测试 | 构建说明 |
| 歌词查询、剪贴板与数据范围 | 数据与安全说明 |
| 发布内容检查 | 安全检查 |
| 第三方组件及许可 | 第三方说明 |
| 源码使用、改版发布与非商用要求 | 许可说明 · 许可全文 |
| 报告问题与提交改进 | 参与项目 |
反馈问题时,请说明手机型号、系统版本、Mi Step 版本、应用/输入法名称和具体操作顺序。涉及横屏时,也请说明是一步内部横屏还是整机横屏。截图或录像能帮助说明问题,发送前请遮住聊天、账号等个人信息。
给想看源码、一起折腾的朋友
工作区与系统适配代码位于 module/src/main/java/,原生输入映射位于 module/src/main/cpp/;tests/、tools/ 提供策略测试、生产方法回放和包检查。Windows 下可通过 build.ps1、test.ps1 完整构建与测试,所需工具及命令见构建说明。
发行页提供 APK、产品源码 ZIP、构建信息及 SHA-256 清单。仓库不包含本机签名私钥、账号凭据、设备日志、个人截图录像或厂商 ROM;文档中的品牌图片是为项目介绍单独提供的素材。
我希望继续分享知识,也不希望有人把大家的成果套个壳就拿去卖。Mi Step 自有内容采用 Mi Step 非商用共享源码许可 1.0:允许非商用的使用、学习、修改与免费分享;分发改版必须公开完整对应源码、保留署名并沿用同一许可。
允许非商用分享,禁止商业化,分发衍生版本必须公开完整对应源码并沿用同一许可。
| 你想做的事 | 规则 |
|---|---|
| 自己使用、学习,或修改后自用 | 允许非商用使用;仅供自己使用的修改无须公开 |
| 免费转发原版或发布改进版 | 保留署名及许可,提供该版本完整对应源码 |
| 换名字、换界面后卖钱 | 禁止 |
| 付费下载、会员解锁、广告变现、收费捆绑 | 禁止 |
| 拿源码修改后闭源分发 | 禁止 |
本项目采用自定义的 Mi Step 非商用共享源码许可 1.0,准确归类为 源码公开(Source Available)。由于限制商业化,它不属于 OSI 定义 下的开源许可,也不是 GPL-3.0;GPL-3.0 本身允许商用和收费分发。 完整条件见 LICENSE 和 许可说明。
本次许可同时适用于官方 1.0.0 发行物中的原创部分。第三方组件保留 各自许可;公开源码不包括签名私钥、账号凭据或设备个人材料。
Mi Step · 小米的步伐
把想法讲出来,把体验做出来,再一起往前走一步。

