openmemory-plus 1.1.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/commands/mem-clean.md

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

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

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

@@ -1,112 +0,0 @@
-# /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*
-