td-web-cli 0.1.14 → 0.1.16

package/README.md

@@ -1,6 +1,6 @@
 # 项目名称
 
-一个基于 node.js 和 typeScript 的高效 cli 工具，用于提升工作效率。
+一个基于 Node.js 和 TypeScript 的高效 CLI 工具，用于提升工作效率。
 
 ---
 
@@ -18,11 +18,11 @@
 
 ## 环境要求
 
-- node.js >= 20.x（推荐使用 22.x 或更高版本）
+- Node.js >= 20.x（推荐使用 22.x 或更高版本）
 - npm >= 10.x
-- typeScript >= 5.x
+- TypeScript >= 5.x
 
-> **注意**：部分依赖可能要求 node.js 20 及以上版本，请根据实际情况调整。
+> **注意**：部分依赖可能要求 Node.js 20 及以上版本，请根据实际情况调整。
 
 ---
 
@@ -31,8 +31,8 @@
 1. 克隆仓库
 
 ```bash
-git clone <仓库地址>
-cd your-project
+git clone https://github.com/qianyuzzf/td-web-cli.git
+cd td-web-cli
 ```
 
 2. 安装依赖
@@ -47,8 +47,8 @@ npm install
 
 ### 代码结构
 
-- `src/` - typeScript 源代码目录
-- `dist/` - 编译后的 javaScript 输出目录
+- `src/` - TypeScript 源代码目录
+- `dist/` - 编译后的 JavaScript 输出目录
 - `release.js` - 发布脚本（可直接运行或编译后运行）
 
 ### 运行开发环境
@@ -59,7 +59,7 @@ npm link
 td-web-cli  # 确保本机未全局安装该工具
 ```
 
-通过 `npm link`，本地调试 cli 命令 `td-web-cli`。
+通过 `npm link`，本地调试 CLI 命令 `td-web-cli`。
 
 ---
 
@@ -67,7 +67,7 @@ td-web-cli  # 确保本机未全局安装该工具
 
 ### 命令行执行
 
-执行 cli 工具：
+执行 CLI 工具：
 
 ```bash
 td-web-cli
@@ -75,13 +75,13 @@ td-web-cli
 
 ### 功能说明
 
