函数拆分是将复杂函数打散为可独立验证模块的关键手段；识别标准包括职责注释、无跨段跳转、明确返回值或副作用，以及多分支长循环需整体封装；comate支持三步拆分与手动微调。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你面对一个超过200行、嵌套三层以上、同时处理校验/计算/IO/异常的Python函数时，靠人眼梳理逻辑链极易漏掉分支或误判作用域，函数拆分就是把这种“一锅炖”的结构打散成可独立验证的模块。
识别该拆不拆的关键信号
打开待处理函数，逐行扫描：如果某段代码块开头有注释如“# 校验用户权限”“# 计算折扣率”“# 写入日志”，且这段代码内部没有跨段跳转（如break/continue跳出外层循环）、不修改外部变量状态、末尾有明确返回值或副作用（如file.write），那就【必须拆】。这类注释本质是开发者自己画出的职责边界，Comate能精准识别并尊重它。
遇到for循环内包含if-elif-else多分支，且每个分支体都超过15行，说明该循环已承担多重判断职责，不能只拆if块——要连同循环头一起封装成新函数。
用Comate执行拆分的三步操作
第一步：将光标置于目标函数名左侧空白处，确保整个函数被完整选中（含def行和所有缩进代码）。
第二步：在代码上方悬浮工具栏中点击【函数拆分】按钮，等待3秒左右，右侧会弹出预览面板，显示拆分后的多个小函数草案及调用关系图。
调用百度PaddleOCR‑VL大模型API，支持PDF、Word、PPT、图片等多格式文档解析，精准识别印刷体、手写体、表格、公式、图表、印章等复杂元素，支持100+语言，可处理不规则布局和跨页长文档。触发词：文档解析、VLM解析、大模型OCR、PaddleOCR、多模态文档、手写识别、公式识别、复杂版面。
第三步：检查预览中的新函数命名是否体现职责——若出现func_1、sub_func等模糊名称，立即点击该函数名旁的铅笔图标手动重命名为validate_input、calculate_fee、log_transaction；【命名错误会导致后续调试完全失效】。
手动微调拆分结果的两种方法
方法一：拖拽调整粒度
在预览面板中，按住某个新函数的标题栏，直接拖拽到另一个函数内部（例如把“解析JSON”函数拖进“处理HTTP响应”函数下方），Comate会自动合并为单个函数并重绘调用链。
方法二：删减冗余入口
预览中若出现仅被调用1次、且无参数传递的函数（如init_config），选中它→点击右上角垃圾桶图标删除→原位置自动内联回主函数，避免无意义的函数跳转损耗。
采纳全部修改后，原函数体只剩顶层调用序列，每个函数独立存在于文件中，结构层级一目了然。
