xw-devtool-cli

中文 | 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 图片（带时间戳文件名）。
  • 特殊符号大全：包含常用符号、箭头、数学符号、货币、希腊字母等 170+ 个符号，支持一键复制。
  • Emoji 输入：支持分类查看和选择常用 Emoji，一键复制到剪贴板。
  • HTML 实体工具：支持 HTML 实体编码与解码 (如 & <-> &)。
  • Markdown 语法工具：提供常用 Markdown 语法模板 (Headers, Lists, Tables, Code 等)，一键复制。
  • VS Code 代码段生成器：将代码转换为 VS Code Snippet JSON，自动生成语法速查表注释。
  • Git 助手: 标准化生成 Git 分支名 (feature/bugfix/custom) 和 Conventional Commits 提交日志。
  • 占位图生成：自定义尺寸、背景色、文字颜色和格式生成占位图。
• 便捷操作：
  • 支持文件选择对话框 (Windows)。
  • 结果自动复制到剪贴板。
  • 支持从剪贴板自动读取输入（部分工具支持直接回车读取）。
  • 支持将大文本结果保存为文件。
• 多语言支持 (i18n)：
• 支持 中文 和 English。
• 可通过菜单中的 Settings 切换，或使用命令行参数：xw-devtool --zh / xw-devtool --en。

🖥️ 系统支持说明（Windows 专属功能）

• 屏幕取色（来源：屏幕）仅支持 Windows；来源为图片的取色跨平台可用
• 全屏十字辅助线 仅支持 Windows
• 屏幕测距（像素）仅支持 Windows
• 屏幕文字标注 仅支持 Windows
• 文件选择/保存对话框 仅支持 Windows；在非 Windows 平台请手动输入文件路径或使用命令行默认路径

📦 安装

全局安装 (推荐)

npm install -g xw-devtool-cli

安装后即可在终端直接使用 xw-devtool 或 xw-dev 命令。

免安装运行 (npx)

npx xw-devtool-cli@latest

🚀 快速开始

在终端运行：

xw-devtool

或者指定语言启动：

xw-devtool --zh  # 中文启动
xw-devtool --en  # 英文启动 (Start in English)

启动后将显示交互式菜单，通过键盘输入对应的数字或字母选择功能：

=================================
      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. 设置 / 语言 (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 文件夹。
  • 自动复制输出目录路径。
  • 完成后可选直接打开输出目录。

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 图片，默认文件名包含时间戳。

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 进入。
• 支持三种模式：
  • Minify: 压缩 JSON (去除空格和换行)。
  • Prettify (2 spaces): 美化 JSON (2 空格缩进)。
  • Prettify (4 spaces): 美化 JSON (4 空格缩进)。
• 支持自动修复简单的非标准 JSON (如 key 缺少引号的 JS 对象)。
• 支持从剪贴板、文件或手动输入读取。
• 注意：为防止长文本刷屏，结果仅自动复制到剪贴板，不会在终端打印。

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 | 中文

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.

✨ 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.
  • 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)

npm install -g xw-devtool-cli

After installation, use xw-devtool or xw-dev command.

Run via npx

npx xw-devtool-cli@latest

🚀 Quick Start

Run in terminal:

xw-devtool

Or specify language directly:

xw-devtool --en  # Start in English
xw-devtool --zh  # Start in Chinese

The interactive menu will appear:

=================================
      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
=================================

📖 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.

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.
• Minify: Remove whitespace.
• Prettify (2/4 spaces).
• 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.