hermes agent个人知识库需完成五步结构化搭建：一、初始化本地环境并启用记忆功能；二、构建五层语义目录；三、激活四层记忆系统；四、导入文档并重建向量索引；五、配置自动化运维任务。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望将Hermes Agent作为个人“第二大脑”长期使用，但发现知识无法有效沉淀、检索迟滞或AI回答脱离上下文，则可能是知识库未完成结构化搭建或记忆系统未激活。以下是构建个人专属知识库的完整流程：
一、初始化本地环境与基础配置
该步骤确保Hermes Agent具备运行基础及中文交互能力，并为后续知识注入建立可信配置锚点。所有操作均在终端中执行，不依赖云端服务。
1、安装Hermes Agent主程序：执行命令 curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash；
2、启动配置向导：输入命令 hermes setup，在交互界面中选择语言为“中文”，启用“本地模型”选项，并开启“记忆功能”；
3、执行环境自检：运行 hermes doctor，确认输出中包含“Python 3.11+ OK”、“MEMORY.md loaded”、“config.yaml valid”三项状态提示。
二、构建五层知识目录结构
该结构遵循LLM Wiki方法论，通过固定前缀与语义分类实现机器可读性与人工可维护性的统一，避免文件夹嵌套过深导致索引失效。
1、在用户主目录下创建根目录：mkdir -p ~/knowledge-base；
2、依次建立五个标准子目录：mkdir ~/knowledge-base/01_项目 ~/knowledge-base/02_技术 ~/knowledge-base/03_参考 ~/knowledge-base/04_待办 ~/knowledge-base/99_归档；
3、为每个目录添加描述性README.md文件，内容需包含该类知识的定义边界与典型文档示例；
4、将已有资料按语义归属移入对应目录，禁止跨类存放，例如《2026Q2产品路线图》必须置于01_项目，不得放入03_参考。
三、激活四层记忆系统
四层记忆系统是Hermes区别于传统RAG工具的核心机制，分别承载静态规则、用户偏好、向量化知识与会话上下文，缺一不可。
1、编辑全局配置文件：nano ~/.hermes/config.yaml，在memory:节点下确认以下四项已启用：enable: true、load_memory_md: true、load_user_md: true、vector_db_enabled: true；
2、生成MEMORY.md：执行 hermes memory init，系统自动创建含基本信息、知识分类优先级、常用项目列表的模板；
3、编写USER.md：手动在~/.hermes/路径下新建USER.md，明确写入个人术语表（如“OKR=目标与关键成果”）、高频查询意图（如“帮我总结上周会议结论”）及禁用行为清单（如“不修改原始PDF文件”）；
4、验证记忆加载：运行 hermes chat 后输入“你记得我叫什么吗？”，应返回USER.md中定义的姓名字段值。
四、导入文档并建立向量索引
文档导入需匹配Hermes的RAG解析逻辑，仅支持UTF-8编码的纯文本格式，PDF/DOCX等二进制文件须经内置解析器转换为文本块后才可被索引。
1、创建知识库集合：执行 hermes rag create --collection personal-kb --label "个人知识库"；
2、批量导入目录：运行 hermes rag import ~/knowledge-base/ --collection personal-kb --recursive --chunk-size 512；
3、强制重建索引：输入 hermes rag rebuild --collection personal-kb，等待终端输出“Embedding completed for 842 chunks”；
4、测试检索准确性：在聊天界面输入“列出02_技术目录下所有关于向量数据库的笔记”，应返回含Milvus/Qdrant/Chroma关键词的Markdown文件名。
五、配置自动化运维任务
自动化运维保障知识库持续健康，避免人工整理断档导致信息熵增，所有任务均基于本地crontab或Hermes内置调度器触发。
1、设置每日索引校验：执行 hermes schedule add --cron "0 9 * * *" --command "hermes rag verify --collection personal-kb"；
2、启用孤岛笔记扫描：在config.yaml的lint:节点下添加 detect_orphaned_notes: true 并设 max_age_days: 90；
3、配置变更日志写入：启用 log_changes_to_index: true，确保每次文档增删均记录至~/.hermes/logs/index_changes.log；
4、验证定时任务：重启服务后执行 hermes schedule list，确认输出中包含“daily-index-verify”条目且状态为“active”。
