Shuery
42f02d0eca
16 个没有前缀的公共函数补上 BakNRet（Write-Log → Write-BakNRetLog、Resolve-BackupEntry → Resolve-BakNRetBackupEntry、Find-ChildDirectoryByName → Find-BakNRetChildDirectoryByName 等）， 另外把全仓的 Baknret 统一成 BakNRet（47 个文件、940 处、65 个定义文件重命名）。 这不是审美问题：静态分析直接拓出一条实据 —— Write-Log 与本机某个已装模块导出的命令 **重名**（PSAvoidOverwritingBuiltInCmdlets），而重名的后果是导入两个模块时有一方的命令被 静默遮蔽。补前缀正是这条规则的解法，改名后它归零。 为什么敢做这个规模：PowerShell 的函数名解析大小写不敏感，所以 Baknret → BakNRet 在功能 上是零风险；真正要验证的是 16 个补前缀的调用点，而 276 个断言几乎覆盖了每个函数。另外 "名字与文件名一致"这条不变式有断言盯着（加载器点源的文件集合 vs 磁盘）。 踩到并记下的坑：Windows 文件系统大小写不敏感，所以**只改大小写**的重命名会被 Move-Item 当成同一个文件而静默跳过 —— 同一批里同时改了名字的那 16 个文件却成功了，于是"看起来能跑"。 最后用"先移到临时名、再移到目标名"的两步走解决，判断与替换全部改用显式大小写敏感的形式 （-creplace / -cmatch）。 顺带把名录指纹缓存从 MD5 换成 SHA256（PSAvoidUsingBrokenHashAlgorithms）：它只是缓存键， 没有兼容负担。 验收：test.ps1 9/9 全绿（7 与 5.1）、100 个文件两版解析零错、276 个断言全过、 构建工具仍能合回单文件（3300 行）。
94 lines
3.6 KiB
PowerShell
94 lines
3.6 KiB
PowerShell
<#
|
|
模块清单。
|
|
|
|
为什么需要它：把"这个模块对外提供什么"变成一份可读的契约。这里 FunctionsToExport 是
|
|
**显式白名单**（官方性能指南明确要求不用通配符；PSUseToExportFieldsInManifest 也是恒开
|
|
的规则、关不掉）。名字少写一个，对应函数就不会被导出 —— 这是有意的：宁可导入方报
|
|
"找不到命令"，也不要静默少一个函数。
|
|
|
|
CompatiblePSEditions 声明"桌面版与核心版都能导入"：本模块兼容 Windows PowerShell 5.1
|
|
与 PowerShell 7.x。代价是放弃 PS 4.0 及以下，那是刻意的。
|
|
#>
|
|
@{
|
|
RootModule = 'BakNRet.psm1'
|
|
ModuleVersion = '1.0.0'
|
|
GUID = '9bc892ed-f852-4468-b1e7-d71a91cf2913'
|
|
Author = 'Shuery'
|
|
Description = 'BakNRet 公共模块：日志、外部命令调用、清单与名录解析、归档命名与暂存、manifest、安全描述符。兼容 Windows PowerShell 5.1 与 PowerShell 7.x。'
|
|
PowerShellVersion = '5.1'
|
|
CompatiblePSEditions = @('Desktop', 'Core')
|
|
|
|
FunctionsToExport = @(
|
|
'Enter-BakNRetRunLock',
|
|
'Exit-BakNRetRunLock',
|
|
'Get-BakNRetRunLockPath',
|
|
'Set-BakNRetDebug',
|
|
'Start-BakNRetLog',
|
|
'Stop-BakNRetLog',
|
|
'Get-BakNRetLogPath',
|
|
'Write-BakNRetLog',
|
|
'Test-BakNRetAdministrator',
|
|
'Get-BakNRetFreeSpaceGB',
|
|
'ConvertTo-BakNRetNativeArgumentString',
|
|
'Invoke-ExternalCommand',
|
|
'Resolve-BakNRetCompressionTool',
|
|
'Get-Optimized7zArgument',
|
|
'Split-BakNRetToken',
|
|
'Remove-BakNRetQuote',
|
|
'Test-BakNRetMarker',
|
|
'ConvertFrom-BakNRetPatternList',
|
|
'ConvertFrom-BackupListLine',
|
|
'Test-BakNRetLiteralPath',
|
|
'Get-BakNRetRegexExclude',
|
|
'Get-BakNRetExcludeArgument',
|
|
'Split-BakNRetPatternScope',
|
|
'Merge-BakNRetExcludeArgument',
|
|
'Resolve-BakNRetCatalogPath',
|
|
'Get-BakNRetSoftwareCatalog',
|
|
'Find-BakNRetChildDirectoryByName',
|
|
'Format-BakNRetCatalogName',
|
|
'Expand-CatalogPathText',
|
|
'Get-BakNRetArchiveTopLevelNames',
|
|
'Get-BakNRetArchiveTopName',
|
|
'New-BakNRetArchiveItem',
|
|
'New-BakNRetJunction',
|
|
'Remove-BakNRetJunction',
|
|
'New-BakNRetArchiveStaging',
|
|
'Remove-BakNRetArchiveStaging',
|
|
'Get-BakNRetItemArchiveName',
|
|
'Resolve-BakNRetBackupEntry',
|
|
'Write-BakNRetBackupEntryPlan',
|
|
'Get-BakNRetBackupBaseName',
|
|
'Convert-BakNRetBackupFileNameToPath',
|
|
'Get-BakNRetFolderSummary',
|
|
'Read-BakNRetManifest',
|
|
'Write-BakNRetManifest',
|
|
'Sync-BakNRetManifestArchive',
|
|
'Move-BakNRetArchiveIntoPlace',
|
|
'Enable-BakNRetPrivilege',
|
|
'ConvertTo-BakNRetWildcardPattern',
|
|
'Test-BakNRetPathExcluded',
|
|
'Get-BakNRetAceSignatureList',
|
|
'Get-BakNRetSecuritySddlWithStale',
|
|
'Get-BakNRetSecurityRecord',
|
|
'Test-BakNRetSecurityRecordNeeded',
|
|
'Get-BakNRetSecurityRecords',
|
|
'Write-BakNRetAtomicText',
|
|
'Save-BakNRetSecuritySidecar',
|
|
'Read-BakNRetSecuritySidecar',
|
|
'Convert-BakNRetSidMap',
|
|
'Set-BakNRetObjectSecurity',
|
|
'Restore-BakNRetSecurity',
|
|
'Get-BakNRetConfig',
|
|
'Get-BakNRetPassword'
|
|
)
|
|
CmdletsToExport = @()
|
|
VariablesToExport = @()
|
|
AliasesToExport = @()
|
|
|
|
PrivateData = @{
|
|
PSData = @{ Tags = @('Backup', 'Restore', '7zip', 'Windows', 'PSEdition_Desktop', 'PSEdition_Core') }
|
|
}
|
|
}
|
|
|