scancscode 1.0.35 → 1.0.36

package/.trae/specs/fix-string-expression-capture-range/checklist.md

@@ -0,0 +1,7 @@
+# 修正字符串表达式捕获范围 - Verification Checklist
+
+- [ ] 修复了 `processAllFunctionCallsInRange` 函数中字符串插值表达式位置计算问题
+- [ ] 所有 "should handle special characters in string 8" 测试用例都通过
+- [ ] 完整的 Jest 测试套件运行通过（所有 120 个测试）
+- [ ] 代码仅修改了问题相关的部分，没有引入不必要的变更
+- [ ] 使用了 TypeScript 语言语法，没有使用 HTML 实体编码和保留字段作为变量名

package/.trae/specs/fix-string-expression-capture-range/spec.md

@@ -0,0 +1,96 @@
+# 修正字符串表达式捕获范围 - Product Requirement Document
+
+## Overview
+
+* **Summary**: 修正 `CSharpStringExtractor` 中函数调用参数内字符串插值表达式的 `originalIndex` 计算问题
+
+* **Purpose**: 解决测试用例中 `originalIndex` 与期望值不符的问题，确保正确捕获字符串表达式的起始位置
+
+* **Target Users**: 使用 `CSharpStringExtractor` 进行 C# 代码国际化处理的开发者
+
+## Goals
+
+* 修正函数调用参数内字符串插值表达式的 `originalIndex` 计算
+
+* 确保所有新增测试用例能够正确通过
+
+* 保持现有功能的正常工作
+
+## Non-Goals (Out of Scope)
+
+* 不修改其他无关的代码逻辑
+
+* 不新增测试用例（使用已有测试）
+
+* 不重构现有代码结构
+
+## Ba**ckground & Context**
+
+* **测试用例显示，函数调用参数内的字符串插值表达式（如** **`$"vwvwe{index + 1}"`）的** **`originalIndex`** **计算不正确**
+
+* **期望的** **`originalIndex`** **是字符串在原始代码中的实际位置，但实际返回的值偏离了10个字符**
+
+* **问题出在** **`processAllFunctionCallsInRange`** **函数中处理字符串位置的逻辑**
+
+## **Functional R**equirements
+
+* **FR-1**: 函数调用参数内的普通字符串字面量的 `originalIndex` 必须正确
+
+* **FR-2**: 函数调用参数内的字符串插值表达式（`$"..."`）的 `originalIndex` 必须正确
+
+* **FR-3**: 函数调用参数内的逐字字符串插值（`$@"..."`、`@$"..."`）的 `originalIndex` 必须正确
+
+## Non-Functional Requirements
+
+* **NFR-1**: 所有现有测试用例必须继续通过
+
+* **NFR-2**: 性能不能有明显下降
+
+* **NFR-3**: 代码变更必须是最小的，只修复问题相关的部分
+
+## Constraints
+
+* **Technical**: 必须使用 TypeScript 语言，不使用 HTML 实体编码，不使用保留字段作为变量名
+
+* **Business**: 必须在不破坏现有功能的前提下修复问题
+
+* **Dependencies**: 依赖现有的 Jest 测试框架
+
+## Assumptions
+
+* 测试用例的期望是正确的
+
+* 只有 `originalIndex` 的计算有问题，其他功能正常
+
+* 问题只出现在函数调用参数内的字符串处理
+
+## Acceptance Criteria
+
+### AC-1: 正确计算字符串插值表达式的 originalIndex
+
+* **Given**: 有一个包含函数调用参数内字符串插值的 C# 代码
+
+* **When**: 调用 `extractor.extractStrings(code)` 处理代码
+
+* **Then**: 返回的 snippet 的 `originalIndex` 必须等于字符串在原始代码中的实际索引位置
+
+* **Verification**: `programmatic`
+
+* **Notes**: 验证测试用例 "should handle special characters in string 8" 的所有实例
+
+### AC-2: 所有现有测试继续通过
+
+* **Given**: 所有已有的 Jest 测试用例
+
+* **When**: 运行完整的测试套件
+
+* **Then**: 所有测试用例必须通过
+
+* **Verification**: `programmatic`
+
+* **Notes**: 确保没有引入新的问题
+
+## Open Questions
+
+* 无
+

