@yuechou/omp-memory
v4.2.3
Published
Oh My Pi extension: persistent memory, wiki, diary, triples, and graph
Maintainers
Readme
@yuechou/omp-memory
Oh My Pi 原生扩展:持久化记忆、Wiki、日记、三元组、图谱系统。
连接到 my-agent-memory HTTP API。
安装
# npm
npm install -g @yuechou/omp-memory
# omp
omp install @yuechou/omp-memory工具 (42)
记忆 (6)
| 工具 | 功能 |
|------|------|
| memory_save | 保存记忆 |
| memory_search | 搜索记忆 |
| memory_list | 列出记忆 |
| memory_get | 获取单条记忆 |
| memory_delete | 删除记忆 |
| memory_stats | 统计信息 |
RAG (4)
| 工具 | 功能 |
|------|------|
| rag_ingest | 摄入文档 |
| rag_search | 搜索文档 |
| rag_list | 列出文档 |
| rag_delete | 删除文档 |
Wiki (8)
| 工具 | 功能 |
|------|------|
| wiki_save | 创建/更新页面 |
| wiki_get | 读取页面 |
| wiki_list | 列出页面 |
| wiki_delete | 删除页面 |
| wiki_search | 搜索页面 |
| wiki_link | 管理链接 |
| wiki_backlinks | 查找反向链接 |
| wiki_move | 移动/重命名页面 |
| wiki_tree | 获取目录树 |
| wiki_ingest | 从源文档综合进 wiki |
| wiki_lint | 健康检查 |
| wiki_export_obsidian | 导出为 Obsidian 格式 |
日记 (6)
| 工具 | 功能 |
|------|------|
| diary_save | 保存日记 |
| diary_update | 更新日记 |
| diary_get | 获取单条日记 |
| diary_delete | 删除日记 |
| diary_search | 搜索日记 |
| diary_list | 列出日记 |
三元组 (4)
| 工具 | 功能 |
|------|------|
| triple_add | 添加三元组 |
| triple_query | 查询三元组 |
| triple_extract | 从文本提取三元组 |
| triple_stats | 统计信息 |
图谱 (4)
| 工具 | 功能 |
|------|------|
| graph_link | 创建关联 |
| graph_related | 获取关联记忆 |
| graph_path | 查找路径 |
| graph_stats | 统计信息 |
系统 (8)
| 工具 | 功能 |
|------|------|
| memory_ping | 健康检查 |
| memory_dream | 生命周期管理 |
| memory_update | 更新记忆 |
| memory_set_agent | 设置 Agent ID(会话开始时调用) |
| memory_set_profile | 设置兴趣领域 |
| memory_share | 共享记忆给其他 agent |
| memory_auth | Token 认证 |
| rag_update | 更新文档 |
命令 (4)
| 命令 | 功能 |
|------|------|
| /memory | stats | search | list |
| /wiki | list | get | search | lint | sync |
| /diary | list | search | today |
| /dream | 手动触发 dreaming |
配置
环境变量
| 环境变量 | 默认值 | 说明 |
|----------|--------|------|
| PI_MEMORY_URL | http://111.229.146.134 | 记忆服务器地址 |
| PI_MEMORY_AGENT | (空) | Agent ID,建议由 agent 自己调用 memory_set_agent 设置 |
| PI_MEMORY_TOKEN | (空) | API Token |
| PI_MEMORY_PASSWORD | (空) | 密码,用于自动获取 Token |
Agent 自注册
Agent 在会话开始时应调用以下工具:
memory_set_agent(agent="hermes") # 设置自己的 ID
memory_set_profile(interests=[...]) # 设置兴趣领域不同 agent 的记忆、Wiki、日记互相隔离。
优先级
memory_set_agent工具调用(最高)memory-agentomp flagPI_MEMORY_AGENT环境变量- 空(需 agent 自行设置)
自动化
- before_agent_start — 注入 wiki/diary 指南到系统 prompt
- turn_end — 累积对话内容
- session_shutdown — 自动生成会话日记
相关链接
- my-agent-memory - 服务器端
- @yuechou/omp-mode - 模式管理
- @yuechou/omp-video-understanding - 视频理解
- @yuechou/omp-display - 侧边栏显示
