xw-devtool-cli 1.0.1 → 1.0.3

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.3",
   "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,8 @@
     "inquirer": "^13.1.0",
     "lorem-ipsum": "^2.0.8",
     "pinyin": "^4.0.0",
+    "sharp": "^0.33.5",
+    "tinycolor2": "^1.6.0",
     "uuid": "^13.0.0"
   }
 }

package/src/commands/color.js

@@ -0,0 +1,56 @@
+import inquirer from 'inquirer';
+import tinycolor from 'tinycolor2';
+import { copy } from '../utils/clipboard.js';
+import { selectFromMenu } from '../utils/menu.js';
+
+export async function colorHandler() {
+    const { input } = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'input',
+            message: 'Enter color (Hex, RGB, HSL, or Name):',
+            validate: (input) => {
+                const color = tinycolor(input);
+                return color.isValid() || 'Invalid color format';
+            }
+        }
+    ]);
+
+    const color = tinycolor(input);
+    
+    const results = [];
+    results.push(`Hex: ${color.toHexString().toUpperCase()}`);
+    results.push(`RGB: ${color.toRgbString()}`);
+    results.push(`HSL: ${color.toHslString()}`);
+    results.push(`HSV: ${color.toHsvString()}`);
+    
+    // CMYK conversion (manual, as tinycolor doesn't support it directly)
+    const rgb = color.toRgb();
+    const r = rgb.r / 255;
+    const g = rgb.g / 255;
+    const b = rgb.b / 255;
+    let k = 1 - Math.max(r, g, b);
+    let c = (1 - r - k) / (1 - k) || 0;
+    let m = (1 - g - k) / (1 - k) || 0;
+    let y = (1 - b - k) / (1 - k) || 0;
+    
+    // Round to 2 decimal places
+    const toPercent = (n) => Math.round(n * 100);
+    const cmyk = `cmyk(${toPercent(c)}%, ${toPercent(m)}%, ${toPercent(y)}%, ${toPercent(k)}%)`;
+    results.push(`CMYK: ${cmyk}`);
+
+    console.log('\n=== Conversion Results ===');
+    results.forEach(res => console.log(res));
+    console.log('==========================\n');
+
+    // Allow user to copy one of the formats
+    const copyChoice = await selectFromMenu('Select format to copy', [
+        { name: 'Hex', value: color.toHexString().toUpperCase() },
+        { name: 'RGB', value: color.toRgbString() },
+        { name: 'HSL', value: color.toHslString() },
+        { name: 'HSV', value: color.toHsvString() },
+        { name: 'CMYK', value: cmyk }
+    ]);
+
+    await copy(copyChoice);
+}

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/commands/timeFormat.js

@@ -1,6 +1,10 @@
 import inquirer from 'inquirer';
 import dayjs from 'dayjs';
+import 'dayjs/locale/zh-cn.js';
 import { copy } from '../utils/clipboard.js';
