命令参考
概览
iconchanger <命令> [选项]命令
status
显示当前配置状态。
bash
iconchanger status显示内容：
- 已配置的应用别名数量
- 缓存图标数量
- Helper 脚本状态
list
列出所有别名和缓存图标。
bash
iconchanger list显示所有已配置别名和所有缓存图标条目的表格。
set-icon
为应用设置自定义图标。
bash
iconchanger set-icon <应用路径> <图片路径>参数：
应用路径— 应用的路径（如/Applications/Safari.app）图片路径— 图标图片的路径（PNG、JPEG、ICNS 等）
示例：
bash
# 设置 Safari 自定义图标
iconchanger set-icon /Applications/Safari.app ~/icons/safari.png
# 支持相对路径
iconchanger set-icon /Applications/Slack.app ./slack-icon.icnsremove-icon
移除自定义图标，恢复原始图标。
bash
iconchanger remove-icon <应用路径>示例：
bash
iconchanger remove-icon /Applications/Safari.apprestore
恢复所有缓存的自定义图标。适用于系统更新后或应用重置图标时。
bash
iconchanger restore [选项]选项：
--dry-run— 预览将恢复的内容，不做实际更改--verbose— 显示每个图标的详细输出--force— 强制恢复，即使图标看起来没有变化
示例：
bash
# 恢复所有缓存图标
iconchanger restore
# 预览恢复操作
iconchanger restore --dry-run --verbose
# 强制恢复所有
iconchanger restore --forceexport
导出别名和缓存图标配置到 JSON 文件。
bash
iconchanger export <输出路径>示例：
bash
iconchanger export ~/Desktop/my-icons.jsonimport
导入配置文件。
bash
iconchanger import <输入路径>导入只添加新条目，不会替换或删除现有配置。
示例：
bash
iconchanger import ~/Desktop/my-icons.jsonvalidate
导入前验证配置文件。
bash
iconchanger validate <文件路径>检查 JSON 结构、必需字段和数据完整性，不做实际更改。
示例：
bash
iconchanger validate ~/Desktop/my-icons.jsonescape-jail
逃出 macOS Tahoe 的圆角矩形监狱。通过将应用自身的图标重新设置为自定义图标，绕过系统的圆角矩形强制裁剪，保持原始图标形状。
bash
iconchanger escape-jail [应用路径] [选项]参数：
应用路径— （可选）指定.app包的路径。省略则处理/Applications下的所有应用。
选项：
--dry-run— 预览将执行的操作，不做实际更改--verbose— 显示详细输出
示例：
bash
# 为 /Applications 下的所有应用逃出监狱
iconchanger escape-jail
# 预览操作
iconchanger escape-jail --dry-run --verbose
# 为特定应用逃出监狱
iconchanger escape-jail /Applications/Safari.appWARNING
自定义图标不支持 macOS Tahoe 的 Clear（透明）、Tinted（着色）或 Dark（深色）图标模式，它们保持为静态图片。
completions
生成 Shell 自动补全脚本。
bash
iconchanger completions <shell类型>参数：
shell类型— Shell 类型：zsh、bash或fish
示例：
bash
# Zsh（添加到 ~/.zshrc）
source <(iconchanger completions zsh)
# Bash（添加到 ~/.bashrc）
source <(iconchanger completions bash)
# Fish
iconchanger completions fish > ~/.config/fish/completions/iconchanger.fish