WorkBuddy大型项目索引异常的优化方案包括：一、配置忽略路径（如node_modules/、dist/等）缩小范围；二、启用.gitignore自动继承；三、调高JVM堆内存至4GB并设4线程并发；四、切换为30秒间隔的增量索引；五、禁用PDF/Office/图像/压缩包解析器，仅保留源码与文本解析。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在大型项目中使用WorkBuddy时发现索引无法正常建立或频繁中断，极可能是索引范围过大导致内存溢出或文件遍历超时。以下是针对性优化索引行为的具体操作步骤：
一、配置项目级忽略路径以缩小索引范围
WorkBuddy默认对工作区根目录下所有子路径递归扫描，当项目包含大量构建产物、第三方依赖或临时文件时，索引引擎会因遍历无效路径而耗尽内存或触发强制终止。通过显式声明忽略规则，可直接跳过非源码区域，显著降低索引负载。
1、启动WorkBuddy后，点击左下角「设置」图标进入系统配置页。
2、在左侧导航栏选择「项目索引」→「路径过滤」选项卡。
3、在「忽略路径」输入框中，逐行添加需排除的目录模式，例如：node_modules/、dist/、build/、.git/、logs/、__pycache__/。
4、勾选「启用正则匹配」，将上述路径转为正则表达式形式（如^.*[/\]node_modules[/\].*$），确保跨平台路径兼容性。
5、点击「应用并重建索引」，系统将清空旧索引并仅扫描未被忽略的路径。
二、启用基于.gitignore的自动继承机制
WorkBuddy支持读取项目根目录下的.gitignore文件，并将其规则自动映射为索引过滤条件。该方式无需手动维护两套规则，避免因遗漏更新导致无效文件重新进入索引流程。
1、确认项目根目录存在有效的.gitignore文件，且其中已包含标准排除项（如*.log、/target/等）。
2、返回「项目索引」→「路径过滤」页面，勾选「自动加载.gitignore规则」选项。
3、点击「同步规则」按钮，界面将实时显示已识别的忽略条目数量。
4、若部分.gitignore规则未生效，检查是否存在语法错误（如未转义特殊字符），或路径前缀含空格未用引号包裹。
三、调整索引内存分配与并发线程数
索引过程默认受限于客户端预设的JVM堆内存上限及单线程执行策略。在大型项目中，需主动提升资源配额并启用并行扫描，否则易因GC频繁或I/O阻塞导致索引挂起。
1、关闭WorkBuddy客户端，在安装目录下找到workbuddy.vmoptions文件（Windows路径示例：%LOCALAPPDATA%TencentWorkBuddyin）。
WorkBuddy 桌宠工厂 —— 给一张角色图、一个 codex.pet 链接、一条 codex-pets.net 下载 URL、或一份现成的精灵表，就能自动创建一只可联动 WorkBuddy 状态的桌面宠物。当用户说"创建桌宠"、"做一只桌宠"、"用这张图做桌宠"、"从 codex.pet 安装桌宠"、"导入 codex 桌宠 XX"、"装一下 codex-pets.net 上的 XX&quo
2、用文本编辑器打开该文件，将-Xmx2g修改为-Xmx4g，确保最大堆内存不低于4GB。
3、新增一行参数：-Dworkbuddy.index.threads=4，指定索引使用4个并发线程（数值不可超过CPU物理核心数）。
4、保存文件后重启WorkBuddy，进入「项目索引」→「高级设置」，确认「内存限制」显示为4096 MB、「并发线程」显示为4。
四、切换为增量式索引模式
全量索引在大型项目中极易失败，而增量索引仅处理自上次成功索引以来发生变更的文件，大幅减少扫描量与内存压力，适用于持续开发场景。
1、在「项目索引」→「模式选择」中，取消勾选「启用全量索引」。
2、勾选「启用增量索引」，并设置「变更检测间隔」为30秒（避免过于频繁轮询）。
3、点击「初始化增量索引」，系统将先执行一次轻量快照扫描，生成基准哈希表。
4、后续所有文件修改、新增、删除操作均通过文件系统事件监听捕获，不触发全路径遍历。
五、禁用非必要元数据解析器
WorkBuddy默认为每类文件启用语义分析模块（如PDF文本提取、Excel结构解析、图片OCR），这些模块在索引阶段即预加载，占用大量内存。对于仅需符号跳转与文本搜索的项目，可关闭全部非文本解析器。
1、进入「项目索引」→「文件类型处理」页面。
2、将「PDF文档」、「Office文档」、「图像文件」、「压缩包」四类条目右侧开关全部设为关闭状态。
3、仅保留「源代码文件」与「纯文本文件」为启用，确保.js、.py、.java等后缀仍可被正确解析。
4、点击「保存配置」，该设置将在下次索引启动时立即生效，内存占用可下降约65%。
