xw-devtool-cli 1.0.15 → 1.0.17

package/README.md

@@ -1,8 +1,10 @@
 # xw-devtool-cli
 
+**中文** | [English Documentation](./README_EN.md)
+
 一个基于 Node.js 的开发者命令行工具箱，旨在提供开箱即用的常用开发工具，帮助开发者快速处理日常任务。
 
-主要功能包括：Base64 编解码、图片格式转换、图片与 Base64 互转、Mock 数据生成、时间戳/日期格式化、时间计算、URL 编解码、UUID 生成、汉字转拼音、颜色转换、变量格式转换、哈希计算、二维码生成、特殊符号大全、Markdown 语法工具等。所有结果均自动复制到剪贴板，极大提升开发效率。
+主要功能包括：Base64 编解码、图片格式转换、图片与 Base64 互转、Mock 数据生成、时间戳/日期格式化、时间计算、URL 编解码、UUID 生成、汉字转拼音、颜色转换、变量格式转换、哈希计算、二维码生成、特殊符号大全、Markdown 语法工具、VS Code 代码段生成等。所有结果均自动复制到剪贴板，极大提升开发效率。
 
 ## ✨ 功能特性
 
@@ -31,12 +33,16 @@
   - **Emoji 输入**：支持分类查看和选择常用 Emoji，一键复制到剪贴板。
   - **HTML 实体工具**：支持 HTML 实体编码与解码 (如 `&` <-> `&amp;`)。
   - **Markdown 语法工具**：提供常用 Markdown 语法模板 (Headers, Lists, Tables, Code 等)，一键复制。
+  - **VS Code 代码段生成器**：将代码转换为 VS Code Snippet JSON，自动生成语法速查表注释。
   - **占位图生成**：自定义尺寸、背景色、文字颜色和格式生成占位图。
 - **便捷操作**：
   - 支持文件选择对话框 (Windows)。
   - 结果自动复制到剪贴板。
   - 支持从剪贴板自动读取输入（部分工具支持直接回车读取）。
   - 支持将大文本结果保存为文件。
+- **多语言支持 (i18n)**：
+  - 支持 **中文** 和 **English**。
+  - 可通过菜单中的 `Settings` 切换，或使用命令行参数：`xw-devtool --zh` / `xw-devtool --en`。
 
 ## 📦 安装
 
@@ -58,6 +64,12 @@ npx xw-devtool-cli@latest
 xw-devtool
 ```
 
+或者指定语言启动：
+```bash
+xw-devtool --zh  # 中文启动
+xw-devtool --en  # 英文启动 (Start in English)
+```
+
 启动后将显示交互式菜单，通过键盘输入对应的数字或字母选择功能：
 
 ```text
@@ -84,6 +96,8 @@ h. Mock Text
 i. Special Characters (Symbols)
 j. Emoji Picker
 k. Markdown Snippets
