刷机包文件名说明

所有属性的值必须严格遵循规则,禁止使用除"_"和"."以外的特殊符号。所有非法值导致的后果自负!!!

刷机包属性

文件名以“-”符号分割,共有五个属性:

类型 - 型号 - 输入值 - 占位符 - 版本 .zip

part - polaris - auto - null - stable1.3 .zip

flash - dipper - Win11_21H2 - null - stable1.3 .zip

reset - enchilada - default - null - beta1.2 .zip


属性说明

类型

标识刷机包类型。不能修改,会报错。

型号

指定手机型号,不能修改,会报错。

输入值

刷机包会根据此属性的内容不同执行不同的操作,以下是作用:

  • 分区包:用于设定Win分区大小
  • 刷写包:用于查找Windows镜像
  • 恢复包:设置恢复分区的模式

此值可根据需要进行修改,但不能留空,具体接受参数参照输入值说明

占位符

由于部分机型的特殊性,此属性用于对特殊机型适配,或以后开发新功能时预留。
此属性默认为null,未启动时修改也无效,但不能留空。此页阅读完毕后一定要看设备特殊性里你的机型有没有特别情况!

版本

由项目自动生成,随update-binary同步更新,详情参阅更新日志,不作过多介绍。此项不可留空


输入值说明

分区包

分区包会根据输入值设定Win分区大小,接受两种值,分别是:

  • auto:根据手机容量自动分配Win分区大小:
    • 64GB手机:Win分区大小为38GB
    • 128GB:70GB
    • 256GB:120GB
    • 512GB:240GB
    • ≥512GB:480GB
  • 整数(G/gb):手动指定Win分区大小,示例为“128Gb”。要求:
    • 数值不能小于38G。
    • 计算后手机剩余空间必须保留19G以上。

自定义容量不区分大小写,单位可省略。对于容量超过256GB的设备,推荐手动设定Win分区大小。

刷写包

刷写包的值是Win镜像文件名,系统将按以下顺序在指定路径查找匹配文件:

  1. U盘:/usbstore/
  2. 内置储存:/sdcrad/
  3. 下载目录:/sdcard/Download/

查找规则:

  • 查找以输入值开头,.wim格式且包含机型代号首个文件1
  • 如未找到,继续按路径顺序查找以.mtip格式的首个文件

.mtip某贼 Mindows工具的懒人包命名方案,这里指全量包2。如果你打算使用此格式的镜像,“输入值”无需修改。

恢复包

用于设定恢复分区时的模式,接受三种值,分别是:

  • default:默认模式,只删除WinEFI分区,调整userdata分区到100%。
  • auto:自动模式,删除官方userdata分区编号及以后的所有分区,重建userdata分区。
  • sgdisk:使用sgdisk分区备份文件进行恢复,优先使用EFI分区里手动备份的,如果没有再使用恢复包data文件夹下的备份。

默认模式适应于只用过此项目分区包调整的分区,如果你手动或使用其他工具调整过分区,会恢复失败且产生未知问题。
自动模式适应大部分情况,但如果你删除过其他分区(如:system_b),必定导致恢复失败和分区错乱等问题。

sgdisk恢复分区的方法未详细测试,所以不清楚什么情况会导致什么问题,欢迎反馈


  1. 我发现世上还是傻子多,特别讲一下刷写包输入值的用法:例如你的手机型号是小米Mix2S,代号是polaris。输入值为“Win11_22H2”,会首先匹配文件名为Win11_22H2*polaris*.wim的文件,符号 * 代表任意数量任意字符(包括0个)。同理,假设你把输入值修改成“这shi.一段_文字”,那么就会匹配这shi.一段_文字*polaris*.wim。如果你还没理解,那没救了

  2. 已经进过系统的镜像,包含了完成系统安装后的状态,无需经历常规安装后的系统初始化、驱动安装等步骤。相较于原版镜像能大幅减少安装问题(如蓝屏),显著缩短耗时。但可能预装特定软件,更改了系统设置等情况。