+import { selectFromMenu } from '../utils/menu.js';
+
+dayjs.locale('zh-cn');
 
 export async function timeFormatHandler() {
     const { input } = await inquirer.prompt([
@@ -35,7 +39,26 @@ export async function timeFormatHandler() {
         return;
     }
 
-    const formatted = date.format('YYYY-MM-DD HH:mm:ss');
+    const formatPattern = await selectFromMenu('Select Output Format', [
+        { name: 'YYYY-MM-DD HH:mm:ss', value: 'YYYY-MM-DD HH:mm:ss' },
+        { name: 'YYYY-MM-DD HH:mm', value: 'YYYY-MM-DD HH:mm' },
+        { name: 'YYYY-MM-DD', value: 'YYYY-MM-DD' },
+        { name: 'HH:mm:ss', value: 'HH:mm:ss' },
+        { name: 'YYYY-MM-DD HH:mm:ss dddd', value: 'YYYY-MM-DD HH:mm:ss dddd' },
+        { name: 'dddd', value: 'dddd' },
+        { name: 'Timestamp (ms)', value: 'timestamp-ms' },
+        { name: 'Timestamp (s)', value: 'timestamp-s' }
+    ]);
+
+    let formatted;
+    if (formatPattern === 'timestamp-ms') {
+        formatted = String(date.valueOf());
+    } else if (formatPattern === 'timestamp-s') {
+        formatted = String(date.unix());
+    } else {
+        formatted = date.format(formatPattern);
+    }
+    
     console.log(`\nFormatted: ${formatted}\n`);
     await copy(formatted);
 }

package/src/commands/variableFormat.js

@@ -0,0 +1,94 @@
+import inquirer from 'inquirer';
+import { copy, read } from '../utils/clipboard.js';
+import { selectFromMenu } from '../utils/menu.js';
+
+export async function variableFormatHandler() {
+    const { input } = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'input',
+            message: 'Enter variable name to convert (Press Enter to paste from clipboard):',
+        }
+    ]);
+
+    let textToConvert = input;
+
+    if (!textToConvert || textToConvert.trim().length === 0) {
+        textToConvert = await read();
+        if (!textToConvert || textToConvert.trim().length === 0) {
+             console.log('Clipboard is empty or could not be read.');
+             return;
+        }
+        console.log(`\nUsing clipboard content: "${textToConvert}"`);
+    }
+
+    const words = splitIntoWords(textToConvert);
+    
+    if (words.length === 0) {
+        console.log('Could not parse any words from input.');
+        return;
+    }
+
+    const results = {
+        'camelCase': toCamelCase(words),
+        'PascalCase': toPascalCase(words),
+        'snake_case': toSnakeCase(words),
+        'kebab-case': toKebabCase(words),
+        'CONSTANT_CASE': toConstantCase(words)
+    };
+
+    console.log('\n=== Conversion Results ===');
+    Object.entries(results).forEach(([key, value]) => {
+        console.log(`${key.padEnd(15)}: ${value}`);
+    });
+    console.log('==========================\n');
+
+    const copyChoice = await selectFromMenu('Select format to copy', 
+        Object.entries(results).map(([key, value]) => ({
+            name: `${key} (${value})`,
+            value: value
+        }))
+    );
+
+    await copy(copyChoice);
+}
+
+function splitIntoWords(str) {
+    // 1. Handle CamelCase/camelCase by inserting space before uppercase letters that follow lowercase letters
+    let temp = str.replace(/([a-z])([A-Z])/g, '$1 $2');
+    
+    // 2. Handle consecutive uppercase followed by lowercase (e.g. JSONParser -> JSON Parser)
+    temp = temp.replace(/([A-Z]+)([A-Z][a-z])/g, '$1 $2');
+
+    // 3. Replace non-alphanumeric characters with spaces
+    temp = temp.replace(/[^a-zA-Z0-9]+/g, ' ');
+
+    // 4. Split by whitespace and filter empty strings
+    return temp
+        .trim()
+        .split(/\s+/)
+        .filter(w => w.length > 0);
+}
+
+function toCamelCase(words) {
+    return words.map((w, i) => {
+        if (i === 0) return w.toLowerCase();
+        return w.charAt(0).toUpperCase() + w.slice(1).toLowerCase();
+    }).join('');
+}
+
+function toPascalCase(words) {
+    return words.map(w => w.charAt(0).toUpperCase() + w.slice(1).toLowerCase()).join('');
+}
+
+function toSnakeCase(words) {
+    return words.map(w => w.toLowerCase()).join('_');
+}
+
+function toKebabCase(words) {
+    return words.map(w => w.toLowerCase()).join('-');
+}
+
+function toConstantCase(words) {
+    return words.map(w => w.toUpperCase()).join('_');
+}

package/src/index.js

@@ -3,11 +3,13 @@ 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';
 import { uuidHandler } from './commands/uuid.js';
 import { pinyinHandler } from './commands/pinyin.js';
