# 无损图片压缩 skill **Repository Path**: XF_469306621/imgcompress-skill ## Basic Information - **Project Name**: 无损图片压缩 skill - **Description**: No description available - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 0 - **Created**: 2026-08-22 - **Last Updated**: 2026-08-22 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # imgcompress — 图片无损压缩,体积最高省 90%+,画质依旧清晰 **Author: XiaoHong Zuo** **一张 10MB 的图片,一键压到 1MB 以内,肉眼几乎看不出区别。** 一个开箱即用的图片批量压缩技能,无需安装任何工具,装上就能用。 ## 为什么值得一试? - **压缩率最高可达 90% 以上**:PNG 最高省 90%+,JPG 通常省 70%~90%,立竿见影 - **不减文件质量**:肉眼几乎看不出画质差异,却能把文件大小压到十分之一 - **只减不增,绝对安全**:仅在压缩后体积更小时才替换原文件,绝不会让图片变大 - **开箱即用**:自带压缩工具,安装即用,不需要额外配置 > 空间不够了?图片加载太慢?包体太大被拒审?用它,一次搞定。 - 批量压缩 `.png` / `.jpg` / `.jpeg` 图片 - **只在压缩后体积更小时才替换原文件**,图片体积只减不增 - 自带压缩工具,**安装即用**,不需要额外配置 ## 搜索关键词 / Tags `图片压缩` `无损压缩` `image compression` `lossless compression` `png` `jpg` `jpeg` `batch compress` `批量压缩` `压缩图片` `减小图片体积` `图片优化` `Skill` `Agent Skills` `CodeBuddy` --- ## 使用场景 - **小程序 / 网页项目**:上线前批量压缩图片资源,减小包体体积、提升加载速度 - **设计稿导出**:压缩 PNG/JPG 素材,减少存储占用 - **APP 打包**:压缩图标与启动图,缩小安装包 - **日常整理**:把零散的大体积图片集中瘦身 --- ## 特性 | 特性 | 说明 | |------|------| | 安全压缩 | 只在压缩后更小时替换,绝不会让图片变大 | | 批量处理 | 给目录就一次性压缩里面所有图片;给单张图片路径就只压缩那一张 | | 预览模式 | 先看压缩效果,满意后再真正压缩 | | 自动依赖 | 首次使用自动安装所需组件,无需手动配置 | | 开箱即用 | 装上就能用,无需预装任何东西 | --- ## 前置条件 **必须安装 Node.js(≥ 14)**,压缩工具依赖 Node 运行。 在终端检查是否已安装: ```bash node -v ``` - 有输出版本号(如 `v20.x.x`)→ 已安装,继续。 - 报错 `command not found: node` → 到 [nodejs.org](https://nodejs.org) 下载安装后重试。 另外需要能联网使用 **npm**,首次使用时会自动下载压缩组件(只需一次)。 > 以下四种安装方式,任选一种即可。 --- ## 安装 ### 方式一:导入 Skill 包(推荐,装进 CodeBuddy) 1. 下载本仓库中的 [`imgcompress.zip`](./imgcompress.zip) —— **不用解压,直接选这个 zip 文件就行** 2. 打开 CodeBuddy / WorkBuddy → 设置 → **Skills(技能)** 3. 点击 **导入 Skill**,选择刚下载的 `imgcompress.zip` 4. 导入完成后即可直接使用 > 导入的是整个 zip 包,它会自己解压安装,你不需要手动解压或指定目录。 --- ### 方式二:放入用户技能目录(所有项目都能用) 把脚本放进程 **CodeBuddy 的用户技能目录**(这是所有项目共享的全局技能目录,一个文件路径,无需手动解压)。先把目录结构看清: ```bash ~/.codebuddy/ # 这是用户主目录下的 CodeBuddy 配置目录 └── skills/ # 技能目录(不存在就创建) └── imgcompress/ # 把整个 imgcompress 文件夹放进来 ``` 执行: ```bash # ① 先解压,得到 imgcompress 文件夹 unzip imgcompress.zip -d ~/.codebuddy/skills/ # ② 确认放对了位置(应能看到 scripts 目录) ls ~/.codebuddy/skills/imgcompress/ ``` > `~` 代表你的用户主目录(macOS 是 `/Users/你的用户名`,Linux 是 `/home/你的用户名`)。如果 `skills` 目录不存在,上面命令会自动创建。放好后,所有项目都能用。 --- ### 方式三:放入当前项目目录(仅当前项目用) 把脚本放进**当前项目的** `.codebuddy/skills/` 目录(这是项目里的隐藏配置目录,只对这个项目生效): ```bash # ① 先解压,得到 imgcompress 文件夹 unzip imgcompress.zip -d .codebuddy/skills/ # ② 确认放对了位置 ls .codebuddy/skills/imgcompress/ ``` > `.codebuddy` 是项目根目录下以点开头的隐藏文件夹,如果你没看到它,执行上面命令会自动创建。这种方式只对当前项目有效。 --- ### 方式四:安装为系统命令(不依赖 CodeBuddy,纯命令行使用) 如果你不想用 CodeBuddy,想让终端里直接有个 `imgcompress` 命令,把它放进系统的命令搜索路径(PATH)即可。脚本是自包含的、已带可执行权限,放进去后在任何目录敲 `imgcompress` 都能用。**这种方式仍然依赖 Node.js,但不需要 CodeBuddy 或任何技能环境。** 各平台做法如下: #### macOS(推荐用 `~/.local/bin`,不用 sudo) 用你自己用户目录下的 `~/.local/bin` 来放命令,并把它加进 PATH。好处是**不需要 sudo、不影响系统**,卸载也干净。 ```bash # ① 创建你的本地命令目录(如果不存在) mkdir -p ~/.local/bin # ② 把脚本复制进去 cp scripts/imgcompress ~/.local/bin/imgcompress # ③ 加上可执行权限(脚本已带,保险起见执行一次) chmod +x ~/.local/bin/imgcompress # ④ 把 ~/.local/bin 加入 PATH(只对当前终端生效) export PATH="$HOME/.local/bin:$PATH" ``` 第 ④ 步只对当前终端窗口有效。要**永久生效**,把这一行写进你的 shell 配置文件。macOS 默认用 zsh,配置文件是 `~/.zshrc`: ```bash # 打开配置文件 nano ~/.zshrc # 在文件末尾加一行: # export PATH="$HOME/.local/bin:$PATH" # 保存退出后,让配置立即生效: source ~/.zshrc ``` 最后验证: ```bash # 应该输出 /Users/你的用户名/.local/bin/imgcompress which imgcompress imgcompress --help ``` > 如果你更愿意放进系统级目录 `/usr/local/bin`(需要 sudo),也可以: > ```bash > sudo cp scripts/imgcompress /usr/local/bin/imgcompress > sudo chmod +x /usr/local/bin/imgcompress > ``` #### Linux(与 macOS 类似,配置文件略有差异) Linux 多数发行版同样可以用 `~/.local/bin`(无需 sudo): ```bash mkdir -p ~/.local/bin cp scripts/imgcompress ~/.local/bin/imgcompress chmod +x ~/.local/bin/imgcompress export PATH="$HOME/.local/bin:$PATH" ``` 永久生效的配置文件因发行版而异: | Shell | 配置文件 | |-------|----------| | Bash(Ubuntu/Debian 等默认) | `~/.bashrc` | | Zsh | `~/.zshrc` | ```bash # 例如 Bash 用户: echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc source ~/.bashrc which imgcompress # 验证 ``` > 有些发行版默认 PATH 里不含 `~/.local/bin`,若 `which imgcompress` 找不到,就用系统级目录(需要 sudo): > ```bash > sudo cp scripts/imgcompress /usr/local/bin/imgcompress > sudo chmod +x /usr/local/bin/imgcompress > ``` #### Windows(用批处理命令,新建一个 `imgcompress.cmd`) Windows 没有可执行脚本的 shebang,做法是新建一个 `imgcompress.cmd` 批处理,让它调用 Node 运行脚本,再放进 PATH 目录。 ```bat @echo off rem 新建文件,把下面两行保存为 imgcompress.cmd node "%~dp0imgcompress" %* ``` 步骤: 1. 在仓库 `scripts` 目录里,新建一个文件 `imgcompress.cmd`,内容就是上面两行。 2. 打开"系统属性 → 环境变量"(Win + R 输入 `sysdm.cpl`,或右键"此电脑→属性→高级系统设置"),在"用户变量"的 `Path` 里**新增一个目录**,例如 `C:\Users\你的用户名\Tools`。 3. 把 `scripts/imgcompress` 和 `imgcompress.cmd` 都放进那个目录(例如 `C:\Users\你的用户名\Tools\`)。 4. 打开**新的**命令提示符 / PowerShell,验证: ```bat where imgcompress imgcompress --help ``` > 说明: > - 前提是系统已装好 Node.js(`node -v` 有版本号)。若 `node` 不是系统命令,用 Node 安装包安装时勾选"Add to PATH"即可。 > - 卸载时,删除对应目录里的 `imgcompress.cmd` 和 `imgcompress` 文件即可。 --- **跨平台小结**:无论是 `~/.local/bin`、`/usr/local/bin` 还是 Windows 的 `Tools` 目录,核心思路都一样——**把命令放进 PATH 里能找到的目录**,这样终端就能直接敲 `imgcompress`。 --- ## 使用 怎么用,取决于你选了哪种安装方式。**先看前提,再看对应用法**: | 你的安装方式 | 怎么用 | |-------------|--------| | 方式一 / 二 / 三(装进 CodeBuddy) | 在 CodeBuddy 里**直接对 AI 说话**(见下文 A) | | 方式四(系统命令) | 打开终端,**直接敲 `imgcompress` 命令**(见下文 B) | > 前提:无论哪种方式,都需要电脑上装好 **Node.js**(见上文"前置条件")。 ### A. 装进 CodeBuddy 的用户(方式一 / 二 / 三) 因为你已经把 skill 装进了 CodeBuddy,AI 才知道"压缩图片"这件事怎么做。这时直接对 AI 说: > "压缩这个目录" / "把这里的图片压缩一下" / "减小图片体积" AI 会自动执行:**先预览压缩效果 → 实际压缩 → 告诉你每个文件省了多少**。 **压缩单张图片**:如果只想压缩某一张图,直接把图片路径给 AI 就行,例如: > "压缩这张图片 `/Users/me/photo.png`" AI 会**只处理这一张**,不会扫描或压缩同目录里的其他图片。 > 注意:这种用法只有在你**把 skill 装进 CodeBuddy**(方式一二三)后才有。如果你走的是方式四,AI 不会"自动"去压缩,请用下面的命令行方式。 ### B. 使用系统命令的用户(方式四) 因为你把 `imgcompress` 装成了系统命令,所以不需要 CodeBuddy,直接在**任何目录**打开终端敲命令即可: ```bash # 压缩指定目录 imgcompress /path/to/images # 只压缩某一个图片文件(不影响同目录其他文件) imgcompress /path/to/photo.png # 预览压缩效果(不修改文件) imgcompress /path/to/images --dry # 压缩当前目录 imgcompress ``` > 给目录就批量处理目录里的所有图片;给单个图片路径就只压缩那一个文件——工具会自动判断。 > 想在 AI 里也用它?在 CodeBuddy 里可以同时安装方式四,AI 检测到系统有 `imgcompress` 命令后,也能直接帮你调用它压缩图片(见 FAQ Q8)。 ### 效果示例 **批量压缩一个目录:** ```bash $ imgcompress ./images --dry 目标: /your/path/images 找到 2 个图片文件 a.png 537 KB -> 158 KB (省 70%) b.jpg 192 KB -> 52 KB (省 72%) 总计: 729 KB -> 210 KB 节省 71.2% ``` **只压缩单个文件:** ```bash $ imgcompress ./images/logo.png --dry 目标: /your/path/images/logo.png 找到 1 个图片文件 logo.png 200 KB -> 60 KB (省 70%) ``` > 提示:`--dry` 只预览不修改文件;去掉 `--dry` 才会真正压缩替换。 **支持格式**:`.png`、`.jpg`、`.jpeg`(不处理子文件夹)。 **目标自动判断**:传**目录**就批量处理目录里所有图片;传**单个图片路径**就只压缩那一张——无需额外参数,工具自动识别。 --- ## 常见问题 FAQ **Q1:压缩后图片会变差或更占空间吗?** 不会。只在压缩后更小时才替换原文件,体积只减不增。 **Q2:会破坏原图吗?** 不会。压缩失败或没有变小的时候,原图会完整保留。 **Q3:需要自己安装什么吗?** 需要装 **Node.js**(≥14)。除此之外无需其他工具,首次使用时会自动下载压缩组件(只需一次)。 **Q4:可以只压缩一张图片吗?** 可以。直接给工具单个图片路径即可只压缩那一张(例如 `imgcompress /path/to/photo.png`),不会影响同目录的其他文件;给目录则批量处理整个目录。 **Q5:支持 GIF / WebP / SVG 吗?** 不支持。仅支持 `.png`、`.jpg`、`.jpeg`。 **Q6:会处理子文件夹里的图片吗?** 不会,只处理所选文件夹里的图片。 **Q7:方式四(系统命令)和 CodeBuddy skill 有什么区别?** 系统命令方式只装到终端,**不依赖 CodeBuddy**,在任何目录直接敲 `imgcompress` 就能用;但**仍依赖 Node.js**。CodeBuddy skill 方式则装进 CodeBuddy,之后直接对 AI 说"压缩图片"即可。 **Q8:我用了系统命令方式,还能让 AI 帮我压缩吗?** 可以。AI 在检测到系统里有 `imgcompress` 命令时,也能直接调用它帮你批量压缩图片。 --- ## License [MIT](./LICENSE)