xw-devtool-cli 1.0.12 → 1.0.14

package/README.md

@@ -2,7 +2,7 @@
 
 一个基于 Node.js 的开发者命令行工具箱，旨在提供开箱即用的常用开发工具，帮助开发者快速处理日常任务。
 
-主要功能包括：Base64 编解码、图片格式转换、图片与 Base64 互转、Mock 数据生成、时间戳/日期格式化、URL 编解码、UUID 生成、汉字转拼音、颜色转换、变量格式转换、哈希计算、二维码生成、特殊符号大全等。所有结果均自动复制到剪贴板，极大提升开发效率。
+主要功能包括：Base64 编解码、图片格式转换、图片与 Base64 互转、Mock 数据生成、时间戳/日期格式化、时间计算、URL 编解码、UUID 生成、汉字转拼音、颜色转换、变量格式转换、哈希计算、二维码生成、特殊符号大全等。所有结果均自动复制到剪贴板，极大提升开发效率。
 
 ## ✨ 功能特性
 
@@ -17,6 +17,7 @@
 - **时间工具**：
   - **时间格式化**：时间戳/日期字符串 -> `YYYY-MM-DD HH:mm:ss`。
   - **获取时间戳**：快速获取当前毫秒级时间戳。
+  - **时间计算**：计算日期差值或日期偏移 (Add/Subtract)。
 - **开发辅助工具**：
   - **URL 编解码**：Encode/Decode URL。
   - **Unicode 编解码**：文本与 Unicode 转义序列 (\uXXXX) 互转。
@@ -71,14 +72,16 @@ xw-devtool
 7. Unicode Encode/Decode
 8. HTML Entity Encode/Decode
 9. Variable Format Converter
-a. Chinese to Pinyin
-b. Time Format / Timestamp
-c. Color Converter (Hex <-> RGB)
-d. Get UUID
-e. Hash Calculator (MD5/SHA/SM3)
-f. Mock Text
-g. Special Characters (Symbols)
-h. Emoji Picker
+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
 0. Exit
 =================================
 ```
@@ -163,42 +166,68 @@ h. Emoji Picker
 - 自动展示 CamelCase, PascalCase, SnakeCase, KebabCase, ConstantCase 五种格式。
 - 选择一种格式自动复制。
 
-### 10. 中文转拼音
+### 10. JSON 格式化
 - 选择 `a` 进入。
+- 支持三种模式：
+  - **Minify**: 压缩 JSON (去除空格和换行)。
+  - **Prettify (2 spaces)**: 美化 JSON (2 空格缩进)。
+  - **Prettify (4 spaces)**: 美化 JSON (4 空格缩进)。
+- 支持自动修复简单的非标准 JSON (如 key 缺少引号的 JS 对象)。
+- 支持从剪贴板、文件或手动输入读取。
+- **注意**：为防止长文本刷屏，结果**仅自动复制到剪贴板**，不会在终端打印。
+
+### 11. 中文转拼音
+- 选择 `b` 进入。
 - 输入中文字符串（支持直接回车读取剪贴板）。
 - 输出对应的拼音（无声调）。
 
-### 11. 时间格式化 (Time Format)
-- 选择 `b` 进入。
+### 12. 时间格式化 (Time Format)
+- 选择 `c` 进入。
 - 支持时间戳转日期字符串，或日期字符串转时间戳。
 - 直接回车可获取当前时间戳。
 
-### 12. 颜色转换 (Hex <-> RGB)
-- 选择 `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))。
 - 自动转换并显示对应格式。
 
-### 13. Get UUID
-- 选择 `d` 进入。
+### 15. Get UUID
+- 选择 `f` 进入。
 - 自动生成一个 UUID v4 并复制到剪贴板。
 
-### 14. 哈希计算 (Encryption)
-- 选择 `e` 进入。
+### 16. 哈希计算 (Encryption)
+- 选择 `g` 进入。
 - 输入文本（支持直接回车读取剪贴板）。
 - 同时计算并显示 MD5, SHA1, SHA256, SHA512, SM3 哈希值。
 
-### 15. Mock 数据生成
-- 选择 `f` 进入。
+### 17. Mock 数据生成
+- 选择 `h` 进入。
 - 提供多种数据类型：英文段落、中文字符、身份证号、邮箱、手机号等。
 - 支持指定生成数量。
 
-### 16. 特殊符号大全
-- 选择 `g` 进入。
+### 18. 特殊符号大全
+- 选择 `i` 进入。
 - 网格化展示常用特殊符号。
 - 输入符号对应的编号即可一键复制。
 
-### 17. Emoji 输入
-- 选择 `h` 进入。
+### 19. Emoji 输入
+- 选择 `j` 进入。
 - 分类展示常用 Emoji (表情、手势、动物、食物等)。
 - 输入编号选择并复制 Emoji 到剪贴板。
 

package/package.json

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

package/src/commands/jsonFormat.js

