scancscode 1.0.56 → 1.0.58

package/.trae/specs/fix-if-else-single-statement-value-extraction/checklist.md

@@ -0,0 +1,7 @@
+# 验证清单
+
+- [ ] 测试用例 "should handle assignment expression within if-else-end" 通过
+- [ ] originalIndex 正确指向值表达式位置 (95)，而不是整个语句
+- [ ] originalCode 只包含值表达式部分，不包含赋值左侧
+- [ ] convertedCode 正确添加 .TR() 后缀
+- [ ] 完整测试套件无回归

package/.trae/specs/fix-if-else-single-statement-value-extraction/spec.md

@@ -0,0 +1,41 @@
+# 修复 if-else 语句无花括号时的值表达式提取 Spec
+
+## 背景
+当 if 或 else 语句没有花括号包围时（如单行 if/else），当前代码提取的是整个赋值语句，而应该只提取赋值右侧的值表达式。
+
+## 测试用例分析
+
+### 输入代码
+```csharp
+if (_eventIdx < _table.MainDescription.Length)
+    m_text_desc.text = _table.MainDescription[_eventIdx];
+else
+    m_text_desc.text = _table.MainDescription[0];
+```
+
+### 期望输出
+- 第一个 snippet:
+  - `originalIndex`: `_table.MainDescription[_eventIdx]` 的位置 (95)
+  - `originalCode`: `_table.MainDescription[_eventIdx]`
+  - `convertedCode`: `_table.MainDescription[_eventIdx].TR()`
+- 第二个 snippet:
+  - `originalIndex`: `_table.MainDescription[0]` 的位置
+  - `originalCode`: `_table.MainDescription[0]`
+  - `convertedCode`: `_table.MainDescription[0].TR()`
+
+## 修改内容
+
+### 问题定位
+在 `CSharpStringExtractor.ts` 中，`extractValueExpression` 或相关方法处理 if-else 语句时：
+- 当前：提取整个赋值语句 `m_text_desc.text = _table.MainDescription[_eventIdx]`
+- 应该：只提取赋值右侧的值表达式 `_table.MainDescription[_eventIdx]`
+
+### 修复策略
+1. 识别 if/else 后没有花括号的单行语句
+2. 跳过赋值左侧部分（`m_text_desc.text = `）
+3. 只提取赋值右侧的表达式
+4. 对提取的表达式应用 `.TR()` 转换
+
+## 影响范围
+- `CSharpStringExtractor.ts` 中的值提取逻辑
+- 特别是在 `extractValueExpression` 或 `processStatementAndExtractValue` 方法中

package/.trae/specs/fix-if-else-single-statement-value-extraction/tasks.md

@@ -0,0 +1,14 @@
+# 任务列表
+
+## 任务 1: 分析代码定位问题
+- [ ] 1.1 分析 CSharpStringExtractor.ts 中处理 if-else 单行语句的代码逻辑
+- [ ] 1.2 定位需要修改的具体方法和代码位置
+
+## 任务 2: 实现修复
+- [ ] 2.1 修改 if-else 单行语句的值表达式提取逻辑
+- [ ] 2.2 确保只提取赋值右侧的表达式
+- [ ] 2.3 确保添加 .TR() 转换
+
+## 任务 3: 验证测试
+- [ ] 3.1 运行目标测试用例验证
+- [ ] 3.2 运行完整测试套件确保无回归

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/CSVUtils.js

