openmemory-plus 1.0.0 → 1.2.0

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

@@ -0,0 +1,64 @@
+# 衰减分析
+
+分析记忆的时间衰减状态。
+
+## 执行步骤
+
+1. 调用 `list_memories_openmemory` 获取所有记忆
+2. 计算每条记忆的衰减分数
+3. 按状态分组展示
+4. 提供清理建议
+
+## 衰减算法
+
+基于时间的衰减公式：
+
+```
+score = baseScore * (1 - decayRate * daysSinceCreation)
+      + accessBonus * recentAccessCount
+      + importanceWeight
+```
+
+## 衰减状态
+
+| 状态 | 分数范围 | 含义 | 建议操作 |
+|------|----------|------|----------|
+| 🟢 Active | 0.7 - 1.0 | 活跃，经常使用 | 保留 |
+| 🟡 Aging | 0.3 - 0.7 | 老化，需要关注 | 考虑更新 |
+| 🔴 Stale | 0.1 - 0.3 | 陈旧，考虑清理 | 建议清理 |
+| ⚫ Cleanup | 0 - 0.1 | 待清理 | 强烈建议删除 |
+
+## 输出格式
+
+```
+⏰ 记忆衰减分析
+
+📊 总览: 15 条记忆
+
+🟢 Active (12条) ████████████░░░ 80%
+├── 用户偏好中文对话 [1.00]
+├── 熟悉 TypeScript [0.95]
+├── 项目使用 Vitest 测试 [0.88]
+└── ... 更多 (输入 "展开 active" 查看全部)
+
+🟡 Aging (2条) ██░░░░░░░░░░░░░ 13%
+├── 旧项目使用 Webpack [0.45]
+└── 偏好 Vim 编辑器 [0.38]
+
+🔴 Stale (1条) █░░░░░░░░░░░░░░ 7%
+└── 使用 jQuery [0.12]
+
+💡 建议: 
+- 清理 1 条 Stale 记忆
+- 关注 2 条 Aging 记忆，考虑是否仍然相关
+```
+
+## 后续操作
+
+- "清理 stale" → 删除所有 Stale 状态记忆
+- "刷新第 N 条" → 更新访问时间，重置衰减
+- "展开 active" → 显示所有 Active 记忆详情
+
+## 返回菜单
+
+完成后提示: "还需要其他操作吗？输入 `/memory` 返回菜单"

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

@@ -0,0 +1,75 @@
+# 知识图谱
+
+查看记忆中的实体关系图谱。
+
+## 执行步骤
+
+1. 读取 `.memory/graph.yaml` (如果存在)
+2. 从项目信息和记忆中提取实体
+3. 分析实体之间的关系
+4. 可视化展示
+
+## 实体类型
+
+| 类型 | 示例 |
+|------|------|
+| project | openmemory-plus |
+| service | API, CLI, Web |
+| database | Qdrant, PostgreSQL |
+| api | REST API, GraphQL |
+| config | tsconfig.json, package.json |
+| person | 用户名, 团队成员 |
+| technology | TypeScript, React |
+| decision | 技术选型, 架构决策 |
+| preference | 用户偏好 |
+
+## 关系类型
+
+| 关系 | 含义 |
+|------|------|
+| uses | A 使用 B |
+| depends_on | A 依赖 B |
+| configured_by | A 由 B 配置 |
+| created_by | A 由 B 创建 |
+| related_to | A 与 B 相关 |
+| stores_in | A 存储在 B |
+| prefers | 用户偏好 A |
+
+## 输出格式
+
+```
+🔗 知识图谱
+
+项目: openmemory-plus
+
+实体关系:
+┌─────────────────────────────────────────┐
+│                                         │
+│  [CLI] ──uses──> [TypeScript]           │
+│    │                                    │
+│    ├──depends_on──> [Commander.js]      │
+│    │                                    │
+│    └──configured_by──> [tsconfig.json]  │
+│                                         │
+│  [openmemory] ──uses──> [Qdrant]        │
+│       │                                 │
+│       └──uses──> [BGE-M3]               │
+│                                         │
+│  [User] ──prefers──> [中文]             │
+│       │                                 │
+│       └──prefers──> [TypeScript]        │
+│                                         │
+└─────────────────────────────────────────┘
+
+统计: 8 个实体, 7 个关系
+```
+
+## 后续操作
+
+- "添加关系" → 手动添加实体关系
+- "查看 [实体名]" → 展示该实体的所有关系
+- "导出" → 导出为 Mermaid/DOT 格式
+
+## 返回菜单
+
+完成后提示: "还需要其他操作吗？输入 `/memory` 返回菜单"

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

