xw-devtool-cli 1.0.9 → 1.0.11

package/README.md

@@ -19,6 +19,7 @@
   - **获取时间戳**：快速获取当前毫秒级时间戳。
 - **开发辅助工具**：
   - **URL 编解码**：Encode/Decode URL。
+  - **Unicode 编解码**：文本与 Unicode 转义序列 (\uXXXX) 互转。
   - **UUID**：生成 UUID v4。
   - **中文转拼音**：将汉字转换为不带声调的拼音。
   - **颜色转换**：Hex <-> RGB 互转。
@@ -61,43 +62,31 @@ xw-devtool
 =================================
       xw-devtool-cli Menu
 =================================
-1. URL Encode/Decode
-2. String Encode/Decode (Base64)
-3. Image <-> Base64
-4. Image Format Convert
-5. Time Format / Timestamp
-6. Mock Text
-7. Get UUID
-8. Chinese to Pinyin
-9. Color Converter (Hex <-> RGB)
-a. Variable Format Converter
-b. Hash Calculator (MD5/SHA/SM3)
-c. QR Code Generator
-d. Special Characters (Symbols)
-e. Emoji Picker
-f. HTML Entity Encode/Decode
-g. Placeholder Image Generator
+1. Image <-> Base64
+2. Image Format Convert
+3. Placeholder Image Generator
+4. QR Code Generator
+5. URL Encode/Decode
+6. String Encode/Decode (Base64)
+7. Unicode Encode/Decode
+8. HTML Entity Encode/Decode
+9. Variable Format Converter
+a. Chinese to Pinyin
+b. Time Format / Timestamp
+c. Color Converter (Hex <-> RGB)
+d. Get UUID
+e. Hash Calculator (MD5/SHA/SM3)
+f. Mock Text
+g. Special Characters (Symbols)
+h. Emoji Picker
 0. Exit
 =================================
 ```
 
 ## 📖 详细使用指南
 
-### 1. URL 编解码
+### 1. 图片与 Base64 互转
 - 选择 `1` 进入。
-- 选择 `Encode` (编码) 或 `Decode` (解码)。
-- 输入 URL 字符串，结果自动复制。
-
-### 2. 字符串 Base64 转换
-- 选择 `2` 进入。
-- 支持三种输入源：
-  - **Clipboard**: 直接读取剪贴板内容（适合处理长文本）。
-  - **File**: 读取文本文件内容。
-  - **Manual input**: 手动粘贴或输入文本。
-- 输出支持：直接复制、保存为文件、预览后复制。
-
-### 3. 图片与 Base64 互转
-- 选择 `3` 进入。
 - **Image -> Base64**:
   - 选择图片文件（支持对话框选择）。
   - 输出 Base64 字符串（可保存为 `.txt` 文件防止控制台卡顿）。
@@ -105,80 +94,111 @@ g. Placeholder Image Generator
   - 输入 Base64 字符串（支持从文件读取或剪贴板读取）。
   - 自动识别图片格式并保存为文件。
 
-### 4. 图片格式转换
-- 选择 `4` 进入。
+### 2. 图片格式转换
+- 选择 `2` 进入。
 - 选择源图片文件。
 - 选择目标格式 (PNG / JPG / WebP)。
 - 设置压缩参数（如 JPG 质量 1-100，PNG 压缩等级 0-9）。
 - 生成的新图片将保存在源文件同级目录。
 
-### 5. 时间格式化 (Time Format)
+### 3. 占位图生成 (Placeholder Image)
+- 选择 `3` 进入。
+- **模式 1：本地图片文件 (Local Image File)**
+  - 自动生成图片文件到当前目录。
+  - 支持自定义：
+    - **尺寸**: 宽度和高度 (px)。
+    - **颜色**: 背景色和文字颜色（支持 Hex 或颜色名）。
+    - **内容**: 自定义图片中间的文字（默认显示尺寸）。
+    - **格式**: 输出 PNG, JPG, WebP, GIF。
+  - 文件名默认包含时间戳，避免覆盖。
+- **模式 2：远程图片 URL (Remote Image URL)**
+  - 自动生成云端占位图链接并复制到剪贴板。
+  - 支持多个主流服务商：
+    - **Picsum Photos**: 随机风景图，支持灰度、模糊效果。
+    - **DummyImage**: 简单、经典。
+    - **Via Placeholder**: 标准占位图。
+    - **Placehold.jp**: 适合日文环境。
+    - **DevTool Tech**: 高度可定制。
+    - **FPO Img**: "For Placement Only" 风格。
+  - 支持自定义尺寸、颜色、文字等参数（视具体服务商而定）。
+
+### 4. 二维码生成
+- 选择 `4` 进入。
+- 输入文本或 URL（支持直接回车读取剪贴板）。
+- 终端直接显示二维码预览。
+- 可选保存为 PNG 图片，默认文件名包含时间戳。
+
+### 5. URL 编解码
 - 选择 `5` 进入。
-- 支持时间戳转日期字符串，或日期字符串转时间戳。
-- 直接回车可获取当前时间戳。
+- 选择 `Encode` (编码) 或 `Decode` (解码)。
+- 输入 URL 字符串，结果自动复制。
 
-### 6. Mock 数据生成
+### 6. 字符串 Base64 转换
 - 选择 `6` 进入。
-- 提供多种数据类型：英文段落、中文字符、身份证号、邮箱、手机号等。
-- 支持指定生成数量。
+- 支持三种输入源：
+  - **Clipboard**: 直接读取剪贴板内容（适合处理长文本）。
+  - **File**: 读取文本文件内容。
+  - **Manual input**: 手动粘贴或输入文本。
+- 输出支持：直接复制、保存为文件、预览后复制。
 
-### 7. UUID 生成
+### 7. Unicode 编码/解码
 - 选择 `7` 进入。
-- 自动生成一个 UUID v4 并复制到剪贴板。
+- **Encode**: 将文本转换为 Unicode 转义序列 (如 `\u4F60\u597D`)。
+- **Decode**: 将 Unicode 转义序列还原为文本。
+- 结果自动复制到剪贴板。
 
-### 8. 中文转拼音
+### 8. HTML 实体编码/解码
 - 选择 `8` 进入。
-- 输入中文字符串（支持直接回车读取剪贴板）。
-- 输出对应的拼音（无声调）。
+- 支持两种编码模式：
+  - **Standard**: 仅编码特殊字符（如 `<` `>` `&` 及非 ASCII 字符）。
+  - **Everything**: 编码所有字符（包括 ASCII 字母数字）。
+- 支持直接回车读取剪贴板内容。
+- 结果自动复制到剪贴板。
 
-### 9. 颜色转换 (Hex <-> RGB)
+### 9. 变量格式转换
 - 选择 `9` 进入。
-- 输入 Hex 颜色值 (如 #333) 或 RGB 值 (如 rgb(51,51,51))。
-- 自动转换并显示对应格式。
-
-### 10. 变量格式转换
-- 选择 `a` 进入。
 - 输入变量名（支持直接回车读取剪贴板）。
 - 自动展示 CamelCase, PascalCase, SnakeCase, KebabCase, ConstantCase 五种格式。
 - 选择一种格式自动复制。
 
-### 11. 哈希计算 (Encryption)
+### 10. 中文转拼音
+- 选择 `a` 进入。
+- 输入中文字符串（支持直接回车读取剪贴板）。
+- 输出对应的拼音（无声调）。
+
+### 11. 时间格式化 (Time Format)
 - 选择 `b` 进入。
-- 输入文本（支持直接回车读取剪贴板）。
-- 同时计算并显示 MD5, SHA1, SHA256, SHA512, SM3 哈希值。
+- 支持时间戳转日期字符串，或日期字符串转时间戳。
+- 直接回车可获取当前时间戳。
 
-### 12. 二维码生成
+### 12. 颜色转换 (Hex <-> RGB)
 - 选择 `c` 进入。
-- 输入文本或 URL（支持直接回车读取剪贴板）。
-- 终端直接显示二维码预览。
-- 可选保存为 PNG 图片，默认文件名包含时间戳。
+- 输入 Hex 颜色值 (如 #333) 或 RGB 值 (如 rgb(51,51,51))。
+- 自动转换并显示对应格式。
 
-### 13. 特殊符号大全
+### 13. Get UUID
 - 选择 `d` 进入。
-- 网格化展示常用特殊符号。
-- 输入符号对应的编号即可一键复制。
+- 自动生成一个 UUID v4 并复制到剪贴板。
 
-### 14. Emoji 输入
+### 14. 哈希计算 (Encryption)
 - 选择 `e` 进入。
-- 分类展示常用 Emoji (表情、手势、动物、食物等)。
-- 输入编号选择并复制 Emoji 到剪贴板。
+- 输入文本（支持直接回车读取剪贴板）。
+- 同时计算并显示 MD5, SHA1, SHA256, SHA512, SM3 哈希值。
 
-### 15. HTML 实体编码/解码
+### 15. Mock 数据生成
 - 选择 `f` 进入。
-- 支持两种编码模式：
-  - **Standard**: 仅编码特殊字符（如 `<` `>` `&` 及非 ASCII 字符）。
-  - **Everything**: 编码所有字符（包括 ASCII 字母数字）。
-- 支持直接回车读取剪贴板内容。
-- 结果自动复制到剪贴板。
+- 提供多种数据类型：英文段落、中文字符、身份证号、邮箱、手机号等。
+- 支持指定生成数量。
 
-### 16. 占位图生成 (Placeholder Image)
+### 16. 特殊符号大全
 - 选择 `g` 进入。
-- 支持自定义：
-  - **尺寸**: 宽度和高度 (px)。
-  - **颜色**: 背景色和文字颜色（支持 Hex 或颜色名）。
-  - **内容**: 自定义图片中间的文字（默认显示尺寸）。
-  - **格式**: 输出 PNG, JPG, WebP, GIF。
-- 文件名默认包含时间戳，避免覆盖。
+- 网格化展示常用特殊符号。
+- 输入符号对应的编号即可一键复制。
+
+### 17. Emoji 输入
+- 选择 `h` 进入。
+- 分类展示常用 Emoji (表情、手势、动物、食物等)。
+- 输入编号选择并复制 Emoji 到剪贴板。
 
 ## 📄 License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xw-devtool-cli",
-  "version": "1.0.9",
+  "version": "1.0.11",
   "type": "module",
   "description": "基于node的开发者助手cli",
   "main": "index.js",

package/src/commands/placeholderImg.js

@@ -1,30 +1,37 @@
 import inquirer from 'inquirer';
 import sharp from 'sharp';
 import path from 'path';
+import { copy } from '../utils/clipboard.js';
+import { selectFromMenu } from '../utils/menu.js';
 
 export async function placeholderImgHandler() {
-    console.log('\n--- Generate Placeholder Image ---\n');
+    const mode = await selectFromMenu('Generate Placeholder Image', [
+        { name: 'Local Image File', value: 'local' },
+        { name: 'Remote Image URL', value: 'remote' }
+    ]);
+
+    if (mode === 'local') {
+        await generateLocalImage();
+    } else {
+        await generateRemoteUrl();
+    }
+}
 
+async function generateLocalImage() {
     const answers = await inquirer.prompt([
         {
             type: 'input',
             name: 'width',
             message: 'Width (px):',
             default: '300',
-            validate: (input) => {
-                const val = parseInt(input);
-                return !isNaN(val) && val > 0 ? true : 'Please enter a valid positive number';
-            }
+            validate: validateNumber
         },
         {
             type: 'input',
             name: 'height',
             message: 'Height (px):',
             default: '200',
-            validate: (input) => {
-                const val = parseInt(input);
-                return !isNaN(val) && val > 0 ? true : 'Please enter a valid positive number';
-            }
+            validate: validateNumber
         },
         {
             type: 'input',
@@ -61,9 +68,8 @@ export async function placeholderImgHandler() {
     const width = parseInt(answers.width);
     const height = parseInt(answers.height);
     const text = answers.text || `${width}x${height}`;
-    const fontSize = Math.floor(Math.min(width, height) / 5); // Heuristic for font size
+    const fontSize = Math.floor(Math.min(width, height) / 5);
     
-    // Create SVG buffer
     const svgImage = `
     <svg width="${width}" height="${height}" version="1.1" xmlns="http://www.w3.org/2000/svg">
       <rect width="100%" height="100%" fill="${answers.bgColor}" />
