xw-devtool-cli 1.0.1 → 1.0.2

package/README.md

@@ -1,73 +1,122 @@
 # xw-devtool-cli
 
-一个上手即用的命令行工具箱，帮你快速完成常见开发小任务：URL 编解码、字符串 Base64、图片与 Base64 互转、时间格式化与当前时间戳、Mock 文本（中/英）、UUID、中文转拼音等,且工具持续添加中......,结果会自动复制到剪贴板，方便粘贴到代码或文档。
+一个基于 Node.js 的开发者命令行工具箱，旨在提供开箱即用的常用开发工具，帮助开发者快速处理日常任务。
 
-## 安装
-- 全局安装：`npm i -g xw-devtool-cli`
-- 启动：在终端运行 `xw-devtool`
-- 免安装一次性使用：`npx xw-devtool@latest`
+主要功能包括：Base64 编解码、图片格式转换、图片与 Base64 互转、Mock 数据生成、时间戳/日期格式化、URL 编解码、UUID 生成、汉字转拼音等。所有结果均自动复制到剪贴板，极大提升开发效率。
 
-## 快速开始
-启动后显示主菜单，输入数字选择功能：
+## ✨ 功能特性
+
+- **Base64 工具**：支持字符串与 Base64 互转，支持从剪贴板、文件或手动输入读取。
+- **图片工具**：
+  - **图片格式转换**：支持 PNG、JPG、WebP 格式互转，可调整压缩质量。
+  - **图片 ↔ Base64**：支持图片转 Base64 字符串，以及 Base64 还原为图片文件。
+- **Mock 数据生成**：
+  - 支持生成：英文段落 (Lorem Ipsum)、中文字符、中国居民身份证号、电子邮箱、URL、订单号、手机号、座机号。
+  - 支持批量生成。
+- **时间工具**：
+  - **时间格式化**：时间戳/日期字符串 -> `YYYY-MM-DD HH:mm:ss`。
+  - **获取时间戳**：快速获取当前毫秒级时间戳。
+- **其他工具**：
+  - **URL 编解码**：Encode/Decode URL。
+  - **UUID**：生成 UUID v4。
+  - **中文转拼音**：将汉字转换为不带声调的拼音。
+- **便捷操作**：
+  - 支持文件选择对话框 (Windows)。
+  - 结果自动复制到剪贴板。
+  - 支持将大文本结果保存为文件。
+
+## 📦 安装
+
+### 全局安装 (推荐)
+```bash
+npm install -g xw-devtool-cli
 ```
-1. URL Encode/Decode
-2. String Encode/Decode (Base64)
-3. Image <-> Base64
-4. Time Format
-5. Get Current Timestamp
-6. Mock Text
-7. Get UUID
-8. Chinese to Pinyin
-0. Exit
+安装后即可在终端直接使用 `xw-devtool` 命令。
+
+### 免安装运行 (npx)
+```bash
+npx xw-devtool-cli@latest
 ```
 
