BakNRet

6 Commits 1 Branch 0 Tags

3 Commits

Include renames

Author	SHA1	Message	Date
Shuery	2937eb6652	chore: 记录改造前基线改造开始前的完整状态，作为可回退的基点。此提交之后：Pester 175 项、零依赖套件 101 项全绿；PowerShell 5.1 尚不可用（源文件无 BOM）。包含此前未提交的在制品：安全描述符套件、Hyper-V 实验环境（tools/lab）、agent 约定（AGENTS.md 与 docs/agents）。 .gitignore 增加 .key / .pfx：BackupConfig.psd1 的 PasswordFile 此前默认指向仓库内的 baknret.key，一次 git add -A 就会把口令提交进版本库。默认值在后续提交中改为空。	2026-09-26 21:46:55 +08:00
Shuery	7173e8ae10	备份前空间预估；manifest 的 archive 字段只在文件真的存在时才写需求 - 写满盘这件事只做一件事：备份前预测本次所需大小，并提示用户存储够不够，不再往"更复杂的占用控制"方向做。实现 - Backup.ps1 新增只读的"备份前空间预估"，在动手之前按清单顺序模拟一遍： * 逐个条目枚举源目录得到真实源大小/文件数，并读取现有归档大小； * 沿用主循环那套"源未更新就跳过"的判断，所以列出来的就是本次真的会重打的条目； * 估算模型：临时归档写完时旧归档还在，那一刻占用 = 当前累计净增量 + 本次预估；原子替换后净增量 = 预估 − 旧归档大小；峰值取整个过程的最大值； * 预估归档大小：有历史归档取 min(源大小, 旧归档 × 1.3)，没有则按"不压缩"的悲观值； * 打印：可用空间、要重打的条目数（及跳过/缺源的数量）、逐条目明细（前 15 条）、预计峰值新增与净增量，最后给一句结论——"空间足够"或"空间可能不够！…差 Z GB"。 * 不够时只告警、不中断：真正放不下的条目仍由逐条目守卫跳过。 - 新增 Sync-BaknretManifestArchive（Common.psm1，Backup/Restore 都在写 manifest 前调用）：维持不变式"manifest 里写了 archive 的记录，磁盘上就一定有那个文件"，把指向不存在归档的 archive 字段清空，但保留 source / action / 历史计数。这样"源不存在的条目"不会再让 Restore 反复报"manifest 记录的归档不存在"，人工删掉归档（例如把它并进别的条目）之后记录也会自我纠正。整理（本机备份集） - 按用户确认，删除了已被 scoop.7z 覆盖的 scoop-config.7z 与 scoop-persist.7z （删除前先 7z t 复验 scoop.7z：233 MB / 29478 项 / 顶层 [persist, scoop]），并清掉 manifest 里这两条历史记录；24 条记录的 archive 现在全部存在于磁盘上。测试 - Pester 88 项、零依赖单元 49 项、端到端 23 项，全部通过。新增覆盖：对象数组名录、两种写法 × :+/-、同名目录拒绝执行、行尾 # 说明、孤儿审计（含"manifest 里还有历史记录"的说明）、archive 字段一致性、空间预估输出。	2026-09-22 08:26:09 +08:00
Shuery	43fa4e52dd	清单格式：两种写法（软件名 / 手写目录）都支持 :+ 追加与 :- 排除；名录改用对象数组并逐条介绍目录需求 - 支持两种条目写法：1) 直接写软件名录里的软件名；2) 用户手写目录。 - 两种写法都必须支持追加（:+）与排除（:-）。 - 软件名录要改进：scoop 合并成"一个软件 + 一个目录数组"。 - 运行时要把"分别是哪些目录、每个目录是干什么的、排除/追加的理由"讲清楚。实现 - 名录（SoftwareCatalog.psd1 / Get-SoftwareCatalog） * 一个软件挂多个目录时写成对象数组：@{ Path = '...'; Description = '...' }；也接受纯字符串数组与旧的 @{ Dirs = ... } / @{ Variants = ... }。 * 目录说明（Description）一路带到运行日志里。 * "声明了但当前不存在"的目录不再被丢掉：备份跳过，恢复仍然知道它该回到哪个位置。 * scoop 合并成一个数组条目（%UserProfile%\scoop\persist + %UserProfile%\.config\scoop）； ScoopApps-persist 保持独立条目 —— 它和前者末级名同为 persist，并进同一个归档会在包里撞名。 - 解析与解析结果（ConvertFrom-BackupListLine / Resolve-BackupEntry） * `:+` 以前只对"软件名且能解析出目录"的写法生效，手写目录的 :+ 会被整段丢掉；现在统一生效，且 :+ 后面写软件名会按名录展开。 * 行尾 `# 说明` 解析成 Comment，运行时打印。 - 归档与恢复 * 同一条目里两个同名目录：打包前明确报错（退出码 1），不再静默混成一棵树。（7z 命令行没有"入库改名"的能力，归档内顶层名只能是文件系统上的那个名字。） * 恢复时每个源只解出它自己那棵子树，不会再往别的父目录里复制兄弟目录。 - 可解释性 * 新增 Write-BackupEntryPlan：打包前打印条目的目录（含来源与介绍）以及排除/追加的出处； Restore.ps1 同样打印"哪棵子树还原到哪、会新建还是覆盖"。 - 孤儿归档审计修正：判据只看当前清单，不再把 manifest 的历史记录当成"已知"。否则"条目被合并/改名后留下的旧归档"会被历史记录遮住，永远不会报警。验证 - Pester 84 项、零依赖单元 49 项、端到端 23 项，全部通过。 - 真实机器：合并后的 scoop.7z 233 MB / 29478 项 / 7z t 通过，manifest.roots=[persist\|scoop]；恢复演练 26982/26982 逐字节一致（.ssh、legendary、Aria 同批通过）。 - 迁移提醒：scoop-config.7z 与 scoop-persist.7z 已无清单条目指向，会出现在孤儿审计里；确认 scoop.7z 无误后可以自行删除。	2026-09-22 08:18:16 +08:00