+import { colorHandler } from './commands/color.js';
+import { variableFormatHandler } from './commands/variableFormat.js';
 
 process.on('SIGINT', () => {
     console.log('\nBye!');
@@ -28,11 +30,13 @@ const features = [
     { name: 'URL Encode/Decode', value: 'url' },
     { name: 'String Encode/Decode (Base64)', value: 'base64' },
     { name: 'Image <-> Base64', value: 'imgBase64' },
-    { name: 'Time Format', value: 'timeFormat' },
-    { name: 'Get Current Timestamp', value: 'timestamp' },
+    { name: 'Image Format Convert', value: 'imgConvert' },
+    { name: 'Time Format / Timestamp', value: 'timeFormat' },
     { name: 'Mock Text', value: 'mock' },
     { name: 'Get UUID', value: 'uuid' },
-    { name: 'Chinese to Pinyin', value: 'pinyin' }
+    { name: 'Chinese to Pinyin', value: 'pinyin' },
+    { name: 'Color Converter (Hex <-> RGB)', value: 'color' },
+    { name: 'Variable Format Converter', value: 'variableFormat' }
 ];
 
 async function main() {
@@ -46,12 +50,29 @@ async function main() {
     program.parse(process.argv);
 }
 
+function getFeatureKey(index) {
+    if (index < 9) {
+        return String(index + 1);
+    }
+    return String.fromCharCode('a'.charCodeAt(0) + (index - 9));
+}
+
+function getFeatureIndex(key) {
+    if (/^[1-9]$/.test(key)) {
+        return parseInt(key) - 1;
+    }
+    if (/^[a-z]$/.test(key.toLowerCase())) {
+        return key.toLowerCase().charCodeAt(0) - 'a'.charCodeAt(0) + 9;
+    }
+    return -1;
+}
+
 async function showMenu() {
     console.log('\n=================================');
     console.log('      xw-devtool-cli Menu');
     console.log('=================================');
     features.forEach((feature, index) => {
-        console.log(`${index + 1}. ${feature.name}`);
+        console.log(`${getFeatureKey(index)}. ${feature.name}`);
     });
     console.log('0. Exit');
     console.log('=================================\n');
@@ -60,25 +81,26 @@ async function showMenu() {
         {
             type: 'input',
             name: 'choice',
-            message: 'Please enter the feature number (0-8):',
+            message: `Please enter the feature key (0-9, a-z):`,
             validate: (input) => {
-                const num = parseInt(input);
-                if (isNaN(num) || num < 0 || num > features.length) {
-                    return `Please enter a number between 0 and ${features.length}`;
+                if (input === '0') return true;
+                
+                const index = getFeatureIndex(input);
+                if (index >= 0 && index < features.length) {
+                    return true;
                 }
-                return true;
+                return 'Invalid selection. Please enter a valid menu key.';
             }
         }
     ]);
 
-    const index = parseInt(choice);
-
-    if (index === 0) {
+    if (choice === '0') {
         console.log('Bye!');
         process.exit(0);
     }
 
-    const selectedFeature = features[index - 1];
+    const index = getFeatureIndex(choice);
+    const selectedFeature = features[index];
     
     try {
         await handleAction(selectedFeature.value);
@@ -102,12 +124,12 @@ async function handleAction(action) {
         case 'imgBase64':
             await imgBase64Handler();
             break;
+        case 'imgConvert':
+            await imgConvertHandler();
+            break;
         case 'timeFormat':
             await timeFormatHandler();
             break;
-        case 'timestamp':
-            await timestampHandler();
-            break;
         case 'mock':
             await mockHandler();
             break;
@@ -117,6 +139,12 @@ async function handleAction(action) {
         case 'pinyin':
             await pinyinHandler();
             break;
+        case 'color':
+            await colorHandler();
+            break;
+        case 'variableFormat':
+            await variableFormatHandler();
+            break;
         default:
             console.log('Feature not implemented yet.');
     }

package/src/utils/clipboard.js

@@ -8,3 +8,12 @@ export async function copy(text) {
         console.error('Failed to copy to clipboard (might not be supported in this environment):', e.message);
     }
 }
+
+export async function read() {
+    try {
+        return await clipboardy.read();
+    } catch (e) {
+        console.error('Failed to read from clipboard:', e.message);
+        return '';
+    }
+}

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;
     }
 }
-

package/src/commands/timestamp.js

@@ -1,7 +0,0 @@
-import { copy } from '../utils/clipboard.js';
-
-export async function timestampHandler() {
-    const now = Date.now();
-    console.log(`\nCurrent Timestamp: ${now}\n`);
-    await copy(String(now));
-}