xw-devtool-cli 1.0.16 → 1.0.17

package/README.md

@@ -1,5 +1,7 @@
 # xw-devtool-cli
 
+**中文** | [English Documentation](./README_EN.md)
+
 一个基于 Node.js 的开发者命令行工具箱，旨在提供开箱即用的常用开发工具，帮助开发者快速处理日常任务。
 
 主要功能包括：Base64 编解码、图片格式转换、图片与 Base64 互转、Mock 数据生成、时间戳/日期格式化、时间计算、URL 编解码、UUID 生成、汉字转拼音、颜色转换、变量格式转换、哈希计算、二维码生成、特殊符号大全、Markdown 语法工具、VS Code 代码段生成等。所有结果均自动复制到剪贴板，极大提升开发效率。
@@ -38,6 +40,9 @@
   - 结果自动复制到剪贴板。
   - 支持从剪贴板自动读取输入（部分工具支持直接回车读取）。
   - 支持将大文本结果保存为文件。
+- **多语言支持 (i18n)**：
+  - 支持 **中文** 和 **English**。
+  - 可通过菜单中的 `Settings` 切换，或使用命令行参数：`xw-devtool --zh` / `xw-devtool --en`。
 
 ## 📦 安装
 
@@ -59,6 +64,12 @@ npx xw-devtool-cli@latest
 xw-devtool
 ```
 
+或者指定语言启动：
+```bash
+xw-devtool --zh  # 中文启动
+xw-devtool --en  # 英文启动 (Start in English)
+```
+
 启动后将显示交互式菜单，通过键盘输入对应的数字或字母选择功能：
 
 ```text
@@ -86,6 +97,7 @@ i. Special Characters (Symbols)
 j. Emoji Picker
 k. Markdown Snippets
 l. VS Code Snippet Generator
+s. Settings (Language)
 0. Exit
 =================================
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xw-devtool-cli",
-  "version": "1.0.16",
+  "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/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';
@@ -23,13 +26,13 @@ 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);
@@ -37,41 +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' },
-    { name: 'VS Code Snippet Generator', value: 'vscodeSnippet' }
-];
+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();
         });
@@ -97,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;
                 
@@ -118,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);
     }
 
@@ -137,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();
 }
 
@@ -183,6 +195,7 @@ async function handleAction(action) {
         case 'jsonFormat':
             await jsonFormatHandler();
             break;
+            
         case 'hashing':
             await hashingHandler();
             break;
@@ -207,9 +220,54 @@ async function handleAction(action) {
         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;
+    }
+}