openmemory-plus 1.1.0 → 1.2.3

package/templates/shared/_omp/commands/memory-actions/decay.md

@@ -0,0 +1,64 @@
+# 衰减分析
+
+分析记忆的时间衰减状态。
+
+## 执行步骤
+
+1. 调用 `list_memories_openmemory` 获取所有记忆
+2. 计算每条记忆的衰减分数
+3. 按状态分组展示
+4. 提供清理建议
+
+## 衰减算法
+
+基于时间的衰减公式：
+
+```
+score = baseScore * (1 - decayRate * daysSinceCreation)
+      + accessBonus * recentAccessCount
+      + importanceWeight
+```
+
+## 衰减状态
+
+| 状态 | 分数范围 | 含义 | 建议操作 |
+|------|----------|------|----------|
+| 🟢 Active | 0.7 - 1.0 | 活跃，经常使用 | 保留 |
+| 🟡 Aging | 0.3 - 0.7 | 老化，需要关注 | 考虑更新 |
+| 🔴 Stale | 0.1 - 0.3 | 陈旧，考虑清理 | 建议清理 |
+| ⚫ Cleanup | 0 - 0.1 | 待清理 | 强烈建议删除 |
+
+## 输出格式
+
+```
+⏰ 记忆衰减分析
+
+📊 总览: 15 条记忆
+
+🟢 Active (12条) ████████████░░░ 80%
+├── 用户偏好中文对话 [1.00]
+├── 熟悉 TypeScript [0.95]
+├── 项目使用 Vitest 测试 [0.88]
+└── ... 更多 (输入 "展开 active" 查看全部)
+
+🟡 Aging (2条) ██░░░░░░░░░░░░░ 13%
+├── 旧项目使用 Webpack [0.45]
+└── 偏好 Vim 编辑器 [0.38]
+
+🔴 Stale (1条) █░░░░░░░░░░░░░░ 7%
+└── 使用 jQuery [0.12]
+
+💡 建议: 
+- 清理 1 条 Stale 记忆
+- 关注 2 条 Aging 记忆，考虑是否仍然相关
+```
+
+## 后续操作
+
+- "清理 stale" → 删除所有 Stale 状态记忆
+- "刷新第 N 条" → 更新访问时间，重置衰减
+- "展开 active" → 显示所有 Active 记忆详情
+
+## 返回菜单
+
+完成后提示: "还需要其他操作吗？输入 `/memory` 返回菜单"

package/templates/shared/_omp/commands/memory-actions/graph.md

@@ -0,0 +1,75 @@
+# 知识图谱
+
+查看记忆中的实体关系图谱。
+
+## 执行步骤
+
+1. 读取 `.memory/graph.yaml` (如果存在)
+2. 从项目信息和记忆中提取实体
+3. 分析实体之间的关系
+4. 可视化展示
+
+## 实体类型
+
+| 类型 | 示例 |
+|------|------|
+| project | openmemory-plus |
+| service | API, CLI, Web |
+| database | Qdrant, PostgreSQL |
+| api | REST API, GraphQL |
+| config | tsconfig.json, package.json |
+| person | 用户名, 团队成员 |
+| technology | TypeScript, React |
+| decision | 技术选型, 架构决策 |
+| preference | 用户偏好 |
+
+## 关系类型
+
+| 关系 | 含义 |
+|------|------|
+| uses | A 使用 B |
+| depends_on | A 依赖 B |
+| configured_by | A 由 B 配置 |
+| created_by | A 由 B 创建 |
+| related_to | A 与 B 相关 |
+| stores_in | A 存储在 B |
+| prefers | 用户偏好 A |
+
+## 输出格式
+
+```
+🔗 知识图谱
+
+项目: openmemory-plus
+
+实体关系:
+┌─────────────────────────────────────────┐
+│                                         │
+│  [CLI] ──uses──> [TypeScript]           │
+│    │                                    │
+│    ├──depends_on──> [Commander.js]      │
+│    │                                    │
+│    └──configured_by──> [tsconfig.json]  │
+│                                         │
+│  [openmemory] ──uses──> [Qdrant]        │
+│       │                                 │
+│       └──uses──> [BGE-M3]               │
+│                                         │
+│  [User] ──prefers──> [中文]             │
+│       │                                 │
+│       └──prefers──> [TypeScript]        │
+│                                         │
+└─────────────────────────────────────────┘
+
+统计: 8 个实体, 7 个关系
+```
+
+## 后续操作
+
+- "添加关系" → 手动添加实体关系
+- "查看 [实体名]" → 展示该实体的所有关系
+- "导出" → 导出为 Mermaid/DOT 格式
+
+## 返回菜单
+
+完成后提示: "还需要其他操作吗？输入 `/memory` 返回菜单"

