hermes agent本地知识库支持五种操作路径：一、命令行批量导入rag知识库；二、webui拖拽上传单文件；三、配置自动监听目录实现增量同步；四、手动注入关键文本至memory.md；五、挂载obsidian仓库作为结构化知识源。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已部署 Hermes Agent 但发现其无法调用或检索您本地存储的笔记、文档或结构化数据，则可能是知识库未正确挂载、路径未识别或索引机制未激活。以下是实现本地知识库有效支持的多种操作路径：
一、启用 RAG 知识库并执行命令行批量导入
该方法通过 hermes rag 子命令直接触发向量化索引构建，适用于已有分类清晰的本地文档目录，是初始化私有知识库最可靠的方式。
1、确保文档已存放于统一路径，例如 /home/user/docs/legal/ 或 C:\Users\yourname\Documents\knowledge\tech\。
2、运行创建集合指令：hermes rag create --collection legal-references --label "法律条文与判例"。
3、执行递归导入：hermes rag import /home/user/docs/legal/ --collection legal-references --recursive。
4、等待终端输出类似 "Indexing completed. 89 chunks embedded." 的确认信息。
二、通过 WebUI 拖拽上传单文件至知识库
该方式绕过命令行依赖，适合临时添加高优先级 PDF 或 Markdown 文件，并可即时验证解析效果与检索可用性。
1、在终端执行 hermes webui 启动界面，记下输出地址（如 http://localhost:8000）。
2、浏览器访问该地址，点击左侧导航栏的 Knowledge 选项卡。
3、在右侧 "Upload Document" 区域，将目标文件直接拖入虚线框内。
4、上传完成后，状态栏显示 Processing → Ready 即表示文档已进入向量数据库。
三、配置自动监听目录实现增量同步
此方案使 Hermes Agent 持续监控指定文件夹，一旦新增或修改文档即自动触发解析与索引更新，适用于长期维护型知识库。
1、编辑配置文件：nano ~/.hermes/config.yaml（Windows 用户使用 notepad++ 打开 %USERPROFILE%\.hermes\config.yaml）。
2、在 rag: 节点下添加监听路径：watch_paths: ["/home/user/knowledge/auto-import"]。
3、确保该路径存在且至少含一个测试文件，例如 /home/user/knowledge/auto-import/会议纪要_20260514.md。
4、重启服务：hermes stop && hermes start。
5、检查终端日志是否出现 Detected new file: 会议纪要_20260514.md → indexing 字样。
四、手动注入关键文本至 MEMORY.md 长期记忆层
该方法跳过文件解析流程，直接将非结构化但高价值的信息（如口头约定、临时决策、会议结论）写入内置记忆系统，确保跨会话可调用。
1、定位文件路径：~/.hermes/state/MEMORY.md（Windows 对应 %USERPROFILE%\.hermes\state\MEMORY.md）。
2、用文本编辑器打开该文件，在末尾新增区块，格式为：
---
date: 2026-05-14T18:42:00Z
source: manual-injection
tags: [urgent, meeting]
---
客户确认放弃2026年Q2违约金索赔，以签署新补充协议为前提。
3、保存文件后，无需重启服务，下次对话中即可被自然语言检索命中。
五、挂载 Obsidian 本地仓库作为结构化知识源
该路径专为 Obsidian 用户设计，支持双向链接解析、frontmatter 提取与 vault 内路径语义映射，实现原生笔记生态无缝接入。
1、运行 hermes setup 启动配置向导，选择 知识库路径 选项。
2、输入 Obsidian 仓库绝对路径，例如 /Users/yourname/Library/Mobile Documents/iCloud~md~obsidian/Documents/MyVault（macOS）或 C:\Users\yourname\Documents\Obsidian Vaults\MyVault（Windows）。
3、确认后，Hermes 将在该目录下自动生成 .hermes 子目录，并写入 vault_config.json。
4、编辑 config.yaml，将 file_watcher.enabled 设为 true，并在 watch_paths 中添加 notes/ 或 01_日常/ 等子路径。
5、重启服务并运行 hermes watch --status，验证监听状态为 active。
