scancscode 1.0.30 → 1.0.33

package/.trae/specs/handle-return-statement/tasks.md

@@ -0,0 +1,44 @@
+# 处理 C# Return 语句 - The Implementation Plan (Decomposed and Prioritized Task List)
+
+## [x] Task 1: 修改 isStatementToProcess 函数支持 return 语句
+- **Priority**: P0
+- **Depends On**: None
+- **Description**: 
+  - 修改 `isStatementToProcess` 函数，允许处理以 "return " 开头的语句
+  - 当前 blockKeywords 数组中不包含 "return"，但需要特别处理
+  - 实现方式：检查 trimmedStatement 是否以 "return " 开头，如果是，并且包含字符串字面量，则返回 true
+- **Acceptance Criteria Addressed**: AC-1
+- **Test Requirements**:
+  - `programmatic` TR-1.1: `isStatementToProcess('return "参数错误";')` 应返回 true
+  - `programmatic` TR-1.2: `isStatementToProcess('return 123;')` 不应返回 true（无字符串字面量）
+  - `programmatic` TR-1.3: 现有其他语句类型的处理不应受影响
+- **Notes**: 确保不会影响 case/default 等现有特殊语句的处理
+
+## [x] Task 2: 修改 extractValueExpression 函数提取 return 语句的字符串
+- **Priority**: P0
+- **Depends On**: Task 1
+- **Description**: 
+  - 在 `extractValueExpression` 函数中添加对 return 语句的处理逻辑
+  - 在 text assignment、assignment、stringFormat 等检查之前，先检查是否以 "return " 开头
+  - 如果是 return 语句，提取 "return " 之后的部分作为 valuePart，然后使用 extractValueUntilSemicolon 提取值
+  - 确保返回的 valueExpression 不包含 "return" 关键字
+  - 正确计算 valueExpressionIndex，指向字符串的起始位置
+- **Acceptance Criteria Addressed**: AC-2
+- **Test Requirements**:
+  - `programmatic` TR-2.1: `extractValueExpression('return "参数错误";', 0, 'return "参数错误";')` 的 valueExpression 应为 `"参数错误"`
+  - `programmatic` TR-2.2: valueExpressionIndex 应正确指向字符串的起始位置
+  - `programmatic` TR-2.3: 其他语句类型（assignment、text assignment、stringFormat）的处理不应受影响
+- **Notes**: 参考现有 text assignment 和 assignment 的处理模式
+
+## [x] Task 3: 运行完整测试套件验证修复
+- **Priority**: P0
+- **Depends On**: Task 2
+- **Description**: 
+  - 运行 "should handle return statement" 测试，确保它通过
+  - 运行所有现有测试用例，确保没有回归
+  - 如有问题，修复代码直到所有测试通过
+- **Acceptance Criteria Addressed**: AC-3, AC-4
+- **Test Requirements**:
+  - `programmatic` TR-3.1: "should handle return statement" 测试通过
+  - `programmatic` TR-3.2: 所有现有测试用例都通过
+- **Notes**: 先单独运行目标测试，再运行完整测试套件

package/.trae/specs/handle-special-string-characters/checklist.md

@@ -0,0 +1,13 @@
+# C#字符串特殊字符处理 - Verification Checklist
+
+- [ ] Checkpoint 1: 分析问题并定位到具体代码位置
+- [ ] Checkpoint 2: 修改后的代码能够正确识别包含特殊字符的字符串边界
+- [ ] Checkpoint 3: 字符串内部的`_+|:"<>?`等特殊字符不会被错误处理
+- [ ] Checkpoint 4: 测试用例`snippets[0]`（对象初始化器字符串）正确处理
+- [ ] Checkpoint 5: 测试用例`snippets[1]`（变量赋值字符串）正确处理
+- [ ] Checkpoint 6: 测试用例`snippets[2]`（插值字符串）正确处理
+- [ ] Checkpoint 7: 测试用例`snippets[3]`（函数调用参数字符串）正确处理
+- [ ] Checkpoint 8: 测试用例`snippets[4]`（返回语句字符串）正确处理
+- [ ] Checkpoint 9: 测试用例`snippets[5]`和`snippets[6]`（成员变量字符串）正确处理
+- [ ] Checkpoint 10: 完整测试用例`should handle special characters in string expression 2`通过
+- [ ] Checkpoint 11: 所有其他未被注释的测试都通过

