【win备份还原工具开发日记】32:部署链路三连净化、DISM降级兜底与判据脱中文
【win备份还原工具开发日记】32:部署链路三连净化、DISM降级兜底与判据脱中文(v2.6.32→v2.6.40)
对应文档(同日 16 篇):docs/20261024-0335-v2.6.32-备份确认框不再冒充还原目标与tab编号订正-DeepSeek-V4.1-Flash.md、docs/20261024-0350-接手AI交接说明-v2.6.32-Step-5-Preview.md、docs/20261024-0430-38-lite数据备份与B入口在线还原实机验收-Step-5-Preview.md、docs/20261024-0550-TaskStore搬离C与证据保留边界拍板-Hy4.md、docs/20261024-0755-A入口还原C盘回归验证TaskStore搬离效果-Hy4.md、docs/20261024-0958-不再往C部署exe与自启项改指H-Step-5-Preview.md、docs/20261024-1050-备份排除表增加程序部署件-Step-5-Preview.md、docs/20261024-1508-下一步详细开发方向-Step-5-Preview.md、docs/20261024-1626-宿主空间治理与磁盘清理执行记录-Step-5-Preview.md、docs/20261024-1636-DISM失败自动降级wimlib与错误分类详细设计-Step-5-Preview.md、docs/20261024-2126-D1D2实现与三层实机验收-Step-5-Preview.md、docs/20261024-2250-冒烟通道重构-入口统一编码替代base64往返-DeepSeek-V4.1-Flash.md、docs/20261024-2300-编码问题为何躲不开中文-ASCII边界与判据纪律-DeepSeek-V4.1-Flash.md、docs/20261024-2345-全局语言层i18n与日志多语言化-DeepSeek-V4.1-Flash.md、docs/20261024-2350-CLI加json与GUI操作审计日志-用户三条解法落地-DeepSeek-V4.1-Flash.md、docs/20261024-2355-GUI审计扩展到全部入口与i18n扩到apply关键路径-DeepSeek-V4.1-Flash.md
今天做了什么
v2.6.32:备份确认框不再冒充还原目标 + --tab 编号订正(03:35,DeepSeek-V4.1-Flash):#38-lite 第①步系统备份完成——任务 c647d8b3-f7e9-4f45-b0a5-924be7a45e8e stage=success/100,镜像 br-2629-20261023.wim 40,566,232,539 B(≈37.8 GiB)、SHA-256(安全散列)74b64dc1…。顺手修两处界面缺陷:①备份页破坏性确认弹「目标卷:C / 目标分区将被覆盖」——备份目标是镜像文件,目标卷取自隐藏下拉纯属误导;修为纯函数 destructive_confirm_parts,backup 不输出目标卷行、警示语改「将把源卷捕获进镜像」;②--tab 帮助文本写 1…=5 实为 0 基,--tab 1 打开的是 A 页不是备份页,文本订正 0…=4 而映射本身不动(--tab 3=第二系统被既有脚本依赖)。坑:新纯函数最初放进 native_gui.rs(#[cfg(windows)])macOS 单测 collected 不到等于白写,改放跨平台 failure_policy.rs。验收:macOS 214+44、虚拟机 249+44 单测全绿,部署 2,885,632 B / SHA 618fe31b… 八联全对。
#38-lite 两步实机验收全过、零缺陷(04:30,Step-5-Preview):第①步 T: 数据备份(全程 GUI 真实点击):DISM(部署映像服务和管理)捕获 100%,日志 sha256=4722ef4c…、capturedUsedBytes=127774720、minimumTargetSize=5368709120(=T: 5 GB),索引名走非系统盘降级规则 Windows (T:) 20261024。第②步 B 入口在线还原(勾选格式化):卷序列号 E880494B→143E3564、哨兵 BR-BENTRY-SENTINEL.txt(42 B)随镜像重现、100 MB 载荷还原前后 SHA 同为 20492A4D…、BCD(启动配置数据)default/displayorder 不动、EventID 1000 零新增(最新仍 09-30)。工具层三坑:①dump 脚本 GetWindowTextW 跨进程被 UIPI(用户界面特权隔离)静默拦成空串,改 SendMessage(WM_GETTEXT)(commit 3e7dea7,5 个脚本);②确认框 BM_CLICK 偶发丢投递(对话框未进消息循环),入库脚本加点击后三态复验 VERIFY=DIALOG_GONE/NEW_DIALOG/STILL_THERE、STILL_THERE 自动重试(aabbee3);③完成框按钮 ID 是 2(IDCANCEL)不是 1。收尾:T: 清回 5 GB 空卷 3CF3-1261;历史启动项 {c76d3c5a}/{ef55d218} 结案不动(Winre.wim 存在、无引用、非悬空)。
TaskStore 搬离 C: 与证据保留边界拍板(05:50,Hy4):用户拍板「证据全留、载荷副本可清;TaskStore 搬离 C」。机制:TaskStore 根 = exe 所在目录(native_gui.rs:6167/main.rs:685),WinRE(Windows 恢复环境)交接存卷内相对路径,换目录不破坏。执行:①删 1aa188b1 任务两份 WinRE 载荷副本(stage\Winre.wim 724,785,581 B SHA 0FEAE2DF…、original\Winre.wim 722,034,583 B SHA 02E802C8…,删前落清单),任务目录 1.35 GB→4,371,997 B,C: 空闲 163.01→164.36 GB;②C: 侧 4 个终态任务按文件数+总字节双校验 match=True 后迁 H:\brwork\tasks(21→25 个/49.9 MB),C: 包目录 tasks 不复存在;③口径固化进 build-win.sh(SHA 标签改「分发副本(C:包目录)/权威运行目录(H-brwork)」——标签不能含冒号)。回归:从 H: 起 GUI PID=6896 无弹框无待续跑。
A 入口还原 C: 全量回归(07:55,Hy4):CLI(命令行界面)prepare+resume 真跑 37.8 GiB 镜像还原 C:,任务 c770b1a4-14b3-4fc5-9a1d-033cce776a6f success/100、TASK_ROOT=H:\brwork\tasks\c770b1a4-…——任务不落 C: 核心判据成立;哨兵消失、C: 序列号 BCD4-EAAB→5698-64F6、default 换新还原系统 {af5ee73f-…}。★这次没拍快照:宿主只剩 22 Gi,快照 CoW(写时复制)会把 ~85 GB 重写量全落增量层必然撑爆;实测不拍 VM 磁盘仅 318→319 GB 平稳跑完,回滚靠抄 BCD 三行 + H: 血脉镜像。三个新发现:①还原后自启的 GUI(图形用户界面)走 C: 包目录旧版 v2.6.31(当时误判「程序内部行为」——09:58 被推翻);②旧镜像仍把 4 个 tasks(1,387.9 MB)带回 C:,H: 有正本后 C: 侧整删;③这次没弹待续跑框是因为镜像带回的任务全是终态,不是搬离的功劳——弹不弹看镜像里任务终态与否,与任务在哪无关。
不再往 C: 部署 exe + 自启项真相(09:58,Step-5-Preview):用户指令「不再往 C: 部署 exe」。依赖面核查 8 条链路(Rust 代码对包目录零引用、WinRE 载荷 winpeshl.ini 内置生成、wimlib 按 executable_dir 定位),改动:build-win.sh/build-windows.ps1 部署位收缩到 H:\brwork 并 rmdir C: 包目录,八联 SHA 收缩为 H: 四联。★修正 07:55 误判:还原后自启走 C: 的真相是用户注册表 HKCU(当前用户注册表键)\...\Run::BackupRestoreTest——它在用户 hive 上、随镜像带回复活,不是程序内部行为;此前两轮取证漏掉它是因为 prlctl exec 走 SYSTEM 身份,其 HKCU 解析到 HKEY_USERS\.Default 看不到登录用户,必须枚举 S-1-5-21-*。自启项改指 H:\brwork,重启实测自启 PID=5092 走 H: v2.6.32;H: 五件套齐(exe/Recovery 各 2,877,440 B e79490f5…、wimlib fddb8c21…/b34549c6…);顺删 10-11 散落旧 exe(2,308,096 B)。
备份排除表增加程序部署件(10:50,Step-5-Preview,v2.6.32→2.6.33):build_capture_exclusions 加 self_exe_dir:同卷时排 5 个部署件文件(不排目录——tasks/logs 证据全留)、固定整排 \Users\Public\backupRestore-package、exe 在卷根不加条目。两个实测坑:①路径解析手写前两字符而不用 Component::Prefix——后者只在 Windows target 产生,macOS 测试行为不一致(第一版当场失败);②RE 内不能传 current_exe()(那是暂存路径,动态排除永不生成,首次实测 5 个部署件全进 T: 镜像),必须传 store.root;在线链传 current_exe().parent()。实机 T:\brwork-test 端到端:备份镜像 2,146,059,229 B 内 5 部署件全不在、tasks/logs/user-data 全在;在线格式化还原后同样;自毁保护顺带验证(从 T: 起还原 T: 被拒、零任务零 BCD)。顺带批量修 tools/win-clicker 65 个脚本 98 处 C: 包目录引用。部署 e8a66b34…。
宿主空间治理 D3(16:26,Step-5-Preview):执行 15:08 方向文档的 D3(P0 前置)。核查:宿主真实空闲仅 7.6 GiB(Data 卷 100% 容量),df / 快照卷自相矛盾显示「13Gi used/7.6Gi avail/63%」;F: 375.8 GB 全空而宿主 harddisk2.hdd 占 126 G(未收缩 slack)。执行:VM 内删 br-2619-cur.wim+br-38sys-20261022.wim 约 60 GiB(H: 91.75→145.4 GB)→ 停 VM 三盘自动收缩(94→79G、104→43G、126G→79M)→ 删宿主 target/ 1.9 G → 结果 7.6→209 GiB(77%)、快照 0 层。新经验:①df 必须读 /System/Volumes/Data;②空卷虚拟磁盘停 VM 即缩,显式 compact 语法是 prl_disk_tool compact --hdd(不是 --disk,用错只打印帮助);③镜像保留 = 血脉镜像+PE 载荷+冒烟素材,血脉看最近 A 入口回归用哪份 wim。
D1/D2:DISM 失败自动降级 wimlib + 错误分类(21:26,Step-5-Preview;16:36 详细设计):四个 apply 落点(RE 主链/PE 链/在线数据卷/在线第二系统)共用 fallback_after_dism_failure;classify_apply_failure 六类(AccessDenied/DiskFull/Busy/ImageCorrupt/TimedOut/Unknown),优先序 TimedOut > AccessDenied > ImageCorrupt > DiskFull > Busy > Unknown;ImageCorrupt 不降级、wimlib 缺件不降、其余一律降级一次;降级路径 wimlib 用不限制超时(否则用户设的短上限连杀 wimlib)。版本线 2.6.34→35→36→37,三层实机:①损坏镜像(中段清零 64 KB)DISM 退出码 1392 → 判 ImageCorrupt 且明确不降级;②BACKUPRESTORE_DISM_TIMEOUT_SECS=90 + 37.8 GiB 镜像→F::DISM 90 秒超时 → wimlib 17 分钟(658023 文件/79 GiB)完成,镜像外 BR-overlay-proof.txt 仍在(overlay 覆盖式语义铁证);③锁句柄占用:DISM 退出码 32(Busy)→ wimlib 退出码 47(status=c0000043)→ 双失败双 Busy 因果——修正设计预期:镜像内文件被锁两个引擎都救不了,救回只适用镜像外占用。实机挖出三个真 bug:①分类被自家日志行污染(回显行 integrity 子串抢命中 ImageCorrupt,降级几乎全失效)→ strip_self_log_lines 剥时间戳行+回显,4 条回归单测;②wimlib 的 NTSTATUS(Windows 内核状态码)无模式覆盖 → Busy 补 c0000043、AccessDenied 补 c0000022;③apply_overlay 的 Err 不带输出尾部(classify 拿到空文本归 Unknown)→ 失败附 tail_text(log, 8192)。终态:v2.6.37 部署 41dee5e0…、228+45 单测全过。
冒烟通道重构:入口统一编码废 base64(22:50,DeepSeek-V4.1-Flash):用户质疑「为什么不直接在入口调编码而总是拼 Base64」成立——约 90 行 base64 搬运一大半是自造复杂度,所谓「prlctl 单次 ~2.5 KB 上限」是 CLIXML(PowerShell 进度流序列化)污染假象。三条实测:①stdout 字节透传无上限(30000 B ASCII + 6000 B UTF-8 中文 cmd /c type 完好回读);②中文必须显式设 [Console]::OutputEncoding=UTF8,chcp 65001 不够(只改控制台代码页,管道按进程 ANSI 936 落字节);③VM 直读 \\Mac\Home 共享目录,脚本零传输,顺带绕开命令行 ~3.4 KB 上限;-EncodedCommand 保留(解决引号/中文参数,不是编码转换)。PowerShell 三个编码变量默认全是错的(us-ascii/gb2312/gb2312),统一成 PS_PRE 四件套(外加 $ProgressPreference 压 CLIXML);落盘必须无 BOM(字节顺序标记,Out-File -Encoding UTF8 会写 BOM 致 JSON 字段比较失配)。暴露四个非编码 bug:①C3 判据变量被后续赋值覆盖(前三轮误判通道截断,实为判据自己写错);②vm_read_file 重试被删,2224 B 日志回读出 0 字节(通道抽风≠文件为空);③grep 在 UTF-8 locale 整行跳过 GBK(简体中文 Windows 默认编码)字节流,必须 LC_ALL=C;④fsutil 输出 GBK 中文 grep 长期取空,改 Get-Volume。全链冒烟 run17 6/7→run20 7/7 PASS(C2 序列号 E46906AE→8EA5FC51)。
ASCII 边界与判据纪律(23:00,DeepSeek-V4.1-Flash):回答「全用 ASCII 是不是就解决了」——对一半:脚本层可 0 处非 ASCII(VM 命令体扫描 0 处、中文判据 0 处、纯 ASCII .cmd 执行可行),但中文不在代码里、在被测系统的回答里(dir/diskpart 用 GBK 回「找不到文件」,主程序 stdout 是 UTF-8——同一脚本要同时对付两种编码);DISM 有 /English 可锁英文,diskpart 无语言开关只能认数字 100。三个实锤:①剥掉非 ASCII 后看到的「DISM 0」是假象(原字节 = DISM 结果:退出码 0);②restore.out 剥后只剩日志路径一行,取「还原成功」绕不开中文 → 判据必须换结构化源;③C3 名不副实(名叫「任务 success/100」实际 grep 中文「操作完成」)→ 改 STEP 4/4+DISM 英文成功行。四层纪律:代码层 ASCII / 判定层只认结构化特征绝不 grep 中文 / 传输层 type 字节透传 / 展示层中文只在宿主侧。LC_ALL=C 环境同样 7/7 PASS(smoke-20261024-225900),证明判据不依赖编码。
全局语言层 i18n(国际化)(23:45,DeepSeek-V4.1-Flash,v2.6.39):新增 i18n.rs——语言优先级 set() > env BACKUPRESTORE_LANG > 默认中文;查表抽纯函数 msg_in(language,key)(只读全局的版本会让单测并行 set(English) 污染别的用例成 flaky);缺失返回哨兵 <i18n:missing>;单测锁「不许缺一边/不许漏翻/英文不许混 CJK」。边界(「适当」的含义):只覆盖结论性文案,append_log 258 个调用点不逐个加参数,需要双语的点主动查表。接入 GUI apply_language(此前切了界面日志仍是中文)、RE 侧与 online_operation。验收:235 单测、部署 c85caaba…;BACKUPRESTORE_LANG=en → [ERROR] Online operation did not complete,不设 env 中文逐字不变(回归证据);日志 STEP 1/4 ASCII 特征保留;冒烟 run24 7/7。
CLI 加 --json 与 GUI 操作审计日志(23:50,DeepSeek-V4.1-Flash,v2.6.38):用户三条解法逐一落地:①CLI --json 是判据的终局解法(新增 cli_json.rs:字段固定、缺失一律 null 不省略键、恒单行 JSON(结构化数据格式);online 补 log_path 字段、prepare 用一行 JSON 取代 TASK_ID=/TASK_ROOT=;边界:只影响 stdout 最后一行,error 仍是中文、给人看不作判据输入);②「测试时把界面调成英文」部分成立——GUI 与 RE 弹窗能切,日志与 CLI stdout 无语言维度,切英文救不了判据(与 --json 分工不同);③GUI 操作审计是历史欠账(两份审查清单挂着「未执行」):放 WM_COMMAND 入口统一留痕 GUI action: control=<名> id=<id> notification=0x<码>(CONTROL_NAMES 由 75 个 ID 常量生成),入口行记「做了什么」、分支行记「做成没有」——源于 2026-09-30「点了没反应」分不清点击没送达还是静默失败。顺带核实旧审查清单不能照抄(panic hook、MiniNT 记录等 P0 已在不同轮次落地,动手前先 grep)。验收:231 单测、SHA 0307a727… 2,905,600 B、run23 7/7、gui.log 实测留痕。
GUI 审计扩到全部入口 + i18n 扩到 apply 关键路径(23:55,DeepSeek-V4.1-Flash,v2.6.40):审计从主窗口 1 处扩到全部 4 处 WM_COMMAND 入口(系统选择/无效路径/设置对话框),关键改动是审计函数不依赖 State(那三个对话框 GWLP_USERDATA 只装 *mut i32)→ audit_control_action(control_id, notification);i18n 新增 8 条 apply 关键文案(dism/wimlib 开始与结果、等待两态)+ msg_tpl 占位替换(同步拆纯函数防并行污染);先核实再动手:翻译不破坏 D1/D2 降级判据(净化剥的全是 ASCII 参数、分类靠英文错误串+NTSTATUS 码)。英语真实还原实测 DISM start (wait limit unlimited)、Operation complete(STEP 2/4、CmdOutcome Display 仍中文,属「适当」边界)。任务 #121(GUI 界面点击切英文)当时未跑通、归因会话隔离+ExecutionPolicy——次日 00:50 已订正:真根因是 UIPI(提权 GUI vs 标准用户测试通道),已端到端通过。验收:236 单测、SHA 6bf9aaeb…、run25 7/7。
教训与经验
- 「镜像带回旧状态」靠源头消灭:备份 C: 会把部署件、任务目录、用户 hive 自启项全部打进镜像;「TaskStore 搬 H: → 不再往 C: 部署 exe → 排除表排部署件」三连后,「还原后程序目录里没有二进制」成为常态;旧镜像(br-2629)仍带历史包袱,新拍镜像才彻底干净。
- SYSTEM 身份查 HKCU 是假的:
prlctl exec(SYSTEM)的HKCU解析到HKEY_USERS\.Default,看不到登录用户 hive;查自启项必须枚举S-1-5-21-*——「自启是程序内部行为」的误判即由此而来。 - 编码是「数据」的属性,不是「代码」的属性:脚本 0 中文也拦不住 GBK 回答;「剥掉非 ASCII 再看」会造出假判据(DISM 0 假象)。正解 = 代码层 ASCII + 判据只认结构化特征 +
type字节透传 +--json让程序自陈成败;LC_ALL=C复跑全过才算编码免疫。 - 分类的输入必须先净化自家日志行:命令回显的子串(
integrity)会抢先把 Busy 判成 ImageCorrupt,让降级功能整体失效且无异常痕迹——strip_self_log_lines+ 实机原文单测锁死;且 Err 必须带输出尾部,否则 classify 拿空文本归 Unknown。 - overlay 语义的边界:wimlib 覆盖写保证的是镜像外文件不被碰;镜像内文件被独占锁定时两个引擎都写不进去,只能引导用户关闭占用程序——设计预期要用实机修正。
- 跨进程 GUI 自动化两条铁律:读编辑框文本用
SendMessage(WM_GETTEXT)(GetWindowTextW被 UIPI 拦成空串);点击必须复验(dump 对话框标题/新任务目录/卷序列号三选一),不能以点击回执为准。 - 纯函数放跨平台模块:
native_gui.rs是#[cfg(windows)],macOS 单测 collected 不到、测试白写;凡读进程级全局的查表函数都要拆纯函数(msg_in/msg_tpl_in),否则单测并行 set 全局互相污染。 - 空间三连:
df只认/System/Volumes/Data(df /是只读快照卷会自相矛盾);空卷虚拟磁盘停 VM 即自动收缩(compact 语法是--hdd不是--disk);CoW 快照会把大还原写入量全落增量层,宿主紧时「不拍快照 + 抄 BCD 三行 + 血脉镜像」是零成本回滚组合。 - 通道抽风要有重试:同一文件连续回读一次空一次满(2224 B 读出 0 字节)——空结果必须重试,「读不到」不能记成「文件为空」。
下次接手的注意
- i18n 覆盖仍 14 条 vs 259 个
append_log调用点:main.rs(132)/windows_prepare.rs(40)/boot_entry.rs(26) 未接入;STEP 2/4、4/4 说明与CmdOutcomeDisplay 仍中文;online无--ui-language(只有prepare有)。 --json只接了online/prepare:冒烟脚本的prepare还没切--json;日志文件整体无语言维度(要支持需给append_log加语言参数,产品级改造待拍板)。- RE 主链(A 入口)的 DISM→wimlib 降级未做实机(本轮回合只在在线链验证;判据与文案单一来源,风险低但未闭环)。
- D4/D5 未做:D4 备份/还原任务目录命名分叉(
BackupRestore-backup-*/-restore-*,旧目录必须兼容读取);D5 冒烟套件是否纳入每次 deploy 常规门禁待拍板;远期「主备反转」(wimlib 提默认)无连续零缺陷证据不动手。 - 拍板遗留:#38 全链复跑专场「彻底不做/以后再做」待确认;
BackupRestore-actual-20261005-0724去留(次日 10-25 已拍板移至H:\BRImages\evidence\)。 - GUI 切英文(任务 #121):23:55 文档的「会话隔离+ExecutionPolicy」归因已被次日 00:50 订正为 UIPI 根因并端到端通过——接手以订正文档为准,勿按旧结论重试。
- 杂项:旧镜像
br-2629-20261023.wim还原 C: 仍会带回包目录(新拍镜像才消除);跑 79 GB 级还原前先df -h /System/Volumes/Data确认 ≥220 Gi;\\Mac\Home共享关闭时的 base64 fallback 未实测;GUI 任务列表 28 个 pending 陈旧条目未清理。
- 点赞
- 收藏
- 关注作者
评论(0)