xw-devtool-cli 1.0.23 → 1.0.25

package/README.md

@@ -14,6 +14,8 @@
   - **图片 ↔ Base64**：支持图片转 Base64 字符串，以及 Base64 还原为图片文件。
   - **图片分割**：支持网格等分（自定义行/列数）或自定义分割线（像素/百分比），自动生成分割后的图片文件。
   - **图片主色识别**：提取图片主色调（Hex/RGB/HSL/HSV），默认复制 Hex 到剪贴板，支持保存详细信息到文件。
+  - **颜色吸取**：从图片中吸取单像素颜色或区域平均颜色，支持 px/% 坐标输入，结果显示颜色条并自动复制 Hex/Hex8。
+  - **屏幕取色**：无需选择图片，直接在屏幕上将鼠标移动到目标位置按回车即可取色，支持透明度显示和预览。
   - **占位图生成**：快速生成指定尺寸、颜色、文字的占位图片 (Placeholder Image)。
 - **Mock 数据生成**：
   - 支持生成：英文段落 (Lorem Ipsum)、中文字符、中国居民身份证号、电子邮箱、URL、订单号、手机号、座机号。
@@ -27,7 +29,8 @@
   - **Unicode 编解码**：文本与 Unicode 转义序列 (\uXXXX) 互转。
   - **UUID**：生成 UUID v4。
   - **中文转拼音**：将汉字转换为不带声调的拼音。
-  - **颜色转换**：Hex <-> RGB 互转。
+  - **颜色转换**：Hex <-> RGB 互转，并在结果中显示颜色条预览（支持透明度棋盘背景），自动复制 Hex。
+  - **颜色预览**：输入颜色并在终端显示颜色条，便于快速视觉确认，同时自动复制 Hex 到剪贴板。
   - **变量格式转换**：支持 CamelCase, PascalCase, SnakeCase, KebabCase, ConstantCase 互转。
   - **哈希计算**：支持 MD5, SHA1, SHA256, SHA512, SM3 算法。
   - **二维码生成**：终端直接显示二维码，支持保存为 PNG 图片（带时间戳文件名）。

package/README_EN.md

@@ -14,6 +14,8 @@ Key features include: Base64 encoding/decoding, image format conversion, image <
   - **Image ↔ Base64**: Convert images to Base64 strings and vice versa.
   - **Image Splitter**: Split images into grid (rows/cols) or custom split lines (pixels/percentage).
   - **Placeholder Image**: Quickly generate placeholder images with custom size, color, and text.
+  - **Color Picker**: Pick a single pixel color or area average from an image; supports px/% coordinates; shows preview bar and auto-copies Hex/Hex8.
+  - **Screen Picker**: Pick color directly from the screen at the mouse position; move the cursor and press Enter to sample; supports alpha preview.
 - **Mock Data**:
   - Generate: Lorem Ipsum, Chinese characters, ID cards, Emails, URLs, Order IDs, Phone numbers.
   - Supports batch generation.
@@ -26,7 +28,8 @@ Key features include: Base64 encoding/decoding, image format conversion, image <
   - **Unicode Encode/Decode**: Text <-> Unicode escape sequences (\uXXXX).
   - **UUID**: Generate UUID v4.
   - **Pinyin**: Convert Chinese characters to Pinyin (without tone).
-  - **Color Converter**: Hex <-> RGB.
+  - **Color Converter**: Hex <-> RGB, and shows a color bar preview in results (with checkerboard alpha simulation); Hex auto-copied.
+  - **Color Preview**: Enter a color and display a color bar in terminal for quick visual confirmation; Hex is auto-copied to clipboard.
   - **Variable Format**: CamelCase, PascalCase, SnakeCase, KebabCase, ConstantCase.
   - **Hash Calculator**: MD5, SHA1, SHA256, SHA512, SM3.
   - **QR Code**: Display QR codes in terminal, save as PNG.

package/package.json

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

package/src/commands/color.js

@@ -2,6 +2,38 @@ import inquirer from 'inquirer';
 import tinycolor from 'tinycolor2';
 import { copy } from '../utils/clipboard.js';
 import { selectFromMenu } from '../utils/menu.js';
