td-web-cli 0.1.28 → 0.1.30

package/dist/index.js

@@ -4,66 +4,114 @@
  * 通过交互式选择执行不同模块功能
  */
 import { Command } from 'commander';
+import fs from 'fs';
 import { select, Separator } from '@inquirer/prompts';
 import { logger, loggerError } from './utils/index.js';
 import { i18n } from './modules/i18n/index.js';
+import { image } from './modules/image/index.js';
 import { tools } from './modules/tools/index.js';
+// 读取 package.json 中的版本号
+const { version } = JSON.parse(fs.readFileSync(new URL('../package.json', import.meta.url), 'utf-8'));
 const program = new Command();
+/**
+ * 设置基础命令行选项
+ */
+function setupBasicOptions() {
+    program
+        .version(version, '-v, --version', '显示版本号')
+        .description('td-web-cli 命令行工具')
+        .usage('[options]')
+        .helpOption('-h, --help', '显示帮助信息')
+        .addHelpText('after', `
+      示例：
+        $ td-web-cli               # 进入交互式选择模块
+        $ td-web-cli -v            # 显示版本号
+        $ td-web-cli -h            # 显示帮助信息
+      `.trim());
+}
+/**
+ * 交互式选择模块并执行
+ */
+async function runInteractiveMode() {
+    // 定义可用模块选项
+    const moduleChoices = [
+        {
+            name: '国际化',
+            value: 'i18n',
+            description: '国际化相关功能',
+        },
+        {
+            name: '图片',
+            value: 'image',
+            description: '图片相关功能',
+        },
+        {
+            name: '小工具',
+            value: 'tools',
+            description: '小工具相关功能',
+        },
+    ];
+    // 交互式选择模块
+    const answer = await select({
+        message: '请选择要执行的模块：',
+        choices: [
+            ...moduleChoices,
+            new Separator(), // 分割线，便于未来扩展更多模块
+        ],
+        default: 'i18n', // 默认选项
+        loop: true, // 选项循环滚动
+    });
+    // 查找选择模块的名称，方便日志输出
+    const selectedModule = moduleChoices.find((item) => item.value === answer);
+    if (!selectedModule) {
+        logger.warn('未选择有效模块，程序已退出');
+        process.exit(0);
+    }
+    logger.info(`用户选择模块：${selectedModule.name}`);
+    // 根据选择执行对应模块
+    switch (answer) {
+        case 'i18n':
+            logger.info(`${selectedModule.name}模块开始执行`);
+            await i18n(program);
+            logger.info(`${selectedModule.name}模块执行完成`);
+            break;
+        case 'image':
+            logger.info(`${selectedModule.name}模块开始执行`);
+            await image(program);
+            logger.info(`${selectedModule.name}模块执行完成`);
+            break;
+        case 'tools':
+            logger.info(`${selectedModule.name}模块开始执行`);
+            await tools(program);
+            logger.info(`${selectedModule.name}模块执行完成`);
+            break;
+        default:
+            logger.warn(`${selectedModule.name}模块暂未实现，程序已退出`);
+            process.exit(0);
+    }
+}
 /**
  * 主程序入口函数
- * 解析命令行参数，交互式选择模块并执行对应功能
+ * 解析命令行参数，若未提供任何选项则进入交互式选择
  */
 async function main() {
     try {
         logger.info('td-web-cli程序启动');
-        // 解析命令行参数
+        // 设置基础命令行选项
+        setupBasicOptions();
+        // 解析命令行参数（如果用户提供了 -v 或 -h，commander 会自动退出）
         program.parse(process.argv);
         logger.info(`命令行参数解析完成：${process.argv.slice(2).join(' ')}`);
-        // 定义可用模块选项
-        const moduleChoices = [
-            {
-                name: '国际化',
-                value: 'i18n',
-                description: '国际化相关功能',
-            },
-            {
-                name: '小工具',
-                value: 'tools',
-                description: '小工具相关功能',
-            },
-        ];
-        // 交互式选择模块
-        const answer = await select({
-            message: '请选择要执行的模块：',
-            choices: [
-                ...moduleChoices,
-                new Separator(), // 分割线，便于未来扩展更多模块
-            ],
-            default: 'i18n', // 默认选项
-            loop: true, // 选项循环滚动
-        });
-        // 查找选择模块的名称，方便日志输出
-        const selectedModule = moduleChoices.find((item) => item.value === answer);
-        if (!selectedModule) {
-            logger.warn('未选择有效模块，程序已退出');
-            process.exit(0);
+        // 如果没有其他参数（如 -v、-h 等），则进入交互模式
+        // 注意：program.args 包含未被选项消费的参数，若无额外参数则执行交互
+        if (program.args.length === 0) {
+            logger.info('未检测到额外参数，进入交互式选择模式');
+            await runInteractiveMode();
         }
-        logger.info(`用户选择模块：${selectedModule.name}`);
-        // 根据选择执行对应模块
-        switch (answer) {
-            case 'i18n':
-                logger.info(`${selectedModule.name}模块开始执行`);
-                await i18n(program);
-                logger.info(`${selectedModule.name}模块执行完成`);
-                break;
-            case 'tools':
-                logger.info(`${selectedModule.name}模块开始执行`);
-                await tools(program);
-                logger.info(`${selectedModule.name}模块执行完成`);
-                break;
-            default:
-                logger.warn(`${selectedModule.name}模块暂未实现，程序已退出`);
-                process.exit(0);
+        else {
+            // 如果有额外参数，可能用户直接传入了子命令，但当前未实现子命令，提示帮助
+            logger.warn(`未知参数：${program.args.join(' ')}，请使用 --help 查看用法`, true);
+            program.help(); // 显示帮助并退出
         }
     }
     catch (error) {

package/dist/modules/image/compressImage/index.d.ts

@@ -0,0 +1,11 @@
+import { Command } from 'commander';
+/**
+ * 图片压缩主功能
+ * - 交互式输入图片路径
+ * - 选择压缩级别（无损/视觉无损/有损/高损）
+ * - 询问是否自动缩放超大图片
+ * - 自动识别格式并使用对应压缩参数
+ * - 输出文件添加6位随机后缀，保存在原目录
+ */
+export declare function compressImage(program: Command): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/image/compressImage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/image/compressImage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwCpC;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,OAAO,iBA6SnD"}

package/dist/modules/image/compressImage/index.js

@@ -0,0 +1,320 @@
+import { input, select, confirm, Separator } from '@inquirer/prompts';
+import fs from 'fs';
+import path from 'path';
+import sharp from 'sharp';
+import { logger, loggerError, normalizeGitBashPath, } from '../../../utils/index.js';
+// 支持处理的图片格式
+const SUPPORTED_FORMATS = [
+    '.jpg',
+    '.jpeg',
+    '.png',
+    '.webp',
+    '.avif',
+    '.tiff',
+    '.gif',
+];
+/**
+ * 生成6位随机字符串（用于文件名后缀）
+ */
+function generateShortSuffix() {
+    return Math.random().toString(36).substring(2, 8);
+}
+/**
+ * 获取文件的输出路径（同目录，原文件名+6位随机字符串+扩展名）
+ */
+function getOutputPath(inputPath) {
+    const dir = path.dirname(inputPath);
+    const ext = path.extname(inputPath);
+    const baseName = path.basename(inputPath, ext);
+    const suffix = generateShortSuffix();
+    return path.join(dir, `${baseName}_${suffix}${ext}`);
+}
+/**
+ * 图片压缩主功能
+ * - 交互式输入图片路径
+ * - 选择压缩级别（无损/视觉无损/有损/高损）
+ * - 询问是否自动缩放超大图片
+ * - 自动识别格式并使用对应压缩参数
+ * - 输出文件添加6位随机后缀，保存在原目录
+ */
+export async function compressImage(program) {
+    var _a;
+    // 交互式输入图片路径并校验
+    const answer = await input({
+        message: '请输入图片文件路径：',
+        validate: (value) => {
+            const cleaned = value.trim().replace(/^['"]|['"]$/g, '');
+            if (cleaned.length === 0) {
+                return '路径不能为空';
+            }
+            const normalizedPath = normalizeGitBashPath(cleaned);
+            if (!fs.existsSync(normalizedPath)) {
+                return '文件不存在，请输入有效路径';
+            }
+            const ext = path.extname(normalizedPath).toLowerCase();
+            if (!SUPPORTED_FORMATS.includes(ext)) {
+                return `不支持的文件格式，支持的格式：${SUPPORTED_FORMATS.join(', ')}`;
+            }
+            return true;
+        },
+    });
+    const imagePath = normalizeGitBashPath(answer);
+    const moduleChoices = [
+        {
+            name: '无损压缩',
+            description: '完全保留原始画质，体积减小极少（5%~15%）',
+            value: 'lossless',
+        },
+        {
+            name: '视觉无损压缩',
+            description: '肉眼几乎无法察觉差异，体积减小明显（20%~50%）',
+            value: 'visually_lossless',
+        },
+        {
+            name: '有损压缩',
+            description: '画质轻微下降，体积大幅减小（40%~70%）',
+            value: 'lossy',
+        },
+        {
+            name: '高损压缩',
+            description: '画质明显下降，体积最小（60%~90%）',
+            value: 'high_lossy',
+        },
+    ];
+    // 选择压缩类型（四种级别，带详细描述）
+    const compressType = await select({
+        message: '请选择压缩级别：',
+        choices: [
+            ...moduleChoices,
+            new Separator(), // 分割线，方便未来扩展更多功能
+        ],
+        default: 'visually_lossless', // 默认选项
+        loop: true, // 是否循环滚动选项
+    });
+    // 询问是否自动缩放超大图片
+    const shouldResize = await confirm({
+        message: '是否自动缩放超大图片（宽度超过 2560px 时缩小至 2560px）？',
+        default: true,
+    });
+    try {
+        logger.info(`开始处理图片：${imagePath}，压缩级别：${(_a = moduleChoices.find((item) => item.value === compressType)) === null || _a === void 0 ? void 0 : _a.name}`, true);
+        // 读取图片元数据，获取格式信息
+        const image = sharp(imagePath);
+        const metadata = await image.metadata();
+        const format = metadata.format;
+        if (!format) {
+            throw new Error('无法识别图片格式');
+        }
+        logger.info(`图片格式：${format}，原始尺寸：${metadata.width}x${metadata.height}`, true);
+        // 初始化处理管道
+        let pipeline = image;
+        // 自动缩放逻辑（用户同意且图片宽度超出阈值）
+        const MAX_WIDTH = 2560;
+        if (shouldResize && metadata.width && metadata.width > MAX_WIDTH) {
+            // 防御性检查：确保 width 是有效正数
+            if (metadata.width > 0 && metadata.width < 100000) {
+                pipeline = pipeline.resize(MAX_WIDTH, null, {
+                    withoutEnlargement: true,
+                    fit: 'inside',
+                });
+                logger.info(`图片尺寸已从 ${metadata.width}px 缩小至 ${MAX_WIDTH}px`, true);
+            }
+            else {
+                logger.warn(`图片宽度异常 (${metadata.width})，跳过尺寸调整`, true);
+            }
+        }
+        else if (shouldResize) {
+            logger.info(`图片宽度未超过 ${MAX_WIDTH}px，无需缩放`, true);
+        }
+        else {
+            logger.info('已跳过自动缩放', true);
+        }
+        // 根据格式和压缩类型构建处理管道
+        switch (format) {
+            case 'jpeg':
+            case 'jpg':
+                if (compressType === 'lossless') {
+                    // 无损：最高质量，关闭色度抽样
+                    pipeline = pipeline.jpeg({
+                        quality: 100,
+                        chromaSubsampling: '4:4:4',
+                    });
+                }
+                else if (compressType === 'visually_lossless') {
+                    // 视觉无损：高品质有损，轻微色度抽样
+                    pipeline = pipeline.jpeg({
+                        quality: 90,
+                        progressive: true,
+                        chromaSubsampling: '4:2:0',
+                    });
+                }
+                else if (compressType === 'lossy') {
+                    // 有损：标准有损参数
+                    pipeline = pipeline.jpeg({
+                        quality: 75,
+                        progressive: true,
+                        chromaSubsampling: '4:2:0',
+                    });
+                }
+                else {
+                    // 高损：低质量，最大化压缩
+                    pipeline = pipeline.jpeg({
+                        quality: 55,
+                        progressive: true,
+                        chromaSubsampling: '4:2:0',
+                    });
+                }
+                break;
+            case 'png':
+                if (compressType === 'lossless') {
+                    // 无损：最高压缩级别
+                    pipeline = pipeline.png({
+                        compressionLevel: 9,
+                        adaptiveFiltering: true,
+                    });
+                }
+                else if (compressType === 'visually_lossless') {
+                    // 视觉无损：高质量调色板模式
+                    pipeline = pipeline.png({
+                        compressionLevel: 9,
+                        palette: true,
+                        quality: 90,
+                        effort: 10,
+                    });
+                }
+                else if (compressType === 'lossy') {
+                    // 有损：中等质量调色板
+                    pipeline = pipeline.png({
+                        compressionLevel: 9,
+                        palette: true,
+                        quality: 70,
+                        effort: 10,
+                    });
+                }
+                else {
+                    // 高损：低质量调色板，大幅减少颜色
+                    pipeline = pipeline.png({
+                        compressionLevel: 9,
+                        palette: true,
+                        quality: 45,
+                        effort: 10,
+                    });
+                }
+                break;
+            case 'webp':
+                if (compressType === 'lossless') {
+                    // 无损：启用 lossless 模式
+                    pipeline = pipeline.webp({
+                        lossless: true,
+                        quality: 100,
+                    });
+                }
+                else if (compressType === 'visually_lossless') {
+                    // 视觉无损：高质量有损 WebP
+                    pipeline = pipeline.webp({
+                        lossless: false,
+                        quality: 85,
+                        effort: 6,
+                    });
+                }
+                else if (compressType === 'lossy') {
+                    // 有损：中等质量
+                    pipeline = pipeline.webp({
+                        lossless: false,
+                        quality: 65,
+                        effort: 6,
+                    });
+                }
+                else {
+                    // 高损：低质量
+                    pipeline = pipeline.webp({
+                        lossless: false,
+                        quality: 45,
+                        effort: 6,
+                    });
+                }
+                break;
+            case 'avif':
+                if (compressType === 'lossless') {
+                    // 无损：启用 lossless 模式
+                    pipeline = pipeline.avif({
+                        lossless: true,
+                    });
+                }
+                else if (compressType === 'visually_lossless') {
+                    // 视觉无损：高质量有损 AVIF
+                    pipeline = pipeline.avif({
+                        lossless: false,
+                        quality: 60,
+                        effort: 9,
+                    });
+                }
+                else if (compressType === 'lossy') {
+                    // 有损：中等质量
+                    pipeline = pipeline.avif({
+                        lossless: false,
+                        quality: 45,
+                        effort: 9,
+                    });
+                }
+                else {
+                    // 高损：极低质量
+                    pipeline = pipeline.avif({
+                        lossless: false,
+                        quality: 30,
+                        effort: 9,
+                    });
+                }
+                break;
+            case 'tiff':
+                // TIFF 支持 LZW 无损压缩或 JPEG 有损压缩
+                if (compressType === 'lossless') {
+                    pipeline = pipeline.tiff({
+                        compression: 'lzw',
+                    });
+                }
+                else if (compressType === 'visually_lossless') {
+                    // 视觉无损：轻微有损
+                    pipeline = pipeline.tiff({
+                        compression: 'jpeg',
+                        quality: 90,
+                    });
+                }
+                else if (compressType === 'lossy') {
+                    pipeline = pipeline.tiff({
+                        compression: 'jpeg',
+                        quality: 75,
+                    });
+                }
+                else {
+                    pipeline = pipeline.tiff({
+                        compression: 'jpeg',
+                        quality: 55,
+                    });
+                }
+                break;
+            case 'gif':
+                // sharp 对 GIF 处理有限，保持原样
+                logger.warn('GIF 格式仅支持原样输出，不进行额外压缩', true);
+                break;
+            default:
+                throw new Error(`暂不支持的格式：${format}`);
+        }
+        // 移除所有元数据以进一步减小体积
+        pipeline = pipeline.withMetadata({});
+        const outputPath = getOutputPath(imagePath);
+        // 执行压缩并输出文件
+        await pipeline.toFile(outputPath);
+        // 获取压缩后文件大小，计算压缩率
+        const originalSize = fs.statSync(imagePath).size;
+        const compressedSize = fs.statSync(outputPath).size;
+        const ratio = ((1 - compressedSize / originalSize) * 100).toFixed(2);
+        logger.info(`压缩完成！\n输出文件：${outputPath}\n原始大小：${(originalSize / 1024).toFixed(2)} KB\n压缩后大小：${(compressedSize / 1024).toFixed(2)} KB\n压缩率：${ratio}%`, true);
+        logger.info(`图片压缩成功！文件已保存至：${outputPath}`, true);
+    }
+    catch (error) {
+        loggerError(error, logger);
+        console.error('程序执行时发生异常，已记录日志，程序已退出');
+        process.exit(1);
+    }
+}

package/dist/modules/image/index.d.ts

@@ -0,0 +1,8 @@
+import { Command } from 'commander';
+/**
+ * 图片模块主入口
+ * 提供多个图片相关功能的交互式选择
+ * @param program Commander命令行实例，用于传递参数和配置
+ */
+export declare function image(program: Command): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/image/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/image/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC;;;;GAIG;AACH,wBAAsB,KAAK,CAAC,OAAO,EAAE,OAAO,iBAmD3C"}

package/dist/modules/image/index.js

@@ -0,0 +1,55 @@
+import { select, Separator } from '@inquirer/prompts';
+import { logger, loggerError } from '../../utils/index.js';
+import { compressImage } from './compressImage/index.js';
+/**
+ * 图片模块主入口
+ * 提供多个图片相关功能的交互式选择
+ * @param program Commander命令行实例，用于传递参数和配置
+ */
+export async function image(program) {
+    try {
+        logger.info('图片模块启动，等待用户选择功能');
+        // 定义可用功能选项
+        const moduleChoices = [
+            {
+                name: '压缩图片',
+                value: 'compressImage',
+                description: '对图片大小进行压缩',
+            },
+        ];
+        // 交互式选择需要执行的功能
+        const answer = await select({
+            message: '请选择要执行的功能：',
+            choices: [
+                ...moduleChoices,
+                new Separator(), // 分割线，方便未来扩展更多功能
+            ],
+            default: 'compressImage', // 默认选项
+            loop: true, // 是否循环滚动选项
+        });
+        // 查找选择功能的名称，方便日志输出
+        const selectedModule = moduleChoices.find((item) => item.value === answer);
+        if (!selectedModule) {
+            logger.warn('未选择有效功能，程序已退出');
+            process.exit(0);
+        }
+        logger.info(`用户选择功能：${selectedModule.name}`);
+        // 根据选择执行对应功能
+        switch (answer) {
+            case 'compressImage':
+                logger.info(`${selectedModule.name}功能开始执行`);
+                await compressImage(program);
+                logger.info(`${selectedModule.name}功能执行完成`);
+                break;
+            default:
+                logger.warn(`${selectedModule.name}功能暂未实现，程序已退出`);
+                process.exit(0);
+        }
+    }
+    catch (error) {
+        // 记录错误日志，方便排查
+        loggerError(error, logger);
+        console.error('程序执行时发生异常，已记录日志，程序已退出');
+        process.exit(1);
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "td-web-cli",
-  "version": "0.1.28",
+  "version": "0.1.30",
   "description": "A CLI tool for efficiency",
   "main": "dist/index.js",
   "type": "module",
@@ -48,6 +48,7 @@
     "commander": "^14.0.2",
     "minimatch": "^10.2.4",
     "node-html-parser": "^7.1.0",
+    "sharp": "^0.34.5",
     "xlsx": "^0.18.5"
   },
   "devDependencies": {