@pz4l/tinyimg-cli

TinyPNG 图片压缩 CLI。

安装

npm i -g @pz4l/tinyimg-cli

或通过 npx 免安装使用：

npx @pz4l/tinyimg-cli src/assets/**

用法

全局选项

| 选项 | 别名 | 说明 | 默认值 | | --------------------------- | ---- | ------------------- | ------- | | -o, --output <dir> | — | 输出目录 | — | | -s, --strategy <strategy> | — | 压缩策略 | AUTO | | --no-cache | — | 禁用缓存 | false | | -k, --key <keys> | — | 逗号分隔的 API 密钥 | — | | -p, --parallel <number> | — | 并行限制 | 3 |

命令

默认命令（压缩）

tinyimg src/assets/**
tinyimg src/assets/** -o dist/images
tinyimg src/assets/** -s API_FIRST -k YOUR_API_KEY

tinyimg convert <paths>

将无透明通道的 PNG 转换为 JPG。

• --noRename — 保留原始 .png 扩展名（仅更改编码）

示例：

tinyimg convert src/assets/**
tinyimg convert src/assets/** --noRename

tinyimg keys <subcommand>

管理 API 密钥。

• tinyimg keys add <key> — 添加并验证 API 密钥（支持同时添加多个）
• tinyimg keys del <maskedKey> — 删除已保存的密钥
• tinyimg keys（无子命令）— 列出所有密钥

示例：

tinyimg keys add your_api_key
tinyimg keys add key1 key2 key3
tinyimg keys del xxxx...xxxx
tinyimg keys

tinyimg list <paths>（别名 ls）

列出图片文件及其元数据。

• --json — 以 JSON 格式输出
• --convert 或 -c — 仅显示可转换的 PNG

示例：

tinyimg list src/assets/**
tinyimg ls src/assets/** -c

压缩策略

• API_ONLY：始终使用 TinyPNG API。需要提供 API key。
• RANDOM：随机在 API 和 Web 端点之间选择。
• API_FIRST：优先使用 API；当 API key 无效或触发限流时回退到 Web 端点。
• AUTO：有 API key 时等同于 API_FIRST，否则等同于 RANDOM。

API 密钥设置

项目级密钥

CLI 启动时自动读取当前工作目录下的 .env 和 .env.local。

支持的变量名：TINYIMG_KEY、TINYIMG_KEYS、TINYPNG_KEY、TINYPNG_KEYS（以及任何带前缀的变体，如 VITE_TINYIMG_KEY — 按后缀匹配）。

.env.local 示例：

TINYIMG_KEY=your_api_key

用户级密钥

通过 tinyimg keys add <key> 存储在 ~/.tinyimg/keys.json 中。当没有项目级密钥时作为回退使用。

许可证

MIT