xw-devtool-cli 1.0.42 → 1.0.44

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 代码段生成、当前目录树生成等。大部分结果可一键复制到剪贴板，极大提升开发效率。
 
 ## ✨ 功能特性
 
@@ -35,6 +35,9 @@
   - **时间格式化**：时间戳/日期字符串 -> `YYYY-MM-DD HH:mm:ss`。
   - **获取时间戳**：快速获取当前毫秒级时间戳。
   - **时间计算**：计算日期差值或日期偏移 (Add/Subtract)。
+  - **控制台时钟**：在终端实时显示当前时间，按 `Enter` 或 `Q` 返回上一步。
+  - **倒计时工具**：输入倒计时分钟数后启动终端倒计时；倒计时结束后继续计时并显示负号（如 `-00:00:05`）。
+  - **计时工具**：启动后从 `00:00:00` 开始正向计时，终端每秒刷新显示。
 - **开发辅助工具**：
   - **URL 编解码**：Encode/Decode URL。
   - **Unicode 编解码**：文本与 Unicode 转义序列 (\uXXXX) 互转。
@@ -46,6 +49,7 @@
   - **变量格式转换**：支持 CamelCase, PascalCase, SnakeCase, KebabCase, ConstantCase 互转。
   - **哈希计算**：支持 MD5, SHA1, SHA256, SHA512, SM3 算法。
   - **二维码生成**：终端直接显示二维码，支持保存为 PNG 图片（带时间戳文件名）。
+  - **二维码识别**：支持选择二维码图片进行识别，识别结果自动复制到剪贴板。
   - **特殊符号大全**：包含常用符号、箭头、数学符号、货币、希腊字母等 170+ 个符号，支持一键复制。
   - **Emoji 输入**：支持分类查看和选择常用 Emoji，一键复制到剪贴板。
   - **HTML 实体工具**：支持 HTML 实体编码与解码 (如 `&` <-> `&amp;`)。
@@ -209,6 +213,13 @@ x. 设置 / 语言 (Settings)
 - 终端直接显示二维码预览。
 - 可选保存为 PNG 图片，默认文件名包含时间戳。
 
+### 二维码识别
+- 选择 `qrcodeDecode`（菜单对应数字/字母）进入。
+- 支持两种图片输入方式：
+  - **选择文件（对话框）**
+  - **手动输入文件路径**
+- 自动识别二维码内容并复制到剪贴板。
+
 ### 5. URL 编解码
 - 选择 `5` 进入。
 - 选择 `Encode` (编码) 或 `Decode` (解码)。
@@ -283,6 +294,22 @@ x. 设置 / 语言 (Settings)
     5. 查看计算后的新日期。
   - 示例：计算 "当前时间 3 天后" 或 "2025-01-01 5 小时前"。
 
