openmemory-plus 1.2.3 → 1.3.2

package/templates/shared/_omp/workflows/memory/workflow.md

@@ -0,0 +1,147 @@
+---
+name: memory
+description: 记忆管理工作流 - 统一管理项目级和用户级记忆
+version: "2.0"
+---
+
+# Memory Management Workflow
+
+**Goal:** 提供统一的记忆管理入口，支持查看、搜索、存储、清理、同步、衰减分析和知识图谱功能。
+
+**Your Role:** 你是记忆管理专家，帮助用户高效管理项目级（`.memory/`）和用户级（openmemory）记忆。使用中文交流，技术术语保留英文。
+
+---
+
+## WORKFLOW ARCHITECTURE
+
+This uses **micro-file architecture** with **menu-driven routing**:
+
+- Main workflow displays status and menu
+- Each action is a self-contained step file
+- User selects action via number or natural language
+- After action completion, return to menu
+
+---
+
+## INITIALIZATION
+
+### Configuration
+
+- `installed_path` = `{project-root}/_omp/workflows/memory`
+- `memory_folder` = `{project-root}/_omp/.memory`
+- `steps_path` = `{installed_path}/steps`
+
+### MCP Tools Available
+
+| Tool | Purpose |
+|------|---------|
+| `add_memories_openmemory` | 添加用户级记忆 |
+| `search_memory_openmemory` | 语义搜索记忆 |
+| `list_memories_openmemory` | 列出所有记忆 |
+| `delete_memories_openmemory` | 删除指定记忆 |
+
+---
+
+## EXECUTION
+
+### Step 1: Quick Status Check
+
+1. Read `_omp/.memory/` directory, count files
+2. Call `list_memories_openmemory` to get user memory count
+3. Display status summary
+
+### Step 2: Display Menu
+
+```
+🧠 OpenMemory Plus - 记忆管理
+
+📊 当前状态:
+├── 项目级 (_omp/.memory/): {n} 个文件
+└── 用户级 (openmemory): {n} 条记忆
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+选择操作:
+
+[1] 📊 查看状态    详细记忆状态和统计
+[2] 🔍 搜索记忆    语义搜索项目和用户记忆
+[3] 💾 存储记忆    手动添加新记忆
+[4] 🧹 清理记忆    清理 ROT (冗余/过时/琐碎)
+[5] 🔄 同步检查    检测冲突并解决
+[6] ⏰ 衰减分析    查看记忆衰减状态
+[7] 🔗 知识图谱    查看实体关系
+
+[M] 返回菜单  [X] 退出
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+输入数字选择，或直接描述你的需求:
+```
+
+### Step 3: Wait for User Input
+
+**STOP and WAIT** for user input. Do NOT proceed automatically.
+
+### Step 4: Route to Step File
+
+Based on user input, load the corresponding step file:
+
+| Input | Keywords | Load Step |
+|-------|----------|-----------|
+| `1` | 状态, 概览, status, overview | `./steps/status.md` |
+| `2` | 搜索, 找, 查, search, find | `./steps/search.md` |
+| `3` | 存储, 记住, 保存, store, save, remember | `./steps/store.md` |
+| `4` | 清理, 删除, clean, delete, remove | `./steps/clean.md` |
+| `5` | 同步, 冲突, sync, conflict | `./steps/sync.md` |
+| `6` | 衰减, 老化, decay, aging | `./steps/decay.md` |
+| `7` | 图谱, 关系, graph, relation | `./steps/graph.md` |
+| `M` | 菜单, menu | Re-display menu |
+| `X` | 退出, exit, quit | Exit workflow |
+
+### Natural Language Routing
+
+Support natural language commands:
+
+- "搜索部署配置" → Load `search.md`
+- "这个项目用 React" → Load `store.md`
+- "清理过期的记忆" → Load `clean.md`
+- "查看记忆衰减" → Load `decay.md`
+
+---
+
+## STEP FILE PROTOCOL
+
+Each step file MUST:
+
+1. Execute its specific action
+2. Display results clearly
+3. Offer follow-up actions
+4. End with: `"还需要其他操作吗？输入 M 返回菜单，或直接输入下一个操作"`
+
+---
+
+## FALLBACK (MCP Unavailable)
+
+If `openmemory` MCP tools are not available:
+
+1. Display warning: `"⚠️ openmemory MCP 不可用，用户级记忆功能受限"`
+2. Offer to store user-level info temporarily in `_omp/.memory/user-context.yaml`
+3. Continue with project-level memory operations
+
+---
+
+## SUCCESS METRICS
+
+✅ Quick status displayed on entry
+✅ Menu clearly presented
+✅ User input correctly routed
+✅ Each action completes with clear output
+✅ Return to menu flow works smoothly
+
+## FAILURE MODES
+
+❌ Proceeding without user input
+❌ Misrouting user commands
+❌ Not handling MCP unavailability
+❌ Breaking out of menu loop unexpectedly
+

