WorkBuddy本地知识库默认不启用向量化索引，需手动在【系统设置→知识库管理→新建知识空间】高级选项中勾选“启用向量化索引”并选择bge-m3-local-v2模型，保存后等待状态栏显示“索引服务就绪”，且仅对已解析完成、格式支持、内容≥128字符的文档生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
WorkBuddy 本地知识库默认不索引文件，必须手动启用向量化索引
WorkBuddy 的知识空间创建后，默认只做基础文档存储和关键词匹配（即类似 grep 的字符串扫描），**不会自动生成语义向量或 FAISS 索引**。如果你发现搜索结果僵硬、无法理解“API调试日志”和“后端故障复盘”之间的关联，大概率是因为还没开启向量化能力。
启用步骤很简单但容易跳过：
- 进入【系统设置】→【知识库管理】→【新建知识空间】
- 在高级选项中，必须勾选
启用向量化索引 - 嵌入模型要选
bge-m3-local-v2（其他模型如text-embedding-v1在本地模式下可能不可用或降级为关键词匹配） - 点击【保存并初始化】后，需等待状态栏显示“索引服务就绪”，不是“上传完成”或“解析完成”
向量索引只对“已解析完成”的文档生效
即使开启了向量化，WorkBuddy 也不会立刻为所有历史文件生成向量。它只对满足以下条件的文档触发嵌入计算：
- 文档已通过上传流程进入知识空间，且状态为
已解析（不是上传中或解析异常） - 文档格式被支持：Markdown、PDF（非扫描版）、TXT、DOCX；纯图片或未 OCR 的 PDF 不参与向量化
- 文档内容长度 ≥ 128 字符 —— 太短的笔记（比如只有标题的空文件）会被跳过
- 上传时未勾选
跳过OCR（对 PDF/图片类）或强制重解析（对已上传但解析失败的）
常见误判：看到“解析完成”就以为能语义搜索了，其实只是文本抽出来了，向量还没算。
搜索时实际走哪条路径？看 search_mode 参数
WorkBuddy 的搜索行为不是固定的，而是由当前任务上下文隐式决定。你调用不同指令，底层走的其实是两套完全不同的检索通道：
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
- 自然语言提问（如：“哪些笔记提到固态电池但没提换电？”）→ 默认走
vector + hybrid rerank模式，依赖向量索引 + 关键词重排序 - 使用
读取xx/文件夹下所有.md文件这类结构化指令 → 走纯文件系统遍历，绕过向量索引，哪怕你开了也没用 - 在知识空间内点【搜索框】输入关键词 → 默认是
keyword-only，除非你在设置里手动切换为“语义搜索”
也就是说：向量化索引存在 ≠ 每次搜索都用它。要不要用、怎么用，取决于你发的是什么指令、在哪发的、有没有显式指定模式。
向量索引更新不是实时的，有延迟窗口
新上传一个文件，从“上传完成”到“能在语义搜索中命中”，中间存在约 30–90 秒的处理延迟。这不是卡顿，而是 WorkBuddy 把向量生成放在后台异步队列里批量执行的。尤其当一次上传 20+ 文件时，最后几个文档的向量可能比第一个晚一分多钟才就绪。
验证是否已就绪最直接的方法是：
- 进知识空间 → 【文档列表】→ 找到目标文件 → 看右侧标签栏是否有
vec:ready标记 - 没有这个标记，说明还没生成向量，此时用自然语言搜它，大概率漏掉
- 别依赖“上传成功”弹窗，那个只代表文件存进去了
真正影响语义搜索效果的，从来不是模型多大，而是向量有没有生成、有没有被正确挂载到索引里 —— 这一步最容易被当成“自动完成”而忽略确认。
