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

+33
View File
@@ -85,6 +85,39 @@ Test-Case '行首 - 表示仅恢复' {
Assert-Equal 'C:\Programs\FooClolor' $r.Path
}
Test-Case '行首标记贴在目标上也算(+Name / -Path),且标记不进入目标' {
# 这是本仓库清单里的主流写法,也是曾经被静默忽略的那种:标记与目标之间没有空格。
# 过去只认独立记号,于是 `+WindowsTerminal` 被当成"名叫 +WindowsTerminal 的软件名",
# 名录查不到、目录不存在,整条静默记成 missing-source 跳过,而备份仍然退出 0。
$attached = ConvertFrom-BackupListLine -Line '+FooClolor'
Assert-Equal 'backup' $attached.Direction
Assert-Equal 'FooClolor' $attached.Path
Assert-True $attached.IsName
$restoreAttached = ConvertFrom-BackupListLine -Line '-C:\Programs\Foo'
Assert-Equal 'restore' $restoreAttached.Direction
Assert-Equal 'C:\Programs\Foo' $restoreAttached.Path
Assert-False $restoreAttached.IsName
# 贴在一起的写法照样能带修饰符
$withOverride = ConvertFrom-BackupListLine -Line '+FooClolor @ Encrypt=''$false'''
Assert-Equal 'backup' $withOverride.Direction
Assert-Equal 'FooClolor' $withOverride.Path
Assert-False $withOverride.Overrides['Encrypt']
}
Test-Case '非行首的 + / - 不是方向标记' {
# 只放宽"行首"这一个位置:记号中间的 + / - 仍然只是普通字符,
# 否则 C:\a:-b 这类路径会被切坏(这条一直有断言盯着)。
$plusInside = ConvertFrom-BackupListLine -Line 'C:\a+b'
Assert-Equal 'both' $plusInside.Direction
Assert-Equal 'C:\a+b' $plusInside.Path
$dashInside = ConvertFrom-BackupListLine -Line 'foo-bar'
Assert-Equal 'both' $dashInside.Direction
Assert-Equal 'foo-bar' $dashInside.Path
}
Test-Case '没有方向标记时是 both(同时备份与恢复)' {
Assert-Equal 'both' (ConvertFrom-BackupListLine -Line 'C:\x').Direction
}