package/templates/augment/AGENTS.md

@@ -1,85 +0,0 @@
-# OpenMemory Plus - Agent 记忆管理
-
-本项目已启用 OpenMemory Plus 双层记忆管理系统。
-
-## 快速使用
-
-**只需记住一个命令：**
-
-```
-/memory
-```
-
-输入后会显示菜单，选择数字或用自然语言描述需求：
-
-| 选项 | 说明 |
-|------|------|
-| 1 | 📋 查看状态 - 详细记忆状态 |
-| 2 | 🔍 搜索记忆 - 语义搜索 |
-| 3 | 💾 存储记忆 - 手动添加 |
-| 4 | 🧹 清理记忆 - 清理 ROT |
-| 5 | 🔄 同步检查 - 冲突检测 |
-| 6 | ⏰ 衰减分析 - 时间衰减 |
-| 7 | 🔗 知识图谱 - 实体关系 |
-
-**示例：**
-- 输入 `2` 或 "搜索部署配置"
-- 输入 `4` 或 "清理过期的记忆"
-
-## 核心目录
-
-```
-_omp/                           # OpenMemory Plus 核心目录
-├── commands/
-│   ├── memory.md               # 主命令入口
-│   └── memory-actions/         # 7 个子动作
-├── skills/
-│   └── memory-extraction/      # 自动提取 Skill
-└── .memory/                    # 项目级记忆
-    ├── project.yaml            # 项目配置 (SSOT)
-    └── *.md                    # 上下文文件
-```
-
-## 双层记忆架构
-
-| 系统 | 存储位置 | 用途 |
-|------|----------|------|
-| 项目级 | `_omp/.memory/` | 项目配置、技术决策、变更记录 |
-| 用户级 | `openmemory` MCP | 用户偏好、技能、跨项目上下文 |
-
-## 自动行为
-
-### 对话开始时
-1. 搜索 `openmemory` 获取用户上下文
-2. 加载 `_omp/.memory/project.yaml` 获取项目配置
-3. 融合上下文提供个性化响应
-
-### 对话结束时
-1. 检测有价值信息
-2. 按分类规则路由存储
-3. 项目级 → `_omp/.memory/`
-4. 用户级 → `openmemory`
-
-## MCP 工具
-
-| 工具 | 用途 |
-|------|------|
-| `add_memories_openmemory` | 添加用户级记忆 |
-| `search_memory_openmemory` | 语义搜索记忆 |
-| `list_memories_openmemory` | 列出所有记忆 |
-| `delete_memories_openmemory` | 删除指定记忆 |
-
-## 分类规则
-
-| 信息类型 | 存储位置 | 示例 |
-|----------|----------|------|
-| 项目配置 | `_omp/.memory/` | 部署 URL、路径 |
-| 技术决策 | `_omp/.memory/` | 框架选择、架构 |
-| 用户偏好 | `openmemory` | 语言、风格 |
-| 用户技能 | `openmemory` | 熟悉的技术栈 |
-
-详细规则见 `.augment/skills/memory-extraction/SKILL.md`
-
----
-*由 OpenMemory Plus CLI 生成 | https://github.com/Alenryuichi/openmemory-plus*
-

package/templates/claude/CLAUDE.md

