Hermes Agent周期性微调未生效需检查五方面：一、启用Nudge信号触发器；二、验证Background Review子系统状态；三、检查USER.md与MEMORY.md写入权限；四、校验Honcho个性化层激活；五、监控nudge.log日志流。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您正在使用Hermes Agent，却发现它未能持续优化过往交互中的有效经验，则可能是周期性微调机制未被正确触发或配置。以下是实现该机制自动运行的具体方法：
一、启用Nudge信号触发器
Nudge是Hermes Agent中负责发起周期性学习动作的核心轻量信号，每完成10个对话turn即自动生成一次“该学习了”的提示，驱动后台启动记忆整理流程。该机制不依赖用户主动指令，而是由系统内部计数器自主判断执行时机。
1、确认当前会话已累计执行满10个turn（每个用户提问+Agent响应计为1个turn）。
2、检查hermes config show输出中nudge.enabled字段值是否为true。
3、若为false，执行hermes config set nudge.enabled true并重启Agent进程。
二、验证Background Review子系统状态
Background Review是承接Nudge信号并执行实际记忆整理的子系统，负责扫描近期会话日志、提取隐式知识、更新USER.md与MEMORY.md两个核心记忆文件。它仅在Nudge触发后异步运行，不占用主推理线程。
1、运行hermes status命令，观察background_review行是否显示active。
2、若状态为inactive，手动执行hermes review run --force强制启动一次整理。
3、查看logs/background_review.log末尾是否有Completed memory consolidation for session_*成功标记。
三、检查双文件存储写入权限
Hermes Agent的记忆固化依赖于实时写入USER.md（用户画像层）与MEMORY.md（持久记忆层）两个Markdown文件。若文件所在目录无写权限，或磁盘空间不足，将导致微调结果无法落地，表现为“有触发、无更新”。
1、定位记忆文件路径：hermes memory path，通常为~/.hermes/memory/。
2、执行ls -l ~/.hermes/memory/USER.md ~/.hermes/memory/MEMORY.md，确认文件存在且属主为当前用户。
3、运行df -h ~/.hermes/memory，确保可用空间大于50MB。
四、校验Honcho个性化层激活状态
Honcho组件承担辩证式用户建模任务，是周期性微调中构建用户心智模型的关键模块。其仅在显式激活后才参与每次Background Review的记忆提炼过程，否则仅执行基础文本归档。
1、执行hermes memory setup，该命令将初始化Honcho所需的向量索引与偏好映射表。
2、检查~/.hermes/honcho/目录下是否存在profile_index.faiss与preference_graph.json两个文件。
3、若缺失任一文件，重新运行hermes memory setup --rebuild并等待完成提示。
五、监控Nudge执行日志流
所有Nudge信号的生成、分发与响应均被记录在独立日志通道中，可用于快速定位微调中断环节。该日志不混入常规会话日志，具备专属时间戳与事件类型标识。
1、执行tail -f ~/.hermes/logs/nudge.log保持实时监听。
2、发起连续对话直至出现TURN_COUNT_REACHED: 10 → dispatching NUDGE条目。
3、紧随其后应出现NUDGE_RECEIVED → forwarding to background_review，若缺失此行，则表明信号路由失败。
