scancscode 1.0.31 → 1.0.34

package/.trae/specs/handle-interpolated-string-double-braces/spec.md

@@ -0,0 +1,61 @@
+
+# 处理内插字符串中的双花括号 - Product Requirement Document
+
+## Overview
+- **Summary**: 修复 CSharpStringExtractor 工具中内插字符串（$""）处理双花括号 `{{` 和 `}}` 的逻辑，确保这些转义字符被正确地保持原样，而不是被错误地识别为多个独立的内插表达式
+- **Purpose**: 解决内插字符串中包含 `{{` 和 `}}` 时，它们被错误地识别为多个独立内插表达式的问题，确保正确的转义处理
+- **Target Users**: 使用 CSharpStringExtractor 工具来扫描和提取 C# 代码中字符串字面量的开发者
+
+## Goals
+- 修复 `should handle special characters in string expression 4` 测试用例的失败问题
+- 确保内插字符串中的 `{{` 和 `}}` 被正确识别为转义字符，保持原样转换到 Tr.Format 中
+- 确保单个 `{xxx}` 被正确识别为内插表达式并替换为 `{0}`, `{1}` 等
+- 保持所有现有测试用例的通过状态
+
+## Non-Goals (Out of Scope)
+- 改变工具的整体架构或 API 接口
+- 添加超出内插字符串处理之外的新功能
+
+## Background & Context
+- 目前 `processStringTemplates` 方法处理内插字符串时，没有正确处理 `{{` 和 `}}` 的转义情况
+- 在内插字符串中，`{{` 表示单个 `{`，`}}` 表示单个 `}`，不应该被当作内插表达式处理
+- 测试用例 `should handle special characters in string expression 4` 测试这个功能，但目前失败了
+
+## Functional Requirements
+- **FR-1**: 工具必须正确处理内插字符串中的 `{{` 转义序列，保持原样
+- **FR-2**: 工具必须正确处理内插字符串中的 `}}` 转义序列，保持原样
+- **FR-3**: 工具必须正确区分转义的 `{{`/`}}` 和单个 `{`/`}` 组成的内插表达式
+- **FR-4**: 工具必须正确处理同时包含转义双花括号和普通内插表达式的情况
+
+## Non-Functional Requirements
+- **NFR-1**: 所有 79 个现有测试用例必须继续通过
+- **NFR-2**: 修复不能降低工具的性能
+- **NFR-3**: 代码必须遵循 TypeScript 语言规范
+
+## Constraints
+- **Technical**: 必须使用 TypeScript 编写，保持现有代码风格和架构
+- **Dependencies**: 不添加任何新的依赖库
+
+## Assumptions
+- C# 内插字符串语法规则：`{{` → `{`, `}}` → `}`, `{expr}` → 内插表达式
+- 用户期望的行为符合 C# 语言规范
+
+## Acceptance Criteria
+
+### AC-1: 内插字符串双花括号测试通过
+- **Given**: 包含 `{{` 和 `}}` 的内插字符串测试用例
+- **When**: 运行 `should handle special characters in string expression 4` 测试
+- **Then**: 该测试用例应该成功通过，不出现任何错误
+- **Verification**: `programmatic`
+- **Notes**: 确保 `{{` 和 `}}` 在转换后的字符串中保持原样
+
+### AC-2: 所有现有测试继续通过
+- **Given**: 完整的测试套件
+- **When**: 运行所有测试用例
+- **Then**: 所有 79 个现有测试用例应该继续通过
+- **Verification**: `programmatic`
+- **Notes**: 保持向后兼容性
+
+## Open Questions
+- 无
+

package/.trae/specs/handle-interpolated-string-double-braces/tasks.md

