workbuddy离线语义搜索必须提前构建向量化索引，需在【系统设置→知识库管理→新建知识空间】中勾选“启用向量化索引”、选择bge-m3-local-v2模型，等待状态栏显示“索引服务就绪”，且文档须为支持格式、≥128字符、解析完成。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
WorkBuddy离线搜索能用，但必须提前完成本地知识库的向量化索引构建，否则只能进行关键词匹配，搜不出同义表述或语义相关的内容。
确认是否已启用向量化索引
进入【系统设置】→【知识库管理】→【新建知识空间】，在高级选项中检查“启用向量化索引”是否已勾选。若未勾选，该空间永远无语义搜索能力，所有提问都退化为字符串扫描。
嵌入模型必须选 【bge-m3-local-v2】，其他模型在本地模式下可能不可用或自动降级为关键词匹配。
点击【保存并初始化】后，务必等待状态栏显示“索引服务就绪”，不是“上传完成”或“解析完成”。此状态未出现前，任何文档上传都不会触发嵌入计算，只是排队静默丢弃。
上传文档前的关键准备
确保文档格式被支持：.doc/.xls 等旧格式默认不参与向量化，需转为 .docx/.xlsx 或 PDF 后重传。
PDF 类型影响极大——纯文本 PDF 可勾选跳过OCR；但扫描件类 PDF 必须关闭该选项，否则解析结果为空白，向量化输入为零向量。
文档内容长度需 ≥128 字符才生效。短于该阈值的文件（如仅标题页、单行说明）不会被送入嵌入队列。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
离线状态下验证搜索是否可用
第一步：关闭网络连接，确认状态栏显示“离线中”标识。
第二步：打开聊天窗口，输入自然语言问题，例如“最新差旅报销标准是什么”。
第三步：观察响应是否高亮显示金额上限与票据要求等具体条款——若只返回文档标题或空结果，说明向量索引未就绪或文档未被成功嵌入。
注意：上传后不要立即提问，系统有约 3–8 秒延迟将解析文本送入嵌入队列，期间查不到是正常行为。
离线索引失败的快速排查路径
方法一：检查知识空间是否处于「激活」状态。未启用的知识空间会静默丢弃所有向量化任务，界面无提示。
方法二：查看日志面板（非主界面），确认是否有模型加载失败记录。bge-m3-local-v2 首次运行需下载约 1.2GB 权重文件，网络中断或磁盘空间不足会导致初始化卡在“就绪”前。
方法三：核对默认缓存路径：%LOCALAPPDATA%\WorkBuddy\embeddings（Windows）或 ~/Library/Caches/WorkBuddy/embeddings（macOS），确认该目录下是否存在非空的 embeddings 文件夹。