-## 常用操作
-- URL 编解码
-  - 选择 `1` → 选择 `Encode` 或 `Decode` → 输入 URL → 结果自动复制
-- 字符串 Base64
-  - 选择 `2` → 选择 `Encode` 或 `Decode`
-  - 选择输入来源：`Clipboard`（推荐长文本）/ `File` / `Manual input`
-  - 选择输出方式：`Copy to clipboard` / `Save to file` / `Preview + copy`
-  - 保存文件会给出默认文件名：`base64-[encode|decode]-<timestamp>.txt`
-- 图片 ↔ Base64
-  - 图片 → Base64：选择 `3` → 选择 `Image -> Base64` → 选择图片（对话框或手动路径）→ 选择输出方式（复制或保存为 `.txt`）
-  - Base64 → 图片：选择 `3` → 选择 `Base64 -> Image` → 选择输入来源（剪贴板、文件或手动输入）→ 自动识别 `data:image/*` 前缀并推断扩展名 → 保存图片（默认名：`image-<timestamp>.<ext>`）
-- 时间工具
-  - 时间格式化：选择 `4` → 输入时间戳（秒/毫秒）或日期字符串，或直接回车使用当前时间 → 输出 `YYYY-MM-DD HH:mm:ss`
-  - 当前时间戳：选择 `5` → 显示毫秒级时间戳并复制
-- Mock 文本
-  - 选择 `6` → 选择语言（英文/中文）
-  - 英文：输入段落数生成 Lorem Ipsum
-  - 中文：输入字数生成随机常用汉字
-- UUID
-  - 选择 `7` → 生成 UUID v4 并复制
-- 中文转拼音
-  - 选择 `8` → 输入中文 → 输出不带声调的拼音（空格分词）
-
-## 输入与输出
-- 输入来源
-  - `Clipboard`：直接读取剪贴板（适合非常长的内容）
-  - `File`：支持文件对话框或手动输入路径
-  - `Manual input`：命令行输入（适合短文本）
-- 文件输入方式（当选择 `File`）
-  - `Select file (dialog)`：弹出系统文件选择框（Windows）
-  - `Enter file path manually`：手动输入路径
-- 输出方式
-  - `Copy to clipboard`：不打印全文，直接复制
-  - `Save to file`：弹出保存对话框（Windows），或手动输入路径；默认文件名为“工具名 + 时间戳”
-  - `Preview + copy`：显示长度与头尾少量字符预览，并复制完整结果
-
-## 提示
-- 粘贴超长文本到控制台会很慢，建议使用 `Clipboard` 或 `File` 作为输入来源，并使用 `Save to file` 或 `Preview + copy` 作为输出方式
-- 在任何步骤按 `Ctrl+C` 会优雅退出并显示 `Bye!`
-- 工具在本地离线运行，不依赖网络
-
-## 系统要求
-- Node.js `>= 18`
-- Windows：支持文件选择/保存对话框
-- macOS/Linux：使用手动路径输入（可按需扩展对话框支持）
-
-## 卸载
-- 全局卸载：`npm uninstall -g xw-devtool-cli`
+## 🚀 快速开始
+
+在终端运行：
+```bash
+xw-devtool
+```
+
+启动后将显示交互式菜单，通过键盘方向键或输入数字选择功能：
+
+```text
+? Select a tool: (Use arrow keys)
+> 1. URL Encode/Decode
+  2. String Encode/Decode (Base64)
+  3. Image <-> Base64
+  4. Image Format Convert
+  5. Time Format
+  6. Get Current Timestamp
+  7. Mock Text
+  8. Get UUID
+  9. Chinese to Pinyin
+  0. Exit
+```
+
+## 📖 详细使用指南
+
+### 1. URL 编解码
+- 选择 `1` 进入。
+- 选择 `Encode` (编码) 或 `Decode` (解码)。
+- 输入 URL 字符串，结果自动复制。
+
+### 2. 字符串 Base64 转换
+- 选择 `2` 进入。
+- 支持三种输入源：
+  - **Clipboard**: 直接读取剪贴板内容（适合处理长文本）。
+  - **File**: 读取文本文件内容。
+  - **Manual input**: 手动粘贴或输入文本。
+- 输出支持：直接复制、保存为文件、预览后复制。
+
+### 3. 图片与 Base64 互转
+- 选择 `3` 进入。
+- **Image -> Base64**:
+  - 选择图片文件（支持对话框选择）。
+  - 输出 Base64 字符串（可保存为 `.txt` 文件防止控制台卡顿）。
+- **Base64 -> Image**:
+  - 输入 Base64 字符串（支持从文件读取或剪贴板读取）。
+  - 自动识别图片格式并保存为文件。
+
+### 4. 图片格式转换
+- 选择 `4` 进入。
+- 选择源图片文件。
+- 选择目标格式 (PNG / JPG / WebP)。
+- 设置压缩参数（如 JPG 质量 1-100，PNG 压缩等级 0-9）。
+- 生成的新图片将保存在源文件同级目录。
+
+### 5. Mock 数据生成
+- 选择 `7` 进入。
+- 提供多种数据类型：
+  - **英文段落**: 生成 Lorem Ipsum 文本。
+  - **中文字符**: 生成随机常用汉字。
+  - **身份证号**: 生成符合规则的虚拟身份证号 (包含校验位)。
+  - **邮箱**: 生成随机电子邮箱地址。
+  - **URL**: 生成随机网址。
+  - **订单号**: 生成基于时间戳的模拟订单号。
+  - **手机号**: 生成常见号段的手机号。
+  - **座机号**: 生成带区号的座机号码。
+- 支持指定生成数量（批量生成）。
+
+### 6. 时间工具
+- **时间格式化 (5)**: 输入时间戳（秒/毫秒）或日期字符串，输出标准化格式。留空直接回车则使用当前时间。
+- **当前时间戳 (6)**: 快速获取当前毫秒时间戳。
+
+### 7. 其他
+- **UUID (8)**: 生成一个 UUID v4。
+- **中文转拼音 (9)**: 输入中文文本，输出拼音字符串（空格分隔）。
 
+## 💻 系统要求
+- Node.js >= 18.0.0
+- Windows 用户可享受原生文件选择/保存对话框体验。
+- macOS/Linux 用户支持完整功能，但文件路径需手动输入。
 
+## 📄 License
+ISC

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xw-devtool-cli",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "type": "module",
   "description": "基于node的开发者助手cli",
   "main": "index.js",