@@ -65,14 +65,15 @@ class CSVUtils {
         return content;
     }
     tryGetEntry(content, map01, map02) {
-        if (map02.has(content)) {
-            let row2 = map02.get(content);
-            return [row2 != null, content, row2];
+        let key = content.replaceAll('\r\n', '\n');
+        if (map02.has(key)) {
+            let row2 = map02.get(key);
+            return [row2 != null, key, row2];
         }
-        let shortKey = this.getShortKey(content);
+        let shortKey = this.getShortKey(key);
         if (map01.has(shortKey)) {
             let row1 = map01.get(shortKey);
-            if (row1 != null && (row1[0] == shortKey || row1[1] == content)) {
+            if (row1 != null && (row1[0] == shortKey || row1[1] == key)) {
                 return [true, shortKey, row1];
             }
             else {
@@ -82,6 +83,7 @@ class CSVUtils {
         return [false, shortKey, undefined];
     }
     merge(rows0, rows1, langs) {
+        let indexsxse = rows1.findIndex(x => x.includes("完成每日的显圣任务，获得经验值提升显圣等级"));
         // 短key
         let map01 = new Map();
         // 全文key

package/dist/src/CmdExecutor.js

@@ -21,7 +21,7 @@ class CmdExecutor {
             // "E:/DATA/Projects/ZhiYou/DXTSProject/Client/Assets/Scripts/",
         ];
         let gameConfigFolders = [cwd + "Assets/Bundles/GameConfigs/"];
-        let outCsvFile = "E:/DATA/Projects/e-gbl-client/client/Assets/Bundles/GameConfigs/Translation/hello.csv";
+        let outCsvFile = "test/Auto.csv";
         let langs = ["zh_cn"];
         let literalCollector = new LiteralCollector_1.LiteralCollector();
         // return literalCollector.convert(cscodeFolders, gameConfigFolders, outCsvFile, langs,undefined,false,true)

package/dist/src/CsvAutoTranslator.js

@@ -37,6 +37,7 @@ exports.CsvAutoTranslator = void 0;
 const crypto = __importStar(require("crypto"));
 const https = __importStar(require("https"));
 const CSVUtils_1 = require("./CSVUtils");
+const LanguageMap_1 = require("./LanguageMap");
 class OnlineTranslateResult {
     errorCode = "";
     errorMsg = "";
@@ -223,11 +224,6 @@ class CsvAutoTranslator {
         let result = new OnlineTranslateResult(firstErrorCode, firstErrorMsg, isOk, translatedTexts);
         return result;
     }
-    langMap = new Map([
-        ["zh_cn", "zh"],
-        ["zh_hk", "cht"],
-        ["en_us", "en"],
-    ]);
     async translateCsvRows(rows, fromLang, toLangs) {
         if (rows.length === 0) {
             console.log("CSV文件为空");
@@ -239,11 +235,11 @@ class CsvAutoTranslator {
             console.error(`未找到 ${fromLang} 列`);
             return TranslateCSVResult.Empty;
         }
-        if (!this.langMap.has(fromLang)) {
+        if (!LanguageMap_1.languageMap.has(fromLang)) {
             console.error(`未找到 ${fromLang} 的目标语言`);
             return TranslateCSVResult.Empty;
         }
-        let fromLang2 = this.langMap.get(fromLang);
+        let fromLang2 = LanguageMap_1.languageMap.get(fromLang);
         if (fromLang2 == null) {
             console.error(`未找到 ${fromLang} 的目标语言`);
             return TranslateCSVResult.Empty;
@@ -261,7 +257,7 @@ class CsvAutoTranslator {
             if (toLangs != undefined && !toLangs.includes(lang)) {
                 continue;
             }
-            if (!(lang != fromLang && this.langMap.has(lang))) {
+            if (!(lang != fromLang && LanguageMap_1.languageMap.has(lang))) {
                 continue;
             }
             const needTranslateIndices = [];
@@ -289,7 +285,7 @@ class CsvAutoTranslator {
                 return TranslateCSVResult.Empty;
             }
             console.log(`开始翻译 ${needTranslateTexts.length} 条内容...`);
-            const toLang = this.langMap.get(lang);
+            const toLang = LanguageMap_1.languageMap.get(lang);
             if (toLang == null) {
                 console.error(`未找到 ${lang} 的目标语言`);
                 continue;

package/dist/src/LanguageMap.js

@@ -0,0 +1,113 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.languageMap = void 0;
+exports.languageMap = new Map([
+    // 中文相关
+    ["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"] // 阿萨姆语
+]);