package/.trae/specs/fix-string-expression-capture-range/tasks.md

@@ -0,0 +1,25 @@
+# 修正字符串表达式捕获范围 - The Implementation Plan (Decomposed and Prioritized Task List)
+
+## [/] Task 1: 分析并修复 processAllFunctionCallsInRange 函数中字符串位置计算问题
+- **Priority**: P0
+- **Depends On**: None
+- **Description**: 
+  - 分析 `processAllFunctionCallsInRange` 函数中字符串插值表达式位置计算的问题
+  - 修复字符串位置的捕获逻辑，确保返回正确的 originalIndex
+  - 特别关注字符串插值表达式（$"..."、$@"..."、@$"..."）的位置识别
+- **Acceptance Criteria Addressed**: [AC-1]
+- **Test Requirements**:
+  - `programmatic` TR-1.1: 运行测试用例 "should handle special characters in string 8"，确保所有实例都通过
+  - `programmatic` TR-1.2: 确保 originalIndex 与 code.indexOf(...) 返回的值匹配
+- **Notes**: 问题可能出在处理参数内字符串的索引计算逻辑上
+
+## [ ] Task 2: 运行完整测试套件验证
+- **Priority**: P1
+- **Depends On**: Task 1
+- **Description**: 
+  - 运行完整的 Jest 测试套件
+  - 确保所有 120 个测试用例都通过
+- **Acceptance Criteria Addressed**: [AC-2]
+- **Test Requirements**:
+  - `programmatic` TR-2.1: 运行 `npx jest` 并确保所有测试通过
+- **Notes**: 如果有测试失败，需要回到 Task 1 继续修复

package/.trae/specs/handle-null-value/checklist.md

@@ -0,0 +1,10 @@
+
+# 处理 null 值 - 验证清单
+
+- [x] Checkpoint 1: 找到所有添加 .TR() 的关键方法位置（processTextAssignments、processStringConcatenation 等）
+- [x] Checkpoint 2: 在添加 .TR() 之前添加 null 检查逻辑
+- [x] Checkpoint 3: 当值为 null 时，跳过添加 .TR()，保持原样
+- [x] Checkpoint 4: 目标测试用例 "should handle null" 通过
+- [x] Checkpoint 5: 所有其他现有测试仍然通过（无回归错误）
+- [x] Checkpoint 6: 严格遵循 TypeScript 语法，不使用 HTML 特殊字符或保留字段作为局部变量名
+

package/.trae/specs/handle-null-value/spec.md

