PowerShell+ImageMagick：一键自动化设置 Windows 文件夹封面

Rinhon

在干嘛？

偷偷学习中...

标签

站点统计

文章

14

分类

10

标签

24

总字数

14,821

运行时长

0 天

最后活动

0 天前

1602 字

8 分钟

PowerShell+ImageMagick：一键自动化设置 Windows 文件夹封面

2025-12-29

脚本自动化

PowerShell

/

ImageMagick

/

Windows

个人需求：没啥顺手的漫画阅读器。有个叫 Rulia 的我还蛮喜欢，但作者创业去了，久未更新，且一直不支持读取文件夹图片（Cover）的功能。试了个连 Kavita 的插件，压根连不上。

于是转念一想：如果直接修改 Windows 文件夹图标，资源管理器不就是最好的书架吗？

虽然市面上有改压缩包封面的工具，但这不太符合我“解压即看”的习惯。所以我决定自己写个脚本，利用 PowerShell 结合 ImageMagick 来自动化这个过程。ImageMagick 负责高性能的图片裁剪（处理成正方形封面），PowerShell 负责与 Windows 底层交互（写入配置、刷新缓存）。

前置准备#

本方案依赖命令行图像处理工具，请先完成安装：

下载 ImageMagick:
- 前往 ImageMagick 官网下载 Windows 版本。
- 推荐下载：ImageMagick-x.x.x-Q16-HDRI-x64-dll.exe。
关键安装步骤:
- 安装过程中，务必勾选以下两项，否则脚本无法运行：
  - Install legacy utilities (e.g. convert)
  - Add application directory to your system path

第一步：核心逻辑脚本 (`Set-FolderCover.ps1`)#

在任意位置（建议固定目录，如 C:\Scripts\FolderCover）创建文件 Set-FolderCover.ps1。

脚本功能升级点：

智能裁剪：调用 ImageMagick 进行“中心 1:1 裁剪”，保留图片主体。
强制刷新：内置 C# 方法调用 Windows API (SHChangeNotify)，无需重启资源管理器即可看到封面变化。
错误日志：自动记录失败原因到文档目录。

1
param (
2
    [string[]]$TargetItem
3
)
4

5
# 1. 强制 UTF-8 输出
6
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
7

8
# --- 配置 ---
9
$LogFile = [System.IO.Path]::Combine([Environment]::GetFolderPath("MyDocuments"), "FolderIcon_Debug.log")
10
$ImageExtensions = @(".jpg", ".jpeg", ".png", ".bmp", ".webp", ".tif", ".tiff")
11

12
# --- Win32 API ---
13
$code = @"
14
[System.Runtime.InteropServices.DllImport("Shell32.dll")]
15
public static extern int SHChangeNotify(int eventId, int flags, IntPtr item1, IntPtr item2);
16
"@
17
try { $Win32 = Add-Type -MemberDefinition $code -Name "Win32SHChangeNotify" -Namespace Win32Functions -PassThru } catch {}
18

19
# --- 日志 ---
20
function Write-Log {
21
    param ([string]$Message, [string]$Level = "INFO")
22
    $Timestamp = Get-Date -Format "HH:mm:ss"
23
    $LogEntry = "[$Timestamp] [$Level] $Message"
24
    try {
25
        $Encoding = New-Object System.Text.UTF8Encoding($true)
26
        [System.IO.File]::AppendAllText($LogFile, $LogEntry + [Environment]::NewLine, $Encoding)
27
    } catch {}
28

29
    $Colors = @{ "INFO"="White"; "WARN"="Yellow"; "ERROR"="Red"; "SUCCESS"="Green" }
30
    $C = if ($Colors.ContainsKey($Level)) { $Colors[$Level] } else { "Gray" }
31
    Write-Host $LogEntry -ForegroundColor $C
32
}
33

34
function Update-Explorer {
35
    Write-Log "发送图标刷新信号..." "INFO"
36
    $null = $Win32::SHChangeNotify(0x08000000, 0, [IntPtr]::Zero, [IntPtr]::Zero)
37
}
38

