xw-devtool-cli 1.0.43 → 1.0.45

package/README.md

@@ -1,214 +1,217 @@
-# xw-devtool-cli
-
-**中文** | [English](#english)
-
-一个基于 Node.js 的开发者命令行工具箱，旨在提供开箱即用的常用开发工具，帮助开发者快速处理日常任务。
-
-主要功能包括：Base64 编解码、图片格式转换、图片与 Base64 互转、Mock 数据生成、时间戳/日期格式化、时间计算、URL 编解码、UUID 生成、汉字转拼音、颜色转换、变量格式转换、哈希计算、二维码生成、二维码识别、特殊符号大全、Markdown 语法工具、VS Code 代码段生成、当前目录树生成等。大部分结果可一键复制到剪贴板，极大提升开发效率。
-
-## ✨ 功能特性
-
-- **Base64 工具**：支持字符串与 Base64 互转，支持从剪贴板、文件或手动输入读取。
-- **图片工具**：
-  - **图片格式转换**：支持 PNG、JPG、WebP、ICO 格式互转，可调整压缩质量。生成 ICO 时支持自定义尺寸（逗号分隔），留空则默认生成 `256` 尺寸。输出文件名默认带时间戳，避免覆盖。
-  - **图片 ↔ Base64**：支持图片转 Base64 字符串，以及 Base64 还原为图片文件。
-  - **图片分割**：支持网格等分（自定义行/列数）或自定义分割线（像素/百分比），自动生成分割后的图片文件。
-  - **图片拼接**：支持“选择目录”或“选择多张图片”两种输入方式；在对话框中可一次多选多张图片，可选**水平拼接**或**垂直拼接**，输出支持选择指定目录（对话框或手动输入），默认输出文件名带时间戳并自动复制输出路径。
-  - **图片主色识别**：提取图片主色调（Hex/RGB/HSL/HSV），默认复制 Hex 到剪贴板，支持保存详细信息到文件。
-  - **颜色吸取**：从图片中吸取单像素颜色或区域平均颜色，支持 px/% 坐标输入，结果显示颜色条并自动复制 Hex/Hex8。
-  - **屏幕取色**：实时显示鼠标所在位置的颜色值（Hex/RGB）。
-    > **操作说明**：
-    > 1. 进入模式后，屏幕右下角会实时显示当前颜色预览和数值。
-    > 2. 移动鼠标到目标位置，按 **Enter 键** 复制当前颜色 Hex 到剪贴板（会有成功提示）。
-    > 3. 按 **ESC 键** 退出取色模式。
-    > 4. 支持多显示器。
-  - **占位图生成**：快速生成指定尺寸、颜色、文字的占位图片 (Placeholder Image)。
-  - **全屏十字辅助线**：显示跟随鼠标的全屏红色十字线，用于屏幕对齐和定位。按 **ESC 键** 退出。
-  - **屏幕测距**：点击屏幕上任意两点，测量其像素距离。
-  - **屏幕文字标注**：在屏幕上点击并输入文字，进行临时标注。右键撤销，Delete 清空。
-  - **图片压缩**：支持文件或文件夹；文件夹可批量压缩其下所有图片（可选包含子文件夹）。支持 PNG/JPG/WebP，质量 1-100；输出文件名带时间戳并复制输出目录到剪贴板。
-    - 压缩完成后可选择自动打开输出目录（带返回上一步）。
-- **Mock 数据生成**：
-  - 支持生成：英文段落 (Lorem Ipsum)、中文字符、中国居民身份证号、电子邮箱、URL、订单号、手机号、座机号。
-  - 支持批量生成。
-- **时间工具**：
-  - **时间格式化**：时间戳/日期字符串 -> `YYYY-MM-DD HH:mm:ss`。
-  - **获取时间戳**：快速获取当前毫秒级时间戳。
-  - **时间计算**：计算日期差值或日期偏移 (Add/Subtract)。
-- **开发辅助工具**：
-  - **URL 编解码**：Encode/Decode URL。
-  - **Unicode 编解码**：文本与 Unicode 转义序列 (\uXXXX) 互转。
-  - **UUID**：生成 UUID v4。
-  - **中文转拼音**：将汉字转换为不带声调的拼音。
-  - **进制转换**：支持二进制、八进制、十进制、十六进制之间的互相转换。
-  - **颜色转换**：Hex <-> RGB 互转，并在结果中显示颜色条预览（支持透明度棋盘背景），自动复制 Hex。
-  - **颜色预览**：输入颜色并在终端显示颜色条，便于快速视觉确认，同时自动复制 Hex 到剪贴板。
-  - **变量格式转换**：支持 CamelCase, PascalCase, SnakeCase, KebabCase, ConstantCase 互转。
-  - **哈希计算**：支持 MD5, SHA1, SHA256, SHA512, SM3 算法。
-  - **二维码生成**：终端直接显示二维码，支持保存为 PNG 图片（带时间戳文件名）。
+# xw-devtool-cli
+
+**中文** | [English](#english)
+
+一个基于 Node.js 的开发者命令行工具箱，旨在提供开箱即用的常用开发工具，帮助开发者快速处理日常任务。
+
+主要功能包括：Base64 编解码、图片格式转换、图片与 Base64 互转、Mock 数据生成、时间戳/日期格式化、时间计算、控制台时钟、倒计时工具、计时工具、URL 编解码、UUID 生成、汉字转拼音、颜色转换、变量格式转换、哈希计算、二维码生成、二维码识别、特殊符号大全、Markdown 语法工具、VS Code 代码段生成、当前目录树生成等。大部分结果可一键复制到剪贴板，极大提升开发效率。
+
+## ✨ 功能特性
+
+- **Base64 工具**：支持字符串与 Base64 互转，支持从剪贴板、文件或手动输入读取。
+- **图片工具**：
+  - **图片格式转换**：支持 PNG、JPG、WebP、ICO 格式互转，可调整压缩质量。生成 ICO 时支持自定义尺寸（逗号分隔），留空则默认生成 `256` 尺寸。输出文件名默认带时间戳，避免覆盖。
+  - **图片 ↔ Base64**：支持图片转 Base64 字符串，以及 Base64 还原为图片文件。
+  - **图片分割**：支持网格等分（自定义行/列数）或自定义分割线（像素/百分比），自动生成分割后的图片文件。
+  - **图片拼接**：支持“选择目录”或“选择多张图片”两种输入方式；在对话框中可一次多选多张图片，可选**水平拼接**或**垂直拼接**，输出支持选择指定目录（对话框或手动输入），默认输出文件名带时间戳并自动复制输出路径。
+  - **图片主色识别**：提取图片主色调（Hex/RGB/HSL/HSV），默认复制 Hex 到剪贴板，支持保存详细信息到文件。
+  - **颜色吸取**：从图片中吸取单像素颜色或区域平均颜色，支持 px/% 坐标输入，结果显示颜色条并自动复制 Hex/Hex8。
+  - **屏幕取色**：实时显示鼠标所在位置的颜色值（Hex/RGB）。
+    > **操作说明**：
+    > 1. 进入模式后，屏幕右下角会实时显示当前颜色预览和数值。
+    > 2. 移动鼠标到目标位置，按 **Enter 键** 复制当前颜色 Hex 到剪贴板（会有成功提示）。
+    > 3. 按 **ESC 键** 退出取色模式。
+    > 4. 支持多显示器。
+  - **占位图生成**：快速生成指定尺寸、颜色、文字的占位图片 (Placeholder Image)。
+  - **全屏十字辅助线**：显示跟随鼠标的全屏红色十字线，用于屏幕对齐和定位。按 **ESC 键** 退出。
+  - **屏幕测距**：点击屏幕上任意两点，测量其像素距离。
+  - **屏幕文字标注**：在屏幕上点击并输入文字，进行临时标注。右键撤销，Delete 清空。
+  - **图片压缩**：支持文件或文件夹；文件夹可批量压缩其下所有图片（可选包含子文件夹）。支持 PNG/JPG/WebP，质量 1-100；输出文件名带时间戳并复制输出目录到剪贴板。
+    - 压缩完成后可选择自动打开输出目录（带返回上一步）。
+- **Mock 数据生成**：
+  - 支持生成：英文段落 (Lorem Ipsum)、中文字符、中国居民身份证号、电子邮箱、URL、订单号、手机号、座机号。
+  - 支持批量生成。
+- **时间工具**：
+  - **时间格式化**：时间戳/日期字符串 -> `YYYY-MM-DD HH:mm:ss`。
+  - **获取时间戳**：快速获取当前毫秒级时间戳。
+  - **时间计算**：计算日期差值或日期偏移 (Add/Subtract)。
+  - **控制台时钟**：在终端实时显示当前时间，按 `Enter` 或 `Q` 返回上一步。
+  - **倒计时工具**：先选择秒/分钟/小时，再输入数值启动倒计时；倒计时结束后继续计时并显示负号（如 `-00:00:05`）。
+  - **计时工具**：启动后从 `00:00:00` 开始正向计时，终端每秒刷新显示。
+- **开发辅助工具**：
+  - **URL 编解码**：Encode/Decode URL。
+  - **Unicode 编解码**：文本与 Unicode 转义序列 (\uXXXX) 互转。
+  - **UUID**：生成 UUID v4。
+  - **中文转拼音**：将汉字转换为不带声调的拼音。
+  - **进制转换**：支持二进制、八进制、十进制、十六进制之间的互相转换。
+  - **颜色转换**：Hex <-> RGB 互转，并在结果中显示颜色条预览（支持透明度棋盘背景），自动复制 Hex。
+  - **颜色预览**：输入颜色并在终端显示颜色条，便于快速视觉确认，同时自动复制 Hex 到剪贴板。
+  - **变量格式转换**：支持 CamelCase, PascalCase, SnakeCase, KebabCase, ConstantCase 互转。
+  - **哈希计算**：支持 MD5, SHA1, SHA256, SHA512, SM3 算法。
+  - **二维码生成**：终端直接显示二维码，支持保存为 PNG 图片（带时间戳文件名）。
   - **二维码识别**：支持选择二维码图片进行识别，识别结果自动复制到剪贴板。
-  - **特殊符号大全**：包含常用符号、箭头、数学符号、货币、希腊字母等 170+ 个符号，支持一键复制。
-  - **Emoji 输入**：支持分类查看和选择常用 Emoji，一键复制到剪贴板。
-  - **HTML 实体工具**：支持 HTML 实体编码与解码 (如 `&` <-> `&amp;`)。
-  - **Markdown 语法工具**：提供常用 Markdown 语法模板 (Headers, Lists, Tables, Code 等)，一键复制。
-  - **VS Code 代码段生成器**：将代码转换为 VS Code Snippet JSON，自动生成语法速查表注释。
-  - **Git 助手**: 标准化生成 Git 分支名 (feature/bugfix/custom) 和 Conventional Commits 提交日志。
-  - **当前目录树生成**：生成当前目录的文件树结构，支持指定层级，输出可选复制到剪贴板或导出为 txt 文件。
-  - **占位图生成**：自定义尺寸、背景色、文字颜色和格式生成占位图。
-- **便捷操作**：
-  - 支持文件选择对话框 (Windows)。
-  - 结果自动复制到剪贴板。
-  - 支持从剪贴板自动读取输入（部分工具支持直接回车读取）。
-  - 支持将大文本结果保存为文件。
- - **多语言支持 (i18n)**：
-  - 支持 **中文** 和 **English**。
-  - 可通过菜单中的 `Settings` 切换，或使用命令行参数：`xw-devtool --zh` / `xw-devtool --en`。
-
-## 🖥️ 系统支持说明（Windows 专属功能）
-
-- 屏幕取色（来源：屏幕）仅支持 Windows；来源为图片的取色跨平台可用
-- 全屏十字辅助线 仅支持 Windows
-- 屏幕测距（像素）仅支持 Windows
-- 屏幕文字标注 仅支持 Windows
-- 文件选择/保存对话框 仅支持 Windows；在非 Windows 平台请手动输入文件路径或使用命令行默认路径
-
-## 📦 安装
-
-### 全局安装 (推荐)
-```bash
-npm install -g xw-devtool-cli
-```
-安装后即可在终端直接使用 `xw-devtool` 或 `xw-dev` 命令。
-
-### 免安装运行 (npx)
-```bash
-npx xw-devtool-cli@latest
-```
-
-## 🚀 快速开始
-
-在终端运行：
-```bash
-xw-devtool
-```
-
-或者指定语言启动：
-```bash
-xw-devtool --zh  # 中文启动
-xw-devtool --en  # 英文启动 (Start in English)
-```
-
-启动后将显示交互式菜单，通过键盘输入对应的数字或字母选择功能，也支持直接输入关键字搜索（如 `json`、`图片`、`git`）：
-
-```text
-=================================
-      xw-devtool-cli 菜单
-=================================
-1. 图片 <-> Base64
-2. 图片格式转换
-3. 图片分割工具
-4. 图片主色识别
-5. 颜色吸取
-6. 全屏十字辅助线
-7. 屏幕测距 (像素)
-8. 屏幕文字标注
-9. 图片压缩
-a. 占位图生成器
-b. 二维码生成器
-c. URL 编码/解码
-d. 进制转换工具
-e. 字符串 编码/解码 (Base64)
-f. Unicode 编码/解码
-g. HTML 实体 编码/解码
-h. 变量命名格式转换
-i. JSON 格式化 (压缩/美化)
-j. 汉字转拼音
-k. 时间格式化 / 时间戳
-l. 时间计算 (差值/偏移)
-m. 颜色转换 (Hex <-> RGB)
-n. 颜色预览
-o. 生成 UUID
-p. 哈希计算 (MD5/SHA/SM3)
-q. Mock 文本生成
-r. 特殊字符 (符号)
-s. Emoji 选择器
-t. Markdown 片段
-u. VS Code 代码片段生成
-v. Git 助手 (分支/提交模板)
-w. 当前目录树生成
-x. 设置 / 语言 (Settings)
-0. 退出
-=================================
-```
-
-## 📖 详细使用指南
-
-### 1. 图片与 Base64 互转
-- 选择 `1` 进入。
-- **Image -> Base64**:
-  - 选择图片文件（支持对话框选择）。
-  - 输出 Base64 字符串（可保存为 `.txt` 文件防止控制台卡顿）。
-- **Base64 -> Image**:
-  - 输入 Base64 字符串（支持从文件读取或剪贴板读取）。
-  - 自动识别图片格式并保存为文件。
-
-### 2. 图片格式转换
-- 选择 `2` 进入。
-- 选择源图片文件。
-- 选择目标格式 (PNG / JPG / WebP / ICO)。
-- 设置压缩参数（如 JPG 质量 1-100，PNG 压缩等级 0-9）。
-- 生成的新图片将保存在源文件同级目录。
-- 生成 ICO 时可自定义尺寸，留空默认生成 `256` 尺寸；输出文件名包含时间戳。
-
-### 图片压缩
-- 选择 `imgCompress` (菜单对应数字/字母) 进入。
-- **支持输入**：
-  - **文件**：单张图片压缩。
-  - **文件夹**：批量压缩文件夹内所有图片（可选是否递归子文件夹）。
-- **参数设置**：
-  - **质量**：推荐 80，也可自定义 1-100。
-  - **文件夹结构**：批量处理时可选保留原目录结构。
-  - **文件名后缀**：可选是否添加 `_compressed_时间戳` 后缀。如果不添加，将保持原文件名（建议输出到不同目录以防覆盖）。
-- **输出**：
-  - 默认输出到源目录下的 `compressed_YYYYMMDD_HHmmss` 文件夹。
-  - 自动复制输出目录路径。
-  - 完成后可选直接打开输出目录。
-
-### 当前目录树生成
-- 选择 `w` 进入。
-- 先选择层级模式：
-  - **所有层级**：从当前目录递归到最深层。
-  - **指定层级**：输入层级数字（`0` 表示仅根目录，`1` 表示包含第一层子项）。
-- 再选择输出方式：
-  - **复制到剪贴板**：自动复制结果，便于粘贴到文档或 Issue 中。
-  - **输出为 txt 文件**：可选择保存位置，默认文件名带时间戳，避免覆盖旧文件。
-
-### 3. 占位图生成 (Placeholder Image)
-- 选择 `3` 进入。
-- **模式 1：本地图片文件 (Local Image File)**
-  - 自动生成图片文件到当前目录。
-  - 支持自定义：
-    - **尺寸**: 宽度和高度 (px)。
-    - **颜色**: 背景色和文字颜色（支持 Hex 或颜色名）。
-    - **内容**: 自定义图片中间的文字（默认显示尺寸）。
-    - **格式**: 输出 PNG, JPG, WebP, GIF。
-  - 文件名默认包含时间戳，避免覆盖。
-- **模式 2：远程图片 URL (Remote Image URL)**
-  - 自动生成云端占位图链接并复制到剪贴板。
-  - 支持多个主流服务商：
-    - **Picsum Photos**: 随机风景图，支持灰度、模糊效果。
-    - **DummyImage**: 简单、经典。
-    - **Via Placeholder**: 标准占位图。
-    - **Placehold.jp**: 适合日文环境。
-    - **DevTool Tech**: 高度可定制。
-    - **FPO Img**: "For Placement Only" 风格。
-  - 支持自定义尺寸、颜色、文字等参数（视具体服务商而定）。
-
-### 4. 二维码生成
-- 选择 `4` 进入。
-- 输入文本或 URL（支持直接回车读取剪贴板）。
-- 终端直接显示二维码预览。
-- 可选保存为 PNG 图片，默认文件名包含时间戳。
+  - **特殊符号大全**：包含常用符号、箭头、数学符号、货币、希腊字母等 170+ 个符号，支持一键复制。
+  - **Emoji 输入**：支持分类查看和选择常用 Emoji，一键复制到剪贴板。
+  - **HTML 实体工具**：支持 HTML 实体编码与解码 (如 `&` <-> `&amp;`)。
+  - **Markdown 语法工具**：提供常用 Markdown 语法模板 (Headers, Lists, Tables, Code 等)，一键复制。
+  - **VS Code 代码段生成器**：将代码转换为 VS Code Snippet JSON，自动生成语法速查表注释。
+  - **Git 助手**: 标准化生成 Git 分支名 (feature/bugfix/custom) 和 Conventional Commits 提交日志。
+  - **当前目录树生成**：生成当前目录的文件树结构，支持指定层级，输出可选复制到剪贴板或导出为 txt 文件。
+  - **占位图生成**：自定义尺寸、背景色、文字颜色和格式生成占位图。
+- **便捷操作**：
+  - 支持文件选择对话框 (Windows)。
+  - 结果自动复制到剪贴板。
+  - 支持从剪贴板自动读取输入（部分工具支持直接回车读取）。
+  - 支持将大文本结果保存为文件。
+ - **多语言支持 (i18n)**：
+  - 支持 **中文** 和 **English**。
+  - 可通过菜单中的 `Settings` 切换，或使用命令行参数：`xw-devtool --zh` / `xw-devtool --en`。
+
+## 🖥️ 系统支持说明（Windows 专属功能）
+
+- 屏幕取色（来源：屏幕）仅支持 Windows；来源为图片的取色跨平台可用
+- 全屏十字辅助线 仅支持 Windows
+- 屏幕测距（像素）仅支持 Windows
+- 屏幕文字标注 仅支持 Windows
+- 文件选择/保存对话框 仅支持 Windows；在非 Windows 平台请手动输入文件路径或使用命令行默认路径
+
+## 📦 安装
+
+### 全局安装 (推荐)
+```bash
+npm install -g xw-devtool-cli
+```
+安装后即可在终端直接使用 `xw-devtool` 或 `xw-dev` 命令。
+
+### 免安装运行 (npx)
+```bash
+npx xw-devtool-cli@latest
+```
+
+## 🚀 快速开始
+
+在终端运行：
+```bash
+xw-devtool
+```
+
+或者指定语言启动：
+```bash
+xw-devtool --zh  # 中文启动
+xw-devtool --en  # 英文启动 (Start in English)
+```
+
+启动后将显示交互式菜单，通过键盘输入对应的数字或字母选择功能，也支持直接输入关键字搜索（如 `json`、`图片`、`git`）：
+
+```text
+=================================
+      xw-devtool-cli 菜单
+=================================
+1. 图片 <-> Base64
+2. 图片格式转换
+3. 图片分割工具
+4. 图片主色识别
+5. 颜色吸取
+6. 全屏十字辅助线
+7. 屏幕测距 (像素)
+8. 屏幕文字标注
+9. 图片压缩
+a. 占位图生成器
+b. 二维码生成器
+c. URL 编码/解码
+d. 进制转换工具
+e. 字符串 编码/解码 (Base64)
+f. Unicode 编码/解码
+g. HTML 实体 编码/解码
+h. 变量命名格式转换
+i. JSON 格式化 (压缩/美化)
+j. 汉字转拼音
+k. 时间格式化 / 时间戳
+l. 时间计算 (差值/偏移)
+m. 颜色转换 (Hex <-> RGB)
+n. 颜色预览
+o. 生成 UUID
+p. 哈希计算 (MD5/SHA/SM3)
+q. Mock 文本生成
+r. 特殊字符 (符号)
+s. Emoji 选择器
+t. Markdown 片段
+u. VS Code 代码片段生成
+v. Git 助手 (分支/提交模板)
+w. 当前目录树生成
+x. 设置 / 语言 (Settings)
+0. 退出
+=================================
+```
+
+## 📖 详细使用指南
+
+### 1. 图片与 Base64 互转
+- 选择 `1` 进入。
+- **Image -> Base64**:
+  - 选择图片文件（支持对话框选择）。
+  - 输出 Base64 字符串（可保存为 `.txt` 文件防止控制台卡顿）。
+- **Base64 -> Image**:
+  - 输入 Base64 字符串（支持从文件读取或剪贴板读取）。
+  - 自动识别图片格式并保存为文件。
+
+### 2. 图片格式转换
+- 选择 `2` 进入。
+- 选择源图片文件。
+- 选择目标格式 (PNG / JPG / WebP / ICO)。
+- 设置压缩参数（如 JPG 质量 1-100，PNG 压缩等级 0-9）。
+- 生成的新图片将保存在源文件同级目录。
+- 生成 ICO 时可自定义尺寸，留空默认生成 `256` 尺寸；输出文件名包含时间戳。
+
+### 图片压缩
+- 选择 `imgCompress` (菜单对应数字/字母) 进入。
+- **支持输入**：
+  - **文件**：单张图片压缩。
+  - **文件夹**：批量压缩文件夹内所有图片（可选是否递归子文件夹）。
+- **参数设置**：
+  - **质量**：推荐 80，也可自定义 1-100。
+  - **文件夹结构**：批量处理时可选保留原目录结构。
+  - **文件名后缀**：可选是否添加 `_compressed_时间戳` 后缀。如果不添加，将保持原文件名（建议输出到不同目录以防覆盖）。
+- **输出**：
+  - 默认输出到源目录下的 `compressed_YYYYMMDD_HHmmss` 文件夹。
+  - 自动复制输出目录路径。
+  - 完成后可选直接打开输出目录。
+
+### 当前目录树生成
+- 选择 `w` 进入。
+- 先选择层级模式：
+  - **所有层级**：从当前目录递归到最深层。
+  - **指定层级**：输入层级数字（`0` 表示仅根目录，`1` 表示包含第一层子项）。
+- 再选择输出方式：
+  - **复制到剪贴板**：自动复制结果，便于粘贴到文档或 Issue 中。
+  - **输出为 txt 文件**：可选择保存位置，默认文件名带时间戳，避免覆盖旧文件。
+
+### 3. 占位图生成 (Placeholder Image)
+- 选择 `3` 进入。
+- **模式 1：本地图片文件 (Local Image File)**
+  - 自动生成图片文件到当前目录。
+  - 支持自定义：
+    - **尺寸**: 宽度和高度 (px)。
+    - **颜色**: 背景色和文字颜色（支持 Hex 或颜色名）。
+    - **内容**: 自定义图片中间的文字（默认显示尺寸）。
+    - **格式**: 输出 PNG, JPG, WebP, GIF。
+  - 文件名默认包含时间戳，避免覆盖。
+- **模式 2：远程图片 URL (Remote Image URL)**
+  - 自动生成云端占位图链接并复制到剪贴板。
+  - 支持多个主流服务商：
+    - **Picsum Photos**: 随机风景图，支持灰度、模糊效果。
+    - **DummyImage**: 简单、经典。
+    - **Via Placeholder**: 标准占位图。
+    - **Placehold.jp**: 适合日文环境。
+    - **DevTool Tech**: 高度可定制。
+    - **FPO Img**: "For Placement Only" 风格。
+  - 支持自定义尺寸、颜色、文字等参数（视具体服务商而定）。
+
+### 4. 二维码生成
+- 选择 `4` 进入。
+- 输入文本或 URL（支持直接回车读取剪贴板）。
+- 终端直接显示二维码预览。
+- 可选保存为 PNG 图片，默认文件名包含时间戳。
 
 ### 二维码识别
 - 选择 `qrcodeDecode`（菜单对应数字/字母）进入。
@@ -216,293 +219,313 @@ x. 设置 / 语言 (Settings)
   - **选择文件（对话框）**
   - **手动输入文件路径**
 - 自动识别二维码内容并复制到剪贴板。
-
-### 5. URL 编解码
-- 选择 `5` 进入。
-- 选择 `Encode` (编码) 或 `Decode` (解码)。
-- 输入 URL 字符串，结果自动复制。
-
-### 6. 字符串 Base64 转换
-- 选择 `6` 进入。
-- 支持三种输入源：
-  - **Clipboard**: 直接读取剪贴板内容（适合处理长文本）。
-  - **File**: 读取文本文件内容。
-  - **Manual input**: 手动粘贴或输入文本。
-- 输出支持：直接复制、保存为文件、预览后复制。
-
-### 7. Unicode 编码/解码
-- 选择 `7` 进入。
-- **Encode**: 将文本转换为 Unicode 转义序列。支持两种模式：
-  - **Non-ASCII Only**: 仅编码中文、符号等非 ASCII 字符 (推荐，保留英文可读性)。
-  - **All Characters**: 编码所有字符 (包括英文字母)。
-- **Decode**: 将 Unicode 转义序列还原为文本。
-- 结果自动复制到剪贴板。
-
-### 8. HTML 实体编码/解码
-- 选择 `8` 进入。
-- 支持两种编码模式：
-  - **Standard**: 仅编码特殊字符（如 `<` `>` `&` 及非 ASCII 字符）。
-  - **Everything**: 编码所有字符（包括 ASCII 字母数字）。
-- 支持直接回车读取剪贴板内容。
-- 结果自动复制到剪贴板。
-
-### 9. 变量格式转换
-- 选择 `9` 进入。
-- 输入变量名（支持直接回车读取剪贴板）。
-- 自动展示 CamelCase, PascalCase, SnakeCase, KebabCase, ConstantCase 五种格式。
-- 选择一种格式自动复制。
-
-### 10. JSON 格式化
-- 选择 `a` 进入。
-- 支持两种输入来源：
-  - **从剪贴板读取**：自动读取当前剪贴板内容。
-  - **从本地文件读取**：支持文件对话框选择或手动输入路径。
-- 优先按标准 JSON 解析；若遇到常见非标准写法（如代码块包裹、单引号、未加引号的 key、尾随逗号、HTML 实体），会自动修正常见问题后再格式化。
-- 统一转换为 2 空格缩进的标准 JSON 格式。
-- 支持在各选项列表中返回上一步。
-- 输出支持：
-  - **复制到剪贴板**（默认推荐）。
-  - **保存到文件**（默认文件名带时间戳，避免覆盖旧文件）。
-- **注意**：为防止长文本刷屏，结果不会在终端完整打印。
-
-### 11. 中文转拼音
-- 选择 `b` 进入。
-- 输入中文字符串（支持直接回车读取剪贴板）。
-- 输出对应的拼音（无声调）。
-
-### 12. 时间格式化 (Time Format)
-- 选择 `c` 进入。
-- 支持时间戳转日期字符串，或日期字符串转时间戳。
-- 直接回车可获取当前时间戳。
-
-### 13. 时间计算 (Time Calculation)
-- 选择 `d` 进入。
-- **Diff**: 计算两个日期之间的时间差 (天、小时、分、秒)。
-  - **操作步骤**：
-    1. 输入 **开始日期** (支持 `YYYY-MM-DD HH:mm:ss` 等多种格式，默认为当前时间)。
-    2. 输入 **结束日期** (默认为当前时间)。
-    3. 查看时间差结果 (显示总天数、总小时数及详细的 `x天x小时x分x秒`)。
-- **Offset**: 计算指定偏移量后的日期。
-  - **操作步骤**：
-    1. 输入 **基准日期** (默认为当前时间)。
-    2. 选择 **时间单位** (Days, Hours, Minutes, Seconds, etc.)。
-    3. 选择 **操作类型** (Add / Subtract)。
-    4. 输入 **数量** (Amount)。
-    5. 查看计算后的新日期。
-  - 示例：计算 "当前时间 3 天后" 或 "2025-01-01 5 小时前"。
-
-### 14. 颜色转换 (Hex <-> RGB)
-- 选择 `e` 进入。
-- 输入 Hex 颜色值 (如 #333) 或 RGB 值 (如 rgb(51,51,51))。
-- 自动转换并显示对应格式。
-
-### 15. Get UUID
-- 选择 `f` 进入。
-- 自动生成一个 UUID v4 并复制到剪贴板。
-
-### 16. 哈希计算 (Encryption)
-- 选择 `g` 进入。
-- 输入文本（支持直接回车读取剪贴板）。
-- 同时计算并显示 MD5, SHA1, SHA256, SHA512, SM3 哈希值。
-
-### 17. Mock 数据生成
-- 选择 `h` 进入。
-- 提供多种数据类型：英文段落、中文字符、身份证号、邮箱、手机号等。
-- 支持指定生成数量。
-
-### 18. 特殊符号大全
-- 选择 `i` 进入。
-- 网格化展示常用特殊符号。
-- 输入符号对应的编号即可一键复制。
-
-### 19. Emoji 输入
-- 选择 `j` 进入。
-- 分类展示常用 Emoji (表情、手势、动物、食物等)。
-- 输入编号选择并复制 Emoji 到剪贴板。
-
-### 20. Markdown 语法工具 (Markdown Snippets)
-- 选择 `k` 进入。
-- 提供常用的 Markdown 语法模板，分类包括：
-  - **Headers**: 标题 (H1-H6)。
-  - **Emphasis**: 加粗、斜体、删除线。
-  - **Lists**: 无序列表、有序列表、任务列表。
-  - **Links & Images**: 链接、图片插入。
-  - **Code**: 行内代码、代码块。
-  - **Tables**: 表格模板。
-  - **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
-
----
-
-## English
-
-**English** | [中文](#xw-devtool-cli)
-
-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.
-
-### ✨ Features
-
-- **Base64 Tools**: Convert strings to/from Base64, supports reading from clipboard, file, or manual input.
-- **Image Tools**:
-  - **Format Conversion**: Convert between PNG, JPG, WebP, ICO, with adjustable compression quality. For ICO, you can specify sizes (comma-separated); leave empty to generate `256` size by default. Output filenames include timestamps to avoid overwriting.
-  - **Image ↔ Base64**: Convert images to Base64 strings and vice versa.
-  - **Image Dominant Color**: Extract dominant color (Hex/RGB/HSL/HSV), copy Hex to clipboard by default, or save details to file.
-  - **Image Color Picker**: Pick color from image (single pixel or average), supports px/% coordinates, shows color bar and auto-copies Hex/Hex8.
-  - **Screen Color Picker**: Real-time color picking from screen (Hex/RGB).
-    > **Usage**:
-    > 1. Real-time color preview and values are shown in the bottom-right corner.
-    > 2. Move mouse to target and press **Enter** to copy Hex color to clipboard.
-    > 3. Press **ESC** to exit.
-    > 4. Supports multiple monitors.
-  - **Placeholder Image**: Quickly generate placeholder images with custom size, color, and text.
-  - **Image Compression**: Support file or folder input; batch compress images in folder (recursive optional). Supports PNG/JPG/WebP, Quality 1-100. Output filename suffix optional.
-  - **Full Screen Crosshair**: Show red crosshair following mouse. Press **ESC** to exit.
-- **Mock Data**:
-  - Generate: Lorem Ipsum, Chinese characters, ID cards, Emails, URLs, Order IDs, Phone numbers.
-  - Supports batch generation.
-- **Time Tools**:
-  - **Formatting**: Timestamp/Date string -> `YYYY-MM-DD HH:mm:ss`.
-  - **Timestamp**: Quickly get current millisecond timestamp.
-  - **Calculation**: Calculate date differences or offsets (Add/Subtract).
-- **Dev Tools**:
-  - **URL Encode/Decode**
-  - **Unicode Encode/Decode**: Text <-> Unicode escape sequences (\uXXXX).
-  - **UUID**: Generate UUID v4.
-  - **Pinyin**: Convert Chinese characters to Pinyin (without tone).
-  - **Color Converter**: Hex <-> RGB.
-  - **Variable Format**: CamelCase, PascalCase, SnakeCase, KebabCase, ConstantCase.
-  - **Hash Calculator**: MD5, SHA1, SHA256, SHA512, SM3.
-  - **QR Code**: Display QR codes in terminal, save as PNG.
+
+### 5. URL 编解码
+- 选择 `5` 进入。
+- 选择 `Encode` (编码) 或 `Decode` (解码)。
+- 输入 URL 字符串，结果自动复制。
+
+### 6. 字符串 Base64 转换
+- 选择 `6` 进入。
+- 支持三种输入源：
+  - **Clipboard**: 直接读取剪贴板内容（适合处理长文本）。
+  - **File**: 读取文本文件内容。
+  - **Manual input**: 手动粘贴或输入文本。
+- 输出支持：直接复制、保存为文件、预览后复制。
+
+### 7. Unicode 编码/解码
+- 选择 `7` 进入。
+- **Encode**: 将文本转换为 Unicode 转义序列。支持两种模式：
+  - **Non-ASCII Only**: 仅编码中文、符号等非 ASCII 字符 (推荐，保留英文可读性)。
+  - **All Characters**: 编码所有字符 (包括英文字母)。
+- **Decode**: 将 Unicode 转义序列还原为文本。
+- 结果自动复制到剪贴板。
+
+### 8. HTML 实体编码/解码
+- 选择 `8` 进入。
+- 支持两种编码模式：
+  - **Standard**: 仅编码特殊字符（如 `<` `>` `&` 及非 ASCII 字符）。
+  - **Everything**: 编码所有字符（包括 ASCII 字母数字）。
+- 支持直接回车读取剪贴板内容。
+- 结果自动复制到剪贴板。
+
+### 9. 变量格式转换
+- 选择 `9` 进入。
+- 输入变量名（支持直接回车读取剪贴板）。
+- 自动展示 CamelCase, PascalCase, SnakeCase, KebabCase, ConstantCase 五种格式。
+- 选择一种格式自动复制。
+
+### 10. JSON 格式化
+- 选择 `a` 进入。
+- 支持两种输入来源：
+  - **从剪贴板读取**：自动读取当前剪贴板内容。
+  - **从本地文件读取**：支持文件对话框选择或手动输入路径。
+- 优先按标准 JSON 解析；若遇到常见非标准写法（如代码块包裹、单引号、未加引号的 key、尾随逗号、HTML 实体），会自动修正常见问题后再格式化。
+- 统一转换为 2 空格缩进的标准 JSON 格式。
+- 支持在各选项列表中返回上一步。
+- 输出支持：
+  - **复制到剪贴板**（默认推荐）。
+  - **保存到文件**（默认文件名带时间戳，避免覆盖旧文件）。
+- **注意**：为防止长文本刷屏，结果不会在终端完整打印。
+
+### 11. 中文转拼音
+- 选择 `b` 进入。
+- 输入中文字符串（支持直接回车读取剪贴板）。
+- 输出对应的拼音（无声调）。
+
+### 12. 时间格式化 (Time Format)
+- 选择 `c` 进入。
+- 支持时间戳转日期字符串，或日期字符串转时间戳。
+- 直接回车可获取当前时间戳。
+
+### 13. 时间计算 (Time Calculation)
+- 选择 `d` 进入。
+- **Diff**: 计算两个日期之间的时间差 (天、小时、分、秒)。
+  - **操作步骤**：
+    1. 输入 **开始日期** (支持 `YYYY-MM-DD HH:mm:ss` 等多种格式，默认为当前时间)。
+    2. 输入 **结束日期** (默认为当前时间)。
+    3. 查看时间差结果 (显示总天数、总小时数及详细的 `x天x小时x分x秒`)。
+- **Offset**: 计算指定偏移量后的日期。
+  - **操作步骤**：
+    1. 输入 **基准日期** (默认为当前时间)。
+    2. 选择 **时间单位** (Days, Hours, Minutes, Seconds, etc.)。
+    3. 选择 **操作类型** (Add / Subtract)。
+    4. 输入 **数量** (Amount)。
+    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))。
+- 自动转换并显示对应格式。
+
+### 15. Get UUID
+- 选择 `f` 进入。
+- 自动生成一个 UUID v4 并复制到剪贴板。
+
+### 16. 哈希计算 (Encryption)
+- 选择 `g` 进入。
+- 输入文本（支持直接回车读取剪贴板）。
+- 同时计算并显示 MD5, SHA1, SHA256, SHA512, SM3 哈希值。
+
+### 17. Mock 数据生成
+- 选择 `h` 进入。
+- 提供多种数据类型：英文段落、中文字符、身份证号、邮箱、手机号等。
+- 支持指定生成数量。
+
+### 18. 特殊符号大全
+- 选择 `i` 进入。
+- 网格化展示常用特殊符号。
+- 输入符号对应的编号即可一键复制。
+
+### 19. Emoji 输入
+- 选择 `j` 进入。
+- 分类展示常用 Emoji (表情、手势、动物、食物等)。
+- 输入编号选择并复制 Emoji 到剪贴板。
+
+### 20. Markdown 语法工具 (Markdown Snippets)
+- 选择 `k` 进入。
+- 提供常用的 Markdown 语法模板，分类包括：
+  - **Headers**: 标题 (H1-H6)。
+  - **Emphasis**: 加粗、斜体、删除线。
+  - **Lists**: 无序列表、有序列表、任务列表。
+  - **Links & Images**: 链接、图片插入。
+  - **Code**: 行内代码、代码块。
+  - **Tables**: 表格模板。
+  - **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
+
+---
+
+## English
+
+**English** | [中文](#xw-devtool-cli)
+
+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, 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
+
+- **Base64 Tools**: Convert strings to/from Base64, supports reading from clipboard, file, or manual input.
+- **Image Tools**:
+  - **Format Conversion**: Convert between PNG, JPG, WebP, ICO, with adjustable compression quality. For ICO, you can specify sizes (comma-separated); leave empty to generate `256` size by default. Output filenames include timestamps to avoid overwriting.
+  - **Image ↔ Base64**: Convert images to Base64 strings and vice versa.
+  - **Image Dominant Color**: Extract dominant color (Hex/RGB/HSL/HSV), copy Hex to clipboard by default, or save details to file.
+  - **Image Color Picker**: Pick color from image (single pixel or average), supports px/% coordinates, shows color bar and auto-copies Hex/Hex8.
+  - **Screen Color Picker**: Real-time color picking from screen (Hex/RGB).
+    > **Usage**:
+    > 1. Real-time color preview and values are shown in the bottom-right corner.
+    > 2. Move mouse to target and press **Enter** to copy Hex color to clipboard.
+    > 3. Press **ESC** to exit.
+    > 4. Supports multiple monitors.
+  - **Placeholder Image**: Quickly generate placeholder images with custom size, color, and text.
+  - **Image Compression**: Support file or folder input; batch compress images in folder (recursive optional). Supports PNG/JPG/WebP, Quality 1-100. Output filename suffix optional.
+  - **Full Screen Crosshair**: Show red crosshair following mouse. Press **ESC** to exit.
+- **Mock Data**:
+  - Generate: Lorem Ipsum, Chinese characters, ID cards, Emails, URLs, Order IDs, Phone numbers.
+  - Supports batch generation.
+- **Time Tools**:
+  - **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**: Select seconds/minutes/hours first, then enter the value to start; 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).
+  - **UUID**: Generate UUID v4.
+  - **Pinyin**: Convert Chinese characters to Pinyin (without tone).
+  - **Color Converter**: Hex <-> RGB.
+  - **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.
-  - **Markdown Snippets**: Common Markdown templates.
-  - **VS Code Snippets**: Generate VS Code snippet JSON from code.
-- **Convenience**:
-  - File selection dialog (Windows).
-  - Auto-copy results to clipboard.
-  - Auto-read from clipboard.
-  - Save large results to file.
-- **Internationalization (i18n)**:
-  - Support **English** and **Chinese**.
-  - Switch via **Settings** in the menu or use CLI flags: `xw-devtool --en` / `xw-devtool --zh`.
-
-### 📦 Installation
-
-#### Global Installation (Recommended)
-```bash
-npm install -g xw-devtool-cli
-```
-After installation, use `xw-devtool` or `xw-dev` command.
-
-#### Run via npx
-```bash
-npx xw-devtool-cli@latest
-```
-
-### 🚀 Quick Start
-
-Run in terminal:
-```bash
-xw-devtool
-```
-
-Or specify language directly:
-```bash
-xw-devtool --en  # Start in English
-xw-devtool --zh  # Start in Chinese
-```
-
-The interactive menu will appear:
-
-```text
-=================================
-      xw-devtool-cli Menu
-=================================
-1. Image <-> Base64                    2. Image Format Convert
-3. Image Splitter                      4. Image Dominant Color
-5. Color Picker                        6. Screen Crosshair
-7. Pixel Distance Tool                 8. Screen Mark Tool
-9. Image Compression                   a. Placeholder Image Generator
-b. QR Code Generator                   c. URL Encode/Decode
-d. Number Base Converter               e. String Encode/Decode (Base64)
-f. Unicode Encode/Decode               g. HTML Entity Encode/Decode
-h. Variable Format Converter           i. JSON Format (Minify/Prettify)
-j. Chinese to Pinyin                   k. Time Format / Timestamp
-l. Time Calculation (Diff/Offset)      m. Color Converter (Hex <-> RGB)
-n. Color Preview                       o. Get UUID
-p. Hash Calculator (MD5/SHA/SM3)       q. Mock Text
-r. Special Characters (Symbols)        s. Emoji Picker
-t. Markdown Snippets                   u. VS Code Snippet Generator
-v. Git Helper (Branch/Commit Template) w. Settings / Language
-0. Exit
-=================================
-```
-
-You can enter a feature key directly, or type a keyword (e.g. `json`, `image`, `git`) to search features and then choose from matched results.
-
-### 📖 Detailed Usage
-
-#### 1. Image <-> Base64
-- Select `1`.
-- **Image -> Base64**:
-  - Select image file.
-  - Output Base64 string (can save to `.txt`).
-- **Base64 -> Image**:
-  - Input Base64 string (file or clipboard).
-  - Auto-detect format and save as file.
-
-#### 2. Image Format Convert
-- Select `2`.
-- Select source image.
-- Select target format (PNG / JPG / WebP).
-- Set quality/compression.
-- Saved in the same directory.
-
-#### Image Compression
-- Select `imgCompress` (menu key).
-- **Input**: File or Folder (batch processing).
-- **Settings**:
-  - Quality (1-100).
-  - Recursive (for folders).
-  - Preserve directory structure.
-  - Suffix option: Add `_compressed_timestamp` or keep original filename.
-- **Output**:
-  - Saved to `compressed_YYYYMMDD_HHmmss` folder.
-  - Auto-copy output path.
-  - Option to open output folder.
-
-#### 3. Placeholder Image Generator
-- Select `3`.
-- **Mode 1: Local Image File**
-  - Generate file locally.
-  - Customize: Size, Colors, Text, Format.
-- **Mode 2: Remote Image URL**
-  - Generate URL and copy to clipboard.
-  - Supports: Picsum Photos, DummyImage, Via Placeholder, Placehold.jp, DevTool Tech, FPO Img.
-
-#### 4. QR Code Generator
-- Select `4`.
-- Input text or URL.
-- Preview in terminal.
-- Option to save as PNG.
+  - **Special Symbols**: 170+ symbols, arrows, math symbols, etc.
+  - **Emoji Picker**: Browse and copy emojis.
+  - **HTML Entity**: Encode/Decode HTML entities.
+  - **Markdown Snippets**: Common Markdown templates.
+  - **VS Code Snippets**: Generate VS Code snippet JSON from code.
+- **Convenience**:
+  - File selection dialog (Windows).
+  - Auto-copy results to clipboard.
+  - Auto-read from clipboard.
+  - Save large results to file.
+- **Internationalization (i18n)**:
+  - Support **English** and **Chinese**.
+  - Switch via **Settings** in the menu or use CLI flags: `xw-devtool --en` / `xw-devtool --zh`.
+
+### 📦 Installation
+
+#### Global Installation (Recommended)
+```bash
+npm install -g xw-devtool-cli
+```
+After installation, use `xw-devtool` or `xw-dev` command.
+
+#### Run via npx
+```bash
+npx xw-devtool-cli@latest
+```
+
+### 🚀 Quick Start
+
+Run in terminal:
+```bash
+xw-devtool
+```
+
+Or specify language directly:
+```bash
+xw-devtool --en  # Start in English
+xw-devtool --zh  # Start in Chinese
+```
+
+The interactive menu will appear:
+
+```text
+=================================
+      xw-devtool-cli Menu
+=================================
+1. Image <-> Base64                    2. Image Format Convert
+3. Image Splitter                      4. Image Dominant Color
+5. Color Picker                        6. Screen Crosshair
+7. Pixel Distance Tool                 8. Screen Mark Tool
+9. Image Compression                   a. Placeholder Image Generator
+b. QR Code Generator                   c. URL Encode/Decode
+d. Number Base Converter               e. String Encode/Decode (Base64)
+f. Unicode Encode/Decode               g. HTML Entity Encode/Decode
+h. Variable Format Converter           i. JSON Format (Minify/Prettify)
+j. Chinese to Pinyin                   k. Time Format / Timestamp
+l. Time Calculation (Diff/Offset)      m. Color Converter (Hex <-> RGB)
+n. Color Preview                       o. Get UUID
+p. Hash Calculator (MD5/SHA/SM3)       q. Mock Text
+r. Special Characters (Symbols)        s. Emoji Picker
+t. Markdown Snippets                   u. VS Code Snippet Generator
+v. Git Helper (Branch/Commit Template) w. Settings / Language
+0. Exit
+=================================
+```
+
+You can enter a feature key directly, or type a keyword (e.g. `json`, `image`, `git`) to search features and then choose from matched results.
+
+### 📖 Detailed Usage
+
+#### 1. Image <-> Base64
+- Select `1`.
+- **Image -> Base64**:
+  - Select image file.
+  - Output Base64 string (can save to `.txt`).
+- **Base64 -> Image**:
+  - Input Base64 string (file or clipboard).
+  - Auto-detect format and save as file.
+
+#### 2. Image Format Convert
+- Select `2`.
+- Select source image.
+- Select target format (PNG / JPG / WebP).
+- Set quality/compression.
+- Saved in the same directory.
+
+#### Image Compression
+- Select `imgCompress` (menu key).
+- **Input**: File or Folder (batch processing).
+- **Settings**:
+  - Quality (1-100).
+  - Recursive (for folders).
+  - Preserve directory structure.
+  - Suffix option: Add `_compressed_timestamp` or keep original filename.
+- **Output**:
+  - Saved to `compressed_YYYYMMDD_HHmmss` folder.
+  - Auto-copy output path.
+  - Option to open output folder.
+
+#### 3. Placeholder Image Generator
+- Select `3`.
+- **Mode 1: Local Image File**
+  - Generate file locally.
+  - Customize: Size, Colors, Text, Format.
+- **Mode 2: Remote Image URL**
+  - Generate URL and copy to clipboard.
+  - Supports: Picsum Photos, DummyImage, Via Placeholder, Placehold.jp, DevTool Tech, FPO Img.
+
+#### 4. QR Code Generator
+- Select `4`.
+- Input text or URL.
+- Preview in terminal.
+- Option to save as PNG.
 
 #### QR Code Reader
 - Select `qrcodeDecode` (menu key).
@@ -510,92 +533,108 @@ You can enter a feature key directly, or type a keyword (e.g. `json`, `image`, `
   - **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`.
-- Input URL, result auto-copied.
-
-#### 6. String Base64
-- Select `6`.
-- Input sources: Clipboard, File, Manual.
-- Output: Copy, Save to file.
-
-#### 7. Unicode Encode/Decode
-- Select `7`.
-- **Encode**: Text to Unicode escape sequences.
-  - **Non-ASCII Only**: Recommended.
-  - **All Characters**.
-- **Decode**: Unicode to Text.
-
-#### 8. HTML Entity Encode/Decode
-- Select `8`.
-- **Standard**: Special chars only.
-- **Everything**: All chars.
-
-#### 9. Variable Format Converter
-- Select `9`.
-- Input variable name.
-- Shows CamelCase, PascalCase, SnakeCase, KebabCase, ConstantCase.
-- Select one to copy.
-
-#### 10. JSON Format
-- Select `a`.
-- Supports two input sources:
-  - **Clipboard**: Read content directly from clipboard.
-  - **Local file**: Pick by file dialog or enter file path manually.
-- Strictly parses standard JSON and converts to canonical JSON with 2-space indentation.
-- Supports going back to previous step in option lists.
-- **Note**: Results copied to clipboard only (to avoid flooding terminal).
-
-#### 11. Chinese to Pinyin
-- Select `b`.
-- Input Chinese string.
-- Output Pinyin (no tone).
-
-#### 12. Time Format
-- Select `c`.
-- Timestamp <-> Date String.
-- Enter to get current timestamp.
-
-#### 13. Time Calculation
-- Select `d`.
-- **Diff**: Calculate difference between two dates.
-- **Offset**: Calculate date after add/subtract time units.
-
-#### 14. Color Converter
-- Select `e`.
-- Hex <-> RGB.
-
-#### 15. Get UUID
-- Select `f`.
-- Generate UUID v4.
-
-#### 16. Hash Calculator
-- Select `g`.
-- Input text.
-- Shows MD5, SHA1, SHA256, SHA512, SM3.
-
-#### 17. Mock Data
-- Select `h`.
-- Generate Lorem Ipsum, Names, IDs, Emails, Phones, etc.
-
-#### 18. Special Symbols
-- Select `i`.
-- Grid view of symbols.
-- Select index to copy.
-
-#### 19. Emoji Picker
-- Select `j`.
-- Categorized emojis.
-- Select to copy.
-
-#### 20. Markdown Snippets
-- Select `k`.
-- Templates for Headers, Lists, Tables, Links, etc.
-
-#### 21. VS Code Snippet Generator
-- Select `l`.
-- Convert code to `.code-snippets` JSON body.
-- Auto-escapes quotes/newlines.
-- Copied to clipboard.
+
+#### 5. URL Encode/Decode
+- Select `5`.
+- Select `Encode` or `Decode`.
+- Input URL, result auto-copied.
+
+#### 6. String Base64
+- Select `6`.
+- Input sources: Clipboard, File, Manual.
+- Output: Copy, Save to file.
+
+#### 7. Unicode Encode/Decode
+- Select `7`.
+- **Encode**: Text to Unicode escape sequences.
+  - **Non-ASCII Only**: Recommended.
+  - **All Characters**.
+- **Decode**: Unicode to Text.
+
+#### 8. HTML Entity Encode/Decode
+- Select `8`.
+- **Standard**: Special chars only.
+- **Everything**: All chars.
+
+#### 9. Variable Format Converter
+- Select `9`.
+- Input variable name.
+- Shows CamelCase, PascalCase, SnakeCase, KebabCase, ConstantCase.
+- Select one to copy.
+
+#### 10. JSON Format
+- Select `a`.
+- Supports two input sources:
+  - **Clipboard**: Read content directly from clipboard.
+  - **Local file**: Pick by file dialog or enter file path manually.
+- Strictly parses standard JSON and converts to canonical JSON with 2-space indentation.
+- Supports going back to previous step in option lists.
+- **Note**: Results copied to clipboard only (to avoid flooding terminal).
+
+#### 11. Chinese to Pinyin
+- Select `b`.
+- Input Chinese string.
+- Output Pinyin (no tone).
+
+#### 12. Time Format
+- Select `c`.
+- Timestamp <-> Date String.
+- Enter to get current timestamp.
+
+#### 13. Time Calculation
+- Select `d`.
+- **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.
+- Select unit first (Seconds / Minutes / Hours), then enter the value.
+- 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.
+
+#### 15. Get UUID
+- Select `f`.
+- Generate UUID v4.
+
+#### 16. Hash Calculator
+- Select `g`.
+- Input text.
+- Shows MD5, SHA1, SHA256, SHA512, SM3.
+
+#### 17. Mock Data
+- Select `h`.
+- Generate Lorem Ipsum, Names, IDs, Emails, Phones, etc.
+
+#### 18. Special Symbols
+- Select `i`.
+- Grid view of symbols.
+- Select index to copy.
+
+#### 19. Emoji Picker
+- Select `j`.
+- Categorized emojis.
+- Select to copy.
+
+#### 20. Markdown Snippets
+- Select `k`.
+- Templates for Headers, Lists, Tables, Links, etc.
+
+#### 21. VS Code Snippet Generator
+- Select `l`.
+- Convert code to `.code-snippets` JSON body.
+- Auto-escapes quotes/newlines.
+- Copied to clipboard.