xw-devtool-cli 1.0.13 → 1.0.15

package/README.md

@@ -2,7 +2,7 @@
 
 一个基于 Node.js 的开发者命令行工具箱，旨在提供开箱即用的常用开发工具，帮助开发者快速处理日常任务。
 
-主要功能包括：Base64 编解码、图片格式转换、图片与 Base64 互转、Mock 数据生成、时间戳/日期格式化、时间计算、URL 编解码、UUID 生成、汉字转拼音、颜色转换、变量格式转换、哈希计算、二维码生成、特殊符号大全等。所有结果均自动复制到剪贴板，极大提升开发效率。
+主要功能包括：Base64 编解码、图片格式转换、图片与 Base64 互转、Mock 数据生成、时间戳/日期格式化、时间计算、URL 编解码、UUID 生成、汉字转拼音、颜色转换、变量格式转换、哈希计算、二维码生成、特殊符号大全、Markdown 语法工具等。所有结果均自动复制到剪贴板，极大提升开发效率。
 
 ## ✨ 功能特性
 
@@ -30,6 +30,7 @@
   - **特殊符号大全**：包含常用符号、箭头、数学符号、货币、希腊字母等 170+ 个符号，支持一键复制。
   - **Emoji 输入**：支持分类查看和选择常用 Emoji，一键复制到剪贴板。
   - **HTML 实体工具**：支持 HTML 实体编码与解码 (如 `&` <-> `&amp;`)。
+  - **Markdown 语法工具**：提供常用 Markdown 语法模板 (Headers, Lists, Tables, Code 等)，一键复制。
   - **占位图生成**：自定义尺寸、背景色、文字颜色和格式生成占位图。
 - **便捷操作**：
   - 支持文件选择对话框 (Windows)。
@@ -72,15 +73,17 @@ xw-devtool
 7. Unicode Encode/Decode
 8. HTML Entity Encode/Decode
 9. Variable Format Converter
