xw-devtool-cli 1.0.29 → 1.0.33

package/README.md

@@ -24,6 +24,8 @@
   - **全屏十字辅助线**：显示跟随鼠标的全屏红色十字线，用于屏幕对齐和定位。
   - **屏幕测距**：点击屏幕上任意两点，测量其像素距离。
   - **屏幕文字标注**：在屏幕上点击并输入文字，进行临时标注。右键撤销，Delete 清空。
+  - **图片压缩**：支持文件或文件夹；文件夹可批量压缩其下所有图片（可选包含子文件夹）。支持 PNG/JPG/WebP，质量 1-100；输出文件名带时间戳并复制输出目录到剪贴板。
+    - 压缩完成后可选择自动打开输出目录（带返回上一步）。
 - **Mock 数据生成**：
   - 支持生成：英文段落 (Lorem Ipsum)、中文字符、中国居民身份证号、电子邮箱、URL、订单号、手机号、座机号。
   - 支持批量生成。
@@ -47,16 +49,25 @@
   - **HTML 实体工具**：支持 HTML 实体编码与解码 (如 `&` <-> `&amp;`)。
   - **Markdown 语法工具**：提供常用 Markdown 语法模板 (Headers, Lists, Tables, Code 等)，一键复制。
   - **VS Code 代码段生成器**：将代码转换为 VS Code Snippet JSON，自动生成语法速查表注释。
+  - **Git 助手**: 标准化生成 Git 分支名 (feature/bugfix/custom) 和 Conventional Commits 提交日志。
   - **占位图生成**：自定义尺寸、背景色、文字颜色和格式生成占位图。
 - **便捷操作**：
   - 支持文件选择对话框 (Windows)。
   - 结果自动复制到剪贴板。
   - 支持从剪贴板自动读取输入（部分工具支持直接回车读取）。
   - 支持将大文本结果保存为文件。
-- **多语言支持 (i18n)**：
+ - **多语言支持 (i18n)**：
   - 支持 **中文** 和 **English**。
   - 可通过菜单中的 `Settings` 切换，或使用命令行参数：`xw-devtool --zh` / `xw-devtool --en`。
 
+## 🖥️ 系统支持说明（Windows 专属功能）
+
+- 屏幕取色（来源：屏幕）仅支持 Windows；来源为图片的取色跨平台可用
+- 全屏十字辅助线 仅支持 Windows
+- 屏幕测距（像素）仅支持 Windows
+- 屏幕文字标注 仅支持 Windows
+- 文件选择/保存对话框 仅支持 Windows；在非 Windows 平台请手动输入文件路径或使用命令行默认路径
+
 ## 📦 安装
 
 ### 全局安装 (推荐)

package/README_EN.md

@@ -19,6 +19,8 @@ Key features include: Base64 encoding/decoding, image format conversion, image <
   - **Screen Crosshair**: Display a full-screen red crosshair following the mouse for alignment.
   - **Pixel Distance**: Measure pixel distance between two points on the screen.
   - **Screen Mark**: Click on the screen to add text annotations. Right-click to undo, Delete to clear.
+  - **Image Compression**: Compress a single file or an entire folder (optionally include subfolders). Supports PNG/JPG/WebP with quality 1–100. Output filenames include timestamps; the output directory is copied to clipboard.
+    - After compression, optionally open the output directory (includes a Back option).
 - **Mock Data**:
   - Generate: Lorem Ipsum, Chinese characters, ID cards, Emails, URLs, Order IDs, Phone numbers.
   - Supports batch generation.
@@ -42,6 +44,7 @@ Key features include: Base64 encoding/decoding, image format conversion, image <
   - **HTML Entity**: Encode/Decode HTML entities.
   - **Markdown Snippets**: Common Markdown templates.
   - **VS Code Snippets**: Generate VS Code snippet JSON from code.
