fix: 行首方向标记贴在目标上时失效(真实清单 29 条里 24 条被静默跳过)

量到的事实:用真实清单只读干跑,28 个条目里 27 个被当成"源不存在"跳过、退出码 0,
只有不写方向标记的 Scoop 真的被备份 —— 磁盘上最新那份归档正是 Scoop.7z(4.6 GB / 09-24)。
修复后同一批条目:29 条全部分解出方向(26 仅备份 / 2 仅恢复 / 1 双向),零个标记残留。

原因:解析器只认"独立记号"形态的方向标记(+ Name),而清单里 24 条贴在目标上
(+WindowsTerminal)。后者被当成一个名叫 +WindowsTerminal 的软件名,名录里查不到就退回
当目录名,目录又不存在 → 静默记成 missing-source。它隐形的理由是两件本身正确的设计叠在
一起:"源不存在只算跳过不算失败" 加上两种写法只差一个空格。

README 的方向标记表格写的是"行首 + / -",并没有要求标记后面跟空格;要求带空白的是
修饰符(:: / :- / :+ / @)那一节。所以让解析器接受行首贴在一起的形态,而不是去改清单。
只放宽"行首"这一个位置:记号中间的 + / - 仍是普通字符(C:\a:-b 那条断言继续盯着)。

新增 tests\Run-RealSmoke.ps1:真实清单 + 真实归档上的只读冒烟。它存在的理由就是这个
缺陷 —— 夹具测试全绿,只有拿真实清单跑才看得见。它检查四件事:方向标记全部被剥掉、没有
软件名退化成"名录里没有"、两个只读模式退出 0、manifest.json 的 SHA256 前后不变。

验收:test.ps1 9/9 全绿(7 与 5.1);tests\Run-RealSmoke.ps1 4/4 全绿。
This commit is contained in:
Shuery committed 2026-09-26 22:26:45 +08:00
1 parent e10503be76
commit 8736bb2c67
4 files changed
+236 -2

No files matched your search

+18 -2
View File
@@ -494,7 +494,9 @@ function ConvertFrom-BackupListLine {
与旧实现的区别:
* `::` 现在表示"覆盖 Path"(旧版是 `:-` 的历史别名),排除一律写 `:-`;
* 新增行首 `+` / `-` 方向、`:encrypt` / `:!encrypt`、`@ Key='Value'` 覆盖;
* 修饰符必须是独立记号(前后加空格),所以 `C:\a:-b` 仍然是路径。
* 修饰符必须是独立记号(前后加空格),所以 `C:\a:-b` 仍然是路径;
* 行首方向标记是唯一例外:`+` / `-` 贴在目标上(`+Edge`)或独立成记号
(`+ Edge`)都认。详见下面判定处的注释。
#>
param([Parameter(ValueFromPipeline = $true)][AllowEmptyString()][string]$Line)
@@ -539,7 +541,15 @@ function ConvertFrom-BackupListLine {
}
}
# 行首方向标记:`+` 仅备份、`-` 仅恢复
# 行首方向标记:`+` 仅备份、`-` 仅恢复。
#
# 两种写法都认:独立成记号(`+ Edge`)与贴在目标上(`+Edge`)。后者是本仓库清单
# 里的主流写法,而过去只认前者 —— 于是 `+WindowsTerminal` 被当成一个名叫
# `+WindowsTerminal` 的软件名,名录里查不到就退回当目录名,目录又不存在,
# 整条静默记成 missing-source 跳过;备份按"跳过不算失败"退出 0,所以一直没暴露。
#
# 只放宽"行首"这一个位置:修饰符(:: / :- / :+ / @)仍然必须是独立记号,
# 否则 `C:\a:-b` 这类路径会被切坏 —— 那是另一条已经钉住的行为。
$direction = 'both'
if ($tokens[0] -eq '+') {
$direction = 'backup'
@@ -547,6 +557,12 @@ function ConvertFrom-BackupListLine {
} elseif ($tokens[0] -eq '-') {
$direction = 'restore'
$tokens = @($tokens | Select-Object -Skip 1)
} elseif ($tokens[0].Length -gt 1 -and $tokens[0][0] -eq '+') {
$direction = 'backup'
$tokens[0] = $tokens[0].Substring(1)
} elseif ($tokens[0].Length -gt 1 -and $tokens[0][0] -eq '-') {
$direction = 'restore'
$tokens[0] = $tokens[0].Substring(1)
}
if ($tokens.Count -eq 0) { return $null }