package/templates/shared/_omp/commands/memory-actions/search.md

@@ -0,0 +1,38 @@
+# 搜索记忆
+
+在项目级和用户级记忆中进行语义搜索。
+
+## 执行步骤
+
+1. 询问搜索关键词（如果用户未提供）
+2. 调用 `search_memory_openmemory` 搜索用户记忆
+3. 同时搜索 `.memory/` 目录下的 YAML 文件
+4. 按相关度排序，合并展示结果
+
+## 输出格式
+
+```
+🔍 搜索结果: "{query}"
+
+📁 项目级结果:
+1. [decisions.yaml] 技术决策: 使用 TypeScript
+   匹配度: 0.85
+
+👤 用户级结果:
+1. 用户偏好使用 pnpm 包管理器
+   创建时间: 30天前 | 衰减状态: Active
+
+共找到 2 条相关记忆
+```
+
+## 后续操作
+
+用户可以继续操作：
+
+- "删除第 N 条" → 执行删除
+- "查看详情" → 展示完整内容
+- "更新第 N 条" → 修改记忆内容
+
+## 返回菜单
+
+完成后提示: "还需要其他操作吗？输入 `/memory` 返回菜单"

package/templates/shared/_omp/commands/memory-actions/status.md

@@ -0,0 +1,35 @@
+# 记忆状态
+
+查看项目级和用户级记忆的详细状态。
+
+## 执行步骤
+
+1. 读取 `.memory/` 目录，列出文件和最后修改时间
+2. 调用 `list_memories_openmemory` 获取用户记忆
+3. 分析衰减状态分布
+4. 统计并展示
+
+## 输出格式
+
+```
+📊 记忆系统详细状态
+
+📁 项目级 (.memory/)
+├── project.yaml    (2024-01-15 更新)
+├── decisions.yaml  (2024-01-10 更新)
+└── changelog.yaml  (2024-01-14 更新)
+
+👤 用户级 (openmemory)
+├── 总记忆数: 15 条
+├── 最近添加: "用户偏好中文对话" (1天前)
+└── 衰减状态:
+    ├── 🟢 Active:  12 条
+    ├── 🟡 Aging:   2 条
+    └── 🔴 Stale:   1 条
+
+✅ 系统状态正常
+```
+
+## 返回菜单
+
+完成后提示: "还需要其他操作吗？输入 `/memory` 返回菜单"

package/templates/shared/_omp/commands/memory-actions/store.md

@@ -0,0 +1,45 @@
+# 存储记忆
+
+手动添加新的记忆到系统中。
+
+## 执行步骤
+
+1. 询问要存储的内容（如果用户未提供）
+2. 分析信息类型，确定存储位置
+3. 确认存储位置
+4. 执行存储
+
+## 分类逻辑
+
+根据信息特征自动路由到合适的存储位置：
+
+| 信息特征 | 存储位置 | 操作 |
+|----------|----------|------|
+| 包含项目路径/URL/配置 | `.memory/project.yaml` | 写入 YAML |
+| 包含技术决策 ("选择"、"决定"、"使用") | `.memory/decisions.yaml` | 写入 YAML |
+| 用户偏好 ("喜欢"、"偏好"、"习惯") | openmemory | `add_memories_openmemory` |
+| 用户技能 ("熟悉"、"擅长"、"会用") | openmemory | `add_memories_openmemory` |
+| 其他 | 询问用户选择 | - |
+
+## 输出格式
+
+```
+💾 记忆已存储
+
+类型: 用户偏好
+内容: "偏好使用 TypeScript 而非 JavaScript"
+位置: openmemory
+时间: 2024-01-15 10:30
+
+还需要存储其他信息吗？
+```
+
+## 批量存储
+
+支持一次存储多条信息：
+- "这个项目用 React，部署在 Vercel，域名是 xxx.com"
+- 自动拆分并分类存储
+
+## 返回菜单
+
+完成后提示: "还需要其他操作吗？输入 `/memory` 返回菜单"

package/templates/shared/_omp/commands/memory-actions/sync.md