@@ -0,0 +1,41 @@
+
+# 处理内插字符串中的双花括号 - The Implementation Plan (Decomposed and Prioritized Task List)
+
+## [x] 任务 1: 分析当前 processStringTemplates 方法的问题
+- **Priority**: P0
+- **Depends On**: None
+- **Description**: 
+  - 查看 `processStringTemplates` 方法的实现，分析为什么 `{{` 和 `}}` 被错误处理
+  - 了解当前正则表达式 `/\{([^}]*?)\}/g` 如何匹配内插表达式
+  - 理解为什么 `{{` 被当作两个独立的 `{` 处理
+- **Acceptance Criteria Addressed**: [AC-1]
+- **Test Requirements**:
+  - `programmatic` TR-1.1: 定位双花括号被错误处理的具体代码位置 ✓
+  - `human-judgement` TR-1.2: 理解当前逻辑中的问题所在 ✓
+- **Notes**: 重点关注内插字符串模板匹配的正则表达式或手动解析逻辑
+
+## [x] 任务 2: 修复 processStringTemplates 方法以正确处理双花括号
+- **Priority**: P0
+- **Depends On**: 任务 1
+- **Description**: 
+  - 重写或修改 `processStringTemplates` 方法中的内插表达式匹配逻辑
+  - 确保首先检查 `{{` 和 `}}` 转义序列并保持原样
+  - 然后再处理单个 `{expr}` 内插表达式
+- **Acceptance Criteria Addressed**: [AC-1, AC-2]
+- **Test Requirements**:
+  - `programmatic` TR-2.1: 修复后 `should handle special characters in string expression 4` 测试用例必须通过 ✓
+  - `programmatic` TR-2.2: 所有其他测试用例继续通过，无回归 ✓
+- **Notes**: 确保修改不会影响普通内插表达式的处理
+- **Modifications**: 重写了 `processStringTemplates` 方法（src/CSharpStringExtractor.ts:972-1055），采用手动解析方式，优先处理 {{ 和 }} 转义序列
+
+## [x] 任务 3: 运行所有测试确保没有回归
+- **Priority**: P0
+- **Depends On**: 任务 2
+- **Description**: 
+  - 运行完整的测试套件，确保所有测试用例都能通过
+  - 检查是否有任何测试出现回归
+- **Acceptance Criteria Addressed**: [AC-2]
+- **Test Requirements**:
+  - `programmatic` TR-3.1: 运行 `npm test` 命令，所有 79 个测试用例必须通过 ✓
+- **Notes**: 确保修复不会破坏任何现有功能
+

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

@@ -0,0 +1,11 @@
+# 处理 C# Return 语句 - Verification Checklist
+
+- [x] isStatementToProcess 能正确识别包含字符串的 return 语句
+- [x] isStatementToProcess 不会错误地识别不包含字符串的 return 语句
+- [x] extractValueExpression 能正确从 return 语句中提取字符串表达式
+- [x] 提取的字符串表达式不包含 "return" 关键字
+- [x] valueExpressionIndex 正确指向字符串的起始位置
+- [x] "should handle return statement" 测试通过
+- [x] 所有现有测试用例都通过
+- [x] 代码风格与项目保持一致
+- [x] 没有引入新的语法错误或类型错误

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

@@ -0,0 +1,76 @@
+# 处理 C# Return 语句 - Product Requirement Document
+
+## Overview
+- **Summary**: 修复 CSharpStringExtractor 无法处理 C# `return` 语句中字符串字面量的问题，确保 return 语句中的字符串表达式能够被正确提取
+- **Purpose**: 解决 `return "参数错误";` 等语句中字符串字面量无法被提取和处理的问题
+- **Target Users**: 使用 CSharpStringExtractor 进行 C# 代码字符串字面量提取和国际化处理的开发者
+
+## Goals
+- 修改 `isStatementToProcess` 函数，允许处理以 "return " 开头的语句
+- 修改 `extractValueExpression` 函数，正确提取 return 语句中的字符串值表达式
+- 确保提取的字符串表达式不包含 "return" 关键字本身
+- 保持现有功能不被破坏
+
+## Non-Goals (Out of Scope)
+- 不修改其他语句类型的处理逻辑
+- 不添加额外的新功能，只修复 return 语句的处理问题
+- 不重构整个代码库
+
+## Background & Context
+- CSharpStringExtractor 是一个用于提取 C# 代码中字符串字面量的工具
+- 当前版本在处理 `return "参数错误";` 语句时无法正确提取字符串
+- 测试用例 `should handle return statement` 专门测试这个功能
+- 需要保持与项目现有架构和编码规范一致
+
+## Functional Requirements
+- **FR-1**: `isStatementToProcess` 函数应能识别并允许处理以 "return " 开头的语句
+- **FR-2**: `extractValueExpression` 函数应能从 return 语句中正确提取字符串值表达式
+- **FR-3**: 提取的字符串表达式不应包含 "return" 关键字
+- **FR-4**: return 语句的处理应与其他语句类型保持一致的行为
+
+## Non-Functional Requirements
+- **NFR-1**: 代码修改应保持可维护性和性能
+- **NFR-2**: 修改不应影响现有功能
+- **NFR-3**: 代码应与项目现有编码风格保持一致
+
+## Constraints
+- **Technical**: 使用 TypeScript，遵循现有代码架构
+- **Business**: 需要通过现有所有测试用例，特别是 "should handle return statement" 测试
+- **Dependencies**: 依赖现有的 CSharpStringExtractor.ts 代码结构
+
+## Assumptions
+- return 语句的结构是 "return " + 字符串表达式 + ";"
+- return 语句中的字符串表达式不包含复杂的条件表达式（测试用例只覆盖简单情况）
+- 现有代码结构是稳定的，可以在其基础上进行修改
+
+## Acceptance Criteria
+
+### AC-1: isStatementToProcess 能识别 return 语句
+- **Given**: 一个包含 "return " 开头的语句字符串
+- **When**: 调用 `isStatementToProcess` 函数检查该语句
+- **Then**: 函数应返回 true，表明该语句需要处理
+- **Verification**: `programmatic`
+- **Notes**: 确保只识别 "return " 开头的语句，避免误识别其他以 "return" 开头的标识符
+
+### AC-2: extractValueExpression 能正确提取 return 语句的字符串
+- **Given**: 一个完整的 return 语句，如 `return "参数错误";`
+- **When**: 调用 `extractValueExpression` 函数处理该语句
+- **Then**: 函数应返回字符串表达式 `"参数错误"`，不包含 "return" 关键字
+- **Verification**: `programmatic`
+- **Notes**: 同时确保 valueExpressionIndex 指向字符串的起始位置
+
+### AC-3: 完整的 return 语句处理流程正确
+- **Given**: 代码字符串 `return "参数错误";`
+- **When**: 调用 `extractStrings` 函数处理该代码
+- **Then**: 返回的 snippets 数组应包含一个 snippet，其 originalCode 为 `"参数错误"`，originalIndex 为字符串在原代码中的起始位置
+- **Verification**: `programmatic`
+- **Notes**: 这就是测试用例 "should handle return statement" 的要求
+
+### AC-4: 现有功能不受影响
+- **Given**: 修改后的代码库
+- **When**: 运行所有现有测试用例
+- **Then**: 所有测试用例都应通过
+- **Verification**: `programmatic`
+
+## Open Questions
+- 是否需要处理更复杂的 return 语句，如 `return condition ? "a" : "b";`？（测试用例未覆盖此场景）

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/src/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/src/RunSlimLangs.js")
+#!/usr/bin/env node
+
+require("../dist/src/RunSlimLangs.js")

