WorkBuddy 知识库完整管理与维护实操步骤区分两种模式客户端内置本地知识库个人常用、WeKnora 外部向量库Docker 私有化下面全部是客户端可直接点击操作不含虚设命令。一、知识库基础管理新建 / 编辑 / 删除 / 复制进入知识库管理面板左侧导航栏 →【知识库】显示全部知识库列表。修改知识库基础信息点击目标知识库进入详情页 → 右上角【设置】修改知识库名称、描述不要随意修改切片大小、重叠度分块参数改动会触发全量重新向量化消耗时间。复制知识库做版本备份列表条目右侧「・・・」更多按钮 →【复制】生成一份独立副本适合做版本快照修改副本不影响原库。删除知识库列表「・・・」→【删除】⚠️删除知识库同时清空向量索引、库内所有文档元数据上传文件模式库内副本被删除你电脑原始文件不受影响绑定本地文件夹模式仅解除绑定本地磁盘文件完全保留。❗不要直接在磁盘删除.workbuddy缓存文件夹会损坏全部知识库索引腾讯云。二、文档生命周期维护两种导入模式操作不一样模式 A上传文件模式文档复制入库副本文件拷贝一份到 WorkBuddy 内部存储不会自动跟随本地源文件更新新增文档知识库内【上传文件】拖拽 pdf/docx/md/txt等待状态变为处理完成。更新修改后的文档① 在知识库文档列表删除旧版本文档 ② 重新上传修改后的新文件 ③ 系统自动解析 重建该文档向量索引。直接修改电脑本地源文件不会自动同步到知识库必须重新上传。单文档删除文档列表选中文档点删除该文档对应的向量片段同步清除。模式 B绑定本地文件夹模式推荐监控本地目录不复制文件直接读取你电脑文件夹开启监控自动同步变更新增文件直接把文件放到绑定的本地文件夹WorkBuddy 自动检测、解析、向量化。修改已有文件本地编辑保存客户端检测到文件变更自动重新解析重建向量。删除文件本地文件夹删除该文件知识库自动移除该文档和向量索引。更换绑定目录知识库设置 →【解除文件夹绑定】再重新选择新目录。⚠️关键坑点文件夹路径不要中文特殊符号、不要放在系统保护目录Windows 必须授予 WorkBuddy 该文件夹读写权限WorkBuddy 软件运行过程中不要移动、重命名绑定的根文件夹会直接断连如需移动先解除绑定移动磁盘文件夹再重新绑定新路径。扫描版 PDF 无法解析只会空白需要先 OCR 转文字 PDF。三、知识库检索参数调优RAG 核心维护进入知识库详情→【设置】这里控制 AI 怎么调用知识库直接影响问答质量。对话检索开关✅勾选对话优先检索本知识库内容不勾选对话不会自动读取该库只能手动指令指定知识库。召回数量默认 3‑5 条文档体量很大可调到 6‑8小知识库保持默认。相似度阈值最小匹配分数默认 0.45阈值越高只召回高度匹配片段减少幻觉但容易回答无结果阈值越低召回更多片段更容易出现无关内容混入。ERP、财务这种严谨业务建议调到 0.55‑0.6降低编造风险。开启【回答附带原文引用来源】强烈建议打开AI 回答底部会显示文档来源片段用来校验 AI 是否瞎编。保存设置。测试指令直接复制请完全基于本知识库回答输出内容末尾带上引用来源片段知识库找不到的内容直接说不知道不要编造信息。四、知识库内容质量维护日常运维动作1、查看文档状态排查异常知识库文档列表查看每个文档状态处理完成正常可用排队中等待解析大文件会耗时处理失败加密 PDF、扫描图片 PDF、文件损坏、文件过大。处理失败文档处理解密 PDFOCR 图片 PDF拆分超大文档重新上传。2、手动触发全量重新向量化当你修改了知识库切片参数或者怀疑向量索引错乱 知识库设置页找到【重建全部向量索引】按钮点击执行。大库会耗时很久不要中途关闭客户端。3、知识库内容定期清理建议每 1‑3 个月执行一次删除过期、作废制度、旧版本文档合并重复内容超大文档拆分成小节文档单文件建议≤100 页把不同主题拆分为多个独立知识库不要几百份文档全部塞一个库检索精度会下降。实操校验指令一键做知识库体检遍历当前知识库全部文档输出清单文档名称、文档状态、是否疑似过时标记重复文档列出处理失败的文档。五、WeKnora 外部本地向量库维护Docker 私有化部署如果你对接的是 WeKnora 本地向量服务而不是 WorkBuddy 内置向量库浏览器访问http://localhost:8080进入 WeKnora 后台做文档增删改查、重建索引WorkBuddy 客户端【设置】→【知识库服务】保持外部 WeKnora 地址配置维护 Docker 容器# 查看容器运行状态 docker ps # 重启向量服务 docker‑compose restart不要直接删除 docker 卷否则全部向量数据丢失。六、常见故障维护排查清单AI 完全不读取知识库输出通用大模型答案① 确认知识库【启用向量化索引】已勾选 ② 确认文档状态全部是【处理完成】无排队 / 失败 ③ 确认【对话优先检索本知识库】开关打开 ④ 提问带上指令请基于XX知识库回答 ⑤ 如果修改过分块参数执行重建全部向量索引。绑定本地文件夹新增文件识别不到① 确认 Windows 给 WorkBuddy 文件夹读写权限 ② 确认文件夹路径没有被移动重命名 ③ 解除绑定重新绑定一次目录 ④ 重启 WorkBuddy 客户端。回答经常答非所问、幻觉编造① 调高相似度阈值 ② 拆分大文档按章节拆小文件 ③ 开启引用来源每次核对来源片段 ④ 提问尽量给出关键词文档名称、条款名称。知识库占用磁盘越来越大清理废弃文档删除不再使用的知识库绑定文件夹模式磁盘占用主要来自你的原始文件上传模式副本会占用存储及时删除废弃上传副本。七、最佳维护工作流适合 ERP / 财务专业知识库资料按业务主题拆分多个知识库不要大一统优先使用绑定本地文件夹模式本地文件夹做版本管理开启引用来源每次重要问答核对来源片段每 2 个月做一次知识库体检清理过期文档检查处理失败文档修改知识库分块参数后必须重建全部向量索引。