@@ -72,7 +78,6 @@ export async function placeholderImgHandler() {
     `;
 
     const buffer = Buffer.from(svgImage);
-
     const outputFilename = `${answers.filename}.${answers.format}`;
     const outputPath = path.resolve(process.cwd(), outputFilename);
 
@@ -86,3 +91,98 @@ export async function placeholderImgHandler() {
         console.error(`\nFailed to generate image: ${error.message}`);
     }
 }
+
+async function generateRemoteUrl() {
+    const provider = await selectFromMenu('Select Provider', [
+        { name: 'Picsum Photos (Random photo)', value: 'picsum' },
+        { name: 'DummyImage (Simple)', value: 'dummyimage' },
+        { name: 'Via Placeholder (Standard)', value: 'placeholder' },
+        { name: 'Placehold.jp (JP Style)', value: 'placeholdjp' },
+        { name: 'DevTool Tech (Customizable)', value: 'devtool' },
+        { name: 'FPO Img (For Placement Only)', value: 'fpoimg' }
+    ]);
+
+    // Picsum is special (random photos)
+    if (provider === 'picsum') {
+        const answers = await inquirer.prompt([
+            { type: 'input', name: 'width', message: 'Width:', default: '300', validate: validateNumber },
+            { type: 'input', name: 'height', message: 'Height:', default: '300', validate: validateNumber },
+            { type: 'confirm', name: 'random', message: 'Add random parameter?', default: true },
+            { type: 'confirm', name: 'grayscale', message: 'Grayscale?', default: false },
+            { type: 'input', name: 'blur', message: 'Blur level (1-10, leave empty for none):', validate: (val) => !val || (parseInt(val) >= 1 && parseInt(val) <= 10) ? true : '1-10' }
+        ]);
+        
+        let url = `https://picsum.photos/${answers.width}/${answers.height}`;
+        const params = [];
+        if (answers.grayscale) params.push('grayscale');
+        if (answers.blur) params.push(`blur=${answers.blur}`);
+        if (answers.random) params.push(`random=${Math.floor(Math.random() * 1000)}`);
+        
+        if (params.length > 0) {
+            url += '?' + params.join('&');
+        }
+        
+        await finishUrl(url);
+        return;
+    }
+
+    // Common prompts for others
+    const answers = await inquirer.prompt([
+        { type: 'input', name: 'width', message: 'Width:', default: '300', validate: validateNumber },
+        { type: 'input', name: 'height', message: 'Height:', default: '300', validate: validateNumber },
+        { type: 'input', name: 'bgColor', message: 'Background Color (Hex without #):', default: 'cccccc' },
+        { type: 'input', name: 'textColor', message: 'Text Color (Hex without #):', default: '969696' },
+        { type: 'input', name: 'text', message: 'Text Content (leave empty for size):' },
+        { type: 'list', name: 'format', message: 'Format:', choices: ['png', 'jpg', 'gif'], default: 'png' }
+    ]);
+
+    let url = '';
+    const { width, height, bgColor, textColor, format } = answers;
+    const text = answers.text || `${width}x${height}`;
+    const cleanBg = bgColor.replace('#', '');
+    const cleanText = textColor.replace('#', '');
+    const encodedText = encodeURIComponent(text);
+
+    switch (provider) {
+        case 'dummyimage':
+            // https://dummyimage.com/300x300/999999/ff4400.png?text=EXAMPLE
+            url = `https://dummyimage.com/${width}x${height}/${cleanBg}/${cleanText}.${format}`;
+            if (text) url += `?text=${encodedText}`;
+            break;
+            
+        case 'placeholder':
+            // https://via.placeholder.com/640x300/999999/ff4400.png?text=example
+            url = `https://via.placeholder.com/${width}x${height}/${cleanBg}/${cleanText}.${format}`;
+            if (text) url += `?text=${encodedText}`;
+            break;
+
+        case 'placeholdjp':
+            // https://placehold.jp/999999/ff4400/300x300.png?text=EXAMPLE
+            url = `https://placehold.jp/${cleanBg}/${cleanText}/${width}x${height}.${format}`;
+            if (text) url += `?text=${encodedText}`;
+            break;
+
+        case 'devtool':
+            // https://devtool.tech/api/placeholder/300/300?text=示例&color=#ffffff&bgColor=#333333
+            // Note: devtool.tech needs # for colors
+            url = `https://devtool.tech/api/placeholder/${width}/${height}?text=${encodedText}&color=%23${cleanText}&bgColor=%23${cleanBg}`;
+            break;
+
+        case 'fpoimg':
+            // https://fpoimg.com/300x300?text=example&bg_color=999999&text_color=ff4400
+            url = `https://fpoimg.com/${width}x${height}?text=${encodedText}&bg_color=${cleanBg}&text_color=${cleanText}`;
+            break;
+    }
+
+    await finishUrl(url);
+}
+
+async function finishUrl(url) {
+    console.log(`\nGenerated URL:\n${url}\n`);
+    await copy(url);
+}
+
+function validateNumber(input) {
+    const val = parseInt(input);
+    return !isNaN(val) && val > 0 ? true : 'Please enter a valid positive number';
+}