@@ -27,7 +27,10 @@
     "mock",
     "timestamp",
     "time",
-    "image"
+    "image",
+    "webp",
+    "jpg",
+    "png"
   ],
   "author": "npmxw",
   "license": "ISC",
@@ -36,10 +39,10 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://example.com/xw-devtool-cli.git"
+    "url": "https://gitee.com/github-9819409/xw-devtool-cli.git"
   },
   "bugs": {
-    "url": "https://example.com/xw-devtool-cli/issues"
+    "url": "https://gitee.com/github-9819409/xw-devtool-cli/issues"
   },
   "dependencies": {
     "clipboardy": "^5.0.2",
@@ -48,6 +51,7 @@
     "inquirer": "^13.1.0",
     "lorem-ipsum": "^2.0.8",
     "pinyin": "^4.0.0",
+    "sharp": "^0.33.5",
     "uuid": "^13.0.0"
   }
 }

package/src/commands/imgConvert.js

@@ -0,0 +1,112 @@
+import inquirer from 'inquirer';
+import fs from 'fs';
+import path from 'path';
+import sharp from 'sharp';
+import { selectFromMenu } from '../utils/menu.js';
+import { selectFile, saveFile } from '../utils/fileDialog.js';
+import { defaultFileName } from '../utils/output.js';
+
+function getExt(p) {
+    const ext = path.extname(p).toLowerCase().replace('.', '');
+    if (ext === 'jpeg') return 'jpg';
+    return ext;
+}
+
+function suggestOutputPath(inputPath, targetExt) {
+    const dir = path.dirname(inputPath);
+    const base = path.basename(inputPath, path.extname(inputPath));
+    return path.join(dir, `${base}.${targetExt}`);
+}
+
+async function pickInputFile() {
+    const method = await selectFromMenu('File input method', [
+        { name: 'Select file (dialog)', value: 'dialog' },
+        { name: 'Enter file path manually', value: 'manual' }
+    ]);
+    let filePath = '';
+    if (method === 'dialog') {
+        filePath = selectFile('Image Files|*.png;*.jpg;*.jpeg;*.webp|All Files|*.*') || '';
+        if (!filePath) {
+            console.log('File dialog not available or canceled. Please enter path manually.');
+        }
+    }
+    if (!filePath) {
+        const ans = await inquirer.prompt([
+            {
+                type: 'input',
+                name: 'filePath',
+                message: 'Enter image file path:',
+                validate: (input) => (fs.existsSync(input) ? true : 'File does not exist.')
+            }
+        ]);
+        filePath = ans.filePath;
+    }
+    return filePath;
+}
+
+async function pickTargetFormat(currentExt) {
+    const options = [
+        { name: 'png', value: 'png' },
+        { name: 'jpg', value: 'jpg' },
+        { name: 'webp', value: 'webp' }
+    ].filter(o => o.value !== currentExt);
+    return await selectFromMenu('Target format', options);
+}
+
+async function pickQuality(targetExt) {
+    if (targetExt === 'png') {
+        const { level } = await inquirer.prompt([
+            { type: 'number', name: 'level', message: 'PNG compression level (0-9):', default: 6, validate: n => (n >= 0 && n <= 9) ? true : '0-9' }
+        ]);
+        return { pngCompressionLevel: level };
+    } else if (targetExt === 'jpg') {
+        const { quality } = await inquirer.prompt([
+            { type: 'number', name: 'quality', message: 'JPEG quality (1-100):', default: 80, validate: n => (n >= 1 && n <= 100) ? true : '1-100' }
+        ]);
+        return { jpegQuality: quality };
+    } else if (targetExt === 'webp') {
+        const { quality } = await inquirer.prompt([
+            { type: 'number', name: 'quality', message: 'WebP quality (1-100):', default: 80, validate: n => (n >= 1 && n <= 100) ? true : '1-100' }
+        ]);
+        return { webpQuality: quality };
+    }
+    return {};
+}
+
+export async function imgConvertHandler() {
+    const inputPath = await pickInputFile();
+    const inputExt = getExt(inputPath);
+    console.log(`Input: ${inputPath}`);
+
+    const targetExt = await pickTargetFormat(inputExt);
+    console.log(`Target format: ${targetExt}`);
+    const opts = await pickQuality(targetExt);
+
+    let outPath = saveFile(suggestOutputPath(inputPath, targetExt), 'Image Files|*.png;*.jpg;*.jpeg;*.webp|All Files|*.*');
+    if (!outPath) {
+        const def = suggestOutputPath(inputPath, targetExt);
+        const ans = await inquirer.prompt([
+            { type: 'input', name: 'outPath', message: 'Enter output file path:', default: def }
+        ]);
+        outPath = ans.outPath;
+    }
+
+    try {
+        fs.mkdirSync(path.dirname(outPath), { recursive: true });
+        let pipeline = sharp(inputPath);
+        if (targetExt === 'png') {
+            pipeline = pipeline.png({ compressionLevel: opts.pngCompressionLevel ?? 6 });
+        } else if (targetExt === 'jpg') {
+            pipeline = pipeline.jpeg({ quality: opts.jpegQuality ?? 80 });
+            if (inputExt !== 'jpg') {
+                pipeline = pipeline.flatten({ background: { r: 255, g: 255, b: 255 } });
+            }
+        } else if (targetExt === 'webp') {
+            pipeline = pipeline.webp({ quality: opts.webpQuality ?? 80 });
+        }
+        await pipeline.toFile(outPath);
+        console.log(`Converted: ${inputPath} -> ${outPath}`);
+    } catch (e) {
+        console.error('Conversion error:', e.message);
+    }
+}

