xw-devtool-cli 1.0.37 → 1.0.39

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 代码段生成、当前目录树生成等。所有结果均自动复制到剪贴板，极大提升开发效率。
 
 ## ✨ 功能特性
 
@@ -15,13 +15,14 @@
   - **图片分割**：支持网格等分（自定义行/列数）或自定义分割线（像素/百分比），自动生成分割后的图片文件。
   - **图片主色识别**：提取图片主色调（Hex/RGB/HSL/HSV），默认复制 Hex 到剪贴板，支持保存详细信息到文件。
   - **颜色吸取**：从图片中吸取单像素颜色或区域平均颜色，支持 px/% 坐标输入，结果显示颜色条并自动复制 Hex/Hex8。
-  - **屏幕取色**：直接在屏幕上将鼠标移动到目标位置按 **空格键** 即可取色。
-    > **注意事项**：
-    > 1. 使用前请确保命令行窗口处于 **激活状态** (Focus)。
-    > 2. 由于涉及跨进程通信，按下空格后可能存在轻微延时，请耐心等待结果。
-    > 3. 取色模式下会显示全屏十字辅助线，按 **回车键** 退出模式。
+  - **屏幕取色**：实时显示鼠标所在位置的颜色值（Hex/RGB）。
+    > **操作说明**：
+    > 1. 进入模式后，屏幕右下角会实时显示当前颜色预览和数值。
+    > 2. 移动鼠标到目标位置，按 **Enter 键** 复制当前颜色 Hex 到剪贴板（会有成功提示）。
+    > 3. 按 **ESC 键** 退出取色模式。
+    > 4. 支持多显示器。
   - **占位图生成**：快速生成指定尺寸、颜色、文字的占位图片 (Placeholder Image)。
-  - **全屏十字辅助线**：显示跟随鼠标的全屏红色十字线，用于屏幕对齐和定位。
+  - **全屏十字辅助线**：显示跟随鼠标的全屏红色十字线，用于屏幕对齐和定位。按 **ESC 键** 退出。
   - **屏幕测距**：点击屏幕上任意两点，测量其像素距离。
   - **屏幕文字标注**：在屏幕上点击并输入文字，进行临时标注。右键撤销，Delete 清空。
   - **图片压缩**：支持文件或文件夹；文件夹可批量压缩其下所有图片（可选包含子文件夹）。支持 PNG/JPG/WebP，质量 1-100；输出文件名带时间戳并复制输出目录到剪贴板。
@@ -50,6 +51,7 @@
   - **Markdown 语法工具**：提供常用 Markdown 语法模板 (Headers, Lists, Tables, Code 等)，一键复制。
   - **VS Code 代码段生成器**：将代码转换为 VS Code Snippet JSON，自动生成语法速查表注释。
   - **Git 助手**: 标准化生成 Git 分支名 (feature/bugfix/custom) 和 Conventional Commits 提交日志。
+  - **当前目录树生成**：生成当前目录的文件树结构，支持指定层级，默认输出全部层级并自动复制到剪贴板。
   - **占位图生成**：自定义尺寸、背景色、文字颜色和格式生成占位图。
 - **便捷操作**：
   - 支持文件选择对话框 (Windows)。
@@ -100,29 +102,39 @@ xw-devtool --en  # 英文启动 (Start in English)
 =================================
       xw-devtool-cli 菜单
 =================================
-1. 图片 ↔ Base64
+1. 图片 <-> Base64
 2. 图片格式转换
-3. 占位图生成
+3. 图片分割工具
 4. 图片主色识别
