openmemory-plus 1.0.0 → 1.1.0

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

@@ -0,0 +1,104 @@
+---
+description: '搜索记忆系统中的信息'
+argument-hint: '{query} [--source=all|project|user] [--limit=10]'
+---
+
+# /mem search
+
+搜索记忆系统中的信息。
+
+> 💡 返回入口: `/memory`
+
+## 触发
+
+- `/mem search {query}`
+- `/memory search {query}`
+- `搜索记忆 {query}`
+
+## 执行流程
+
+1. **并行查询两个系统**
+
+   ```
+   ┌─────────────────┐     ┌─────────────────┐
+   │   .memory/      │     │   openmemory    │
+   │   (grep/关键词) │     │   (语义搜索)    │
+   └────────┬────────┘     └────────┬────────┘
+            │                       │
+            └───────────┬───────────┘
+                        ↓
+                   结果融合
+   ```
+
+2. **搜索 .memory/**
+   - 使用 grep 在 YAML 文件中搜索关键词
+   - 返回匹配的文件和行
+
+3. **搜索 openmemory**
+   - 调用 `search_memory_openmemory`
+   - 参数: `query = "{用户输入}"`
+
+4. **结果融合**
+   - 按相关性排序
+   - 去重
+   - 标注来源
+
+## 输出格式
+
+```
+🔍 搜索结果: "{query}"
+
+📁 项目记忆 (.memory/)
+├── project.yaml:15 - deployment.vercel.url: https://...
+└── decisions.yaml:23 - 选择 XYZ 公式作为简历格式
+
+🧠 用户记忆 (openmemory)
+├── [2026-02-01] 用户偏好使用中文
+└── [2026-01-28] 用户熟悉 Python 和 TypeScript
+
+共找到 4 条相关记忆
+```
+
+## 参数
+
+| 参数 | 说明 | 默认值 |
+|------|------|--------|
+| query | 搜索关键词 | 必填 |
+| --source | 仅搜索指定来源 | all |
+| --limit | 返回结果数量 | 10 |
+
+## 示例
+
+```bash
+# 搜索所有记忆
+/mem search 部署配置
+
+# 仅搜索项目记忆
+/mem search 部署配置 --source=project
+
+# 仅搜索用户记忆
+/mem search 偏好 --source=user
+```
+
+## 无结果处理
+
+```
+🔍 搜索结果: "xxx"
+
+未找到相关记忆。
+
+💡 建议:
+- 尝试不同的关键词
+- 使用 /mem status 查看记忆状态
+```
+
+## 降级策略
+
+当 openmemory 不可用时:
+- 仅返回 .memory/ 结果
+- 提示 "openmemory 暂不可用，仅显示项目记忆"
+
+---
+
+**版本**: v1.1
+

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

@@ -0,0 +1,76 @@
+---
+description: '显示记忆系统状态概览'
+argument-hint: ''
+---
+
+# /mem status
+
+显示记忆系统状态概览。
+
+> 💡 返回入口: `/memory`
+
+## 触发
+
+- `/mem status`
+- `/memory status`
+- `记忆状态`
+
+## 执行流程
+
+1. **检查 .memory/ 目录**
+   ```bash
+   ls -la .memory/*.yaml 2>/dev/null | wc -l
+   du -sh .memory/ 2>/dev/null
+   ```
+
+2. **检查 openmemory MCP**
+   - 调用 `list_memories_openmemory` 获取记忆数量
+   - 检测 MCP 连接状态
+
+3. **输出格式**
+
+```
+📊 记忆系统状态
+├── .memory/ (项目级)
+│   ├── 文件数: {count} 个
+│   ├── 总大小: {size}
+│   └── 最后更新: {timestamp}
+├── openmemory (用户级)
+│   ├── 记忆数: {count} 条
+│   ├── MCP 状态: ✅ 已连接 / ❌ 未连接
+│   └── 最后同步: {timestamp}
+└── 健康状态: ✅ 正常 / ⚠️ 部分可用 / ❌ 异常
+```
+
+## 健康状态判断
+
+| 状态 | 条件 |
+|------|------|
+| ✅ 正常 | 两个系统都可用 |
+| ⚠️ 部分可用 | openmemory 不可用，仅 .memory/ 可用 |
+| ❌ 异常 | .memory/ 目录不存在或不可读 |
+
+## 示例输出
+
+```
+📊 记忆系统状态
+├── .memory/ (项目级)
+│   ├── 文件数: 4 个
+│   ├── 总大小: 12KB
+│   └── 最后更新: 2026-02-02 10:30
+├── openmemory (用户级)
+│   ├── 记忆数: 47 条
+│   ├── MCP 状态: ✅ 已连接
+│   └── 端点: localhost:8765
+└── 健康状态: ✅ 正常
+```
+
+## 错误处理
+
+- openmemory 连接失败：显示 "MCP 状态: ❌ 未连接"，建议检查服务
+- .memory/ 不存在：提示创建目录
+
+---
+
+**版本**: v1.1
+

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

@@ -0,0 +1,106 @@
+---
+description: '同步两个记忆系统，检测并解决冲突'
+argument-hint: ''
+---
+
+# /mem sync
+
+同步两个记忆系统，检测并解决冲突。
+
+> 💡 返回入口: `/memory`
+
+## 触发
+
+- `/mem sync`
+- `/memory sync`
+- `同步记忆`
+
+## 执行流程
+
+```
+/mem sync
+    ↓
+1. 读取 .memory/ 关键配置
+    ↓
+2. 搜索 openmemory 相关记忆
+    ↓
+3. 比对检测冲突
+    ↓
+4. 展示冲突列表
+    ↓
+5. 用户确认解决方案
+    ↓
+6. 更新/删除过时记录
+```
+
+## 冲突检测逻辑
+
+### 检测范围
+
+| 类型 | .memory/ 字段 | openmemory 关键词 |
+|------|---------------|-------------------|
+| 部署 URL | `deployment.*.url` | 部署, deploy, url |
+| 项目路径 | `paths.*` | 路径, path, 目录 |
+| 技术选型 | `decisions.*.choice` | 选择, 采用, 使用 |
+
+### 冲突判定
+
+1. 提取 `.memory/` 中的关键值
+2. 搜索 `openmemory` 相关记忆
+3. 比对同类信息是否一致
+4. 不一致 → 标记为冲突
+
+## 输出格式
+
+### 无冲突
+
+```
+🔄 记忆同步检查
+
+✅ 两个系统数据一致，无需同步
+
+检查项目:
+├── 部署 URL: 一致
+├── 项目路径: 一致
+└── 技术决策: 一致
+```
+
+### 发现冲突
+
+```
+🔄 记忆同步检查
+
+⚠️ 发现 2 处冲突:
+
+1. 部署 URL
+   ├── .memory/: https://old-url.vercel.app
+   └── openmemory: https://new-url.vercel.app
+   
+   [1] 保留 .memory/ 版本
+   [2] 保留 openmemory 版本
+   [3] 跳过
+
+请选择解决方案 (输入数字):
+```
+
+## 解决冲突
+
+| 选择 | 操作 |
+|------|------|
+| 保留 .memory/ | 删除 openmemory 中的过时记忆 |
+| 保留 openmemory | 更新 .memory/ 对应字段 |
+| 跳过 | 不处理，保留两边 |
+
+## 自动同步规则
+
+**优先级**: `.memory/` > `openmemory`
+
+原因:
+- `.memory/` 有 Git 版本控制
+- `.memory/` 是项目级 SSOT
+- `openmemory` 可能包含过时对话记忆
+
+---
+
+**版本**: v1.1
+

package/templates/shared/commands/memory.md

@@ -0,0 +1,89 @@
+---
+description: '记忆管理系统入口 - 查看状态、搜索、同步、清理'
+argument-hint: 'status|search|sync|clean|help [args]'
+---
+
+# /memory
+
+统一记忆管理系统入口。管理 `.memory/` (项目级) 和 `openmemory` (用户级) 双层记忆。
+
+## 快速使用
+
+| 命令 | 说明 |
+|------|------|
+| `/memory` | 显示快速状态 + 子命令列表 |
+| `/mem status` | 详细记忆状态 |
+| `/mem search {query}` | 搜索记忆 |
+| `/mem sync` | 检测并解决冲突 |
+| `/mem clean` | 清理 ROT (冗余/过时/琐碎) |
+| `/mem extract` | 手动触发记忆提取 |
+| `/memory help` | 完整帮助文档 |
+
+## 路由逻辑
+
+### 无参数时
+
+执行快速状态检查并显示子命令：
+
+```
+📊 记忆系统快速状态
+├── .memory/: {n} 个文件
+├── openmemory: {n} 条记忆
+└── 状态: ✅ 正常
+
+💡 可用命令:
+  /mem status    - 详细状态
+  /mem search    - 搜索记忆
+  /mem sync      - 同步检查
+  /mem clean     - 清理 ROT
+  /mem extract   - 提取记忆
+```
+
+### 有参数时
+
+根据子命令路由到对应功能：
+
+| 子命令 | 加载文件 |
+|--------|----------|
+| `status` | `mem-status.md` |
+| `search` | `mem-search.md` |
+| `sync` | `mem-sync.md` |
+| `clean` | `mem-clean.md` |
+| `extract` | `mem-extract.md` |
+| `help` | 显示本文件完整内容 |
+
+## 系统架构
+
+```
+Agent 记忆系统
+├── .memory/ (项目级)
+│   ├── project.yaml     # 项目配置、部署信息 (SSOT)
+│   ├── decisions.yaml   # 技术决策记录
+│   └── changelog.yaml   # 变更历史
+└── openmemory (用户级)
+    ├── 用户偏好          # 跨项目通用
+    ├── 用户技能          # 个人能力
+    └── 对话上下文        # 历史记忆
+```
+
+## 分类规则
+
+| 信息类型 | 存储位置 | 示例 |
+|----------|----------|------|
+| 项目配置 | `.memory/` | 部署 URL、路径 |
+| 技术决策 | `.memory/` | 框架选择、架构 |
+| 用户偏好 | `openmemory` | 语言、风格 |
+| 用户技能 | `openmemory` | 熟悉的技术栈 |
+
+详细规则: `.rules/memory/classification.md`
+
+## 相关文件
+
+- **分类规则**: `.rules/memory/classification.md`
+- **提取 Skill**: `.augment/skills/memory-extraction/SKILL.md`
+- **配置中心**: `.memory/project.yaml`
+
+---
+
+**版本**: v1.0
+

package/templates/shared/rules/classification.md

@@ -0,0 +1,108 @@
+# Memory Classification Rules
+
+记忆分类规则，定义信息存储位置决策逻辑。
+
+## 存储位置决策表
+
+| 信息类型 | 存储位置 | 识别关键词 |
+|----------|----------|------------|
+| 项目配置 | `.memory/project.yaml` | url, domain, deploy, vercel, config, path |
+| 技术决策 | `.memory/decisions.yaml` | 决定, 选择, 采用, 架构, decision, choose |
+| 变更记录 | `.memory/changelog.yaml` | 更新, 修改, 发布, update, change, release |
+| 用户偏好 | `openmemory` | 偏好, 喜欢, 习惯, prefer, style, always |
+| 用户技能 | `openmemory` | 会, 熟悉, 经验, skill, experience, know |
+| 对话上下文 | `openmemory` | 之前, 上次, 记得, remember, last time |
+
+## 分类优先级
+
+1. **项目相关** → `.memory/` (Git 版本控制)
+2. **用户相关** → `openmemory` (跨项目共享)
+3. **混合信息** → 拆分存储到两个系统
+
+## 敏感信息过滤
+
+**禁止存储**（检测后阻止）:
+
+| 类型 | 检测模式 |
+|------|----------|
+| API Key | `sk-`, `api_key`, `token=`, `bearer` |
+| 密码 | `password`, `secret`, `credential` |
+| 私钥 | `-----BEGIN`, `PRIVATE KEY` |
+| 个人信息 | 身份证号, 银行卡号, 手机号 |
+
+## 分类决策流程
+
+```
+信息输入
+    ↓
+敏感信息检测 → 是 → 阻止存储，提示用户
+    ↓ 否
+项目相关判断 → 是 → .memory/{category}.yaml
+    ↓ 否
+用户相关判断 → 是 → openmemory (add_memories)
+    ↓ 否
+丢弃 (琐碎信息)
+```
+
+## 项目相关信息判断
+
+**存入 `.memory/` 的条件**:
+- 包含项目路径、URL、域名
+- 涉及部署配置、环境变量名（非值）
+- 技术架构决策
+- 项目里程碑、版本信息
+
+## 用户相关信息判断
+
+**存入 `openmemory` 的条件**:
+- 用户表达偏好 ("我喜欢...", "以后都用...")
+- 用户技能声明 ("我会...", "我熟悉...")
+- 跨项目通用的习惯
+- 用户个人经历、背景
+
+## ROT 过滤规则
+
+**不存储的信息**:
+
+| 类型 | 示例 |
+|------|------|
+| 琐碎确认 | "好的", "OK", "明白了" |
+| 临时状态 | "正在处理...", "稍等" |
+| 重复信息 | 已存在的相同内容 |
+| 过期信息 | 被明确否定或更新的旧信息 |
+
+## MCP 工具调用
+
+### 写入 openmemory
+
+```
+Tool: add_memories_openmemory
+Parameter: text = "{提取的用户信息}"
+```
+
+### 搜索 openmemory
+
+```
+Tool: search_memory_openmemory
+Parameter: query = "{搜索关键词}"
+```
+
+### 列出所有记忆
+
+```
+Tool: list_memories_openmemory
+```
+
+## 降级策略
+
+**当 openmemory 不可用时**:
+1. 检测 MCP 连接状态
+2. 降级到仅 `.memory/` 存储
+3. 用户相关信息临时存入 `.memory/user-context.yaml`
+4. 服务恢复后提示同步
+
+---
+
+**版本**: v1.0
+**更新日期**: 2026-02-02
+