-a. Chinese to Pinyin
-b. Time Format / Timestamp
-c. Time Calculation (Diff/Offset)
-d. Color Converter (Hex <-> RGB)
-e. Get UUID
-f. Hash Calculator (MD5/SHA/SM3)
-g. Mock Text
-h. Special Characters (Symbols)
-i. 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
+k. Markdown Snippets
 0. Exit
 =================================
 ```
@@ -165,53 +168,83 @@ i. 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. 时间计算 (Time Calculation)
-- 选择 `c` 进入。
+### 13. 时间计算 (Time Calculation)
+- 选择 `d` 进入。
 - **Diff**: 计算两个日期之间的时间差 (天、小时、分、秒)。
+  - **操作步骤**：
+    1. 输入 **开始日期** (支持 `YYYY-MM-DD HH:mm:ss` 等多种格式，默认为当前时间)。
+    2. 输入 **结束日期** (默认为当前时间)。
+    3. 查看时间差结果 (显示总天数、总小时数及详细的 `x天x小时x分x秒`)。
 - **Offset**: 计算指定偏移量后的日期。
-  - 支持单位：Years, Months, Weeks, Days, Hours, Minutes, Seconds。
-  - 支持操作：Add (+), Subtract (-)。
+  - **操作步骤**：
+    1. 输入 **基准日期** (默认为当前时间)。
+    2. 选择 **时间单位** (Days, Hours, Minutes, Seconds, etc.)。
+    3. 选择 **操作类型** (Add / Subtract)。
+    4. 输入 **数量** (Amount)。
+    5. 查看计算后的新日期。
   - 示例：计算 "当前时间 3 天后" 或 "2025-01-01 5 小时前"。
 
-### 13. 颜色转换 (Hex <-> RGB)
-- 选择 `d` 进入。
+### 14. 颜色转换 (Hex <-> RGB)
+- 选择 `e` 进入。
 - 输入 Hex 颜色值 (如 #333) 或 RGB 值 (如 rgb(51,51,51))。
 - 自动转换并显示对应格式。
 
-### 14. Get UUID
-- 选择 `e` 进入。
+### 15. Get UUID
+- 选择 `f` 进入。
 - 自动生成一个 UUID v4 并复制到剪贴板。
 
-### 15. 哈希计算 (Encryption)
-- 选择 `f` 进入。
+### 16. 哈希计算 (Encryption)
+- 选择 `g` 进入。
 - 输入文本（支持直接回车读取剪贴板）。
 - 同时计算并显示 MD5, SHA1, SHA256, SHA512, SM3 哈希值。
 
-### 16. Mock 数据生成
-- 选择 `g` 进入。
+### 17. Mock 数据生成
+- 选择 `h` 进入。
 - 提供多种数据类型：英文段落、中文字符、身份证号、邮箱、手机号等。
 - 支持指定生成数量。
 
-### 17. 特殊符号大全
-- 选择 `h` 进入。
+### 18. 特殊符号大全
+- 选择 `i` 进入。
 - 网格化展示常用特殊符号。
 - 输入符号对应的编号即可一键复制。
 
-### 18. Emoji 输入
-- 选择 `i` 进入。
+### 19. Emoji 输入
+- 选择 `j` 进入。
 - 分类展示常用 Emoji (表情、手势、动物、食物等)。
 - 输入编号选择并复制 Emoji 到剪贴板。
 
+### 20. Markdown 语法工具 (Markdown Snippets)
+- 选择 `k` 进入。
+- 提供常用的 Markdown 语法模板，分类包括：
+  - **Headers**: 标题 (H1-H6)。
+  - **Emphasis**: 加粗、斜体、删除线。
+  - **Lists**: 无序列表、有序列表、任务列表。
+  - **Links & Images**: 链接、图片插入。
+  - **Code**: 行内代码、代码块。
+  - **Tables**: 表格模板。
+  - **Others**: 引用、分割线、折叠详情等。
+- 选择对应语法后，模板将自动复制到剪贴板。
+
 ## 📄 License
 
 ISC

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xw-devtool-cli",
-  "version": "1.0.13",
+  "version": "1.0.15",
   "type": "module",
   "description": "基于node的开发者助手cli",
   "main": "index.js",
@@ -20,17 +20,35 @@
   "keywords": [
     "cli",
     "devtools",
+    "developer-tools",
+    "toolbox",
+    "utility",
     "base64",
-    "url",
+    "url-encode",
+    "unicode",
+    "html-entities",
     "uuid",
     "pinyin",
     "mock",
+    "mock-data",
     "timestamp",
     "time",
+    "date-calculation",
     "image",
+    "image-conversion",
     "webp",
     "jpg",
-    "png"
+    "png",
+    "placeholder-image",
+    "qrcode",
+    "json-format",
+    "variable-case",
+    "hash",
+    "encryption",
+    "md5",
+    "color-converter",
+    "emoji",
+    "markdown"
   ],
   "author": "npmxw",
   "license": "ISC",

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/markdown.js

@@ -0,0 +1,75 @@
+import { selectFromMenu } from '../utils/menu.js';
+import { copy } from '../utils/clipboard.js';
+import inquirer from 'inquirer';
+
+const MARKDOWN_SNIPPETS = {
+    'headers': [
+        { name: 'H1 Header (#)', value: '# Header 1' },
+        { name: 'H2 Header (##)', value: '## Header 2' },
+        { name: 'H3 Header (###)', value: '### Header 3' },
+        { name: 'H4 Header (####)', value: '#### Header 4' },
+    ],
+    'emphasis': [
+        { name: 'Bold (**text**)', value: '**Bold Text**' },
+        { name: 'Italic (*text*)', value: '*Italic Text*' },
+        { name: 'Bold Italic (***text***)', value: '***Bold Italic Text***' },
+        { name: 'Strikethrough (~~text~~)', value: '~~Strikethrough Text~~' },
+    ],
+    'lists': [
+        { name: 'Unordered List (-)', value: '- Item 1\n- Item 2\n- Item 3' },
+        { name: 'Ordered List (1.)', value: '1. Item 1\n2. Item 2\n3. Item 3' },
+        { name: 'Task List (- [ ])', value: '- [ ] To Do\n- [x] Done' },
+    ],
+    'links_images': [
+        { name: 'Link [text](url)', value: '[Link Text](https://example.com)' },
+        { name: 'Image ![alt](url)', value: '![Alt Text](https://example.com/image.jpg)' },
+        { name: 'Link with Title', value: '[Link Text](https://example.com "Title")' },
+    ],
+    'code': [
+        { name: 'Inline Code (`text`)', value: '`code`' },
+        { name: 'Code Block (```)', value: '```javascript\nconsole.log("Hello World");\n```' },
+    ],
+    'tables': [
+        { name: 'Table (3x3)', value: '| Header 1 | Header 2 | Header 3 |\n| :--- | :---: | ---: |\n| Left | Center | Right |\n| Item 1 | Item 2 | Item 3 |' },
+    ],
+    'others': [
+        { name: 'Blockquote (>)', value: '> This is a quote.' },
+        { name: 'Horizontal Rule (---)', value: '---' },
+        { name: 'Details/Summary (<details>)', value: '<details>\n<summary>Click to expand</summary>\n\nHidden content here.\n</details>' },
+    ]
+};
+
+export async function markdownHandler() {
+    while (true) {
+        const category = await selectFromMenu('Markdown Snippets', [
+            { name: 'Headers (H1-H6)', value: 'headers' },
+            { name: 'Emphasis (Bold, Italic...)', value: 'emphasis' },
+            { name: 'Lists (Bullet, Numbered, Task)', value: 'lists' },
+            { name: 'Links & Images', value: 'links_images' },
+            { name: 'Code (Inline, Block)', value: 'code' },
+            { name: 'Tables', value: 'tables' },
+            { name: 'Others (Quote, HR, Details)', value: 'others' },
+            { name: 'Back to Main Menu', value: 'back' }
+        ]);
+
+        if (category === 'back') {
+            break;
+        }
+
+        const snippets = MARKDOWN_SNIPPETS[category];
+        const snippetValue = await selectFromMenu('Select Snippet', [
+            ...snippets,
+            { name: 'Back', value: 'back' }
+        ]);
+
+        if (snippetValue === 'back') {
+            continue;
+        }
+
+        await copy(snippetValue);
+        
+        // Optional: ask if user wants to continue or exit
+        // For now, loop back to category selection is consistent with other tools or just exit?
+        // Let's loop back to categories to allow picking another one.
+    }
+}