-5. 二维码生成
-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. 设置 (语言)
+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. 退出
 =================================
 ```
@@ -146,6 +158,27 @@ s. 设置 (语言)
 - 生成的新图片将保存在源文件同级目录。
 - 生成 ICO 时可自定义尺寸，留空默认生成 `256` 尺寸；输出文件名包含时间戳。
 
+### 图片压缩
+- 选择 `imgCompress` (菜单对应数字/字母) 进入。
+- **支持输入**：
+  - **文件**：单张图片压缩。
+  - **文件夹**：批量压缩文件夹内所有图片（可选是否递归子文件夹）。
+- **参数设置**：
+  - **质量**：推荐 80，也可自定义 1-100。
+  - **文件夹结构**：批量处理时可选保留原目录结构。
+  - **文件名后缀**：可选是否添加 `_compressed_时间戳` 后缀。如果不添加，将保持原文件名（建议输出到不同目录以防覆盖）。
+- **输出**：
+  - 默认输出到源目录下的 `compressed_YYYYMMDD_HHmmss` 文件夹。
+  - 自动复制输出目录路径。
+  - 完成后可选直接打开输出目录。
+
+### 当前目录树生成
+- 选择 `w` 进入。
+- 先选择层级模式：
+  - **所有层级**：从当前目录递归到最深层。
+  - **指定层级**：输入层级数字（`0` 表示仅根目录，`1` 表示包含第一层子项）。
+- 生成后的目录树会自动复制到剪贴板，便于粘贴到文档或 Issue 中。
+
 ### 3. 占位图生成 (Placeholder Image)
 - 选择 `3` 进入。
 - **模式 1：本地图片文件 (Local Image File)**
@@ -317,12 +350,15 @@ Key features include: Base64 encoding/decoding, image format conversion, image <
   - **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**: Pick color directly from screen by moving mouse and pressing **Space**.
-    > **Note**:
-    > 1. Ensure the terminal window is **Focused** before use.
-    > 2. There might be a slight delay after pressing Space due to system calls.
-    > 3. A full-screen crosshair is shown in picking mode; press **Enter** to exit.
+  - **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.
@@ -385,28 +421,22 @@ The interactive menu will appear:
 =================================
       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)
+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
 =================================
 ```
@@ -429,6 +459,19 @@ s. Settings (Language)
 - 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**

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, 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, 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. All results are automatically copied to the clipboard, greatly improving development efficiency.
 
 ## ✨ Features
 
@@ -45,6 +45,7 @@ Key features include: Base64 encoding/decoding, image format conversion, image <
   - **Markdown Snippets**: Common Markdown templates.
   - **VS Code Snippets**: Generate VS Code snippet JSON from code.
   - **Git Helper**: Generate standardized Git branch names (feature/bugfix) and Conventional Commits messages.
+  - **Current Directory Tree**: Generate the file tree for the current directory, with optional depth limit (default: all levels), and copy result to clipboard.
 - **Convenience**:
   - File selection dialog (Windows).
   - Auto-copy results to clipboard.
@@ -119,6 +120,7 @@ i. Special Characters (Symbols)
 j. Emoji Picker
 k. Markdown Snippets
 l. VS Code Snippet Generator
+m. Current Directory Tree
 s. Settings (Language)
 0. Exit
 =================================

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xw-devtool-cli",
-  "version": "1.0.37",
+  "version": "1.0.39",
   "type": "module",
   "description": "基于node的开发者助手cli",
   "main": "index.js",
@@ -59,7 +59,9 @@
     "git",
     "git-branch",
     "commit-message",
-    "conventional-commits"
+    "conventional-commits",
+    "directory-tree",
+    "file-tree"
   ],
   "author": "npmxw",
   "license": "ISC",
@@ -74,6 +76,7 @@
     "url": "https://gitee.com/github-9819409/xw-devtool-cli/issues"
   },
   "dependencies": {
+    "cli-table3": "^0.6.5",
     "clipboardy": "^5.0.2",
     "commander": "^14.0.2",
     "dayjs": "^1.11.19",
@@ -85,7 +88,7 @@
     "qrcode": "^1.5.4",
     "sharp": "^0.33.5",
     "tinycolor2": "^1.6.0",
-    "uuid": "^13.0.0",
-    "to-ico": "^1.1.5"
+    "to-ico": "^1.1.5",
+    "uuid": "^13.0.0"
   }
 }

package/src/commands/fileTree.js