package/.trae/specs/handle-special-string-characters/spec.md

@@ -0,0 +1,94 @@
+# C#字符串特殊字符处理 - Product Requirement Document
+
+## Overview
+- **Summary**: 修复CSharpStringExtractor处理C#字符串中包含特殊字符时的边界识别和捕获问题
+- **Purpose**: 解决工具在处理包含特殊字符（如`_+|:"<>?`）的C#字符串时错误地添加`.TR()`调用的问题，确保字符串边界识别的准确性
+- **Target Users**: 使用UnityI18N工具扫描和转换C#代码的开发人员
+
+## Goals
+- 修复C#字符串中特殊字符导致错误添加`.TR()`的bug
+- 确保所有类型的C#字符串（普通字符串、插值字符串等）中的特殊字符都能被正确处理
+- 通过现有的测试用例 `should handle special characters in string expression 2`
+
+## Non-Goals (Out of Scope)
+- 不修改其他不相关的测试用例
+- 不改变工具的整体架构
+- 不添加新的转换功能
+
+## Background & Context
+- 当前工具在处理包含特殊字符（特别是`_+`模式）的C#字符串时，会错误地在字符串内部添加`.TR()`调用
+- 测试用例中展示了在多种C#语句（对象初始化器、变量赋值、函数调用、返回语句、成员变量等）中的字符串都需要正确处理
+- 问题可能出在字符串边界识别逻辑上，特殊字符被错误地识别为字符串结束或其他语法结构
+
+## Functional Requirements
+- **FR-1**: 正确识别包含所有特殊字符的C#字符串边界
+- **FR-2**: 普通字符串（双引号包裹）中的所有特殊字符都能被正确保留
+- **FR-3**: 插值字符串（`$"`）中的所有特殊字符都能被正确处理
+- **FR-4**: 不应该在字符串内部错误地添加`.TR()`调用
+
+## Non-Functional Requirements
+- **NFR-1**: 所有现有测试用例继续通过（除被注释掉的）
+- **NFR-2**: 保持工具的性能，不显著增加处理时间
+
+## Constraints
+- **Technical**: 必须使用TypeScript，保持与现有代码库风格一致
+- **Dependencies**: 仅修改`CSharpStringExtractor.ts`文件
+- **Business**: 必须在不破坏现有功能的情况下修复问题
+
+## Assumptions
+- 测试用例中的期望输出是正确的行为
+- 问题仅出在字符串边界识别和处理逻辑中
+- 不需要修改测试用例本身
+
+## Acceptance Criteria
+
+### AC-1: 正确处理普通字符串中的特殊字符
+- **Given**: C#代码中包含带有各种特殊字符的普通字符串（如`_+|:"<>?`）
+- **When**: CSharpStringExtractor处理该代码
+- **Then**: 字符串被完整识别，不添加多余的`.TR()`调用
+- **Verification**: `programmatic`
+- **Notes**: 通过测试用例验证
+
+### AC-2: 正确处理对象初始化器中的字符串
+- **Given**: C#对象初始化器中的属性赋值包含特殊字符的字符串
+- **When**: CSharpStringExtractor处理该代码
+- **Then**: 字符串被正确提取和处理
+- **Verification**: `programmatic`
+- **Notes**: 测试用例中的第1个和第6、7个snippet
+
+### AC-3: 正确处理变量赋值中的字符串
+- **Given**: C#变量赋值语句包含特殊字符的字符串
+- **When**: CSharpStringExtractor处理该代码
+- **Then**: 字符串被正确处理
+- **Verification**: `programmatic`
+- **Notes**: 测试用例中的第2个snippet
+
+### AC-4: 正确处理插值字符串
+- **Given**: C#插值字符串（`$"`）包含变量和特殊字符
+- **When**: CSharpStringExtractor处理该代码
+- **Then**: 插值字符串被正确转换为Tr.Format
+- **Verification**: `programmatic`
+- **Notes**: 测试用例中的第3个snippet
+
+### AC-5: 正确处理函数调用中的字符串
+- **Given**: C#函数调用参数包含特殊字符的字符串
+- **When**: CSharpStringExtractor处理该代码
+- **Then**: 字符串被正确处理
+- **Verification**: `programmatic`
+- **Notes**: 测试用例中的第4个snippet
+
+### AC-6: 正确处理返回语句中的字符串
+- **Given**: C#返回语句包含特殊字符的字符串
+- **When**: CSharpStringExtractor处理该代码
+- **Then**: 字符串被正确处理
+- **Verification**: `programmatic`
+- **Notes**: 测试用例中的第5个snippet
+
+### AC-7: 测试通过
+- **Given**: 运行指定的测试用例
+- **When**: 执行 `npx jest test/CSharpStringExtractor.test.ts -t "should handle special characters in string expression 2"`
+- **Then**: 测试完全通过
+- **Verification**: `programmatic`
+
+## Open Questions
+- 无