package/src/index.js

@@ -12,12 +12,14 @@ 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';
 import { emojiHandler } from './commands/emoji.js';
 import { htmlEntitiesHandler } from './commands/htmlEntities.js';
 import { placeholderImgHandler } from './commands/placeholderImg.js';
+import { markdownHandler } from './commands/markdown.js';
 
 process.on('SIGINT', () => {
     console.log('\nBye!');
@@ -47,6 +49,7 @@ 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)
@@ -59,7 +62,8 @@ const features = [
     // Content/Mocking
     { name: 'Mock Text', value: 'mock' },
     { name: 'Special Characters (Symbols)', value: 'specialChars' },
-    { name: 'Emoji Picker', value: 'emoji' }
+    { name: 'Emoji Picker', value: 'emoji' },
+    { name: 'Markdown Snippets', value: 'markdown' }
 ];
 
 async function main() {
@@ -174,6 +178,9 @@ async function handleAction(action) {
         case 'variableFormat':
             await variableFormatHandler();
             break;
+        case 'jsonFormat':
+            await jsonFormatHandler();
+            break;
         case 'hashing':
             await hashingHandler();
             break;
@@ -192,6 +199,9 @@ async function handleAction(action) {
         case 'placeholderImg':
             await placeholderImgHandler();
             break;
+        case 'markdown':
+            await markdownHandler();
+            break;
         default:
             console.log('Feature not implemented yet.');
     }