@@ -1,65 +0,0 @@
-# OpenMemory Plus 配置
-
-## 记忆管理系统
-
-本项目已启用 OpenMemory Plus 双层记忆管理。
-
-### 核心目录
-
-```
-_omp/                           # OpenMemory Plus 核心目录
-├── commands/
-│   ├── memory.md               # 主命令入口
-│   └── memory-actions/         # 7 个子动作
-├── skills/
-│   └── memory-extraction/      # 自动提取 Skill
-└── .memory/                    # 项目级记忆
-    └── project.yaml            # 项目配置 (SSOT)
-```
-
-### 命令入口
-
-**只需记住一个命令：**
-
-```
-/memory
-```
-
-输入后会显示菜单，选择数字或用自然语言描述需求：
-
-| 选项 | 说明 |
-|------|------|
-| 1 | 📋 查看状态 - 详细记忆状态 |
-| 2 | 🔍 搜索记忆 - 语义搜索 |
-| 3 | 💾 存储记忆 - 手动添加 |
-| 4 | 🧹 清理记忆 - 清理 ROT |
-| 5 | 🔄 同步检查 - 冲突检测 |
-| 6 | ⏰ 衰减分析 - 时间衰减 |
-| 7 | 🔗 知识图谱 - 实体关系 |
-
-### 存储架构
-
-| 系统 | 存储位置 | 用途 |
-|------|----------|------|
-| 项目级 | `_omp/.memory/` | 项目配置、技术决策、变更记录 |
-| 用户级 | `openmemory` MCP | 用户偏好、技能、跨项目上下文 |
-
-### 自动提取 (Memory Extraction)
-
-对话结束时自动执行：
-1. 检测有价值信息
-2. 智能分类路由
-3. 项目级 → `_omp/.memory/`
-4. 用户级 → `openmemory`
-
-### MCP 工具
-
-| 工具 | 用途 |
-|------|------|
-| `add_memories_openmemory` | 添加用户级记忆 |
-| `search_memory_openmemory` | 语义搜索记忆 |
-| `list_memories_openmemory` | 列出所有记忆 |
-| `delete_memories_openmemory` | 删除指定记忆 |
-
----
-*由 OpenMemory Plus CLI 生成*

package/templates/common/AGENTS.md

@@ -1,51 +0,0 @@
-# OpenMemory Plus - Agent 记忆管理
-
-本项目已启用 OpenMemory Plus 双层记忆管理系统。
-
-## 快速使用
-
-**只需记住一个命令：**
-
-```
-/memory
-```
-
-输入后会显示菜单，选择数字或用自然语言描述需求：
-
-| 选项 | 说明 |
-|------|------|
-| 1 | 📋 查看状态 - 详细记忆状态 |
-| 2 | 🔍 搜索记忆 - 语义搜索 |
-| 3 | 💾 存储记忆 - 手动添加 |
-| 4 | 🧹 清理记忆 - 清理 ROT |
-| 5 | 🔄 同步检查 - 冲突检测 |
-| 6 | ⏰ 衰减分析 - 时间衰减 |
-| 7 | 🔗 知识图谱 - 实体关系 |
-
-## 双层记忆架构
-
-| 层级 | 存储 | 用途 |
-|------|------|------|
-| 项目级 | `.memory/*.yaml` | 项目配置、技术决策、变更记录 |
-| 用户级 | `openmemory` MCP | 用户偏好、技能、跨项目上下文 |
-
-## 自动行为
-
-### 对话开始时
-1. 搜索 `openmemory` 获取用户上下文
-2. 加载 `.memory/project.yaml` 获取项目配置
-3. 融合上下文提供个性化响应
-
-### 对话结束时
-1. 检测有价值信息
-2. 按分类规则路由存储
-3. 项目级 → `.memory/`
-4. 用户级 → `openmemory`
-
-## 配置文件
-
-- `.memory/project.yaml` - 项目配置
-- 命令和 Skill 文件 - 参考 IDE 对应目录
-
----
-*由 OpenMemory Plus CLI 生成*

package/templates/cursor/.cursorrules

