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

Rinhon

在干嘛？

偷偷学习中...

标签

站点统计

文章

14

分类

10

标签

24

总字数

14,875

运行时长

0 天

最后活动

0 天前

1666 字

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
# --- 配置部分 ---
6
$ErrorLogPath = [System.IO.Path]::Combine([Environment]::GetFolderPath("MyDocuments"), "FolderCover_ErrorLog.txt")
7
$ImageExtensions = @(".jpg", ".jpeg", ".png", ".bmp", ".webp", ".tif", ".tiff")
8

9
# --- 嵌入 C# 代码：用于强制刷新 Windows 图标缓存 ---
10
$code = @"
11
[System.Runtime.InteropServices.DllImport("Shell32.dll")]
12
public static extern int SHChangeNotify(int eventId, int flags, IntPtr item1, IntPtr item2);
13
"@
14
$Win32 = Add-Type -MemberDefinition $code -Name "Win32SHChangeNotify" -Namespace Win32Functions -PassThru
15

16
# --- 函数定义 ---
17

18
function Write-Log {
19
    param ([string]$Message)
20
    $Timestamp = Get-Date -Format "yyyy-MM-dd HH:mm:ss"
21
    Add-Content -Path $ErrorLogPath -Value "[$Timestamp] $Message" -Encoding UTF8
22
}
23

24
function Refresh-Explorer {
25
    # 0x08000000 = SHCNE_ASSOCCHANGED (通知系统文件关联/图标已变更)
26
    # 虽是核弹级刷新，但对文件夹图标生效最快
27
    $null = $Win32::SHChangeNotify(0x08000000, 0, [IntPtr]::Zero, [IntPtr]::Zero)
28
}
29

30
function Set-CoverImage {
31
    param (
32
        [string]$FolderPath,
33
        [string]$SourceImagePath
34
    )
35

36
    try {
37
        if (-not (Test-Path $SourceImagePath)) { return }
38

39
        $DestPath = Join-Path -Path $FolderPath -ChildPath "folder.jpg"
40

41
        # 1. 清理旧文件（需先移除只读/隐藏属性才能删除）
42
        if (Test-Path $DestPath) {
43
            $existing = Get-Item $DestPath
44
            $existing.Attributes = "Normal"
45
            Remove-Item -Path $DestPath -Force
46
        }
47

48
        # 2. 调用 ImageMagick 处理图片
49
        # -gravity center: 居中定位
50
        # -extent: 强制调整画布为 1:1 (宽=高，取原图中较小的一边)
51
        $magickCmd = "magick"
52
        $argsList = @(
53
            "`"$SourceImagePath`"",
54
            "-gravity", "center",
55
            "-extent", "`"%[fx:w<h?w:h]x%[fx:w<h?w:h]`"",
56
            "`"$DestPath`""
57
        )
58

59
        $process = Start-Process -FilePath $magickCmd -ArgumentList $argsList -WindowStyle Hidden -Wait -PassThru
60

61
        if ($process.ExitCode -ne 0) {
62
            throw "ImageMagick CLI 执行失败，ExitCode: $($process.ExitCode)"
63
        }
64

65
        # 3. 设置 folder.jpg 为系统+隐藏
66
        $file = Get-Item $DestPath
67
        $file.Attributes = "Hidden, System"
68

69
        # 4. 配置 desktop.ini
70
        # 关键：文件夹必须设为 ReadOnly，Windows 才会去读 desktop.ini
71
        $folder = Get-Item $FolderPath
72
        $folder.Attributes = "ReadOnly"
73

74
        $iniPath = Join-Path -Path $FolderPath -ChildPath "desktop.ini"
75
        if (Test-Path $iniPath) {
76
            (Get-Item $iniPath).Attributes = "Normal"
77
        }
78

79
        # 写入配置 (使用 Unicode 编码以兼容特殊字符，虽然 folder.jpg 是纯英文)
80
        $iniContent = "[.ShellClassInfo]`r`nLogo=folder.jpg"
81
        Set-Content -Path $iniPath -Value $iniContent -Encoding Unicode -Force
82

83
        # desktop.ini 必须是 Hidden + System
84
        (Get-Item $iniPath).Attributes = "Hidden, System"
85

86
        # 5. 触发刷新
87
        Refresh-Explorer
88
    }
89
    catch {
90
        Write-Log "处理失败 [$FolderPath]: $_"
91
    }
92
}
93

94
function Find-FirstImage {
95
    param ([string]$Path)
96
    try {
97
        # 排除 folder.jpg 自身，防止递归错误
98
        $images = Get-ChildItem -Path $Path -File | Where-Object {
99
            $ImageExtensions -contains $_.Extension.ToLower() -and $_.Name -ne "folder.jpg"
100
        }
101
        if ($images) {
102
            return ($images | Select-Object -First 1).FullName
103
        }
104
    }
105
    catch {
106
        Write-Log "搜图失败 [$Path]: $_"
107
    }
108
    return $null
109
}
110

111
# --- 主入口 ---
112

113
try {
114
    # 清洗传入路径（去除注册表可能带来的多余引号）
115
    $TargetItem = $TargetItem.Trim('"')
116

117
    if (Test-Path $TargetItem -PathType Container) {
118
        # === 场景 A: 用户右键了文件夹 ===
119
        $img = Find-FirstImage -Path $TargetItem
120
        if ($img) {
121
            Set-CoverImage -FolderPath $TargetItem -SourceImagePath $img
122
        } else {
123
            Write-Log "跳过: 文件夹内无可用图片 - $TargetItem"
124
        }
125
    }
126
    elseif (Test-Path $TargetItem -PathType Leaf) {
127
        # === 场景 B: 用户右键了图片 ===
128
        $ext = [System.IO.Path]::GetExtension($TargetItem).ToLower()
129
        if ($ImageExtensions -contains $ext) {
130
            $parentDir = [System.IO.Path]::GetDirectoryName($TargetItem)
131
            Set-CoverImage -FolderPath $parentDir -SourceImagePath $TargetItem
132
        }
133
    }
134
}
135
catch {
136
    Write-Log "致命错误: $_"
137
}

第二步：注册右键菜单 (`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/set-folder-picture-cover/

作者

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`)#