+import i18next from '../i18n.js';
+
+function blend(fg, bg, alpha) {
+    const a = Math.max(0, Math.min(1, alpha ?? 1));
+    return {
+        r: Math.round(a * fg.r + (1 - a) * bg.r),
+        g: Math.round(a * fg.g + (1 - a) * bg.g),
+        b: Math.round(a * fg.b + (1 - a) * bg.b),
+    };
+}
+
+function printColorBar(rgb, width = 50, height = 2, label = '', alpha = 1) {
+    const reset = '\x1b[0m';
+    const block = ' ';
+    if (label) {
+        console.log(label);
+    }
+    const useChecker = alpha < 1;
+    const bg1 = { r: 255, g: 255, b: 255 };
+    const bg2 = { r: 204, g: 204, b: 204 };
+    for (let row = 0; row < height; row++) {
+        let line = '';
+        for (let col = 0; col < width; col++) {
+            const checker = ((Math.floor(row / 1) + Math.floor(col / 2)) % 2 === 0) ? bg1 : bg2;
+            const blended = useChecker ? blend(rgb, checker, alpha) : rgb;
+            const bg = `\x1b[48;2;${blended.r};${blended.g};${blended.b}m`;
+            line += `${bg}${block}`;
+        }
+        line += reset;
+        console.log(line);
+    }
+}
 
 export async function colorHandler() {
     const { input } = await inquirer.prompt([
@@ -17,6 +49,11 @@ export async function colorHandler() {
     ]);
 
     const color = tinycolor(input);
+    const rgbBar = color.toRgb();
+    const alpha = typeof rgbBar.a === 'number' ? rgbBar.a : 1;
+    const hexBar = alpha < 1 ? color.toHex8String().toUpperCase() : color.toHexString().toUpperCase();
+    const label = `${i18next.t('colorPreview.preview')} ${hexBar} ${color.toRgbString()} ${color.toHslString()}`;
+    printColorBar(rgbBar, 50, 2, label, alpha);
     
     const results = [];
     results.push(`Hex: ${color.toHexString().toUpperCase()}`);

package/src/commands/colorPick.js

@@ -0,0 +1,359 @@
+import inquirer from 'inquirer';
+import { execSync, spawn } from 'child_process';
+import fs from 'fs';
+import path from 'path';
+import sharp from 'sharp';
+import tinycolor from 'tinycolor2';
+import i18next from '../i18n.js';
+import { selectFromMenu } from '../utils/menu.js';
+import { selectFile } from '../utils/fileDialog.js';
+import { copy } from '../utils/clipboard.js';
+
+function parseUnit(input, total) {
+    const s = String(input).trim();
+    if (s.endsWith('%')) {
+        const p = parseFloat(s.slice(0, -1));
+        return Math.round((p / 100) * total);
+    }
+    if (s.endsWith('px')) {
+        return Math.round(parseFloat(s.slice(0, -2)));
+    }
+    return Math.round(parseFloat(s));
+}
+
+function clamp(n, min, max) {
+    return Math.max(min, Math.min(max, n));
+}
+
+function blend(fg, bg, alpha) {
+    const a = Math.max(0, Math.min(1, alpha ?? 1));
+    return {
+        r: Math.round(a * fg.r + (1 - a) * bg.r),
+        g: Math.round(a * fg.g + (1 - a) * bg.g),
+        b: Math.round(a * fg.b + (1 - a) * bg.b),
+    };
+}
+
+function printColorBar(rgb, width = 50, height = 2, label = '', alpha = 1) {
+    const reset = '\x1b[0m';
+    const block = ' ';
+    if (label) console.log(label);
+    const useChecker = alpha < 1;
+    const bg1 = { r: 255, g: 255, b: 255 };
+    const bg2 = { r: 204, g: 204, b: 204 };
+    for (let row = 0; row < height; row++) {
+        let line = '';
+        for (let col = 0; col < width; col++) {
+            const checker = ((Math.floor(row / 1) + Math.floor(col / 2)) % 2 === 0) ? bg1 : bg2;
+            const blended = useChecker ? blend(rgb, checker, alpha) : rgb;
+            const bg = `\x1b[48;2;${blended.r};${blended.g};${blended.b}m`;
+            line += `${bg}${block}`;
+        }
+        line += reset;
+        console.log(line);
+    }
+}
+
+async function pickInputFile() {
+    const method = await selectFromMenu(
+        i18next.t('colorPick.inputMethod'),
+        [
+            { name: i18next.t('colorPick.inputDialog'), value: 'dialog' },
+            { name: i18next.t('colorPick.inputManual'), value: 'manual' }
+        ],
+        true,
+        i18next.t('colorPick.backPrev')
+    );
+    if (method === '__BACK__') return '__BACK__';
+    let filePath = '';
+    if (method === 'dialog') {
+        filePath = selectFile('Image Files|*.png;*.jpg;*.jpeg;*.webp|All Files|*.*') || '';
+    }
+    if (!filePath) {
+        const { filePath: fp } = await inquirer.prompt([
+            {
+                type: 'input',
+                name: 'filePath',
+                message: i18next.t('colorPick.enterPath'),
+                validate: (p) => (fs.existsSync(p) ? true : i18next.t('colorPick.notExist'))
+            }
+        ]);
+        filePath = fp;
+    }
+    return filePath;
+}
+
+async function pickPixel(image, width, height) {
+    const answers = await inquirer.prompt([
+        { type: 'input', name: 'x', message: i18next.t('colorPick.xPrompt') },
+        { type: 'input', name: 'y', message: i18next.t('colorPick.yPrompt') }
+    ]);
+    const x = clamp(parseUnit(answers.x, width), 0, width - 1);
+    const y = clamp(parseUnit(answers.y, height), 0, height - 1);
+    const buf = await image.ensureAlpha().extract({ left: x, top: y, width: 1, height: 1 }).raw().toBuffer();
+    const r = buf[0], g = buf[1], b = buf[2], a = buf[3] / 255;
+    return { r, g, b, a, region: { left: x, top: y, width: 1, height: 1 } };
+}
+
+async function pickAreaAverage(image, width, height) {
+    const answers = await inquirer.prompt([
+        { type: 'input', name: 'x1', message: i18next.t('colorPick.x1Prompt') },
+        { type: 'input', name: 'y1', message: i18next.t('colorPick.y1Prompt') },
+        { type: 'input', name: 'x2', message: i18next.t('colorPick.x2Prompt') },
+        { type: 'input', name: 'y2', message: i18next.t('colorPick.y2Prompt') }
+    ]);
+    let x1 = clamp(parseUnit(answers.x1, width), 0, width - 1);
+    let y1 = clamp(parseUnit(answers.y1, height), 0, height - 1);
+    let x2 = clamp(parseUnit(answers.x2, width), 0, width);
+    let y2 = clamp(parseUnit(answers.y2, height), 0, height);
+    if (x2 < x1) [x1, x2] = [x2, x1];
+    if (y2 < y1) [y1, y2] = [y2, y1];
+    const w = Math.max(1, x2 - x1);
+    const h = Math.max(1, y2 - y1);
+    const region = { left: x1, top: y1, width: w, height: h };
+    const buf = await image.ensureAlpha().extract(region).raw().toBuffer();
+    let sr = 0, sg = 0, sb = 0, sa = 0;
+    for (let i = 0; i < buf.length; i += 4) {
+        sr += buf[i];
+        sg += buf[i + 1];
+        sb += buf[i + 2];
+        sa += buf[i + 3];
+    }
+    const n = buf.length / 4;
+    const r = Math.round(sr / n);
+    const g = Math.round(sg / n);
+    const b = Math.round(sb / n);
+    const a = Math.round(sa / n) / 255;
+    return { r, g, b, a, region };
+}
+
+export async function colorPickHandler() {
+    const source = await selectFromMenu(
+        i18next.t('colorPick.source'),
+        [
+            { name: i18next.t('colorPick.sourceScreen'), value: 'screen' },
+            { name: i18next.t('colorPick.sourceImage'), value: 'image' }
+        ],
+        true,
+        i18next.t('colorPick.backPrev')
+    );
+    if (source === '__BACK__') return;
+
+    let picked;
+    if (source === 'screen') {
+        if (process.platform !== 'win32') {
+            console.log(i18next.t('colorPick.notSupported'));
+            return;
+        }
+        let overlay = null;
+        let sampler = null;
+        const readOneLine = (timeoutMs = 800) => new Promise((resolve) => {
+            let settled = false;
+            const onData = (buf) => {
+                if (settled) return;
+                settled = true;
+                resolve(buf.toString('utf8').trim());
+            };
+            sampler.stdout.once('data', onData);
+            if (timeoutMs > 0) {
+                setTimeout(() => {
+                    if (settled) return;
+                    settled = true;
+                    try { sampler.stdout.removeListener('data', onData); } catch {}
+                    resolve(null);
+                }, timeoutMs);
+            }
+        });
+        try {
+            const overlayScript = `
+Add-Type -AssemblyName System.Windows.Forms; Add-Type -AssemblyName System.Drawing;
+Add-Type -TypeDefinition @'
+using System;
+using System.Drawing;
+using System.Windows.Forms;
+using System.Runtime.InteropServices;
+public class OverlayForm : Form {
+ const int WS_EX_TRANSPARENT=0x20;
+ const int WS_EX_LAYERED=0x80000;
+ const int GWL_EXSTYLE=-20;
+ [DllImport("user32.dll")] static extern int GetWindowLong(IntPtr hWnd, int nIndex);
+ [DllImport("user32.dll")] static extern int SetWindowLong(IntPtr hWnd, int nIndex, int dwNewLong);
+ Timer t;
+ public OverlayForm(){
+  this.FormBorderStyle=FormBorderStyle.None;
+  this.TopMost=true;
+  this.ShowInTaskbar=false;
+  this.WindowState=FormWindowState.Maximized;
+  this.BackColor=Color.Fuchsia;
+  this.TransparencyKey=this.BackColor;
+  this.DoubleBuffered=true;
+ }
+ protected override void OnShown(EventArgs e){
+  base.OnShown(e);
+  int ex=GetWindowLong(this.Handle,GWL_EXSTYLE);
+  SetWindowLong(this.Handle,GWL_EXSTYLE,ex|WS_EX_LAYERED|WS_EX_TRANSPARENT);
+  t=new Timer();
+  t.Interval=33;
+  t.Tick+=(s,ev)=>{ this.Invalidate(); };
+  t.Start();
+ }
+ protected override void OnPaint(PaintEventArgs e){
+  var p=Cursor.Position;
+  var g=e.Graphics;
+  int gap=16;
+  using(var pen=new Pen(Color.Red,1)){
+   g.DrawLine(pen,0,p.Y,Math.Max(0,p.X-gap),p.Y);
+   g.DrawLine(pen,Math.Min(this.Width,p.X+gap),p.Y,this.Width,p.Y);
+   g.DrawLine(pen,p.X,0,p.X,Math.Max(0,p.Y-gap));
+   g.DrawLine(pen,p.X,Math.Min(this.Height,p.Y+gap),p.X,this.Height);
+  }
+ }
+}
+public static class Entry {
+ public static void Main(){ Application.EnableVisualStyles(); Application.SetCompatibleTextRenderingDefault(false); Application.Run(new OverlayForm()); }
+}
+'@ -ReferencedAssemblies System.Windows.Forms,System.Drawing;
+[Entry]::Main()
+`;
+            overlay = spawn('powershell', ['-NoProfile', '-Command', overlayScript], { windowsHide: true });
+            const samplerScript = `
+Add-Type -TypeDefinition @'
+using System;
+using System.Runtime.InteropServices;
+public static class ColorSampler {
+    [StructLayout(LayoutKind.Sequential)]
+    public struct POINT { public int X; public int Y; }
+    [DllImport("user32.dll")] static extern bool GetCursorPos(out POINT lpPoint);
+    [DllImport("user32.dll")] static extern IntPtr GetDC(IntPtr hWnd);
+    [DllImport("user32.dll")] static extern int ReleaseDC(IntPtr hWnd, IntPtr hDC);
+    [DllImport("gdi32.dll")] static extern int GetPixel(IntPtr hdc, int x, int y);
+    public static string Sample() {
+        POINT p;
+        if(!GetCursorPos(out p)) return "";
+        IntPtr hdc = GetDC(IntPtr.Zero);
+        if (hdc == IntPtr.Zero) return "";
+        int color = GetPixel(hdc, p.X, p.Y);
+        ReleaseDC(IntPtr.Zero, hdc);
+        if (color == -1) return "";
+        int r = color & 0xFF;
+        int g = (color >> 8) & 0xFF;
+        int b = (color >> 16) & 0xFF;
+        return $"{r},{g},{b},255";
+    }
+}
+'@
+function Sample {
+ $s=[ColorSampler]::Sample();
+ if([string]::IsNullOrEmpty($s)){ [Console]::Out.WriteLine(""); } else { [Console]::Out.WriteLine($s) }
+}
+while($true){
+ $line = [Console]::In.ReadLine();
+ if($line -eq $null){ break }
+ if($line -eq 'SAMPLE'){ Sample }
+ elseif($line -eq 'EXIT'){ break }
+}
+`;
+            sampler = spawn('powershell', ['-NoProfile', '-Command', samplerScript], { windowsHide: true, stdio: ['pipe', 'pipe', 'ignore'] });
+            try { sampler.stdout.setEncoding('utf8'); } catch {}
+        } catch {}
+        console.log(i18next.t('colorPick.moveMousePrompt'));
+        let last = null;
+        const sampleOnce = async () => {
+            try {
+                let out = null;
+                if (sampler && sampler.stdin && !sampler.killed) {
+                    sampler.stdin.write('SAMPLE\n');
+                    out = await readOneLine(800);
+                }
+                if (!out) {
+                    const cmd = `powershell -NoProfile -Command "Add-Type -AssemblyName System.Windows.Forms; Add-Type -AssemblyName System.Drawing; $p=[System.Windows.Forms.Cursor]::Position; $bmp=New-Object System.Drawing.Bitmap 1,1; $g=[System.Drawing.Graphics]::FromImage($bmp); $g.CopyFromScreen($p.X,$p.Y,0,0,[System.Drawing.Size]::new(1,1)); $c=$bmp.GetPixel(0,0); Write-Output (\\"$($c.R),$($c.G),$($c.B),255\\"); $g.Dispose(); $bmp.Dispose();"`;
+                    out = execSync(cmd, { stdio: ['pipe', 'pipe', 'ignore'] }).toString('utf8').trim();
+                }
+                const parts = out.split(',').map(n => parseInt(n, 10));
+                const r = parts[0], g = parts[1], b = parts[2];
+                last = { r, g, b, a: 1 };
+                const tc = tinycolor({ r: last.r, g: last.g, b: last.b, a: last.a });
+                const hex = last.a < 1 ? tc.toHex8String().toUpperCase() : tc.toHexString().toUpperCase();
+                const rgb = tc.toRgbString();
+                const hsl = tc.toHslString();
+                console.log('\n=== ' + i18next.t('colorPick.result') + ' ===');
+                console.log(`Hex: ${hex}`);
+                console.log(`RGB: ${rgb}`);
+                console.log(`HSL: ${hsl}`);
+                console.log('==========================\n');
+                const label = `${i18next.t('colorPreview.preview')} ${hex} ${rgb} ${hsl}`;
+                printColorBar({ r: last.r, g: last.g, b: last.b }, 50, 2, label, last.a);
+                copy(hex);
+            } catch {}
+        };
+        await new Promise((resolve) => {
+            const stdin = process.stdin;
+            try { stdin.setRawMode(true); } catch {}
+            stdin.resume();
+            const onData = (data) => {
+                const s = data.toString('utf8');
+                if (s === ' ') {
+                    sampleOnce();
+                } else if (s === '\r' || s === '\n') {
+                    stdin.removeListener('data', onData);
+                    try { stdin.setRawMode(false); } catch {}
+                    stdin.pause();
+                    resolve();
+                }
+            };
+            stdin.on('data', onData);
+        });
+        try { if (sampler) { sampler.stdin.write('EXIT\n'); sampler.kill(); } } catch {}
+        try { if (overlay) { overlay.kill(); } } catch {}
+        if (!last) {
+            console.log(i18next.t('colorPick.pickFail'));
+            return;
+        }
+        picked = { r: last.r, g: last.g, b: last.b, a: last.a, region: null };
+    } else {
+        const inputPath = await pickInputFile();
+        if (inputPath === '__BACK__') {
+            return await colorPickHandler();
+        }
+        const image = sharp(inputPath);
+        const meta = await image.metadata();
+        const { width, height } = meta;
+        console.log(`${i18next.t('colorPick.imageInfo')} ${inputPath} (${width}x${height})`);
+
+        const mode = await selectFromMenu(
+            i18next.t('colorPick.mode'),
+            [
+                { name: i18next.t('colorPick.modePixel'), value: 'pixel' },
+                { name: i18next.t('colorPick.modeArea'), value: 'area' },
+            ],
+            true,
+            i18next.t('colorPick.backPrev')
+        );
+        if (mode === '__BACK__') {
+            return await colorPickHandler();
+        }
+
+        if (mode === 'pixel') {
+            picked = await pickPixel(image, width, height);
+        } else {
+            picked = await pickAreaAverage(image, width, height);
+        }
+    }
+
+    const tc = tinycolor({ r: picked.r, g: picked.g, b: picked.b, a: picked.a });
+    const hex = picked.a < 1 ? tc.toHex8String().toUpperCase() : tc.toHexString().toUpperCase();
+    const rgb = tc.toRgbString();
+    const hsl = tc.toHslString();
+
+    console.log('\n=== ' + i18next.t('colorPick.result') + ' ===');
+    console.log(`Hex: ${hex}`);
+    console.log(`RGB: ${rgb}`);
+    console.log(`HSL: ${hsl}`);
+    console.log('==========================\n');
+
+    const label = `${i18next.t('colorPreview.preview')} ${hex} ${rgb} ${hsl}`;
+    printColorBar({ r: picked.r, g: picked.g, b: picked.b }, 50, 2, label, picked.a);
+
+    await copy(hex);
+    console.log(i18next.t('colorPreview.copied', { value: hex }));
+}

package/src/commands/colorPreview.js

@@ -0,0 +1,72 @@
+import inquirer from 'inquirer';
+import tinycolor from 'tinycolor2';
+import { copy } from '../utils/clipboard.js';
+import i18next from '../i18n.js';
+// No width/height selection per user request; fixed size preview
+
+function blend(fg, bg, alpha) {
+    const a = Math.max(0, Math.min(1, alpha ?? 1));
+    return {
+        r: Math.round(a * fg.r + (1 - a) * bg.r),
+        g: Math.round(a * fg.g + (1 - a) * bg.g),
+        b: Math.round(a * fg.b + (1 - a) * bg.b),
+    };
+}
+
+function printColorBar(rgb, width = 50, height = 2, label = '', alpha = 1) {
+    const reset = '\x1b[0m';
+    const block = ' ';
+    if (label) {
+        console.log(label);
+    }
+    const useChecker = alpha < 1;
+    const bg1 = { r: 255, g: 255, b: 255 };
+    const bg2 = { r: 204, g: 204, b: 204 };
+    for (let row = 0; row < height; row++) {
+        let line = '';
+        for (let col = 0; col < width; col++) {
+            const checker = ((Math.floor(row / 1) + Math.floor(col / 2)) % 2 === 0) ? bg1 : bg2;
+            const blended = useChecker ? blend(rgb, checker, alpha) : rgb;
+            const bg = `\x1b[48;2;${blended.r};${blended.g};${blended.b}m`;
+            line += `${bg}${block}`;
+        }
+        line += reset;
+        console.log(line);
+    }
+}
+
+function isAllowedColorFormat(val) {
+    if (!val || typeof val !== 'string') return false;
+    const s = val.trim();
+    const hex = /^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/;
+    const rgb = /^rgb\(\s*(\d{1,3})\s*,\s*(\d{1,3})\s*,\s*(\d{1,3})\s*\)$/i;
+    const rgba = /^rgba\(\s*(\d{1,3})\s*,\s*(\d{1,3})\s*,\s*(\d{1,3})\s*,\s*(?:0|1|0?\.\d+)\s*\)$/i;
+    const hsl = /^hsl\(\s*(\d{1,3})\s*,\s*(\d{1,3})%\s*,\s*(\d{1,3})%\s*\)$/i;
+    const hsla = /^hsla\(\s*(\d{1,3})\s*,\s*(\d{1,3})%\s*,\s*(\d{1,3})%\s*,\s*(?:0|1|0?\.\d+)\s*\)$/i;
+    return hex.test(s) || rgb.test(s) || rgba.test(s) || hsl.test(s) || hsla.test(s);
+}
+
+export async function colorPreviewHandler() {
+    const { input } = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'input',
+            message: i18next.t('colorPreview.input'),
+            validate: (val) => isAllowedColorFormat(val) || i18next.t('colorPreview.invalid')
+        }
+    ]);
+
+    const color = tinycolor(input);
+    const rgb = color.toRgb();
+    const alpha = typeof rgb.a === 'number' ? rgb.a : 1;
+    const hex = alpha < 1 ? color.toHex8String().toUpperCase() : color.toHexString().toUpperCase();
+
+    const width = 50;
+    const height = 2;
+
+    const label = `${i18next.t('colorPreview.preview')} ${hex} ${color.toRgbString()} ${color.toHslString()}`;
+    printColorBar(rgb, width, height, label, alpha);
+
+    await copy(hex);
+    console.log(i18next.t('colorPreview.copied', { value: hex }));
+}