package/src/commands/unicode.js

@@ -0,0 +1,52 @@
+import inquirer from 'inquirer';
+import { copy } from '../utils/clipboard.js';
+import { selectFromMenu } from '../utils/menu.js';
+
+export async function unicodeHandler() {
+    const mode = await selectFromMenu('Unicode Encode/Decode', [
+        { name: 'Encode (Text -> \\uXXXX)', value: 'encode' },
+        { name: 'Decode (\\uXXXX -> Text)', value: 'decode' }
+    ]);
+
+    const { input } = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'input',
+            message: `Enter string to ${mode}:`
+        }
+    ]);
+
+    let result;
+    try {
+        if (mode === 'encode') {
+            const encodeType = await selectFromMenu('Select Encoding Mode', [
+                { name: 'Encode Non-ASCII Only (Recommended)', value: 'non-ascii' },
+                { name: 'Encode All Characters', value: 'all' }
+            ]);
+            result = encodeUnicode(input, encodeType === 'non-ascii');
+        } else {
+            result = decodeUnicode(input);
+        }
+        console.log(`\nResult:\n${result}\n`);
+        await copy(result);
+    } catch (e) {
+        console.error('Error processing Unicode:', e.message);
+    }
+}
+
+function encodeUnicode(str, onlyNonAscii) {
+    return str.split('').map(char => {
+        const code = char.charCodeAt(0);
+        if (onlyNonAscii && code <= 127) {
+            return char;
+        }
+        const hex = code.toString(16).toUpperCase();
+        return '\\u' + '0000'.substring(0, 4 - hex.length) + hex;
+    }).join('');
+}
+
+function decodeUnicode(str) {
+    return str.replace(/\\u[\dA-F]{4}/gi, (match) => {
+        return String.fromCharCode(parseInt(match.replace(/\\u/g, ''), 16));
+    });
+}

