备份前空间预估;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 字段一致性、空间预估输出。
This commit is contained in:
Shuery committed 2026-09-22 08:26:09 +08:00
1 parent 43fa4e52dd
commit 7173e8ae10
5 files changed
+244 -4

No files matched your search

+42 -1
View File
@@ -1310,6 +1310,47 @@ function Read-BaknretManifest {
}
}
function Sync-BaknretManifestArchive {
<#
.SYNOPSIS
清空 manifest 里"指向了一个不存在的归档"的 archive 字段,返回被清空的条目名。
.DESCRIPTION
维持一条不变式:**manifest 里写了 archive 的记录,磁盘上就一定有那个文件。**
没有这条不变式时会出现两种误导:
* 源不存在的条目(missing-source / invalid-path)本来就没有归档,记录里却留着
一个不存在的文件名,Restore 每次都会打一条
"manifest 记录的归档不存在,回退按文件名查找",看着像出了问题其实没有;
* 人工删掉了某个归档(例如把它并进了另一个条目)之后,记录还宣称它在那儿。
只清 archive 字段,保留条目本身的历史(source / 成功次数 / 上次恢复时间),
因为"这个软件曾经备份过、现在源不在了"本身就是有用信息。
#>
param(
[Parameter(Mandatory = $true)]$Manifest,
[Parameter(Mandatory = $true)][string]$BackupDir
)
$cleared = @()
if (-not $Manifest -or -not $Manifest.items) { return , $cleared }
foreach ($key in @($Manifest.items.Keys)) {
$item = $Manifest.items[$key]
if (-not $item) { continue }
if (-not ($item.PSObject.Properties.Name -contains 'archive')) { continue }
$archive = $item.archive
if ([string]::IsNullOrWhiteSpace([string]$archive)) { continue }
if (Test-Path -LiteralPath (Join-Path $BackupDir $archive)) { continue }
$item.archive = $null
$cleared += $key
}
return , $cleared
}
function Write-BaknretManifest {
<#
.SYNOPSIS
@@ -1488,6 +1529,6 @@ Export-ModuleMember -Function @(
'Get-ArchiveTopLevelNames',
'Get-ItemArchiveName', 'Resolve-BackupEntry', 'Write-BackupEntryPlan', 'Get-BackupBaseName', 'Convert-BackupFileNameToPath',
'Get-FolderSummary',
'Read-BaknretManifest', 'Write-BaknretManifest', 'Move-BaknretArchiveIntoPlace',
'Read-BaknretManifest', 'Write-BaknretManifest', 'Sync-BaknretManifestArchive', 'Move-BaknretArchiveIntoPlace',
'Get-BaknretConfig', 'Get-BaknretPassword'
)