workbuddy大文件卡顿问题可通过四步解决：一、启用流式解析与函数级作用域提示；二、配置分块索引与符号缓存；三、绑定外部lsp服务器；四、启用注释隔离解析。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用WorkBuddy编辑或分析大体积代码文件（如超10MB的单个TS/Java源码、含数千行逻辑的Python脚本）时遭遇智能提示延迟、卡顿、无响应或提示内容不完整，则很可能是因默认加载策略将全文载入内存导致解析器阻塞或上下文截断。以下是解决此问题的步骤：
一、启用流式代码解析与按需提示加载
该方法绕过全文语法树构建，改用增量式词法扫描与局部AST缓存机制，在光标所在函数或类范围内动态激活语义提示，显著降低内存占用并提升响应速度。
1、打开WorkBuddy主界面，点击右上角「首选项」→「代码智能」→「提示行为」。
2、取消勾选“启用全文件静态分析”选项。
3、勾选“仅对当前作用域启用智能提示”，并在下拉菜单中选择“函数级上下文窗口”。
4、点击「保存并重启代码引擎」，系统将卸载旧解析模块并加载轻量级流式提示器。
二、配置分块索引与符号缓存策略
针对含大量导入、嵌套模块或跨文件引用的大型工程，WorkBuddy支持将符号表按逻辑单元切片存储，避免单次加载全部依赖引发的IO瓶颈与内存溢出。
1、进入「首选项」→「项目索引」→「符号缓存设置」。
2、将“最大单文件索引行数”由默认50000调整为15000。
3、启用“按import路径分块缓存”，并勾选“跳过node_modules及venv目录索引”。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
4、点击「重建当前工作区索引」，系统将生成多个独立.bin缓存文件，每个对应一个模块层级。
三、绑定外部语言服务器实现低延迟提示
当本地WorkBuddy引擎无法满足高实时性要求时，可将其智能提示请求代理至已部署的LSP服务（如Pyright、tsserver、clangd），利用其成熟优化的增量编译能力提供毫秒级响应。
1、在「首选项」→「代码智能」→「语言服务器」中点击「添加自定义LSP」。
2、填写服务地址：localhost:9001（确保该端口已运行兼容LSP v3.17的服务器实例）。
3、为.ts文件类型指定该服务器，并勾选“禁用内置TypeScript提示器”。
4、重启WorkBuddy后，所有.ts文件的补全、跳转、悬停提示均由外部LSP接管。
四、启用注释隔离解析以加速提示触发
长文件中常存在大量文档注释（如JSDoc、Sphinx风格docstring），默认模式下会强制解析其中嵌入的示例代码，拖慢整体提示初始化。启用注释隔离后，仅对真实可执行代码段构建语义模型。
1、进入「首选项」→「代码智能」→「解析增强」。
2、勾选“跳过文档注释内代码块解析”。
3、在“注释识别标记”字段中确认已预置：/**、'''、\"\"\"、