@@ -0,0 +1,38 @@
+# 搜索记忆
+
+在项目级和用户级记忆中进行语义搜索。
+
+## 执行步骤
+
+1. 询问搜索关键词（如果用户未提供）
+2. 调用 `search_memory_openmemory` 搜索用户记忆
+3. 同时搜索 `.memory/` 目录下的 YAML 文件
+4. 按相关度排序，合并展示结果
+
+## 输出格式
+
+```
+🔍 搜索结果: "{query}"
+
+📁 项目级结果:
+1. [decisions.yaml] 技术决策: 使用 TypeScript
+   匹配度: 0.85
+
+👤 用户级结果:
+1. 用户偏好使用 pnpm 包管理器
+   创建时间: 30天前 | 衰减状态: Active
+
+共找到 2 条相关记忆
+```
+
+## 后续操作
+
+用户可以继续操作：
+
+- "删除第 N 条" → 执行删除
+- "查看详情" → 展示完整内容
+- "更新第 N 条" → 修改记忆内容
+
+## 返回菜单
+
+完成后提示: "还需要其他操作吗？输入 `/memory` 返回菜单"

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

@@ -0,0 +1,35 @@
+# 记忆状态
+
+查看项目级和用户级记忆的详细状态。
+
+## 执行步骤
+
+1. 读取 `.memory/` 目录，列出文件和最后修改时间
+2. 调用 `list_memories_openmemory` 获取用户记忆
+3. 分析衰减状态分布
+4. 统计并展示
+
+## 输出格式
+
+```
+📊 记忆系统详细状态
+
+📁 项目级 (.memory/)
+├── project.yaml    (2024-01-15 更新)
+├── decisions.yaml  (2024-01-10 更新)
+└── changelog.yaml  (2024-01-14 更新)
+
+👤 用户级 (openmemory)
+├── 总记忆数: 15 条
+├── 最近添加: "用户偏好中文对话" (1天前)
+└── 衰减状态:
+    ├── 🟢 Active:  12 条
+    ├── 🟡 Aging:   2 条
+    └── 🔴 Stale:   1 条
+
+✅ 系统状态正常
+```
+
+## 返回菜单
+
+完成后提示: "还需要其他操作吗？输入 `/memory` 返回菜单"

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

@@ -0,0 +1,45 @@
+# 存储记忆
+
+手动添加新的记忆到系统中。
+
+## 执行步骤
+
+1. 询问要存储的内容（如果用户未提供）
+2. 分析信息类型，确定存储位置
+3. 确认存储位置
+4. 执行存储
+
+## 分类逻辑
+
+根据信息特征自动路由到合适的存储位置：
+
+| 信息特征 | 存储位置 | 操作 |
+|----------|----------|------|
+| 包含项目路径/URL/配置 | `.memory/project.yaml` | 写入 YAML |
+| 包含技术决策 ("选择"、"决定"、"使用") | `.memory/decisions.yaml` | 写入 YAML |
+| 用户偏好 ("喜欢"、"偏好"、"习惯") | openmemory | `add_memories_openmemory` |
+| 用户技能 ("熟悉"、"擅长"、"会用") | openmemory | `add_memories_openmemory` |
+| 其他 | 询问用户选择 | - |
+
+## 输出格式
+
+```
+💾 记忆已存储
+
+类型: 用户偏好
+内容: "偏好使用 TypeScript 而非 JavaScript"
+位置: openmemory
+时间: 2024-01-15 10:30
+
+还需要存储其他信息吗？
+```
+
+## 批量存储
+
+支持一次存储多条信息：
+- "这个项目用 React，部署在 Vercel，域名是 xxx.com"
+- 自动拆分并分类存储
+
+## 返回菜单
+
+完成后提示: "还需要其他操作吗？输入 `/memory` 返回菜单"

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

@@ -0,0 +1,50 @@
+# 同步检查
+
+检测项目级和用户级记忆之间的冲突。
+
+## 执行步骤
+
+1. 读取 `.memory/` 中的所有信息
+2. 搜索 openmemory 中的相关记忆
+3. 检测冲突（同一主题不同值）
+4. 展示冲突列表
+5. 提示用户选择解决方式
+
+## 冲突类型
+
+| 冲突类型 | 示例 | 解决方式 |
+|----------|------|----------|
+| 值不一致 | 项目级: "用 npm" vs 用户级: "偏好 pnpm" | 用户选择保留哪个 |
+| 重复记录 | 两处都记录了部署 URL | 合并或删除重复 |
+| 过期信息 | 项目级配置已更新，用户级未同步 | 更新用户级 |
+
+## 输出格式
+
+```
+🔄 同步检查结果
+
+发现 2 个冲突:
+
+⚠️ 冲突 1: 包管理器偏好不一致
+├── 📁 项目级: 使用 npm (package-lock.json 存在)
+└── 👤 用户级: "偏好使用 pnpm"
+
+建议: 更新用户记忆以匹配项目配置
+操作: [A] 保留项目级 [B] 保留用户级 [S] 跳过
+
+⚠️ 冲突 2: 部署 URL 重复
+├── 📁 项目级: deploy_url: "https://xxx.vercel.app"
+└── 👤 用户级: "项目部署在 https://xxx.vercel.app"
+
+建议: 删除用户级重复记录
+操作: [A] 删除用户级 [B] 保留两者 [S] 跳过
+```
+
+## 自动同步选项
+
+- "全部自动" - 按建议自动处理所有冲突
+- "逐个处理" - 一个一个确认
+
+## 返回菜单
+
+完成后提示: "还需要其他操作吗？输入 `/memory` 返回菜单"

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
+