openmemory-plus 1.0.0 → 1.1.0

package/templates/augment/AGENTS.md

@@ -0,0 +1,65 @@
+# OpenMemory Plus - Agent 记忆管理
+
+本项目已启用 OpenMemory Plus 双层记忆管理系统。
+
+## 快速使用
+
+| 命令 | 说明 |
+|------|------|
+| `/memory` | 查看记忆状态 + 子命令列表 |
+| `/mem status` | 详细记忆状态 |
+| `/mem search {query}` | 搜索记忆 |
+| `/mem sync` | 同步检查 |
+| `/mem clean` | 清理 ROT 记忆 |
+| `/mem extract` | 手动提取记忆 |
+
+## 双层记忆架构
+
+```
+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,44 @@
+# OpenMemory Plus 配置
+
+## 记忆管理系统
+
+本项目已启用 OpenMemory Plus 双层记忆管理。
+
+### 命令入口
+
+| 命令 | 说明 |
+|------|------|
+| `/memory` | 统一入口 (快速状态 + 帮助) |
+| `/mem status` | 详细记忆状态 |
+| `/mem search {query}` | 搜索记忆 |
+| `/mem sync` | 同步检查 |
+| `/mem clean` | 清理 ROT |
+| `/mem extract` | 手动提取 |
+
+### 存储架构
+
+| 系统 | 存储位置 | 用途 |
+|------|----------|------|
+| 项目级 | `.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,43 @@
+# OpenMemory Plus - Agent 记忆管理
+
+本项目已启用 OpenMemory Plus 双层记忆管理系统。
+
+## 快速使用
+
+| 命令 | 说明 |
+|------|------|
+| `/memory` | 查看记忆状态 + 子命令列表 |
+| `/mem status` | 详细记忆状态 |
+| `/mem search {query}` | 搜索记忆 |
+| `/mem sync` | 同步检查 |
+| `/mem clean` | 清理 ROT 记忆 |
+| `/mem extract` | 手动提取记忆 |
+
+## 双层记忆架构
+
+| 层级 | 存储 | 用途 |
+|------|------|------|
+| 项目级 | `.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,65 @@
+# OpenMemory Plus - Agent 记忆管理
+
+本项目已启用 OpenMemory Plus 双层记忆管理系统。
+
+## 快速使用
+
+| 命令 | 说明 |
+|------|------|
+| `/memory` | 查看记忆状态 + 子命令列表 |
+| `/mem status` | 详细记忆状态 |
+| `/mem search {query}` | 搜索记忆 |
+| `/mem sync` | 同步检查 |
+| `/mem clean` | 清理 ROT 记忆 |
+| `/mem extract` | 手动提取记忆 |
+
+## 双层记忆架构
+
+```
+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/mem-clean.md

@@ -0,0 +1,117 @@
+---
+description: '清理 ROT (冗余/过时/琐碎) 记忆'
+argument-hint: '[--dry-run] [--force] [--type=all|redundant|outdated|trivial]'
+---
+
+# /mem clean
+
+清理 ROT (Redundant, Outdated, Trivial) 记忆。
+
+> 💡 返回入口: `/memory`
+
+## 触发
+
+- `/mem clean`
+- `/memory clean`
+- `清理记忆`
+
+## 执行流程
+
+```
+/mem clean
+    ↓
+1. 列出所有 openmemory 记忆
+    ↓
+2. 分析识别 ROT
+    ↓
+3. 生成清理报告
+    ↓
+4. 用户确认
+    ↓
+5. 批量删除
+```
+
+## ROT 识别规则
+
+### Redundant (冗余)
+
+| 规则 | 说明 |
+|------|------|
+| 语义相似度 >90% | 两条记忆表达相同意思 |
+| 完全重复 | 文本完全相同 |
+| 子集包含 | 一条记忆是另一条的子集 |
+
+### Outdated (过时)
+
+| 规则 | 说明 |
+|------|------|
+| 被明确否定 | "不再使用 X" 后 X 相关记忆 |
+| 版本过时 | 旧版本配置信息 |
+| 时间过期 | 临时性信息超过有效期 |
+
+### Trivial (琐碎)
+
+| 规则 | 说明 |
+|------|------|
+| 长度 <10 字符 | 过短无意义 |
+| 纯确认语 | "好的", "OK", "明白" |
+| 无实质内容 | 无法提取有价值信息 |
+
+## 输出格式
+
+```
+🧹 记忆清理分析
+
+扫描完成: 共 47 条记忆
+
+📊 ROT 分析结果:
+
+🔴 Redundant (冗余): 3 条
+├── [ID: abc123] "用户偏好中文"
+│   └── 与 [ID: def456] 重复
+
+🟡 Outdated (过时): 2 条
+├── [ID: mno345] "部署地址是 old-url"
+│   └── 已被新地址替代
+
+⚪ Trivial (琐碎): 5 条
+├── [ID: pqr678] "好的"
+
+---
+建议清理: 10 条 | 保留: 37 条
+
+确认清理? [y/N]:
+```
+
+## 安全机制
+
+1. **预览模式**: 默认只显示，不删除
+2. **确认机制**: 必须用户确认才执行
+3. **批量限制**: 单次最多删除 20 条
+4. **保护规则**: 最近 7 天的记忆不自动标记
+
+## 参数
+
+| 参数 | 说明 | 默认值 |
+|------|------|--------|
+| --dry-run | 仅预览，不删除 | true |
+| --force | 跳过确认 | false |
+| --type | 仅清理指定类型 | all |
+
+## 示例
+
+```bash
+# 预览清理
+/mem clean
+
+# 仅清理冗余
+/mem clean --type=redundant
+
+# 强制清理 (跳过确认)
+/mem clean --force
+```
+
+---
+
+**版本**: v1.1
+

