scancscode 1.0.56 → 1.0.57

package/README.md

@@ -0,0 +1,194 @@
+# scancscode
+
+C# 代码字符串提取与国际化处理工具集。
+
+## 功能简介
+
+scancscode 是一个用于处理 C# 代码国际化的命令行工具集，主要功能包括：
+
+- **扫描代码字符串**：从 C# 代码中自动提取需要国际化的字符串字面量, 生成 CSV 文件
+- **CSV 文件处理**：合并、精简 CSV 语言文件
+- **自动翻译**：调用翻译 API 批量翻译 CSV 文件中的内容
+
+## 安装
+
+```bash
+# 克隆项目
+git clone <repository-url>
+cd scancscode
+
+# 安装依赖
+npm install
+
+# 构建项目
+npm run build
+```
+
+## 命令行工具
+
+### 1. scanliterals - 扫描代码字符串
+
+扫描 C# 代码中的字符串字面量，并输出到 CSV 文件。
+
+```bash
+npx scanliterals --cscodedir <目录> --configdir <目录> --outcsv <文件> --langs <语言>
+```
+
+**参数说明**：
+
+| 参数            | 说明              |
+| ------------- | --------------- |
+| `--cscodedir` | C# 代码目录，支持多个目录  |
+| `--configdir` | 配置文件目录，支持多个目录   |
+| `--outcsv`    | 输出 CSV 文件路径     |
+| `--langs`     | 语言列表（默认 zh\_cn） |
+| `--verbose`   | 显示详细日志          |
+
+**示例**：
+
+```bash
+npx scanliterals \
+  --cscodedir ./GameClient/Assets/Bundles/FGUI/ \
+  --configdir ./GameClient/Assets/Bundles/GameConfigs/ \
+  --outcsv ./output/Translation.csv \
+  --langs zh_cn
+```
+
+### 2. slimlangs - 精简 CSV 文件列
+
+将多个 CSV 文件合并，并按指定语言列表精简列。
+
+```bash
+npx slimlangs --incsv <文件> --outcsv <文件> --langs <语言>
+```
+
+**参数说明**：
+
+| 参数         | 说明                 |
+| ---------- | ------------------ |
+| `--incsv`  | 输入 CSV 文件路径，支持多个文件 |
+| `--outcsv` | 输出 CSV 文件路径        |
+| `--langs`  | 要保留的语言列表           |
+
+**示例**：
+
+```bash
+npx slimlangs \
+  --incsv ./Auto.csv ./Manual.csv \
+  --outcsv ./ScriptTrans.csv \
+  --langs zh_cn
+```
+
+### 3. transcsv - 翻译 CSV 文件
+
+使用翻译 API 将 CSV 文件中的内容从源语言翻译到目标语言。
+
+- 暂时仅支持小牛翻译API: <https://niutrans.com/documents/contents/transapi_batch_v2#accessMode>
+
+```bash
+npx transcsv --incsv <文件> --outcsv <文件> --fromLang <语言> --toLangs <语言> --apiKey <密钥> --appId <应用ID>
+```
+
+**参数说明**：
+
+| 参数           | 说明            |
+| ------------ | ------------- |
+| `--incsv`    | 输入 CSV 文件路径   |
+| `--outcsv`   | 输出 CSV 文件路径   |
+| `--fromLang` | 源语言（如 zh\_cn） |
+| `--toLangs`  | 目标语言列表        |
+| `--apiKey`   | 翻译 API 密钥     |
+| `--appId`    | 翻译 API 应用 ID  |
+
+**示例**：
+
+```bash
+npx transcsv \
+  --incsv ./ScriptTrans.csv \
+  --outcsv ./ScriptTrans_translated.csv \
+  --fromLang zh_cn \
+  --toLangs zh_hk en_us \
+  --apiKey your_api_key \
+  --appId your_app_id
+```
+
+## 核心模块
+
+### CSharpStringExtractor
+
+C# 代码字符串提取器，支持多种字符串格式：
+
+- 普通字符串：`"Hello World"`
+- 插值字符串：`$"Hello {name}"`
+- 原生插值字符串：`$@"Hello {name}"`
+- string.Format 调用：`string.Format("Hello {0}", name)`
+- Tr.Format 调用：`Tr.Format("Hello {0}", name)`
+- .text/.title 赋值：`label.text = "Hello"`
+- 三元表达式：`condition ? "Yes" : "No"`
+- 字符串拼接：`"Hello " + name`
+- switch case：`case "value":`
+
+### CsvAutoTranslator
+
+CSV 文件自动翻译器，基于百度翻译 API 实现批量翻译功能。
+
+### CSVUtils
+
+CSV 文件处理工具集，提供 CSV 文件的读取、写入、合并和精简功能。
+
+## 工作流示例
+
+### 完整国际化处理流程
+
+```bash
+# 步骤 1: 扫描代码中的字符串字面量
+npx scanliterals \
+  --cscodedir ./GameClient/Assets/Bundles/FGUI/ \
+  --configdir ./GameClient/Assets/Bundles/GameConfigs/ \
+  --outcsv ./Translation/Auto.csv \
+  --langs zh_cn
+
+# 步骤 2: 合并并精简 CSV（可选）
+npx slimlangs \
+  --incsv ./Translation/Auto.csv ./Translation/Manual.csv \
+  --outcsv ./Translation/ScriptTrans.csv \
+  --langs zh_cn
+
+# 步骤 3: 翻译到目标语言
+npx transcsv \
+  --incsv ./Translation/ScriptTrans.csv \
+  --outcsv ./Translation/ScriptTrans.csv \
+  --fromLang zh_cn \
+  --toLangs zh_hk \
+  --apiKey your_api_key \
+  --appId your_app_id
+```
+
+## 开发
+
+### 运行测试
+
+```bash
+npm test
+```
+
+### 构建项目
+
+```bash
+npm run build
+```
+
+## 语言代码参考
+
+| 语言       | 代码     |
+| -------- | ------ |
+| 简体中文     | zh\_cn |
+| 繁体中文（香港） | zh\_hk |
+| 繁体中文（台湾） | zh\_tw |
+| 英语       | en\_us |
+| 日语       | ja\_jp |
+| 韩语       | ko\_kr |
+
+## 许可证
+
+ISC