@@ -0,0 +1,57 @@
+
+# 处理 null 值 - 产品需求文档
+
+## 概述
+- **Summary**: 修改 CSharpStringExtractor 类，使其在处理 null 值时保持原样而不是错误地添加 .TR() 后缀。
+- **Purpose**: 确保当字符串表达式字面量为 null 时，代码不会对其进行转换，保持 null 的原始状态，以通过相关测试用例。
+- **Target Users**: 使用该工具进行 C# 代码国际化处理的开发人员。
+
+## 目标
+- 正确处理 null 值，不对 null 进行任何转换
+- 确保转换后的代码与原始代码保持一致（null 保持为 null）
+- 通过测试用例 "should handle null"
+
+## 非目标
+- 不修改其他字符串处理逻辑
+- 不改变其他关键字（如 true、false）的行为
+- 不引入新的功能
+
+## 背景与上下文
+- 当前代码在处理值为 null 的文本赋值（如 `m_text_notice.text = null;`）时，错误地将 null 转换为 null.TR()
+- 这导致了测试用例失败，因为期望 null 保持原样不转换
+- 需要修改相关处理逻辑，识别 null 关键字并跳过对它的转换
+
+## 功能需求
+- **FR-1**: 代码应该能够识别 null 值
+- **FR-2**: 当处理 null 时，不应该添加 .TR() 后缀
+- **FR-3**: 处理 null 后的 convertedCode 应该仍然是 "null"
+
+## 非功能需求
+- **NFR-1**: 保持现有功能的性能不受影响
+- **NFR-2**: 不破坏现有的其他测试用例
+
+## 约束
+- **技术**: 必须严格使用 TypeScript 语言语法
+- **技术**: 不能使用 <、&、> 等 HTML 符号
+- **技术**: 不能使用 arguments 等保留字段作为局部变量名
+
+## 假设
+- 只有 null 关键字需要特殊处理，其他值正常处理
+- 不改变 true、false 等其他关键字的行为
+
+## 验收标准
+
+### AC-1: null 值保持原样
+- **Given**: 存在包含 `m_text_notice.text = null;` 这样语句的 C# 代码
+- **When**: 使用 extractor.extractStrings(code) 处理该代码
+- **Then**: 
+  - 生成的 snippet 的 originalCode 应该是 "null"
+  - convertedCode 应该仍然是 "null"
+  - isChanged 应该为 false
+  - literals 应该是空数组
+- **Verification**: `programmatic`
+- **Notes**: 通过 test/CSharpStringExtractor.test.ts#L2655-2671 中的测试用例验证
+
+## 待解决问题
+- [ ] 无待解决问题
+

package/.trae/specs/handle-null-value/tasks.md

@@ -0,0 +1,40 @@
+
+# 处理 null 值 - 实现计划 (分解和优先级任务列表)
+
+## [x] 任务 1: 找到处理 null 值被错误转换的代码位置
+- **Priority**: P0
+- **Depends On**: None
+- **Description**: 
+  - 分析 CSharpStringExtractor.ts 中的代码，找到添加 .TR() 后缀的关键位置
+  - 主要检查 processTextAssignments 和 processStatementAndExtractValue 等方法
+- **Acceptance Criteria Addressed**: [AC-1]
+- **Test Requirements**:
+  - `programmatic` TR-1.1: 找到所有可能添加 .TR() 的方法 ✓
+- **Notes**: 特别注意 .text 赋值处理的代码路径
+
+## [x] 任务 2: 修改相关方法，对 null 值进行特殊处理
+- **Priority**: P0
+- **Depends On**: ["任务 1"]
+- **Description**: 
+  - 在添加 .TR() 后缀的代码之前，检查值是否为 null
+  - 如果是 null，就跳过转换，保持原样
+- **Acceptance Criteria Addressed**: [AC-1]
+- **Test Requirements**:
+  - `programmatic` TR-2.1: 在 processTextAssignments 中添加 null 检查 ✓
+  - `programmatic` TR-2.2: 在 processStringConcatenation 中添加 null 检查 ✓
+  - `programmatic` TR-2.3: 在其他相关方法中添加 null 检查（如果需要）
+- **Notes**: 只修改与添加 .TR() 相关的逻辑
+
+## [x] 任务 3: 验证修复是否解决了问题
+- **Priority**: P0
+- **Depends On**: ["任务 2"]
+- **Description**: 
+  - 运行目标测试用例 "should handle null"
+  - 确保测试通过
+  - 运行完整的测试套件，确保其他测试没有受到影响
+- **Acceptance Criteria Addressed**: [AC-1]
+- **Test Requirements**:
+  - `programmatic` TR-3.1: "should handle null" 测试用例通过 ✓
+  - `programmatic` TR-3.2: 所有其他现有测试继续通过（无回归）
+- **Notes**: 使用 Jest 运行完整测试套件
+

package/.trae/specs/handle-right-value-expression/checklist.md

@@ -0,0 +1,9 @@
+# 右值表达式字符串提取 - Verification Checklist
+
+- [ ] "should handle right value expression" 测试用例通过
+- [ ] "should handle special characters in string 8" 测试用例通过
+- [ ] "should handle assignment expression with both sides strings" 测试用例通过
+- [ ] 所有现有的测试用例继续通过
+- [ ] 代码严格遵循 TypeScript 语法
+- [ ] 不使用 HTML 实体编码字符
+- [ ] 不使用 arguments 等保留字段作为局部变量名