package/templates/shared/commands/mem-decay.md

@@ -0,0 +1,81 @@
+# /mem decay - 记忆衰减状态
+
+显示记忆的时间衰减状态，帮助识别需要清理或刷新的记忆。
+
+## 使用方法
+
+```
+/mem decay [--cleanup] [--refresh <id>]
+```
+
+## 参数
+
+| 参数 | 说明 |
+|------|------|
+| `--cleanup` | 显示建议清理的记忆列表 |
+| `--refresh <id>` | 刷新指定记忆的访问时间 |
+
+## 衰减状态说明
+
+| 状态 | 说明 | 衰减分数 |
+|------|------|----------|
+| 🟢 Active | 活跃记忆，近期访问或高频使用 | 0.8 - 1.0 |
+| 🟡 Aging | 老化中，一段时间未访问 | 0.5 - 0.8 |
+| 🟠 Stale | 陈旧，长时间未访问 | 0.2 - 0.5 |
+| 🔴 Cleanup | 建议清理 | < 0.2 |
+
+## 衰减规则
+
+1. **宽限期**: 7 天内访问的记忆不衰减
+2. **核心记忆**: 访问次数 ≥ 5 的记忆永不衰减
+3. **衰减速率**: 宽限期后每天衰减 1%
+4. **清理阈值**: 90 天未访问且分数 < 0.2
+
+## 执行流程
+
+```yaml
+workflow:
+  - step: 加载记忆
+    action: 从 openmemory 获取所有记忆
+    
+  - step: 计算衰减
+    action: 对每条记忆计算衰减分数
+    
+  - step: 分组显示
+    action: 按状态分组展示
+    output: |
+      ## 📊 记忆衰减状态
+      
+      ### 🟢 Active (12 条)
+      - [ID: xxx] 用户偏好: 深色主题 (访问: 8次, 分数: 1.0)
+      - ...
+      
+      ### 🟡 Aging (5 条)
+      - [ID: yyy] 项目配置: API 端口 (访问: 2次, 分数: 0.65)
+      - ...
+      
+      ### 🔴 Cleanup (3 条)
+      - [ID: zzz] 临时笔记 (访问: 0次, 分数: 0.1)
+      
+      💡 运行 `/mem clean` 清理建议删除的记忆
+```
+
+## 刷新记忆
+
+当某条记忆仍然重要但长时间未访问时，可以手动刷新：
+
+```
+/mem decay --refresh abc123
+```
+
+这会更新记忆的 `lastAccessedAt` 时间，重置衰减计时。
+
+## 相关命令
+
+- `/mem clean` - 执行 ROT 清理
+- `/mem status` - 查看记忆状态
+- `/mem search` - 搜索记忆
+
+---
+*OpenMemory Plus v2.0 - Memory Decay System*
+

package/templates/shared/commands/mem-extract.md