+  - **Git Helper**: Generate standardized Git branch names (feature/bugfix) and Conventional Commits messages.
 - **Convenience**:
   - File selection dialog (Windows).
   - Auto-copy results to clipboard.
@@ -51,6 +54,18 @@ Key features include: Base64 encoding/decoding, image format conversion, image <
   - Support **English** and **Chinese**.
   - Switch via **Settings** in the menu or use CLI flags: `xw-devtool --en` / `xw-devtool --zh`.
 
+## 💻 System Requirements
+
+This tool is based on Node.js and supports multiple platforms, but some screen-interaction features are currently **Windows only** (due to reliance on PowerShell/WinForms):
+
+- **Screen Color Pick** (Screen source)
+- **Screen Crosshair**
+- **Pixel Distance Tool**
+- **Screen Mark Tool**
+- **File Dialogs** (Select/Save file) - *On non-Windows systems, please input file paths manually.*
+
+All other features (Image processing, Encoders, Mock data, Time, etc.) are fully cross-platform (Windows/macOS/Linux).
+
 ## 📦 Installation
 
 ### Global Installation (Recommended)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xw-devtool-cli",
-  "version": "1.0.29",
+  "version": "1.0.33",
   "type": "module",
   "description": "基于node的开发者助手cli",
   "main": "index.js",
@@ -51,7 +51,15 @@
     "emoji",
     "markdown",
     "screen-mark",
-    "pixel-distance"
+    "pixel-distance",
+    "image-compress",
+    "png-compress",
+    "jpg-compress",
+    "webp-compress",
+    "git",
+    "git-branch",
+    "commit-message",
+    "conventional-commits"
   ],
   "author": "npmxw",
   "license": "ISC",

package/src/commands/gitHelper.js

