本地知识库搭建指南：导入文档让AI读懂你的私人数据

如果你的Hermes Agent已经部署完成，但在处理基于个人文档的查询时频繁出现“理解偏差”或“信息缺失”，核心症结通常在于知识库的初始化阶段——AI模型尚未有效“消化”你的专属数据。这本质上是一个数据管道问题，只需确保信息被正确索引即可解决。以下五种经过验证的数据导入策略，将帮助你系统性地将私有数据“注入”AI的认知体系。

一、使用 hermes rag import 命令执行批量导入

这是执行大规模知识库初始化的标准操作，尤其适用于已具备结构化本地文档目录的场景。该命令能自动化完成文档解析、分块及向量化索引的全流程。

操作流程清晰：首先，将你的文档资源组织到特定目录，例如 /home/user/knowledge/internal/。随后，在终端中顺序执行：通过 hermes rag create --collection internal-docs --label "内部文档问答" 创建目标知识集合；紧接着运行 hermes rag import /home/user/knowledge/internal/ --collection internal-docs --recursive，启动对指定目录的递归扫描与导入。当终端显示 "Indexing completed. 127 chunks embedded." 类提示时，即表明向量索引已构建完毕，AI检索层已就绪。

二、通过 WebUI 界面进行拖拽式单文件上传

对于偏好图形化操作或需快速插入零星文档的用户，Web管理界面提供了更直观的解决方案。你可以在浏览器中完成上传并即时预览文档解析状态。

访问路径：启动Web服务（hermes webui），在浏览器中访问终端输出的地址（如 http://localhost:8000）。导航至左侧 "Knowledge" 模块，在右侧的 "Upload Document" 面板区域，直接将PDF或Markdown文件拖入虚线框。界面将反馈 "Processing..." 状态，处理完成后更新为 "Ready"。至此，文档内容已进入向量数据库，可供查询调用。

三、配置目录监听以实现增量数据同步

在文档持续迭代的业务环境中，手动重复导入效率低下。配置目录监听功能可实现自动化增量索引，确保知识库与源文件实时同步。

配置步骤：编辑主配置文件 nano ~/.hermes/config.yaml。定位至 rag: 配置段，新增一行：watch_paths: ["/home/user/knowledge/auto-import"]。请确保该目录路径已存在，并可预先放入测试文件。配置生效需重启服务（hermes stop && hermes start）。此后，观察服务日志，若出现 "Detected new file: 合同模板_v2.md → indexing..." 类记录，则证明自动化监听与索引机制已正常运行。

四、向 MEMORY.md 手动写入结构化文本片段

对于非正式文档形态的关键信息（如会议决议、临时备忘），可直接将其以结构化格式写入AI的持久化记忆文件，绕过常规文档解析流程。

操作方法：直接编辑核心记忆文件 ~/.hermes/MEMORY.md。在文件末尾，遵循既定格式追加条目，示例：- [2026-04-27] 客户张伟确认Q3交付周期可延至9月15日，需同步法务审核补充条款。 保存后信息即刻生效。当后续对话询问“客户张伟的交付时间是什么时候？”时，AI将直接引用此条记录。关键格式规范：每条记录以短横线 - 起始，并应避免在内容中使用可能干扰解析的YAML特殊字符。

五、挂载外部目录作为只读知识源

当源数据位于第三方存储（如网络存储、共享目录）且需确保其不可篡改时，可采用只读挂载方案。这使AI具备读取权限以构建索引，同时从物理层面阻止任何写入操作。

实施路径：编辑环境配置文件，通常位于 environments/hermes_swe_env/hermes_swe_env.py。在 mount_points 字典中新增映射项，例如："/mnt/shared": {"path": "/Volumes/MyCloud/Company_Policy", "mode": "ro"}。此举将外部公司政策目录以只读模式挂载至Agent内部的 /mnt/shared 路径。重启Agent后，即可为该路径创建知识集合并导入文档。效果验证：AI可正常检索引用该处文件，但任何写入尝试均会触发 "Permission denied: read-only mount" 错误，从而保障源文件安全。