package/dist/debug-arg.js

@@ -0,0 +1,30 @@
+"use strict";
+const { CSharpStringExtractor } = require('./dist/CSharpStringExtractor');
+const extractor = new CSharpStringExtractor();
+const code = `
+        private void OnBtnIaa(EventContext context)
+        {
+            var iaaConfig = IAAConfigTable.GetConfigById((int)IAAId.境界失败_加速冷却);
+            if (iaaConfig == null)
+            {
+                return;
+            }
+
+            string des = $"观看视频后\\n等待时间减少{iaaConfig.EffectValue / 60}分钟";
+            this.GetModel<IAAModel>().ShowAdWithDialog(IAAId.境界失败_加速冷却, "加速时间", des, null);
+        }
+`;
+console.log('code:', JSON.stringify(code));
+console.log('code.indexOf("加速时间"):', code.indexOf('"加速时间"'));
+console.log('code.indexOf("观看视频后"):', code.indexOf('"观看视频后"'));
+console.log('\n--- Full code ---');
+console.log(code);
+console.log('\n--- Indices ---');
+for (let i = 0; i & lt; code.length)
+    ;
+i++;
+{
+    if (code[i] === '"') {
+        console.log(i, ':', code.substring(i, i + 10));
+    }
+}

package/dist/debug-args.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const CSharpStringExtractor_1 = require("./src/CSharpStringExtractor");
+const code = `
+        private void OnBtnIaa(EventContext context)
+        {
+            var iaaConfig = IAAConfigTable.GetConfigById((int)IAAId.境界失败_加速冷却);
+            if (iaaConfig == null)
+            {
+                return;
+            }
+
+            string des = $"观看视频后\\n等待时间减少{iaaConfig.EffectValue / 60}分钟";
+            this.GetModel<IAAModel>().ShowAdWithDialog(IAAId.境界失败_加速冷却, "加速时间", des, null);
+        }
+`;
+const extractor = new CSharpStringExtractor_1.CSharpStringExtractor();
+const snippets = extractor.extractStrings(code);
+console.log('Total snippets:', snippets.length);
+console.log('---');
+for (let i = 0; i < snippets.length; i++) {
+    console.log(`Snippet ${i}:`);
+    console.log('  originalIndex:', snippets[i].originalIndex);
+    console.log('  originalCode:', JSON.stringify(snippets[i].originalCode));
+    console.log('  literals:', snippets[i].literals);
+    console.log('---');
+}
+// Find the snippet with "加速时间"
+const targetSnippet = snippets.find(s => s.originalCode.includes('加速时间'));
+if (targetSnippet) {
+    console.log('Target snippet found at index:', snippets.indexOf(targetSnippet));
+    console.log('  originalIndex:', targetSnippet.originalIndex);
+    console.log('  Expected index:', code.indexOf('"加速时间"'));
+}