WorkBuddy代码搜索与定位：大型项目高效导航指南
在大型项目中面对数百个文件与复杂的调用关系，快速定位特定函数、变量或逻辑模块往往令人头疼。WorkBuddy 集成了多种高效的代码搜索与定位工具，熟练掌握后能显著提升开发效率。
一、启用本地知识库语义搜索
WorkBuddy 的语义搜索基于嵌入模型对代码进行向量化处理，并非简单的字符串匹配，而是深入理解变量命名意图、函数职责及上下文逻辑关系。该能力在完成初始化并绑定工作区后自动生效，无需额外部署。
操作步骤清晰简洁：
1、确保当前已打开目标项目的工作区，并且项目内至少包含一个 .js、.py 或 .ts 文件。
2、直接在 WorkBuddy 对话框中使用自然语言提问，例如：“找出所有处理 JWT token 解析的函数”，或 “哪个文件实现了用户登录后的权限校验逻辑？”。
3、系统自动扫描项目目录下所有源码文件，提取函数签名、注释块、调用链与关键参数，生成语义向量进行相似度比对。
4、返回结果按相关性排序，每条记录附带文件路径、函数名、行号及上下文摘要，点击即可直接跳转到 VS Code 中的对应位置。
二、通过代码片段快照库直接检索
WorkBuddy 每次执行代码解释、重构或 Debug 任务时，会自动将被分析的代码块存入本地快照库，并打上行为标签（如“异常捕获”“API 调用”“正则校验”）。该库独立于文件系统，支持跨项目、跨时间回溯，相当于专属的代码记忆仓库。
具体用法如下：
1、在主界面左侧导航栏点击【记忆】图标，进入快照管理视图。
2、在顶部搜索栏输入描述性短语，例如：“带重试机制的 HTTP 请求”，或 “解析 base64 图片字符串的工具函数”。
3、系统从快照元数据中匹配行为标签与嵌入向量，几乎瞬时列出匹配的历史片段。
4、每个结果项显示原始代码缩略图、关联的任务 ID、创建时间及文件路径，点击“插入到编辑器”即可一键复用。
三、使用关键路径导航穿透调用链
通过静态调用图分析与入口函数标记，WorkBuddy 自动推导出从公开 API 到核心实现的最短可信调用链，屏蔽无关分支与测试代码。此功能在深入理解第三方库或自研核心模块时尤为实用。
操作步骤：
1、在 WorkBuddy 插件界面点击“源码分析”按钮，选择目标开源库或项目根目录。
2、勾选“启用关键路径识别”，系统自动扫描 package.json 或 pyproject.toml 中声明的 main/module 入口点。
3、分析完成后，左侧导航树出现高亮标记的Key Path 分组，内含带箭头图标的可展开路径节点。
4、点击任意路径节点（例如 “HttpClient.send → RequestBuilder.build → encodeBody”），编辑器自动跳转到对应方法定义处，并在当前文件顶部显示横向路径条。
四、结合路径前缀限定搜索范围
当项目结构层次清晰（如 src/api、src/utils、src/components 等明确路径）时，添加路径前缀能显著提升语义搜索精度，避免跨域干扰。该技巧在微前端或多包单体仓库场景下尤为有效。
具体做法：
1、在自然语言查询中加入路径约束，例如：“在 src/api/auth/ 下查找刷新 token 的请求封装函数”。
2、WorkBuddy 优先扫描指定子目录下所有匹配文件，跳过其他路径。
3、如需排除某类路径，可在查询中显式声明，例如：“除 node_modules 和 __tests__ 外，搜索所有 use* 开头的 React Hook”。
4、系统实时反馈匹配的文件数量与最高相关性的片段，支持点击展开完整上下文。
五、利用任务内嵌 Ctrl+F 检索上下文
WorkBuddy 在对话页中集成了轻量级全文检索能力，针对当前任务涉及的所有交互文本、代码块输出与历史响应进行局部索引。快速复查已交付结果中的特定符号或错误信息时，该功能极为顺手。
使用方式：
1、在任意任务对话页中按下Ctrl + F（Windows/Linux）或 Cmd + F（macOS），激活内嵌搜索框。
2、输入待查关键词，例如：“401 error handler” 或 “missing dependency warning”。
3、系统高亮所有匹配项，支持按Enter 键逐个跳转。
4、搜索结果不触发新分析，响应延迟低于 50ms，在调试过程中可用于即时验证。