workbuddy 提供五种重构超长递归函数的方法：一、提取递归为私有函数；二、递归转迭代+显式栈；三、按职责切分为多私有函数；四、web worker 卸载计算；五、记忆化+缓存键标准化。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 WorkBuddy 处理代码重构任务时，遇到超长函数（如超过100行、嵌套多层条件与循环、含重复递归逻辑）难以维护的问题，则可能是由于函数职责混杂、控制流复杂或递归边界不清晰所致。以下是针对该问题的多种重构方法：
一、递归逻辑提取为独立函数并私有化
该方法通过识别原函数中可分离的递归片段，将其封装为单一职责的私有函数，消除原函数内部递归调用带来的嵌套膨胀，同时利用命名明确其语义，提升可读性与可测试性。
1、在 WorkBuddy 主界面点击【技能中心】→ 搜索启用【函数结构分析】技能。
2、拖入待重构文件（如 /src/core/processor.js），系统自动标注出含 return fn(...) 或 fn(...) 自调用的代码段。
3、选中被标记的递归块，右键选择【提取为私有函数】，输入新函数名（如 _traverseNode），确认后 WorkBuddy 自动生成带下划线前缀的私有函数并替换原调用。
4、检查生成代码：新函数位于原函数上方，作用域限定为模块内，且参数精简为仅传递必要状态变量（如 node, depth, accumulator）。
二、递归转迭代 + 显式栈管理
该方法将隐式依赖调用栈的递归逻辑，改为显式使用数组模拟栈结构进行遍历，彻底规避栈溢出风险，并使控制流线性化，便于 WorkBuddy 插入日志、断点或性能监控点。
1、在指令框中输入：把 /src/utils/tree.js 中 traverse() 函数的递归实现改为迭代版本，保持行为一致，使用 stack 数组替代调用栈。
2、WorkBuddy 解析后，在【Plan 模式】下展示三步变更：初始化空栈并压入根节点；while 循环 pop 节点并处理；对每个子节点按需压栈（顺序依原递归方向调整）。
3、确认方案后执行，生成的新函数名为 traverseIterative，原函数自动重命名为 traverseLegacy 并添加废弃注释。
4、WorkBuddy 同步更新所有对该函数的调用处，确保无运行时行为偏移。
三、基于职责切分的多私有函数协同重构
该方法适用于超长函数中存在多个逻辑子域（如数据预处理、核心计算、结果组装、异常兜底）且部分子域含递归分支的情形。WorkBuddy 将其拆解为一组高内聚、低耦合的私有函数，递归仅保留在最窄作用域内。
1、启动【Craft 模式】，输入指令：分析 /src/analyzer/report.js 中 generateReport() 函数，识别四个以上职责区域，将其中‘递归聚合子项指标’部分提取为 _aggregateMetrics(node, config)，其余分别封装为 _validateInput、_formatOutput、_handleError。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
2、WorkBuddy 扫描函数体，依据缩进层级、注释分隔符与 return 语句分布，自动划分四段逻辑区域。
3、对识别出的递归聚合段，检测到其依赖 node.children 和 config.depthLimit，据此生成带深度守卫的私有函数，内嵌 if (depth >= config.depthLimit) return null 防护。
4、全部私有函数生成后，原函数仅保留顺序调用链，每行调用对应一个清晰语义，如 const metrics = _aggregateMetrics(root, config)。
四、Web Worker 卸载递归计算任务
该方法适用于超长函数中递归部分计算密集、阻塞主线程（如树形结构深度遍历、分治排序、路径搜索）的场景。WorkBuddy 可自动生成 Worker 封装逻辑，实现主线程零阻塞。
1、在【Claw 设置】中启用「重型计算隔离」选项，确保本地已允许 Worker 创建权限。
2、在指令中明确指定卸载范围：将 /src/calculator/optimizer.js 中 solveRecursive() 的全部递归执行逻辑移入 Web Worker，主线程只传入 {tree, maxDepth} 并监听 result 事件。
3、WorkBuddy 自动生成两个文件：/src/calculator/optimizer.worker.js（含完整递归函数与 onmessage 监听）、/src/calculator/optimizer.js（主模块中创建 Worker 实例并封装 postMessage 接口）。
4、验证阶段，WorkBuddy 自动注入性能采样代码，在主线程输出 "Worker start: 12ms, result received: 847ms" 等耗时日志。
五、递归路径记忆化 + 缓存键标准化
该方法专用于优化含大量重复子问题的递归逻辑（如动态规划类、树形哈希计算），通过自动注入 LRU 缓存机制与结构化缓存键生成策略，避免指数级重复计算。
1、启用【智能性能增强】技能，在文件选择器中定位 /src/transformer/keygen.js。
2、WorkBuddy 检测到函数内存在 computeHash(node.left) + computeHash(node.right) 类型递归调用，且 node 为普通对象。
3、系统自动引入 import { memoize } from 'workbuddy/memo'，并将函数重写为 const computeHash = memoize((node) => {...}, { key: (node) => `${node.id}_${node.type}` })。
4、缓存键生成逻辑由 WorkBuddy 根据对象字段访问路径推导，排除不可序列化字段（如函数、undefined），确保跨会话缓存可用性。