@@ -0,0 +1,83 @@
+import inquirer from 'inquirer';
+import { copy } from '../utils/clipboard.js';
+import { selectFromMenu } from '../utils/menu.js';
+import fs from 'fs';
+
+export async function jsonFormatHandler() {
+    const mode = await selectFromMenu('JSON Format', [
+        { name: 'Minify (Compact)', value: 'minify' },
+        { name: 'Prettify (2 spaces)', value: 'prettify-2' },
+        { name: 'Prettify (4 spaces)', value: 'prettify-4' }
+    ]);
+
+    const inputSource = await selectFromMenu('Select Input Source', [
+        { name: 'Clipboard (Paste automatically)', value: 'clipboard' },
+        { name: 'Manual Input', value: 'manual' },
+        { name: 'File', value: 'file' }
+    ]);
+
+    let input = '';
+    if (inputSource === 'clipboard') {
+        const clipboardy = (await import('clipboardy')).default;
+        input = await clipboardy.read();
+    } else if (inputSource === 'file') {
+        const { filePath } = await inquirer.prompt([
+            {
+                type: 'input',
+                name: 'filePath',
+                message: 'Enter file path:'
+            }
+        ]);
+        try {
+            input = fs.readFileSync(filePath.replace(/"/g, ''), 'utf-8');
+        } catch (e) {
+            console.error('Error reading file:', e.message);
+            return;
+        }
+    } else {
+        const { manualInput } = await inquirer.prompt([
+            {
+                type: 'input',
+                name: 'manualInput',
+                message: 'Enter JSON string:'
+            }
+        ]);
+        input = manualInput;
+    }
+
+    try {
+        // Try to parse relaxed JSON (like JS objects) if possible, but standard JSON.parse is safer for strict JSON
+        // We can try to evaluate if it fails parsing, but that's risky. 
+        // Let's stick to standard JSON parsing first.
+        let jsonObj;
+        try {
+            jsonObj = JSON.parse(input);
+        } catch (e) {
+            // If strict parse fails, try to be more lenient if it's a JS object string
+            // e.g. { a: 1 } instead of { "a": 1 }
+            // Using Function constructor is safer than eval but still risky. 
+            // For a dev tool, it might be acceptable if warned.
+            // Let's try a simple regex fix for common cases (keys without quotes)
+            try {
+                // This is a very basic attempt to fix unquoted keys
+                const fixed = input.replace(/([{,]\s*)([a-zA-Z0-9_]+?)\s*:/g, '$1"$2":');
+                jsonObj = JSON.parse(fixed);
+            } catch (e2) {
+                throw new Error('Invalid JSON format');
+            }
+        }
+
+        let output = '';
+        if (mode === 'minify') {
+            output = JSON.stringify(jsonObj);
+        } else if (mode === 'prettify-2') {
+            output = JSON.stringify(jsonObj, null, 2);
+        } else {
+            output = JSON.stringify(jsonObj, null, 4);
+        }
+        
+        await copy(output);
+    } catch (e) {
+        console.error('Error processing JSON:', e.message);
+    }
+}

package/src/commands/timeCalc.js

@@ -0,0 +1,151 @@
+import inquirer from 'inquirer';
+import dayjs from 'dayjs';
+import duration from 'dayjs/plugin/duration.js';
+import { copy } from '../utils/clipboard.js';
+import { selectFromMenu } from '../utils/menu.js';
+
+dayjs.extend(duration);
+
+export async function timeCalcHandler() {
+    const mode = await selectFromMenu('Time Calculation', [
+        { name: 'Diff (Calculate difference between two dates)', value: 'diff' },
+        { name: 'Add/Subtract (Calculate new date from offset)', value: 'offset' }
+    ]);
+
+    if (mode === 'diff') {
+        await handleDiff();
+    } else {
+        await handleOffset();
+    }
+}
+
+async function handleDiff() {
+    const answers = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'start',
+            message: 'Enter Start Date (YYYY-MM-DD HH:mm:ss or timestamp):',
+            default: dayjs().format('YYYY-MM-DD HH:mm:ss')
+        },
+        {
+            type: 'input',
+            name: 'end',
+            message: 'Enter End Date (YYYY-MM-DD HH:mm:ss or timestamp):',
+            default: dayjs().format('YYYY-MM-DD HH:mm:ss')
+        }
+    ]);
+
+    const start = parseDate(answers.start);
+    const end = parseDate(answers.end);
+
+    if (!start.isValid() || !end.isValid()) {
+        console.error('Invalid date format.');
+        return;
+    }
+
+    const diffMs = end.diff(start);
+    const dur = dayjs.duration(diffMs);
+
+    const result = [
+        `Start: ${start.format('YYYY-MM-DD HH:mm:ss')}`,
+        `End:   ${end.format('YYYY-MM-DD HH:mm:ss')}`,
+        '---------------------------------',
+        `Total Days:    ${dur.asDays().toFixed(2)}`,
+        `Total Hours:   ${dur.asHours().toFixed(2)}`,
+        `Total Minutes: ${dur.asMinutes().toFixed(2)}`,
+        `Total Seconds: ${dur.asSeconds().toFixed(0)}`,
+        '---------------------------------',
+        `Human Readable: ${formatDuration(dur)}`
+    ].join('\n');
+
+    console.log(`\n${result}\n`);
+    await copy(result);
+}
+
+async function handleOffset() {
+    const { startInput } = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'startInput',
+            message: 'Enter Start Date:',
+            default: dayjs().format('YYYY-MM-DD HH:mm:ss')
+        }
+    ]);
+
+    const start = parseDate(startInput);
+    if (!start.isValid()) {
+        console.error('Invalid date format.');
+        return;
+    }
+
+    const operator = await selectFromMenu('Select Operation', [
+        { name: 'Add (+)', value: 'add' },
+        { name: 'Subtract (-)', value: 'subtract' }
+    ]);
+
+    const unit = await selectFromMenu('Select Unit', [
+        { name: 'Days', value: 'day' },
+        { name: 'Hours', value: 'hour' },
+        { name: 'Minutes', value: 'minute' },
+        { name: 'Seconds', value: 'second' },
+        { name: 'Weeks', value: 'week' },
+        { name: 'Months', value: 'month' },
+        { name: 'Years', value: 'year' }
+    ]);
+
+    const { amount } = await inquirer.prompt([
+        {
+            type: 'number',
+            name: 'amount',
+            message: `Enter Amount of ${unit}s (number):`,
+            validate: val => !isNaN(val) || 'Please enter a number'
+        }
+    ]);
+
+    let resultDate;
+    if (operator === 'add') {
+        resultDate = start.add(amount, unit);
+    } else {
+        resultDate = start.subtract(amount, unit);
+    }
+
+    const result = resultDate.format('YYYY-MM-DD HH:mm:ss');
+    console.log(`\nResult Date: ${result}\n`);
+    await copy(result);
+}
+
+function parseDate(input) {
+    if (!input) return dayjs();
+    if (/^\d+$/.test(input)) {
+        const ts = parseInt(input);
+        if (input.length === 10) return dayjs.unix(ts);
+        return dayjs(ts);
+    }
+    return dayjs(input);
+}
+
+function formatDuration(dur) {
+    const parts = [];
+    const years = Math.floor(dur.asYears());
+    if (years > 0) parts.push(`${years} years`);
+    
+    // Calculate remaining duration after removing years is tricky with dayjs duration directly
+    // simplified approach:
+    
+    const d = Math.abs(dur.asMilliseconds());
+    const seconds = Math.floor((d / 1000) % 60);
+    const minutes = Math.floor((d / (1000 * 60)) % 60);
+    const hours = Math.floor((d / (1000 * 60 * 60)) % 24);
+    const days = Math.floor(d / (1000 * 60 * 60 * 24));
+
+    // Note: This simple day calc doesn't account for variable month lengths perfectly if we wanted "X months Y days"
+    // But for "X days Y hours..." it's accurate enough for absolute diff.
+    
+    let str = '';
+    if (days > 0) str += `${days} days `;
+    if (hours > 0) str += `${hours} hours `;
+    if (minutes > 0) str += `${minutes} mins `;
+    if (seconds > 0) str += `${seconds} secs`;
+    
+    return str.trim() || '0 secs';
+}