package/src/index.js

@@ -3,6 +3,7 @@ import { program } from 'commander';
 import { urlHandler } from './commands/url.js';
 import { base64Handler } from './commands/base64.js';
 import { imgBase64Handler } from './commands/imgBase64.js';
+import { imgConvertHandler } from './commands/imgConvert.js';
 import { timeFormatHandler } from './commands/timeFormat.js';
 import { timestampHandler } from './commands/timestamp.js';
 import { mockHandler } from './commands/mock.js';
@@ -28,6 +29,7 @@ const features = [
     { name: 'URL Encode/Decode', value: 'url' },
     { name: 'String Encode/Decode (Base64)', value: 'base64' },
     { name: 'Image <-> Base64', value: 'imgBase64' },
+    { name: 'Image Format Convert', value: 'imgConvert' },
     { name: 'Time Format', value: 'timeFormat' },
     { name: 'Get Current Timestamp', value: 'timestamp' },
     { name: 'Mock Text', value: 'mock' },
@@ -102,6 +104,9 @@ async function handleAction(action) {
         case 'imgBase64':
             await imgBase64Handler();
             break;
+        case 'imgConvert':
+            await imgConvertHandler();
+            break;
         case 'timeFormat':
             await timeFormatHandler();
             break;

package/src/utils/fileDialog.js

@@ -7,9 +7,10 @@ function isWindows() {
 export function selectFile(filter = 'All Files|*.*') {
     if (!isWindows()) return null;
     try {
-        const cmd = `powershell -NoProfile -Command "Add-Type -AssemblyName System.Windows.Forms; $fd = New-Object System.Windows.Forms.OpenFileDialog; $fd.Filter='${filter.replace(/"/g, '\\"')}'; $fd.Multiselect=$false; if($fd.ShowDialog() -eq [System.Windows.Forms.DialogResult]::OK){ Write-Output $fd.FileName }"`;
-        const output = execSync(cmd, { stdio: ['pipe', 'pipe', 'ignore'] }).toString().trim();
-        return output || null;
+        const cmd = `powershell -NoProfile -Command "Add-Type -AssemblyName System.Windows.Forms; $fd = New-Object System.Windows.Forms.OpenFileDialog; $fd.Filter='${filter.replace(/"/g, '\\"')}'; $fd.Multiselect=$false; if($fd.ShowDialog() -eq [System.Windows.Forms.DialogResult]::OK){ $bytes = [System.Text.Encoding]::UTF8.GetBytes($fd.FileName); 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;
     }
@@ -18,11 +19,11 @@ export function selectFile(filter = 'All Files|*.*') {
 export function saveFile(defaultName = 'output.txt', filter = 'All Files|*.*') {
     if (!isWindows()) return null;
     try {
-        const cmd = `powershell -NoProfile -Command "Add-Type -AssemblyName System.Windows.Forms; $sd = New-Object System.Windows.Forms.SaveFileDialog; $sd.Filter='${filter.replace(/"/g, '\\"')}'; $sd.FileName='${defaultName.replace(/"/g, '\\"')}'; if($sd.ShowDialog() -eq [System.Windows.Forms.DialogResult]::OK){ Write-Output $sd.FileName }"`;
-        const output = execSync(cmd, { stdio: ['pipe', 'pipe', 'ignore'] }).toString().trim();
-        return output || null;
+        const cmd = `powershell -NoProfile -Command "Add-Type -AssemblyName System.Windows.Forms; $sd = New-Object System.Windows.Forms.SaveFileDialog; $sd.Filter='${filter.replace(/"/g, '\\"')}'; $sd.FileName='${defaultName.replace(/"/g, '\\"')}'; if($sd.ShowDialog() -eq [System.Windows.Forms.DialogResult]::OK){ $bytes = [System.Text.Encoding]::UTF8.GetBytes($sd.FileName); 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;
     }
 }
-