+l. VS Code Snippet Generator
+s. Settings (Language)
 0. Exit
 =================================
 ```
@@ -245,6 +259,16 @@ k. Markdown Snippets
   - **Others**: 引用、分割线、折叠详情等。
 - 选择对应语法后，模板将自动复制到剪贴板。
 
+### 21. VS Code 代码段生成器 (VS Code Snippet Generator)
+- 选择 `l` 进入。
+- **Generate Snippet**: 将任意代码转换为 VS Code 的 `.code-snippets` JSON 格式。
+  - 支持从 **剪贴板**、**文件** 或 **手动输入** 获取代码。
+  - 自动转义双引号和换行符，生成 `body` 数组。
+  - 输入 Snippet Name, Prefix (Trigger), Description。
+  - 结果自动复制到剪贴板，可直接粘贴到 VS Code 的 Snippet 配置文件中。
+  - **注意**：为防止长文本刷屏，结果**仅自动复制到剪贴板**，不会在终端打印。
+  - **提示**：生成的代码段会自动包含语法速查表 (Syntax Cheatsheet) 作为注释，方便参考。
+
 ## 📄 License
 
 ISC

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xw-devtool-cli",
-  "version": "1.0.15",
+  "version": "1.0.17",
   "type": "module",
   "description": "基于node的开发者助手cli",
   "main": "index.js",
@@ -67,6 +67,7 @@
     "commander": "^14.0.2",
     "dayjs": "^1.11.19",
     "he": "^1.2.0",
+    "i18next": "^25.7.3",
     "inquirer": "^13.1.0",
     "lorem-ipsum": "^2.0.8",
     "pinyin": "^4.0.0",

package/src/commands/url.js

@@ -1,18 +1,19 @@
 import inquirer from 'inquirer';
 import { copy } from '../utils/clipboard.js';
 import { selectFromMenu } from '../utils/menu.js';
+import i18next from '../i18n.js';
 
 export async function urlHandler() {
-    const mode = await selectFromMenu('URL Encode/Decode', [
-        { name: 'Encode', value: 'encode' },
-        { name: 'Decode', value: 'decode' }
+    const mode = await selectFromMenu(i18next.t('url.title'), [
+        { name: i18next.t('url.encode'), value: 'encode' },
+        { name: i18next.t('url.decode'), value: 'decode' }
     ]);
 
     const { input } = await inquirer.prompt([
         {
             type: 'input',
             name: 'input',
-            message: `Enter URL to ${mode}:`
+            message: i18next.t('url.inputPrompt', { mode: mode === 'encode' ? i18next.t('url.encode') : i18next.t('url.decode') })
         }
     ]);
 
@@ -23,9 +24,9 @@ export async function urlHandler() {
         } else {
             result = decodeURIComponent(input);
         }
-        console.log(`\nResult:\n${result}\n`);
+        console.log(`\n${i18next.t('url.result')}\n${result}\n`);
         await copy(result);
     } catch (e) {
-        console.error('Error processing URL:', e.message);
+        console.error(i18next.t('url.error'), e.message);
     }
 }

package/src/commands/vscodeSnippet.js

@@ -0,0 +1,95 @@
+import inquirer from 'inquirer';
+import { copy } from '../utils/clipboard.js';
+import { selectFromMenu } from '../utils/menu.js';
+import fs from 'fs';
+
+export async function vscodeSnippetHandler() {
+    await generateSnippet();
+}
+
+async function generateSnippet() {
+    const inputSource = await selectFromMenu('VS Code Snippet Generator - Select Code Source', [
+        { name: 'Clipboard (Paste automatically)', value: 'clipboard' },
+        { name: 'Manual Input', value: 'manual' },
+        { name: 'File', value: 'file' }
+    ]);
+
+    let code = '';
+    if (inputSource === 'clipboard') {
+        const clipboardy = (await import('clipboardy')).default;
+        code = await clipboardy.read();
+    } else if (inputSource === 'file') {
+        const { filePath } = await inquirer.prompt([
+            {
+                type: 'input',
+                name: 'filePath',
+                message: 'Enter file path:'
+            }
+        ]);
+        try {
+            code = fs.readFileSync(filePath.replace(/"/g, ''), 'utf-8');
+        } catch (e) {
+            console.error('Error reading file:', e.message);
+            return;
+        }
+    } else {
+        const { manualInput } = await inquirer.prompt([
+            {
+                type: 'editor',
+                name: 'manualInput',
+                message: 'Enter/Paste your code (Close editor to finish):'
+            }
+        ]);
+        code = manualInput;
+    }
+
+    if (!code) {
+        console.log('No code provided.');
+        return;
+    }
+
+    const answers = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'name',
+            message: 'Snippet Name (e.g. "React Component"):',
+            validate: input => input ? true : 'Name is required'
+        },
+        {
+            type: 'input',
+            name: 'prefix',
+            message: 'Snippet Prefix (Trigger) (e.g. "rfc"):',
+            validate: input => input ? true : 'Prefix is required'
+        },
+        {
+            type: 'input',
+            name: 'description',
+            message: 'Description (optional):'
+        }
+    ]);
+
+    // Convert code to array of lines
+    const lines = code.split(/\r?\n/);
+    
+    // We construct the object
+    const snippetObj = {
+        [answers.name]: {
+            prefix: answers.prefix,
+            body: lines,
+            description: answers.description || answers.name
+        }
+    };
+
+    const jsonOutput = JSON.stringify(snippetObj, null, 4);
+    
+    // Add syntax cheatsheet as comments
+    const finalOutput = `// VS Code Snippet Syntax Help:
+// 1. Tabstops: $1, $2... $0 (final cursor position)
+// 2. Placeholders: \${1:default value}
+// 3. Choices: \${1|one,two,three|}
+// 4. Variables: $TM_FILENAME, $CURRENT_YEAR, $CLIPBOARD...
+
+${jsonOutput}`;
+
+    await copy(finalOutput);
+}

package/src/i18n.js

@@ -0,0 +1,46 @@
+import i18next from 'i18next';
+import en from './locales/en.js';
+import zh from './locales/zh.js';
+import { loadConfig, saveConfig } from './utils/config.js';
+
+const config = loadConfig();
+
+let systemLocale = 'en';
+try {
+    systemLocale = Intl.DateTimeFormat().resolvedOptions().locale;
+} catch (e) {}
+
+let language = config.language || systemLocale;
+
+// Check command line arguments for language override
+// Note: We check this before commander parses arguments because i18n is initialized at top-level
+const args = process.argv.slice(2);
+let newLang = null;
+if (args.includes('--zh')) {
+    newLang = 'zh';
+} else if (args.includes('--en')) {
+    newLang = 'en';
+}
+
+if (newLang) {
+    language = newLang;
+    // Persist the language setting if changed via CLI
+    saveConfig({ language: newLang });
+}
+
+if (language.toLowerCase().startsWith('zh')) {
+    language = 'zh';
+} else {
+    language = 'en';
+}
+
+await i18next.init({
+    lng: language,
+    fallbackLng: 'en',
+    resources: {
+        en: { translation: en },
+        zh: { translation: zh }
+    }
+});
+
+export default i18next;

package/src/index.js

@@ -1,5 +1,8 @@
 import inquirer from 'inquirer';
-import { program } from 'commander';
+import { Command } from 'commander';
+import i18next from './i18n.js';
+import { saveConfig } from './utils/config.js';
+
 import { urlHandler } from './commands/url.js';
 import { base64Handler } from './commands/base64.js';
 import { unicodeHandler } from './commands/unicode.js';
@@ -20,15 +23,16 @@ import { emojiHandler } from './commands/emoji.js';
 import { htmlEntitiesHandler } from './commands/htmlEntities.js';
 import { placeholderImgHandler } from './commands/placeholderImg.js';
 import { markdownHandler } from './commands/markdown.js';
+import { vscodeSnippetHandler } from './commands/vscodeSnippet.js';
 
 process.on('SIGINT', () => {
-    console.log('\nBye!');
+    console.log(`\n${i18next.t('menu.bye')}`);
     process.exit(0);
 });
 process.on('unhandledRejection', (err) => {
     const msg = (err && err.message) ? err.message : String(err);
     if (msg.includes('SIGINT') || (err && err.name === 'ExitPromptError')) {
-        console.log('\nBye!');
+        console.log(`\n${i18next.t('menu.bye')}`);
         process.exit(0);
     } else {
         console.error('Unhandled error:', err);
@@ -36,40 +40,50 @@ process.on('unhandledRejection', (err) => {
     }
 });
 
-const features = [
-    // Image Tools
-    { name: 'Image <-> Base64', value: 'imgBase64' },
-    { name: 'Image Format Convert', value: 'imgConvert' },
-    { 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: 'JSON Format (Minify/Prettify)', value: 'jsonFormat' },
-    { name: 'Chinese to Pinyin', value: 'pinyin' },
-
-    // Utils (Time, Color, UUID, Hash)
-    { name: 'Time Format / Timestamp', value: 'timeFormat' },
-    { name: 'Time Calculation (Diff/Offset)', value: 'timeCalc' },
-    { name: 'Color Converter (Hex <-> RGB)', value: 'color' },
-    { name: 'Get UUID', value: 'uuid' },
-    { name: 'Hash Calculator (MD5/SHA/SM3)', value: 'hashing' },
-
-    // Content/Mocking
-    { name: 'Mock Text', value: 'mock' },
-    { name: 'Special Characters (Symbols)', value: 'specialChars' },
-    { name: 'Emoji Picker', value: 'emoji' },
-    { name: 'Markdown Snippets', value: 'markdown' }
-];
+function getFeatures() {
+    return [
+        // Image Tools
+        { name: i18next.t('menu.features.imgBase64'), value: 'imgBase64' },
+        { name: i18next.t('menu.features.imgConvert'), value: 'imgConvert' },
+        { name: i18next.t('menu.features.placeholderImg'), value: 'placeholderImg' },
+        { name: i18next.t('menu.features.qrcode'), value: 'qrcode' },
+        
+        // Encode/Decode & Formatting
+        { name: i18next.t('menu.features.url'), value: 'url' },
+        { name: i18next.t('menu.features.base64'), value: 'base64' },
+        { name: i18next.t('menu.features.unicode'), value: 'unicode' },
+        { name: i18next.t('menu.features.htmlEntities'), value: 'htmlEntities' },
+        { name: i18next.t('menu.features.variableFormat'), value: 'variableFormat' },
+        { name: i18next.t('menu.features.jsonFormat'), value: 'jsonFormat' },
+        { name: i18next.t('menu.features.pinyin'), value: 'pinyin' },
+
+        // Utils (Time, Color, UUID, Hash)
+        { name: i18next.t('menu.features.timeFormat'), value: 'timeFormat' },
+        { name: i18next.t('menu.features.timeCalc'), value: 'timeCalc' },
+        { name: i18next.t('menu.features.color'), value: 'color' },
+        { name: i18next.t('menu.features.uuid'), value: 'uuid' },
+        { name: i18next.t('menu.features.hashing'), value: 'hashing' },
+
+        // Content/Mocking
+        { name: i18next.t('menu.features.mock'), value: 'mock' },
+        { name: i18next.t('menu.features.specialChars'), value: 'specialChars' },
+        { name: i18next.t('menu.features.emoji'), value: 'emoji' },
+        { name: i18next.t('menu.features.markdown'), value: 'markdown' },
+        { name: i18next.t('menu.features.vscodeSnippet'), value: 'vscodeSnippet' },
+        
+        // Settings
+        { name: i18next.t('menu.features.settings'), value: 'settings' }
+    ];
+}
 
 async function main() {
+    const program = new Command();
+
     program
         .version('1.0.0')
         .description('Developer Assistant CLI')
+        .option('--en', 'Set language to English')
+        .option('--zh', 'Set language to Chinese')
         .action(async () => {
             await showMenu();
         });
@@ -95,20 +109,22 @@ function getFeatureIndex(key) {
 }
 
 async function showMenu() {
+    const features = getFeatures();
+
     console.log('\n=================================');
-    console.log('      xw-devtool-cli Menu');
+    console.log(`      ${i18next.t('menu.title')}`);
     console.log('=================================');
     features.forEach((feature, index) => {
         console.log(`${getFeatureKey(index)}. ${feature.name}`);
     });
-    console.log('0. Exit');
+    console.log(`0. ${i18next.t('menu.exit')}`);
     console.log('=================================\n');
 
     const { choice } = await inquirer.prompt([
         {
             type: 'input',
             name: 'choice',
-            message: `Please enter the feature key (0-9, a-z):`,
+            message: i18next.t('menu.prompt'),
             validate: (input) => {
                 if (input === '0') return true;
                 
@@ -116,13 +132,13 @@ async function showMenu() {
                 if (index >= 0 && index < features.length) {
                     return true;
                 }
-                return 'Invalid selection. Please enter a valid menu key.';
+                return i18next.t('menu.invalid');
             }
         }
     ]);
 
     if (choice === '0') {
-        console.log('Bye!');
+        console.log(i18next.t('menu.bye'));
         process.exit(0);
     }
 
@@ -135,8 +151,6 @@ async function showMenu() {
         console.error('Error:', error.message);
     }
     
-    // Wait a bit or ask to continue? 
-    // Usually just looping back is fine.
     await showMenu();
 }
 
@@ -181,6 +195,7 @@ async function handleAction(action) {
         case 'jsonFormat':
             await jsonFormatHandler();
             break;
+            
         case 'hashing':
             await hashingHandler();
             break;
@@ -202,9 +217,57 @@ async function handleAction(action) {
         case 'markdown':
             await markdownHandler();
             break;
+        case 'vscodeSnippet':
+            await vscodeSnippetHandler();
+            break;
+        case 'settings':
+            await handleSettings();
+            break;
         default:
             console.log('Feature not implemented yet.');
     }
 }
 
+async function handleSettings() {
+    const languages = [
+        { name: 'English', value: 'en' },
+        { name: '中文 (Chinese)', value: 'zh' }
+    ];
+
+    console.log(`\n${i18next.t('settings.selectLanguage')}:`);
+    languages.forEach((lang, index) => {
+        console.log(`${index + 1}. ${lang.name}`);
+    });
+    console.log(`0. ${i18next.t('settings.backToMenu')}`);
+    console.log(''); // Empty line
+
+    const { choice } = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'choice',
+            message: i18next.t('menu.prompt'),
+            validate: (input) => {
+                if (input === '0') return true;
+                const index = parseInt(input);
+                if (index >= 1 && index <= languages.length) {
+                    return true;
+                }
+                return 'Invalid selection.';
+            }
+        }
+    ]);
+
+    if (choice === '0') {
+        return;
+    }
+
+    const lang = languages[parseInt(choice) - 1].value;
+
+    saveConfig({ language: lang });
+    
+    await i18next.changeLanguage(lang);
+    
+    console.log(i18next.t('settings.saved'));
+}
+
 main();

package/src/locales/en.js

@@ -0,0 +1,46 @@
+export default {
+    menu: {
+        title: 'xw-devtool-cli Menu',
+        exit: 'Exit',
+        prompt: 'Please enter the feature key (0-9, a-z):',
+        invalid: 'Invalid selection. Please enter a valid menu key.',
+        bye: 'Bye!',
+        features: {
+            imgBase64: 'Image <-> Base64',
+            imgConvert: 'Image Format Convert',
+            placeholderImg: 'Placeholder Image Generator',
+            qrcode: 'QR Code Generator',
+            url: 'URL Encode/Decode',
+            base64: 'String Encode/Decode (Base64)',
+            unicode: 'Unicode Encode/Decode',
+            htmlEntities: 'HTML Entity Encode/Decode',
+            variableFormat: 'Variable Format Converter',
+            jsonFormat: 'JSON Format (Minify/Prettify)',
+            pinyin: 'Chinese to Pinyin',
+            timeFormat: 'Time Format / Timestamp',
+            timeCalc: 'Time Calculation (Diff/Offset)',
+            color: 'Color Converter (Hex <-> RGB)',
+            uuid: 'Get UUID',
+            hashing: 'Hash Calculator (MD5/SHA/SM3)',
+            mock: 'Mock Text',
+            specialChars: 'Special Characters (Symbols)',
+            emoji: 'Emoji Picker',
+            markdown: 'Markdown Snippets',
+            vscodeSnippet: 'VS Code Snippet Generator',
+            settings: 'Settings / Language'
+        }
+    },
+    settings: {
+        selectLanguage: 'Select Language',
+        saved: 'Language saved. Please restart the tool or continue using the menu.',
+        backToMenu: 'Back to Menu'
+    },
+    url: {
+        title: 'URL Encode/Decode',
+        encode: 'Encode',
+        decode: 'Decode',
+        inputPrompt: 'Enter URL to {{mode}}:',
+        result: 'Result:',
+        error: 'Error processing URL:'
+    }
+};

package/src/locales/zh.js

@@ -0,0 +1,46 @@
+export default {
+    menu: {
+        title: 'xw-devtool-cli 菜单',
+        exit: '退出',
+        prompt: '请输入功能键 (0-9, a-z):',
+        invalid: '无效选择，请输入有效的菜单键。',
+        bye: '再见！',
+        features: {
+            imgBase64: '图片 <-> Base64',
+            imgConvert: '图片格式转换',
+            placeholderImg: '占位图生成器',
+            qrcode: '二维码生成器',
+            url: 'URL 编码/解码',
+            base64: '字符串 编码/解码 (Base64)',
+            unicode: 'Unicode 编码/解码',
+            htmlEntities: 'HTML 实体 编码/解码',
+            variableFormat: '变量命名格式转换',
+            jsonFormat: 'JSON 格式化 (压缩/美化)',
+            pinyin: '汉字转拼音',
+            timeFormat: '时间格式化 / 时间戳',
+            timeCalc: '时间计算 (差值/偏移)',
+            color: '颜色转换 (Hex <-> RGB)',
+            uuid: '生成 UUID',
+            hashing: '哈希计算 (MD5/SHA/SM3)',
+            mock: 'Mock 文本生成',
+            specialChars: '特殊字符 (符号)',
+            emoji: 'Emoji 选择器',
+            markdown: 'Markdown 片段',
+            vscodeSnippet: 'VS Code 代码片段生成',
+            settings: '设置 / 语言 (Settings)'
+        }
+    },
+    settings: {
+        selectLanguage: '选择语言',
+        saved: '语言已保存。请继续使用。',
+        backToMenu: '返回主菜单'
+    },
+    url: {
+        title: 'URL 编码/解码',
+        encode: '编码',
+        decode: '解码',
+        inputPrompt: '请输入要{{mode}}的 URL:',
+        result: '结果:',
+        error: '处理 URL 时出错:'
+    }
+};

package/src/utils/config.js

@@ -0,0 +1,29 @@
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+
+const CONFIG_FILE = path.join(os.homedir(), '.xw-devtool-cli-config.json');
+
+export function loadConfig() {
+    try {
+        if (fs.existsSync(CONFIG_FILE)) {
+            const data = fs.readFileSync(CONFIG_FILE, 'utf8');
+            return JSON.parse(data);
+        }
+    } catch (e) {
+        // Ignore errors
+    }
+    return {};
+}
+
+export function saveConfig(config) {
+    try {
+        const current = loadConfig();
+        const newConfig = { ...current, ...config };
+        fs.writeFileSync(CONFIG_FILE, JSON.stringify(newConfig, null, 2), 'utf8');
+        return true;
+    } catch (e) {
+        console.error('Failed to save config:', e);
+        return false;
+    }
+}