Author

SHA1

Message

Date

Shuery

2937eb6652

chore: 记录改造前基线

改造开始前的完整状态，作为可回退的基点。此提交之后：Pester 175 项、零依赖套件 101 项全绿；PowerShell 5.1 尚不可用（源文件无 BOM）。

包含此前未提交的在制品：安全描述符套件、Hyper-V 实验环境（tools/lab）、agent 约定（AGENTS.md 与 docs/agents）。

.gitignore 增加 *.key / *.pfx：BackupConfig.psd1 的 PasswordFile 此前默认指向仓库内的 baknret.key，一次 git add -A 就会把口令提交进版本库。默认值在后续提交中改为空。

2026-09-26 21:46:55 +08:00

Shuery

7173e8ae10

备份前空间预估；manifest 的 archive 字段只在文件真的存在时才写

需求
- 写满盘这件事只做一件事：**备份前预测本次所需大小，并提示用户存储够不够**，
  不再往"更复杂的占用控制"方向做。

实现
- Backup.ps1 新增只读的"备份前空间预估"，在动手之前按清单顺序模拟一遍：
  * 逐个条目枚举源目录得到真实源大小/文件数，并读取现有归档大小；
  * 沿用主循环那套"源未更新就跳过"的判断，所以列出来的就是**本次真的会重打**的条目；
  * 估算模型：临时归档写完时旧归档还在，那一刻占用 = 当前累计净增量 + 本次预估；
    原子替换后净增量 = 预估 − 旧归档大小；峰值取整个过程的最大值；
  * 预估归档大小：有历史归档取 min(源大小, 旧归档 × 1.3)，没有则按"不压缩"的悲观值；
  * 打印：可用空间、要重打的条目数（及跳过/缺源的数量）、逐条目明细（前 15 条）、
    预计峰值新增与净增量，最后给一句结论——"空间足够"或"空间可能不够！…差 Z GB"。
  * 不够时**只告警、不中断**：真正放不下的条目仍由逐条目守卫跳过。
