openmemory-plus 1.0.0 → 1.2.0

package/templates/augment/AGENTS.md

@@ -0,0 +1,78 @@
+# 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

@@ -0,0 +1,52 @@
+# 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

@@ -0,0 +1,51 @@
+# 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

@@ -0,0 +1,57 @@
+# OpenMemory Plus - Agent 记忆管理
+
+本项目已启用 OpenMemory Plus 双层记忆管理系统。
+
+## 记忆命令
+
+- `/memory` - 查看记忆状态 + 子命令列表
+- `/mem status` - 详细记忆状态
+- `/mem search {query}` - 搜索记忆
+- `/mem sync` - 同步检查
+- `/mem clean` - 清理 ROT 记忆
+- `/mem extract` - 手动提取记忆
+
+## 双层记忆架构
+
+项目级 (.memory/):
+- project.yaml - 项目配置
+- decisions.yaml - 技术决策
+- changelog.yaml - 变更历史
+
+用户级 (openmemory MCP):
+- 用户偏好 - 跨项目通用
+- 用户技能 - 个人能力
+- 对话上下文 - 历史记忆
+
+## 自动行为
+
+对话开始时:
+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/gemini/gemini.md

@@ -0,0 +1,77 @@
+# 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/shared/commands/memory.md

@@ -0,0 +1,86 @@
+---
+description: '记忆管理入口 - 统一管理项目级和用户级记忆'
+---
+
+# /memory
+
+OpenMemory Plus 记忆管理统一入口。
+
+## 行为
+
+当用户输入 `/memory` 时：
+
+1. **快速状态检测**
+   - 读取 `.memory/` 目录状态
+   - 调用 `list_memories_openmemory` 获取用户记忆数量
+
+2. **显示菜单**
+
+```
+📊 记忆管理系统
+
+当前状态快览:
+├── 项目级 (.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` | 删除指定记忆 |
+
+## 项目级记忆
+
+直接读写 `.memory/` 目录下的 YAML 文件：
+
+- `project.yaml` - 项目配置
+- `decisions.yaml` - 技术决策
+- `changelog.yaml` - 变更历史
+
+## 返回菜单
+
+每个子动作完成后，提示用户：
+> "还需要其他操作吗？输入 `/memory` 返回菜单"

package/templates/shared/memory/activeContext.md

@@ -0,0 +1,34 @@
+# Active Context
+
+> ⚡ This file is updated frequently - captures current work state
+
+## Current Focus
+<!-- 当前正在进行的工作 -->
+
+- 
+
+## Recent Changes
+<!-- 最近的重要变更 -->
+
+| Date | Change | Impact |
+|------|--------|--------|
+| {{CREATED_AT}} | Project initialized | - |
+
+## Active Decisions
+<!-- 当前生效的决策 -->
+
+- 
+
+## Open Questions
+<!-- 待解决的问题 -->
+
+- [ ] 
+
+## Next Steps
+<!-- 接下来要做的事 -->
+
+1. 
+
+---
+
+*Last updated: {{CREATED_AT}}*

package/templates/shared/memory/productContext.md

@@ -0,0 +1,30 @@
+# Product Context
+
+## Why This Project Exists
+<!-- 项目存在的原因，解决什么问题 -->
+
+
+
+## Problems Solved
+<!-- 用户面临的具体问题 -->
+
+1. 
+
+## User Experience Goals
+<!-- 期望的用户体验 -->
+
+- 
+
+## Target Users
+<!-- 目标用户群体 -->
+
+- 
+
+## How It Should Work
+<!-- 产品应该如何运作 -->
+
+
+
+---
+
+*Updated when product direction or user needs change.*

package/templates/shared/memory/progress.md

@@ -0,0 +1,41 @@
+# Progress
+
+## What Works ✅
+<!-- 已完成且正常工作的功能 -->
+
+- [ ] Project initialized
+
+## What's Left 📋
+<!-- 还需要完成的工作 -->
+
+- [ ] 
+
+## Current Status
+<!-- 当前状态概览 -->
+
+| Milestone | Status | ETA |
+|-----------|--------|-----|
+| Setup | 🟡 In Progress | - |
+| MVP | ⚪ Not Started | - |
+| Launch | ⚪ Not Started | - |
+
+## Known Issues 🐛
+<!-- 已知问题 -->
+
+| Issue | Severity | Workaround |
+|-------|----------|------------|
+| | | |
+
+## Blockers 🚧
+<!-- 阻塞项 -->
+
+- 
+
+## Recent Wins 🎉
+<!-- 最近的成就 -->
+
+- {{CREATED_AT}}: Project created
+
+---
+
+*Last updated: {{CREATED_AT}}*

package/templates/shared/memory/projectbrief.md

@@ -0,0 +1,36 @@
+# Project Brief
+
+## Overview
+<!-- 项目的核心定义，所有其他文档的基础 -->
+
+**项目名称**: {{PROJECT_NAME}}
+
+**创建时间**: {{CREATED_AT}}
+
+## Core Requirements
+<!-- 项目必须实现的核心功能 -->
+
+1. 
+
+## Goals
+<!-- 项目的主要目标 -->
+
+- 
+
+## Scope
+<!-- 项目范围边界 -->
+
+### In Scope
+- 
+
+### Out of Scope
+- 
+
+## Success Criteria
+<!-- 如何判断项目成功 -->
+
+- 
+
+---
+
+*This is the foundation document. All other memory files build upon this.*

package/templates/shared/memory/systemPatterns.md

@@ -0,0 +1,39 @@
+# System Patterns
+
+## Architecture Overview
+<!-- 系统整体架构 -->
+
+```
+[Diagram or description]
+```
+
+## Key Technical Decisions
+<!-- 重要的技术决策及原因 -->
+
+| Decision | Rationale | Date |
+|----------|-----------|------|
+| | | |
+
+## Design Patterns
+<!-- 项目中使用的设计模式 -->
+
+### Pattern 1
+- **Name**: 
+- **Usage**: 
+- **Example**: 
+
+## Component Relationships
+<!-- 组件之间的关系 -->
+
+```
+ComponentA → ComponentB → ComponentC
+```
+
+## Coding Conventions
+<!-- 代码规范 -->
+
+- 
+
+---
+
+*Updated when architecture or patterns change.*

package/templates/shared/memory/techContext.md

@@ -0,0 +1,51 @@
+# Tech Context
+
+## Tech Stack
+<!-- 技术栈 -->
+
+| Category | Technology | Version |
+|----------|------------|---------|
+| Language | | |
+| Framework | | |
+| Database | | |
+| Deployment | | |
+
+## Development Setup
+<!-- 开发环境配置 -->
+
+```bash
+# Clone and setup
+git clone <repo>
+cd {{PROJECT_NAME}}
+
+# Install dependencies
+
+
+# Run development server
+
+```
+
+## Dependencies
+<!-- 主要依赖 -->
+
+### Production
+- 
+
+### Development
+- 
+
+## Technical Constraints
+<!-- 技术限制 -->
+
+- 
+
+## Environment Variables
+<!-- 环境变量 -->
+
+| Variable | Description | Required |
+|----------|-------------|----------|
+| | | |
+
+---
+
+*Updated when tech stack or constraints change.*

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

@@ -0,0 +1,54 @@
+# 清理记忆
+
+清理过期、冗余或琐碎的记忆 (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` 返回菜单"