@@ -1,81 +0,0 @@
-# OpenMemory Plus - Agent 记忆管理
-
-本项目已启用 OpenMemory Plus 双层记忆管理系统。
-
-## 快速使用
-
-**只需记住一个命令：**
-
-```
-/memory
-```
-
-输入后会显示菜单，选择数字或用自然语言描述需求：
-
-| 选项 | 说明 |
-|------|------|
-| 1 | 📋 查看状态 - 详细记忆状态 |
-| 2 | 🔍 搜索记忆 - 语义搜索 |
-| 3 | 💾 存储记忆 - 手动添加 |
-| 4 | 🧹 清理记忆 - 清理 ROT |
-| 5 | 🔄 同步检查 - 冲突检测 |
-| 6 | ⏰ 衰减分析 - 时间衰减 |
-| 7 | 🔗 知识图谱 - 实体关系 |
-
-## 核心目录
-
-```
-_omp/                           # OpenMemory Plus 核心目录
-├── commands/
-│   ├── memory.md               # 主命令入口
-│   └── memory-actions/         # 7 个子动作
-├── skills/
-│   └── memory-extraction/      # 自动提取 Skill
-└── .memory/                    # 项目级记忆
-    ├── project.yaml            # 项目配置 (SSOT)
-    └── *.md                    # 上下文文件
-```
-
-## 双层记忆架构
-
-| 系统 | 存储位置 | 用途 |
-|------|----------|------|
-| 项目级 | `_omp/.memory/` | 项目配置、技术决策、变更记录 |
-| 用户级 | `openmemory` MCP | 用户偏好、技能、跨项目上下文 |
-
-## 自动行为
-
-### 对话开始时
-1. 搜索 `openmemory` 获取用户上下文
-2. 加载 `_omp/.memory/project.yaml` 获取项目配置
-3. 融合上下文提供个性化响应
-
-### 对话结束时
-1. 检测有价值信息
-2. 按分类规则路由存储
-3. 项目级 → `_omp/.memory/`
-4. 用户级 → `openmemory`
-
-## MCP 工具
-
-| 工具 | 用途 |
-|------|------|
-| `add_memories_openmemory` | 添加用户级记忆 |
-| `search_memory_openmemory` | 语义搜索记忆 |
-| `list_memories_openmemory` | 列出所有记忆 |
-| `delete_memories_openmemory` | 删除指定记忆 |
-
-## 分类规则
-
-| 信息类型 | 存储位置 | 示例 |
-|----------|----------|------|
-| 项目配置 | `_omp/.memory/` | 部署 URL、路径 |
-| 技术决策 | `_omp/.memory/` | 框架选择、架构 |
-| 用户偏好 | `openmemory` | 语言、风格 |
-| 用户技能 | `openmemory` | 熟悉的技术栈 |
-
-详细规则见 `.cursor/skills/memory-extraction/SKILL.md`
-
----
-*由 OpenMemory Plus CLI 生成 | https://github.com/Alenryuichi/openmemory-plus*
-

package/templates/gemini/gemini.md

