 Shuery
|
d72fe63c02
|
docs: 跟上 TUI 与入口重组（README 入口名 + TUI 一节 + CHANGELOG + CONTEXT 模块与入口）
README 里 24 处过期入口名（13 处 Backup.ps1、11 处 Restore.ps1）全部更新为新名字 —— 这正是 ADR-0012 里垫片存在的理由：内部实现改名断了会当场报错，而 README 里的入口名过期是**静默没用**，所以垫片留一轮等文档跟上。现在文档跟上了，删垫片的时机也就到了。
README 新增「交互界面（TUI）」一节：怎么进三个编辑器、每个编辑器能改什么（以及为什么有些字段刻意不列 —— 值跨行或本身是集合时"改一行"没有明确含义）、-Quiet 与 -InputScript 的用途、以及"只有真终端才画界面，否则明确报错并给退出码 2"。入口表从"两个入口"扩成四个（主入口 / 动作 / 配置 / 垫片）。
CHANGELOG 增加「新增：交互界面与入口重组」一节，含三项编辑器共用的外科式改写保证与那条往返断言；并写明旧命令照旧可用。
CONTEXT.md 增加「模块与入口」一节：BakNRet/ 四层的分工与规矩（清单是显式白名单、加载器是唯一点源顺序声明处、Public 一个函数一个文件、Private 放内部实现与 State），以及四个入口脚本的职责与"编排尚未下沉"这个已知的下一步。
验收：test.ps1 9/9 全绿（5.1 与 7）。
|
2026-09-27 22:40:54 +08:00 |
|
|
Shuery
|
3a3a57a6a1
|
docs: 决策记录 8 条、变更日志、README 的验收与口令两节
0007 与 0008 是本次改造新产生的决策（原计划 6 条）。它们同样满足「后人会问为什么」：把运行锁改成互斥体、或给库里 27 个函数补上 SupportsShouldProcess，都是看起来更规范的错法。
CHANGELOG.md：把 README 里那 33 行「相对旧版修了什么」整节搬过去，并补上本次改造的记录（11 条修复 + 6 条结构与规范，每条修复都写明现象与现状）。README 那一节换成指针。
README 新增两节：「验收与静态分析」（六个层次、Run-RealSmoke 为什么独立存在、以及那 6 条格式规则默认 Disabled 这个容易漏掉的事实）；「口令放在哪里」（默认留空不是遗漏，附迁移与验证命令）。
.markdownlint.json 照 PowerShell 主仓库的实践（default true、行长 240），只把 MD024 从关闭改成「仅同级不重复」，因为变更日志需要重复标题。顺带按 .editorconfig 把 .md 的 BOM 去掉。
|
2026-09-27 10:01:54 +08:00 |
|
|
Shuery
|
42f02d0eca
|
refactor: 公共面补 BakNRet 前缀，产品名大小写全仓统一
16 个没有前缀的公共函数补上 BakNRet（Write-Log → Write-BakNRetLog、Resolve-BackupEntry →
Resolve-BakNRetBackupEntry、Find-ChildDirectoryByName → Find-BakNRetChildDirectoryByName 等），
另外把全仓的 Baknret 统一成 BakNRet（47 个文件、940 处、65 个定义文件重命名）。
这不是审美问题：静态分析直接拓出一条实据 —— Write-Log 与本机某个已装模块导出的命令
**重名**（PSAvoidOverwritingBuiltInCmdlets），而重名的后果是导入两个模块时有一方的命令被
静默遮蔽。补前缀正是这条规则的解法，改名后它归零。
为什么敢做这个规模：PowerShell 的函数名解析大小写不敏感，所以 Baknret → BakNRet 在功能
上是零风险；真正要验证的是 16 个补前缀的调用点，而 276 个断言几乎覆盖了每个函数。另外
"名字与文件名一致"这条不变式有断言盯着（加载器点源的文件集合 vs 磁盘）。
踩到并记下的坑：Windows 文件系统大小写不敏感，所以**只改大小写**的重命名会被 Move-Item
当成同一个文件而静默跳过 —— 同一批里同时改了名字的那 16 个文件却成功了，于是"看起来能跑"。
最后用"先移到临时名、再移到目标名"的两步走解决，判断与替换全部改用显式大小写敏感的形式
（-creplace / -cmatch）。
顺带把名录指纹缓存从 MD5 换成 SHA256（PSAvoidUsingBrokenHashAlgorithms）：它只是缓存键，
没有兼容负担。
验收：test.ps1 9/9 全绿（7 与 5.1）、100 个文件两版解析零错、276 个断言全过、
构建工具仍能合回单文件（3300 行）。
|
2026-09-27 09:56:36 +08:00 |
|
|
Shuery
|
78f43c8cc9
|
docs: 建立 CONTEXT.md 术语表
13 个词，按「输入 / 归档布局 / 产物与审计 / 名字」四组，每词带 _Avoid_ 同义词。它是本次改造落定的用词记录：清单 / 条目 / 方向 / 软件名录 / Slot / 覆盖 / 排除模式 / 前缀补全 / 归档 / 归档项 / 旧布局 / manifest / 安全描述符旁挂 / 孤儿归档 / BakNRet。
|
2026-09-27 09:23:48 +08:00 |
|