MIS 记忆引擎

项目地址：

GitHub: FSWei/hermes-mis
License: MIT

开发时间：

2026.06 - 2026.09（当前 v4）

MIS — Memory-Index-Skill

给 LLM 装一套"写得进去、找得到、不过期"的两层记忆系统，带实时写拦截和违规自动修复。

---

项目概述

MIS（Memory-Index-Skill） 是 Hermes Agent 的 MemoryProvider 插件，把默认的扁平记忆替换成两层受管架构：

• Layer 1 · Active（MEMORY.md）：永远注入 system prompt（约 2,200 字符），只放索引行：§项目：see skill xxx
• Layer 0 · Registry（registry.json）：结构化 JSON 存有生命周期的实体（项目 / 服务器 / 设备）

核心不是"多一层存储"，而是写入时的代码级管控：格式、长度、结构、死引用全部校验；违规不直接丢弃，而是给出修复路径（缩短 / 匹配已有 skill / 新建 skill / 强制写入）。

---

核心功能

• 实时写拦截：写入前 check 校验格式 / 长度 / 结构 / 引用
• 违规自动路由：可选 shorten / match_skill / create_skill 四种处理策略
• 自动 skill 路由：超出记忆容量的细节自动降级到 Skill
• Registry：结构化实体管理（增删改查 + Dashboard 生成）
• 统计与归档：活跃 / 归档分层，容量可视化
• 双语文档：README + 中文文档

📸 截图待补：Dashboard 面板 / stats 输出（运行后补图）

---

技术栈说明

部分	说明
语言	Python
宿主	Hermes Agent（MemoryProvider 插件）
存储	Markdown（MEMORY.md）+ JSON（registry.json）
机制	写入拦截 → 校验 → 路由
许可	MIT

---

项目架构

hermes-mis/
├── 插件入口              # MemoryProvider 接口实现
├── check.py              # 写入前校验（格式/长度/结构/死引用）
├── registry.py           # Layer 0：结构化实体
├── archive.py            # 归档层
├── dashboard.py          # 生成可视化面板
├── README.md / README.zh-CN.md
└── LICENSE               # MIT

---

开发历程

阶段	版本	内容
起步	v1	两层存储雏形
强化	v2-v3	写入校验、违规路由
当前	v4	实时拦截 + 四种修复策略 + Registry + Dashboard

为什么做它：LLM 的记忆天然是"往回塞文本"，塞多了就互相污染——索引 + 分层 + 写入闸门才是能长期维护的结构。