+### 控制台时钟
+- 在菜单中选择 `控制台时钟` 进入。
+- 终端会每秒刷新显示当前时间。
+- 按 `Enter` 或 `Q` 返回上一步。
+
+### 倒计时工具
+- 在菜单中选择 `倒计时工具` 进入。
+- 输入倒计时分钟数后，终端会每秒刷新倒计时。
+- 倒计时结束后会继续计时并显示负号（如 `-00:00:01`、`-00:00:02`）。
+- 按 `Enter` 或 `Q` 返回上一步。
+
+### 计时工具
+- 在菜单中选择 `计时工具` 进入。
+- 启动后从 `00:00:00` 开始，终端每秒刷新已计时时间。
+- 按 `Enter` 或 `Q` 返回上一步。
+
 ### 14. 颜色转换 (Hex <-> RGB)
 - 选择 `e` 进入。
 - 输入 Hex 颜色值 (如 #333) 或 RGB 值 (如 rgb(51,51,51))。
@@ -346,7 +373,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, console clock, countdown timer, stopwatch, 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
 
@@ -372,6 +399,9 @@ Key features include: Base64 encoding/decoding, image format conversion, image <
   - **Formatting**: Timestamp/Date string -> `YYYY-MM-DD HH:mm:ss`.
   - **Timestamp**: Quickly get current millisecond timestamp.
   - **Calculation**: Calculate date differences or offsets (Add/Subtract).
+  - **Console Clock**: Show real-time current time in terminal, press `Enter` or `Q` to go back.
+  - **Countdown Timer**: Enter countdown minutes to start timer; once it reaches zero, it keeps counting with a negative sign (such as `-00:00:05`).
+  - **Stopwatch**: Start from `00:00:00` and count up every second in terminal.
 - **Dev Tools**:
   - **URL Encode/Decode**
   - **Unicode Encode/Decode**: Text <-> Unicode escape sequences (\uXXXX).
@@ -381,6 +411,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.
@@ -495,6 +526,13 @@ You can enter a feature key directly, or type a keyword (e.g. `json`, `image`, `
 - 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`.
 - Select `Encode` or `Decode`.
@@ -547,6 +585,22 @@ You can enter a feature key directly, or type a keyword (e.g. `json`, `image`, `
 - **Diff**: Calculate difference between two dates.
 - **Offset**: Calculate date after add/subtract time units.
 
+#### Console Clock
+- Select `Console Clock` in the menu.
+- Current time refreshes every second in terminal.
+- Press `Enter` or `Q` to go back.
+
+#### Countdown Timer
+- Select `Countdown Timer` in the menu.
+- Enter minutes to start the countdown.
+- After reaching zero, the timer continues with a negative sign (for example `-00:00:01`).
+- Press `Enter` or `Q` to go back.
+
+#### Stopwatch
+- Select `Stopwatch` in the menu.
+- It starts from `00:00:00` and updates every second.
+- Press `Enter` or `Q` to go back.
+
 #### 14. Color Converter
 - Select `e`.
 - Hex <-> RGB.

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, console clock, countdown timer, stopwatch, 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
 
@@ -29,6 +29,9 @@ Key features include: Base64 encoding/decoding, image format conversion, image <
   - **Formatting**: Timestamp/Date string -> `YYYY-MM-DD HH:mm:ss`.
   - **Timestamp**: Quickly get current millisecond timestamp.
   - **Calculation**: Calculate date differences or offsets (Add/Subtract).
+  - **Console Clock**: Show real-time current time in terminal, press `Enter` or `Q` to go back.
+  - **Countdown Timer**: Enter countdown minutes to start timer; once it reaches zero, it keeps counting with a negative sign (such as `-00:00:05`).
+  - **Stopwatch**: Start from `00:00:00` and count up every second in terminal.
 - **Dev Tools**:
   - **URL Encode/Decode**
   - **Unicode Encode/Decode**: Text <-> Unicode escape sequences (\uXXXX).
@@ -40,6 +43,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 +164,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`.
@@ -216,6 +227,22 @@ s. Settings (Language)
 - **Diff**: Calculate difference between two dates.
 - **Offset**: Calculate date after add/subtract time units.
 
+### Console Clock
+- Select `Console Clock` in the menu.
+- Current time refreshes every second in terminal.
+- Press `Enter` or `Q` to go back.
+
+### Countdown Timer
+- Select `Countdown Timer` in the menu.
+- Enter minutes to start the countdown.
+- After reaching zero, the timer continues with a negative sign (for example `-00:00:01`).
+- Press `Enter` or `Q` to go back.
+
+### Stopwatch
+- Select `Stopwatch` in the menu.
+- It starts from `00:00:00` and updates every second.
+- Press `Enter` or `Q` to go back.
+
 ### 14. Color Converter
 - Select `e`.
 - Hex <-> RGB.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xw-devtool-cli",
-  "version": "1.0.42",
+  "version": "1.0.44",
   "type": "module",
   "description": "基于node的开发者助手cli",
   "main": "index.js",
@@ -34,6 +34,12 @@
     "mock-data",
     "timestamp",
     "time",
+    "clock",
+    "console-clock",
+    "countdown",
+    "countdown-timer",
+    "stopwatch",
+    "stopwatch-timer",
     "date-calculation",
     "image",
     "image-conversion",
@@ -42,6 +48,8 @@
     "png",
     "placeholder-image",
     "qrcode",
+    "qr-code-reader",
+    "qr-decoder",
     "json-format",
     "json-formatter",
     "variable-case",
@@ -87,6 +95,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/clock.js

@@ -0,0 +1,135 @@
+import readline from 'readline';
+import i18next from '../i18n.js';
+
+function getLocale() {
+    return i18next.language && i18next.language.toLowerCase().startsWith('zh') ? 'zh-CN' : 'en-US';
+}
+
+function getNowDisplay(locale) {
+    const now = new Date();
+    const timeText = new Intl.DateTimeFormat(locale, {
+        hour12: false,
+        hour: '2-digit',
+        minute: '2-digit',
+        second: '2-digit'
+    }).format(now);
+    const dateText = new Intl.DateTimeFormat(locale, {
+        year: 'numeric',
+        month: '2-digit',
+        day: '2-digit',
+        weekday: 'long'
+    }).format(now);
+    return { timeText, dateText };
+}
+
+function getCharDisplayWidth(char) {
+    if (/[\u0000-\u001f\u007f]/.test(char)) {
+        return 0;
+    }
+    if (
+        /[\u1100-\u115f\u2329\u232a\u2e80-\u303e\u3040-\ua4cf\uac00-\ud7a3\uf900-\ufaff\ufe10-\ufe19\ufe30-\ufe6f\uff00-\uff60\uffe0-\uffe6]/.test(char)
+    ) {
+        return 2;
+    }
+    return 1;
+}
+
+function getDisplayWidth(text) {
+    let width = 0;
+    for (const char of text) {
+        width += getCharDisplayWidth(char);
+    }
+    return width;
+}
+
+function fitText(text, width) {
+    let result = '';
+    let currentWidth = 0;
+    for (const char of text) {
+        const charWidth = getCharDisplayWidth(char);
+        if (currentWidth + charWidth > width) {
+            break;
+        }
+        result += char;
+        currentWidth += charWidth;
+    }
+    const remaining = width - getDisplayWidth(result);
+    if (remaining > 0) {
+        return `${result}${' '.repeat(remaining)}`;
+    }
+    return result;
+}
+
+function renderClockBlock() {
+    const { timeText, dateText } = getNowDisplay(getLocale());
+    const innerWidth = 34;
+    const top = `┌${'─'.repeat(innerWidth + 2)}┐`;
+    const bottom = `└${'─'.repeat(innerWidth + 2)}┘`;
+    const line = (text) => `│ ${fitText(text, innerWidth)} │`;
+    return [
+        top,
+        line(i18next.t('clock.title')),
+        line(''),
+        line(`${i18next.t('clock.now')}${timeText}`),
+        line(dateText),
+        line(i18next.t('clock.exitTip')),
+        bottom
+    ];
+}
+
+export async function clockHandler() {
+    if (!process.stdin.isTTY || !process.stdout.isTTY) {
+        const { timeText, dateText } = getNowDisplay(getLocale());
+        console.log(`${i18next.t('clock.now')}${timeText} (${dateText})`);
+        return;
+    }
+
+    await new Promise((resolve) => {
+        let renderedLineCount = 0;
+        let shouldExitApp = false;
+
+        const render = () => {
+            const lines = renderClockBlock();
+            if (renderedLineCount > 0) {
+                readline.moveCursor(process.stdout, 0, -renderedLineCount);
+                readline.cursorTo(process.stdout, 0);
+                readline.clearScreenDown(process.stdout);
+            }
+            process.stdout.write(`${lines.join('\n')}\n`);
+            renderedLineCount = lines.length;
+        };
+
+        const cleanup = () => {
+            clearInterval(timer);
+            process.stdin.off('data', onData);
+            process.stdin.setRawMode(false);
+            process.stdin.pause();
+            readline.cursorTo(process.stdout, 0);
+            readline.clearScreenDown(process.stdout);
+            process.stdout.write('\n');
+            if (shouldExitApp) {
+                console.log(i18next.t('menu.bye'));
+                process.exit(0);
+            }
+            resolve();
+        };
+
+        const onData = (chunk) => {
+            const key = chunk.toString().toLowerCase();
+            if (key === '0') {
+                shouldExitApp = true;
+                cleanup();
+                return;
+            }
+            if (key === '\r' || key === 'q' || key === '\u0003') {
+                cleanup();
+            }
+        };
+
+        const timer = setInterval(render, 1000);
+        process.stdin.setRawMode(true);
+        process.stdin.resume();
+        process.stdin.on('data', onData);
+        render();
+    });
+}

package/src/commands/countdown.js

@@ -0,0 +1,159 @@
+import inquirer from 'inquirer';
+import readline from 'readline';
+import i18next from '../i18n.js';
+
+function getCharDisplayWidth(char) {
+    if (/[\u0000-\u001f\u007f]/.test(char)) {
+        return 0;
+    }
+    if (
+        /[\u1100-\u115f\u2329\u232a\u2e80-\u303e\u3040-\ua4cf\uac00-\ud7a3\uf900-\ufaff\ufe10-\ufe19\ufe30-\ufe6f\uff00-\uff60\uffe0-\uffe6]/.test(char)
+    ) {
+        return 2;
+    }
+    return 1;
+}
+
+function getDisplayWidth(text) {
+    let width = 0;
+    for (const char of text) {
+        width += getCharDisplayWidth(char);
+    }
+    return width;
+}
+
+function fitText(text, width) {
+    let result = '';
+    let currentWidth = 0;
+    for (const char of text) {
+        const charWidth = getCharDisplayWidth(char);
+        if (currentWidth + charWidth > width) {
+            break;
+        }
+        result += char;
+        currentWidth += charWidth;
+    }
+    const remaining = width - getDisplayWidth(result);
+    if (remaining > 0) {
+        return `${result}${' '.repeat(remaining)}`;
+    }
+    return result;
+}
+
+function formatSeconds(seconds) {
+    const isNegative = seconds < 0;
+    const absSeconds = Math.abs(seconds);
+    const hours = Math.floor(absSeconds / 3600);
+    const minutes = Math.floor((absSeconds % 3600) / 60);
+    const secs = absSeconds % 60;
+    const sign = isNegative ? '-' : '';
+    return `${sign}${String(hours).padStart(2, '0')}:${String(minutes).padStart(2, '0')}:${String(secs).padStart(2, '0')}`;
+}
+
+function parseMinutes(input) {
+    const value = Number(input);
+    if (!Number.isFinite(value) || value < 0) {
+        return null;
+    }
+    return value;
+}
+
+function renderCountdownBlock(totalSeconds, elapsedSeconds) {
+    const remainSeconds = totalSeconds - elapsedSeconds;
+    const innerWidth = 34;
+    const top = `┌${'─'.repeat(innerWidth + 2)}┐`;
+    const bottom = `└${'─'.repeat(innerWidth + 2)}┘`;
+    const line = (text) => `│ ${fitText(text, innerWidth)} │`;
+    const status = remainSeconds < 0 ? i18next.t('countdown.statusOvertime') : i18next.t('countdown.statusCounting');
+
+    return [
+        top,
+        line(i18next.t('countdown.title')),
+        line(''),
+        line(`${i18next.t('countdown.remaining')}${formatSeconds(remainSeconds)}`),
+        line(`${i18next.t('countdown.total')}${formatSeconds(totalSeconds)}`),
+        line(`${i18next.t('countdown.status')}${status}`),
+        line(i18next.t('countdown.exitTip')),
+        bottom
+    ];
+}
+
+export async function countdownHandler() {
+    const { minutesInput } = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'minutesInput',
+            message: i18next.t('countdown.inputPrompt'),
+            default: '1',
+            validate: (input) => {
+                const value = parseMinutes(input);
+                if (value === null) {
+                    return i18next.t('countdown.invalidMinutes');
+                }
+                return true;
+            }
+        }
+    ]);
+
+    const minutes = parseMinutes(minutesInput);
+    const totalSeconds = Math.round(minutes * 60);
+
+    if (!process.stdin.isTTY || !process.stdout.isTTY) {
+        console.log(i18next.t('countdown.nonTtyTip', { value: formatSeconds(totalSeconds) }));
+        return;
+    }
+
+    await new Promise((resolve) => {
+        let renderedLineCount = 0;
+        let elapsedSeconds = 0;
+        let shouldExitApp = false;
+
+        const render = () => {
+            const lines = renderCountdownBlock(totalSeconds, elapsedSeconds);
+            if (renderedLineCount > 0) {
+                readline.moveCursor(process.stdout, 0, -renderedLineCount);
+                readline.cursorTo(process.stdout, 0);
+                readline.clearScreenDown(process.stdout);
+            }
+            process.stdout.write(`${lines.join('\n')}\n`);
+            renderedLineCount = lines.length;
+        };
+
+        const cleanup = () => {
+            clearInterval(timer);
+            process.stdin.off('data', onData);
+            process.stdin.setRawMode(false);
+            process.stdin.pause();
+            readline.cursorTo(process.stdout, 0);
+            readline.clearScreenDown(process.stdout);
+            process.stdout.write('\n');
+            if (shouldExitApp) {
+                console.log(i18next.t('menu.bye'));
+                process.exit(0);
+            }
+            resolve();
+        };
+
+        const onData = (chunk) => {
+            const key = chunk.toString().toLowerCase();
+            if (key === '0') {
+                shouldExitApp = true;
+                cleanup();
+                return;
+            }
+            if (key === '\r' || key === 'q' || key === '\u0003') {
+                cleanup();
+            }
+        };
+
+        const timer = setInterval(() => {
+            elapsedSeconds += 1;
+            render();
+        }, 1000);
+
+        process.stdin.setRawMode(true);
+        process.stdin.resume();
+        process.stdin.on('data', onData);
+        render();
+    });
+}

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

