⚠️ 未经本人同意，请勿擅自转载、打包、二次分发

本项目采用保留所有权利（All Rights Reserved）的专有许可，不是开源许可证。 你可以免费下载、编译、在自己的设备上使用，也欢迎分享本仓库链接； 但转载、复制、镜像、重新打包 APK、搬运到第三方应用市场 / 网盘 / 论坛附件 / 公众号 / 群文件，或收入任何「合集」「工具箱」「刷机包」，都必须先取得作者的书面许可。

完整条款见 LICENSE；需要授权请走 Issues。

小米桌面只能手动拖。图标一多，就得一个一个往文件夹里塞；换个主题、装几个新应用，桌面又乱了。

Deskly 做两件事：

1. 整张桌面按一个规则重排——把全部图标按「颜色」或「功能」分类，自动建成文件夹、自动分屏，一次写完；
2. 改坏了能退回去——每次动手前自动拍快照，备份精确到「哪个图标在哪个文件夹、文件夹在第几屏第几格」，恢复是整库覆盖。

它不是通过无障碍服务模拟拖拽，而是直接读写桌面自己的布局数据库（launcher4x6.db），所以速度快、结果稳定，也不会在你手上抢焦点。

已在 Xiaomi 2509FPN0BC（HyperOS）上实测。换机型 / 换 ROM 前请务必先手动备份一次桌面。

1. 到 Releases 下载最新的 Deskly-x.y.z.apk；
2. 安装（系统会提示「未知来源」，允许即可）；
3. 打开 LSPosed 管理器 → 模块 → Deskly，打开开关；
4. 同一页的作用域里勾选「小米桌面」（com.miui.home）；
5. 在 Magisk / KernelSU 里给 Deskly 授予 root；
6. 回到 Deskly → 底部切到 「配置」 → 展开 「运行引导」，按 1~5 步走一遍（第 4 步「重启桌面」必须点一次，模块只在桌面进程启动时注入）；
7. 一切就绪后回到 「整理」，开始用。

覆盖升级不需要重新勾作用域。更新 Deskly 后建议重启一次桌面，否则桌面进程里跑的还是旧版模块。

分析桌面全部图标  →  选一个方案  →  预览并写入

1. 分析：点「分析桌面全部图标」。Deskly 读一次桌面库，把文件夹内的和散落在桌面上的图标合成一批，同时按颜色与功能各归一次类，然后告诉你三个数字：应用图标 / 现有文件夹 / 桌面屏数；
2. 选方案：并排两张卡，方案一按颜色、方案二按功能。点哪张就用哪张，下面的分组与屏位立刻重算；
   • 预览里每个文件夹是一块，每行显示 7 个图标，超过 7 个可以「展开全部 N 个」；
   • 点文件夹右侧的屏号，可以把它钉到指定的一屏；勾「第一屏留空」则第一屏只放小组件；
3. 写入：底栏的「应用方案」始终可点，滚到哪儿都在。写入前会自动拍一份快照；写完后桌面自动重启一次，布局立刻生效。

状态行会给出回读证据，例如：

已整理 147 个图标 · 9 个文件夹 · 清掉 3 个旧文件夹 · 已写入并重启桌面
回读 147/147 个图标已在新文件夹里
位置与计划一致（每屏从左上角开始排）

分析范围是「桌面上已有的图标」（含文件夹内）。装了但没放到桌面上的应用，Deskly 不会自动加进来——它只重排已有条目。差多少个，界面上会直接写出来。

• 运行引导（默认折叠）：5 步接入清单，每步带一个能直接点的动作。作用域那一步框架没有查询接口，只能自己确认，界面会如实说明，不假装打勾。收起时只报一句 5 步接入 · root 已就绪 / root 未授权——五步里有两步本来就无法自动确认，算"就绪 N/5"只会给出一个假的分母。
• 备份与恢复（默认折叠）：
  • 「备份当前桌面」存一份完整快照，显示 N 个图标；
  • 点「展开明细」可看到每个文件夹在第几屏、里面装了哪些应用（带图标）；
  • 恢复直接覆盖，不会先替你备份。想留退路，请先手动点一次备份。
• 关于（默认折叠）：版本号、作者、GitHub 入口（点击打开、长按复制地址，欢迎提 issue）、免责声明、捐赠与版权。内容刻意保持四行可扫完；版本号从 PackageManager 读，不会和 APK 对不上。

本项目是第三方模块，不是 LSPosed 官方项目。它与官方的关系只有技术依赖：

• 模块基于 libxposed 的 API 101 开发，描述文件（META-INF/xposed/module.prop）遵循其规范；
• 作用域声明在 app/src/main/resources/META-INF/xposed/scope.list，默认 com.miui.home；
• 运行需要 LSPosed 框架。