@@ -0,0 +1,90 @@
+import fs from 'fs';
+import path from 'path';
+import inquirer from 'inquirer';
+import i18next from '../i18n.js';
+import { selectFromMenu } from '../utils/menu.js';
+import { copy } from '../utils/clipboard.js';
+
+export async function fileTreeHandler() {
+    const mode = await selectFromMenu(
+        i18next.t('fileTree.depthMode'),
+        [
+            { name: i18next.t('fileTree.allDepth'), value: 'all' },
+            { name: i18next.t('fileTree.customDepth'), value: 'custom' }
+        ],
+        true,
+        i18next.t('common.back')
+    );
+
+    if (mode === '__BACK__') {
+        return;
+    }
+
+    let maxDepth = Infinity;
+    if (mode === 'custom') {
+        const { depth } = await inquirer.prompt([
+            {
+                type: 'input',
+                name: 'depth',
+                message: i18next.t('fileTree.depthPrompt'),
+                validate: (input) => {
+                    const value = Number.parseInt(input, 10);
+                    if (!Number.isInteger(value) || value < 0) {
+                        return i18next.t('fileTree.depthInvalid');
+                    }
+                    return true;
+                }
+            }
+        ]);
+        maxDepth = Number.parseInt(depth, 10);
+    }
+
+    const cwd = process.cwd();
+    const tree = buildTree(cwd, maxDepth);
+    const depthText = Number.isFinite(maxDepth) ? String(maxDepth) : i18next.t('fileTree.allDepth');
+
+    console.log(i18next.t('fileTree.generated', { path: cwd, depth: depthText }));
+    const preview = tree.length > 2000 ? `${tree.slice(0, 1000)}\n...\n${tree.slice(-800)}` : tree;
+    console.log(`\n${preview}\n`);
+    await copy(tree);
+}
+
+export function buildTree(rootPath, maxDepth) {
+    const rootName = path.basename(rootPath) || rootPath;
+    const lines = [rootName];
+
+    walkDir(rootPath, '', 0, maxDepth, lines);
+
+    return lines.join('\n');
+}
+
+function walkDir(currentPath, prefix, depth, maxDepth, lines) {
+    if (depth >= maxDepth) {
+        return;
+    }
+
+    let entries = [];
+    try {
+        entries = fs.readdirSync(currentPath, { withFileTypes: true });
+    } catch (error) {
+        lines.push(`${prefix}└── [${i18next.t('fileTree.readFailed')}: ${error.message}]`);
+        return;
+    }
+
+    entries.sort((a, b) => {
+        if (a.isDirectory() && !b.isDirectory()) return -1;
+        if (!a.isDirectory() && b.isDirectory()) return 1;
+        return a.name.localeCompare(b.name, undefined, { sensitivity: 'base' });
+    });
+
+    entries.forEach((entry, index) => {
+        const isLast = index === entries.length - 1;
+        const connector = isLast ? '└── ' : '├── ';
+        lines.push(`${prefix}${connector}${entry.name}`);
+
+        if (entry.isDirectory()) {
+            const nextPrefix = `${prefix}${isLast ? '    ' : '│   '}`;
+            walkDir(path.join(currentPath, entry.name), nextPrefix, depth + 1, maxDepth, lines);
+        }
+    });
+}

package/src/index.js

@@ -1,5 +1,6 @@
 import inquirer from 'inquirer';
 import { Command } from 'commander';
+import Table from 'cli-table3';
 import i18next from './i18n.js';
 import { saveConfig } from './utils/config.js';
 
@@ -34,6 +35,7 @@ import { pixelDistanceHandler } from './commands/pixelDistance.js';
 import { screenMarkHandler } from './commands/screenMark.js';
 import { gitHelperHandler } from './commands/gitHelper.js';
 import { imgCompressHandler } from './commands/imgCompress.js';
