openmemory-plus 1.2.0 → 1.3.0

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** 返回菜单，或直接输入下一个操作"

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

package/templates/claude/CLAUDE.md

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