知识库挂载与私有文档导入需通过四类路径实现：一、在管理员后台挂载本地文件夹或Obsidian仓库并开启实时同步；二、多通道批量上传文档，支持拖拽、钉钉/企微同步；三、命令行工具导入高敏感文档，强制数字签名校验；四、通过OpenClaw协议挂载Confluence等第三方知识源。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望将本地积累的行业资料、项目文档或内部规范纳入WorkBuddy的AI理解范围，但系统无法自动识别或关联这些文件，则可能是由于知识库尚未完成挂载或文档未被正确导入。以下是实现知识库挂载与私有文档库导入的具体操作路径：
一、理解知识库挂载功能的核心机制
知识库挂载并非简单链接文件路径，而是通过建立文档元数据索引与语义向量空间的双向映射，使WorkBuddy在执行问答、摘要或推理任务时，能实时检索并融合挂载文档中的上下文信息。该功能依赖于后台NLP模型对文档结构、实体关系与领域术语的深度解析，挂载成功后文档将进入可被自然语言指令直接调用的“激活态”。
1、进入WorkBuddy管理员后台，点击【知识库】→【知识空间管理】。
2、选择目标知识空间（如“法务合规中心”），点击右侧【挂载设置】按钮。
3、在挂载源类型中，勾选【本地文件夹】或【Obsidian仓库】选项。
4、点击【浏览】按钮，定位至含文档的根目录（例如：D:\InternalDocs\Legal），确认路径不含中文、空格及特殊符号。
5、开启【实时同步】开关，系统将监听该路径下新增/修改文件，并在30秒内自动触发解析队列。
二、通过多通道批量导入私有文档库
WorkBuddy支持四类互不冲突的导入方式，适配不同组织规模与安全策略，所有方式均默认启用OCR增强与段落级语义切分，确保扫描件、PDF表格及非结构化文本均可被准确索引。
1、在已挂载的知识空间内，点击【上传文档】按钮。
2、拖入本地文件夹（单次≤50个文件，总大小≤200MB），或点击【从钉钉/企业微信同步】拉取已授权的共享文档库。
3、上传完成后，状态栏显示“正在解析中”，此时系统自动执行文本抽取、标题识别与关键实体标注。
使用聊天补全、重试、结构化输出和明确的 User-Agent 标头运行 AIMLAPI LLM 与推理工作流，适用于 Codex 对 AIMLAPI 模型进行脚本化提示/推理调用的场景。
4、解析完成提示出现后，点击【查看解析结果】核验章节结构还原度与敏感字段脱敏效果。
三、使用命令行工具导入高敏感文档集
针对金融、医疗等强监管行业，需绕过图形界面直连本地存储，避免中间缓存风险。该方式强制校验文档数字签名与哈希值一致性，仅允许白名单证书签发的技能包访问指定目录。
1、打开终端（Windows使用PowerShell，macOS使用Terminal），执行workbuddy kb mount --path /secure/docs/legal --cert /certs/internal-ca.crt。
2、系统返回绿色提示：挂载成功：/secure/docs/legal 已绑定至知识空间「合规审计库」，启用FIPS-140加密通道。
3、执行workbuddy kb ingest --batch legal_q1_2026.zip --mode strict启动严格模式导入，拒绝任何未通过Schema校验的XML/JSON元数据文件。
4、日志输出末尾显示✅ 100% processed | 237 files indexed | 0 errors即表示全部文档已进入向量数据库。
四、通过OpenClaw兼容协议挂载第三方知识源
当已有Confluence、Notion或自建Elasticsearch知识库时，无需迁移数据，只需配置MCP标准适配器，即可将远程知识源以只读方式挂载为WorkBuddy的扩展语义层，所有查询请求经由沙箱代理转发，原始数据不出域。
1、在【知识库】→【外部源管理】中点击【添加MCP连接器】。
2、选择预置模板“Confluence Cloud”，填入OAuth2.0 Client ID与Access Token。
3、在空间过滤器中输入key:FIN-REG,TEAM-COMPLIANCE，限定仅挂载指定Confluence空间。
4、点击【测试连接】，收到连接成功：检测到12个页面，最近更新时间2026-04-11T15:22:03Z提示后，保存配置。