package/src/index.js

@@ -6,11 +6,13 @@ import { unicodeHandler } from './commands/unicode.js';
 import { imgBase64Handler } from './commands/imgBase64.js';
 import { imgConvertHandler } from './commands/imgConvert.js';
 import { timeFormatHandler } from './commands/timeFormat.js';
+import { timeCalcHandler } from './commands/timeCalc.js';
 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 { variableFormatHandler } from './commands/variableFormat.js';
+import { jsonFormatHandler } from './commands/jsonFormat.js';
 import { hashingHandler } from './commands/hashing.js';
 import { qrcodeHandler } from './commands/qrcode.js';
 import { specialCharsHandler } from './commands/specialChars.js';
@@ -46,10 +48,12 @@ const features = [
     { name: 'Unicode Encode/Decode', value: 'unicode' },
     { name: 'HTML Entity Encode/Decode', value: 'htmlEntities' },
     { name: 'Variable Format Converter', value: 'variableFormat' },
+    { name: 'JSON Format (Minify/Prettify)', value: 'jsonFormat' },
     { name: 'Chinese to Pinyin', value: 'pinyin' },
 
     // Utils (Time, Color, UUID, Hash)
     { name: 'Time Format / Timestamp', value: 'timeFormat' },
+    { name: 'Time Calculation (Diff/Offset)', value: 'timeCalc' },
     { name: 'Color Converter (Hex <-> RGB)', value: 'color' },
     { name: 'Get UUID', value: 'uuid' },
     { name: 'Hash Calculator (MD5/SHA/SM3)', value: 'hashing' },
@@ -154,6 +158,9 @@ async function handleAction(action) {
         case 'timeFormat':
             await timeFormatHandler();
             break;
+        case 'timeCalc':
+            await timeCalcHandler();
+            break;
         case 'mock':
             await mockHandler();
             break;
@@ -169,6 +176,9 @@ async function handleAction(action) {
         case 'variableFormat':
             await variableFormatHandler();
             break;
+        case 'jsonFormat':
+            await jsonFormatHandler();
+            break;
         case 'hashing':
             await hashingHandler();
             break;