package/.trae/specs/handle-right-value-expression/spec.md

@@ -0,0 +1,72 @@
+# 右值表达式字符串提取 - Product Requirement Document
+
+## Overview
+- **Summary**: 修改 CSharpStringExtractor 类，使其能够正确处理赋值表达式左右两边都有字符串的情况，包括处理出现在 `=` 左边（左值表达式）的字符串，以及处理包含特殊符号的字符串。
+- **Purpose**: 解决当前代码在处理赋值表达式的左值字符串和特殊字符字符串时出现的问题。
+- **Target Users**: Unity 项目开发者，使用此工具进行 C# 代码国际化。
+
+## Goals
+- 正确处理赋值表达式 `=` 左边（左值表达式）的字符串
+- 正确处理赋值表达式左右两边都有字符串的情况
+- 保持正确处理赋值表达式 `=` 右边（右值表达式）的字符串
+- 正确处理包含特殊符号的字符串（如 HTML 标签、单引号等）
+- 保持现有功能不变
+
+## Non-Goals (Out of Scope)
+- 不修改字符串处理的核心逻辑
+- 不改变已有的测试用例
+- 不添加新的功能，除了修复当前问题
+
+## Background & Context
+- 测试用例位于 test/CSharpStringExtractor.test.ts:2493-2560
+- 问题1：左值表达式中的字符串 originalIndex 不匹配
+- 问题2：包含特殊字符的字符串提取了过多片段
+- 问题3：赋值表达式两边都有字符串时，左值字符串的 originalIndex 不匹配
+
+## Functional Requirements
+- **FR-1**: 正确处理出现在赋值表达式 `=` 左边（左值表达式）的字符串
+- **FR-2**: 正确处理赋值表达式左右两边都有字符串的情况
+- **FR-3**: 正确处理包含特殊符号的字符串（如 HTML 标签、单引号等）
+
+## Non-Functional Requirements
+- **NFR-1**: 所有现有测试用例必须继续通过
+- **NFR-2**: 性能不应受到明显影响
+- **NFR-3**: 代码必须严格遵循 TypeScript 语法
+
+## Constraints
+- **Technical**: 使用 TypeScript，不使用 HTML 实体编码，不使用 arguments 等保留字段名
+- **Business**: 必须通过指定的测试用例
+- **Dependencies**: 依赖 Jest 测试框架
+
+## Assumptions
+- 左值表达式中的字符串主要出现在函数调用参数中
+- 包含特殊字符的字符串应该被当作一个整体处理
+
+## Acceptance Criteria
+
+### AC-1: 处理赋值表达式左值的字符串
+- **Given**: 有一个赋值表达式，`=` 左边的表达式中包含字符串
+- **When**: extractStrings 方法被调用处理此代码
+- **Then**: 左值表达式中的字符串被正确提取，originalIndex 正确
+- **Verification**: `programmatic`
+
+### AC-2: 处理赋值表达式两边都有字符串
+- **Given**: 有一个赋值表达式，`=` 左右两边都包含字符串
+- **When**: extractStrings 方法被调用处理此代码
+- **Then**: 两边的字符串都被正确提取，顺序正确，originalIndex 正确
+- **Verification**: `programmatic`
+
+### AC-3: 处理包含特殊字符的字符串
+- **Given**: 有一个包含特殊字符（如 HTML 标签、单引号）的字符串
+- **When**: extractStrings 方法被调用处理此代码
+- **Then**: 字符串被正确提取，片段数量正确
+- **Verification**: `programmatic`
+
+### AC-4: 保持现有功能不变
+- **Given**: 所有现有的测试用例
+- **When**: 运行测试
+- **Then**: 所有现有的测试用例必须通过
+- **Verification**: `programmatic`
+
+## Open Questions
+- 无

package/.trae/specs/handle-right-value-expression/tasks.md