package/src/index.js

@@ -15,6 +15,7 @@ import { mockHandler } from './commands/mock.js';
 import { uuidHandler } from './commands/uuid.js';
 import { pinyinHandler } from './commands/pinyin.js';
 import { colorHandler } from './commands/color.js';
+import { colorPreviewHandler } from './commands/colorPreview.js';
 import { variableFormatHandler } from './commands/variableFormat.js';
 import { jsonFormatHandler } from './commands/jsonFormat.js';
 import { hashingHandler } from './commands/hashing.js';
@@ -26,6 +27,7 @@ import { placeholderImgHandler } from './commands/placeholderImg.js';
 import { markdownHandler } from './commands/markdown.js';
 import { vscodeSnippetHandler } from './commands/vscodeSnippet.js';
 import { dominantColorHandler } from './commands/dominantColor.js';
+import { colorPickHandler } from './commands/colorPick.js';
 
 process.on('SIGINT', () => {
     console.log(`\n${i18next.t('menu.bye')}`);
@@ -49,6 +51,7 @@ function getFeatures() {
         { name: i18next.t('menu.features.imgConvert'), value: 'imgConvert' },
         { name: i18next.t('menu.features.imgSplit'), value: 'imgSplit' },
         { name: i18next.t('menu.features.dominantColor'), value: 'dominantColor' },
+        { name: i18next.t('menu.features.colorPick'), value: 'colorPick' },
         { name: i18next.t('menu.features.placeholderImg'), value: 'placeholderImg' },
         { name: i18next.t('menu.features.qrcode'), value: 'qrcode' },
         
@@ -65,6 +68,7 @@ function getFeatures() {
         { name: i18next.t('menu.features.timeFormat'), value: 'timeFormat' },
         { name: i18next.t('menu.features.timeCalc'), value: 'timeCalc' },
         { name: i18next.t('menu.features.color'), value: 'color' },
+        { name: i18next.t('menu.features.colorPreview'), value: 'colorPreview' },
         { name: i18next.t('menu.features.uuid'), value: 'uuid' },
         { name: i18next.t('menu.features.hashing'), value: 'hashing' },
 
@@ -182,6 +186,9 @@ async function handleAction(action) {
         case 'dominantColor':
             await dominantColorHandler();
             break;
+        case 'colorPick':
+            await colorPickHandler();
+            break;
         case 'timeFormat':
             await timeFormatHandler();
             break;
@@ -200,6 +207,9 @@ async function handleAction(action) {
         case 'color':
             await colorHandler();
             break;
+        case 'colorPreview':
+            await colorPreviewHandler();
+            break;
         case 'variableFormat':
             await variableFormatHandler();
             break;

package/src/locales/en.js

@@ -10,6 +10,7 @@ export default {
             imgConvert: 'Image Format Convert',
             imgSplit: 'Image Splitter',
             dominantColor: 'Image Dominant Color',
+            colorPick: 'Color Picker',
             placeholderImg: 'Placeholder Image Generator',
             qrcode: 'QR Code Generator',
             url: 'URL Encode/Decode',
@@ -22,6 +23,7 @@ export default {
             timeFormat: 'Time Format / Timestamp',
             timeCalc: 'Time Calculation (Diff/Offset)',
             color: 'Color Converter (Hex <-> RGB)',
+            colorPreview: 'Color Preview',
             uuid: 'Get UUID',
             hashing: 'Hash Calculator (MD5/SHA/SM3)',
             mock: 'Mock Text',
@@ -37,6 +39,37 @@ export default {
         saved: 'Language saved. Please restart the tool or continue using the menu.',
         backToMenu: 'Back to Menu'
     },
+    colorPreview: {
+        input: 'Enter color (Hex/RGB/HSL):',
+        invalid: 'Invalid color format',
+        preview: 'Preview:',
+        copied: 'Copied to clipboard: {{value}}'
+    },
+    colorPick: {
+        backPrev: 'Back to previous step',
+        source: 'Select source',
+        sourceScreen: 'Screen (mouse position)',
+        sourceImage: 'Image file',
+        inputMethod: 'Image input method',
+        inputDialog: 'Select file (dialog)',
+        inputManual: 'Enter file path manually',
+        enterPath: 'Enter image file path:',
+        notExist: 'File does not exist.',
+        notSupported: 'Screen picking not supported on this OS.',
+        moveMousePrompt: 'Move mouse; press Space to sample, Enter to finish...',
+        pickFail: 'Failed to pick color from screen.',
+        imageInfo: 'Image:',
+        mode: 'Pick mode',
+        modePixel: 'Pick single pixel',
+        modeArea: 'Pick area average',
+        xPrompt: 'Enter X (px or %):',
+        yPrompt: 'Enter Y (px or %):',
+        x1Prompt: 'Enter X1 (px or %):',
+        y1Prompt: 'Enter Y1 (px or %):',
+        x2Prompt: 'Enter X2 (px or %):',
+        y2Prompt: 'Enter Y2 (px or %):',
+        result: 'Picked Color'
+    },
     url: {
         title: 'URL Encode/Decode',
         encode: 'Encode',

package/src/locales/zh.js

@@ -10,6 +10,7 @@ export default {
             imgConvert: '图片格式转换',
             imgSplit: '图片分割工具',
             dominantColor: '图片主色识别',
+            colorPick: '颜色吸取',
             placeholderImg: '占位图生成器',
             qrcode: '二维码生成器',
             url: 'URL 编码/解码',
@@ -22,6 +23,7 @@ export default {
             timeFormat: '时间格式化 / 时间戳',
             timeCalc: '时间计算 (差值/偏移)',
             color: '颜色转换 (Hex <-> RGB)',
+            colorPreview: '颜色预览',
             uuid: '生成 UUID',
             hashing: '哈希计算 (MD5/SHA/SM3)',
             mock: 'Mock 文本生成',
@@ -37,6 +39,37 @@ export default {
         saved: '语言已保存。请继续使用。',
         backToMenu: '返回主菜单'
     },
+    colorPreview: {
+        input: '输入颜色 (Hex/RGB/HSL):',
+        invalid: '颜色格式无效',
+        preview: '预览:',
+        copied: '已复制到剪贴板: {{value}}'
+    },
+    colorPick: {
+        backPrev: '返回上一步',
+        source: '选择来源',
+        sourceScreen: '屏幕取色（鼠标位置）',
+        sourceImage: '图片取色',
+        inputMethod: '图片输入方式',
+        inputDialog: '选择文件（对话框）',
+        inputManual: '手动输入文件路径',
+        enterPath: '请输入图片路径:',
+        notExist: '文件不存在。',
+        notSupported: '当前系统不支持屏幕取色。',
+        moveMousePrompt: '移动鼠标；按空格采样，回车结束...',
+        pickFail: '屏幕取色失败。',
+        imageInfo: '图片:',
+        mode: '选择吸取模式',
+        modePixel: '吸取单像素颜色',
+        modeArea: '区域平均颜色',
+        xPrompt: '输入 X（px 或 %）:',
+        yPrompt: '输入 Y（px 或 %）:',
+        x1Prompt: '输入 X1（px 或 %）:',
+        y1Prompt: '输入 Y1（px 或 %）:',
+        x2Prompt: '输入 X2（px 或 %）:',
+        y2Prompt: '输入 Y2（px 或 %）:',
+        result: '吸取结果'
+    },
     url: {
         title: 'URL 编码/解码',
         encode: '编码',

package/src/utils/menu.js

@@ -4,29 +4,38 @@ import inquirer from 'inquirer';
  * Display a numbered menu and get user selection.
  * @param {string} title - The title of the menu.
  * @param {Array<{name: string, value: any}>} options - List of options.
+ * @param {boolean} [allowBack=false] - Whether to show a back option (0).
+ * @param {string} [backText='Back'] - Text for back option.
  * @returns {Promise<any>} - The selected value.
  */
-export async function selectFromMenu(title, options) {
+export async function selectFromMenu(title, options, allowBack = false, backText = 'Back') {
     console.log(`\n=== ${title} ===`);
     options.forEach((opt, index) => {
         console.log(`${index + 1}. ${opt.name}`);
     });
+    if (allowBack) {
+        console.log(`0. ${backText}`);
+    }
     console.log('=================\n');
 
     const { choice } = await inquirer.prompt([
         {
             type: 'input',
             name: 'choice',
-            message: `Select option (1-${options.length}):`,
+            message: `Select option (${allowBack ? `0-${options.length}` : `1-${options.length}`}):`,
             validate: (input) => {
+                if (allowBack && input === '0') return true;
                 const num = parseInt(input);
                 if (isNaN(num) || num < 1 || num > options.length) {
-                    return `Please enter a number between 1 and ${options.length}`;
+                    return `Please enter a number between ${allowBack ? 0 : 1} and ${options.length}`;
                 }
                 return true;
             }
         }
     ]);
 
+    if (allowBack && choice === '0') {
+        return '__BACK__';
+    }
     return options[parseInt(choice) - 1].value;
 }