change-image-suffix 1.18.2

package/CHANGELOG.md

@@ -0,0 +1,22 @@
+# Changelog
+
+All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
+
+### [1.18.2](https://github.com/GuoSirius/change-image-suffix/compare/v1.18.1...v1.18.2) (2026-05-19)
+
+
+### Features
+
+* add npm publish config and github release with changelog ([105e113](https://github.com/GuoSirius/change-image-suffix/commit/105e113c6ecd03085560be99ce5236240b68fa17))
+
+
+### Bug Fixes
+
+* improve GitHub Actions workflow and standard-version integration ([01e1ce4](https://github.com/GuoSirius/change-image-suffix/commit/01e1ce4d1a8b8e56b120f162ab93e7f3a3311074))
+* remove deprecated husky script lines ([7261d48](https://github.com/GuoSirius/change-image-suffix/commit/7261d4874337105255beeca690d8b6013bc86f1c))
+* remove duplicate content in CHANGELOG.md ([db0f4b6](https://github.com/GuoSirius/change-image-suffix/commit/db0f4b6403935ed713e2df2d6d1029b1b17aabe4))
+* replace inquirer with enquirer for CommonJS compatibility ([6fe88a5](https://github.com/GuoSirius/change-image-suffix/commit/6fe88a51487cb92117e0c487592048b07804c89a))
+
+# Changelog
+
+All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 siriussupreme
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,302 @@
+# change-image-suffix
+
+🖼️ 批量转换图片格式的 CLI 工具，支持递归搜索、深度限制、Windows 右键菜单等功能。
+
+## 功能特性
+
+- 📁 支持指定目录或使用当前目录
+- 🔄 支持递归搜索子目录
+- 📏 支持递归深度限制
+- 🎯 支持指定源文件后缀（png, jpg, gif 等）
+- 🎨 支持多种目标格式（webp, jpg, png, avif, gif）
+- 📤 输出到 `output/` 子目录
+- 🔢 同名不同后缀文件自动编号（`_01`, `_02`）
+- 🖱️ Windows 右键菜单集成
+- ⚡ 基于 [sharp](https://sharp.pixel.glass/) 高性能图片处理
+
+---
+
+## 快速开始
+
+```bash
+# 安装
+npm install -g change-image-suffix
+
+# 基本用法（转换当前目录图片为 webp）
+cis
+
+# 指定目录
+cis -p ./images
+
+# 递归转换
+cis -r
+```
+
+---
+
+## 常用命令
+
+| 场景 | 命令 |
+|------|------|
+| 转换当前目录 → webp | `cis` |
+| 转换指定目录 → webp | `cis -p ./photos` |
+| 递归转换所有子目录 | `cis -r` |
+| 递归，限制深度 2 层 | `cis -r -d 2` |
+| 仅转换 png 和 jpg | `cis -e png,jpg` |
+| 转换为 jpg 格式 | `cis -t jpg` |
+| 转换为 avif（更小体积） | `cis -t avif` |
+| 单个文件转换 | `cis -f ./banner.png` |
+| 多文件批量转换 | `cis -f ./a.png ./b.jpg ./c.gif` |
+| 多选文件/目录混合 | `cis file1.png dir1 file2.jpg` |
+| 显示帮助 | `cis --help` |
+
+### Windows 右键菜单
+
+```bash
+# 注册右键菜单（只需执行一次）
+cis install-menu
+
+# 卸载右键菜单
+cis uninstall-menu
+```
+
+注册后，在文件夹或图片文件上**右键 → 悬停**即可看到格式子菜单：
+
+```
+🖼 转换图片 (cis)    ← 悬停展开
+  ├── 🌀 WebP       ← 默认
+  ├── 📷 JPG
+  ├── 🖼 PNG
+  ├── 📺 AVIF
+  ├── 🎞 GIF
+  ├── 📋 TIFF
+  ├── 🍎 HEIF
+  └── 📐 JPEG2000
+```
+
+**适用场景：**
+- 📁 文件夹空白处右键 → 转换该目录所有图片
+- 📁 文件夹图标上右键 → 转换该目录所有图片
+- 🖼 图片文件上右键 → 转换该单个图片
+- 🔢 支持多选文件/文件夹后右键
+- 🔀 支持文件和目录混合选择 → 自动识别并处理所有图片
+
+**注意：**
+- 非图片文件右键显示菜单但不会处理（静默跳过）
+- 混合选择时会获取所有选中项中的图片文件进行转换
+
+---
+
+## 命令行参数
+
+| 参数 | 说明 | 默认值 |
+|------|------|--------|
+| `-p, --path <dir>` | 指定工作目录 | 当前目录 |
+| `-r, --recursive` | 递归搜索子目录 | 否 |
+| `-d, --depth <n>` | 递归深度限制 | 无限制 |
+| `-e, --extensions` | 指定源后缀，逗号分隔 | png,jpg,jpeg,gif,bmp,tiff,webp |
+| `-t, --to <format>` | 目标格式 | webp |
+| `-f, --file <file>` | 指定单个文件转换 | - |
+| `-h, --help` | 显示帮助 | - |
+| `-v, --version` | 显示版本 | - |
+
+---
+
+## 文件命名规范
+
+转换后的文件输出到 **`output/`** 子目录下，命名规则如下：
+
+### 同名不同后缀 → 自动编号
+
+当源目录中存在同名但不同扩展名的文件时，按字母顺序编号：
+
+```
+源目录:  photo.png + photo.jpg + photo.gif
+输出:    output/photo_01.webp
+        output/photo_02.webp
+        output/photo_03.webp
+```
+
+### 不同名或不同文件 → 直接覆盖
+
+```
+源目录:  banner.png + logo.jpg
+输出:    output/banner.webp
+        output/logo.webp
+```
+
+### 同格式转换 → 直接覆盖
+
+```
+源目录:  photo.webp
+输出:    output/photo.webp  (直接覆盖，无双重后缀)
+```
+
+### 输出目录结构
+
+```
+📁 原目录/
+├── 📁 output/          ← 转换后的文件
+│   ├── photo.webp
+│   ├── banner.jpg
+│   └── photo_01.png
+├── photo.png
+├── banner.jpg
+└── logo.gif
+```
+
+---
+
+## 支持的格式
+
+| 类型 | 格式 |
+|------|------|
+| **输入** | png, jpg, jpeg, gif, bmp, tiff, webp, avif |
+| **输出** | webp, jpg, png, avif, gif, tiff, heif, jp2 |
+
+---
+
+## 使用示例
+
+### 示例 1：批量转换照片集
+
+```bash
+# 将 photos 目录下的所有图片递归转换为 webp
+cis -r -p ./photos -t webp
+```
+
+### 示例 2：压缩图片体积
+
+```bash
+# 将图片转换为 avif（体积更小，画质接近）
+cis -p ./screenshots -t avif
+```
+
+### 示例 3：仅处理 PNG 图片
+
+```bash
+# 只转换 png 格式，输出为 jpg
+cis -p ./icons -e png -t jpg
+```
+
+### 示例 4：限制递归深度
+
+```bash
+# 只递归 1 层子目录
+cis -r -d 1 -p ./project
+```
+
+### 示例 5：单文件转换
+
+```bash
+# 转换单个文件，指定输出格式
+cis -f ./avatar.png -t webp
+```
+
+### 示例 6：多选文件/目录批量转换
+
+```bash
+# 多选文件（空格分隔），每个文件的输出在其所在目录的 output/
+cis ./photo1.png ./photo2.jpg ./folder3
+
+# 多选多个目录
+cis ./images ./icons ./logos
+```
+
+> 💡 **多选时**：每个文件/目录的输出结果放在**各自所在目录的 `output/` 子目录**中，互不干扰。
+
+---
+
+## 安装与更新
+
+```bash
+# 安装
+npm install -g change-image-suffix
+
+# 更新
+npm update -g change-image-suffix
+```
+
+---
+
+## 开发
+
+```bash
+# 克隆项目
+git clone https://github.com/GuoSirius/change-image-suffix.git
+cd change-image-suffix
+
+# 安装依赖
+npm install
+
+# 编译 TypeScript
+npm run build
+
+# 链接到全局（开发时）
+npm link
+```
+
+### 提交规范
+
+项目使用 [Conventional Commits](https://www.conventionalcommits.org/) 规范，提交信息格式：
+
+```
+<type>(<scope>): <description>
+
+[optional body]
+
+[optional footer(s)]
+```
+
+**type 类型：**
+- `feat`: 新功能
+- `fix`: 修复bug
+- `docs`: 文档更新
+- `style`: 代码格式（不影响代码运行的变动）
+- `refactor`: 重构
+- `perf`: 性能优化
+- `test`: 测试相关
+- `chore`: 构建/工具类改动
+
+### 发布流程
+
+```bash
+# 执行一键发布脚本
+npm run release
+
+# 或指定版本类型
+npm run release:patch   # 修复bug
+npm run release:minor   # 新增功能  
+npm run release:major   # 重大变更
+```
+
+发布脚本会自动：
+1. 检测未提交文件并提示提交
+2. 交互式选择版本更新类型
+3. 更新版本号和 CHANGELOG.md
+4. 推送至远程仓库
+5. 发布到 npm
+
+---
+
+## 项目结构
+
+```
+├── .github/workflows/   # GitHub Actions 工作流
+│   └── release.yml      # 自动发布工作流
+├── .husky/              # Git 钩子
+│   └── commit-msg       # 提交信息校验钩子
+├── scripts/             # 脚本目录
+│   └── release.js       # 一键发布脚本
+├── src/                 # 源代码
+│   └── index.ts         # 主入口
+├── .commitlintrc.json   # commitlint 配置
+├── CHANGELOG.md         # 变更日志
+└── package.json         # 项目配置
+```
+
+---
+
+## License
+
+MIT

package/dist/index.js

@@ -0,0 +1,783 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const child_process_1 = require("child_process");
+const sharp_1 = __importDefault(require("sharp"));
+// 默认配置
+const DEFAULT_EXTENSIONS = ['png', 'jpg', 'jpeg', 'gif', 'bmp', 'tiff', 'webp'];
+const DEFAULT_TARGET_FORMAT = 'webp';
+// ─────────────────────────────────────────
+// 右键菜单管理（仅 Windows）
+// ─────────────────────────────────────────
+function requireWindows() {
+    if (os.platform() !== 'win32') {
+        console.error('❌ 右键菜单功能仅支持 Windows 系统');
+        process.exit(1);
+    }
+}
+/**
+ * 写注册表 key（调用 reg.exe，无需管理员权限写 HKCU）
+ */
+function regAdd(key, name, value, type = 'REG_SZ') {
+    const cmd = `reg add "${key}" /v "${name}" /t ${type} /d "${value}" /f`;
+    (0, child_process_1.execSync)(cmd, { stdio: 'ignore' });
+}
+function regAddDefault(key, value) {
+    const cmd = `reg add "${key}" /ve /d "${value}" /f`;
+    (0, child_process_1.execSync)(cmd, { stdio: 'ignore' });
+}
+function regDelete(key) {
+    try {
+        (0, child_process_1.execSync)(`reg delete "${key}" /f`, { stdio: 'ignore' });
+    }
+    catch {
+        // 忽略不存在的键
+    }
+}
+function installContextMenu() {
+    requireWindows();
+    // ── 查找 cis.cmd 和 node_modules 路径 ──
+    let cisCmd = '';
+    let nodeModulesDir = '';
+    try {
+        cisCmd = (0, child_process_1.execSync)('where cis.cmd', { encoding: 'utf8' }).trim().split('\n')[0].trim();
+        nodeModulesDir = path.dirname(cisCmd);
+    }
+    catch {
+        try {
+            cisCmd = (0, child_process_1.execSync)('where cis', { encoding: 'utf8' }).trim().split('\n')[0].trim();
+            nodeModulesDir = path.dirname(cisCmd);
+        }
+        catch {
+            console.error('❌ 找不到 cis 命令，请先执行 npm link 或 npm install -g change-image-suffix');
+            process.exit(1);
+        }
+    }
+    // ── 复制 ICO ──
+    const appDataDir = path.join(os.homedir(), 'AppData', 'Roaming', 'change-image-suffix');
+    if (!fs.existsSync(appDataDir)) {
+        fs.mkdirSync(appDataDir, { recursive: true });
+    }
+    const icoTarget = path.join(appDataDir, 'icon.ico');
+    const icoSource = path.join(__dirname, '..', 'assets', 'icon.ico');
+    if (fs.existsSync(icoSource)) {
+        fs.copyFileSync(icoSource, icoTarget);
+    }
+    const iconPath = fs.existsSync(icoTarget) ? icoTarget : cisCmd;
+    // ── 辅助脚本路径定义（需要在 batContent 之前，因为 bat 中引用了 ps1Path）──
+    const batPath = path.join(appDataDir, 'cis_file.bat');
+    const ps1Path = path.join(appDataDir, 'cis_getfiles.ps1');
+    // cis_getfiles.ps1: 通过 Shell.Application COM 获取 Explorer 选中文件
+    const cisGetfilesContent = `
+Add-Type -AssemblyName Microsoft.VisualBasic
+Add-Type -AssemblyName UIAutomationClient
+$files = @()
+try {
+    $shell = New-Object -ComObject Shell.Application
+    $windows = $shell.Windows()
+    foreach ($win in $windows) {
+        if ($win -and $win.FullName -like "*explorer.exe") {
+            $selected = $win.Document.SelectedItems()
+            foreach ($item in $selected) {
+                if ($item -and $item.Path) {
+                    $files += $item.Path
+                }
+            }
+        }
+    }
+} catch {}
+if ($files.Count -gt 0) {
+    $files | ForEach-Object { $_ }
+} else {
+    Write-Output "NO_FILES"
+}
+`;
+    fs.writeFileSync(ps1Path, cisGetfilesContent, 'utf8');
+    // ── bat 脚本：接收 Windows 传递的文件路径和格式参数 ──
+    // 根据 Windows ExtendedSubCommandsKey 机制：
+    // - 子命令的 command 参数（格式）在前
+    // - Windows 自动将父命令收到的文件路径追加在末尾
+    // - 最终执行: cmd /c "bat" "格式" "文件路径"
+    // 移除 AppliesTo 限制后，bat 需要过滤非图片文件
+    const batContent = `
+@echo off
+chcp 65001 >nul
+setlocal enabledelayedexpansion
+
+REM Get this script's directory (no trailing backslash)
+set "SCRIPT_DIR=%~dp0"
+set "SCRIPT_DIR=!SCRIPT_DIR:~0,-1!"
+
+REM Get cis.cmd path
+for /f "delims=" %%c in ('where cis.cmd 2^>nul') do set "CIS_CMD=%%c"
+
+REM Supported image extensions
+set "SUPPORTED_EXT=.png;.jpg;.jpeg;.gif;.bmp;.tiff;.tif;.webp;.avif"
+
+REM %1 = format (from subcommand), %2 = file path (from Windows)
+if "%~1"=="" (
+    echo Error: No format specified.
+    timeout /t 2 >nul
+    goto :done
+)
+set "format=%~1"
+
+REM Collect all image files
+set "fileList="
+
+REM Windows passes file path as %2. If multiple files selected, use PowerShell.
+REM Otherwise use direct argument.
+if "%~2"=="" (
+    REM Multi-file via PowerShell (with retries for reliability)
+    for /f "delims=" %%i in ('powershell -ExecutionPolicy Bypass -File "!SCRIPT_DIR!\\cis_getfiles.ps1"') do (
+        if not "%%i"=="NO_FILES" (
+            call :add_if_image "%%i"
+        )
+    )
+) else (
+    REM Single file or multiple via %2 (space-separated)
+    REM Split space-separated paths
+    for %%F in (%~2) do (
+        call :add_if_image "%%F"
+    )
+)
+
+REM Process all collected files - use start /b to avoid new window
+if not "!fileList!"=="" (
+    start "" /b cmd /c "!CIS_CMD! -t !format! !fileList!"
+)
+goto :done
+
+:add_if_image
+set "filePath=%~1"
+REM Skip if empty or NO_FILES
+if "!filePath!"=="" exit /b
+if "!filePath!"=="NO_FILES" exit /b
+
+REM Get file extension
+for %%E in ("!filePath!") do set "ext=%%~xE"
+if "!ext!"=="" exit /b
+
+REM Convert to lowercase
+set "ext_lower=!ext!"
+call set "ext_lower=%%ext_lower:A=a%%
+call set "ext_lower=%%ext_lower:B=b%%
+call set "ext_lower=%%ext_lower:C=c%%
+call set "ext_lower=%%ext_lower:D=d%%
+call set "ext_lower=%%ext_lower:E=e%%
+call set "ext_lower=%%ext_lower:F=f%%
+call set "ext_lower=%%ext_lower:G=g%%
+call set "ext_lower=%%ext_lower:H=h%%
+call set "ext_lower=%%ext_lower:I=i%%
+call set "ext_lower=%%ext_lower:J=j%%
+call set "ext_lower=%%ext_lower:K=k%%
+call set "ext_lower=%%ext_lower:L=l%%
+call set "ext_lower=%%ext_lower:M=m%%
+call set "ext_lower=%%ext_lower:N=n%%
+call set "ext_lower=%%ext_lower:O=o%%
+call set "ext_lower=%%ext_lower:P=p%%
+call set "ext_lower=%%ext_lower:Q=q%%
+call set "ext_lower=%%ext_lower:R=r%%
+call set "ext_lower=%%ext_lower:S=s%%
+call set "ext_lower=%%ext_lower:T=t%%
+call set "ext_lower=%%ext_lower:U=u%%
+call set "ext_lower=%%ext_lower:V=v%%
+call set "ext_lower=%%ext_lower:W=w%%
+call set "ext_lower=%%ext_lower:X=x%%
+call set "ext_lower=%%ext_lower:Y=y%%
+call set "ext_lower=%%ext_lower:Z=z%%"
+
+REM Check if extension is supported
+echo !SUPPORTED_EXT! | findstr /i /c:"!ext_lower!" >nul 2>&1
+if !errorlevel!==0 (
+    set "fileList=!fileList! -f "!filePath!""
+)
+exit /b
+
+:done
+endlocal
+exit
+
+exit
+
+exit
+
+exit
+
+`;
+    fs.writeFileSync(batPath, batContent, 'utf8');
+    // ── 格式列表（webp 排第一，其他按常见程度排序）──
+    const formats = [
+        { verb: 'webp', label: '🌀 WebP' },
+        { verb: 'jpg', label: '📷 JPG' },
+        { verb: 'png', label: '🖼 PNG' },
+        { verb: 'avif', label: '📺 AVIF' },
+        { verb: 'gif', label: '🎞 GIF' },
+        { verb: 'tiff', label: '📋 TIFF' },
+        { verb: 'heif', label: '🍎 HEIF' },
+        { verb: 'jp2', label: '📐 JPEG2000' },
+    ];
+    // ── 使用 ExtendedSubCommandsKey 方式（PowerShell 7 同款）──
+    // 主菜单项配置（每个菜单类型有独立的子菜单路径）
+    // 注意：文件右键和目录右键都使用 bat + PowerShell 获取选中文件
+    // 这样混合选择时也能处理所有选中项
+    const menuBases = [
+        { base: 'HKCU\\Software\\Classes\\Directory\\Background\\shell\\cis', subMenu: 'Directory\\ContextMenus\\cis', arg: '-p "%V"' },
+        { base: 'HKCU\\Software\\Classes\\Directory\\shell\\cis', subMenu: 'Directory\\ContextMenus\\cis_dir', useBat: true },
+        { base: 'HKCU\\Software\\Classes\\*\\shell\\cis', subMenu: 'Directory\\ContextMenus\\cis_file', useBat: true },
+    ];
+    // 1. 注册公共子菜单（每种菜单类型独立注册）
+    const REG_ROOT = 'HKCU\\Software\\Classes\\';
+    for (const menu of menuBases) {
+        for (const fmt of formats) {
+            const shellKey = `${REG_ROOT}${menu.subMenu}\\shell\\${fmt.verb}`;
+            let cmd;
+            if (menu.useBat) {
+                // 文件右键：子命令传递格式参数，Windows 自动追加文件路径
+                // 最终执行: cmd /c "bat" "格式" "文件路径"
+                cmd = `"${batPath}" ${fmt.verb}`;
+            }
+            else {
+                cmd = `"${cisCmd}" -t ${fmt.verb} ${menu.arg}`;
+            }
+            (0, child_process_1.execSync)(`reg add "${shellKey}" /ve /d "${fmt.label}" /f`, { stdio: 'ignore' });
+            (0, child_process_1.execSync)(`reg add "${shellKey}" /v Icon /d "${iconPath}" /f`, { stdio: 'ignore' });
+            // 直接调用 bat，不需要 cmd /c，Windows 会自动追加文件路径
+            (0, child_process_1.execSync)(`reg add "${shellKey}\\command" /ve /d "${cmd}" /f`, { stdio: 'ignore' });
+        }
+    }
+    // 2. 注册主菜单项（使用 ExtendedSubCommandsKey 关联各自的子菜单）
+    for (const menu of menuBases) {
+        (0, child_process_1.execSync)(`reg add "${menu.base}" /ve /d "🖼 转换图片 (cis)" /f`, { stdio: 'ignore' });
+        (0, child_process_1.execSync)(`reg add "${menu.base}" /v Icon /d "${iconPath}" /f`, { stdio: 'ignore' });
+        (0, child_process_1.execSync)(`reg add "${menu.base}" /v ExtendedSubCommandsKey /d "${menu.subMenu}" /f`, { stdio: 'ignore' });
+        // 使用 bat 的菜单（文件右键和目录右键）：设置 command 接收文件路径 %1
+        // Windows 会将父命令收到的 %1 自动传递给子命令
+        if (menu.useBat) {
+            (0, child_process_1.execSync)(`reg add "${menu.base}\\command" /ve /d "cmd /c echo %1 > nul" /f`, { stdio: 'ignore' });
+            // 注意：不添加 AppliesTo 限制，让菜单始终显示
+            // bat 脚本会检查文件扩展名，自动忽略非图片文件
+        }
+    }
+    console.log('✅ 右键菜单安装成功！');
+    console.log('   📁 文件夹空白处/图标右键 → 悬停展开格式子菜单');
+    console.log('   🖼  图片文件上右键       → 悬停展开格式子菜单');
+    console.log('   ⚠️  非图片文件右键       → 菜单显示但不处理');
+    console.log(`   📂 输出目录: <原目录>/output/`);
+    console.log('\n💡 提示：如需卸载，执行 cis uninstall-menu');
+}
+function uninstallContextMenu() {
+    requireWindows();
+    // 删除主菜单项
+    const mainKeys = [
+        'HKCU\\Software\\Classes\\Directory\\Background\\shell\\cis',
+        'HKCU\\Software\\Classes\\Directory\\shell\\cis',
+        'HKCU\\Software\\Classes\\*\\shell\\cis',
+    ];
+    for (const key of mainKeys) {
+        try {
+            (0, child_process_1.execSync)(`reg delete "${key}" /f`, { stdio: 'ignore' });
+        }
+        catch { /* ignore */ }
+    }
+    // 删除公共子菜单（三个：目录空白、目录图标、文件）
+    const subMenuRoots = [
+        'HKCU\\Software\\Classes\\Directory\\ContextMenus\\cis',
+        'HKCU\\Software\\Classes\\Directory\\ContextMenus\\cis_dir',
+        'HKCU\\Software\\Classes\\Directory\\ContextMenus\\cis_file',
+    ];
+    for (const root of subMenuRoots) {
+        try {
+            (0, child_process_1.execSync)(`reg delete "${root}" /f`, { stdio: 'ignore' });
+        }
+        catch { /* ignore */ }
+    }
+    // 删除批处理文件和 PowerShell 脚本
+    const appDataDir = path.join(os.homedir(), 'AppData', 'Roaming', 'change-image-suffix');
+    const batPath = path.join(appDataDir, 'cis_file.bat');
+    const ps1Path = path.join(appDataDir, 'cis_getfiles.ps1');
+    try {
+        fs.unlinkSync(batPath);
+    }
+    catch { /* ignore */ }
+    try {
+        fs.unlinkSync(ps1Path);
+    }
+    catch { /* ignore */ }
+    console.log('✅ 右键菜单已卸载');
+}
+// ─────────────────────────────────────────
+// 参数解析
+// ─────────────────────────────────────────
+function parseArgs() {
+    const args = process.argv.slice(2);
+    const options = {
+        directory: process.cwd(),
+        recursive: false,
+        maxDepth: Infinity,
+        extensions: [...DEFAULT_EXTENSIONS],
+        targetFormat: DEFAULT_TARGET_FORMAT,
+    };
+    // 用于分类收集的临时数组
+    let filesFromFlag = []; // -f 收集的文件
+    let dirsFromFlag = []; // -p 收集的目录
+    let positionalFiles = []; // 位置参数中的文件
+    let positionalDirs = []; // 位置参数中的目录
+    let i = 0;
+    while (i < args.length) {
+        const arg = args[i];
+        if (arg === '-r' || arg === '--recursive') {
+            options.recursive = true;
+            i++;
+            continue;
+        }
+        if (arg === '-d' || arg === '--depth') {
+            if (i + 1 < args.length) {
+                options.maxDepth = parseInt(args[++i], 10);
+                if (isNaN(options.maxDepth) || options.maxDepth < 1) {
+                    console.error('❌ 深度必须是正整数');
+                    process.exit(1);
+                }
+            }
+            i++;
+            continue;
+        }
+        if (arg === '-e' || arg === '--extensions') {
+            if (i + 1 < args.length) {
+                options.extensions = args[++i].split(',').map(e => e.trim().toLowerCase().replace(/^\./, ''));
+            }
+            i++;
+            continue;
+        }
+        if (arg === '-t' || arg === '--to') {
+            if (i + 1 < args.length) {
+                options.targetFormat = args[++i].trim().toLowerCase().replace(/^\./, '');
+            }
+            i++;
+            continue;
+        }
+        if (arg === '-h' || arg === '--help') {
+            printHelp();
+            process.exit(0);
+        }
+        if (arg === '-v' || arg === '--version') {
+            console.log('change-image-suffix v1.18.0');
+            process.exit(0);
+        }
+        if (arg === '-p' || arg === '--path') {
+            // 收集 -p 后的目录
+            const start = i + 1;
+            while (i + 1 < args.length && !args[i + 1].startsWith('-')) {
+                i++;
+                dirsFromFlag.push(path.resolve(args[i]));
+            }
+            // 如果 -p 后面没有参数，用当前目录
+            if (start > i) {
+                dirsFromFlag.push(path.resolve('.'));
+            }
+            i++;
+            continue;
+        }
+        if (arg === '-f' || arg === '--file') {
+            // 收集 -f 后的所有文件
+            while (i + 1 < args.length && !args[i + 1].startsWith('-')) {
+                i++;
+                filesFromFlag.push(path.resolve(args[i]));
+            }
+            i++;
+            continue;
+        }
+        if (!arg.startsWith('-')) {
+            // 位置参数：根据实际类型分类
+            const resolvedPath = path.resolve(arg);
+            if (fs.existsSync(resolvedPath)) {
+                if (fs.statSync(resolvedPath).isFile()) {
+                    positionalFiles.push(resolvedPath);
+                }
+                else {
+                    positionalDirs.push(resolvedPath);
+                }
+            }
+            else {
+                // 文件不存在但不是以 - 开头，当作文件收集（后续验证会报错）
+                positionalFiles.push(resolvedPath);
+            }
+            i++;
+            continue;
+        }
+        // 未知选项，跳过
+        i++;
+    }
+    // ─── 合并所有收集的内容 ───
+    // 合并文件：-f 收集的 + 位置参数中的文件
+    const allFiles = [...filesFromFlag, ...positionalFiles];
+    // 合并目录：-p 收集的 + 位置参数中的目录
+    const allDirs = [...dirsFromFlag, ...positionalDirs];
+    // ─── 确定最终模式 ───
+    // 情况1：只有文件（单文件/多文件模式）
+    if (allFiles.length > 0 && allDirs.length === 0) {
+        options.multiFiles = allFiles;
+        return options;
+    }
+    // 情况2：只有目录（单目录/多目录模式）
+    if (allDirs.length > 0 && allFiles.length === 0) {
+        if (allDirs.length === 1) {
+            options.directory = allDirs[0];
+        }
+        else {
+            options.multiPaths = allDirs;
+        }
+        return options;
+    }
+    // 情况3：文件和目录混合（混合模式）
+    if (allFiles.length > 0 && allDirs.length > 0) {
+        options.multiFiles = allFiles;
+        options.multiPaths = allDirs;
+        return options;
+    }
+    // 情况4：没有任何路径参数，使用当前目录
+    return options;
+}
+function printHelp() {
+    console.log(`
+🔄 change-image-suffix - 图片格式批量转换工具
+
+用法:
+  change-image-suffix [选项]
+  cis [选项]                     # 简写
+  cis install-menu               # 添加到 Windows 右键菜单
+  cis uninstall-menu             # 从 Windows 右键菜单移除
+
+选项:
+  -f, --file <file>       转换单个文件（右键文件时自动传入）
+  -p, --path <dir>        指定工作目录（默认: 当前目录）
+  -r, --recursive         递归搜索子目录
+  -d, --depth <n>         递归深度限制（需要 -r 选项）
+  -e, --extensions <ext>  指定要转换的后缀，逗号分隔（不含点号）
+  -t, --to <format>       转换到的目标格式（默认: webp）
+  -h, --help              显示帮助信息
+  -v, --version           显示版本信息
+
+示例:
+  cis                              # 转换当前目录的图片为 webp
+  cis -f ./photo.png               # 转换单个文件
+  cis -p ./images                  # 转换指定目录
+  cis -r                           # 递归转换当前目录
+  cis -r -d 2 -p ./images         # 递归转换，深度限制为2
+  cis -e png,jpg -t jpg           # png/jpg 转换为 jpg
+  cis install-menu                 # 注册 Windows 右键菜单
+`);
+}
+// ─────────────────────────────────────────
+// 图片处理
+// ─────────────────────────────────────────
+function getAllFiles(dir, extensions, recursive, currentDepth, maxDepth) {
+    const files = [];
+    try {
+        const entries = fs.readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(dir, entry.name);
+            if (entry.isDirectory() && recursive && currentDepth < maxDepth) {
+                files.push(...getAllFiles(fullPath, extensions, recursive, currentDepth + 1, maxDepth));
+            }
+            else if (entry.isFile()) {
+                const ext = path.extname(entry.name).slice(1).toLowerCase();
+                if (extensions.includes(ext)) {
+                    files.push(fullPath);
+                }
+            }
+        }
+    }
+    catch {
+        console.warn(`⚠️  无法读取目录: ${dir}`);
+    }
+    return files;
+}
+function getOutputPath(inputPath, targetFormat, allInputFiles) {
+    const dir = path.dirname(inputPath);
+    const ext = path.extname(inputPath);
+    const basename = path.basename(inputPath, ext);
+    const originalExt = ext.slice(1).toLowerCase();
+    const targetExt = targetFormat;
+    // 源格式与目标格式相同时，直接覆盖
+    let coreName = basename;
+    const outputDir = path.join(dir, 'output');
+    // 检查输入目录中是否有同名（不含扩展名）但不同后缀的文件
+    // 如 photo.png 和 photo.jpg 会被判定为同名冲突
+    const hasNameConflict = allInputFiles.some(f => {
+        if (f === inputPath)
+            return false;
+        const fDir = path.dirname(f);
+        const fExt = path.extname(f);
+        const fBasename = path.basename(f, fExt);
+        return fDir === dir && fBasename === basename && fExt.toLowerCase() !== ext.toLowerCase();
+    });
+    if (hasNameConflict) {
+        // 找所有同basename的文件的序号
+        const allBasenameMatches = allInputFiles.filter(f => {
+            if (f === inputPath)
+                return false;
+            const fDir = path.dirname(f);
+            const fExt = path.extname(f);
+            const fBasename = path.basename(f, fExt);
+            return fDir === dir && fBasename === basename;
+        });
+        // 当前文件在所有同名文件中的索引（从1开始）
+        const sortedMatches = [...allBasenameMatches, inputPath].sort();
+        const index = sortedMatches.indexOf(inputPath) + 1;
+        const padded = String(index).padStart(2, '0');
+        coreName = `${basename}_${padded}`;
+    }
+    const filename = `${coreName}.${targetExt}`;
+    return path.join(outputDir, filename);
+}
+async function convertImage(inputPath, targetFormat, allInputFiles) {
+    try {
+        const outputPath = getOutputPath(inputPath, targetFormat, allInputFiles);
+        // 确保 output 目录存在
+        const outputDir = path.dirname(outputPath);
+        if (!fs.existsSync(outputDir)) {
+            fs.mkdirSync(outputDir, { recursive: true });
+        }
+        const image = (0, sharp_1.default)(inputPath);
+        switch (targetFormat.toLowerCase()) {
+            case 'webp':
+                await image.webp({ quality: 85 }).toFile(outputPath);
+                break;
+            case 'jpg':
+            case 'jpeg':
+                await image.jpeg({ quality: 85 }).toFile(outputPath);
+                break;
+            case 'png':
+                await image.png({ quality: 85 }).toFile(outputPath);
+                break;
+            case 'gif':
+                await image.gif().toFile(outputPath);
+                break;
+            case 'tiff':
+            case 'tif':
+                await image.tiff({ quality: 85 }).toFile(outputPath);
+                break;
+            case 'avif':
+                await image.avif({ quality: 85 }).toFile(outputPath);
+                break;
+            default: await image.toFormat(targetFormat).toFile(outputPath);
+        }
+        return { success: true, outputPath };
+    }
+    catch (err) {
+        return {
+            success: false,
+            outputPath: inputPath,
+            error: err instanceof Error ? err.message : '未知错误'
+        };
+    }
+}
+// ─────────────────────────────────────────
+// 入口
+// ─────────────────────────────────────────
+async function main() {
+    const firstArg = process.argv[2];
+    // 子命令：右键菜单管理
+    if (firstArg === 'install-menu') {
+        installContextMenu();
+        return;
+    }
+    if (firstArg === 'uninstall-menu') {
+        uninstallContextMenu();
+        return;
+    }
+    console.log('\n🖼️  change-image-suffix - 图片格式批量转换工具\n');
+    const options = parseArgs();
+    // ─── 辅助函数：处理文件列表 ───
+    async function processFiles(files, title) {
+        console.log(`\n🖼️  change-image-suffix - ${title}\n`);
+        console.log(`🎯 目标格式: ${options.targetFormat}`);
+        console.log(`📦 待处理: ${files.length} 个文件\n`);
+        console.log('----------------------------------------\n');
+        const supportedExts = ['png', 'jpg', 'jpeg', 'gif', 'bmp', 'tiff', 'tif', 'webp', 'avif'];
+        let totalSuccess = 0;
+        let totalFail = 0;
+        for (const filePath of files) {
+            const ext = path.extname(filePath).slice(1).toLowerCase();
+            if (!supportedExts.includes(ext)) {
+                console.log(`  ⚠️  跳过（不支持格式）: ${filePath}`);
+                totalFail++;
+                continue;
+            }
+            console.log(`  📄 文件: ${filePath}`);
+            process.stdout.write(`     处理中: ${path.basename(filePath)} ... `);
+            const result = await convertImage(filePath, options.targetFormat, [filePath]);
+            if (result.success) {
+                console.log(`✅ -> ${path.relative(path.dirname(filePath), result.outputPath)}`);
+                totalSuccess++;
+            }
+            else {
+                console.log(`❌ 失败 (${result.error})`);
+                totalFail++;
+            }
+        }
+        return { success: totalSuccess, fail: totalFail };
+    }
+    // ─── 辅助函数：处理目录列表 ───
+    async function processDirs(dirs) {
+        console.log(`\n🎯 目标格式: ${options.targetFormat}`);
+        console.log(`📦 待处理: ${dirs.length} 个目录\n`);
+        console.log('----------------------------------------\n');
+        let totalSuccess = 0;
+        let totalFail = 0;
+        for (const inputPath of dirs) {
+            const stat = fs.existsSync(inputPath) ? fs.statSync(inputPath) : null;
+            if (!stat) {
+                console.log(`  ⚠️  跳过（不存在）: ${inputPath}`);
+                totalFail++;
+                continue;
+            }
+            if (stat.isFile()) {
+                const ext = path.extname(inputPath).slice(1).toLowerCase();
+                const supportedExts = ['png', 'jpg', 'jpeg', 'gif', 'bmp', 'tiff', 'tif', 'webp', 'avif'];
+                if (!supportedExts.includes(ext)) {
+                    console.log(`  ⚠️  跳过（不支持格式）: ${inputPath}`);
+                    totalFail++;
+                    continue;
+                }
+                console.log(`  📄 文件: ${inputPath}`);
+                process.stdout.write(`     处理中: ${path.basename(inputPath)} ... `);
+                const result = await convertImage(inputPath, options.targetFormat, [inputPath]);
+                if (result.success) {
+                    console.log(`✅ -> ${path.relative(path.dirname(inputPath), result.outputPath)}`);
+                    totalSuccess++;
+                }
+                else {
+                    console.log(`❌ 失败 (${result.error})`);
+                    totalFail++;
+                }
+            }
+            else {
+                const files = getAllFiles(inputPath, options.extensions, options.recursive, 0, options.maxDepth);
+                console.log(`  📁 目录: ${inputPath} (${files.length} 个文件)`);
+                if (files.length === 0) {
+                    console.log('     ✅ 没有找到图片文件');
+                    continue;
+                }
+                for (const file of files) {
+                    process.stdout.write(`     处理中: ${path.basename(file)} ... `);
+                    const result = await convertImage(file, options.targetFormat, files);
+                    if (result.success) {
+                        console.log(`✅`);
+                        totalSuccess++;
+                    }
+                    else {
+                        console.log(`❌ (${result.error})`);
+                        totalFail++;
+                    }
+                }
+            }
+        }
+        return { success: totalSuccess, fail: totalFail };
+    }
+    // ─── 混合模式：同时有文件和目录 ───
+    if (options.multiFiles && options.multiFiles.length > 0 && options.multiPaths && options.multiPaths.length > 0) {
+        console.log('\n🖼️  change-image-suffix - 混合模式（文件+目录）\n');
+        const fileResult = await processFiles(options.multiFiles, '图片转换工具');
+        console.log('\n');
+        const dirResult = await processDirs(options.multiPaths);
+        console.log('\n----------------------------------------');
+        console.log(`📊 转换完成！成功: ${fileResult.success + dirResult.success}, 失败: ${fileResult.fail + dirResult.fail}\n`);
+        return;
+    }
+    // ─── 单/多文件模式 ───
+    if (options.multiFiles && options.multiFiles.length > 0) {
+        const result = await processFiles(options.multiFiles, '图片转换工具');
+        console.log('\n----------------------------------------\n');
+        console.log(`📊 转换完成！成功: ${result.success}, 失败: ${result.fail}\n`);
+        return;
+    }
+    // ─── 多路径模式 ───
+    if (options.multiPaths) {
+        console.log(`\n🖼️  change-image-suffix - 批量转换工具\n`);
+        const result = await processDirs(options.multiPaths);
+        console.log('\n----------------------------------------');
+        console.log(`📊 转换完成！成功: ${result.success}, 失败: ${result.fail}\n`);
+        return;
+    }
+    // ─── 目录批量模式 ───
+    console.log(`📂 目录: ${options.directory}`);
+    console.log(`🔁 递归: ${options.recursive ? `是 (深度: ${options.maxDepth === Infinity ? '无限制' : options.maxDepth})` : '否'}`);
+    console.log(`📄 后缀: ${options.extensions.join(', ')}`);
+    console.log(`🎯 目标格式: ${options.targetFormat}`);
+    console.log('\n----------------------------------------\n');
+    const files = getAllFiles(options.directory, options.extensions, options.recursive, 0, options.maxDepth);
+    if (files.length === 0) {
+        console.log('✅ 没有找到需要转换的图片文件。');
+        return;
+    }
+    console.log(`📋 找到 ${files.length} 个文件，准备开始转换...\n`);
+    let successCount = 0;
+    let failCount = 0;
+    const results = [];
+    for (const file of files) {
+        const relativePath = path.relative(options.directory, file);
+        process.stdout.write(`  处理中: ${relativePath} ... `);
+        const result = await convertImage(file, options.targetFormat, files);
+        if (result.success) {
+            const outputRelativePath = path.relative(options.directory, result.outputPath);
+            console.log(`✅ -> ${outputRelativePath}`);
+            results.push({ input: file, output: result.outputPath, status: 'success' });
+            successCount++;
+        }
+        else {
+            console.log(`❌ 失败 (${result.error})`);
+            results.push({ input: file, output: '', status: 'fail' });
+            failCount++;
+        }
+    }
+    console.log('\n----------------------------------------');
+    console.log(`\n📊 转换完成！成功: ${successCount}, 失败: ${failCount}\n`);
+    if (failCount > 0) {
+        console.log('❌ 失败的文件:');
+        for (const r of results.filter(x => x.status === 'fail')) {
+            console.log(`   - ${r.input}`);
+        }
+    }
+}
+main().catch(console.error);

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "change-image-suffix",
+  "version": "1.18.2",
+  "description": "批量转换图片格式的CLI工具，支持递归搜索、深度限制、指定后缀、Windows右键菜单等功能",
+  "main": "dist/index.js",
+  "files": [
+    "dist/",
+    "assets/",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "bin": {
+    "change-image-suffix": "./dist/index.js",
+    "cis": "./dist/index.js"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "clean": "rimraf dist",
+    "build": "tsc",
+    "prepublishOnly": "npm run clean && npm run build",
+    "release": "node scripts/release.js",
+    "release:patch": "node scripts/release.js --patch",
+    "release:minor": "node scripts/release.js --minor",
+    "release:major": "node scripts/release.js --major",
+    "lint": "echo \"Linting not configured yet\"",
+    "lint:fix": "echo \"Linting fix not configured yet\"",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "cli",
+    "image",
+    "converter",
+    "webp",
+    "png",
+    "jpg",
+    "batch",
+    "sharp",
+    "context-menu"
+  ],
+  "author": "siriussupreme",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/GuoSirius/change-image-suffix.git"
+  },
+  "bugs": {
+    "url": "https://github.com/GuoSirius/change-image-suffix/issues"
+  },
+  "homepage": "https://github.com/GuoSirius/change-image-suffix#readme",
+  "dependencies": {
+    "sharp": "^0.33.2"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^21.0.1",
+    "@commitlint/config-conventional": "^21.0.1",
+    "@types/node": "^20.11.0",
+    "enquirer": "^2.4.1",
+    "husky": "^9.1.7",
+    "rimraf": "^6.1.3",
+    "standard-version": "^9.5.0",
+    "typescript": "^5.3.3"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  }
+}