@@ -0,0 +1,53 @@
+# 右值表达式字符串提取 - The Implementation Plan (Decomposed and Prioritized Task List)
+
+## [x] Task 1: 分析测试失败的原因
+- **Priority**: P0
+- **Depends On**: None
+- **Description**: 
+  - 分析 "should handle right value expression" 测试失败原因
+  - 分析 "should handle special characters in string 8" 测试失败原因
+  - 分析 "should handle assignment expression with both sides strings" 测试失败原因
+- **Acceptance Criteria Addressed**: [AC-1, AC-2, AC-3]
+- **Test Requirements**:
+  - `programmatic` TR-1.1: 运行测试用例，确认失败状态
+  - `programmatic` TR-1.2: 分析代码流程，确定问题所在
+- **Notes**: 无
+
+## [x] Task 2: 设计解决方案
+- **Priority**: P0
+- **Depends On**: Task 1
+- **Description**: 
+  - 分析为什么左值字符串的 originalIndex 不正确
+  - 分析为什么特殊字符字符串提取了过多片段
+  - 设计如何正确处理这些场景
+- **Acceptance Criteria Addressed**: [AC-1, AC-2, AC-3]
+- **Test Requirements**:
+  - `human-judgement` TR-2.1: 设计文档清晰说明问题原因和解决方案
+- **Notes**: 确保不破坏现有功能
+
+## [/] Task 3: 实现修复
+- **Priority**: P0
+- **Depends On**: Task 2
+- **Description**: 
+  - 修改源代码以修复三个测试用例的问题
+  - 确保左值字符串的 originalIndex 正确
+  - 确保特殊字符字符串只提取一个片段
+  - 确保赋值表达式两边的字符串都正确提取
+- **Acceptance Criteria Addressed**: [AC-1, AC-2, AC-3, AC-4]
+- **Test Requirements**:
+  - `programmatic` TR-3.1: 三个目标测试用例通过
+  - `programmatic` TR-3.2: 所有现有测试用例继续通过
+- **Notes**: 严格遵循 TypeScript 语法
+
+## [ ] Task 4: 全面验证和测试
+- **Priority**: P0
+- **Depends On**: Task 3
+- **Description**: 
+  - 运行所有目标测试用例
+  - 运行所有现有测试用例
+  - 确保没有回归
+- **Acceptance Criteria Addressed**: [AC-1, AC-2, AC-3, AC-4]
+- **Test Requirements**:
+  - `programmatic` TR-4.1: 所有目标测试用例通过
+  - `programmatic` TR-4.2: 所有现有测试用例通过
+- **Notes**: 无

package/.trae/specs/process-function-call-interpolated-strings/checklist.md

@@ -0,0 +1,12 @@
+# 内插字符串处理增强 - Verification Checklist
+
+- [ ] 任务 1 完成：已完整分析 processFunctionCallArguments 方法，理解当前实现
+- [ ] 任务 2 完成：已更新字符串起始位置检测，支持 $""、@$"" 和 $@"" 格式的内插字符串
+- [ ] 任务 3 完成：已更新函数括号查找逻辑，正确处理内插字符串中的括号
+- [ ] 任务 4 完成：已更新参数检测逻辑，能正确识别内插字符串
+- [ ] 任务 5 完成：三个目标测试用例已通过
+  - [ ] should handle right value expression
+  - [ ] should handle special characters in string 8
+  - [ ] should handle assignment expression with both sides strings
+- [ ] 任务 6 完成：所有现有测试用例继续通过
+- [ ] 代码风格与现有保持一致，遵循项目规范

package/.trae/specs/process-function-call-interpolated-strings/spec.md

