xw-devtool-cli 1.0.42 → 1.0.43

package/README.md

@@ -4,7 +4,7 @@
 
 一个基于 Node.js 的开发者命令行工具箱，旨在提供开箱即用的常用开发工具，帮助开发者快速处理日常任务。
 
-主要功能包括：Base64 编解码、图片格式转换、图片与 Base64 互转、Mock 数据生成、时间戳/日期格式化、时间计算、URL 编解码、UUID 生成、汉字转拼音、颜色转换、变量格式转换、哈希计算、二维码生成、特殊符号大全、Markdown 语法工具、VS Code 代码段生成、当前目录树生成等。大部分结果可一键复制到剪贴板，极大提升开发效率。
+主要功能包括：Base64 编解码、图片格式转换、图片与 Base64 互转、Mock 数据生成、时间戳/日期格式化、时间计算、URL 编解码、UUID 生成、汉字转拼音、颜色转换、变量格式转换、哈希计算、二维码生成、二维码识别、特殊符号大全、Markdown 语法工具、VS Code 代码段生成、当前目录树生成等。大部分结果可一键复制到剪贴板，极大提升开发效率。
 
 ## ✨ 功能特性
 
@@ -46,6 +46,7 @@
   - **变量格式转换**：支持 CamelCase, PascalCase, SnakeCase, KebabCase, ConstantCase 互转。
   - **哈希计算**：支持 MD5, SHA1, SHA256, SHA512, SM3 算法。
   - **二维码生成**：终端直接显示二维码，支持保存为 PNG 图片（带时间戳文件名）。
+  - **二维码识别**：支持选择二维码图片进行识别，识别结果自动复制到剪贴板。
   - **特殊符号大全**：包含常用符号、箭头、数学符号、货币、希腊字母等 170+ 个符号，支持一键复制。
   - **Emoji 输入**：支持分类查看和选择常用 Emoji，一键复制到剪贴板。
   - **HTML 实体工具**：支持 HTML 实体编码与解码 (如 `&` <-> `&amp;`)。
@@ -208,6 +209,13 @@ x. 设置 / 语言 (Settings)
 - 输入文本或 URL（支持直接回车读取剪贴板）。
 - 终端直接显示二维码预览。
 - 可选保存为 PNG 图片，默认文件名包含时间戳。
+
+### 二维码识别
+- 选择 `qrcodeDecode`（菜单对应数字/字母）进入。
+- 支持两种图片输入方式：
+  - **选择文件（对话框）**
+  - **手动输入文件路径**
+- 自动识别二维码内容并复制到剪贴板。
 
 ### 5. URL 编解码
 - 选择 `5` 进入。
@@ -346,7 +354,7 @@ x. 设置 / 语言 (Settings)
 
 A Node.js-based developer command-line toolbox designed to provide out-of-the-box common development tools to help developers handle daily tasks quickly.
 
-Key features include: Base64 encoding/decoding, image format conversion, image <-> Base64, Mock data generation, timestamp/date formatting, time calculation, URL encoding/decoding, UUID generation, Chinese pinyin conversion, color conversion, variable format conversion, hash calculation, QR code generation, special symbols, Markdown snippets, VS Code snippet generation, etc. All results are automatically copied to the clipboard, greatly improving development efficiency.
+Key features include: Base64 encoding/decoding, image format conversion, image <-> Base64, Mock data generation, timestamp/date formatting, time calculation, URL encoding/decoding, UUID generation, Chinese pinyin conversion, color conversion, variable format conversion, hash calculation, QR code generation, QR code recognition, special symbols, Markdown snippets, VS Code snippet generation, current directory tree generation, etc. Most results can be copied to the clipboard in one step, greatly improving development efficiency.
 
 ### ✨ Features
 
@@ -381,6 +389,7 @@ Key features include: Base64 encoding/decoding, image format conversion, image <
   - **Variable Format**: CamelCase, PascalCase, SnakeCase, KebabCase, ConstantCase.
   - **Hash Calculator**: MD5, SHA1, SHA256, SHA512, SM3.
   - **QR Code**: Display QR codes in terminal, save as PNG.
+  - **QR Code Reader**: Select an image with QR code and decode content, then copy the result to clipboard automatically.
   - **Special Symbols**: 170+ symbols, arrows, math symbols, etc.
   - **Emoji Picker**: Browse and copy emojis.
   - **HTML Entity**: Encode/Decode HTML entities.
