feat(v1.0.12): 增加日志记录和重试功能

CHANGELOG.md

@@ -1,6 +1,6 @@
-## v1.0.11
+## v1.0.12
 
-[compare changes](https://github.com/h7ml/ai-markdown-translator/compare/v1.0.11...v1.0.11)
+[compare changes](https://github.com/h7ml/ai-markdown-translator/compare/v1.0.12...v1.0.12)
 
 ### 💅 Refactors
 
@@ -10,7 +10,7 @@
 
 - **README:** Update README-zh.md ([8ceca79](https://github.com/h7ml/ai-markdown-translator/commit/8ceca79))
 
-- **release:** Update CHANGELOG for v1.0.11 [skip ci] ([d17947d](https://github.com/h7ml/ai-markdown-translator/commit/d17947d))
+- **release:** Update CHANGELOG for v1.0.12 [skip ci] ([d17947d](https://github.com/h7ml/ai-markdown-translator/commit/d17947d))
 
 ### ❤️ Contributors
 
@@ -19,7 +19,7 @@
 
 ## v1.0.9
 
-[compare changes](https://github.com/h7ml/ai-markdown-translator/compare/v1.0.11...v1.0.9)
+[compare changes](https://github.com/h7ml/ai-markdown-translator/compare/v1.0.12...v1.0.9)
 
 ### 📖 Documentation
 
@@ -28,7 +28,7 @@
 
 ### 🏡 Chore
 
-- **release:** Update CHANGELOG for v1.0.11 [skip ci] ([d17947d](https://github.com/h7ml/ai-markdown-translator/commit/d17947d))
+- **release:** Update CHANGELOG for v1.0.12 [skip ci] ([d17947d](https://github.com/h7ml/ai-markdown-translator/commit/d17947d))
 
 ### ❤️ Contributors
 

README-zh.md

@@ -1,38 +1,42 @@
 # ai-markdown-translator
 
 <div>
-  <a href="https://www.npmjs.org/package/ai-markdown-translator"><img src="https://img.shields.io/npm/v/ai-markdown-translator.svg?style=flat" alt="NPM 版本"></a>
+  <a href="https://www.npmjs.org/package/ai-markdown-translator"><img src="https://img.shields.io/npm/v/ai-markdown-translator.svg?style=flat" alt="NPM version"></a>
   <a href="https://github.com/h7ml/ai-markdown-translator/actions/workflows/ci.yml"><img src="https://github.com/h7ml/ai-markdown-translator/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
-  <a href="https://github.com/h7ml/ai-markdown-translator/actions/workflows/release.yml"><img src="https://github.com/h7ml/ai-markdown-translator/actions/workflows/release.yml/badge.svg" alt="发布"></a>
-  <a href="https://www.npmjs.org/package/ai-markdown-translator"><img src="https://img.shields.io/npm/dw/ai-markdown-translator" alt="NPM 下载量"></a>
-  <a href="https://www.npmjs.org/package/ai-markdown-translator"><img src="https://img.shields.io/npm/l/ai-markdown-translator" alt="NPM 许可证"></a>
+  <a href="https://github.com/h7ml/ai-markdown-translator/actions/workflows/release.yml"><img src="https://github.com/h7ml/ai-markdown-translator/actions/workflows/release.yml/badge.svg" alt="Release"></a>
+  <a href="https://www.npmjs.org/package/ai-markdown-translator"><img src="https://img.shields.io/npm/dw/ai-markdown-translator" alt="NPM Downloads"></a>
+  <a href="https://www.npmjs.org/package/ai-markdown-translator"><img src="https://img.shields.io/npm/l/ai-markdown-translator" alt="NPM License"></a>
   <a href="https://github.com/h7ml/ai-markdown-translator/stargazers"><img src="https://img.shields.io/github/stars/h7ml/ai-markdown-translator.svg" alt="GitHub Stars"></a>
   <a href="https://github.com/h7ml/ai-markdown-translator/issues"><img src="https://img.shields.io/github/issues/h7ml/ai-markdown-translator.svg" alt="GitHub Issues"></a>
   <a href="https://github.com/h7ml/ai-markdown-translator/network/members"><img src="https://img.shields.io/github/forks/h7ml/ai-markdown-translator.svg" alt="GitHub Forks"></a>
   <a href="https://github.com/h7ml/ai-markdown-translator/graphs/contributors"><img src="https://img.shields.io/github/contributors/h7ml/ai-markdown-translator.svg" alt="GitHub Contributors"></a>
 </div>
 
-[英文](README.md) | [中文](README-zh.md)
+[English](README.md) | [中文](README-zh.md)
 
-`ai-markdown-translator` 是一个命令行工具，用于使用 OpenAI 的语言模型将 Markdown 文件从一种语言翻译成另一种语言。它在翻译内容时保留 Markdown 语法。
+`ai-markdown-translator` 是一个命令行工具，使用 OpenAI 的语言模型将 Markdown 文件从一种语言翻译成另一种语言。它在翻译内容的同时保留 Markdown 语法。
 
 ## 特性
 
-- 将 Markdown 文件翻译为 OpenAI 模型支持的任何语言。
-- 在翻译过程中保持 Markdown 语法。
-- 通过命令行参数或环境变量灵活配置。
+- 将 Markdown 文件翻译为 OpenAI 模型支持的任何语言
+- 在翻译过程中保留 Markdown 语法
+- 支持递归目录翻译
+- 失败翻译的自动重试机制
+- 全面的日志记录系统
+- 目录结构可视化
+- 文件失败跟踪和恢复
 
-## 前提条件
+## 先决条件
 
 - Node.js (v14 或更高)
-- npm (通常随 Node.js 一起安装)
+- npm (通常与 Node.js 一起安装)
 - OpenAI API 密钥
 
 ## 安装
 
-1. 克隆此存储库或下载源代码。
+1. 克隆此库或下载源代码。
 2. 在终端中导航到项目目录。
-3. 安装依赖：
+3. 安装依赖项：
 
 ```bash
 npm install
@@ -47,30 +51,30 @@ npm run build
 ## 脚本
 
 - `build`: 将 TypeScript 文件编译为 JavaScript。
-- `start`: 使用 Node.js 运行已编译的 JavaScript。
+- `start`: 使用 Node.js 运行编译后的 JavaScript。
 - `lint`: 运行 ESLint 检查 TypeScript 文件中的代码质量问题。
 - `lint:fix`: 自动修复 TypeScript 文件中的 lint 问题。
-- `format`: 使用 Prettier 格式化 `src` 目录中的各种文件类型代码。
-- `format:check`: 检查代码格式而不进行更改，适用于 `src` 目录中的各种文件类型。
+- `format`: 使用 Prettier 格式化 `src` 目录中的不同文件类型的代码。
+- `format:check`: 检查代码格式而不进行更改，适用于 `src` 目录中的不同文件类型。
 - `postbuild`: 使编译后的 `index.js` 文件可执行。
-- `changelog`: 生成基于常规提交的变更日志。
-- `version`: 当版本变更时更新变更日志并将其暂存以供提交。
+- `changelog`: 基于常规提交生成变更日志。
+- `version`: 更新变更日志并在版本更新时将其暂存以供提交。
 - `test`: 构建项目并运行测试。
 
 ## 用法
 
-你可以使用 Node.js、`npx` 或作为独立可执行文件（如果你已经打包它）来运行 CLI 工具。
+您可以使用 Node.js、`npx` 或作为独立可执行文件（如果您已打包）来运行 CLI 工具。
 
 ### 使用 Node.js
 
 ```bash
-node dist/index.js --input <输入文件> --output <输出文件> --language <目标语言> [选项]
+node dist/index.js --input <input-file> --output <output-file> --language <target-language> [options]
 ```
 
 ### 使用 npx
 
 ```bash
-npx ai-markdown-translator -i <输入文件> -o <输出文件> -l <目标语言> [选项]
+npx ai-markdown-translator -i <input-file> -o <output-file> -l <target-language> [options]
 ```
 
 例如：
@@ -82,43 +86,55 @@ npx ai-markdown-translator -u https://gitee.com/h7ml/ai-markdown-translator/raw/
 ### 使用独立可执行文件
 
 ```bash
-./ai-markdown-translator --input <输入文件> --output <输出文件> --language <目标语言> [选项]
+./ai-markdown-translator --input <input-file> --output <output-file> --language <target-language> [options]
 ```
 
 ## 选项
 
-- `--input`, `-i`: 输入的 Markdown 文件或目录（替代 `--url`）。此选项允许你指定要翻译的 Markdown 文件或目录的路径。
-- `--url`, `-u`: 要翻译的 Markdown 文件的 URL（替代 `--input`）。使用此选项提供要翻译的 Markdown 文件的直接链接。
+- `--input`, `-i`: 输入的 Markdown 文件或目录（替代 `--url`）。此选项允许您指定要翻译的 Markdown 文件或目录的路径。
+- `--url`, `-u`: 要翻译的 Markdown 文件的 URL（替代 `--input`）。使用此选项提供一个直接链接到您想要翻译的 Markdown 文件。
 
-- `--extension`, `-e`: 指定要翻译的文件扩展名（例如，`md`）。如果未提供，将处理所有文件。此选项允许你根据文件扩展名过滤要翻译的文件。
+- `--extension`, `-e`: 指定要翻译的文件扩展名（例如，`md`）。如果未提供，所有文件将被处理。此选项允许您根据文件的扩展名过滤要翻译的文件。
 
-- `--rename`: 是否修改文件名。如果为真，输出文件将命名为 `<原始文件名>-translated.<扩展名>`。此选项允许你指定是否希望在翻译后的文件名中附加后缀。
+- `--rename`: 是否修改文件名。如果为 true，输出文件将命名为 `<original-filename>-translated.<extension>`。此选项允许您指定是否要在翻译后的文件名中附加后缀。
 
-- `--output`, `-o`: 输出的 Markdown 文件（如果未提供，默认为输入文件名）。此选项允许你指定翻译内容保存输出文件的名称。
+- `--output`, `-o`: 输出的 Markdown 文件（如果未提供，默认为输入文件名）。此选项允许您指定翻译内容将被保存的输出文件的名称。
 
-- `--language`, `-l`: 翻译的目标语言（必填）。此选项指定你希望将 Markdown 内容翻译成的语言。
+- `--language`, `-l`: 翻译的目标语言（必需）。此选项指定您想要将 Markdown 内容翻译成的语言。
 
-- `--openai-url`: OpenAI API URL（默认：使用 `OPENAI_URL` 环境变量）。此选项允许你在需要时指定 OpenAI API 的自定义 URL。
+- `--openai-url`: OpenAI API URL（默认：使用 `OPENAI_URL` 环境变量）。此选项允许您在需要时指定 OpenAI API 的自定义 URL。
 
-- `--api-key`: OpenAI API 密钥（默认：使用 `API_KEY` 环境变量）。此选项用于提供你的 OpenAI API 密钥以进行身份验证。
+- `--api-key`: OpenAI API 密钥（默认：使用 `API_KEY` 环境变量）。此选项用于提供您的 OpenAI API 密钥以进行身份验证。
 
-- `--model`: 使用的 OpenAI 模型（默认：使用 `MODEL` 环境变量或 `gpt-3.5-turbo`）。此选项允许你指定要用于翻译的 OpenAI 模型。
+- `--model`: 使用的 OpenAI 模型（默认：使用 `MODEL` 环境变量或 `gpt-3.5-turbo`）。此选项允许您指定要用于翻译的 OpenAI 模型。
 
 - `--help`, `-h`: 显示帮助。此选项显示命令行工具的帮助信息。
 
 - `--show-version`, `-v`: 显示版本。此选项显示工具的当前版本。
 
-> 注意：`--input` 和 `--url` 是互斥的；你必须提供其中一个。
+- `--log`: 启用日志记录（默认：false）。启用翻译过程的详细日志记录，包括成功和失败信息。
+
+- `--log-file`: 指定日志文件路径（默认：`<project_root>/log/translator-err.log`）。用于记录翻译错误和失败的文件。
+
+- `--log-dir`: 指定日志目录（默认：`<project_root>/log`）。所有日志文件将存储的目录。
+
+- `--retry-count`: 失败翻译的重试尝试次数（默认：3）。翻译器应尝试重试失败翻译的次数。
+
+- `--retry-delay`: 重试尝试之间的延迟（默认：10）。重试尝试之间等待的时间。
+
+- `--path`, `-p`: 显示目录结构（默认：当前脚本目录）。显示指定目录结构的树视图。
+
+> 注意：`--input` 和 `--url` 是互斥的；您必须提供其中之一。
 
 ## 环境变量
 
-你可以设置以下环境变量，而不是作为命令行参数传递它们：
+您可以设置以下环境变量，而不是将它们作为命令行参数传递：
 
 - `OPENAI_URL`: OpenAI API 的 URL。
-- `API_KEY`: 你的 OpenAI API 密钥。
+- `API_KEY`: 您的 OpenAI API 密钥。
 - `MODEL`: 要使用的 OpenAI 模型（例如，`'gpt-3.5-turbo'`）。
 
-你可以在项目根目录的 `.env` 文件中设置这些变量，或者在命令行中导出它们。
+您可以在项目根目录中的 `.env` 文件中设置这些环境变量，或在 shell 中导出它们。
 
 ## 示例
 
@@ -152,39 +168,102 @@ npx ai-markdown-translator -u https://gitee.com/h7ml/ai-markdown-translator/raw/
 npx ai-markdown-translator -i ./markdown-files -l "中文" --rename
 ```
 
-6. **翻译 Markdown 文件并指定输出文件名：**
+6. **翻译 Markdown 文件并指定输出文件名称：**
 
 ```bash
 npx ai-markdown-translator -i example.md -o translated_example.md -l "日语"
 ```
 
+7. **使用日志记录和重试选项进行翻译：**
+
+```bash
+npx ai-markdown-translator -i ./docs -o ./translated -l "中文" --log --retry-count 5 --retry-delay 15
+```
+
+8. **使用自定义日志目录进行翻译：**
+
+```bash
+npx ai-markdown-translator -i input.md -o output.md -l "日语" --log --log-dir "./custom-logs"
+```
+
+9. **使用所有日志记录和重试选项进行翻译：**
+
+```bash
+npx ai-markdown-translator -i ./markdown-files -l "法语" \
+  --log \
+  --log-dir "./logs" \
+  --log-file "./logs/translation.log" \
+  --retry-count 3 \
+  --retry-delay 5
+```
+
+10. **显示目录结构：**
+
+```bash
+npx ai-markdown-translator -p ./src
+```
+
+输出示例：
+
+```
+📂 目录结构: /path/to/src
+.
+├── 📁 components
+│   ├── 📄 Button.tsx
+│   └── 📄 Input.tsx
+├── 📁 utils
+│   ├── 📄 logger.ts
+│   └── 📄 translator.ts
+└── 📄 index.ts
+```
+
+11. **使用自动重试和日志记录进行翻译：**
+
+```bash
+npx ai-markdown-translator -i ./docs -o ./translated -l "中文" \
+  --log \
+  --retry-count 5 \
+  --retry-delay 15 \
+  --log-file "./logs/translation.log"
+```
+
+12. **翻译目录并跟踪失败：**
+
+```bash
+npx ai-markdown-translator -i ./markdown-files -o ./output -l "日语" \
+  --log \
+  --log-dir "./logs" \
+  --retry-count 3 \
+  --retry-delay 10
+```
+
 ## 许可证
 
-[MIT 许可证](LICENSE)
+[MIT License](LICENSE)
 
 ## Git 信息
 
-- **存储库**: [h7ml/ai-markdown-translator](https://github.com/h7ml/ai-markdown-translator)
+- **仓库**: [h7ml/ai-markdown-translator](https://github.com/h7ml/ai-markdown-translator)
 - **问题**: [报告问题](https://github.com/h7ml/ai-markdown-translator/issues)
 
 ## 版本信息
 
-- **当前版本**: 1.0.11
+- **当前版本**: 1.0.12
 - **NPM 包**: [ai-markdown-translator](https://www.npmjs.com/package/ai-markdown-translator)
 
 ## CI 信息
 
-该项目使用 GitHub Actions 进行持续集成。CI 工作流程包括：
+此项目使用 GitHub Actions 进行持续集成。CI 工作流程包含：
 
-- 使用 ESLint 对代码进行检测
-- 运行测试（如果适用）
+- 使用 ESLint 对代码进行 lint
+- 运行测试（如适用）
 - 构建项目
-- 缓存依赖以加快构建速度
+- 缓存依赖项以加快构建速度
 
 ## 贡献
 
 欢迎贡献！请随时提交 Pull Request。
 
 ## 支持
 
-如果你遇到任何问题或有任何疑问，请在此存储库中提出问题。
+如果您遇到任何问题或有任何疑问，请在此仓库中打开一个问题。