@@ -0,0 +1,80 @@
+# 内插字符串处理增强 - Product Requirement Document
+
+## Overview
+- **Summary**: 增强 `CSharpStringExtractor` 类中的 `processFunctionCallArguments` 方法，使其能够正确处理 C# 内插字符串（以 $ 开头的字符串），包括 $""、@$"" 和 $@"" 格式。
+- **Purpose**: 解决三个目标测试用例失败的问题，确保函数调用参数中的内插字符串能够被正确识别、处理，同时保持所有现有测试用例继续通过。
+- **Target Users**: 开发者，使用该代码扫描工具提取 C# 字符串进行国际化处理的开发人员。
+
+## Goals
+- 使 `processFunctionCallArguments` 方法能够正确识别和处理内插字符串
+- 确保三个目标测试用例能够通过：
+  1. should handle right value expression
+  2. should handle special characters in string 8
+  3. should handle assignment expression with both sides strings
+- 保持所有现有测试用例继续通过
+- 保持与代码库中其他处理内插字符串方法的一致性
+
+## Non-Goals (Out of Scope)
+- 不修改除 `processFunctionCallArguments` 方法以外的其他方法的主要逻辑
+- 不重构整个代码库的架构
+- 不引入新的依赖
+
+## Background & Context
+- 当前 `CSharpStringExtractor` 类负责从 C# 代码中提取字符串并进行国际化处理
+- 该类已经有多个方法已经支持内插字符串处理，如 `extractClassMemberStrings`、`extractObjectInitializerStrings` 等
+- 但 `processFunctionCallArguments` 方法目前只支持普通字符串字面量，不支持内插字符串
+- 三个目标测试用例当前失败，需要修复
+
+## Functional Requirements
+- **FR-1**: `processFunctionCallArguments` 方法能识别内插字符串格式：$""
+- **FR-2**: `processFunctionCallArguments` 方法能识别 @$"" 和 $@"" 格式的内插字符串
+- **FR-3**: 正确计算内插字符串的起始位置和结束位置
+- **FR-4**: 正确处理内插字符串中的特殊字符
+- **FR-5**: 确保 originalIndex 值正确设置为内插字符串的起始位置
+
+## Non-Functional Requirements
+- **NFR-1**: 所有现有测试必须继续通过
+- **NFR-2**: 三个目标测试必须通过
+- **NFR-3**: 保持代码风格和现有方法保持一致
+
+## Constraints
+- **Technical**: 使用 TypeScript，遵循现有代码风格
+- **Business**: 无特定时间限制，但需要保持代码稳定
+- **Dependencies**: 无额外依赖
+
+## Assumptions
+- 内插字符串的处理方式可以参考 `extractClassMemberStrings`、`extractObjectInitializerStrings` 等方法
+- 内插字符串需要被正确处理为与普通字符串一样被识别和收集
+- 内插字符串的 originalIndex 应该设置为 `$` 字符的位置
+
+## Acceptance Criteria
+
+### AC-1: 正确处理右值表达式中的内插字符串
+- **Given**: 有一个 C# 代码，函数调用参数中包含内插字符串
+- **When**: 调用 extractStrings 方法
+- **Then**: 内插字符串被正确提取，originalIndex 正确，snippets 数组中包含正确的片段
+- **Verification**: `programmatic`
+- **Notes**: 通过 should handle right value expression 测试用例通过
+
+### AC-2: 正确处理包含特殊字符的内插字符串
+- **Given**: 有一个 C# 代码，内插字符串包含特殊字符
+- **When**: 调用 extractStrings 方法
+- **Then**: 内插字符串被正确提取，只产生一个 CodeSnippet，originalIndex 正确
+- **Verification**: `programmatic`
+- **Notes**: 通过 should handle special characters in string 8 测试用例通过
+
+### AC-3: 正确处理赋值表达式两边都有字符串的情况
+- **Given**: 有一个 C# 赋值表达式，左右两边都有字符串
+- **When**: 调用 extractStrings 方法
+- **Then**: 两个字符串都被正确提取，originalIndex 都正确
+- **Verification**: `programmatic`
+- **Notes**: 通过 should handle assignment expression with both sides strings 测试用例通过
+
+### AC-4: 所有现有测试用例继续通过
+- **Given**: 完整的测试套件
+- **When**: 运行完整测试
+- **Then**: 所有现有 113 个测试继续通过
+- **Verification**: `programmatic`
+
+## Open Questions
+- 无