@@ -0,0 +1,50 @@
+# 同步检查
+
+检测项目级和用户级记忆之间的冲突。
+
+## 执行步骤
+
+1. 读取 `.memory/` 中的所有信息
+2. 搜索 openmemory 中的相关记忆
+3. 检测冲突（同一主题不同值）
+4. 展示冲突列表
+5. 提示用户选择解决方式
+
+## 冲突类型
+
+| 冲突类型 | 示例 | 解决方式 |
+|----------|------|----------|
+| 值不一致 | 项目级: "用 npm" vs 用户级: "偏好 pnpm" | 用户选择保留哪个 |
+| 重复记录 | 两处都记录了部署 URL | 合并或删除重复 |
+| 过期信息 | 项目级配置已更新，用户级未同步 | 更新用户级 |
+
+## 输出格式
+
+```
+🔄 同步检查结果
+
+发现 2 个冲突:
+
+⚠️ 冲突 1: 包管理器偏好不一致
+├── 📁 项目级: 使用 npm (package-lock.json 存在)
+└── 👤 用户级: "偏好使用 pnpm"
+
+建议: 更新用户记忆以匹配项目配置
+操作: [A] 保留项目级 [B] 保留用户级 [S] 跳过
+
+⚠️ 冲突 2: 部署 URL 重复
+├── 📁 项目级: deploy_url: "https://xxx.vercel.app"
+└── 👤 用户级: "项目部署在 https://xxx.vercel.app"
+
+建议: 删除用户级重复记录
+操作: [A] 删除用户级 [B] 保留两者 [S] 跳过
+```
+
+## 自动同步选项
+
+- "全部自动" - 按建议自动处理所有冲突
+- "逐个处理" - 一个一个确认
+
+## 返回菜单
+
+完成后提示: "还需要其他操作吗？输入 `/memory` 返回菜单"

package/templates/shared/_omp/commands/memory.md

@@ -0,0 +1,86 @@
+---
+description: '记忆管理入口 - 统一管理项目级和用户级记忆'
+---
+
+# /memory
+
+OpenMemory Plus 记忆管理统一入口。
+
+## 行为
+
+当用户输入 `/memory` 时：
+
+1. **快速状态检测**
+   - 读取 `_omp/.memory/` 目录状态
+   - 调用 `list_memories_openmemory` 获取用户记忆数量
+
+2. **显示菜单**
+
+```
+📊 记忆管理系统
+
+当前状态快览:
+├── 项目级 (_omp/.memory/): {n} 个文件
+└── 用户级 (openmemory): {n} 条记忆
+
+选择操作:
+
+1. 📋 查看状态 - 详细记忆状态
+2. 🔍 搜索记忆 - 语义搜索
+3. 💾 存储记忆 - 手动添加
+4. 🧹 清理记忆 - 清理 ROT
+5. 🔄 同步检查 - 冲突检测
+6. ⏰ 衰减分析 - 时间衰减
+7. 🔗 知识图谱 - 实体关系
+
+输入数字，或直接描述你的需求:
+```
+
+3. **等待用户输入**
+
+## 路由逻辑
+
+根据用户输入路由到对应子文件：
+
+| 输入 | 意图关键词 | 加载文件 |
+|------|-----------|----------|
+| `1` | 状态、概览、overview | `./memory-actions/status.md` |
+| `2` | 搜索、找、查、search | `./memory-actions/search.md` |
+| `3` | 存储、记住、保存、store | `./memory-actions/store.md` |
+| `4` | 清理、删除、过期、clean | `./memory-actions/clean.md` |
+| `5` | 同步、冲突、检查、sync | `./memory-actions/sync.md` |
+| `6` | 衰减、aging、decay | `./memory-actions/decay.md` |
+| `7` | 图谱、关系、依赖、graph | `./memory-actions/graph.md` |
+
+## 自然语言兼容
+
+用户也可以直接描述需求，Agent 根据意图关键词路由：
+
+- "搜索一下部署配置" → 加载 search.md
+- "清理过期的记忆" → 加载 clean.md
+- "这个项目用 React" → 加载 store.md
+- "查看记忆衰减状态" → 加载 decay.md
+
+## MCP 工具
+
+Agent 可使用以下工具：
+
+| 工具 | 用途 |
+|------|------|
+| `add_memories_openmemory` | 添加用户级记忆 |
+| `search_memory_openmemory` | 语义搜索记忆 |
+| `list_memories_openmemory` | 列出所有记忆 |
+| `delete_memories_openmemory` | 删除指定记忆 |
+
+## 项目级记忆
+
+直接读写 `_omp/.memory/` 目录下的 YAML 文件：
+
+- `project.yaml` - 项目配置
+- `decisions.yaml` - 技术决策
+- `changelog.yaml` - 变更历史
+
+## 返回菜单
+
+每个子动作完成后，提示用户：
+> "还需要其他操作吗？输入 `/memory` 返回菜单"