@@ -0,0 +1,125 @@
+import readline from 'readline';
+import i18next from '../i18n.js';
+
+function getCharDisplayWidth(char) {
+    if (/[\u0000-\u001f\u007f]/.test(char)) {
+        return 0;
+    }
+    if (
+        /[\u1100-\u115f\u2329\u232a\u2e80-\u303e\u3040-\ua4cf\uac00-\ud7a3\uf900-\ufaff\ufe10-\ufe19\ufe30-\ufe6f\uff00-\uff60\uffe0-\uffe6]/.test(char)
+    ) {
+        return 2;
+    }
+    return 1;
+}
+
+function getDisplayWidth(text) {
+    let width = 0;
+    for (const char of text) {
+        width += getCharDisplayWidth(char);
+    }
+    return width;
+}
+
+function fitText(text, width) {
+    let result = '';
+    let currentWidth = 0;
+    for (const char of text) {
+        const charWidth = getCharDisplayWidth(char);
+        if (currentWidth + charWidth > width) {
+            break;
+        }
+        result += char;
+        currentWidth += charWidth;
+    }
+    const remaining = width - getDisplayWidth(result);
+    if (remaining > 0) {
+        return `${result}${' '.repeat(remaining)}`;
+    }
+    return result;
+}
+
+function formatSeconds(seconds) {
+    const hours = Math.floor(seconds / 3600);
+    const minutes = Math.floor((seconds % 3600) / 60);
+    const secs = seconds % 60;
+    return `${String(hours).padStart(2, '0')}:${String(minutes).padStart(2, '0')}:${String(secs).padStart(2, '0')}`;
+}
+
+function renderStopwatchBlock(elapsedSeconds) {
+    const innerWidth = 34;
+    const top = `┌${'─'.repeat(innerWidth + 2)}┐`;
+    const bottom = `└${'─'.repeat(innerWidth + 2)}┘`;
+    const line = (text) => `│ ${fitText(text, innerWidth)} │`;
+
+    return [
+        top,
+        line(i18next.t('stopwatch.title')),
+        line(''),
+        line(`${i18next.t('stopwatch.elapsed')}${formatSeconds(elapsedSeconds)}`),
+        line(`${i18next.t('stopwatch.status')}${i18next.t('stopwatch.statusRunning')}`),
+        line(i18next.t('stopwatch.exitTip')),
+        bottom
+    ];
+}
+
+export async function stopwatchHandler() {
+    if (!process.stdin.isTTY || !process.stdout.isTTY) {
+        console.log(i18next.t('stopwatch.nonTtyTip'));
+        return;
+    }
+
+    await new Promise((resolve) => {
+        let renderedLineCount = 0;
+        let elapsedSeconds = 0;
+        let shouldExitApp = false;
+
+        const render = () => {
+            const lines = renderStopwatchBlock(elapsedSeconds);
+            if (renderedLineCount > 0) {
+                readline.moveCursor(process.stdout, 0, -renderedLineCount);
+                readline.cursorTo(process.stdout, 0);
+                readline.clearScreenDown(process.stdout);
+            }
+            process.stdout.write(`${lines.join('\n')}\n`);
+            renderedLineCount = lines.length;
+        };
+
+        const cleanup = () => {
+            clearInterval(timer);
+            process.stdin.off('data', onData);
+            process.stdin.setRawMode(false);
+            process.stdin.pause();
+            readline.cursorTo(process.stdout, 0);
+            readline.clearScreenDown(process.stdout);
+            process.stdout.write('\n');
+            if (shouldExitApp) {
+                console.log(i18next.t('menu.bye'));
+                process.exit(0);
+            }
+            resolve();
+        };
+
+        const onData = (chunk) => {
+            const key = chunk.toString().toLowerCase();
+            if (key === '0') {
+                shouldExitApp = true;
+                cleanup();
+                return;
+            }
+            if (key === '\r' || key === 'q' || key === '\u0003') {
+                cleanup();
+            }
+        };
+
+        const timer = setInterval(() => {
+            elapsedSeconds += 1;
+            render();
+        }, 1000);
+
+        process.stdin.setRawMode(true);
+        process.stdin.resume();
+        process.stdin.on('data', onData);
+        render();
+    });
+}