package/.trae/specs/process-function-call-interpolated-strings/tasks.md

@@ -0,0 +1,73 @@
+# 内插字符串处理增强 - The Implementation Plan (Decomposed and Prioritized Task List)
+
+## [x] Task 1: 分析 processFunctionCallArguments 方法，理解当前实现
+- **Priority**: P0
+- **Depends On**: None
+- **Description**: 
+  - 仔细阅读 processFunctionCallArguments 方法的完整实现
+  - 理解它当前如何处理字符串字面量
+  - 识别需要修改的具体位置
+  - 参考其他已实现内插字符串处理的方法（如 extractClassMemberStrings）
+- **Acceptance Criteria Addressed**: [AC-1, AC-2, AC-3, AC-4]
+- **Test Requirements**:
+  - `programmatic` TR-1.1: 完整理解方法逻辑
+- **Notes**: 首先仔细阅读代码，确保理解需要修改的所有部分
+
+## [/] Task 2: 更新字符串起始位置检测，支持内插字符串
+- **Priority**: P0
+- **Depends On**: [Task 1]
+- **Description**: 
+  - 修改 simpleStringLiteralPositions 收集逻辑
+  - 添加对 $""、@$"" 和 $@"" 格式的支持
+  - 确保内插字符串的起始位置也被记录下来
+- **Acceptance Criteria Addressed**: [AC-1, AC-2, AC-3]
+- **Test Requirements**:
+  - `programmatic` TR-2.1: simpleStringLiteralPositions 包含内插字符串的起始位置
+- **Notes**: 参考 extractClassMemberStrings 中处理内插字符串的模式
+
+## [ ] Task 3: 更新函数括号查找逻辑，支持内插字符串
+- **Priority**: P0
+- **Depends On**: [Task 2]
+- **Description**: 
+  - 修改查找括号时的字符串状态管理逻辑
+  - 添加对内插字符串的识别，避免在内插字符串内部误判括号
+- **Acceptance Criteria Addressed**: [AC-1, AC-2, AC-3]
+- **Test Requirements**:
+  - `programmatic` TR-3.1: 查找括号位置时正确处理内插字符串
+- **Notes**: 确保在查找括号时不会被内插字符串中的字符干扰
+
+## [ ] Task 4: 更新参数检测逻辑，支持内插字符串
+- **Priority**: P0
+- **Depends On**: [Task 3]
+- **Description**: 
+  - 修改 hasStringLiteral 的检测方式
+  - 更新简单字符串字面量的判断逻辑，添加对内插字符串的支持
+  - 确保内插字符串被正确识别为简单字符串字面量
+- **Acceptance Criteria Addressed**: [AC-1, AC-2, AC-3, AC-4]
+- **Test Requirements**:
+  - `programmatic` TR-4.1: 内插字符串被正确识别为有字符串字面量
+  - `programmatic` TR-4.2: 内插字符串被正确判断为简单字符串字面量
+
+## [ ] Task 5: 运行并调试三个目标测试用例
+- **Priority**: P0
+- **Depends On**: [Task 4]
+- **Description**: 
+  - 运行测试，检查三个目标测试用例
+  - 修复任何发现的问题
+  - 确保 originalIndex 正确
+- **Acceptance Criteria Addressed**: [AC-1, AC-2, AC-3]
+- **Test Requirements**:
+  - `programmatic` TR-5.1: should handle right value expression 测试通过
+  - `programmatic` TR-5.2: should handle special characters in string 8 测试通过
+  - `programmatic` TR-5.3: should handle assignment expression with both sides strings 测试通过
+
+## [ ] Task 6: 运行完整测试套件，确保所有现有测试继续通过
+- **Priority**: P0
+- **Depends On**: [Task 5]
+- **Description**: 
+  - 运行完整的 Jest 测试套件
+  - 检查并修复任何可能失败的现有测试
+  - 确保没有引入新的问题
+- **Acceptance Criteria Addressed**: [AC-4]
+- **Test Requirements**:
+  - `programmatic` TR-6.1: 所有 113+ 现有测试用例通过