QCL-CE v1.9.4

QCL 社区版自 v1.5.4 以来的首次功能更新（v1.5.5 → v1.9.4，共 49 个提交）。基于官方 Quanta Craft Launcher 的社区分支，按 GNU GPL-3.0 授权发布。

官方版的全部核心能力都保留：下载全部已归档的远古版本、全远古版本中文补丁、ModLoader 与 Babric 支持、Pojav 启动后端。下面是社区版多出来的部分。

内置插件 42 → 90 个

插件页顶部可直接搜索，每个插件可以单独开关。分类覆盖下载、界面、资源、模组、账号、联机、系统、安全与备份、Java、语言。

设计上的硬规矩没变：每个插件里做不到的部分都写在界面上，不放点了没反应的按钮。

深色模式

• 13 个语义色地基 + 完整夜间配色：正文、面板、强调色、链接色、分割线全部适配
• 内置「跟随系统 / 始终浅色 / 始终深色」开关
• 夜间背景走 Android 的 night 资源限定符，同名资源自动切换，不需要重启

主页改版

• 原来平铺在底部的 8 个入口收进左侧「≡ 菜单」
• 菜单支持自定义排版：勾选显示哪些、上下调整顺序

界面排版自定义（分两阶段落地）

• 阶段①：qcl_layout.json 数据层 —— 每个页面的「控件 id → 顺序 / 显隐 / 宽高」+ 恢复默认
• 阶段②：编辑器 UI —— 长按主页进入编辑模式，控件高亮后可拖动 / 隐藏 / 缩放，保存或取消
• 支持布局的导入导出（复用 FileProvider 分享）

其它新增

• 一键开服：把原来缺的那一步补上
• 装模组自动补全前置依赖：递归拉整条依赖链，已装的自动跳过
• 白天 / 黑夜背景：跟随系统深色模式自动切换
• 输入链路自检：启动时检查输入桥是否加载、isInputReady 的值、控制布局是否为空，结果写进启动诊断报告
• 动效：卡片、左侧导航、按钮、对话框的进出场（只动合成层属性，不触发重新布局）
• 官网落地页与 Wiki：docs/ 目录，可直接用 GitHub Pages

修复

• 修一批闪退与卡死（14 处主线程重活挪到后台）
• 修整合包下载不了（MCIM 镜像）
• 修通用设置里的语言下拉只有 4 种
• 修「上次启动没有走完」的误报
• 修日志分享失败（CE 版改用独立日志目录）
• 修资源限定符顺序导致的编译失败

体积

安装包 328 MB → 229 MB。内置运行时按需裁剪，只保留当前设备架构的 JRE 与原生库。

安装

• 真机（arm64）：QCL-CE-v1.9.4-arm64.apk
• 模拟器（x86_64）：暂未构建

包名 com.qcl.launcher.ce，可以与官方版同时安装，互不冲突。

装之前建议先卸载官方版并清除应用数据 —— 两者签名不同，且旧设置文件可能自我延续。
首次启动会离线解压运行时（约 452 MB），需要几分钟，断网也能装。

说明

• 本项目不是官方版本，问题请提到本仓库的 Issue
• 本项目以 GNU GPL-3.0 授权，保留上游署名

QCL-CE v1.5.4 首个开源版本

QCL 社区版的首个开源版本。基于官方 Quanta Craft Launcher 的社区分支，按 GNU GPL-3.0 授权发布。

官方版的全部核心能力都保留：下载全部已归档的远古版本、全远古版本中文补丁、
ModLoader 与 Babric 支持、Pojav 启动后端。下面是社区版多出来的部分。

界面

• 导航从底部横排改到左侧竖排：罗马数字加中文竖排，侧栏顶部有方形品牌印记，
  底部显示当前版本号，子页面保持常驻
• 主界面改为编辑式排版：页眉分三栏，主内容区左边是当前档案区块（编号、标题、
  元数据、线段式轮播指示器），右边是最近游玩列表，底部是启动按钮加页码