39
function Set-FolderIcon {
40
    param ([string]$FolderPath, [string]$SourceImagePath)
41

42
    try {
43
        $FolderPath = (Get-Item -LiteralPath $FolderPath).FullName
44
        $DestPath = [System.IO.Path]::Combine($FolderPath, "folder.ico")
45
        $IniPath = [System.IO.Path]::Combine($FolderPath, "desktop.ini")
46

47
        Write-Log "处理路径: $FolderPath" "INFO"
48

49
        # 1. 清理旧文件
50
        foreach ($f in @("folder.ico", "folder.jpg", "desktop.ini")) {
51
            $p = [System.IO.Path]::Combine($FolderPath, $f)
52
            if (Test-Path -LiteralPath $p) {
53
                Start-Process -FilePath "attrib.exe" -ArgumentList "-s -h -r `"$p`"" -WindowStyle Hidden -Wait
54
                Remove-Item -LiteralPath $p -Force -ErrorAction SilentlyContinue
55
            }
56
        }
57

58
        # 2. 生成 ICO (ImageMagick)
59
        Write-Log "生成图标..." "INFO"
60
        $argsList = @(
61
            "`"$SourceImagePath`"",
62
            "-resize", "256x256^",
63
            "-gravity", "center",
64
            "-extent", "256x256",
65
            "-define", "icon:auto-resize=256,128,64,48,32,16",
66
            "`"$DestPath`""
67
        )
68
        $proc = Start-Process -FilePath "magick" -ArgumentList $argsList -WindowStyle Hidden -Wait -PassThru
69
        if ($proc.ExitCode -ne 0) { throw "Magick 转换失败" }
70

71
        # 3. 写入 desktop.ini (最简版)
72
        Write-Log "配置 desktop.ini..." "INFO"
73

74
        # 只保留核心的一行
75
        $iniContent = "[.ShellClassInfo]`r`nIconResource=folder.ico,0"
76

77
        # 依然使用 UTF-8 (PowerShell 默认带 BOM)
78
        Set-Content -LiteralPath $IniPath -Value $iniContent -Encoding UTF8 -Force
79

80
        # 4. 强制属性 (Attrib)
81
        Write-Log "应用属性..." "INFO"
82
        Start-Process -FilePath "attrib.exe" -ArgumentList "+s +h `"$DestPath`"" -WindowStyle Hidden -Wait
83
        Start-Process -FilePath "attrib.exe" -ArgumentList "+s +h `"$IniPath`"" -WindowStyle Hidden -Wait
84
        Start-Process -FilePath "attrib.exe" -ArgumentList "+r `"$FolderPath`"" -WindowStyle Hidden -Wait
85

86
        # 5. 时间戳刷新
87
        (Get-Item -LiteralPath $IniPath -Force).LastWriteTime = Get-Date
88

89
        Write-Log "成功。" "SUCCESS"
90
    }
91
    catch {
92
        Write-Log "错误: $($_.Exception.Message)" "ERROR"
93
    }
94
}
95

96
# --- 主入口 ---
97
try {
98
    # 合并参数以支持多选
99
    $AllPaths = @()
100
    if ($TargetItem) { $AllPaths += $TargetItem }
101
    if ($args) { $AllPaths += $args }
102

103
    $AllPaths = $AllPaths | Select-Object -Unique | ForEach-Object { $_.Trim().Trim('"') }
104

105
    if ($AllPaths.Count -eq 0) { exit }
106

107
    foreach ($RawPath in $AllPaths) {
108
        if (-not (Test-Path -LiteralPath $RawPath)) { continue }
109

110
        if (Test-Path -LiteralPath $RawPath -PathType Container) {
111
            # 文件夹模式: 避开 folder.ico 和 folder.jpg
112
            $img = Get-ChildItem -LiteralPath $RawPath -File | Where-Object {
113
                $ImageExtensions -contains $_.Extension.ToLower() -and $_.Name -notmatch "^folder\.(ico|jpg)$"
114
            } | Select-Object -First 1
115

116
            if ($img) { Set-FolderIcon -FolderPath $RawPath -SourceImagePath $img.FullName }
117
        }
118
        else {
119
            # 图片模式
120
            $parent = Split-Path -Path $RawPath -Parent
121
            Set-FolderIcon -FolderPath $parent -SourceImagePath $RawPath
122
        }
123
    }
124
    Update-Explorer
125
}
126
catch {
127
    Write-Log "Main Crash: $_" "ERROR"
128
}

第二步：注册右键菜单 (`Register-RightClick.ps1`)#

将此脚本放在与 Set-FolderCover.ps1 相同的目录下。

脚本功能：

自动识别当前路径，写入注册表。
同时注册到 “文件夹右键” 和 “图片文件右键”。
自动提权：双击运行即可，无需手动右键以管理员运行。

1
# --- 自动提权模块 ---
2
$currentPrincipal = New-Object Security.Principal.WindowsPrincipal([Security.Principal.WindowsIdentity]::GetCurrent())
3
if (-not $currentPrincipal.IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)) {
4
    Start-Process powershell.exe "-NoProfile -ExecutionPolicy Bypass -File `"$PSCommandPath`"" -Verb RunAs
5
    Exit
6
}
7

8
# --- 环境检查 ---
9
$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Definition
10
$TargetScript = Join-Path -Path $ScriptDir -ChildPath "Set-FolderCover.ps1"
11

12
if (-not (Test-Path $TargetScript)) {
13
    Write-Host "错误：未找到主脚本 Set-FolderCover.ps1" -ForegroundColor Red
14
    Write-Host "请确保两个文件在同一目录。"
15
    Pause; Exit
16
}
17

18
if (-not (Get-Command magick -ErrorAction SilentlyContinue)) {
19
    Write-Host "警告：未检测到 'magick' 命令！" -ForegroundColor Yellow
20
    Write-Host "请确保已安装 ImageMagick 且添加到了 PATH 环境变量。"
21
    Write-Host "按任意键继续（如果确认已安装）..."
22
    Pause
23
}
24

25
# --- 注册表操作 ---
26
$MenuText = "设置纯图封面 (1:1)"
27
# 使用系统自带图标，也可替换为 .ico 文件路径
28
$IconPath = "imageres.dll,-68"
29

30
function Register-Menu {
31
    param (
32
        [string]$RegPath,
33
        [string]$MenuName
34
    )
35

36
    $KeyPath = "Registry::HKEY_CLASSES_ROOT\$RegPath\shell\SetFolderCover"
37
    $CommandPath = "$KeyPath\command"
38

39
    # 1. 创建菜单项
40
    if (-not (Test-Path $KeyPath)) { New-Item -Path $KeyPath -Force | Out-Null }
41
    Set-ItemProperty -Path $KeyPath -Name "(default)" -Value $MenuName
42
    Set-ItemProperty -Path $KeyPath -Name "Icon" -Value $IconPath
43

44
    # 2. 注入命令 (优先使用 pwsh, 降级使用 powershell)
45
    if (-not (Test-Path $CommandPath)) { New-Item -Path $CommandPath -Force | Out-Null }
46

47
    $Executor = if (Get-Command pwsh -ErrorAction SilentlyContinue) { "pwsh.exe" } else { "powershell.exe" }
48
    $Command = "$Executor -WindowStyle Hidden -ExecutionPolicy Bypass -File `"$TargetScript``" `"%1`""
49

50
    Set-ItemProperty -Path $CommandPath -Name "(default)" -Value $Command
51
}
52

53
try {
54
    Write-Host "正在注入注册表..." -ForegroundColor Cyan
55

56
    # 注册位置 1: 文件夹背景/图标右键
57
    Register-Menu -RegPath "Directory" -MenuName $MenuText
58

59
    # 注册位置 2: 所有图片格式右键
60
    Register-Menu -RegPath "SystemFileAssociations\image" -MenuName "设为当前文件夹封面 (1:1)"
61

62
    Write-Host "✅ 注册成功！" -ForegroundColor Green
63
    Write-Host "现在你可以右键文件夹或图片使用了。"
64
}
65
catch {
66
    Write-Host "❌ 注册失败：$_" -ForegroundColor Red
67
}
68

69
Pause

使用指南#

部署：

将上述两个 .ps1 文件放在同一永久目录（如 D:\Tools\FolderCover\）。
双击运行 Register-RightClick.ps1（会自动请求管理员权限）。

操作：

方法 A：在资源管理器中，右键点击某个漫画文件夹 -> 选择 设置纯图封面 (1:1)。
方法 B：进入文件夹，右键点击你喜欢的某张图片 -> 选择 设为当前文件夹封面 (1:1)。

批量处理：

选中几百个文件夹，右键一次性执行，脚本会自动为每个文件夹找第一张图做封面。

效果原理#

脚本的核心在于这一行 ImageMagick 命令：

1
magick "input.jpg" -gravity center -extent "%[fx:w<h?w:h]x%[fx:w<h?w:h]" "folder.jpg"

它利用 fx 表达式动态计算宽高，取较小值作为边长，配合 center 重心，实现智能正方形裁切。相比直接缩放，这样能最大程度保留封面的人物主体，在书架视图下也更整齐美观。

如果这篇文章对你有帮助，欢迎分享给更多人！

PowerShell+ImageMagick：一键自动化设置 Windows 文件夹封面

http://www.rinhonlc.fun/posts/windows-folder-cover-automation/

作者

Rinhon

发布于

2025-12-29

许可协议

CC BY-NC-SA 4.0

部分信息可能已经过时

MarkDown基本语法

docker

Rinhon

前置准备#

第一步：核心逻辑脚本 (Set-FolderCover.ps1)#

第二步：注册右键菜单 (Register-RightClick.ps1)#

使用指南#

效果原理#

第一步：核心逻辑脚本 (`Set-FolderCover.ps1`)#

第二步：注册右键菜单 (`Register-RightClick.ps1`)#