关于上架 LSPosed 在线模块库（modules.lsposed.org）：包名已按官方要求改为 io.github.cobylinweiqi.deskly，并提交到 Xposed-Modules-Repo。收录后可直接在 LSPosed 客户端的「在线仓库」里搜到、一键安装与更新。提交与发版备忘见 docs/上架官方模块库.md。

git clone https://github.com/Cobylinweiqi/Deskly.git
cd Deskly

# 需要 JDK 17 与 Android SDK 34
echo "sdk.dir=/path/to/Android/sdk" > local.properties

./gradlew assembleRelease
# 产物：app/build/outputs/apk/release/app-release.apk

release 用本机的 ~/.android/debug.keystore 签名，目的是让升级安装不会因签名不同被拒——这份 APK 不适合上架任何应用商店，请自行换签名后再分发。

• 点了「应用方案」，桌面没变化？
• 提示「整理失败」但桌面其实整理好了？
• 文件夹没落在钉住的那一屏？
• 提示没有 root / 读不到桌面数据库？

这些都在 docs/技术内幕.md 里按现象分了类，含实测数据、根因与修复版本。遇到问题先搜一眼，提 Issue 时请带上**版本号（左上角 banner 右侧）**与现象截图。

请完整阅读后再使用。

1. 本项目会直接修改系统桌面的布局数据库（/data/user_de/0/com.miui.home/databases/launcher4x6.db），属于高风险操作。使用前请自行备份重要数据，并确认你愿意承担相应风险。
2. 本项目按「现状」提供，不附带任何明示或暗示的担保，包括但不限于可用性、无错误、适用于特定目的。因使用或无法使用本项目导致的桌面布局错乱、图标丢失、数据损坏、设备异常、时间损失或任何间接损失，作者不承担任何责任。
3. root、LSPosed、系统修改本身可能使设备失去保修、触发安全风控或影响部分应用（如银行、支付类）的正常使用。这些后果由使用者自行判断与承担。
4. 本项目不收集任何数据、不联网、不含统计与广告 SDK。所有操作都在你的设备本地完成。
5. 本项目与小米（Xiaomi）、MIUI / HyperOS、LSPosed 官方均无隶属或背书关系，相关名称与商标归各自权利人所有。
6. 若你不同意上述任何一条，请立即停止使用并卸载。

Copyright © 2026 Coby Lin. All rights reserved.

本项目采用**保留所有权利（All Rights Reserved）**的专有许可，不是开源许可证——不属于 MIT / Apache / GPL 等任何 OSI 认可的开源协议，不授予再分发权。完整条款见 LICENSE。

• ✅ 欢迎分享本仓库链接，让更多人看到；
• ✅ 欢迎在个人博客 / 视频 / 文章里引用本项目的名称、截图与功能介绍，并注明出处与本仓库地址；
• ✅ 从作者本人维护的渠道获取与升级不受限制：主仓库 Releases、LSPosed 官方模块库索引仓库；
• ❌ 未经作者书面授权，禁止任何形式的转载与二次分发，包括但不限于：把 APK 重新打包、搬运到第三方应用市场 / 网盘 / 公众号 / 论坛附件、去除署名后发布、打包进「XX 合集」「XX 工具箱」；
• ❌ 禁止把本项目整体或部分重新提交到任何模块仓库 / 应用市场，冒充原作者或由第三方自行发布；
• ❌ 禁止反编译后重新签名打包，或以「汉化版」「优化版」「增强版」「搬运版」等名义发布修改版；
• ❌ 禁止任何商业用途（含付费下载、以捐赠/会员/广告等形式变相收费、随硬件或服务捆绑分发）；
• ❌ 禁止移除或修改本项目的署名、版权信息与免责声明。

需要授权（转载、商用、二次开发分发）请先通过 Issues 联系作者，说明用途与范围，取得书面许可后再进行。作者未回复不等于默许。

Deskly 是业余时间写的，不收钱、不放广告、不收集数据。如果它确实帮你把桌面收拾干净了，可以请我喝一杯咖啡 —— 金额随意，不打赏也完全不影响使用。

_{支付宝扫码 · 感谢每一份心意}

• ⭐ Star：点右上角 Star，收藏的同时也让我知道有多少人在用；
• 👀 Watch：选 Releases only，有新版会自动通知；
• 🐛 Issue：遇到问题请带上版本号、机型与 ROM 版本、复现步骤，以及「整理」页的状态行文字；
• ➡️ Follow：@Cobylinweiqi，后续同类工具会第一时间发在这里。