package/.trae/specs/handle-special-string-characters/tasks.md

@@ -0,0 +1,74 @@
+# C#字符串特殊字符处理 - The Implementation Plan (Decomposed and Prioritized Task List)
+
+## \[ ] Task 1: 分析问题并定位bug
+
+* **Priority**: P0
+
+* **Depends On**: None
+
+* **Description**:
+
+  * 分析当前测试失败的原因，确认问题出现在哪个函数
+
+  * 查看`processStringConcatenation`和相关函数的实现，找出为什么`_+`被错误处理
+
+  * 确定需要修复的具体代码位置
+
+* **Acceptance Criteria Addressed**: \[AC-1, AC-2, AC-3, AC-4, AC-5, AC-6]
+
+* **Test Requirements**:
+
+  * `programmatic` TR-1.1: 确认测试失败的具体原因和位置
+
+* **Notes**: 通过调试和代码审查确定问题根源
+
+## \[ ] Task 2: 修复字符串处理逻辑中的bug
+
+* **Priority**: P0
+
+* **Depends On**: \[Task 1]
+
+* **Description**:
+
+  * 修改`processStringConcatenation`或相关函数，确保在处理字符串时不会错误地在字符串内部添加`.TR()`
+
+  * 确保所有特殊字符都能被正确处理，特别是`_+|:"<>?`等组合
+
+  * 修改涉及字符串边界识别和`.TR()`添加逻辑的函数
+
+* **Acceptance Criteria Addressed**: \[AC-1, AC-2, AC-3, AC-4, AC-5, AC-6]
+
+* **Test Requirements**:
+
+  * `programmatic` TR-2.1: 修复后的代码能够正确识别字符串边界
+
+  * `programmatic` TR-2.2: 字符串内部的特殊字符不会被错误处理
+
+* **Notes**: 只修改`CSharpStringExtractor.ts`，保持现有代码结构
+
+## \[ ] Task 3: 运行测试并验证修复
+
+* **Priority**: P0
+
+* **Depends On**: \[Task 2]
+
+* **Description**:
+
+  * 编译TypeScript代码
+
+  * 运行指定的测试用例`should handle special characters in string expression 2`
+
+  * 确保测试完全通过
+
+  * 运行所有其他测试，确保没有破坏现有功能
+
+* **Acceptance Criteria Addressed**: \[AC-7]
+
+* **Test Requirements**:
+
+  * `programmatic` TR-3.1: 测试`should handle special characters in string expression 2`通过
+
+  * `programmatic` TR-3.2: 所有未被注释的测试都通过
+
+* **Notes**: 如果有其他测试失败，需要分析是否与此次修改相关
+

package/.trae/specs/unify-return-statement-string-extraction/checklist.md