package/src/commands/url.js

@@ -7,7 +7,10 @@ export async function urlHandler() {
     const mode = await selectFromMenu(i18next.t('url.title'), [
         { name: i18next.t('url.encode'), value: 'encode' },
         { name: i18next.t('url.decode'), value: 'decode' }
-    ]);
+    ], true, i18next.t('common.back'));
+    if (mode === '__BACK__') {
+        return;
+    }
 
     const { input } = await inquirer.prompt([
         {

package/src/index.js

@@ -14,6 +14,9 @@ import { imgSplitHandler } from './commands/imgSplit.js';
 import { imgMergeHandler } from './commands/imgMerge.js';
 import { timeFormatHandler } from './commands/timeFormat.js';
 import { timeCalcHandler } from './commands/timeCalc.js';
+import { clockHandler } from './commands/clock.js';
+import { countdownHandler } from './commands/countdown.js';
+import { stopwatchHandler } from './commands/stopwatch.js';
 import { mockHandler } from './commands/mock.js';
 import { uuidHandler } from './commands/uuid.js';
 import { pinyinHandler } from './commands/pinyin.js';
@@ -23,6 +26,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 +72,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' },
@@ -82,6 +87,9 @@ function getFeatures() {
         // 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.clock'), value: 'clock' },
+        { name: i18next.t('menu.features.countdown'), value: 'countdown' },
+        { name: i18next.t('menu.features.stopwatch'), value: 'stopwatch' },
         { name: i18next.t('menu.features.color'), value: 'color' },
         { name: i18next.t('menu.features.colorPreview'), value: 'colorPreview' },
         { name: i18next.t('menu.features.uuid'), value: 'uuid' },
@@ -308,6 +316,15 @@ async function handleAction(action) {
         case 'timeCalc':
             await timeCalcHandler();
             break;
+        case 'clock':
+            await clockHandler();
+            break;
+        case 'countdown':
+            await countdownHandler();
+            break;
+        case 'stopwatch':
+            await stopwatchHandler();
+            break;
         case 'mock':
             await mockHandler();
             break;
@@ -336,6 +353,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)',
@@ -60,6 +61,9 @@ export default {
             pinyin: 'Chinese to Pinyin',
             timeFormat: 'Time Format / Timestamp',
             timeCalc: 'Time Calculation (Diff/Offset)',
+            clock: 'Console Clock',
+            countdown: 'Countdown Timer',
+            stopwatch: 'Stopwatch',
             color: 'Color Converter (Hex <-> RGB)',
             colorPreview: 'Color Preview',
             uuid: 'Get UUID',
@@ -110,6 +114,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',
@@ -118,6 +134,32 @@ export default {
         result: 'Result:',
         error: 'Error processing URL:'
     },
+    clock: {
+        title: 'Console Clock',
+        start: 'Console clock started. Press Enter / Q to go back.',
+        now: 'Current time: ',
+        exitTip: 'Press Enter / Q to go back, 0 to exit app'
+    },
+    countdown: {
+        title: 'Countdown Timer',
+        inputPrompt: 'Enter countdown minutes:',
+        invalidMinutes: 'Please enter a number greater than or equal to 0',
+        remaining: 'Remaining: ',
+        total: 'Total: ',
+        status: 'Status: ',
+        statusCounting: 'Counting down',
+        statusOvertime: 'Overtime',
+        exitTip: 'Press Enter / Q to go back, 0 to exit app',
+        nonTtyTip: 'Current terminal does not support dynamic countdown. Target duration: {{value}}'
+    },
+    stopwatch: {
+        title: 'Stopwatch',
+        elapsed: 'Elapsed: ',
+        status: 'Status: ',
+        statusRunning: 'Running',
+        exitTip: 'Press Enter / Q to go back, 0 to exit app',
+        nonTtyTip: 'Current terminal does not support dynamic stopwatch.'
+    },
     baseConvert: {
         inputPrompt: 'Enter number:',
         invalidInput: 'Please enter a valid number',

package/src/locales/zh.js

@@ -50,6 +50,7 @@ export default {
             imgCompress: '图片压缩',
             placeholderImg: '占位图生成器',
             qrcode: '二维码生成器',
+            qrcodeDecode: '二维码识别',
             url: 'URL 编码/解码',
             baseConvert: '进制转换工具',
             base64: '字符串 编码/解码 (Base64)',
@@ -60,6 +61,9 @@ export default {
             pinyin: '汉字转拼音',
             timeFormat: '时间格式化 / 时间戳',
             timeCalc: '时间计算 (差值/偏移)',
+            clock: '控制台时钟',
+            countdown: '倒计时工具',
+            stopwatch: '计时工具',
             color: '颜色转换 (Hex <-> RGB)',
             colorPreview: '颜色预览',
             uuid: '生成 UUID',
@@ -110,6 +114,18 @@ export default {
         y2Prompt: '输入 Y2（px 或 %）:',
         result: '吸取结果'
     },
+    qrcodeDecode: {
+        selectInputMethod: '选择二维码图片输入方式',
+        inputDialog: '选择文件（对话框）',
+        inputManual: '手动输入文件路径',
+        dialogUnavailable: '文件对话框不可用或已取消，请手动输入文件路径。',
+        enterPath: '请输入二维码图片路径:',
+        notExist: '文件不存在。',
+        notFound: '未识别到二维码，请确认图片清晰且包含二维码。',
+        success: '识别完成，内容已复制到剪贴板。',
+        result: '识别结果:',
+        decodeFail: '二维码识别失败: {{message}}'
+    },
     url: {
         title: 'URL 编码/解码',
         encode: '编码',
@@ -118,6 +134,32 @@ export default {
         result: '结果:',
         error: '处理 URL 时出错:'
     },
+    clock: {
+        title: '控制台时钟',
+        start: '控制台时钟已启动，按 Enter / Q 返回上一步。',
+        now: '当前时间: ',
+        exitTip: '按 Enter / Q 返回上一步，按 0 直接退出'
+    },
+    countdown: {
+        title: '倒计时工具',
+        inputPrompt: '请输入倒计时分钟数:',
+        invalidMinutes: '请输入大于等于 0 的数字分钟数',
+        remaining: '剩余时间: ',
+        total: '倒计总时: ',
+        status: '当前状态: ',
+        statusCounting: '倒计时中',
+        statusOvertime: '已超时',
+        exitTip: '按 Enter / Q 返回上一步，按 0 直接退出',
+        nonTtyTip: '当前终端不支持动态倒计时。目标时长: {{value}}'
+    },
+    stopwatch: {
+        title: '计时工具',
+        elapsed: '已计时: ',
+        status: '当前状态: ',
+        statusRunning: '计时中',
+        exitTip: '按 Enter / Q 返回上一步，按 0 直接退出',
+        nonTtyTip: '当前终端不支持动态计时。'
+    },
     baseConvert: {
         inputPrompt: '请输入数字:',
         invalidInput: '请输入有效的数字',