用途:作为 Hermes 智能体的“温”长期记忆层。MEMORY.md 与 USER.md 只是约 1300 token 的热缓存,永远在上下文中;wiki 存放在 ~/.hermes/wiki/,容量不限、由 git 跟踪,由操作员在 Hermy HQ 中浏览和编辑。
写入时机:完成复杂任务(5 次以上工具调用)后,向 log/YYYY-MM.md 追加一行;若有可复用经验,创建或更新 lessons/ 条目。操作员做出决定时,写 decisions/ 条目并记录理由与日期。学到比一句话更大的持久事实(项目、人物、业务)时,写 projects/、people/ 或 facts/ 条目。被纠正时更新相关条目,不删除旧值,而是标记 status: superseded 并补充新事实,保留历史。MEMORY.md 只保留约 10–20 条始终为真、高频使用的事实,并加一行指向 wiki 的说明。
条目格式:每个条目一个 markdown 文件,YAML frontmatter 加正文。frontmatter 字段包括 id、type(fact | preference | decision | event | project | contact | lesson | metric | note)、title、status(active | superseded | archived)、confidence(high | medium | low)、provenance(user-stated | observed | web | session:<id>)、tags、links、updated。文件按类型分目录存放于 projects/、people/、decisions/、lessons/、facts/、log/,并维护 INDEX.md(每条一行:id · title · type · updated)。
检索:回答前先扫描热注入的 INDEX.md 找条目 id;用 search_files ~/.hermes/wiki "<term>" 或 read_file 读取具体文件;仍不确定时用 session_search 查对话历史。只取需要的 1–2 个条目,不要加载整个 wiki。
维护:写入后执行 git -C ~/.hermes/wiki add -A && git commit -m "wiki: <what changed>"。永不破坏历史,用 supersede 而非覆盖。每晚的 wiki-consolidate cron 会合并重复项、降级过期条目并重建 INDEX.md,因此条目应保持小而单一用途。限制方面:资料未说明该 wiki 的独立收费或价格信息。