Hermes-Memory 本地向量记忆系统#

你的AI助手是不是每次聊天都像失忆了？ 这个skill就是解决这个问题的。

Hermes-Memory 给AI装上了长期记忆：记住你的偏好、持仓、策略、教训……下次聊天自动关联上下文，就像跟一个老朋友说话一样。

为什么用它？#

• 完全本地，隐私零风险 —— 数据存在你电脑上的SQLite文件里，不传任何云端
• 零成本 —— 不需要API Key，不需要付费服务，本地embedding模型免费跑
• 中文优化 —— 专用中文向量模型，搜索准确率远超英文通用模型
• 开箱即用 —— 安装依赖后直接使用，不需要额外启动数据库服务（不像Qdrant/Milvus那样需要单独部署）
• 越用越聪明 —— 自动去重、自动衰减过时记忆、实体关系图谱越建越丰富
• 类型自由定制 —— 内置交易、策略、教训等类型，也可以随时自定义任何新类型

和其他方案对比#

vs 纯文本记忆（MEMORY.md / 每日笔记）

纯文本是大部分AI助手的默认方案——把记忆写在Markdown文件里，每次对话让AI自己翻。

维度Hermes-Memory纯文本记忆查找方式语义搜索（"我之前说过什么止损规则"→精准命中）关键词匹配或全文翻阅记忆容量千条级，搜索毫秒级几百条就开始乱、遗漏去重向量相似度>0.95自动合并手动检查，重复越积越多过期处理自动衰减+归档永远在文件里，越堆越旧结构化按类型/实体/关系组织平铺在一个大文件里实体关系多跳图谱（某股→板块→策略→教训）无Token消耗只搜索需要的记忆，按需加载每次要把整个文件喂给AI

一句话： 纯文本适合记10条备忘；Hermes-Memory适合构建一个真正可用的知识库。

vs AGENTS.md 内置记忆逻辑

很多用户会在AGENTS.md里写一段记忆规则，让AI自己维护Markdown文件。这个方案能用，但有几个本质限制：

维度Hermes-MemoryAGENTS.md规则+Markdown存储引擎SQLite + 向量索引 + FTS5纯文本文件搜索能力向量语义搜索 + 全文搜索 + 关系查询只能靠AI逐行读文件可靠性确定性——CLI命令执行即写入，不依赖AI"记得去写"不确定——AI可能忘写、写错格式、漏写写入触发CLI工具一键写入（memdb.py add / memory_tool.py check）依赖AI每次对话后主动执行，无强制保证跨会话SQLite文件是唯一真相源，任何session读取一致多个daily note + MEMORY.md，容易不一致关系推理实体图谱支持多跳查询（"跟这只股票相关的所有教训"）无结构化关系，全靠AI自己关联自动维护decay归档+去重+export，cron一条命令搞定需要AI手动整理文件，容易堆积垃圾可扩展性类型自定义、关系自由扩展文件越大AI越容易遗漏

核心差异： AGENTS.md记忆规则是"靠AI自觉"——提示词让它记，但执行没有保证。Hermes-Memory是"工具保证"——CLI命令执行就写入，搜索就返回，不依赖AI的注意力。

vs 云端向量库（Qdrant / Milvus / Pinecone）

维度Hermes-Memory云端向量库部署难度pip install即可需要启动独立服务或注册云服务隐私安全✅ 完全本地⚠️ 需自建或信任第三方成本免费云服务按量计费 / 自建服务器成本大规模性能千条级优秀百万级优秀中文支持✅ 专用中文模型⚠️ 需额外配置embedding

一句话： 个人使用千条级别，Hermes-Memory更简单更安全；企业级百万条数据，上云端方案。

快速开始#

所有命令必须用 Python 3.12+（支持OpenSSL 3.0+），macOS推荐 /opt/homebrew/bin/python3.12。

bash

# 搜索记忆（语义搜索，支持中文）
python3 scripts/memdb.py search "止损策略" --limit 5

# 添加记忆
python3 scripts/memdb.py add "内容" --type portfolio --entity 某科技股

# 智能检测关键词并写入
python3 scripts/memory_tool.py check "用户说的内容"

# 建立实体关系
python3 scripts/memdb.py relate "某科技股" "属于" "医药板块"

# 查看实体关系（支持多跳）
python3 scripts/memdb.py relations "某科技股" --depth 2

# 统计
python3 scripts/memdb.py stats

记忆类型#

类型完全开放，可自由扩展。以下是内置推荐类型：

通用类型#

type用途示例preference用户偏好数据源用东财、回复用中文user-profile用户画像用户基本信息和背景fact事实/决策用户的重要决定note笔记其他lesson教训（带severity）缺乏风控导致亏损

交易/投资类型（内置，可按需使用）#

type用途示例portfolio持仓变动买入某科技股、清仓某消费股strategy策略规则主线共振策略买点、情绪周期L4market-view大盘/板块判断大盘缩量反弹，半导体主线trade-plan交易计划某股跌破MA20则止损stock-note个股研究笔记某股：行业龙头，产能扩张期watchlist关注标的关注某股回调至20日线review复盘结论本周操作：胜率40%，亏损来自追高

自定义类型： --type 参数接受任意字符串，无需预定义。根据你的使用场景自由创造类型：

bash

# 程序员用户可能用
type=bugfix type=architecture type=deploy

# 创作者用户可能用
type=idea type=draft type=publish