@@ -494,6 +503,13 @@ You can enter a feature key directly, or type a keyword (e.g. `json`, `image`, `
 - Input text or URL.
 - Preview in terminal.
 - Option to save as PNG.
+
+#### QR Code Reader
+- Select `qrcodeDecode` (menu key).
+- Image input methods:
+  - **Select file (dialog)**
+  - **Enter file path manually**
+- Decode content and copy it to clipboard automatically.
 
 #### 5. URL Encode/Decode
 - Select `5`.

package/README_EN.md

@@ -4,7 +4,7 @@
 
 A Node.js-based developer command-line toolbox designed to provide out-of-the-box common development tools to help developers handle daily tasks quickly.
 
-Key features include: Base64 encoding/decoding, image format conversion, image <-> Base64, Mock data generation, timestamp/date formatting, time calculation, URL encoding/decoding, UUID generation, Chinese pinyin conversion, color conversion, variable format conversion, hash calculation, QR code generation, special symbols, Markdown snippets, VS Code snippet generation, current directory tree generation, etc. Most results can be copied to the clipboard in one step, greatly improving development efficiency.
+Key features include: Base64 encoding/decoding, image format conversion, image <-> Base64, Mock data generation, timestamp/date formatting, time calculation, URL encoding/decoding, UUID generation, Chinese pinyin conversion, color conversion, variable format conversion, hash calculation, QR code generation, QR code recognition, special symbols, Markdown snippets, VS Code snippet generation, current directory tree generation, etc. Most results can be copied to the clipboard in one step, greatly improving development efficiency.
 
 ## ✨ Features
 
@@ -40,6 +40,7 @@ Key features include: Base64 encoding/decoding, image format conversion, image <
   - **Variable Format**: CamelCase, PascalCase, SnakeCase, KebabCase, ConstantCase.
   - **Hash Calculator**: MD5, SHA1, SHA256, SHA512, SM3.
   - **QR Code**: Display QR codes in terminal, save as PNG.
+  - **QR Code Reader**: Select a QR code image and recognize the content, then copy the result to clipboard.
   - **Special Symbols**: 170+ symbols, arrows, math symbols, etc.
   - **Emoji Picker**: Browse and copy emojis.
   - **HTML Entity**: Encode/Decode HTML entities.
@@ -160,6 +161,13 @@ s. Settings (Language)
 - Preview in terminal.
 - Option to save as PNG.
 
+### QR Code Reader
+- Select `qrcodeDecode` (menu key).
+- Supports two input methods:
+  - **Select file (dialog)**
+  - **Enter file path manually**
+- Recognized content is copied to clipboard automatically.
+
 ### 5. URL Encode/Decode
 - Select `5`.
 - Select `Encode` or `Decode`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xw-devtool-cli",
-  "version": "1.0.42",
+  "version": "1.0.43",
   "type": "module",
   "description": "基于node的开发者助手cli",
   "main": "index.js",
@@ -42,6 +42,8 @@
     "png",
     "placeholder-image",
     "qrcode",
+    "qr-code-reader",
+    "qr-decoder",
     "json-format",
     "json-formatter",
     "variable-case",
@@ -87,6 +89,7 @@
     "he": "^1.2.0",
     "i18next": "^25.7.3",
     "inquirer": "^13.1.0",
+    "jsqr": "^1.4.0",
     "lorem-ipsum": "^2.0.8",
     "pinyin": "^4.0.0",
     "qrcode": "^1.5.4",

package/src/commands/qrcodeDecode.js

@@ -0,0 +1,76 @@
+import fs from 'fs';
+import inquirer from 'inquirer';
+import jsQR from 'jsqr';
+import sharp from 'sharp';
+import i18next from '../i18n.js';
+import { selectFile } from '../utils/fileDialog.js';
+import { selectFromMenu } from '../utils/menu.js';
+import { outputText } from '../utils/output.js';
+
+async function getImagePath() {
+    const method = await selectFromMenu(
+        i18next.t('qrcodeDecode.selectInputMethod'),
+        [
+            { name: i18next.t('qrcodeDecode.inputDialog'), value: 'dialog' },
+            { name: i18next.t('qrcodeDecode.inputManual'), value: 'manual' }
+        ],
+        true,
+        i18next.t('common.back')
+    );
+    if (method === '__BACK__') {
+        return null;
+    }
+
+    let imagePath = '';
+    if (method === 'dialog') {
+        imagePath = selectFile('Image Files|*.png;*.jpg;*.jpeg;*.gif;*.bmp;*.webp|All Files|*.*') || '';
+        if (!imagePath) {
+            console.log(i18next.t('qrcodeDecode.dialogUnavailable'));
+        }
+    }
+
+    if (!imagePath) {
+        const answer = await inquirer.prompt([
+            {
+                type: 'input',
+                name: 'path',
+                message: i18next.t('qrcodeDecode.enterPath'),
+                validate: (value) => (fs.existsSync(value) ? true : i18next.t('qrcodeDecode.notExist'))
+            }
+        ]);
+        imagePath = answer.path;
+    }
+
+    return imagePath;
+}
+
+async function decodeQRCodeFromImage(imagePath) {
+    const { data, info } = await sharp(imagePath)
+        .rotate()
+        .ensureAlpha()
+        .raw()
+        .toBuffer({ resolveWithObject: true });
+    const pixelData = new Uint8ClampedArray(data);
+    const result = jsQR(pixelData, info.width, info.height, { inversionAttempts: 'attemptBoth' });
+    return result ? result.data : '';
+}
+
+export async function qrcodeDecodeHandler() {
+    const imagePath = await getImagePath();
+    if (!imagePath) {
+        return;
+    }
+
+    try {
+        const decoded = await decodeQRCodeFromImage(imagePath);
+        if (!decoded) {
+            console.log(i18next.t('qrcodeDecode.notFound'));
+            return;
+        }
+        await outputText(decoded, { showPreview: false, copyToClipboard: true });
+        console.log(i18next.t('qrcodeDecode.success'));
+        console.log(`${i18next.t('qrcodeDecode.result')}\n${decoded}\n`);
+    } catch (error) {
+        console.error(i18next.t('qrcodeDecode.decodeFail', { message: error.message }));
+    }
+}

package/src/index.js

@@ -23,6 +23,7 @@ import { variableFormatHandler } from './commands/variableFormat.js';
 import { jsonFormatHandler } from './commands/jsonFormat.js';
 import { hashingHandler } from './commands/hashing.js';
 import { qrcodeHandler } from './commands/qrcode.js';
+import { qrcodeDecodeHandler } from './commands/qrcodeDecode.js';
 import { specialCharsHandler } from './commands/specialChars.js';
 import { emojiHandler } from './commands/emoji.js';
 import { htmlEntitiesHandler } from './commands/htmlEntities.js';
@@ -68,6 +69,7 @@ function getFeatures() {
         { name: i18next.t('menu.features.imgCompress'), value: 'imgCompress' },
         { name: i18next.t('menu.features.placeholderImg'), value: 'placeholderImg' },
         { name: i18next.t('menu.features.qrcode'), value: 'qrcode' },
+        { name: i18next.t('menu.features.qrcodeDecode'), value: 'qrcodeDecode' },
         
         // Encode/Decode & Formatting
         { name: i18next.t('menu.features.url'), value: 'url' },
@@ -336,6 +338,9 @@ async function handleAction(action) {
         case 'qrcode':
             await qrcodeHandler();
             break;
+        case 'qrcodeDecode':
+            await qrcodeDecodeHandler();
+            break;
         case 'specialChars':
             await specialCharsHandler();
             break;

package/src/locales/en.js

@@ -50,6 +50,7 @@ export default {
             imgCompress: 'Image Compression',
             placeholderImg: 'Placeholder Image Generator',
             qrcode: 'QR Code Generator',
+            qrcodeDecode: 'QR Code Reader',
             url: 'URL Encode/Decode',
             baseConvert: 'Number Base Converter',
             base64: 'String Encode/Decode (Base64)',
@@ -110,6 +111,18 @@ export default {
         y2Prompt: 'Enter Y2 (px or %):',
         result: 'Picked Color'
     },
+    qrcodeDecode: {
+        selectInputMethod: 'Select QR image input method',
+        inputDialog: 'Select file (dialog)',
+        inputManual: 'Enter file path manually',
+        dialogUnavailable: 'File dialog is unavailable or canceled. Please enter the file path manually.',
+        enterPath: 'Enter QR code image path:',
+        notExist: 'File does not exist.',
+        notFound: 'No QR code detected. Please make sure the image is clear and contains a QR code.',
+        success: 'Recognition completed. Content copied to clipboard.',
+        result: 'Recognized content:',
+        decodeFail: 'Failed to decode QR code: {{message}}'
+    },
     url: {
         title: 'URL Encode/Decode',
         encode: 'Encode',

package/src/locales/zh.js

@@ -50,6 +50,7 @@ export default {
             imgCompress: '图片压缩',
             placeholderImg: '占位图生成器',
             qrcode: '二维码生成器',
+            qrcodeDecode: '二维码识别',
             url: 'URL 编码/解码',
             baseConvert: '进制转换工具',
             base64: '字符串 编码/解码 (Base64)',
@@ -110,6 +111,18 @@ export default {
         y2Prompt: '输入 Y2（px 或 %）:',
         result: '吸取结果'
     },
+    qrcodeDecode: {
+        selectInputMethod: '选择二维码图片输入方式',
+        inputDialog: '选择文件（对话框）',
+        inputManual: '手动输入文件路径',
+        dialogUnavailable: '文件对话框不可用或已取消，请手动输入文件路径。',
+        enterPath: '请输入二维码图片路径:',
+        notExist: '文件不存在。',
+        notFound: '未识别到二维码，请确认图片清晰且包含二维码。',
+        success: '识别完成，内容已复制到剪贴板。',
+        result: '识别结果:',
+        decodeFail: '二维码识别失败: {{message}}'
+    },
     url: {
         title: 'URL 编码/解码',
         encode: '编码',