td-web-cli 0.1.18 → 0.1.19

package/README.md

@@ -76,7 +76,7 @@ td-web-cli
 ### 功能说明
 
 - 多语言 Excel 转 JSON 工具。[详细功能说明请点击这里](https://github.com/qianyuzzf/td-web-cli/blob/master/docs/i18n/excel2json.md)
-- 获取假期时间工具。[详细功能说明请点击这里](https://github.com/qianyuzzf/td-web-cli/blob/master/docs/tools/getHolidayTime.md)
+- 节假日查询工具。[详细功能说明请点击这里](https://github.com/qianyuzzf/td-web-cli/blob/master/docs/tools/getHolidayTime.md)
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "td-web-cli",
-  "version": "0.1.18",
+  "version": "0.1.19",
   "description": "A CLI tool for efficiency",
   "main": "dist/index.js",
   "type": "module",
@@ -9,8 +9,7 @@
   },
   "files": [
     "dist",
-    "setting.json",
-    "docs/**/*.md"
+    "setting.json"
   ],
   "scripts": {
     "build": "tsc",

package/docs/i18n/excel2json.md

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

package/docs/tools/getHolidayTime.md

@@ -1,68 +0,0 @@
-# 节假日查询工具
-
-该工具基于节假日数据接口，实现获取指定年份的节假日信息，并计算从今天起最近的几个节假日详情，支持调休日识别和节假日连续日期合并，方便用户快速了解即将到来的假期安排。
-
----
-
-## 主要功能
-
-1. **节假日数据请求**
-   - 动态请求指定年份的节假日 JSON 数据，支持多地区扩展。
-
-2. **节假日与调休日区分**
-   - 过滤并区分公共节假日（public_holiday）和调休日（transfer_workday），分别处理。
-
-3. **节假日连续日期合并**
-   - 将连续日期且名称相同的节假日合并为一个节日区间，输出更友好的节假日信息。
-
-4. **调休日匹配**
-   - 对每个节日区间匹配前后7天内的调休日，标记并列出相关调休日日期。
-
-5. **距离计算**
-   - 计算每个节假日距离今天还有多少天，便于用户判断假期时间。
-
-6. **控制台彩色打印**
-   - 使用不同颜色高亮节假日名称、距离天数、放假日期及调休日，提升阅读体验。
-
-7. **异常捕获与日志记录**
-   - 捕获请求和处理异常，记录详细日志，确保程序稳定运行。
-
----
-
-## 使用说明
-
-1. 运行程序时，自动获取当前年份节假日数据。
-2. 程序会计算并打印距离今天最近的三个节假日的详细信息。
-3. 控制台输出包括节假日名称（黄色加粗）、距离天数（绿色）、放假日期（紫色）、调休日（红色）等。
-4. 如发生异常，程序会记录错误日志并退出。
-
----
-
-## 代码结构简述
-
-- **接口定义**
-  - `HolidayDate`：节假日单条记录，包含日期、名称和类型。
-  - `HolidayData`：节假日数据集合，包含年份、地区和日期列表。
-  - `HolidaySummary`：节假日汇总信息，包含名称、距离天数、放假日期及调休日信息。
-
-- **核心函数**
-  - `getNearestHolidays(data, count)`：计算从今天起最近的若干节假日汇总信息，合并连续节日并匹配调休日。
-  - `getHolidayTime()`：异步函数，负责请求数据、调用计算函数并打印结果，含异常处理和日志记录。
-
-- **辅助逻辑**
-  - 日期解析确保时区正确。
-  - 节假日排序和筛选保证输出顺序和准确性。
-  - 调休日匹配采用时间窗口策略。
-
----
-
-## 备注
-
-- 调休日匹配时间窗口为节假日区间前后7天内。
-- 输出节假日数量默认3个，可通过参数调整。
-- 控制台颜色使用 ANSI 转义码，兼容大多数终端。
-- 程序依赖外部 API 和日志工具，请确保相关模块正确配置。
-
----
-
-欢迎反馈和贡献！