让 Hermes 拥有跨会话持久记忆，和 Claude Code 共享同一份知识库。

---

一、前提条件

条件	说明
Hermes Agent	已安装并运行
共享知识库	D:/tools/shared-knowledge/ 已部署
Python	系统自带即可（引擎纯标准库）

验证知识库可用：

python D:/tools/shared-knowledge/kb.py stats
# 输出: {"total_facts": 6, "db_path": "D:\\tools\\shared-knowledge\\knowledge.db"}

---

二、Skill 已自动安装

在搭建知识库时已创建 shared-knowledge Skill，Hermes 会自动识别以下场景并调用：

用户说	Hermes 做什么
“记住 xxx”	调用 kb.py remember
“查一下知识库 xxx”	调用 kb.py recall
“知识库里有什么”	调用 kb.py list
“删除知识 xxx”	调用 kb.py forget

无需手动配置，开箱即用。

---

三、使用演示（Hermes 对话中）

3.1 存储知识

👤 用户: 记住项目的 GitHub Token 在 D:/.hermes/.env 的 GITHUB_TOKEN 里

🤖 Hermes: [加载 shared-knowledge Skill]
           [执行 kb.py remember "..."]
           已存入知识库，ID: a23a52cb

3.2 搜索知识

👤 用户: Token 放在哪里？

🤖 Hermes: [搜索知识库]
           找到 1 条匹配:
           - GitHub Token 存放在 D:/.hermes/.env 的 GITHUB_TOKEN 变量

3.3 批量查询

👤 用户: 查一下知识库里关于 DeepSeek 的所有内容

🤖 Hermes: [执行 kb.py recall "DeepSeek"]
           找到 2 条:
           1. DeepSeek API 余额不足时需要充值...
           2. Hermes 工作目录在 D:/.hermes，使用 DeepSeek API

---

四、手动命令（高级用法）

Hermes 终端中也可以直接执行：

# 存储
python D:/tools/shared-knowledge/kb.py remember "需要记住的内容"

# 搜索（支持中文）
python D:/tools/shared-knowledge/kb.py recall "关键词"

# 列出全部
python D:/tools/shared-knowledge/kb.py list

# 删除（按 ID）
python D:/tools/shared-knowledge/kb.py forget a23a52cb

# 统计
python D:/tools/shared-knowledge/kb.py stats

---

五、Skill 工作原理

用户输入
    │
    ▼
Hermes 解析意图 ──→ 匹配 "记住/查/删除/知识库"
    │
    ▼
加载 shared-knowledge Skill
    │
    ▼
terminal("python D:/tools/shared-knowledge/kb.py remember '...'")
    │
    ▼
SQLite 写入/查询 ──→ 返回结果给用户

Skill 文件位置：D:/.hermes/skills/shared-knowledge/SKILL.md

---

六、实际场景示例

场景 A：记住环境变量位置

👤 用户: 记住，生产环境的 API Key 在服务器 /etc/app/.env 里
🤖 Hermes: ✅ 已存储

一周后：

👤 用户: 生产环境 API Key 在哪
🤖 Hermes: /etc/app/.env（来自知识库，2026-07-01 存储）

场景 B：记住项目依赖

👤 用户: 记住，这个项目前端用 React 18 + TypeScript，后端用 FastAPI
🤖 Hermes: ✅ 已存储

下次开新对话：

👤 用户: 这个项目用什么技术栈
🤖 Hermes: React 18 + TypeScript + FastAPI（来自共享知识库）

场景 C：跨 AI 工具共享

[Claude Code]  记住: "Bug #42 的修复方案是升级 axios 到 1.7"
[Hermes]       查: Bug #42 → ✅ 升级 axios 到 1.7

---

七、快速命令速查

操作	对话方式	手动命令
存储	“记住 xxx”	python D:/tools/shared-knowledge/kb.py remember "xxx"
搜索	“查知识库 xxx”	python D:/tools/shared-knowledge/kb.py recall "xxx"
列表	“知识库有什么”	python D:/tools/shared-knowledge/kb.py list
删除	“忘了 xxx”	python D:/tools/shared-knowledge/kb.py forget <id>
统计	“知识库多少条”	python D:/tools/shared-knowledge/kb.py stats

---

八、常见问题

Q: Skill 没触发怎么办？

手动加载：在 Hermes 对话中输入 /skill shared-knowledge

Q: 数据存在哪？

D:/tools/shared-knowledge/knowledge.db（SQLite，FTS5 全文索引）

Q: 能存多少条？

SQLite 无上限，FTS5 搜索千条以内毫秒级

Q: 和内置 memory 冲突吗？

不冲突。Hermes 内置 memory 存偏好/环境，共享知识库存知识/事实，互补。

---

知识库位置：D:/tools/shared-knowledge/knowledge.db
Skill 位置：D:/.hermes/skills/shared-knowledge/SKILL.md