package/dist/src/CsvAutoTranslator.js

@@ -224,9 +224,114 @@ class CsvAutoTranslator {
         return result;
     }
     langMap = new Map([
-        ["zh_cn", "zh"],
-        ["zh_hk", "cht"],
-        ["en_us", "en"],
+        // 中文相关
+        ["zh_cn", "zh"], // 简体中文
+        ["zh_hk", "cht"], // 香港繁体中文
+        ["zh_tw", "cht"], // 台湾繁体中文
+        // 英语相关
+        ["en_us", "en"], // 美式英语
+        ["en_gb", "en"], // 英式英语
+        ["en_au", "en"], // 澳大利亚英语
+        ["en_ca", "en"], // 加拿大英语
+        ["en_nz", "en"], // 新西兰英语
+        // 日语
+        ["ja_jp", "ja"], // 日语
+        // 韩语
+        ["ko_kr", "ko"], // 韩语
+        // 法语
+        ["fr_fr", "fr"], // 法语
+        ["fr_ca", "fr"], // 加拿大法语
+        // 德语
+        ["de_de", "de"], // 德语
+        // 西班牙语
+        ["es_es", "es"], // 西班牙语
+        ["es_mx", "es"], // 墨西哥西班牙语
+        // 俄语
+        ["ru_ru", "ru"], // 俄语
+        // 葡萄牙语
+        ["pt_pt", "pt"], // 葡萄牙语
+        ["pt_br", "pt"], // 巴西葡萄牙语
+        // 意大利语
+        ["it_it", "it"], // 意大利语
+        // 阿拉伯语
+        ["ar_sa", "ar"], // 阿拉伯语
+        // 荷兰语
+        ["nl_nl", "nl"], // 荷兰语
+        // 瑞典语
+        ["sv_se", "sv"], // 瑞典语
+        // 丹麦语
+        ["da_dk", "da"], // 丹麦语
+        // 挪威语
+        ["no_no", "no"], // 挪威语
+        ["nb_no", "no"], // 挪威语（博克马尔语）
+        // 芬兰语
+        ["fi_fi", "fi"], // 芬兰语
+        // 波兰语
+        ["pl_pl", "pl"], // 波兰语
+        // 匈牙利语
+        ["hu_hu", "hu"], // 匈牙利语
+        // 捷克语
+        ["cs_cz", "cs"], // 捷克语
+        // 斯洛伐克语
+        ["sk_sk", "sk"], // 斯洛伐克语
+        // 罗马尼亚语
+        ["ro_ro", "ro"], // 罗马尼亚语
+        // 希腊语
+        ["el_gr", "el"], // 希腊语
+        // 土耳其语
+        ["tr_tr", "tr"], // 土耳其语
+        // 希伯来语
+        ["he_il", "he"], // 希伯来语
+        // 印地语
+        ["hi_in", "hi"], // 印地语
+        // 泰语
+        ["th_th", "th"], // 泰语
+        // 越南语
+        ["vi_vn", "vi"], // 越南语
+        // 印尼语
+        ["id_id", "id"], // 印尼语
+        // 马来语
+        ["ms_my", "ms"], // 马来语
+        // 菲律宾语
+        ["tl_ph", "tl"], // 菲律宾语
+        // 乌克兰语
+        ["uk_ua", "uk"], // 乌克兰语
+        // 保加利亚语
+        ["bg_bg", "bg"], // 保加利亚语
+        // 克罗地亚语
+        ["hr_hr", "hr"], // 克罗地亚语
+        // 塞尔维亚语
+        ["sr_rs", "sr"], // 塞尔维亚语
+        // 斯洛文尼亚语
+        ["sl_si", "sl"], // 斯洛文尼亚语
+        // 爱沙尼亚语
+        ["et_ee", "et"], // 爱沙尼亚语
+        // 拉脱维亚语
+        ["lv_lv", "lv"], // 拉脱维亚语
+        // 立陶宛语
+        ["lt_lt", "lt"], // 立陶宛语
+        // 波斯语
+        ["fa_ir", "fa"], // 波斯语
+        // 乌尔都语
+        ["ur_pk", "ur"], // 乌尔都语
+        // 孟加拉语
+        ["bn_in", "bn"], // 孟加拉语
+        // 泰米尔语
+        ["ta_in", "ta"], // 泰米尔语
+        // 泰卢固语
+        ["te_in", "te"], // 泰卢固语
+        // 卡纳达语
+        ["kn_in", "kn"], // 卡纳达语
+        // 马拉雅拉姆语
+        ["ml_in", "ml"], // 马拉雅拉姆语
+        // 古吉拉特语
+        ["gu_in", "gu"], // 古吉拉特语
+        // 马拉地语
+        ["mr_in", "mr"], // 马拉地语
+        // 奥里亚语
+        ["or_in", "or"], // 奥里亚语
+        // 阿萨姆语
+        ["as_in", "as"] // 阿萨姆语
     ]);
     async translateCsvRows(rows, fromLang, toLangs) {
         if (rows.length === 0) {