@@ -0,0 +1,10 @@
+
+# 统一匹配 return 语句中的字符串表达式 - Verification Checklist
+
+- [x] `should handle special characters in string expression of return sentence` 测试用例成功通过
+- [x] 所有 75+ 个现有测试用例继续通过，无回归问题 (实际 78 个测试全部通过)
+- [x] 代码严格符合 TypeScript 语言语法，不使用保留关键字作为变量名
+- [x] return 语句能够被正确识别和处理
+- [x] 包含特殊字符的字符串在 return 语句中能够被正确提取
+- [x] 临时调试文件已清理，代码仓库保持整洁
+

package/.trae/specs/unify-return-statement-string-extraction/spec.md

@@ -0,0 +1,70 @@
+
+# 统一匹配 return 语句中的字符串表达式 - Product Requirement Document
+
+## Overview
+- **Summary**: 修复 CSharpStringExtractor 工具中 return 语句字符串表达式的提取逻辑，确保正确识别和处理包含特殊字符的字符串边界
+- **Purpose**: 解决现有工具在提取 return 语句中包含特殊字符的字符串时出现的错误，确保工具能够统一、正确地匹配和处理 return 语句中的字符串表达式
+- **Target Users**: 使用 CSharpStringExtractor 工具来扫描和提取 C# 代码中字符串字面量的开发者
+
+## Goals
+- 修复 `should handle special characters in string expression of return sentence` 测试用例的失败问题
+- 确保工具能够正确识别 return 语句中的字符串边界
+- 确保工具能够正确处理包含特殊字符的字符串，包括但不限于：`{}`、`[]`、`;`、`"`、`'`、`\`、`<`、`>` 等
+- 保持所有现有测试用例的通过状态
+
+## Non-Goals (Out of Scope)
+- 修改被注释掉的测试用例
+- 改变工具的整体架构或 API 接口
+- 添加超出字符串边界识别之外的新功能
+
+## Background & Context
+- 当前 CSharpStringExtractor 工具已经支持大部分 C# 语句类型的字符串提取
+- 测试用例 `should handle special characters in string expression of return sentence` 目前失败，问题在于 return 语句中的特殊字符字符串无法被正确处理
+- 工具需要能够正确处理插值字符串（$""、$@""、@$""）、普通字符串和包含各种特殊字符的字符串
+
+## Functional Requirements
+- **FR-1**: 工具必须能够正确提取 return 语句中的字符串表达式
+- **FR-2**: 工具必须能够正确识别包含特殊字符的字符串边界
+- **FR-3**: 工具必须确保字符串内部的特殊字符不被错误地识别为语句边界
+- **FR-4**: 工具必须能够处理普通字符串、插值字符串（$""、$@""、@$""）和包含转义字符的字符串
+
+## Non-Functional Requirements
+- **NFR-1**: 所有 75+ 个现有测试用例必须继续通过
+- **NFR-2**: 修复不能降低工具的性能，扫描速度保持在可接受范围
+- **NFR-3**: 代码必须遵循 TypeScript 语言规范，不使用保留关键字作为变量名
+
+## Constraints
+- **Technical**: 必须使用 TypeScript 编写，保持现有代码风格和架构
+- **Business**: 必须在保持所有现有功能正常工作的前提下修复该问题
+- **Dependencies**: 不添加任何新的依赖库
+
+## Assumptions
+- 当前被注释掉的测试用例不需要考虑
+- 工具的其他功能保持不变
+- 用户期望修复的是 return 语句中的特殊字符字符串处理问题
+
+## Acceptance Criteria
+
+### AC-1: Return 语句特殊字符字符串测试通过
+- **Given**: 包含特殊字符的 return 语句测试用例
+- **When**: 运行 `should handle special characters in string expression of return sentence` 测试
+- **Then**: 该测试用例应该成功通过，不出现任何错误
+- **Verification**: `programmatic`
+- **Notes**: 确保 return 语句中的特殊字符字符串被正确提取
+
+### AC-2: 所有现有测试继续通过
+- **Given**: 完整的测试套件
+- **When**: 运行所有测试用例
+- **Then**: 所有 75+ 个现有测试用例应该继续通过
+- **Verification**: `programmatic`
+- **Notes**: 保持向后兼容性
+
+### AC-3: 代码符合 TypeScript 规范
+- **Given**: 源代码文件
+- **When**: 检查 TypeScript 语法和编码规范
+- **Then**: 代码必须严格符合 TypeScript 语言语法，不使用保留关键字作为变量名
+- **Verification**: `programmatic`
+
+## Open Questions
+- 无
+

package/.trae/specs/unify-return-statement-string-extraction/tasks.md

@@ -0,0 +1,54 @@
+
+# 统一匹配 return 语句中的字符串表达式 - The Implementation Plan (Decomposed and Prioritized Task List)
+
+## [x] 任务 1: 分析当前代码和失败测试的问题
+- **Priority**: P0
+- **Depends On**: None
+- **Description**: 
+  - 查看当前失败的测试用例，分析 return 语句中的字符串为什么没有被正确提取
+  - 检查 `processStatementAndExtractValue` 和 `extractValueExpression` 方法中 return 语句的处理逻辑
+  - 查看 `extractValueUntilSemicolon` 等相关辅助方法的实现
+- **Acceptance Criteria Addressed**: [AC-1]
+- **Test Requirements**:
+  - `programmatic` TR-1.1: 定位 return 语句字符串提取错误的具体位置 ✓
+  - `human-judgement` TR-1.2: 理解当前逻辑中的问题所在 ✓
+- **Notes**: 重点关注 return 语句中的特殊字符字符串处理
+
+## [x] 任务 2: 修复 return 语句中的字符串提取逻辑
+- **Priority**: P0
+- **Depends On**: 任务 1
+- **Description**: 
+  - 修复 `processStatementAndExtractValue` 方法中处理 return 语句的逻辑
+  - 确保 return 语句能够正确地被识别和处理
+  - 确保 return 语句中的字符串边界能够正确识别
+- **Acceptance Criteria Addressed**: [AC-1, AC-3]
+- **Test Requirements**:
+  - `programmatic` TR-2.1: 修复后 `should handle special characters in string expression of return sentence` 测试用例必须通过 ✓
+  - `programmatic` TR-2.2: 代码符合 TypeScript 语法规范，不使用保留关键字作为变量名 ✓
+- **Notes**: 确保修改不会影响其他语句类型的处理
+- **Modifications**: 在 `src/CSharpStringExtractor.ts:1736-1765` 中添加了检查逻辑：当 fullStatement === processedFullStatement 时，直接使用原始的 valueExpression，而不是重新提取
+
+## [x] 任务 3: 运行所有测试确保没有回归
+- **Priority**: P0
+- **Depends On**: 任务 2
+- **Description**: 
+  - 运行完整的测试套件，确保所有测试用例都能通过
+  - 检查是否有任何测试出现回归
+- **Acceptance Criteria Addressed**: [AC-2]
+- **Test Requirements**:
+  - `programmatic` TR-3.1: 运行 `npm test` 命令，所有 75+ 个测试用例必须通过 ✓ (78 个测试全部通过)
+  - `programmatic` TR-3.2: 检查 TypeScript 编译没有错误 ✓ (核心源代码无错误)
+- **Notes**: 确保修复不会破坏任何现有功能
+
+## [x] 任务 4: 清理临时调试文件
+- **Priority**: P2
+- **Depends On**: 任务 3
+- **Description**: 
+  - 删除所有临时创建的调试文件
+  - 确保代码仓库的整洁
+- **Acceptance Criteria Addressed**: []
+- **Test Requirements**:
+  - `human-judgement` TR-4.1: 代码仓库中不再有临时的调试文件 ✓
+- **Notes**: 保持 git 仓库的整洁
+- **Deleted Files**: 所有根目录下的 debug-*.ts 文件和临时文本文件
+

package/bin/scanliterals.js

@@ -1,3 +1,3 @@
-#!/usr/bin/env node
-
-require("../dist/RunConvert.js")
+#!/usr/bin/env node
+
+require("../dist/src/RunConvert.js")

package/bin/slimlangs.js

@@ -1,3 +1,3 @@
-#!/usr/bin/env node
-
-require("../dist/RunSlimLangs.js")
+#!/usr/bin/env node
+
+require("../dist/src/RunSlimLangs.js")