最新动态

🎉新功能

• 通过 `format` 输出 AVIF: `convert_images` 新增 `format: "webp" | "avif"` 参数（默认 `"webp"`）。传入 `"avif"` 即可输出 `.avif` 同名文件，编码更慢但在同等感知质量下通常更小。
• 可选 SHA-256 清单输出: 在 `convert_images` 中传入 `manifest_path`，服务器会为每一条成功转换写入包含 SHA-256 指纹的 JSON 清单文件。响应中还会附带 `manifest: { path, entries, generated_at }` 摘要，适合 CI 流水线和审计场景。
• 与 CLI 共享跨工具限频状态: MCP 服务器和 CLI 现在共用同一份磁盘上的 `usage.json` 滚动窗口计数器，Free 套餐用户在 CLI 和 MCP 之间交替调用时，限频会跨工具统一生效，而不是各自独立计数。

✨改进

• Free 套餐截断时返回 `skipped_by_limit`: 当 Free 套餐下的 `convert_images` 请求超过 20 个文件上限时，响应依然为 `success: true`，并新增 `skipped_by_limit` 字段说明被截断的文件数量，同时附带 `upgrade_url`，方便 Agent 清晰地告知截断情况而不是让任务失败。

• 结构化 `error` 字段（破坏性变更）: `error` 字段从字符串改为对象：`{ code, message, context? }`。`code` 来自共享的 `ErrorCode` 枚举，为稳定标识（如 `rate_limited`、`input_not_found`、`io_error`）；`context` 携带对应的细节（如限频场景的 `delay_seconds` 和 `recent_calls`）。原本写 `error === "rate_limited"` 的调用方需要迁移为 `error?.code === "rate_limited"`。

🐛错误修复

• 不存在的输入和 I/O 错误现在返回结构化错误: 之前输入路径不存在或文件系统出错时，原始异常会直接传回 MCP 客户端。现在会统一映射为 `error.code: "input_not_found"` 或 `error.code: "io_error"`，并附带可读的 `message`，Agent 可以直接按 code 分支处理，无需解析栈信息。
• 过期 Pro 许可证正确回退到 Free 限制: 此前 Pro 许可证过期后仍然沿用 Pro 层级的限制，现已修复：过期后会正确回退到 Free 层级的限制和限频策略。`get_status` 依然会返回原始许可证类型，方便客户端区分"从未付费"与"曾付费但已过期"。

🎉新功能

• 通过 `--format` 输出 AVIF: 使用 `getwebp convert --format avif` 可输出 `.avif` 文件而不是 `.webp`。默认输出格式仍然是 WebP，因此现有调用方式不会改变。

✨改进

• JSON 结果新增绝对路径 `outputPath`: 每条成功的 `convert.completed` 结果现在都会包含绝对路径 `outputPath`，方便自动化流程、MCP 集成和下游工具准确定位生成文件。
• 更安全的 AVIF 质量回退: 当输出格式为 AVIF 且未显式传入 `--quality` 时，CLI 现在会明确提示，并回退到 `quality=55`，不再误导用户以为可以使用 WebP 的自动质量策略。

🐛错误修复

• 修复 WordPress 队列的 NDJSON 解析问题: 修复了一个关键集成问题：WordPress 插件此前直接对整段 NDJSON 输出执行 `json_decode()`，导致后台 CLI 转换任务静默失败，而不是读取最后一条 `convert.completed` 事件。

🎉新功能

• 结构化 JSON 输出（NDJSON）: 在任意命令中加上 `--json`，即可获得换行分隔的 JSON 输出，每条事件都包含统一的 `type`、`@level` 和 `data` 字段，方便脚本和 CI 流水线集成。
• 全局 flags 统一生效: `--json`、`--quiet`、`--verbose`、`--debug`、`--force` 现已在所有子命令中统一生效，不再受限于单个命令。
• HTTP/HTTPS 代理支持: 通过 `HTTP_PROXY`、`HTTPS_PROXY` 或 `NO_PROXY` 环境变量，将 API 请求路由到企业或本地代理。`GETWEBP_API_URL` 替换了旧版 `API_BASE_URL`。

✨改进

• 规范化退出码: 退出码现已统一并有文档记录：`0` 成功，`1` 一般错误，`2` 用法错误，`3` 授权错误，`4` 配额错误，Shell 脚本可按错误类型可靠分支处理。
• 原子化配置写入: 配置文件现在通过锁文件进行原子化写入，防止多进程同时运行时出现数据损坏。

🐛错误修复

• 登出安全加固: 登出操作现在会从磁盘重新读取配置来验证令牌已删除，防止内存缓存仍持有旧令牌的极端竞态问题。

🎉新功能

• Watch 模式 — 正式稳定版: `getwebp convert --watch` 现已达到生产可用状态，实时自动转换新增和修改的图片，支持路径级合并去重，避免快速保存时的重复处理。
• 回填模式（`--backfill`）: 使用 `--backfill` 启动 watch，先转换所有已存在的未转换图片，再切换为实时监听，非常适合增量迁移大型目录。
• 遵循 .gitignore 的忽略规则: Watch 模式自动遵循 `.gitignore` 规则，版本控制中已排除的文件同样会被跳过转换。

✨改进

• 错误恢复与去重: 瞬时错误（磁盘满、临时故障）会按退避策略重试，同一文件的重复报错会合并去重，终端输出保持可读。

🐛错误修复

• 修复授权套餐识别问题: 修复了部分已激活许可证未能正确识别为 Pro 的问题，导致 Pro 功能无法使用。

🎉新功能

• 自动质量（SSIM）: 自动为每张图片寻找最佳 WebP 质量，无需手动猜测 — 每张图片都能在保持视觉质量的前提下获得最小文件。可用 `--no-auto-quality` 关闭。
• 支持 HEIC 和 AVIF 输入: 现在可以直接将 HEIC（iPhone 照片）和 AVIF 图片作为输入，转换为 WebP。
• 体积保护: WebP 输出永远不会比原文件更大。如果转换后体积反而增加，则保留原文件并仅去除元数据。

✨改进

• 零原生依赖: 不再有原生编译问题 — 任何平台都能瞬间安装，零系统依赖。

🎉新功能

• CLI 正式发布: 通过 `npx getwebp@latest` 安装，在命令行中转换图片，支持 WebP、AVIF、PNG 输出格式。
• 批量和 Glob 处理: 转换整个目录或使用 glob 模式，一条命令处理数百张图片。
• 监听模式: 使用 `--watch` 模式自动转换目录中新增或修改的图片，非常适合开发工作流。
• 质量与尺寸控制: 通过 `--quality` 和 `--width`/`--height` 参数精细控制输出质量和图片尺寸。
• 离线且隐私安全: 所有处理均在本地完成，图片不会上传到任何地方，文件隐私完全得到保护。

🎉新功能

• 上架 Chrome 应用商店: GetWebP 正式在 Chrome 应用商店公开上线，一键安装，立即使用。
• 本地 WebP 转换: 直接在浏览器内将 PNG / JPG 转换为 WebP，文件全程不离开本地，完全保护隐私。
• 批量处理: 一次性选中多张图片批量转换，告别重复劳动。
• 右键快捷转换: 在任意网页上右键单击图片，无需打开扩展弹窗，即可一键转为 WebP。
• 质量可调: 自由调节输出质量，在文件体积与画质之间找到最佳平衡。