workbuddy提供五种代码搜索与定位方法：一、启用本地知识库语义搜索；二、通过代码片段快照库检索；三、使用关键路径导航穿透调用链；四、结合路径前缀限定搜索范围；五、利用任务内嵌ctrl+f检索上下文。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在大型项目中面对成百上千个文件与嵌入式调用链，难以快速定位目标函数、变量或逻辑模块，则可能是由于未启用WorkBuddy内置的多模态代码搜索与结构化导航能力。以下是支持代码搜索和定位的具体方法：
一、启用本地知识库语义搜索
WorkBuddy 的语义搜索功能基于嵌入模型（Embedding）对代码内容进行向量化处理，可理解变量命名意图、函数用途、上下文逻辑关系，而非仅依赖字面字符串匹配。该能力默认在完成初始化并绑定工作区后自动激活，无需额外部署。
1、确保当前已打开目标项目工作区，且项目中至少包含一个 .js、.py 或 .ts 文件。
2、在 WorkBuddy 对话框中输入自然语言查询，例如：“找出所有处理 JWT token 解析的函数” 或 “哪个文件实现了用户登录后的权限校验逻辑？”。
3、WorkBuddy 自动扫描项目目录下所有源码文件，提取函数签名、注释块、调用链及关键参数，生成语义向量并比对相似度。
4、返回结果按相关性排序，每项包含文件路径、函数名、所在行号及上下文摘要，点击即可跳转至 VS Code 对应位置。
二、通过代码片段快照库直接检索
WorkBuddy 在每次执行代码解释、重构或 Debug 任务时，会自动将被分析的代码块存入本地快照库，并打上行为标签（如“异常捕获”“API 调用”“正则校验”）。该库独立于文件系统，支持跨项目、跨时间回溯。
1、在主界面左侧导航栏点击【记忆】图标，进入快照管理视图。
2、在顶部搜索栏输入描述性短语，例如：“带重试机制的 HTTP 请求” 或 “解析 base64 图片字符串的工具函数”。
3、系统从快照元数据中匹配行为标签与嵌入向量，瞬时列出匹配的历史片段。
4、每个结果项显示原始代码缩略、所属任务ID、创建时间及关联文件路径，点击“插入到编辑器”可一键复用。
三、使用关键路径导航穿透调用链
WorkBuddy 通过静态调用图分析与入口函数标记，自动推导出从公开 API 到核心实现的最短可信调用链，屏蔽无关分支与测试代码，适用于深入理解第三方库或自研核心模块。
1、在 WorkBuddy 插件界面点击“源码分析”按钮，选择目标开源库或项目根目录。
WorkBuddy 桌宠工厂 —— 给一张角色图、一个 codex.pet 链接、一条 codex-pets.net 下载 URL、或一份现成的精灵表，就能自动创建一只可联动 WorkBuddy 状态的桌面宠物。当用户说"创建桌宠"、"做一只桌宠"、"用这张图做桌宠"、"从 codex.pet 安装桌宠"、"导入 codex 桌宠 XX"、"装一下 codex-pets.net 上的 XX&quo
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，适合调试过程中即时验证。
