Shuery
60f2ae3e0f
grilling 三轮把设计树走完了，这里把它落成文件，避免决策只活在对话里。 ADR-0010 零依赖自研 TUI：三个候选库全部实测排除 —— ConsoleGuiTools 的 PSGallery 元数据声明最低 7.2（5.1 装不上）；Spectre.Console 0.49.1 能在 5.1 加载但要塞 4 个第三方 DLL 且不支持鼠标；Terminal.Gui 1.15.0 能反射接线到真的渲染出窗口，但 Application.Shutdown() 在两端都抛 NRE。同时记下两条实测坑：无控制台时 $Host.UI.SupportsVirtualTerminal 会撒谎返回 True（第一道闸门必须是 [Console]::IsOutputRedirected），以及 5.1 的 RawUI.LengthInBufferCells 对中文返回 2、对边框字符返回 6（都不能用来排版）。 ADR-0011 进度回调这个例外：它是注入点不是状态，无头路径为 $null 时行为与今天完全一致。 ADR-0012 入口改名与垫片：这次留垫片而 Common.psm1 直接删，是因为前者是外部接口（断了是静默没用）后者是内部实现（断了当场报错）。并纠正了自己的一个伪前提 —— 本机实测没有注册任何 BakNRet 计划任务。 ADR-0013 TUI 写配置：外科式改写 + 校验通过才原子替换。硬事实是 SoftwareCatalog.psd1 根本不能被 Import-PowerShellDataFile 读入（动态表达式），任何"解析成对象再序列化"的方案都会毁掉表达式与注释。 .scratch/tui/spec.md 是这次改造的验收锚点：9 条已定决策 + 三轮的判据 + 风险表。 验收：Parse 两版仍绿。
1.2 KiB
1.2 KiB
进度用"注入的钩子"，这是对"模块不持有运行状态"的一次有意例外
TUI 需要知道"正在处理哪个条目、处在哪个阶段"，而目前唯一的通道是日志文本。解析日志行是脆的 ——这个仓库已经因为"从文本里反推结构"吃过一次亏（方向标记贴在名字上时解析不出来，27/28 个条目 被静默跳过）。
所以核心在几个确定的点上调用一个可注入的进度回调（建暂存 / 压缩 / 校验 / 安全描述符）；
无头路径下它是 $null，行为与今天完全一致。
为什么这不是"又把全局可变状态请回来"：它是一个注入点，不是一份状态——除了运行期被调用之外 不被读、不被写、不跨条目累积，也不参与任何判断。ADR-0007（运行锁用文件句柄而非模块级变量）的 同一条原则仍然成立：状态属于调用方，模块只提供能力。
代价：这些回调点会成为核心里的"缝"。以后新增或改动回调点时，要同时想清楚它对两个前端 （TUI 与无头）分别意味着什么——尤其是"跳过"这种既不是成功也不是失败的状态，两个前端都得有说法。