@@ -0,0 +1,144 @@
+import inquirer from 'inquirer';
+import i18next from '../i18n.js';
+import { copy } from '../utils/clipboard.js';
+import { selectFromMenu } from '../utils/menu.js';
+
+export async function gitHelperHandler() {
+    while (true) {
+        const action = await selectFromMenu(
+            i18next.t('gitHelper.selectAction'),
+            [
+                { name: i18next.t('gitHelper.branchName'), value: 'branch' },
+                { name: i18next.t('gitHelper.commitMessage'), value: 'commit' },
+                { name: i18next.t('common.back'), value: '__BACK__' }
+            ],
+            false
+        );
+        if (action === '__BACK__') return;
+        if (action === 'branch') {
+            await handleBranchName();
+        } else {
+            await handleCommitMessage();
+        }
+        return;
+    }
+}
+
+async function handleBranchName() {
+    const type = await selectFromMenu(
+        i18next.t('gitHelper.branchType'),
+        [
+            { name: 'feature', value: 'feature' },
+            { name: 'bugfix', value: 'bugfix' },
+            { name: 'hotfix', value: 'hotfix' },
+            { name: 'release', value: 'release' },
+            { name: 'docs', value: 'docs' },
+            { name: 'style', value: 'style' },
+            { name: 'refactor', value: 'refactor' },
+            { name: 'test', value: 'test' },
+            { name: 'chore', value: 'chore' },
+            { name: 'custom', value: 'custom' },
+            { name: i18next.t('common.back'), value: '__BACK__' }
+        ],
+        true,
+        i18next.t('common.back')
+    );
+    if (type === '__BACK__') return;
+    let customType = '';
+    if (type === 'custom') {
+        const { customType: ct } = await inquirer.prompt([
+            {
+                type: 'input',
+                name: 'customType',
+                message: i18next.t('gitHelper.customTypePrompt'),
+                validate: (input) => input.trim() ? true : i18next.t('gitHelper.required')
+            }
+        ]);
+        customType = ct;
+    }
+    const { ticketId, description } = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'ticketId',
+            message: i18next.t('gitHelper.ticketId'),
+            default: ''
+        },
+        {
+            type: 'input',
+            name: 'description',
+            message: i18next.t('gitHelper.description'),
+            validate: (input) => input.trim() ? true : i18next.t('gitHelper.required')
+        }
+    ]);
+
+    // Helper to slugify text
+    const slugify = (text) => {
+        return text.toString().toLowerCase()
+            .trim()
+            .replace(/\s+/g, '-')     // Replace spaces with -
+            .replace(/[^\w\-]+/g, '') // Remove all non-word chars
+            .replace(/\-\-+/g, '-');  // Replace multiple - with single -
+    };
+
+    const descSlug = slugify(description);
+    const ticketPart = ticketId ? `${ticketId.trim()}-` : '';
+    
+    const branchName = `${type === 'custom' ? customType : type}/${ticketPart}${descSlug}`;
+    
+    console.log(`\n${i18next.t('gitHelper.result')}: ${branchName}\n`);
+    await copy(branchName);
+}
+
+async function handleCommitMessage() {
+    const type = await selectFromMenu(
+        i18next.t('gitHelper.commitType'),
+        [
+            { name: 'feat:      A new feature', value: 'feat' },
+            { name: 'fix:       A bug fix', value: 'fix' },
+            { name: 'docs:      Documentation only changes', value: 'docs' },
+            { name: 'style:     Changes that do not affect the meaning of the code', value: 'style' },
+            { name: 'refactor:  A code change that neither fixes a bug nor adds a feature', value: 'refactor' },
+            { name: 'perf:      A code change that improves performance', value: 'perf' },
+            { name: 'test:      Adding missing tests or correcting existing tests', value: 'test' },
+            { name: 'build:     Changes that affect the build system or external dependencies', value: 'build' },
+            { name: 'ci:        Changes to our CI configuration files and scripts', value: 'ci' },
+            { name: 'chore:     Other changes that don\'t modify src or test files', value: 'chore' },
+            { name: 'revert:    Reverts a previous commit', value: 'revert' }
+        ]
+    );
+    const { scope, subject } = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'scope',
+            message: i18next.t('gitHelper.scope'),
+        },
+        {
+            type: 'input',
+            name: 'subject',
+            message: i18next.t('gitHelper.subject'),
+            validate: (input) => input.trim() ? true : i18next.t('gitHelper.required')
+        }
+    ]);
+    const { body, footer } = await inquirer.prompt([
+        {
+            type: 'editor',
+            name: 'body',
+            message: i18next.t('gitHelper.body'),
+        },
+        {
+            type: 'input',
+            name: 'footer',
+            message: i18next.t('gitHelper.footer'),
+        }
+    ]);
+
+    const scopePart = scope ? `(${scope})` : '';
+    const head = `${type}${scopePart}: ${subject}`;
+    const bodyPart = body ? `\n\n${body.trim()}` : '';
+    const footerPart = footer ? `\n\n${footer.trim()}` : '';
+
+    const commitMsg = `${head}${bodyPart}${footerPart}`;
+
+    console.log(`\n${i18next.t('gitHelper.result')}:\n----------------\n${commitMsg}\n----------------\n`);
+    await copy(commitMsg);
+}

package/src/commands/imgCompress.js

