Shuery
60ecbc2933
拆出软件名录（67 行）、清单语法（114 行）、归档布局与迁移（47 行）、安全描述符（69 行），共 297 行；README 从 653 降到 360 行，每节原位留一句摘要加链接。 为什么拆：这四块是「要查的资料」，README 剩下的是「要读的流程」。混在一起时，想查清单语法的人得先滚过一百多行总览；拆开后每篇也能被单独引用与单独评审。 搬运按标题抽取原文、不重打，并在写之前断言正文长度、写之后再读回断言一次（第一次尝试就是栽在没有断言上：@(a, b, $arr) 不会展开数组，而是把 $arr 拼成一行，结果四篇各只有 5 行、正文却已从 README 删除。那次已回滚）。
3.3 KiB
3.3 KiB
SoftwareCatalog.psd1 —— 软件名 → Slot 组
本文从 README.md 拆出，单独成篇是为了让它能被单独引用与单独评审。
@{
Edge = @{
# Slot = 归档内的一层目录：内容进 DefaultData\，恢复时整棵回到这个 Path
DefaultData = @{
Path = '%LocalAppData%\Microsoft\Edge\User Data'
Exclude = '!*Cache,!Crashpad,Default\Extensions,Default\Service Worker'
Description = 'Edge 用户数据：书签/密码/偏好/历史，以及站点数据'
}
}
Scoop = @{
# 一个软件可以有多个 Slot；两个都叫 persist 的目录因此不再冲突
DefaultConfig = @{
Path = '%UserProfile%\.config\scoop'
Encrypt = $true
Description = 'scoop 自身的配置'
}
UserPersist = @{
Path = '$(if ($env:SCOOP) { $env:SCOOP } else { Join-Path $env:USERPROFILE "scoop" })\persist'
Encrypt = $true
Description = 'scoop 各应用的持久化数据'
}
}
WindowsTerminal = @{
# Path 指向文件时，归档里就是一个名为 DefaultData 的文件（没有扩展名）
DefaultData = @{
Path = '%LocalAppData%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\settings.json'
Encrypt = $true
Description = 'Windows Terminal 的设置文件'
}
}
}
字段：
| 字段 | 说明 |
|---|---|
| Slot 名 | 归档内的一层目录。内容进 <Slot>\；Path 是文件时就是名为 <Slot> 的文件。同一软件里不能重名 |
Path |
宿主机上的绝对路径。支持 %变量% 与 $( ... ) 子表达式 |
Exclude |
排除模式，相对本 Slot 的根，逗号分隔。! 打头 = 任意层级（7z 通配符），!re:<正则> = 正则 |
Include |
追加项，<归档内相对路径>:<宿主机绝对路径>，逗号分隔 |
Encrypt |
该归档是否加密，默认 $false。同一软件里若各 Slot 不一致，整个归档按加密处理 |
Description |
这个 Slot 是干什么的；运行时逐条打印 |
要点：
Path支持$( ... )：$(if ($env:SCOOP) { $env:SCOOP } else { Join-Path $env:USERPROFILE "scoop" })会按 PowerShell 求值（求值结果会缓存，不会每个条目重复起进程）。 这类写法用了+拼接字符串时，Import-PowerShellDataFile会拒绝，脚本会自动改用 PowerShell 求值——名录与配置是仓库里的本地文件，和脚本同级，信任级别相同。- 目录当前不存在也不会被丢掉：备份时跳过并记
missing-source，但恢复时仍然知道 "这块内容原本该回到哪个位置"，这正是恢复要用的。 - 前缀补全：写
D:\Programs\legendary，实际目录是legendary_2.0.4时会自动匹配 （只认<名>_*与<名>-*）。一个 Slot 只能对应一个目录，补全出多个会明确报错并让你拆 Slot。 - 一个软件里不能有两个同名 Slot，否则归档内会混成一棵树；脚本会明确报错。
分文件维护：用 Includes 引入其它名录文件（路径相对本文件）：
@{
Includes = @('SoftwareCatalog.games.psd1')
...
}