@@ -0,0 +1,84 @@
+---
+description: 'Agent-only: 自动提取对话中的关键信息到记忆系统'
+argument-hint: ''
+---
+
+# /mem extract
+
+Agent-only 工作流，自动提取对话中的关键信息到 `.memory/` 目录和 `openmemory`。
+
+> 💡 返回入口: `/memory`
+
+## 触发方式
+
+### 自动触发（推荐）
+Agent 在以下情况自动执行，无需用户干预：
+- 对话结束时检测到有价值信息
+- 部署状态变更（成功/失败）
+- 重要技术决策
+- 项目配置变更
+
+### 手动触发
+```
+/mem extract
+保存到记忆
+记住这个
+更新配置
+```
+
+## 存储结构
+
+| 文件 | 用途 | 更新频率 |
+|------|------|----------|
+| `.memory/project.yaml` | 项目常量、部署信息 (SSOT) | 配置变更时 |
+| `.memory/decisions.yaml` | 技术决策记录 | 决策时 |
+| `.memory/changelog.yaml` | 变更历史 | 每次变更 |
+| `openmemory` | 用户偏好、技能、上下文 | 每次对话 |
+
+## 信息分类
+
+| 存储位置 | 信息类型 | 检测信号 |
+|----------|----------|----------|
+| `.memory/` | 部署变更 | `deploy`, `vercel`, URL |
+| `.memory/` | 服务配置 | `config`, `secret` |
+| `.memory/` | 技术决策 | `决定`, `选择`, `采用` |
+| `openmemory` | 用户偏好 | `喜欢`, `偏好`, `习惯` |
+| `openmemory` | 用户技能 | `熟悉`, `擅长`, `会用` |
+
+详细规则: `.rules/memory/classification.md`
+
+## 验证工具
+
+```bash
+# 验证所有 YAML 文件语法
+.augment/skills/memory-extraction/scripts/validate.sh
+
+# 验证单个文件
+.augment/skills/memory-extraction/scripts/validate.sh .memory/project.yaml
+```
+
+## 与其他系统的关系
+
+```
+.memory/           ← 项目级 (Git 版本控制)
+openmemory         ← 用户级 (MCP 语义搜索)
+_bmad/_memory/     ← Agent 专属 (BMAD Agent)
+```
+
+## 注意事项
+
+1. **Agent-Only**: 此命令主要供 Agent 自动使用
+2. **SSOT 原则**: 项目配置应引用 `.memory/project.yaml`
+3. **分类规则**: 遵循 `.rules/memory/classification.md`
+4. **降级策略**: openmemory 不可用时存入 `.memory/user-context.yaml`
+
+## 相关文件
+
+- **Skill**: `.augment/skills/memory-extraction/SKILL.md`
+- **分类规则**: `.rules/memory/classification.md`
+- **Schema**: `.memory/schema/*.json`
+
+---
+
+**版本**: v1.1
+

package/templates/shared/commands/mem-graph.md

@@ -0,0 +1,112 @@
+# /mem graph - 知识图谱
+
+管理和查询记忆的实体关系图谱。
+
+## 使用方法
+
+```
+/mem graph [subcommand] [options]
+```
+
+## 子命令
+
+| 子命令 | 说明 |
+|--------|------|
+| `show` | 显示图谱概览 |
+| `add <type> <name>` | 添加实体 |
+| `link <source> <target> <relation>` | 创建关系 |
+| `query <entity>` | 查询相关实体 |
+| `export` | 导出图谱 |
+
+## 实体类型
+
+| 类型 | 说明 | 示例 |
+|------|------|------|
+| `project` | 项目 | my-app |
+| `service` | 服务 | API, Worker |
+| `database` | 数据库 | PostgreSQL, Redis |
+| `api` | API 端点 | /users, /orders |
+| `config` | 配置 | 环境变量, 密钥 |
+| `person` | 人员 | 开发者, 用户 |
+| `technology` | 技术 | React, Node.js |
+| `decision` | 决策 | 架构选择 |
+| `preference` | 偏好 | 编码风格 |
+
+## 关系类型
+
+| 关系 | 说明 |
+|------|------|
+| `depends_on` | 依赖 |
+| `configured_by` | 被配置 |
+| `created_by` | 创建者 |
+| `uses` | 使用 |
+| `prefers` | 偏好 |
+| `decided` | 决定 |
+| `related_to` | 相关 |
+
+## 示例
+
+### 添加实体
+
+```
+/mem graph add service "User API"
+/mem graph add database "PostgreSQL"
+```
+
+### 创建关系
+
+```
+/mem graph link "User API" "PostgreSQL" depends_on
+```
+
+### 查询相关
+
+```
+/mem graph query "User API"
+```
+
+输出:
+```
+## 🔗 User API 的关系图
+
+User API (service)
+├── depends_on → PostgreSQL (database)
+├── configured_by → API Config (config)
+└── uses → JWT Auth (technology)
+```
+
+## 图谱存储
+
+图谱数据存储在 `.memory/graph.yaml`:
+
+```yaml
+entities:
+  - id: "uuid-1"
+    type: "service"
+    name: "User API"
+    properties:
+      port: 3000
+      
+relations:
+  - id: "uuid-2"
+    sourceId: "uuid-1"
+    targetId: "uuid-3"
+    type: "depends_on"
+```
+
+## 自动提取
+
+对话中提到的实体和关系会被自动提取到图谱：
+
+- "API 服务依赖 PostgreSQL 数据库" → 自动创建实体和关系
+- "我们决定使用 React 作为前端框架" → 创建 decision 和 technology 实体
+
+## 相关命令
+
+- `/mem status` - 查看记忆状态
+- `/mem search` - 搜索记忆
+- `/mem decay` - 查看衰减状态
+
+---
+*OpenMemory Plus v2.0 - Graph Memory System*
+