WorkBuddy本地知识库索引在创建知识空间时自动构建，需勾选“启用向量化索引”并选择bge-m3-local-v2模型，保存后触发FAISS初始化，状态栏显示“索引服务就绪”才真正生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
WorkBuddy 的本地知识库索引不是“安装”出来的，而是创建知识空间时由系统自动构建并初始化的——你不需要手动下载、编译或配置 FAISS/Chroma 等向量数据库，启用向量化索引 就是全部动作。
知识空间初始化即触发索引构建
WorkBuddy 的向量索引服务（基于 bge-m3-local-v2 模型 + 本地 FAISS）在保存知识空间时才真正启动。如果你跳过「启用向量化索引」勾选，后续上传文档只会走关键词检索，无法支持语义搜索。
- 必须在【新建知识空间】→【高级选项】中主动勾选
启用向量化索引，否则该空间永远无向量能力 -
开启上下文窗口扩展(128 tokens)是可选但强推荐项：它让模型在 chunk 切分时保留前后文，避免段落被硬截断导致语义丢失 - 状态栏显示“索引服务就绪”前，任何文档上传都不会触发嵌入计算；此时上传只是排队，不会报错也不会提醒
- 首次初始化耗时取决于设备性能，Windows 中端笔记本通常需 40–90 秒，macOS M1/M2 约 25–60 秒
上传文档后不自动索引？先看这三件事
常见现象是文档上传完成、解析也显示“成功”，但用自然语言提问却搜不到内容——大概率不是索引失败，而是卡在前置环节。
WorkBuddy Visio — Visio 兼容架构图生成器
下载
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
- 确认知识空间已处于「激活」状态：未启用的知识空间会静默丢弃所有向量化任务，界面无提示
- 检查文档格式是否被跳过：.doc/.xls 等旧格式默认不支持向量化，需转为 .docx/.xlsx 或 PDF 后重传
- PDF 类型影响极大：
跳过OCR勾选仅对纯文本 PDF 安全；扫描件类 PDF 必须关闭该选项，否则解析结果为空白，向量化输入为零向量 - 上传后不要立即提问：系统有约 3–8 秒延迟将解析文本送入嵌入队列，期间查不到是正常行为
bge-m3-local-v2 模型的实际约束
这个嵌入模型虽标称“本地”，但仍需首次运行时下载约 1.2GB 模型权重文件。若网络中断或磁盘空间不足，初始化会卡在“就绪”前，且错误信息只出现在日志面板（非主界面）。
- 默认缓存路径为：
%LOCALAPPDATA%\WorkBuddy\embeddings（Windows）或~/Library/Caches/WorkBuddy/embeddings（macOS） - 模型加载失败时，
索引服务就绪永远不出现，但上传文档仍能解析——只是不生成向量，表现为“能搜标题，搜不出同义表述” - 不支持切换为其他本地模型（如
text2vec-large-chinese），下拉菜单里只有bge-m3-local-v2可选，这是硬编码限制 - 768维向量固定不可调，不能通过参数压缩维度来换速度；小内存设备（≤4GB RAM）可能在批量上传时触发 OOM 并静默终止嵌入进程
最易被忽略的一点：WorkBuddy 的向量索引完全绑定知识空间生命周期。删除空间=彻底清除 FAISS 文件+嵌入缓存，没有「导出索引」或「迁移索引」功能。如果想复用已有向量结果，只能复制整个知识空间（通过后台数据库操作，非 UI 支持）。