+import { fileTreeHandler } from './commands/fileTree.js';
 
 process.on('SIGINT', () => {
     console.log(`\n${i18next.t('menu.bye')}`);
@@ -90,6 +92,7 @@ function getFeatures() {
         { name: i18next.t('menu.features.markdown'), value: 'markdown' },
         { name: i18next.t('menu.features.vscodeSnippet'), value: 'vscodeSnippet' },
         { name: i18next.t('menu.features.gitHelper'), value: 'gitHelper' },
+        { name: i18next.t('menu.features.fileTree'), value: 'fileTree' },
         
         // Settings
         { name: i18next.t('menu.features.settings'), value: 'settings' }
@@ -134,10 +137,31 @@ async function showMenu() {
     console.log('\n=================================');
     console.log(`      ${i18next.t('menu.title')}`);
     console.log('=================================');
-    features.forEach((feature, index) => {
-        console.log(`${getFeatureKey(index)}. ${feature.name}`);
+
+    // Prepare items for table
+    const items = features.map((feature, index) => `${getFeatureKey(index)}. ${feature.name}`);
+    items.push(`0. ${i18next.t('menu.exit')}`);
+
+    // Configure table
+    const table = new Table({
+        chars: {
+            'top': '', 'top-mid': '', 'top-left': '', 'top-right': '',
+            'bottom': '', 'bottom-mid': '', 'bottom-left': '', 'bottom-right': '',
+            'left': '', 'left-mid': '', 'mid': '', 'mid-mid': '',
+            'right': '', 'right-mid': '', 'middle': '   '
+        },
+        style: { 'padding-left': 0, 'padding-right': 0 },
+        colWidths: [40, 40]
     });
-    console.log(`0. ${i18next.t('menu.exit')}`);
+    
+    // Add items to table in pairs
+    const columns = 2;
+    for (let i = 0; i < items.length; i += columns) {
+        const row = items.slice(i, i + columns);
+        table.push(row);
+    }
+
+    console.log(table.toString());
     console.log('=================================\n');
 
     const { choice } = await inquirer.prompt([
@@ -271,6 +295,9 @@ async function handleAction(action) {
         case 'gitHelper':
             await gitHelperHandler();
             break;
+        case 'fileTree':
+            await fileTreeHandler();
+            break;
         case 'settings':
             await handleSettings();
             break;

package/src/locales/en.js

@@ -64,6 +64,7 @@ export default {
             markdown: 'Markdown Snippets',
             vscodeSnippet: 'VS Code Snippet Generator',
             gitHelper: 'Git Helper (Branch/Commit Template)',
+            fileTree: 'Current Directory Tree',
             settings: 'Settings / Language'
         }
     },
@@ -157,5 +158,14 @@ export default {
         scanResult: 'Images found',
         preservePrompt: 'Preserve original directory structure in output?',
         suffixPrompt: 'Append filename suffix (compressed + timestamp)?'
+    },
+    fileTree: {
+        depthMode: 'Select tree depth mode',
+        allDepth: 'All levels',
+        customDepth: 'Specify depth',
+        depthPrompt: 'Enter depth (0 means root only):',
+        depthInvalid: 'Please enter an integer greater than or equal to 0',
+        generated: 'Directory tree generated (path: {{path}}, depth: {{depth}}) and copied to clipboard',
+        readFailed: 'Failed to read directory'
     }
 };

package/src/locales/zh.js

@@ -64,6 +64,7 @@ export default {
             markdown: 'Markdown 片段',
             vscodeSnippet: 'VS Code 代码片段生成',
             gitHelper: 'Git 助手 (分支/提交模板)',
+            fileTree: '当前目录树生成',
             settings: '设置 / 语言 (Settings)'
         }
     },
@@ -158,5 +159,14 @@ export default {
         preservePrompt: '递归时是否按原始目录结构输出'
         ,
         suffixPrompt: '是否在文件名添加后缀（compressed+时间戳）'
+    },
+    fileTree: {
+        depthMode: '请选择目录树生成层级',
+        allDepth: '所有层级',
+        customDepth: '指定层级',
+        depthPrompt: '请输入层级（0 表示仅根目录）:',
+        depthInvalid: '请输入大于等于 0 的整数',
+        generated: '目录树已生成（路径: {{path}}，层级: {{depth}}），已复制到剪贴板',
+        readFailed: '读取目录失败'
     }
 };