@@ -1,84 +0,0 @@
-# OpenMemory Plus - Agent 记忆管理
-
-本项目已启用 OpenMemory Plus 双层记忆管理系统。
-
-## 快速使用
-
-**只需记住一个命令：**
-
-```
-/memory
-```
-
-输入后会显示菜单，选择数字或用自然语言描述需求：
-
-| 选项 | 说明 |
-|------|------|
-| 1 | 📋 查看状态 - 详细记忆状态 |
-| 2 | 🔍 搜索记忆 - 语义搜索 |
-| 3 | 💾 存储记忆 - 手动添加 |
-| 4 | 🧹 清理记忆 - 清理 ROT |
-| 5 | 🔄 同步检查 - 冲突检测 |
-| 6 | ⏰ 衰减分析 - 时间衰减 |
-| 7 | 🔗 知识图谱 - 实体关系 |
-
-**示例：**
-- 输入 `2` 或 "搜索部署配置"
-- 输入 `4` 或 "清理过期的记忆"
-
-## 核心目录
-
-```
-_omp/                           # OpenMemory Plus 核心目录
-├── commands/
-│   ├── memory.md               # 主命令入口
-│   └── memory-actions/         # 7 个子动作
-├── skills/
-│   └── memory-extraction/      # 自动提取 Skill
-└── .memory/                    # 项目级记忆
-    ├── project.yaml            # 项目配置 (SSOT)
-    └── *.md                    # 上下文文件
-```
-
-## 双层记忆架构
-
-| 系统 | 存储位置 | 用途 |
-|------|----------|------|
-| 项目级 | `_omp/.memory/` | 项目配置、技术决策、变更记录 |
-| 用户级 | `openmemory` MCP | 用户偏好、技能、跨项目上下文 |
-
-## 自动行为
-
-### 对话开始时
-1. 搜索 `openmemory` 获取用户上下文
-2. 加载 `_omp/.memory/project.yaml` 获取项目配置
-3. 融合上下文提供个性化响应
-
-### 对话结束时
-1. 检测有价值信息
-2. 按分类规则路由存储
-3. 项目级 → `_omp/.memory/`
-4. 用户级 → `openmemory`
-
-## MCP 工具
-
-| 工具 | 用途 |
-|------|------|
-| `add_memories_openmemory` | 添加用户级记忆 |
-| `search_memory_openmemory` | 语义搜索记忆 |
-| `list_memories_openmemory` | 列出所有记忆 |
-| `delete_memories_openmemory` | 删除指定记忆 |
-
-## 分类规则
-
-| 信息类型 | 存储位置 | 示例 |
-|----------|----------|------|
-| 项目配置 | `_omp/.memory/` | 部署 URL、路径 |
-| 技术决策 | `_omp/.memory/` | 框架选择、架构 |
-| 用户偏好 | `openmemory` | 语言、风格 |
-| 用户技能 | `openmemory` | 熟悉的技术栈 |
-
-详细规则见 `.gemini/skills/memory-extraction/SKILL.md`
-
----
-*由 OpenMemory Plus CLI 生成 | https://github.com/Alenryuichi/openmemory-plus*

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

@@ -1,54 +0,0 @@
-# 清理记忆
-
-清理过期、冗余或琐碎的记忆 (ROT)。
-
-## 执行步骤
-
-1. 调用 `list_memories_openmemory` 获取所有记忆
-2. 分析衰减状态，识别 Cleanup 状态的记忆
-3. 检测冗余和矛盾的记忆
-4. 展示候选列表，询问用户确认
-5. 执行删除
-
-## ROT 判断标准
-
-| 类型 | 定义 | 检测方法 |
-|------|------|----------|
-| **Redundant** (冗余) | 重复或相似的记忆 | 语义相似度 > 0.9 |
-| **Outdated** (过时) | 超过 90 天未访问 | 衰减分数 < 0.3 |
-| **Trivial** (琐碎) | 无实际价值 | 内容过短或通用 |
-
-## 输出格式
-
-```
-🧹 清理候选记忆
-
-以下记忆可能需要清理:
-
-⚠️ Outdated (过时):
-1. "旧项目使用 Webpack 4"
-   最后访问: 120天前 | 衰减分数: 0.15
-
-⚠️ Redundant (冗余):
-2. "偏好使用 npm" (与另一条冲突)
-   最后访问: 30天前
-
-⚠️ Trivial (琐碎):
-3. "ok"
-   创建时间: 60天前
-
-确认删除？
-- "全部删除" - 删除所有候选
-- "删除 1,2" - 删除指定项
-- "取消" - 不删除
-```
-
-## 安全机制
-
-- 删除前必须用户确认
-- 显示将被删除的内容预览
-- 支持选择性删除
-
-## 返回菜单
-
-完成后提示: "还需要其他操作吗？输入 `/memory` 返回菜单"

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

@@ -1,64 +0,0 @@
-# 衰减分析
-
-分析记忆的时间衰减状态。
-
-## 执行步骤
-
-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

@@ -1,75 +0,0 @@
-# 知识图谱
-
-查看记忆中的实体关系图谱。
-
-## 执行步骤
-
-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` 返回菜单"