-- 多语言 excel 转 json 工具。[功能说明](./docs/i18n/excel2json.md)
+- 多语言 Excel 转 JSON 工具。[详细功能说明请点击这里](https://github.com/qianyuzzf/td-web-cli/blob/master/docs/i18n/excel2json.md)
 
 ---
 
 ## 构建
 
-使用 typeScript 编译项目：
+使用 TypeScript 编译项目：
 
 ```bash
 npm run build
@@ -105,7 +105,7 @@ npm run release
 - 依赖安装
 - 项目构建
 - 发布到 npm
-- 提交并推送 git 代码
+- 提交并推送 Git 代码
 
 ---
 
@@ -113,17 +113,17 @@ npm run release
 
 ```
 .
-├── src/                  # typeScript 源代码
+├── src/                  # TypeScript 源代码
 │   └── index.ts          # 入口文件
 ├── dist/                 # 编译输出目录
 ├── release.js            # 发布脚本
 ├── setting.json          # 配置文件
 ├── package.json          # 项目配置
-├── tsconfig.json         # typeScript 配置
+├── tsconfig.json         # TypeScript 配置
 ├── README.md             # 项目说明文件
-├── .gitignore            # git 忽略文件
-├── .prettierignore       # prettier 忽略文件
-├── .prettierrc           # prettier 配置文件
+├── .gitignore            # Git 忽略文件
+├── .prettierignore       # Prettier 忽略文件
+├── .prettierrc           # Prettier 配置文件
 └── package-lock.json     # 依赖锁定文件
 ```
 

package/dist/api/interface.d.ts

@@ -1,6 +1,7 @@
 declare const api: {
     LANGUAGE_TOOL_V2_LANGUAGES: string;
     LANGUAGE_TOOL_V2_CHECK: string;
+    UNPKG_HOLIDAY_CALENDAR: string;
 };
 export default api;
 //# sourceMappingURL=interface.d.ts.map

package/dist/api/interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../src/api/interface.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,GAAG;;;CAGR,CAAC;AAEF,eAAe,GAAG,CAAC"}
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../src/api/interface.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,GAAG;;;;CAIR,CAAC;AAEF,eAAe,GAAG,CAAC"}

package/dist/api/interface.js

@@ -1,5 +1,6 @@
 const api = {
-    LANGUAGE_TOOL_V2_LANGUAGES: 'https://api.languagetool.org/v2/languages',
-    LANGUAGE_TOOL_V2_CHECK: 'https://api.languagetool.org/v2/check',
+    LANGUAGE_TOOL_V2_LANGUAGES: 'https://api.languagetool.org/v2/languages', // 获取支持的语言列表
+    LANGUAGE_TOOL_V2_CHECK: 'https://api.languagetool.org/v2/check', // 调用语言检测接口，检测文本中的语言错误
+    UNPKG_HOLIDAY_CALENDAR: 'https://unpkg.com/holiday-calendar@1.3.0/data/CN', // 获取假期日历数据
 };
 export default api;

package/dist/index.js

@@ -5,8 +5,9 @@
  */
 import { Command } from 'commander';
 import { select, Separator } from '@inquirer/prompts';
-import { i18n } from './modules/i18n/index.js';
 import { logger, loggerError } from './utils/index.js';
+import { i18n } from './modules/i18n/index.js';
+import { tools } from './modules/tools/index.js';
 const program = new Command();
 /**
  * 主程序入口函数
@@ -25,6 +26,11 @@ async function main() {
                 value: 'i18n',
                 description: '国际化相关功能',
             },
+            {
+                name: '小工具',
+                value: 'tools',
+                description: '小工具相关功能',
+            },
         ];
         // 交互式选择模块
         const answer = await select({
@@ -51,6 +57,11 @@ async function main() {
                 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);

package/dist/modules/i18n/excel2json/index.d.ts

@@ -1,9 +1,9 @@
 import { Command } from 'commander';
 /**
- * excel转json功能主函数
- * 读取用户输入的excel路径，解析内容，根据配置生成多语言json文件
+ * Excel转JSON功能主函数
+ * 读取用户输入的Excel路径，解析内容，根据配置生成多语言JSON文件
  * 并对配置文件中所有语言对应的词条进行语言检测
- * 如果有相同的json key，则在key前面加上6位编码，保证唯一性
+ * 如果有相同的JSON KEY，则在KEY前面加上6位编码，保证唯一性
  * @param program Commander命令行实例
  */
 export declare function excel2json(program: Command): Promise<void>;

package/dist/modules/i18n/excel2json/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/i18n/excel2json/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0LpC;;;;;;GAMG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,OAAO,iBAoVhD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/i18n/excel2json/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0LpC;;;;;;GAMG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,OAAO,iBAsVhD"}

package/dist/modules/i18n/excel2json/index.js

@@ -34,17 +34,17 @@ function loadConfig(configPath) {
     return json.i18n;
 }
 /**
- * 匹配excel表头列名对应的语言key，支持大小写不敏感匹配
- * 先匹配语言key本身，再匹配语言名称数组（包含关系）
+ * 匹配Excel表头列名对应的语言KEY，支持大小写不敏感匹配
+ * 先匹配语言KEY本身，再匹配语言名称数组（包含关系）
  * @param colName 表头列名
  * @param langs 语言映射
- * @returns 匹配到的语言key，未匹配返回null
+ * @returns 匹配到的语言KEY，未匹配返回null
  */
 function matchLangKey(colName, langs) {
     if (!colName)
         return null;
     const colNameLower = colName.toLowerCase();
-    // 先尝试匹配语言key
+    // 先尝试匹配语言KEY
     for (const langKey of Object.keys(langs)) {
         if (langKey.toLowerCase() === colNameLower) {
             return langKey;
@@ -135,10 +135,10 @@ function parseCheckResultPerEntry(checkResult, texts) {
     return entryErrors;
 }
 /**
- * excel转json功能主函数
- * 读取用户输入的excel路径，解析内容，根据配置生成多语言json文件
+ * Excel转JSON功能主函数
+ * 读取用户输入的Excel路径，解析内容，根据配置生成多语言JSON文件
  * 并对配置文件中所有语言对应的词条进行语言检测
- * 如果有相同的json key，则在key前面加上6位编码，保证唯一性
+ * 如果有相同的JSON KEY，则在KEY前面加上6位编码，保证唯一性
  * @param program Commander命令行实例
  */
 export async function excel2json(program) {
@@ -173,7 +173,7 @@ export async function excel2json(program) {
             });
         }
         for (const lang of languageTools) {
-            // 尝试根据语言名称匹配配置中的语言key
+            // 尝试根据语言名称匹配配置中的语言KEY
             const lowerName = lang.name.toLowerCase();
             const matchedKey = langNameToKey[lowerName] ||
                 Object.keys(i18nConfig.langs).find((k) => k.toLowerCase() === lowerName);
@@ -188,9 +188,9 @@ export async function excel2json(program) {
         logger.warn(`获取在线语言列表失败，使用本地配置 longCodes，错误：${normalizeError(error).stack}`);
         console.warn('获取在线语言列表失败，使用本地配置 longCodes');
     }
-    // 交互式输入excel文件路径并校验
+    // 交互式输入Excel文件路径并校验
     const answer = await input({
-        message: '请输入excel文件路径：',
+        message: '请输入Excel文件路径：',
         validate: (value) => {
             const cleaned = value.trim().replace(/^['"]|['"]$/g, '');
             if (cleaned.length === 0)
@@ -198,19 +198,19 @@ export async function excel2json(program) {
             if (!fs.existsSync(cleaned))
                 return '文件不存在，请输入有效路径';
             if (!/\.(xls|xlsx)$/i.test(cleaned))
-                return '请输入有效的excel文件路径（.xls或.xlsx）';
+                return '请输入有效的Excel文件路径（.xls或.xlsx）';
             return true;
         },
     });
     // 规范化路径，支持相对路径转绝对路径，去除首尾引号
     const excelPath = path.resolve(process.cwd(), answer.trim().replace(/^['"]|['"]$/g, ''));
     try {
-        logger.info(`开始读取excel文件：${excelPath}`, true);
-        // 读取excel文件
+        logger.info(`开始读取Excel文件：${excelPath}`, true);
+        // 读取Excel文件
         const workbook = XLSX.readFile(excelPath);
         const firstSheetName = workbook.SheetNames[0];
         if (!firstSheetName) {
-            logger.error('excel文件没有任何工作表，程序已退出');
+            logger.error('Excel文件没有任何工作表，程序已退出');
             console.error('程序执行时发生异常，已记录日志，程序已退出');
             process.exit(1);
         }
@@ -225,7 +225,7 @@ export async function excel2json(program) {
         logger.info('开始解析表头', true);
         // 处理表头行，去除空格，转成字符串
         const headerRow = rows[0].map((cell) => (cell ? String(cell).trim() : ''));
-        // 根据表头匹配语言列，建立列索引到语言key的映射
+        // 根据表头匹配语言列，建立列索引到语言KEY的映射
         const colIndexToLangKey = {};
         headerRow.forEach((colName, idx) => {
             const langKey = matchLangKey(colName, i18nConfig.langs);
@@ -243,20 +243,20 @@ export async function excel2json(program) {
         }
         const defaultColNum = Number(defaultColIndex);
         // 初始化所有语言词条对象（包括默认语言）
-        // 用于存储最终的翻译key-value对，key可能会被重新编码以避免重复
+        // 用于存储最终的翻译KEY-VALUE对，KEY可能会被重新编码以避免重复
         const langTranslations = {};
         Object.values(colIndexToLangKey).forEach((langKey) => {
             langTranslations[langKey] = {};
         });
         logger.info('开始解析数据行', true);
-        // 记录所有出现过的key，检测重复，格式：langKey => Set of keys
+        // 记录所有出现过的KEY，检测重复，格式：langKey => Set of keys
         const langKeySets = {};
         Object.keys(langTranslations).forEach((langKey) => {
             langKeySets[langKey] = new Set();
         });
         // 遍历数据行，提取所有语言词条
-        // key统一用默认语言列的值，其他语言对应的列为翻译内容
-        const langKeysMap = {}; // 语言key => 词条数组（用于检测）
+        // KEY统一用默认语言列的值，其他语言对应的列为翻译内容
+        const langKeysMap = {}; // 语言KEY => 词条数组（用于检测）
         Object.keys(langTranslations).forEach((langKey) => {
             langKeysMap[langKey] = [];
         });
@@ -267,15 +267,15 @@ export async function excel2json(program) {
                 continue;
             let key = String(keyCell).trim();
             key = trimQuotes(key); // 去除引号
-            // 跳过空key，避免写入无效数据
+            // 跳过空KEY，避免写入无效数据
             if (key.length === 0)
                 continue;
-            // 判断默认语言key是否重复，若重复则重新编码
+            // 判断默认语言KEY是否重复，若重复则重新编码
             if (langKeySets[defaultLang].has(key)) {
                 key = formatKey(key);
             }
             langKeySets[defaultLang].add(key);
-            // 默认语言的词条即key本身
+            // 默认语言的词条即KEY本身
             langTranslations[defaultLang][key] = key;
             langKeysMap[defaultLang].push(key);
             // 其他语言词条
@@ -286,7 +286,7 @@ export async function excel2json(program) {
                 const valCell = row[colIdx];
                 if (valCell !== undefined && valCell !== null && valCell !== '') {
                     const valStr = String(valCell);
-                    // 判断该语言的key是否重复，若重复则重新编码key
+                    // 判断该语言的KEY是否重复，若重复则重新编码KEY
                     let finalKey = key;
                     if (langKeySets[langKey].has(finalKey)) {
                         finalKey = formatKey(finalKey);
@@ -301,7 +301,7 @@ export async function excel2json(program) {
                 }
             }
         }
-        // 语言检测结果映射，语言key => 每条词条的错误描述数组
+        // 语言检测结果映射，语言KEY => 每条词条的错误描述数组
         const langCheckErrorsMap = {};
         // 对所有语言词条批量进行语言检测（包括默认语言）
         const langKeysEntries = Object.entries(langKeysMap);
@@ -343,7 +343,7 @@ export async function excel2json(program) {
                 }
             }
         }
-        // 输出目录：excel文件所在目录下的“lang_时间戳”文件夹
+        // 输出目录：Excel文件所在目录下的“lang_时间戳”文件夹
         const excelDir = path.dirname(excelPath);
         const timestamp = getTimestamp();
         const outputRoot = path.join(excelDir, `lang_${timestamp}`);
@@ -351,12 +351,12 @@ export async function excel2json(program) {
             fs.mkdirSync(outputRoot, { recursive: true });
         }
         logger.info(`开始生成语言文件，输出目录：${outputRoot}`, true);
-        // 按语言生成对应的json文件，默认语言的key=value不生成文件
+        // 按语言生成对应的JSON文件，默认语言的KEY=VALUE不生成文件
         for (const [langKey, translations] of Object.entries(langTranslations)) {
             if (Object.keys(translations).length === 0)
                 continue;
             if (langKey === defaultLang) {
-                logger.info(`跳过默认语言(${langKey})的json文件生成`, true);
+                logger.info(`跳过默认语言(${langKey})的JSON文件生成`, true);
                 continue; // 跳过默认语言文件生成
             }
             const langDir = path.join(outputRoot, langKey);
@@ -369,21 +369,21 @@ export async function excel2json(program) {
             });
             logger.info(`已生成语言文件：${filePath}`, true);
         }
-        // 生成语言检测结果excel文件
-        logger.info('开始生成语言检测结果excel文件', true);
-        // 构造检测结果excel的表头：默认语言列 + 其他语言列（对应原文列名）
-        // 这里表头用原excel的表头中对应语言列的值
+        // 生成语言检测结果Excel文件
+        logger.info('开始生成语言检测结果Excel文件', true);
+        // 构造检测结果Excel的表头：默认语言列 + 其他语言列（对应原文列名）
+        // 这里表头用原Excel的表头中对应语言列的值
         const errorSheetHeader = [];
-        // 按列索引顺序遍历，匹配语言key，构造表头
+        // 按列索引顺序遍历，匹配语言KEY，构造表头
         Object.entries(colIndexToLangKey)
             .sort((a, b) => Number(a[0]) - Number(b[0]))
             .forEach(([colIdxStr, langKey]) => {
             const colIdx = Number(colIdxStr);
-            // 表头为原excel表头中对应列的文字
+            // 表头为原Excel表头中对应列的文字
             errorSheetHeader.push(headerRow[colIdx]);
         });
-        // 构造检测结果excel的内容，每一列对应语言检测错误描述
-        // 每行对应原excel中一条数据行
+        // 构造检测结果Excel的内容，每一列对应语言检测错误描述
+        // 每行对应原Excel中一条数据行
         const dataRowCount = rows.length - 1;
         const errorSheetData = [errorSheetHeader];
         for (let i = 0; i < dataRowCount; i++) {
@@ -405,14 +405,14 @@ export async function excel2json(program) {
             });
             errorSheetData.push(rowErrors);
         }
-        // 生成excel工作簿和工作表
+        // 生成Excel工作簿和工作表
         const errorWorkbook = XLSX.utils.book_new();
         const errorSheet = XLSX.utils.aoa_to_sheet(errorSheetData);
         XLSX.utils.book_append_sheet(errorWorkbook, errorSheet, 'LanguageCheckResults');
-        // 写入检测结果excel文件，固定文件名 lang_check_results.xlsx
+        // 写入检测结果Excel文件，固定文件名 lang_check_results.xlsx
         const errorExcelPath = path.join(outputRoot, `lang_check_results.xlsx`);
         XLSX.writeFile(errorWorkbook, errorExcelPath);
-        logger.info(`语言检测结果excel文件已生成：${errorExcelPath}`, true);
+        logger.info(`语言检测结果Excel文件已生成：${errorExcelPath}`, true);
         // 最终完成提示，包含输出目录
         logger.info(`全部转换完成，语言文件输出目录：${outputRoot}`, true);
     }

package/dist/modules/i18n/index.js

@@ -1,6 +1,6 @@
 import { select, Separator } from '@inquirer/prompts';
-import { excel2json } from './excel2json/index.js';
 import { logger, loggerError } from '../../utils/index.js';
+import { excel2json } from './excel2json/index.js';
 /**
  * 国际化模块主入口
  * 提供多个国际化相关功能的交互式选择
@@ -17,19 +17,19 @@ export async function i18n(program) {
                 description: '从所给路径中提取词条信息',
             },
             {
-                name: 'json转excel',
+                name: 'JSON转Excel',
                 value: 'json2excel',
-                description: '将json格式的词条信息转换为excel表格',
+                description: '将JSON格式的词条信息转换为Excel表格',
             },
             {
-                name: 'excel转json',
+                name: 'Excel转JSON',
                 value: 'excel2json',
-                description: '将excel表格转换为json格式的词条信息',
+                description: '将Excel表格转换为JSON格式的词条信息',
             },
             {
-                name: 'json合并',
+                name: 'JSON合并',
                 value: 'jsonMerge',
-                description: '合并多个json格式的词条信息文件',
+                description: '合并多个JSON格式的词条信息文件',
             },
         ];
         // 交互式选择需要执行的功能

package/dist/modules/i18n/json2excel/index.js

@@ -1,3 +1,3 @@
 export function run() {
-    console.log('json转excel');
+    console.log('JSON转Excel');
 }

package/dist/modules/i18n/jsonMerge/index.js

@@ -1,3 +1,3 @@
 export function run() {
-    console.log('json合并');
+    console.log('JSON合并');
 }

package/dist/modules/tools/getHolidayTime/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 获取节假日信息并打印最近三个节假日详情，节假日名称黄色，序号无颜色
+ * 并打印请求和处理进度提示
+ */
+export declare function getHolidayTime(): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/tools/getHolidayTime/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/tools/getHolidayTime/index.ts"],"names":[],"mappings":"AA6HA;;;GAGG;AACH,wBAAsB,cAAc,kBAoCnC"}

package/dist/modules/tools/getHolidayTime/index.js

@@ -0,0 +1,111 @@
+import { getData } from '../../../api/index.js';
+import api from '../../../api/interface.js';
+import { logger, loggerError } from '../../../utils/index.js';
+/**
+ * 计算从今天起最近的几个节假日信息
+ * @param data 节假日数据
+ * @param count 需要返回的节假日数量，默认3
+ * @returns 最近count个节假日的汇总信息数组
+ */
+function getNearestHolidays(data, count = 3) {
+    const today = new Date();
+    // 过滤出所有节假日和调休日
+    const holidays = data.dates.filter((d) => d.type.toLowerCase() === 'public_holiday');
+    const transferWorkdays = data.dates.filter((d) => d.type.toLowerCase() === 'transfer_workday');
+    // 解析日期字符串为Date对象，确保时区正确
+    function parseDate(dateStr) {
+        return new Date(dateStr + 'T00:00:00');
+    }
+    // 按日期升序排序节假日
+    holidays.sort((a, b) => parseDate(a.date).getTime() - parseDate(b.date).getTime());
+    // 筛选今天及以后日期的节假日
+    const upcomingHolidays = holidays.filter((h) => parseDate(h.date) >= today);
+    // 将连续日期且名称相同的节假日合并为一个节日区间
+    const grouped = [];
+    let currentGroup = null;
+    for (const h of upcomingHolidays) {
+        const hd = parseDate(h.date);
+        if (!currentGroup) {
+            // 初始化第一个节日组
+            currentGroup = {
+                name: h.name,
+                daysUntil: Math.floor((hd.getTime() - today.getTime()) / (1000 * 60 * 60 * 24)),
+                holidayDates: [h.date],
+                hasTransferWorkday: false,
+                transferWorkdays: [],
+            };
+        }
+        else {
+            // 判断是否是连续日期且名称相同，合并到当前组
+            const lastDate = parseDate(currentGroup.holidayDates[currentGroup.holidayDates.length - 1]);
+            const diffDays = (hd.getTime() - lastDate.getTime()) / (1000 * 60 * 60 * 24);
+            if (diffDays === 1 && h.name === currentGroup.name) {
+                currentGroup.holidayDates.push(h.date);
+            }
+            else {
+                // 不连续或名称不同，保存当前组，开启新组
+                grouped.push(currentGroup);
+                currentGroup = {
+                    name: h.name,
+                    daysUntil: Math.floor((hd.getTime() - today.getTime()) / (1000 * 60 * 60 * 24)),
+                    holidayDates: [h.date],
+                    hasTransferWorkday: false,
+                    transferWorkdays: [],
+                };
+            }
+        }
+    }
+    if (currentGroup) {
+        grouped.push(currentGroup);
+    }
+    // 为每个节假日组匹配调休日（调休日距离节假日区间前后7天内视为相关）
+    for (const group of grouped) {
+        const start = parseDate(group.holidayDates[0]);
+        const end = parseDate(group.holidayDates[group.holidayDates.length - 1]);
+        const relatedTransfers = transferWorkdays.filter((t) => {
+            const td = parseDate(t.date);
+            return (Math.abs(td.getTime() - start.getTime()) <= 7 * 24 * 60 * 60 * 1000 ||
+                Math.abs(td.getTime() - end.getTime()) <= 7 * 24 * 60 * 60 * 1000);
+        });
+        if (relatedTransfers.length > 0) {
+            group.hasTransferWorkday = true;
+            group.transferWorkdays = relatedTransfers.map((t) => t.date);
+        }
+    }
+    // 返回最近count个节假日
+    return grouped.slice(0, count);
+}
+/**
+ * 获取节假日信息并打印最近三个节假日详情，节假日名称黄色，序号无颜色
+ * 并打印请求和处理进度提示
+ */
+export async function getHolidayTime() {
+    try {
+        logger.info('开始获取节假日数据...', true);
+        const year = new Date().getFullYear();
+        const url = api.UNPKG_HOLIDAY_CALENDAR + `/${year}.json`;
+        const data = await getData(url);
+        logger.info('节假日数据请求成功，开始计算最近节假日...', true);
+        const nearest = getNearestHolidays(data, 3);
+        console.log('\x1b[36m%s\x1b[0m', '=== 最近三个节假日信息 ==='); // 青色标题
+        nearest.forEach((holiday, index) => {
+            console.log(`第${index + 1}个节假日: \x1b[33m\x1b[1m${holiday.name}\x1b[0m`); // 节假日名称黄色加粗
+            console.log(`距离今天还有: \x1b[32m${holiday.daysUntil} 天\x1b[0m`); // 绿色天数
+            console.log(`放假日期: \x1b[35m${holiday.holidayDates.join(', ')}\x1b[0m`); // 紫色日期
+            if (holiday.hasTransferWorkday) {
+                console.log(`包含调休日期: \x1b[31m${holiday.transferWorkdays.join(', ')}\x1b[0m`); // 红色调休日
+            }
+            else {
+                console.log('\x1b[37m无调休\x1b[0m'); // 白色无调休
+            }
+            console.log('\x1b[90m---------------------\x1b[0m'); // 灰色分割线
+        });
+        logger.info('节假日信息打印完成。', true);
+    }
+    catch (error) {
+        // 记录错误日志，方便排查
+        loggerError(error, logger);
+        console.error('程序执行时发生异常，已记录日志，程序已退出');
+        process.exit(1);
+    }
+}

package/dist/modules/tools/holidayTime/index.d.ts

@@ -0,0 +1,13 @@
+type HolidayInfo = {
+    name: string;
+    start: Date;
+    end: Date;
+    daysLeft: number;
+};
+/**
+ * 获取最近两个节假日放假时间和距离天数
+ */
+export declare function getHolidayTime(currentDate?: Date): Promise<HolidayInfo[]>;
+export declare function holidayTime(): Promise<void>;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/tools/holidayTime/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/tools/holidayTime/index.ts"],"names":[],"mappings":"AAGA,KAAK,WAAW,GAAG;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,IAAI,CAAC;IACZ,GAAG,EAAE,IAAI,CAAC;IACV,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAuEF;;GAEG;AACH,wBAAsB,cAAc,CAClC,WAAW,OAAa,GACvB,OAAO,CAAC,WAAW,EAAE,CAAC,CA+DxB;AAED,wBAAsB,WAAW,kBAUhC"}

package/dist/modules/tools/holidayTime/index.js

@@ -0,0 +1,116 @@
+import axios from 'axios';
+import { Lunar } from 'lunar-javascript';
+const lunarHolidays = [
+    { name: '春节', lunarMonth: 1, lunarDay: 1, duration: 7 },
+    { name: '端午节', lunarMonth: 5, lunarDay: 5, duration: 3 },
+    { name: '中秋节', lunarMonth: 8, lunarDay: 15, duration: 3 },
+];
+/**
+ * 解析 yyyy-mm-dd 字符串成 Date（00:00:00）
+ */
+function parseDate(dateStr) {
+    return new Date(dateStr + 'T00:00:00');
+}
+/**
+ * 获取农历节日对应当年公历放假起止日期
+ */
+function getLunarHolidayDates(year) {
+    return lunarHolidays.map((h) => {
+        const lunar = Lunar.fromYmd(year, h.lunarMonth, h.lunarDay);
+        const start = lunar.getSolar().toDate();
+        const end = new Date(start);
+        end.setDate(start.getDate() + h.duration - 1);
+        return { name: h.name, start, end, daysLeft: 0 };
+    });
+}
+/**
+ * 合并连续且同名的节假日日期区间
+ */
+function mergeHolidays(holidays) {
+    if (holidays.length === 0)
+        return [];
+    holidays.sort((a, b) => a.start.getTime() - b.start.getTime());
+    const merged = [];
+    for (const h of holidays) {
+        const last = merged[merged.length - 1];
+        if (last &&
+            h.name === last.name &&
+            h.start.getTime() === last.end.getTime() + 86400000) {
+            // 连续且同名，延长结束日期
+            last.end = h.end;
+        }
+        else {
+            merged.push({ ...h });
+        }
+    }
+    return merged;
+}
+/**
+ * 计算两个日期相差天数（date2 - date1）
+ */
+function daysBetween(date1, date2) {
+    const msPerDay = 1000 * 60 * 60 * 24;
+    return Math.floor((date2.getTime() - date1.getTime()) / msPerDay);
+}
+/**
+ * 获取最近两个节假日放假时间和距离天数
+ */
+export async function getHolidayTime(currentDate = new Date()) {
+    const year = currentDate.getFullYear();
+    const today = new Date(currentDate.toDateString());
+    // 1. 获取当年官方节假日数据（含调休）
+    const res = await axios.get(`http://timor.tech/api/holiday/year`);
+    if (res.status !== 200) {
+        throw new Error('获取节假日数据失败');
+    }
+    const data = res.data;
+    // 2. 从API数据中筛选放假日期（holiday=true）
+    const apiHolidaysRaw = Object.entries(data.holiday)
+        .filter(([_, info]) => info.holiday)
+        .map(([date, info]) => ({
+        name: info.name,
+        start: parseDate(date),
+        end: parseDate(date),
+        daysLeft: 0,
+    }));
+    // 3. 合并连续放假日期（同名且连续）
+    const apiHolidays = mergeHolidays(apiHolidaysRaw);
+    // 4. 计算农历节日对应公历日期，补充可能遗漏的节日
+    const lunarHols = getLunarHolidayDates(year);
+    // 5. 合并API节假日和农历节假日（避免重复）
+    const allHolidays = [...apiHolidays];
+    lunarHols.forEach((lh) => {
+        const exists = allHolidays.some((h) => h.name === lh.name &&
+            h.start.getTime() === lh.start.getTime() &&
+            h.end.getTime() === lh.end.getTime());
+        if (!exists) {
+            allHolidays.push(lh);
+        }
+    });
+    // 6. 计算距离今天的天数，如果节日已过则计算下一年对应日期距离
+    const futureHolidays = allHolidays.map((h) => {
+        let daysLeft = daysBetween(today, h.start);
+        if (daysLeft < 0) {
+            // 节日已过，计算下一年对应节日日期
+            const nextYearStart = new Date(h.start);
+            nextYearStart.setFullYear(nextYearStart.getFullYear() + 1);
+            const nextYearEnd = new Date(h.end);
+            nextYearEnd.setFullYear(nextYearEnd.getFullYear() + 1);
+            daysLeft = daysBetween(today, nextYearStart);
+            return { name: h.name, start: nextYearStart, end: nextYearEnd, daysLeft };
+        }
+        return { ...h, daysLeft };
+    });
+    // 7. 按距离排序，返回最近两个节日
+    futureHolidays.sort((a, b) => a.daysLeft - b.daysLeft);
+    return futureHolidays.slice(0, 2);
+}
+export async function holidayTime() {
+    return getHolidayTime().then((holidays) => {
+        holidays.forEach((h) => {
+            console.log(`距离${h.name}放假还有 ${h.daysLeft} 天，放假时间：${h.start
+                .toISOString()
+                .slice(0, 10)} 至 ${h.end.toISOString().slice(0, 10)}`);
+        });
+    });
+}

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

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

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

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

package/dist/modules/tools/index.js

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

package/dist/modules/tools/printFish/index.d.ts

@@ -0,0 +1,2 @@
+export declare function printFish(): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/tools/printFish/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/tools/printFish/index.ts"],"names":[],"mappings":"AAAA,wBAAgB,SAAS,IAAI,IAAI,CA6ChC"}

package/dist/modules/tools/printFish/index.js

@@ -0,0 +1,46 @@
+export function printFish() {
+    console.log(`
+╔══════════════════════════════════════════════════════════════╗
+║                    🐟✨ 摸 鱼 盛 宴 ✨🐟                      ║
+╠══════════════════════════════════════════════════════════════╣
+║                                                              ║
+║         ~~~~~      ~~~    ~~~~~~~~       ~~~~~      ~~~     ║
+║     ~~~~     ~~~      ~~~~~~~~    ~~ ~~~~    ~~~      ~~~   ║
+║   ~~~          ~~~~~~~~~~       ~~~~~          ~~~~~~~~~~   ║
+║                                                              ║
+║                           ╭─────────╮                       ║
+║                           │   👤   │                        ║
+║                           │  /|\\   │                        ║
+║                           │  / \\   │                        ║
+║                           ╰────┬────╯                       ║
+║                                │                            ║
+║                                │                            ║
+║                                │ 🎣                         ║
+║                                ↓                            ║
+║                                                              ║
+║           ╭────────────────────────────────────╮            ║
+║           │     ░░░░░░░░░░░░░░░░░░░░░░░░      │            ║
+║           │   ░░  🌊   湖  塘   🌊    ░░     │            ║
+║           │  ░                               ░  │            ║
+║           │ ░       🐠   🐟   🐡        ░   │            ║
+║           │░     /≻\\     />\\     <\\≺     ░  │            ║
+║           │░    /   \\   /___\\   /   \\    ░  │            ║
+║           │░   o >< ))> (🐟 )  <) >< o   ░  │            ║
+║           │░     \\__/     \\_/     \\__/     ░  │            ║
+║           │ ░                               ░   │            ║
+║           │  ░░                            ░░  │            ║
+║           │     ░░░░░░░░░░░░░░░░░░░░░░░░      │            ║
+║           ╰────────────────────────────────────╯            ║
+║                                                              ║
+║   ~~~          ~~~~~~~~~~       ~~~~~          ~~~~~~~~~~   ║
+║     ~~~~     ~~~      ~~~~~~~~    ~~ ~~~~    ~~~      ~~~   ║
+║         ~~~~~      ~~~    ~~~~~~~~       ~~~~~      ~~~     ║
+║                                                              ║
+║  💬 "老板不在家，摸鱼乐哈哈！"                               ║
+║  📈 摸鱼指数：███████████░░░░░░░ 75%                        ║
+║  ⚡ 摸鱼效率：██████████████░░░░ 85%                        ║
+║  🛡️  隐蔽指数：██████████████████ 100%                       ║
+║                                                              ║
+╚══════════════════════════════════════════════════════════════╝
+  `);
+}

package/docs/i18n/excel2json.md

@@ -1,6 +1,6 @@
-# 多语言 excel 转 json 工具
+# 多语言 Excel 转 JSON 工具
 
-该工具基于配置文件，实现将多语言 excel 文件转换为对应的 json 翻译文件，并支持语言检测和重复 key 处理，方便多语言项目的词条管理与质量控制。
+该工具基于配置文件，实现将多语言 Excel 文件转换为对应的 JSON 翻译文件，并支持语言检测和重复 Key 处理，方便多语言项目的词条管理与质量控制。
 
 ---
 
@@ -9,58 +9,58 @@
 1. **配置文件读取与解析**
    - 从本地 `setting.json` 文件读取国际化配置，包括默认语言、语言映射和语言长代码。
 
-2. **excel 表头语言列匹配**
-   - 根据配置自动识别 excel 表头中的语言列，支持大小写不敏感匹配和语言名称模糊匹配。
+2. **Excel 表头语言列匹配**
+   - 根据配置自动识别 Excel 表头中的语言列，支持大小写不敏感匹配和语言名称模糊匹配。
 
-3. **excel 文件读取与数据解析**
-   - 读取用户指定路径的 excel 文件，提取第一个工作表的内容。
+3. **Excel 文件读取与数据解析**
+   - 读取用户指定路径的 Excel 文件，提取第一个工作表的内容。
    - 解析表头和数据行，提取多语言词条。
 
-4. **重复 json key 处理**
-   - 对默认语言列的 key 进行去重处理，若存在重复，则在 key 前添加随机生成的6位编码前缀，确保 json key 唯一。
-   - 其他语言的 key 也进行同样处理，避免冲突。
+4. **重复 JSON Key 处理**
+   - 对默认语言列的 Key 进行去重处理，若存在重复，则在 Key 前添加随机生成的6位编码前缀，确保 JSON Key 唯一。
+   - 其他语言的 Key 也进行同样处理，避免冲突。
 
 5. **批量语言检测**
    - 将所有语言词条拼接成字符串，一次性调用语言检测接口，减少请求次数，提高检测效率。
    - 解析检测结果，拆分到每条词条对应的错误信息。
 
-6. **生成多语言 json 文件**
-   - 为每个语言生成对应的 json 翻译文件，默认语言文件不生成。
+6. **生成多语言 JSON 文件**
+   - 为每个语言生成对应的 JSON 翻译文件，默认语言文件不生成。
 
-7. **生成语言检测结果 excel 文件**
-   - 生成包含所有语言检测错误信息的 excel 文件，方便查看和修正。
+7. **生成语言检测结果 Excel 文件**
+   - 生成包含所有语言检测错误信息的 Excel 文件，方便查看和修正。
 
 8. **命令行交互与日志记录**
-   - 通过命令行交互输入 excel 文件路径。
+   - 通过命令行交互输入 Excel 文件路径。
    - 详细日志记录执行过程、错误和警告，便于排查问题。
 
 ---
 
 ## 使用说明
 
-1. 准备好符合格式的 excel 文件，第一行为表头，包含语言列（如 `en`, `zh-CN` 等）。
+1. 准备好符合格式的 Excel 文件，第一行为表头，包含语言列（如 `en`, `zh-CN` 等）。
 2. 配置好 `setting.json`，包含国际化相关配置。
-3. 运行工具，输入 excel 文件路径。
-4. 程序将自动解析 excel，生成多语言 json 文件和语言检测结果 excel。
-5. 结果文件输出在 excel 文件所在目录的 `lang_时间戳` 文件夹中。
+3. 运行工具，输入 Excel 文件路径。
+4. 程序将自动解析 Excel，生成多语言 JSON 文件和语言检测结果 Excel。
+5. 结果文件输出在 Excel 文件所在目录的 `lang_时间戳` 文件夹中。
 
 ---
 
 ## 代码结构简述
 
-- `formatKey` / `decodeKey`：处理重复 key，添加或去除随机编码前缀。
+- `formatKey` / `decodeKey`：处理重复 Key，添加或去除随机编码前缀。
 - `loadConfig`：读取并校验配置文件。
-- `matchLangKey`：匹配 excel 表头语言列。
+- `matchLangKey`：匹配 Excel 表头语言列。
 - `batchCheckTexts` / `parseCheckResultPerEntry`：批量调用语言检测并解析结果。
-- `excel2json`：主函数，完成 excel 读取、解析、语言检测、文件生成等流程。
+- `excel2json`：主函数，完成 Excel 读取、解析、语言检测、文件生成等流程。
 
 ---
 
 ## 备注
 
-- 默认语言的 json 文件不会生成，默认语言词条作为 key 使用。
+- 默认语言的 JSON 文件不会生成，默认语言词条作为 Key 使用。
 - 语言检测依赖在线服务，若获取语言列表失败则使用本地配置。
-- 重复 key 处理确保生成的 json 文件中不会有冲突的键名。
+- 重复 Key 处理确保生成的 JSON 文件中不会有冲突的键名。
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "td-web-cli",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "description": "A CLI tool for efficiency",
   "main": "dist/index.js",
   "type": "module",
@@ -17,6 +17,9 @@
     "format": "prettier --write \"src/**/*.{js,ts,tsx,json,md}\"",
     "release": "node ./release.js"
   },
+  "engines": {
+    "node": ">=20"
+  },
   "keywords": [],
   "author": "",
   "license": "ISC",