change-image-suffix 2.1.3 → 2.1.4

package/CHANGELOG.md

@@ -2,6 +2,23 @@
 
 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.
 
+### [2.1.4](https://github.com/GuoSirius/change-image-suffix/compare/v2.1.3...v2.1.4) (2026-05-23)
+
+
+### Bug Fixes
+
+* output to <format>/ dir, command injection, recursive nesting, and other issues ([32da38a](https://github.com/GuoSirius/change-image-suffix/commit/32da38aef36a7d736e91e0375573a905d565d864))
+
+
+### Chores
+
+* update local settings permissions ([1a86130](https://github.com/GuoSirius/change-image-suffix/commit/1a86130de6005348d6ba8aaba26500d7688be996))
+
+
+### Documentation
+
+* update README output convention, add .claude/ commit policy memory ([b689bc6](https://github.com/GuoSirius/change-image-suffix/commit/b689bc60ed397eb826954e289c3f89488bd97449))
+
 ### [2.1.3](https://github.com/GuoSirius/change-image-suffix/compare/v2.1.2...v2.1.3) (2026-05-21)
 
 

package/README.md

@@ -9,7 +9,7 @@
 - 📏 支持递归深度限制
 - 🎯 支持指定源文件后缀（png, jpg, gif 等）
 - 🎨 支持多种目标格式（webp, jpg, png, avif, tiff）
-- 📤 输出到 `output/` 子目录
+- 📤 输出到 `<目标格式>/` 子目录（如 `webp/`, `jpg/`）
 - 🔢 同名不同后缀文件自动编号（`_01`, `_02`）
 - 🖱️ Windows 右键菜单集成
 - ⚡ 基于 [sharp](https://sharp.pixel.glass/) 高性能图片处理
@@ -101,7 +101,7 @@ cis uninstall-menu
 
 ## 文件命名规范
 
-转换后的文件输出到 **`output/`** 子目录下，命名规则如下：
+转换后的文件输出到 **`<目标格式>/`** 子目录下（例如转换为 webp 则输出到 `webp/`，转换为 jpg 则输出到 `jpg/`），命名规则如下：
 
 ### 同名不同后缀 → 自动编号
 
@@ -109,34 +109,36 @@ cis uninstall-menu
 
 ```
 源目录:  photo.png + photo.jpg + photo.gif
-输出:    output/photo_01.webp
-        output/photo_02.webp
-        output/photo_03.webp
+输出:    webp/photo_01.webp
+        webp/photo_02.webp
+        webp/photo_03.webp
 ```
 
 ### 不同名或不同文件 → 直接覆盖
 
 ```
 源目录:  banner.png + logo.jpg
-输出:    output/banner.webp
-        output/logo.webp
+输出:    webp/banner.webp
+        webp/logo.webp
 ```
 
 ### 同格式转换 → 直接覆盖
 
 ```
 源目录:  photo.webp
-输出:    output/photo.webp  (直接覆盖，无双重后缀)
+输出:    webp/photo.webp  (直接复制，无双重后缀)
 ```
 
 ### 输出目录结构
 
 ```
 📁 原目录/
-├── 📁 output/          ← 转换后的文件
+├── 📁 webp/             ← 转换后的 webp 文件
 │   ├── photo.webp
-│   ├── banner.jpg
-│   └── photo_01.png
+│   ├── banner.webp
+│   └── photo_01.webp
+├── 📁 jpg/              ← 转换后的 jpg 文件
+│   └── ...
 ├── photo.png
 ├── banner.jpg
 └── logo.gif
@@ -193,14 +195,14 @@ cis -f ./avatar.png -t webp
 ### 示例 6：多选文件/目录批量转换
 
 ```bash
-# 多选文件（空格分隔），每个文件的输出在其所在目录的 output/
+# 多选文件（空格分隔），每个文件的输出在其所在目录的 <目标格式>/
 cis ./photo1.png ./photo2.jpg ./folder3
 
 # 多选多个目录
 cis ./images ./icons ./logos
 ```
 
-> 💡 **多选时**：每个文件/目录的输出结果放在**各自所在目录的 `output/` 子目录**中，互不干扰。
+> 💡 **多选时**：每个文件/目录的输出结果放在**各自所在目录的 `<目标格式>/` 子目录**中（如 `webp/`, `jpg/`），互不干扰。
 
 ---
 

package/dist/index.js

@@ -203,7 +203,7 @@ endlocal
     console.log('   📁 文件夹空白处/图标右键 → 悬停展开格式子菜单');
     console.log('   🖼  图片文件上右键       → 悬停展开格式子菜单');
     console.log('   ⚠️  非图片文件右键       → 菜单显示但不处理');
-    console.log(`   📂 输出目录: <原目录>/output/`);
+    console.log(`   📂 输出目录: <原目录>/<目标格式>/`);
     console.log('\n💡 提示：如需卸载，执行 cis uninstall-menu');
 }
 function uninstallContextMenu() {
@@ -232,18 +232,28 @@ function uninstallContextMenu() {
         }
         catch { /* ignore */ }
     }
-    // 删除批处理文件和版本标记
+    // 删除批处理文件、图标和版本标记
     const appDataDir = path.join(os.homedir(), 'AppData', 'Roaming', 'change-image-suffix');
     const batPath = path.join(appDataDir, 'cis_file.bat');
     try {
         fs.unlinkSync(batPath);
     }
     catch { /* ignore */ }
+    const iconPath = path.join(appDataDir, 'icon.ico');
+    try {
+        fs.unlinkSync(iconPath);
+    }
+    catch { /* ignore */ }
     const versionFile = path.join(appDataDir, 'version.json');
     try {
         fs.unlinkSync(versionFile);
     }
     catch { /* ignore */ }
+    // 尝试删除目录（仅当为空时），失败也不影响
+    try {
+        fs.rmdirSync(appDataDir);
+    }
+    catch { /* ignore */ }
     console.log('✅ 右键菜单已卸载');
 }
 // 自动检测版本变化并更新右键菜单（解决 npm update 不触发 postinstall 的问题）
@@ -252,20 +262,23 @@ function autoUpdateContextMenu() {
         return;
     const appDataDir = path.join(os.homedir(), 'AppData', 'Roaming', 'change-image-suffix');
     const versionFile = path.join(appDataDir, 'version.json');
+    // 如果从未安装过右键菜单，跳过自动更新（postinstall 负责首次安装）
+    if (!fs.existsSync(versionFile))
+        return;
     const pkg = JSON.parse(fs.readFileSync(path.join(__dirname, '..', 'package.json'), 'utf8'));
     const currentVersion = pkg.version;
     let installedVersion = '';
     try {
-        if (fs.existsSync(versionFile)) {
-            installedVersion = JSON.parse(fs.readFileSync(versionFile, 'utf8')).version || '';
-        }
+        installedVersion = JSON.parse(fs.readFileSync(versionFile, 'utf8')).version || '';
     }
     catch { /* ignore */ }
     if (installedVersion !== currentVersion) {
         try {
             installContextMenu();
         }
-        catch { /* menu update failed silently, will retry next invocation */ }
+        catch {
+            console.warn('⚠️  右键菜单自动更新失败，请手动执行 cis install-menu');
+        }
     }
 }
 // ─────────────────────────────────────────
@@ -294,27 +307,40 @@ function parseArgs() {
             continue;
         }
         if (arg === '-d' || arg === '--depth') {
-            if (i + 1 < args.length) {
-                options.maxDepth = parseInt(args[++i], 10);
-                if (isNaN(options.maxDepth) || options.maxDepth < 1) {
+            if (i + 1 < args.length && !args[i + 1].startsWith('-')) {
+                const val = parseInt(args[++i], 10);
+                if (isNaN(val) || val < 1) {
                     console.error('❌ 深度必须是正整数');
                     process.exit(1);
                 }
+                options.maxDepth = val;
+            }
+            else {
+                console.error('❌ -d/--depth 需要指定一个正整数参数');
+                process.exit(1);
             }
             i++;
             continue;
         }
         if (arg === '-e' || arg === '--extensions') {
-            if (i + 1 < args.length) {
+            if (i + 1 < args.length && !args[i + 1].startsWith('-')) {
                 options.extensions = args[++i].split(',').map(e => e.trim().toLowerCase().replace(/^\./, ''));
             }
+            else {
+                console.error('❌ -e/--extensions 需要指定后缀参数');
+                process.exit(1);
+            }
             i++;
             continue;
         }
         if (arg === '-t' || arg === '--to') {
-            if (i + 1 < args.length) {
+            if (i + 1 < args.length && !args[i + 1].startsWith('-')) {
                 options.targetFormat = args[++i].trim().toLowerCase().replace(/^\./, '');
             }
+            else {
+                console.error('❌ -t/--to 需要指定目标格式');
+                process.exit(1);
+            }
             i++;
             continue;
         }
@@ -343,10 +369,15 @@ function parseArgs() {
         }
         if (arg === '-f' || arg === '--file') {
             // 收集 -f 后的所有文件
+            const start = i + 1;
             while (i + 1 < args.length && !args[i + 1].startsWith('-')) {
                 i++;
                 filesFromFlag.push(path.resolve(args[i]));
             }
+            if (start > i) {
+                console.error('❌ -f/--file 需要指定至少一个文件路径');
+                process.exit(1);
+            }
             i++;
             continue;
         }
@@ -434,14 +465,16 @@ function printHelp() {
 // ─────────────────────────────────────────
 // 图片处理
 // ─────────────────────────────────────────
-function getAllFiles(dir, extensions, recursive, currentDepth, maxDepth) {
+function getAllFiles(dir, extensions, recursive, currentDepth, maxDepth, excludeDirName) {
     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));
+                if (excludeDirName && entry.name === excludeDirName)
+                    continue;
+                files.push(...getAllFiles(fullPath, extensions, recursive, currentDepth + 1, maxDepth, excludeDirName));
             }
             else if (entry.isFile()) {
                 const ext = path.extname(entry.name).slice(1).toLowerCase();
@@ -462,7 +495,7 @@ function getOutputPath(inputPath, targetFormat, allInputFiles) {
     const basename = path.basename(inputPath, ext);
     const targetExt = targetFormat;
     let coreName = basename;
-    const outputDir = path.join(dir, 'output');
+    const outputDir = path.join(dir, targetFormat);
     // 检查输入目录中是否有同名（不含扩展名）但不同后缀的文件
     // 如 photo.png 和 photo.jpg 会被判定为同名冲突
     const hasNameConflict = allInputFiles.some(f => {
@@ -471,7 +504,7 @@ function getOutputPath(inputPath, targetFormat, allInputFiles) {
         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();
+        return fDir === dir && fBasename.toLowerCase() === basename.toLowerCase() && fExt.toLowerCase() !== ext.toLowerCase();
     });
     if (hasNameConflict) {
         // 找所有同basename的文件的序号
@@ -481,7 +514,7 @@ function getOutputPath(inputPath, targetFormat, allInputFiles) {
             const fDir = path.dirname(f);
             const fExt = path.extname(f);
             const fBasename = path.basename(f, fExt);
-            return fDir === dir && fBasename === basename;
+            return fDir === dir && fBasename.toLowerCase() === basename.toLowerCase();
         });
         // 当前文件在所有同名文件中的索引（从1开始）
         const sortedMatches = [...allBasenameMatches, inputPath].sort();
@@ -493,22 +526,23 @@ function getOutputPath(inputPath, targetFormat, allInputFiles) {
     return path.join(outputDir, filename);
 }
 async function convertImage(inputPath, targetFormat, allInputFiles) {
+    const outputPath = getOutputPath(inputPath, targetFormat, allInputFiles);
+    const srcExt = path.extname(inputPath).slice(1).toLowerCase();
+    const fmt = targetFormat.toLowerCase();
+    // 先验证格式，避免在无效路径上创建目录
+    if (!SUPPORTED_OUTPUT_FORMATS.includes(fmt)) {
+        return { success: false, outputPath, error: `不支持的目标格式: ${targetFormat}，支持: ${SUPPORTED_OUTPUT_FORMATS.join(', ')}` };
+    }
     try {
-        const outputPath = getOutputPath(inputPath, targetFormat, allInputFiles);
         const outputDir = path.dirname(outputPath);
         if (!fs.existsSync(outputDir)) {
             fs.mkdirSync(outputDir, { recursive: true });
         }
-        const srcExt = path.extname(inputPath).slice(1).toLowerCase();
-        const fmt = targetFormat.toLowerCase();
         // 同格式直接复制，避免重新编码导致质量损失
         if (srcExt === fmt || (srcExt === 'jpeg' && fmt === 'jpg') || (srcExt === 'jpg' && fmt === 'jpeg') || (srcExt === 'tif' && fmt === 'tiff') || (srcExt === 'tiff' && fmt === 'tif')) {
             fs.copyFileSync(inputPath, outputPath);
             return { success: true, outputPath };
         }
-        if (!SUPPORTED_OUTPUT_FORMATS.includes(fmt)) {
-            return { success: false, outputPath: inputPath, error: `不支持的目标格式: ${targetFormat}，支持: ${SUPPORTED_OUTPUT_FORMATS.join(', ')}` };
-        }
         const image = (0, sharp_1.default)(inputPath);
         switch (fmt) {
             case 'webp':
@@ -534,7 +568,7 @@ async function convertImage(inputPath, targetFormat, allInputFiles) {
     catch (err) {
         return {
             success: false,
-            outputPath: inputPath,
+            outputPath,
             error: err instanceof Error ? err.message : '未知错误'
         };
     }
@@ -565,16 +599,18 @@ async function main() {
         console.log('----------------------------------------\n');
         let totalSuccess = 0;
         let totalFail = 0;
+        const failures = [];
         for (const filePath of files) {
             const ext = path.extname(filePath).slice(1).toLowerCase();
             if (!SUPPORTED_INPUT_EXTENSIONS.includes(ext)) {
                 console.log(`  ⚠️  跳过（不支持格式）: ${filePath}`);
                 totalFail++;
+                failures.push(filePath);
                 continue;
             }
             console.log(`  📄 文件: ${filePath}`);
             process.stdout.write(`     处理中: ${path.basename(filePath)} ... `);
-            const result = await convertImage(filePath, options.targetFormat, [filePath]);
+            const result = await convertImage(filePath, options.targetFormat, files);
             if (result.success) {
                 console.log(`✅ -> ${path.relative(path.dirname(filePath), result.outputPath)}`);
                 totalSuccess++;
@@ -582,6 +618,13 @@ async function main() {
             else {
                 console.log(`❌ 失败 (${result.error})`);
                 totalFail++;
+                failures.push(filePath);
+            }
+        }
+        if (failures.length > 0) {
+            console.log('\n❌ 失败的文件:');
+            for (const f of failures) {
+                console.log(`   - ${f}`);
             }
         }
         return { success: totalSuccess, fail: totalFail };
@@ -593,11 +636,13 @@ async function main() {
         console.log('----------------------------------------\n');
         let totalSuccess = 0;
         let totalFail = 0;
+        const failures = [];
         for (const inputPath of dirs) {
             const stat = fs.existsSync(inputPath) ? fs.statSync(inputPath) : null;
             if (!stat) {
                 console.log(`  ⚠️  跳过（不存在）: ${inputPath}`);
                 totalFail++;
+                failures.push(inputPath);
                 continue;
             }
             if (stat.isFile()) {
@@ -605,11 +650,12 @@ async function main() {
                 if (!SUPPORTED_INPUT_EXTENSIONS.includes(ext)) {
                     console.log(`  ⚠️  跳过（不支持格式）: ${inputPath}`);
                     totalFail++;
+                    failures.push(inputPath);
                     continue;
                 }
                 console.log(`  📄 文件: ${inputPath}`);
                 process.stdout.write(`     处理中: ${path.basename(inputPath)} ... `);
-                const result = await convertImage(inputPath, options.targetFormat, [inputPath]);
+                const result = await convertImage(inputPath, options.targetFormat, dirs);
                 if (result.success) {
                     console.log(`✅ -> ${path.relative(path.dirname(inputPath), result.outputPath)}`);
                     totalSuccess++;
@@ -617,10 +663,11 @@ async function main() {
                 else {
                     console.log(`❌ 失败 (${result.error})`);
                     totalFail++;
+                    failures.push(inputPath);
                 }
             }
             else {
-                const files = getAllFiles(inputPath, options.extensions, options.recursive, 0, options.maxDepth);
+                const files = getAllFiles(inputPath, options.extensions, options.recursive, 0, options.maxDepth, options.targetFormat);
                 console.log(`  📁 目录: ${inputPath} (${files.length} 个文件)`);
                 if (files.length === 0) {
                     console.log('     ✅ 没有找到图片文件');
@@ -636,10 +683,17 @@ async function main() {
                     else {
                         console.log(`❌ (${result.error})`);
                         totalFail++;
+                        failures.push(file);
                     }
                 }
             }
         }
+        if (failures.length > 0) {
+            console.log('\n❌ 失败的文件:');
+            for (const f of failures) {
+                console.log(`   - ${f}`);
+            }
+        }
         return { success: totalSuccess, fail: totalFail };
     }
     // ─── 混合模式：同时有文件和目录 ───
@@ -673,7 +727,7 @@ async function main() {
     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);
+    const files = getAllFiles(options.directory, options.extensions, options.recursive, 0, options.maxDepth, options.targetFormat);
     if (files.length === 0) {
         console.log('✅ 没有找到需要转换的图片文件。');
         return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "change-image-suffix",
-  "version": "2.1.3",
+  "version": "2.1.4",
   "description": "批量转换图片格式的CLI工具，支持递归搜索、深度限制、指定后缀、Windows右键菜单等功能",
   "main": "dist/index.js",
   "files": [