@@ -0,0 +1,230 @@
+import fs from 'fs';
+import path from 'path';
+import sharp from 'sharp';
+import inquirer from 'inquirer';
+import i18next from '../i18n.js';
+import { selectFromMenu } from '../utils/menu.js';
+import { selectFile, selectFolder } from '../utils/fileDialog.js';
+import dayjs from 'dayjs';
+import { spawn, exec } from 'child_process';
+import { copy } from '../utils/clipboard.js';
+
+const SUPPORTED_EXT = ['.png', '.jpg', '.jpeg', '.webp'];
+
+function isDirPath(p) {
+    try {
+        const st = fs.statSync(p);
+        return st.isDirectory();
+    } catch {
+        return false;
+    }
+}
+
+function listImagesInDir(dir, recursive) {
+    const results = [];
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const full = path.join(dir, entry.name);
+        const isDir = entry.isDirectory() || entry.isSymbolicLink() ? isDirPath(full) : false;
+        if (isDir) {
+            if (recursive) {
+                results.push(...listImagesInDir(full, recursive));
+            }
+        } else {
+            const ext = path.extname(entry.name).toLowerCase();
+            if (SUPPORTED_EXT.includes(ext)) {
+                results.push(full);
+            }
+        }
+    }
+    return results;
+}
+
+async function pickInput() {
+    const options = [
+        { name: i18next.t('imgCompress.sourceFileDialog'), value: 'fileDialog' },
+        { name: i18next.t('imgCompress.sourceFolderDialog'), value: 'folderDialog' },
+        { name: i18next.t('imgCompress.sourceFileManual'), value: 'fileManual' },
+        { name: i18next.t('imgCompress.sourceFolderManual'), value: 'folderManual' }
+    ];
+    const method = await selectFromMenu(i18next.t('imgCompress.selectSource'), options, true, i18next.t('common.back'));
+    if (method === '__BACK__') return { back: true };
+    if (method === 'fileDialog') {
+        const filePath = selectFile('Image Files|*.png;*.jpg;*.jpeg;*.webp');
+        if (!filePath) {
+            console.log(i18next.t('imgCompress.dialogFail'));
+            return await pickInput();
+        }
+        return { type: 'file', path: filePath };
+    }
+    if (method === 'folderDialog') {
+        const folderPath = selectFolder();
+        if (!folderPath) {
+            console.log(i18next.t('imgCompress.dialogFail'));
+            return await pickInput();
+        }
+        return { type: 'folder', path: folderPath };
+    }
+    if (method === 'fileManual') {
+        const { filePath } = await inquirer.prompt([
+            { type: 'input', name: 'filePath', message: i18next.t('imgCompress.enterFilePath') }
+        ]);
+        if (!fs.existsSync(filePath) || !fs.statSync(filePath).isFile()) {
+            console.log(i18next.t('imgCompress.notExist'));
+            return await pickInput();
+        }
+        return { type: 'file', path: filePath };
+    }
+    if (method === 'folderManual') {
+        const { folderPath } = await inquirer.prompt([
+            { type: 'input', name: 'folderPath', message: i18next.t('imgCompress.enterFolderPath') }
+        ]);
+        if (!fs.existsSync(folderPath) || !fs.statSync(folderPath).isDirectory()) {
+            console.log(i18next.t('imgCompress.notExist'));
+            return await pickInput();
+        }
+        return { type: 'folder', path: folderPath };
+    }
+    return { back: true };
+}
+
+async function pickQuality() {
+    const presets = [
+        { name: '90 (High)', value: 90 },
+        { name: '80 (Recommended)', value: 80 },
+        { name: '70 (Smaller size)', value: 70 },
+        { name: i18next.t('imgCompress.customQuality'), value: 'custom' }
+    ];
+    const qSel = await selectFromMenu(i18next.t('imgCompress.selectQuality'), presets, true, i18next.t('common.back'));
+    if (qSel === '__BACK__') return '__BACK__';
+    if (qSel === 'custom') {
+        const { q } = await inquirer.prompt([
+            { type: 'input', name: 'q', message: i18next.t('imgCompress.inputQuality'), default: '80', validate: (v) => (/^\d+$/.test(v) && +v >= 1 && +v <= 100) ? true : i18next.t('imgCompress.qualityInvalid') }
+        ]);
+        return parseInt(q);
+    }
+    return qSel;
+}
+
+async function pickRecursive() {
+    const choice = await selectFromMenu(i18next.t('imgCompress.includeSubfolders'), [
+        { name: i18next.t('imgCompress.yes'), value: true },
+        { name: i18next.t('imgCompress.no'), value: false }
+    ], true, i18next.t('common.back'));
+    if (choice === '__BACK__') return '__BACK__';
+    return choice;
+}
+
+async function pickPreserveStructure() {
+    const choice = await selectFromMenu(i18next.t('imgCompress.preservePrompt'), [
+        { name: i18next.t('imgCompress.yes'), value: true },
+        { name: i18next.t('imgCompress.no'), value: false }
+    ], true, i18next.t('common.back'));
+    if (choice === '__BACK__') return '__BACK__';
+    return choice;
+}
+
+async function compressOne(inputPath, quality, outDir, baseDir, preserveStructure) {
+    const ext = path.extname(inputPath).toLowerCase();
+    const name = path.basename(inputPath, ext);
+    const ts = dayjs().format('YYYYMMDD_HHmmss');
+    let targetDir = outDir;
+    if (preserveStructure && baseDir) {
+        const rel = path.relative(baseDir, path.dirname(inputPath));
+        targetDir = path.join(outDir, rel);
+        fs.mkdirSync(targetDir, { recursive: true });
+    }
+    const outPath = path.join(targetDir, `${name}_compressed_${ts}${ext}`);
+    const image = sharp(inputPath, { failOnError: false });
+    if (ext === '.jpg' || ext === '.jpeg') {
+        await image.jpeg({ quality, mozjpeg: true }).toFile(outPath);
+    } else if (ext === '.png') {
+        // Map quality (1-100) to compressionLevel (0-9) roughly
+        const level = Math.max(0, Math.min(9, Math.round((100 - quality) / 10)));
+        await image.png({ quality, compressionLevel: level }).toFile(outPath);
+    } else if (ext === '.webp') {
+        await image.webp({ quality }).toFile(outPath);
+    } else {
+        return null;
+    }
+    return outPath;
+}
+
+export async function imgCompressHandler() {
+    const input = await pickInput();
+    if (input.back) return;
+    const quality = await pickQuality();
+    if (quality === '__BACK__') return;
+    let files = [];
+    let baseDir = '';
+    if (input.type === 'file') {
+        files = [input.path];
+        baseDir = path.dirname(input.path);
+    } else {
+        const recursive = await pickRecursive();
+        if (recursive === '__BACK__') return;
+        files = listImagesInDir(input.path, recursive);
+        baseDir = input.path;
+        console.log(`${i18next.t('imgCompress.scanResult')}: ${files.length}`);
+        if (files.length > 0) {
+            const preview = files.slice(0, Math.min(files.length, 5));
+            preview.forEach((p, i) => console.log(`${i + 1}. ${p}`));
+            if (files.length > preview.length) console.log('...');
+        }
+    }
+    if (files.length === 0) {
+        console.log(i18next.t('imgCompress.noImages'));
+        return;
+    }
+    const outDir = path.resolve(baseDir, `compressed_${dayjs().format('YYYYMMDD_HHmmss')}`);
+    fs.mkdirSync(outDir, { recursive: true });
+    let preserveStructure = false;
+    if (input.type === 'folder') {
+        const preserveChoice = await pickPreserveStructure();
+        if (preserveChoice === '__BACK__') return;
+        preserveStructure = preserveChoice;
+    }
+    const results = [];
+    for (const f of files) {
+        try {
+            const out = await compressOne(f, quality, outDir, baseDir, preserveStructure);
+            if (out) results.push(out);
+        } catch (e) {
+            console.error(`${i18next.t('imgCompress.fail')}: ${f} -> ${e.message}`);
+        }
+    }
+    console.log(`\n${i18next.t('imgCompress.done')} ${results.length}/${files.length}`);
+    console.log(`${i18next.t('imgCompress.outputDir')}: ${outDir}\n`);
+    await copy(`${i18next.t('imgCompress.outputDir')}: ${outDir}`);
+
+    const openChoice = await selectFromMenu(
+        i18next.t('imgCompress.openPrompt'),
+        [
+            { name: i18next.t('imgCompress.yes'), value: true },
+            { name: i18next.t('imgCompress.no'), value: false }
+        ],
+        true,
+        i18next.t('common.back')
+    );
+    if (openChoice !== '__BACK__' && openChoice === true) {
+        try {
+            openFolder(outDir);
+            console.log(i18next.t('imgCompress.opened'));
+        } catch (e) {
+            console.error(`${i18next.t('imgCompress.openFail')}: ${e.message}`);
+        }
+    }
+}
+
+function openFolder(dir) {
+    const platform = process.platform;
+    if (platform === 'win32') {
+        exec(`start "" "${dir}"`);
+    } else if (platform === 'darwin') {
+        const cp = spawn('open', [dir], { detached: true });
+        cp.unref();
+    } else {
+        const cp = spawn('xdg-open', [dir], { detached: true });
+        cp.unref();
+    }
+}

