# WorkBuddy 建立本地知识库完整实操步骤＞ ＞ WorkBuddy 有两种本地知识库模式：**客户端内置向量知识库（最简单，推荐个人）**、**WeKnora 本地向量服务（高敏感数据

WorkBuddy 建立本地知识库完整实操步骤WorkBuddy 有两种本地知识库模式客户端内置向量知识库最简单推荐个人、WeKnora 本地向量服务高敏感数据Docker 部署腾讯云。支持格式pdf、docx、md、txt、csv扫描图片 PDF 无法识别需要先 OCR 转文字。方案一WorkBuddy 桌面客户端内置本地知识库零 Docker优先用向量索引、文档元数据存储在本机原始文件保留在你电脑磁盘不上传云端腾讯云代码...。步骤 1准备环境与文档安装最新版 WorkBuddy 桌面客户端登录账号。电脑新建专门文件夹例如D:\WorkBuddy_Knowledge把你的资料全部放入该文件夹。文档预处理长文档建议拆分单文件尽量控制在 100 页以内扫描版 PDF 必须 OCR 转为可复制文字 PDF否则解析为空md/txt 格式解析效果最好优先使用腾讯云开发...。步骤 2新建知识库打开 WorkBuddy 左侧菜单栏找到【知识库】模块没有就点更多展开腾讯云。点击【新建知识库】填写名称如 “ERP 项目资料库”描述简单备注用途务必勾选【启用向量化索引】RAG 检索核心不勾选无法语义问答其余高级参数保持默认不要修改切片大小、重叠度新手默认最优。点击创建。步骤 3导入本地文档2 种导入方式方式 A直接上传文件复制文档入库副本进入刚建好的知识库点击【上传文件】可以批量拖拽文件选择 D:\WorkBuddy_Knowledge 里面的 pdf/docx/md/txt 文件确认上传系统自动执行文档解析 → 文本清洗切分 → 生成向量索引。文件越大处理时间越长几十页 PDF 几十秒上百页 PDF 需要 3‑5 分钟等待状态栏显示【处理完成】不要中途关闭软件。方式 B绑定本地文件夹实时监控推荐原始文件不复制文件变更自动重索引在知识库详情页找到【绑定本地文件夹】选择你提前建好的文件夹D:\WorkBuddy_Knowledge开启【监控文件夹变更自动更新索引】⚠️重要弹窗授予 WorkBuddy 文件夹访问权限之后你直接在电脑文件夹新增 / 修改 / 删除文档知识库自动同步不需要重复上传腾讯云开发...。步骤 4配置对话调用规则关键否则 AI 不会读知识库进入知识库设置页面勾选对话优先检索本知识库内容召回数量默认 3‑5 条保持默认开启【回答附带原文引用来源】可以看到 AI 引用哪一段文档防止幻觉编造腾讯云。保存设置。步骤 5测试验证知识库是否生效新建对话会话两种调用方式全局开启的情况下直接提问请基于知识库回答ERP项目的完工百分比核算规则是什么手动指定知识库更稳妥使用【ERP项目资料库】知识库回答xxx问题✅正常现象回答底部出现来源引用链接可以点开跳转对应文档片段 ❌不读取知识库排查确认向量化索引已启用文档状态是处理完成文件夹权限已授予。步骤 6知识库日常维护绑定文件夹模式电脑本地修改文件自动更新向量上传副本模式修改源文件后需要在知识库内删除旧文件重新上传新版本不需要的文档直接删除向量索引同步清除。方案二WeKnora 本地私有化向量库Docker适合高度敏感企业资料数据完全本地不出机适用不想把任何文档片段经过公网需要本地独立向量服务电脑内存≥16G需要 Docker Desktop腾讯云。Windows 安装 Docker Desktop开启 WSL2 后端确认 Docker 引擎正常运行左下角绿色 running。新建独立目录例如D:\WeKnora下载官方 docker‑compose.yml 放到该目录。WinR 输入 cmd 打开命令行cd /d D:\WeKnora docker‑compose up ‑d等待镜像拉取执行docker ps确认 6 个容器全部正常运行。浏览器访问http://localhost:8080注册管理员账号新建知识库上传你的本地文档WeKnora 完成向量化。回到 WorkBuddy 客户端 → 设置 → 知识库服务选择【外部 WeKnora 服务】填写地址http://localhost:8080填入账号密码完成对接。之后 WorkBuddy 的 RAG 问答全部调用本机 WeKnora 向量库所有数据保存在本机 Docker 卷中不经过腾讯云端服务器腾讯云。常见踩坑 排错清单文档上传后处理失败扫描件 PDFOCR 转文字加密 PDF 先解密单文件不要过大。AI 回答完全不参考知识库还是大模型通用回答确认【启用向量化索引】勾选确认知识库对话检索开关打开提问指令带上 “基于本知识库回答”文档是否处理完成不是排队中。绑定文件夹读取不到文件Windows 安全拦截重新授予 WorkBuddy 文件夹读写权限路径不要有中文特殊符号。知识库检索结果差答非所问文档不要整本书一个大文件拆分成小节优先 md/txt不要把一堆无关文件全部塞进去知识库做主题拆分不要一个库装所有资料。快速最小验证提示词复制直接测试请完全基于当前绑定的本地知识库回答ERP项目投入法核算的分录是什么回答末尾标出引用来源片段。