应启用workbuddy本地知识库语义搜索：一、确保打开含.js/.py/.ts文件的工作区，用自然语言提问；二、通过【记忆】页用行为标签检索快照库；三、添加路径前缀限定搜索范围以提升精度。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 WorkBuddy 过程中需要从大量历史代码中精准定位某段逻辑或函数，但仅靠文件名或关键词模糊匹配效率低下，则可能是由于未启用其本地知识库的语义搜索能力。以下是快速检索历史代码片段的具体方法：
一、启用并使用本地知识库语义搜索
WorkBuddy 的语义搜索功能基于嵌入模型（Embedding）对代码内容进行向量化处理，可理解变量命名意图、函数用途、上下文逻辑关系，而非仅依赖字面字符串匹配。该能力默认在完成初始化并绑定工作区后自动激活，无需额外部署。
1、确保当前已打开目标项目工作区，且项目中至少包含一个 .js、.py 或 .ts 文件。
2、在 WorkBuddy 对话框中输入自然语言查询，例如：“找出所有处理 JWT token 解析的函数” 或 “哪个文件实现了用户登录后的权限校验逻辑？”。
3、WorkBuddy 自动扫描项目目录下所有源码文件，提取函数签名、注释块、调用链及关键参数，生成语义向量并比对相似度。
4、返回结果按相关性排序，每项包含文件路径、函数名、所在行号及上下文摘要，点击即可跳转至 VS Code 对应位置。
二、通过代码片段快照库直接检索
WorkBuddy 在每次执行代码解释、重构或 Debug 任务时，会自动将被分析的代码块存入本地快照库，并打上行为标签（如“异常捕获”“API 调用”“正则校验”）。该库独立于文件系统，支持跨项目、跨时间回溯。
1、在主界面左侧导航栏点击【记忆】图标，进入快照管理视图。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
2、在顶部搜索栏输入描述性短语，例如：“带重试机制的 HTTP 请求” 或 “解析 base64 图片字符串的工具函数”。
3、系统从快照元数据中匹配行为标签与嵌入向量，瞬时列出匹配的历史片段。
4、每个结果项显示原始代码缩略、所属任务ID、创建时间及关联文件路径，点击“插入到编辑器”可一键复用。
三、结合文件结构约束缩小语义搜索范围
当项目规模较大时，全域语义搜索可能引入无关噪声。可通过显式限定作用域提升查准率，系统将仅对指定路径下的文件执行嵌入索引与相似度计算。
1、在提问前添加路径前缀，例如：“在 /src/utils/network/ 目录下，找实现断网自动降级的代码”。
2、WorkBuddy 解析路径约束后，跳过其他目录，仅加载符合路径规则的文件内容进行向量化。
3、若该目录下存在同名文件（如多个 index.ts），系统会进一步依据 import 关系与调用上下文加权排序。
4、返回结果中每条均标注相对路径与匹配置信度百分比，高于85%的结果默认高亮显示。
