跳至内容
Zipic 文档

与 AI / 命令行协作

Zipic 不止是 GUI 应用。通过 URL Scheme，你可以在终端脚本、CI 流水线，甚至 Claude Code 这类 AI Agent 中调用 Zipic 的全部压缩能力 —— 同时保留 100% 本地处理的隐私优势。

命令行使用

Zipic 没有传统意义上的 CLI 二进制，而是借助 macOS 自带的 open 命令将 URL Scheme 请求转交给 Zipic 应用。

一个最小示例 —— 将单张图片压缩为 WebP，等级 3：

终端窗口
open "zipic://compress?url=/path/to/image.png&level=3&format=webp"

整个模式就这么简单。在此基础上，你可以重复 url= 参数实现批处理、传入文件夹路径递归压缩、用 width/height 调整尺寸、用 directory 指定保存位置。

完整的参数表、批处理示例、快捷指令下载和 AppIntents 用法，详见 《集成 Zipic 能力》。

AI Agent Skill（一键安装）

Claude Code 以及其他支持 Agent Skills 的工具，都可以一条命令安装 Zipic Skill。安装后，你可以用自然语言跟 AI Agent 对话 —— “压缩这些截图”、“把这张 PNG 转成 WebP”、“把这些图缩到 1920 宽” —— Agent 会自动把意图翻译成正确的 URL Scheme 调用。

安装命令：

终端窗口
npx skills add okooo5km/Skills4U --skill zipic

Skill 主要能力

自动环境检测

运行前自动验证 macOS 与 Zipic 安装情况，未安装时友好引导（Homebrew、Mac App Store、官网三种方式）。

安全的路径处理

自动对路径中的空格和中文等非 ASCII 字符进行 URL 编码，批处理循环也无需手动转义，整文件夹直接喂入即可。

合理的默认值

日常压缩默认推荐 2–3 级；根据使用场景自动选择目标格式 —— Web 用 WebP/AVIF、Apple 生态用 HEIC、需要兼容性时回落到 JPEG。

Pro 功能识别

清楚哪些能力（刘海拖拽、剪贴板自动压缩、文件夹监控）需要 Pro，并在接近免费版 25 次/天 限额时主动提醒。

在对话中触发

安装完成后，你可以直接对 Agent 说：

  • “帮我压缩 ~/Downloads/screenshots/ 里的所有图片。”
  • “把这张 PNG 转成 WebP，准备发博客。”
  • “把这些产品图缩到 1920 宽，保存为 AVIF。”

Agent 会自行推断 level、format、width、url 等参数，并执行对应的 open 命令。

适用场景

  • 构建流水线 —— 在部署到 CDN 之前对静态资源做压缩。
  • 博客自动化 —— 截图触发脚本，自动产出 Web 友好的 WebP/AVIF。
  • 批量出图 —— 把文件夹拖给脚本，剩下的事不用管。
  • 编辑器 / IDE 集成 —— 把 Zipic 接入 VS Code 任务或你常用的 AI 编程助手。