package/src/commands/pixelDistance.js

@@ -123,14 +123,10 @@ public class DistanceForm : Form {
             double dist = Math.Sqrt(Math.Pow(target.X - p1.X, 2) + Math.Pow(target.Y - p1.Y, 2));
             string text = String.Format("{0:F2} px", dist);
             
-            // Draw text at midpoint
-            Point mid = new Point((p1.X + target.X) / 2, (p1.Y + target.Y) / 2);
             SizeF size = g.MeasureString(text, font);
-            
-            // Ensure text doesn't go off screen
-            float txtX = mid.X + 10;
-            float txtY = mid.Y + 10;
-            
+            float pad = 16;
+            float txtX = this.ClientSize.Width - (float)size.Width - pad;
+            float txtY = this.ClientSize.Height - (float)size.Height - pad;
             g.FillRectangle(textBg, txtX - 2, txtY - 2, size.Width + 4, size.Height + 4);
             g.DrawString(text, font, Brushes.White, txtX, txtY);
             

package/src/index.js

@@ -32,6 +32,8 @@ import { colorPickHandler } from './commands/colorPick.js';
 import { crosshairHandler } from './commands/crosshair.js';
 import { pixelDistanceHandler } from './commands/pixelDistance.js';
 import { screenMarkHandler } from './commands/screenMark.js';
+import { gitHelperHandler } from './commands/gitHelper.js';
+import { imgCompressHandler } from './commands/imgCompress.js';
 
 process.on('SIGINT', () => {
     console.log(`\n${i18next.t('menu.bye')}`);
@@ -59,6 +61,7 @@ function getFeatures() {
         { name: i18next.t('menu.features.crosshair'), value: 'crosshair' },
         { name: i18next.t('menu.features.pixelDistance'), value: 'pixelDistance' },
         { name: i18next.t('menu.features.screenMark'), value: 'screenMark' },
+        { name: i18next.t('menu.features.imgCompress'), value: 'imgCompress' },
         { name: i18next.t('menu.features.placeholderImg'), value: 'placeholderImg' },
         { name: i18next.t('menu.features.qrcode'), value: 'qrcode' },
         
@@ -86,6 +89,7 @@ function getFeatures() {
         { name: i18next.t('menu.features.emoji'), value: 'emoji' },
         { name: i18next.t('menu.features.markdown'), value: 'markdown' },
         { name: i18next.t('menu.features.vscodeSnippet'), value: 'vscodeSnippet' },
+        { name: i18next.t('menu.features.gitHelper'), value: 'gitHelper' },
         
         // Settings
         { name: i18next.t('menu.features.settings'), value: 'settings' }
@@ -255,12 +259,18 @@ async function handleAction(action) {
         case 'placeholderImg':
             await placeholderImgHandler();
             break;
+        case 'imgCompress':
+            await imgCompressHandler();
+            break;
         case 'markdown':
             await markdownHandler();
             break;
         case 'vscodeSnippet':
             await vscodeSnippetHandler();
             break;
+        case 'gitHelper':
+            await gitHelperHandler();
+            break;
         case 'settings':
             await handleSettings();
             break;

package/src/locales/en.js

@@ -2,6 +2,22 @@ export default {
     common: {
         back: 'Back to previous step'
     },
+    gitHelper: {
+        selectAction: 'Select Action',
+        branchName: 'Generate Git Branch Name',
+        commitMessage: 'Generate Git Commit Message',
+        branchType: 'Select Branch Type',
+        customTypePrompt: 'Enter Custom Type:',
+        ticketId: 'Ticket ID (Optional):',
+        description: 'Description (Short):',
+        required: 'Required',
+        result: 'Result',
+        commitType: 'Select Commit Type',
+        scope: 'Scope (Optional):',
+        subject: 'Subject (Short summary):',
+        body: 'Body (Detailed description, Optional, opens editor):',
+        footer: 'Footer (Breaking changes/Issue refs, Optional):'
+    },
     pixelDistance: {
         notSupported: 'Pixel distance tool not supported on this OS.',
         startPrompt: 'Pixel distance tool started. Click 2 points to measure. Right-click to reset. ESC to exit.'
@@ -25,6 +41,7 @@ export default {
             crosshair: 'Screen Crosshair',
             pixelDistance: 'Pixel Distance Tool',
             screenMark: 'Screen Mark Tool',
+            imgCompress: 'Image Compression',
             placeholderImg: 'Placeholder Image Generator',
             qrcode: 'QR Code Generator',
             url: 'URL Encode/Decode',
@@ -46,6 +63,7 @@ export default {
             emoji: 'Emoji Picker',
             markdown: 'Markdown Snippets',
             vscodeSnippet: 'VS Code Snippet Generator',
+            gitHelper: 'Git Helper (Branch/Commit Template)',
             settings: 'Settings / Language'
         }
     },
@@ -111,5 +129,32 @@ export default {
         hLines: 'Horizontal split lines (e.g. 10 20 30 or 10% 20%):',
         vLines: 'Vertical split lines (e.g. 10 20 30 or 10% 20%):',
         success: 'Successfully split image into {{count}} parts. Saved to {{path}}'
+    },
+    imgCompress: {
+        selectSource: 'Select input method',
+        sourceFileDialog: 'Select file (dialog)',
+        sourceFolderDialog: 'Select folder (dialog)',
+        sourceFileManual: 'Enter file path manually',
+        sourceFolderManual: 'Enter folder path manually',
+        dialogFail: 'Dialog not available or canceled. Please retry or use manual input.',
+        enterFilePath: 'Enter image file path:',
+        enterFolderPath: 'Enter folder path:',
+        notExist: 'Path does not exist or type mismatch.',
+        selectQuality: 'Select compression quality (1-100)',
+        customQuality: 'Custom quality',
+        inputQuality: 'Enter quality (1-100):',
+        qualityInvalid: 'Please enter an integer between 1 and 100',
+        includeSubfolders: 'Include subfolders?',
+        yes: 'Yes',
+        no: 'No',
+        noImages: 'No images found to compress.',
+        fail: 'Compression failed',
+        done: 'Compression finished. Success count',
+        outputDir: 'Output Directory',
+        openPrompt: 'Open output directory?',
+        openFail: 'Failed to open directory',
+        opened: 'Opened output directory',
+        scanResult: 'Images found',
+        preservePrompt: 'Preserve original directory structure in output?'
     }
 };

package/src/locales/zh.js

@@ -6,6 +6,22 @@ export default {
         notSupported: '当前系统不支持屏幕辅助线。',
         startPrompt: '屏幕十字辅助线已启动。按任意键退出...'
     },
+    gitHelper: {
+        selectAction: '请选择操作',
+        branchName: '生成 Git 分支名',
+        commitMessage: '生成 Git 提交日志 (Conventional Commits)',
+        branchType: '选择分支类型',
+        customTypePrompt: '请输入自定义类型:',
+        ticketId: 'Ticket ID (可选):',
+        description: '描述 (简短):',
+        required: '此项必填',
+        result: '生成结果',
+        commitType: '选择提交类型',
+        scope: 'Scope (范围, 可选):',
+        subject: 'Subject (简述):',
+        body: 'Body (详细描述, 可选, 会打开编辑器):',
+        footer: 'Footer (Breaking changes/Issue refs, 可选):'
+    },
     pixelDistance: {
         notSupported: '当前系统不支持屏幕测距。',
         startPrompt: '屏幕测距工具已启动。点击两点测量距离。右键重置。ESC 退出。'
@@ -25,6 +41,7 @@ export default {
             crosshair: '全屏十字辅助线',
             pixelDistance: '屏幕测距 (像素)',
             screenMark: '屏幕文字标注',
+            imgCompress: '图片压缩',
             placeholderImg: '占位图生成器',
             qrcode: '二维码生成器',
             url: 'URL 编码/解码',
@@ -46,6 +63,7 @@ export default {
             emoji: 'Emoji 选择器',
             markdown: 'Markdown 片段',
             vscodeSnippet: 'VS Code 代码片段生成',
+            gitHelper: 'Git 助手 (分支/提交模板)',
             settings: '设置 / 语言 (Settings)'
         }
     },
@@ -111,5 +129,32 @@ export default {
         hLines: '水平分割线 (例如 10 20 30 或 10% 20%):',
         vLines: '垂直分割线 (例如 10 20 30 或 10% 20%):',
         success: '成功将图片分割为 {{count}} 份。保存至 {{path}}'
+    },
+    imgCompress: {
+        selectSource: '选择输入方式',
+        sourceFileDialog: '选择文件（对话框）',
+        sourceFolderDialog: '选择文件夹（对话框）',
+        sourceFileManual: '手动输入文件路径',
+        sourceFolderManual: '手动输入文件夹路径',
+        dialogFail: '对话框不可用或取消，请重试或改用手动输入。',
+        enterFilePath: '请输入图片文件路径:',
+        enterFolderPath: '请输入文件夹路径:',
+        notExist: '路径不存在或类型不匹配。',
+        selectQuality: '选择压缩质量 (1-100)',
+        customQuality: '自定义质量',
+        inputQuality: '请输入质量 (1-100):',
+        qualityInvalid: '请输入 1-100 的整数',
+        includeSubfolders: '是否包含子文件夹',
+        yes: '是',
+        no: '否',
+        noImages: '未找到可压缩的图片。',
+        fail: '压缩失败',
+        done: '压缩完成，成功数量',
+        outputDir: '输出目录',
+        openPrompt: '是否打开输出目录',
+        openFail: '打开目录失败',
+        opened: '已打开输出目录',
+        scanResult: '扫描到图片数量',
+        preservePrompt: '递归时是否按原始目录结构输出'
     }
 };

package/src/utils/fileDialog.js

@@ -27,3 +27,15 @@ export function saveFile(defaultName = 'output.txt', filter = 'All Files|*.*') {
         return null;
     }
 }
+
+export function selectFolder() {
+    if (!isWindows()) return null;
+    try {
+        const cmd = `powershell -NoProfile -Command "Add-Type -AssemblyName System.Windows.Forms; $fb = New-Object System.Windows.Forms.FolderBrowserDialog; if($fb.ShowDialog() -eq [System.Windows.Forms.DialogResult]::OK){ $bytes = [System.Text.Encoding]::UTF8.GetBytes($fb.SelectedPath); Write-Output ([Convert]::ToBase64String($bytes)) }"`;
+        const buf = execSync(cmd, { stdio: ['pipe', 'pipe', 'ignore'] });
+        const output = Buffer.isBuffer(buf) ? buf.toString('utf8').trim() : String(buf).trim();
+        return output ? Buffer.from(output, 'base64').toString('utf8') : null;
+    } catch {
+        return null;
+    }
+}