openmemory-plus 1.2.3 → 1.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openmemory-plus",
-  "version": "1.2.3",
+  "version": "1.3.0",
   "description": "Agent Memory Management CLI - Install, configure, and manage OpenMemory Plus",
   "type": "module",
   "bin": {

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

@@ -1,86 +1,6 @@
 ---
-description: '记忆管理入口 - 统一管理项目级和用户级记忆'
+name: 'memory'
+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` 返回菜单"
+IT IS CRITICAL THAT YOU FOLLOW THIS COMMAND: LOAD the FULL @{project-root}/_omp/workflows/memory/workflow.md, READ its entire contents and follow its directions exactly!

package/templates/shared/_omp/workflows/memory/steps/clean.md

@@ -0,0 +1,92 @@
+---
+name: clean
+description: 清理过期、冗余或琐碎的记忆 (ROT)
+---
+
+# Step: 清理记忆
+
+## EXECUTION RULES
+
+- ✅ Analyze all memories for ROT
+- ✅ Show candidates before deletion
+- ✅ Require user confirmation
+
+---
+
+## EXECUTION
+
+### 1. Get All Memories
+
+Call `list_memories_openmemory` to get all user memories.
+
+### 2. Analyze ROT
+
+Identify cleanup candidates:
+
+| Type | Definition | Detection |
+|------|------------|-----------|
+| **Redundant** (冗余) | 重复或相似 | 语义相似度 > 0.9 |
+| **Outdated** (过时) | 超过 90 天 | 创建时间 > 90 days |
+| **Trivial** (琐碎) | 无实际价值 | 内容 < 10 chars or too generic |
+
+### 3. Display Candidates
+
+```
+🧹 清理候选记忆
+
+以下记忆可能需要清理:
+
+⚠️ Outdated (过时):
+{foreach outdated}
+{n}. "{content}"
+   创建: {days_ago} 天前
+{/foreach}
+
+⚠️ Redundant (冗余):
+{foreach redundant}
+{n}. "{content}" (与 "{similar_to}" 相似)
+{/foreach}
+
+⚠️ Trivial (琐碎):
+{foreach trivial}
+{n}. "{content}"
+{/foreach}
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+操作选项:
+- "全部删除" - 删除所有候选
+- "删除 1,2,3" - 删除指定项
+- "取消" - 不删除
+```
+
+### 4. Execute Deletion
+
+Based on user selection:
+- Get memory IDs to delete
+- Call `delete_memories_openmemory` with IDs
+- Display deletion result
+
+### 5. Display Result
+
+```
+🗑️ 清理完成
+
+已删除 {n} 条记忆
+释放空间: {estimated_size}
+```
+
+---
+
+## SAFETY
+
+- ⚠️ NEVER delete without user confirmation
+- ⚠️ Show content preview before deletion
+- ⚠️ Support selective deletion
+
+---
+
+## RETURN TO MENU
+
+完成后提示:
+> "还需要其他操作吗？输入 **M** 返回菜单，或直接输入下一个操作"

package/templates/shared/_omp/workflows/memory/steps/decay.md

@@ -0,0 +1,82 @@
+---
+name: decay
+description: 分析记忆的时间衰减状态
+---
+
+# Step: 衰减分析
+
+## EXECUTION RULES
+
+- ✅ Calculate decay scores for all memories
+- ✅ Group by decay status
+- ✅ Provide actionable recommendations
+
+---
+
+## EXECUTION
+
+### 1. Get All Memories
+
+Call `list_memories_openmemory` to get all user memories with timestamps.
+
+### 2. Calculate Decay Scores
+
+For each memory, calculate decay score based on:
+- Days since creation
+- Content importance (keywords)
+
+**Simplified formula:**
+```
+score = max(0, 1 - (daysSinceCreation / 180))
+```
+
+### 3. Classify by Status
+
+| Status | Score Range | Meaning |
+|--------|-------------|---------|
+| 🟢 Active | 0.7 - 1.0 | 活跃，近期创建 |
+| 🟡 Aging | 0.3 - 0.7 | 老化，需要关注 |
+| 🔴 Stale | 0.1 - 0.3 | 陈旧，考虑清理 |
+| ⚫ Cleanup | 0 - 0.1 | 待清理 |
+
+### 4. Display Analysis
+
+```
+⏰ 记忆衰减分析
+
+📊 总览: {total} 条记忆
+
+🟢 Active ({n}条) {progress_bar} {percent}%
+{foreach top_3}
+├── {content} [{score}]
+{/foreach}
+└── ... (输入 "展开 active" 查看全部)
+
+🟡 Aging ({n}条) {progress_bar} {percent}%
+{foreach all}
+├── {content} [{score}]
+{/foreach}
+
+🔴 Stale ({n}条) {progress_bar} {percent}%
+{foreach all}
+└── {content} [{score}]
+{/foreach}
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+💡 建议:
+{recommendations}
+```
+
+### 5. Follow-up Actions
+
+- `"清理 stale"` → Delete all Stale memories
+- `"刷新 N"` → Update memory (re-add to refresh)
+- `"展开 {status}"` → Show all in category
+
+---
+
+## RETURN TO MENU
+
+完成后提示:
+> "还需要其他操作吗？输入 **M** 返回菜单，或直接输入下一个操作"

package/templates/shared/_omp/workflows/memory/steps/graph.md

@@ -0,0 +1,88 @@
+---
+name: graph
+description: 查看记忆中的实体关系图谱
+---
+
+# Step: 知识图谱
+
+## EXECUTION RULES
+
+- ✅ Extract entities from memories
+- ✅ Identify relationships
+- ✅ Visualize in ASCII or Mermaid
+
+---
+
+## EXECUTION
+
+### 1. Read Graph Data
+
+Check for existing `_omp/.memory/graph.yaml`:
+- If exists, load entities and relations
+- If not, initialize empty graph
+
+### 2. Extract Entities
+
+From project and user memories, extract:
+
+| Entity Type | Examples |
+|-------------|----------|
+| project | Project name |
+| technology | TypeScript, React, Python |
+| service | API, CLI, Web |
+| database | Qdrant, PostgreSQL |
+| config | tsconfig.json, package.json |
+| preference | User preferences |
+
+### 3. Identify Relations
+
+| Relation | Meaning |
+|----------|---------|
+| uses | A uses B |
+| depends_on | A depends on B |
+| configured_by | A configured by B |
+| prefers | User prefers A |
+
+### 4. Display Graph
+
+```
+🔗 知识图谱
+
+项目: {project_name}
+
+实体关系:
+┌─────────────────────────────────────────┐
+│                                         │
+│  [{entity}] ──{relation}──> [{entity}]  │
+│    │                                    │
+│    └──{relation}──> [{entity}]          │
+│                                         │
+│  [User] ──prefers──> [{preference}]     │
+│                                         │
+└─────────────────────────────────────────┘
+
+统计: {n} 个实体, {n} 个关系
+```
+
+### 5. Follow-up Actions
+
+- `"添加关系"` → Add new entity relation
+- `"查看 {entity}"` → Show all relations for entity
+- `"导出 mermaid"` → Export as Mermaid diagram
+- `"导出 dot"` → Export as DOT format
+
+### 6. Mermaid Export Format
+
+```mermaid
+graph LR
+    A[CLI] -->|uses| B[TypeScript]
+    A -->|depends_on| C[Commander.js]
+    D[User] -->|prefers| E[中文]
+```
+
+---
+
+## RETURN TO MENU
+
+完成后提示:
+> "还需要其他操作吗？输入 **M** 返回菜单，或直接输入下一个操作"

package/templates/shared/_omp/workflows/memory/steps/search.md

@@ -0,0 +1,68 @@
+---
+name: search
+description: 在项目级和用户级记忆中进行语义搜索
+---
+
+# Step: 搜索记忆
+
+## EXECUTION RULES
+
+- ✅ Get search query from user if not provided
+- ✅ Search both project and user memory
+- ✅ Display results with relevance scores
+
+---
+
+## EXECUTION
+
+### 1. Get Search Query
+
+If user provided query in their command, use it directly.
+Otherwise ask:
+> "请输入搜索关键词："
+
+### 2. Search User Memory
+
+Call `search_memory_openmemory` with the query:
+- Get matching memories with scores
+- Sort by relevance
+
+### 3. Search Project Memory
+
+Search `_omp/.memory/*.md` and `_omp/.memory/*.yaml` files:
+- Grep for query keywords
+- Match file content
+
+### 4. Display Results
+
+```
+🔍 搜索结果: "{query}"
+
+📁 项目级结果:
+{foreach result}
+{n}. [{filename}] {matched_content}
+   匹配位置: 行 {line_number}
+{/foreach}
+
+👤 用户级结果:
+{foreach result}
+{n}. {memory_content}
+   相关度: {score} | 创建: {time_ago} | 状态: {decay_status}
+{/foreach}
+
+共找到 {total} 条相关记忆
+```
+
+### 5. Follow-up Actions
+
+用户可继续操作：
+- `"删除 N"` → 删除指定记忆
+- `"详情 N"` → 展示完整内容
+- `"更新 N"` → 修改记忆内容
+
+---
+
+## RETURN TO MENU
+
+完成后提示:
+> "还需要其他操作吗？输入 **M** 返回菜单，或直接输入下一个操作"

package/templates/shared/_omp/workflows/memory/steps/status.md

@@ -0,0 +1,63 @@
+---
+name: status
+description: 查看项目级和用户级记忆的详细状态
+---
+
+# Step: 查看记忆状态
+
+## EXECUTION RULES
+
+- ✅ Execute all steps in order
+- ✅ Display results clearly
+- ✅ End with menu prompt
+
+---
+
+## EXECUTION
+
+### 1. Read Project-Level Memory
+
+Read `_omp/.memory/` directory:
+- List all files with last modified time
+- Count total files
+
+### 2. Get User-Level Memory
+
+Call `list_memories_openmemory`:
+- Get all user memories
+- Count by decay status (Active/Aging/Stale/Cleanup)
+
+### 3. Display Status
+
+```
+📊 记忆系统详细状态
+
+📁 项目级 (_omp/.memory/)
+├── project.yaml    ({last_modified})
+├── decisions.yaml  ({last_modified})
+└── ... 共 {n} 个文件
+
+👤 用户级 (openmemory)
+├── 总记忆数: {total} 条
+├── 最近添加: "{latest_memory}" ({time_ago})
+└── 衰减状态:
+    ├── 🟢 Active:  {n} 条
+    ├── 🟡 Aging:   {n} 条
+    ├── 🔴 Stale:   {n} 条
+    └── ⚫ Cleanup: {n} 条
+
+{status_message}
+```
+
+### 4. Status Message Logic
+
+- If Cleanup > 0: `"⚠️ 有 {n} 条待清理记忆，建议执行清理"`
+- If Stale > 3: `"💡 有较多陈旧记忆，建议检查是否仍需要"`
+- Else: `"✅ 系统状态正常"`
+
+---
+
+## RETURN TO MENU
+
+完成后提示:
+> "还需要其他操作吗？输入 **M** 返回菜单，或直接输入下一个操作"

package/templates/shared/_omp/workflows/memory/steps/store.md

@@ -0,0 +1,81 @@
+---
+name: store
+description: 手动添加新的记忆到系统中
+---
+
+# Step: 存储记忆
+
+## EXECUTION RULES
+
+- ✅ Get content from user if not provided
+- ✅ Classify and route to correct storage
+- ✅ Confirm before storing
+
+---
+
+## EXECUTION
+
+### 1. Get Content
+
+If user provided content in their command, use it directly.
+Otherwise ask:
+> "请输入要存储的信息："
+
+### 2. Classify Information
+
+Analyze content and determine storage location:
+
+| Keywords | Storage | Action |
+|----------|---------|--------|
+| 项目路径, URL, 配置, deploy, domain | `_omp/.memory/` | Write to YAML |
+| 选择, 决定, 使用, 采用 (技术决策) | `_omp/.memory/decisions.yaml` | Append decision |
+| 喜欢, 偏好, 习惯 (用户偏好) | openmemory | `add_memories_openmemory` |
+| 熟悉, 擅长, 会用 (用户技能) | openmemory | `add_memories_openmemory` |
+| Other | Ask user | - |
+
+### 3. Confirm Storage
+
+```
+📝 即将存储:
+
+内容: "{content}"
+类型: {type}
+位置: {location}
+
+确认存储？[Y/n]
+```
+
+### 4. Execute Storage
+
+**For project-level:**
+- Read existing YAML file
+- Append new entry with timestamp
+- Write back
+
+**For user-level:**
+- Call `add_memories_openmemory` with content
+
+### 5. Display Result
+
+```
+💾 记忆已存储
+
+类型: {type}
+内容: "{content}"
+位置: {location}
+时间: {timestamp}
+```
+
+### 6. Batch Storage
+
+If content contains multiple items (comma/semicolon separated):
+- Split into individual items
+- Classify each separately
+- Store all with confirmation
+
+---
+
+## RETURN TO MENU
+
+完成后提示:
+> "还需要存储其他信息吗？输入 **M** 返回菜单，或直接输入下一个操作"

package/templates/shared/_omp/workflows/memory/steps/sync.md

@@ -0,0 +1,76 @@
+---
+name: sync
+description: 检测项目级和用户级记忆之间的冲突
+---
+
+# Step: 同步检查
+
+## EXECUTION RULES
+
+- ✅ Compare project and user memories
+- ✅ Identify conflicts and duplicates
+- ✅ Guide user through resolution
+
+---
+
+## EXECUTION
+
+### 1. Read Project Memory
+
+Read all files in `_omp/.memory/`:
+- Extract key-value pairs from YAML files
+- Extract topics from markdown files
+
+### 2. Search User Memory
+
+Call `search_memory_openmemory` with project topics:
+- Find related user memories
+- Compare values
+
+### 3. Detect Conflicts
+
+| Conflict Type | Example | Detection |
+|---------------|---------|-----------|
+| 值不一致 | Project: "npm" vs User: "pnpm" | Same topic, different value |
+| 重复记录 | Both have deploy URL | Same info in both |
+| 过期信息 | Project updated, user not | Timestamp comparison |
+
+### 4. Display Conflicts
+
+```
+🔄 同步检查结果
+
+{if no_conflicts}
+✅ 无冲突，项目级和用户级记忆同步正常
+{else}
+发现 {n} 个冲突:
+
+{foreach conflict}
+⚠️ 冲突 {n}: {description}
+├── 📁 项目级: {project_value}
+└── 👤 用户级: {user_value}
+
+建议: {recommendation}
+操作: [A] {option_a} [B] {option_b} [S] 跳过
+{/foreach}
+{/if}
+```
+
+### 5. Resolution Options
+
+- `"全部自动"` - Apply all recommendations
+- `"逐个处理"` - Handle one by one
+- `"A/B/S"` - Per-conflict decision
+
+### 6. Execute Resolution
+
+Based on user selection:
+- Update or delete memories as needed
+- Display summary of changes
+
+---
+
+## RETURN TO MENU
+
+完成后提示:
+> "还需要其他操作吗？输入 **M** 返回菜单，或直接输入下一个操作"