xw-devtool-cli 1.0.43 → 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,7 +49,7 @@
   - **变量格式转换**：支持 CamelCase, PascalCase, SnakeCase, KebabCase, ConstantCase 互转。
   - **哈希计算**：支持 MD5, SHA1, SHA256, SHA512, SM3 算法。
   - **二维码生成**：终端直接显示二维码，支持保存为 PNG 图片（带时间戳文件名）。
-  - **二维码识别**：支持选择二维码图片进行识别，识别结果自动复制到剪贴板。
+  - **二维码识别**：支持选择二维码图片进行识别，识别结果自动复制到剪贴板。
   - **特殊符号大全**：包含常用符号、箭头、数学符号、货币、希腊字母等 170+ 个符号，支持一键复制。
   - **Emoji 输入**：支持分类查看和选择常用 Emoji，一键复制到剪贴板。
   - **HTML 实体工具**：支持 HTML 实体编码与解码 (如 `&` <-> `&amp;`)。
@@ -209,13 +212,13 @@ x. 设置 / 语言 (Settings)
 - 输入文本或 URL（支持直接回车读取剪贴板）。
 - 终端直接显示二维码预览。
 - 可选保存为 PNG 图片，默认文件名包含时间戳。
-
-### 二维码识别
-- 选择 `qrcodeDecode`（菜单对应数字/字母）进入。
-- 支持两种图片输入方式：
-  - **选择文件（对话框）**
-  - **手动输入文件路径**
-- 自动识别二维码内容并复制到剪贴板。
+
+### 二维码识别
+- 选择 `qrcodeDecode`（菜单对应数字/字母）进入。
+- 支持两种图片输入方式：
+  - **选择文件（对话框）**
+  - **手动输入文件路径**
+- 自动识别二维码内容并复制到剪贴板。
 
 ### 5. URL 编解码
 - 选择 `5` 进入。
@@ -291,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))。
@@ -354,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, 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.
+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
 
@@ -380,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).
@@ -389,7 +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.
+  - **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.
@@ -503,13 +525,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.
+
+#### 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`.
@@ -563,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, 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.
+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).
@@ -224,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.43",
+  "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",

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/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';
@@ -84,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' },
@@ -310,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;

package/src/locales/en.js

@@ -61,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',
@@ -131,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

@@ -61,6 +61,9 @@ export default {
             pinyin: '汉字转拼音',
             timeFormat: '时间格式化 / 时间戳',
             timeCalc: '时间计算 (差值/偏移)',
+            clock: '控制台时钟',
+            countdown: '倒计时工具',
+            stopwatch: '计时工具',
             color: '颜色转换 (Hex <-> RGB)',
             colorPreview: '颜色预览',
             uuid: '生成 UUID',
@@ -131,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: '请输入有效的数字',