package/src/index.js

@@ -2,6 +2,7 @@ import inquirer from 'inquirer';
 import { program } from 'commander';
 import { urlHandler } from './commands/url.js';
 import { base64Handler } from './commands/base64.js';
+import { unicodeHandler } from './commands/unicode.js';
 import { imgBase64Handler } from './commands/imgBase64.js';
 import { imgConvertHandler } from './commands/imgConvert.js';
 import { timeFormatHandler } from './commands/timeFormat.js';
@@ -33,22 +34,30 @@ process.on('unhandledRejection', (err) => {
 });
 
 const features = [
-    { name: 'URL Encode/Decode', value: 'url' },
-    { name: 'String Encode/Decode (Base64)', value: 'base64' },
+    // Image Tools
     { name: 'Image <-> Base64', value: 'imgBase64' },
     { name: 'Image Format Convert', value: 'imgConvert' },
-    { name: 'Time Format / Timestamp', value: 'timeFormat' },
-    { name: 'Mock Text', value: 'mock' },
-    { name: 'Get UUID', value: 'uuid' },
+    { name: 'Placeholder Image Generator', value: 'placeholderImg' },
+    { name: 'QR Code Generator', value: 'qrcode' },
+    
+    // Encode/Decode & Formatting
+    { name: 'URL Encode/Decode', value: 'url' },
+    { name: 'String Encode/Decode (Base64)', value: 'base64' },
+    { name: 'Unicode Encode/Decode', value: 'unicode' },
+    { name: 'HTML Entity Encode/Decode', value: 'htmlEntities' },
+    { name: 'Variable Format Converter', value: 'variableFormat' },
     { name: 'Chinese to Pinyin', value: 'pinyin' },
+
+    // Utils (Time, Color, UUID, Hash)
+    { name: 'Time Format / Timestamp', value: 'timeFormat' },
     { name: 'Color Converter (Hex <-> RGB)', value: 'color' },
-    { name: 'Variable Format Converter', value: 'variableFormat' },
+    { name: 'Get UUID', value: 'uuid' },
     { name: 'Hash Calculator (MD5/SHA/SM3)', value: 'hashing' },
-    { name: 'QR Code Generator', value: 'qrcode' },
+
+    // Content/Mocking
+    { name: 'Mock Text', value: 'mock' },
     { name: 'Special Characters (Symbols)', value: 'specialChars' },
-    { name: 'Emoji Picker', value: 'emoji' },
-    { name: 'HTML Entity Encode/Decode', value: 'htmlEntities' },
-    { name: 'Placeholder Image Generator', value: 'placeholderImg' }
+    { name: 'Emoji Picker', value: 'emoji' }
 ];
 
 async function main() {
@@ -133,6 +142,9 @@ async function handleAction(action) {
         case 'base64':
             await base64Handler();
             break;
+        case 'unicode':
+            await unicodeHandler();
+            break;
         case 'imgBase64':
             await imgBase64Handler();
             break;