- 新增 Sync-BaknretManifestArchive（Common.psm1，Backup/Restore 都在写 manifest 前调用）：
  维持不变式"manifest 里写了 archive 的记录，磁盘上就一定有那个文件"，
  把指向不存在归档的 archive 字段清空，但保留 source / action / 历史计数。
  这样"源不存在的条目"不会再让 Restore 反复报"manifest 记录的归档不存在"，
  人工删掉归档（例如把它并进别的条目）之后记录也会自我纠正。

整理（本机备份集）
- 按用户确认，删除了已被 scoop.7z 覆盖的 scoop-config.7z 与 scoop-persist.7z
  （删除前先 7z t 复验 scoop.7z：233 MB / 29478 项 / 顶层 [persist, scoop]），
  并清掉 manifest 里这两条历史记录；24 条记录的 archive 现在全部存在于磁盘上。

测试
- Pester 88 项、零依赖单元 49 项、端到端 23 项，全部通过。
  新增覆盖：对象数组名录、两种写法 × :+/-、同名目录拒绝执行、行尾 # 说明、
  孤儿审计（含"manifest 里还有历史记录"的说明）、archive 字段一致性、空间预估输出。

2026-09-22 08:26:09 +08:00

Shuery

43fa4e52dd

清单格式：两种写法（软件名 / 手写目录）都支持 :+ 追加与 :- 排除；名录改用对象数组并逐条介绍目录

需求
- 支持两种条目写法：1) 直接写软件名录里的软件名；2) 用户手写目录。
- 两种写法都必须支持追加（:+）与排除（:-）。
- 软件名录要改进：scoop 合并成"一个软件 + 一个目录数组"。
- 运行时要把"分别是哪些目录、每个目录是干什么的、排除/追加的理由"讲清楚。

实现
- 名录（SoftwareCatalog.psd1 / Get-SoftwareCatalog）
  * 一个软件挂多个目录时写成**对象数组**：@{ Path = '...'; Description = '...' }；
    也接受纯字符串数组与旧的 @{ Dirs = ... } / @{ Variants = ... }。
  * 目录说明（Description）一路带到运行日志里。
  * "声明了但当前不存在"的目录不再被丢掉：备份跳过，恢复仍然知道它该回到哪个位置。
  * scoop 合并成一个数组条目（%UserProfile%\scoop\persist + %UserProfile%\.config\scoop）；
    ScoopApps-persist 保持独立条目 —— 它和前者末级名同为 persist，并进同一个归档会在包里撞名。
- 解析与解析结果（ConvertFrom-BackupListLine / Resolve-BackupEntry）
  * `:+` 以前只对"软件名且能解析出目录"的写法生效，**手写目录的 :+ 会被整段丢掉**；
    现在统一生效，且 :+ 后面写软件名会按名录展开。
  * 行尾 `# 说明` 解析成 Comment，运行时打印。
- 归档与恢复
  * 同一条目里两个同名目录：打包前明确报错（退出码 1），不再静默混成一棵树。
    （7z 命令行没有"入库改名"的能力，归档内顶层名只能是文件系统上的那个名字。）
  * 恢复时每个源只解出**它自己那棵子树**，不会再往别的父目录里复制兄弟目录。
- 可解释性
  * 新增 Write-BackupEntryPlan：打包前打印条目的目录（含来源与介绍）以及排除/追加的出处；
    Restore.ps1 同样打印"哪棵子树还原到哪、会新建还是覆盖"。
- 孤儿归档审计修正：判据只看当前清单，不再把 manifest 的历史记录当成"已知"。
  否则"条目被合并/改名后留下的旧归档"会被历史记录遮住，永远不会报警。

验证
- Pester 84 项、零依赖单元 49 项、端到端 23 项，全部通过。
- 真实机器：合并后的 scoop.7z 233 MB / 29478 项 / 7z t 通过，manifest.roots=[persist|scoop]；
  恢复演练 26982/26982 逐字节一致（.ssh、legendary、Aria 同批通过）。
- 迁移提醒：scoop-config.7z 与 scoop-persist.7z 已无清单条目指向，会出现在孤儿审计里；
  确认 scoop.7z 无误后可以自行删除。

2026-09-22 08:18:16 +08:00