mcpField
B
baoyu-compress-image

baoyu-compress-image

github.com/tentacle-pro创意与媒体441 次安装12 周前更新
代码仓库

关于 baoyu-compress-image

baoyu-compress-image 是使用本地可用引擎压缩图片的命令行技能，针对 Obsidian Creator Vault 调整，支持配置输出格式和质量，并可归档原图。

主要功能

  1. 01检测可用的压缩引擎
  2. 02选择 JPEG、WebP 或 PNG 格式
  3. 03设置压缩质量
  4. 04递归处理目录
  5. 05归档或保留原图

适用场景

  1. 01准备用于网页发布的图片
  2. 02将图片转换为 WebP
  3. 03批量压缩目录中的图片
  4. 04替换图片时归档原图

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/tentacle-pro/skills --skill baoyu-compress-image

安装后在 Claude Code 中输入/baoyu-compress-image确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

bun.lock
package.json
test-process.ts
scripts/
main.ts

详细介绍

baoyu-compress-image

使用系统上可用的最佳命令行工具（sips、cwebp、convert 或 sharp）自动压缩图像。

此工具专为 Obsidian Creator Vault 调整：

  • 快速，面向 Web：默认生成质量为 65 的 .jpg（非常适合大多数小于 1 MB 的平台限制）。
  • 保持知识库整洁：以默认模式（替换）运行时，不会在 Assets/ 中堆积 _original 文件，而是将未经修改的原始文件备份到 Archive/Original-Images/。
  • 依赖隔离：所有运行时均通过 bun 封装，并隔离在 .agents/skills 中。

安装与系统要求

此脚本会自动检测你的操作系统，并按以下顺序使用能找到的速度最快、质量最高的图像引擎：

  1. macOS sips（内置，强烈推荐）
    macOS 原生自带 sips。无需安装。
    （底层执行：sips -s format jpeg -s formatOptions 65 <input> --out <output>）

  2. cwebp（最适用于 WebP 输出）

    • macOS：brew install webp
    • Ubuntu/Debian：sudo apt install webp

  3. ImageMagick（convert）

    • macOS：brew install imagemagick
    • Linux：sudo apt install imagemagick

  4. sharp（适用于 Windows / 非原生环境的 Node.js 备用方案）
    运行本地 bun install 命令时会自动安装。sharp 引擎通过 libvips 处理压缩，无需外部二进制文件。

首次设置（TS 环境）：

cd .agents/skills/baoyu-compress-image
bun install

用法

在知识库根目录中使用 bun 运行脚本。

bun .agents/skills/baoyu-compress-image/scripts/main.ts <input> [options]
选项
选项简写说明默认值
<input>输入目标（文件或目录）必填
--output-o指定输出文件路径与输入文件位于同一目录
--format-f输出格式（jpeg、webp、png）jpeg
--quality-q质量级别 0-10065
--keep-k将原始文件保留在原处（不归档）false
--recursive-r递归处理目录false

示例与工作流

1. 压缩生成的 AI 图像以供发布（默认）

bun .agents/skills/baoyu-compress-image/scripts/main.ts Assets/cover-draft.png

效果：创建 Assets/cover-draft.jpg，并将 cover-draft.png 安全移出，存放到 Archive/Original-Images/。

2. 压缩图像并保留 WebP 格式

bun .agents/skills/baoyu-compress-image/scripts/main.ts Assets/screenshot.png -f webp

3. 手动测试不同质量并将原始文件保留在原处

bun .agents/skills/baoyu-compress-image/scripts/main.ts Assets/photo.png -q 80 --keep

4. 批量压缩整个目录

bun .agents/skills/baoyu-compress-image/scripts/main.ts "00 Inbox/" -r

评论

支持 Markdown