• 导航栏与返回栏使用 AGSL 着色器实现液态玻璃：边缘畸变、色散、菲涅尔边缘光。
  不支持 AGSL 的设备会自动走降级路径，用位图矩阵做真实的光学放大，
  任何机器上都能看到透镜效果
• 主界面中间的 3D 人物改为头像，尺寸按屏幕高度自适应（屏幕高度乘 18%，
  夹在 56 到 120 dp 之间），每次回到主界面重新计算
• 主色改为铁锈红；主界面图标换新；支持背景图轮播；
  加两个轻量动效（头像浮动、按钮按下缩放）；启动按钮改为自适应宽度

42 个内置插件

入口在底部导航的插件页，按分类分组：

• 实例管理（9）：图标生成器、配置差异对比、健康评分、启动历史、导入向导、
  启动画面、启动队列、性能基准、主题编辑器
• 模组管理（6）：标签自动分类、锁定列表、依赖树、降级工具、更新预检、更新日志聚合
• 资源（4）：资源包合并、资源包预览图、光影兼容检测、光影预设管理
• 下载（3）：源测速、失败自动换源、组合模板
• 存档（5）：版本转换提醒、玩家列表、地图预览、编辑警告、游戏规则预设
• 安全与备份（5）：文件完整性校验、密码保险箱、操作日志、服务器白名单、数据迁移
• Java（2）：自动匹配、参数预设
• 工具（8）：批量重命名、服务器延迟预检、本地化词库、教程库、一键开服向导、
  本地百科、快速笔记、一键恢复出厂

设计上有一条硬规矩：每个插件里做不到的部分都写在界面上，不放点了没反应的按钮。
比如密码保险箱会写明「存在应用私有目录，不是加密存储」，
存档地图预览会写明「画的是已生成区块，不画地形」，
性能基准会写明「没有帧率数据源」。

多语言

19 种语言可切换：跟随系统、简体中文、繁體中文、English、日本語、한국어、
Français、Deutsch、Español、Italiano、Русский、العربية、ไทย、Tiếng Việt、
Bahasa Indonesia、Türkçe、Polski、Português (Brasil)、Српски。

入口在插件页的语言项，切换后立即生效，不需要重启启动器。
阿拉伯语会自动切换为从右到左排版。

覆盖范围是用户最常看到的 60 条核心字符串加上 42 个插件名，
其余字符串由 Android 的资源回退机制显示英文。

诊断与排障

• 启动路标：启动全程埋点，日志同时写到应用私有目录、/sdcard/QCL/ 和
  Android/media/<包名>/（无需权限，分区存储下唯一对外可见的位置）
• 崩溃弹窗一键分享日志：崩溃后重开启动器会弹提示，主按钮直接走系统分享面板
• 启动前检查：点启动时先跑一遍轻量检查，只在查出问题时才弹面板，
  检查本身出错绝不拦启动
• 日志中心、诊断向导、安全模式

实例与存档

• 实例快照对比、占用空间分析（按用途拆开统计，清理只碰日志和下载残留）
• 实例间搬运：模组、存档、资源包、光影、配置，执行前先列出会覆盖谁
• 存档自动备份、世界信息面板（读 level.dat 展示种子与版本）、种子与存档分享

下载

• 下载限速、暂停继续重试（HTTP Range 续传）、仅 Wi-Fi 下载、通知栏进度
• 分享菜单接入：从微信、QQ 或文件管理器把 zip、mrpack、图片分享给启动器

自动化与统计

• 定时任务、启动与退出脚本、本地统计
• 桌面小部件与一键启动快捷方式、快速切换账号

主题与外观

• 主题方案（默认、深色、纯黑三个预设，可导出导入）
• 安全区避让（自动检测系统栏、刘海挖孔、大圆角）
• 兼容性数据库

安装

下载对应架构的 APK：

• 真机（arm64）：QCL-CE-v1.5.4-arm64.apk
• 模拟器（x86_64）：暂未构建

包名 com.qcl.launcher.ce，可以与官方版同时安装，互不冲突。

说明

• 本项目不是官方版本，问题请提到本仓库的 Issue，不要打扰上游作者
• 本项目以 GNU GPL-3.0 授权，保留上游署名