若AI无法准确回答个人文档问题，需检查知识库导入与索引：一、命令行批量导入；二、WebUI拖拽上传；三、配置目录自动监听；四、手动注入MEMORY.md；五、挂载外部只读目录。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已部署Hermes Agent但AI无法准确回答基于您个人文档的问题，则可能是知识库未正确导入或索引未建立。以下是让AI真正读懂您私人数据的多种文档导入方法：
一、使用 hermes rag import 命令批量导入
该方法适用于结构清晰的本地文档目录，通过命令行直接触发向量化索引构建，是RAG知识库最标准的初始化方式。
1、确保知识文档已按分类存放于统一路径，例如 /home/user/knowledge/internal/；
2、执行创建知识库集合命令：hermes rag create --collection internal-docs --label "内部文档问答"；
3、运行导入指令并启用递归扫描：hermes rag import /home/user/knowledge/internal/ --collection internal-docs --recursive；
4、等待终端输出 "Indexing completed. 127 chunks embedded." 类似提示，表示向量索引已生成。
二、通过 WebUI 拖拽上传单文件
该方法适合临时添加少量高优先级文档，无需命令行操作，所有处理在浏览器中完成，且支持即时预览解析效果。
1、启动Web界面：hermes webui，在终端查看输出的访问地址（如 http://localhost:8000）；
2、用浏览器打开该地址，点击左侧导航栏的 "Knowledge" 选项卡；
3、在右侧区域找到 "Upload Document" 区域，将PDF或Markdown文件直接拖入虚线框内；
4、上传完成后，页面显示 "Processing... → Ready" 状态，此时该文档已进入向量数据库并可被检索。
三、配置自动监听目录实现增量同步
该方法用于长期维护场景，使Hermes Agent持续监控指定文件夹，一旦新增或修改文档即自动触发解析与索引更新，无需人工干预。
1、编辑配置文件：nano ~/.hermes/config.yaml；
2、在 rag: 节点下添加监听配置段落：watch_paths: ["/home/user/knowledge/auto-import"]；
3、确保目标路径存在且已放入至少一个测试文档，例如 /home/user/knowledge/auto-import/合同模板_v2.md；
4、重启服务使监听生效：hermes stop && hermes start；
5、观察终端日志中是否出现 "Detected new file: 合同模板_v2.md → indexing..." 字样。
四、手动注入纯文本片段至 MEMORY.md
该方法适用于非结构化关键信息（如会议结论、临时决策、口头约定），绕过文件解析流程，直接写入长期记忆层，确保AI在任何会话中均可调用。
1、定位记忆主文件：~/.hermes/MEMORY.md；
2、在文件末尾插入带时间戳的条目，格式为：- [2026-04-27] 客户张伟确认Q3交付周期可延至9月15日，需同步法务审核补充条款。；
3、保存文件后，在任意对话中输入 “客户张伟的交付时间是什么时候？”，AI将立即引用该条目作答；
4、注意：每条记录必须以短横线 - 开头，且不得包含YAML语法符号（如冒号后紧跟空格）。
五、挂载外部目录为只读知识源
该方法适用于保护原始资料不被AI修改，同时允许其读取内容参与RAG检索，特别适合接入网盘同步目录或公司共享文件夹。
1、在沙箱配置中声明挂载点：编辑 environments/hermes_swe_env/hermes_swe_env.py；
2、向 mount_points 字典添加新映射："/mnt/shared": {"path": "/Volumes/MyCloud/Company_Policy", "mode": "ro"}；
3、重启Agent后，在CLI中执行：hermes rag create --collection policy --label "公司制度"；
4、导入时指定挂载路径：hermes rag import /mnt/shared/ --collection policy --recursive；
5、验证结果：AI可检索该目录下所有PDF制度文件，但任何write操作均返回 "Permission denied: read-only mount" 错误。