# 学生用户可能用
type=course type=exam type=schedule

实时写入规则#

每次回复用户后，检查是否有值得长期记住的信息：

关键词触发（用 memory_tool.py check）：

• 买了/卖了/加仓/减仓/清仓/建仓/止盈/止损 → portfolio
• 新策略/改策略/情绪周期/买点卖点 → strategy
• 纠正我/不对/错误/教训/踩坑 → lesson
• 以后用/记住/偏好/改用 → preference

LLM判断（直接用 memdb.py add）：

• 隐含信息（用户随口提到的新方向、生活变化）→ fact
• 重要决策 → fact
• 根据对话领域自适应选择类型，不限于上表
• 遇到新模式可创造新类型， --type 无白名单限制

判断标准： 这条信息1周后还有用吗？是→写入，否→跳过。

实体关系图谱#

写入记忆时，主动建立实体间关联：

bash

# 股票→板块
python3 scripts/memdb.py relate "某科技股" "属于" "医药板块"
# 策略→组件
python3 scripts/memdb.py relate "主线共振策略" "包含" "买点规则"
# 教训→应用
python3 scripts/memdb.py relate "某股亏损" "教训应用于" "止损规则"

自动维护#

• 衰减： memdb.py decay --days 30 标记30天未更新的记忆为expired
• 归档： memdb.py archive 将expired记忆移入archive表
• 导出： memdb.py export --dir ./entities 同步Markdown可读备份
• 导入： memdb.py import --dir ./entities 从Markdown导入

推荐Cron每晚23点执行：decay → export → stats。

CLI完整参考#

bash

# ── 记忆操作 ──
python3 scripts/memdb.py add "内容" --type <type> [--entity <实体>] [--severity high|medium|low] [--source manual|conversation|cron]
python3 scripts/memdb.py search "查询" [--type <type>] [--status active|expired] [--entity <实体>] [--limit N] [--format text|json]
python3 scripts/memdb.py list [--type <type>] [--status active] [--limit N]
python3 scripts/memdb.py relate "实体A" "关系" "实体B"
python3 scripts/memdb.py relations "实体" [--depth 1|2|3] [--direction from|to|both]
python3 scripts/memdb.py unrelate "实体A" "关系" "实体B"
python3 scripts/memdb.py decay [--days 30]
python3 scripts/memdb.py archive
python3 scripts/memdb.py export --dir <目录>
python3 scripts/memdb.py import --dir <目录>
python3 scripts/memdb.py stats

# ── Skill进化 ──
python3 scripts/skill_evolve.py record "操作模式" --tags "标签1,标签2"
python3 scripts/skill_evolve.py detect
python3 scripts/skill_evolve.py draft <pattern_id> [--name "skill-name"]
python3 scripts/skill_evolve.py promote <pattern_id> --name "skill-name"
python3 scripts/skill_evolve.py list

详细文档#

• 安装指南： 见 references/install.md
• AGENTS.md集成： 见 references/integration.md

Skill进化系统#

受 Hermes Agent 的闭环学习启发，hermes-memory-cn 增加了自动模式检测和skill提炼能力。

工作流#

text

完成多步骤任务 → skill_evolve.py record → 向量检测相似模式
                                                ↓
                          同一模式出现≥3次 → 自动通知候选
                                                ↓
                          skill_evolve.py draft → 生成草案到 skill_drafts/
                                                ↓
                          用户审核 → skill_evolve.py promote → 正式skill

命令#

bash

# 记录操作模式
python3 scripts/skill_evolve.py record "步骤1→步骤2→步骤3" --tags "标签"

# 检测候选
python3 scripts/skill_evolve.py detect

# 生成草案
python3 scripts/skill_evolve.py draft <id> --name "skill-name"

# 确认升级
python3 scripts/skill_evolve.py promote <id> --name "skill-name"

# 查看所有模式
python3 scripts/skill_evolve.py list

与 Hermes Agent 对比#

维度Hermes AgentHermes Memory CN定位完整Agent框架（自研内核+工具+消息平台）专注记忆层的工程优化记忆存储Markdown(3600字符硬上限)SQLite+向量DB(千条级)检索方式FTS5+LLM摘要向量语义搜索+FTS5+关系图谱容量管理硬上限强制精简自动衰减+去重+归档skill进化✅ 自动沉淀（成熟）✅ 模式检测+草案生成（新增）冻结注入✅ 保护prefix cache❌ 无中文优化无专用text2vec-base-chinese实体关系无多跳图谱查询部署门槛低（一个CLI）中（需装embedding模型）

关系定位： Hermes Agent 定义了"AI应该有长期记忆"的范式——反思循环、跨session持久化、skill自动沉淀。Hermes Memory CN 继承这个理念，在记忆存储层做了工程升级：从Markdown到向量数据库，从关键词搜索到语义检索，从几十条到千条级。两者互补，不是替代关系。

架构#

text

用户对话 → LLM判断/关键词触发 → memdb.py add/relate → SQLite + 向量DB
                                                        ↓
                        Cron每晚 ← decay + export ← entities/ Markdown备份

技术栈：

• 存储层：SQLite（结构化数据）+ sqlite-vec（向量索引）+ FTS5（全文搜索）
• Embedding：text2vec-base-chinese（768维，本地运行，MPS加速）
• 关系层：relations表（实体关系图谱，支持多跳BFS查询）
• 去重：向量余弦相似度 >0.95 自动合并