xw-devtool-cli 1.0.19 → 1.0.20

package/README.md

@@ -1,6 +1,6 @@
 # xw-devtool-cli
 
-**中文** | [English Documentation](https://unpkg.com/xw-devtool-cli@latest/README_EN.md)
+**中文** | [English](#english)
 
 一个基于 Node.js 的开发者命令行工具箱，旨在提供开箱即用的常用开发工具，帮助开发者快速处理日常任务。
 
@@ -74,31 +74,31 @@ xw-devtool --en  # 英文启动 (Start in English)
 
 ```text
 =================================
-      xw-devtool-cli Menu
+      xw-devtool-cli 菜单
 =================================
-1. Image <-> Base64
-2. Image Format Convert
-3. Placeholder Image Generator
-4. QR Code Generator
-5. URL Encode/Decode
-6. String Encode/Decode (Base64)
-7. Unicode Encode/Decode
-8. HTML Entity Encode/Decode
-9. Variable Format Converter
-a. JSON Format (Minify/Prettify)
-b. Chinese to Pinyin
-c. Time Format / Timestamp
-d. Time Calculation (Diff/Offset)
-e. Color Converter (Hex <-> RGB)
-f. Get UUID
-g. Hash Calculator (MD5/SHA/SM3)
-h. Mock Text
-i. Special Characters (Symbols)
-j. Emoji Picker
-k. Markdown Snippets
-l. VS Code Snippet Generator
-s. Settings (Language)
-0. Exit
+1. 图片 ↔ Base64
+2. 图片格式转换
+3. 占位图生成
+4. 二维码生成
+5. URL 编解码
+6. 字符串 Base64 转换
+7. Unicode 编解码
+8. HTML 实体 编码/解码
+9. 变量格式转换
+a. JSON 格式 (压缩/美化)
+b. 中文转拼音
+c. 时间格式 / 时间戳
+d. 时间计算 (差值/偏移)
+e. 颜色转换 (Hex ↔ RGB)
+f. 获取 UUID
+g. 哈希计算 (MD5/SHA/SM3)
+h. Mock 文本
+i. 特殊符号大全
+j. Emoji 输入
+k. Markdown 语法工具
+l. VS Code 代码段生成器
+s. 设置 (语言)
+0. 退出
 =================================
 ```
 
@@ -269,6 +269,230 @@ s. Settings (Language)
   - **注意**：为防止长文本刷屏，结果**仅自动复制到剪贴板**，不会在终端打印。
   - **提示**：生成的代码段会自动包含语法速查表 (Syntax Cheatsheet) 作为注释，方便参考。
 
-## 📄 License
+ ## 📄 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, 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, with adjustable compression quality.
+  - **Image ↔ Base64**: Convert images to Base64 strings and vice versa.
+  - **Placeholder Image**: Quickly generate placeholder images with custom size, color, and text.
+- **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)
+```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
+```
 
-ISC
+### 🚀 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. Placeholder Image Generator
+4. QR Code Generator
+5. URL Encode/Decode
+6. String Encode/Decode (Base64)
+7. Unicode Encode/Decode
+8. HTML Entity Encode/Decode
+9. Variable Format Converter
+a. JSON Format (Minify/Prettify)
+b. Chinese to Pinyin
+c. Time Format / Timestamp
+d. Time Calculation (Diff/Offset)
+e. Color Converter (Hex <-> RGB)
+f. Get UUID
+g. Hash Calculator (MD5/SHA/SM3)
+h. Mock Text
+i. Special Characters (Symbols)
+j. Emoji Picker
+k. Markdown Snippets
+l. VS Code Snippet Generator
+s. 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.
+
+#### 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.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xw-devtool-cli",
-  "version": "1.0.19",
+  "version": "1.0.20",
   "type": "module",
   "description": "基于node的开发者助手cli",
   "main": "index.js",