@bsbofmusic/memos-memu-local-memory-tools-for-agent 1.3.2 → 1.3.3

package/SKILL.md

@@ -0,0 +1,115 @@
+---
+name: memory-triple-recall
+description: |
+  三层记忆召回：File Brain → memos + memuK（MCP，同时查询）。
+  默认调用：mcporter call memos-memu-local-memory-tools-for-agent memos_memuk_query query="<关键词>"
+  Layer 2 强制并行，不允许串行分开查。
+triggers: 回忆|回想|记得|原话|哪天|什么时候|答应过|之前|历史|进展|有没有说过|问过你
+version: 2.2.0
+updated: 2026-03-28
+---
+
+# 三层记忆召回 — Memory Triple Recall
+
+## 架构
+
+```
+Layer 1  File Brain      → 稳定事实、规则、拍板决定
+Layer 2  memos + memuK  ← 必须同时触发，不用等
+  ↓  memos（原话、原始内容）+ memuK（摘要、跨session）
+```
+
+---
+
+## 调用规则（强制）
+
+### Layer 1：File Brain
+- 直接读 `MEMORY.md` / `memory/*.md`
+- 适用：系统规则、拍板结论、阶段总结、配置拍板
+
+### Layer 2：memos + memuK（MCP，必须同时触发）
+```
+mcporter call memos-memu-local-memory-tools-for-agent memos_memuk_query query="<关键词>" limit=10
+```
+- **关键词提取规则（必须执行）**：
+  1. 先把问题拆成短句，去掉语气词（吗、呢、吧、啊、呀）、标点符号
+  2. 提取核心名词、动词短语、人名、地名、项目名
+  3. 多个关键词都要试，不要只试一个
+  4. 常见例子：
+     - "我喜欢的女星是谁" → 优先试"Leah Gotti"，然后"喜欢的女星"，然后"女星"
+     - "之前我们有没有聊过npm token的事" → 优先试"npm token"，然后"npm"，然后"token"
+     - "3月9日有什么重要的事" → 优先试"3月9日"，然后"重要的事"
+     - "穿孔枕项目最近进展" → 优先试"穿孔枕"，然后"piercing pillow"，然后"项目进展"
+- 适用：**所有个人事实类问题**，包括但不限于：
+  - 喜欢什么、最爱谁
+  - 女友、crush、女星
+  - 个人偏好、私人事实
+  - 具体承诺、时间点
+  - "之前说过"、"原话"
+- **禁止**：凭记忆直接答，必须调 MCP 工具查
+- 如果 Layer 1 已经明确记载，直接答；Layer 1 没有的，必须走 Layer 2（用合并的工具同时查两个数据库）
+
+---
+
+## 问题路由表
+
+| 问题类型 | 示例 | 路由 |
+|---------|------|------|
+| 系统规则/配置 | "我的 MCP 有哪些工具" | Layer 1（MEMORY.md）|
+| 个人偏好/事实 | "我喜欢什么"、"我女友是谁" | **Layer 2 必须** |
+| 承诺/时间点 | "我什么时候答应过" | **Layer 2 必须** |
+| 原话 | "我当时怎么说的" | **Layer 2 必须** |
+| 模糊主题 | "我们聊过 XXX 吗" | Layer 2 → Layer 3 |
+| 稳定结论 | "上次排障结论是什么" | Layer 1 已有则直接答 |
+| 最新 session | 最近 15 分钟的对话 | Layer 2（还没被 ingest 则走 session）|
+
+---
+
+## 输出格式
+
+```
+已确认事实（来自 Layer X）：
+- ...
+
+原话·证据（来自 memos id:xxx）：
+> ...
+
+仍不确定点：
+- ...
+```
+
+三层全空时：
+```
+已确认事实 → [空]
+原话·证据 → [空]
+仍不确定点 → 此话题在三层记忆中均无记录。
+```
+
+---
+
+## 强制执行约束
+
+1. **Layer 2 必须并行**：任何个人事实类问题，第一动作必须是 `memos_memuk_query` 并行同时查两个库，不允许先查一个再查另一个
+2. **不制造记忆**：memos + memuK 都查不到就说查不到，禁止编造
+3. **证据要引用**：从返回结果里引用原文，不要自己总结
+4. **版本时效**：memos ingest 延迟 ~15 分钟，超短窗口内的问题可标注"可能尚未 ingest"
+
+---
+
+## MCP 工具参考
+
+```bash
+# Layer 2 查询（memos + memuK 同时并行，禁止分开）
+mcporter call memos-memu-local-memory-tools-for-agent memos_memuk_query query="<关键词>" limit=10
+```
+
+---
+
+## 零证据时的标准回复
+
+当三层全空时，使用以下标准回复，不要自行发挥：
+
+> 已确认事实 → [空]
+> 原话·证据 → [空]
+> 仍不确定点 → 此话题在三层记忆中均无记录。建议直接告诉我。
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bsbofmusic/memos-memu-local-memory-tools-for-agent",
-  "version": "1.3.2",
+  "version": "1.3.3",
   "description": "MCP server — one-shot install + query for memos (PostgreSQL) and memuK (SQLite) local memory. Designed for OpenClaw agents.",
   "main": "src/index.js",
   "type": "module",

package/src/tools/install.js

@@ -163,50 +163,24 @@ INSERT OR IGNORE INTO memu_sync_checkpoint (key, value) VALUES ('last_memo_id',
   }
 
   // ── SKILL ────────────────────────────────────────────────────────────────
-  const skillDir = path.join(env.skillDir, 'memory-triple-recall');
+  const skillDir = path.join(env.workspaceDir, 'skills', 'memory-triple-recall');
   const skillFile = path.join(skillDir, 'SKILL.md');
-  const today = new Date().toISOString().split('T')[0];
+  // Copy bundled SKILL.md from the npm package (bundled at ../SKILL.md relative to this file)
+  const bundledSkill = path.join(__dirname, '..', '..', 'SKILL.md');
 
-  const skillContent = `---
-name: memory-triple-recall
-description: |
-  Three-layer memory recall stack: MEMORY.md → memos (PostgreSQL) → memuK (SQLite).
-  Use for: original quotes, timing, commitments, topic recall, historical context.
-triggers: 回忆|回想|记得|原话|哪天|什么时候|答应过|之前|历史|进展
-version: 1.0.0
-updated: ${today}
----
-
-# Memory Triple Recall
-
-## Architecture
-| Layer | Store | Access |
-|-------|-------|--------|
-| File brain | MEMORY.md / memory/*.md | File system |
-| memos | PostgreSQL Docker | memos_query MCP tool |
-| memuK | SQLite | memuk_search MCP tool |
-
-## Fast path
-Do NOT trigger layered recall for atomic facts in USER.md / IDENTITY.md / injected context.
-
-## NEVER fast-path (always do Layer 1+2)
-- 喜欢、最爱、最喜欢的X
-- 女友、crush、个人偏好、私人事实
-
-## Default order
-1. File brain: stable facts, rules, decisions
-2. memos: original wording, timing, commitments (memos_query)
-3. memuK: fuzzy topic recall (memuk_search)
-
-## Output shape
-- 已确认事实
-- 原话·证据
-- 仍不确定点
-
-## Zero-evidence fallback
-已确认事实 → [空]
-原话·证据 → [空]
-仍不确定点 → 此话题在三层记忆中均无记录。
+  try {
+    fs.mkdirSync(skillDir, { recursive: true });
+    if (fs.existsSync(bundledSkill)) {
+      fs.copyFileSync(bundledSkill, skillFile);
+      report.ok('memory-triple-recall SKILL', `Installed → ${skillFile}`);
+    } else if (!fs.existsSync(skillFile)) {
+      report.fail('memory-triple-recall SKILL', `Bundled SKILL.md not found at ${bundledSkill}`);
+    } else {
+      report.skip('memory-triple-recall SKILL', 'Bundled SKILL.md not found — preserving existing');
+    }
+  } catch (err) {
+    report.fail('memory-triple-recall SKILL', err.message);
+  }
 `;
 
   try {
@@ -222,9 +196,11 @@ Do NOT trigger layered recall for atomic facts in USER.md / IDENTITY.md / inject
   }
 
   // ── Cron ─────────────────────────────────────────────────────────────────
+  const syncScript = path.join(env.workspaceDir, 'scripts', 'sync_memos_to_memuk.py');
+  const syncLog   = path.join(env.workspaceDir, 'logs', 'memuk-sync.log');
   const cronContent = `\
 # memos → memuK sync every 15 minutes
-*/15 * * * * root /var/lib/openclaw/.openclaw/workspace/scripts/sync_memos_to_memuk.py >> /var/lib/openclaw/.openclaw/workspace/logs/memuk-sync.log 2>&1
+*/15 * * * * ${process.env.USER || 'root'} ${syncScript} >> ${syncLog} 2>&1
 `.trim();
 
   const cronPath = '/etc/cron.d/memuk-sync';
@@ -235,7 +211,7 @@ Do NOT trigger layered recall for atomic facts in USER.md / IDENTITY.md / inject
   } catch {
     try {
       await sh(
-        `(crontab -l 2>/dev/null | grep -v "memuk-sync"; echo "*/15 * * * * /var/lib/openclaw/.openclaw/workspace/scripts/sync_memos_to_memuk.py >> /var/lib/openclaw/.openclaw/workspace/logs/memuk-sync.log 2>&1") | crontab -`,
+        `(crontab -l 2>/dev/null | grep -v "memuk-sync"; echo "*/15 * * * * ${process.env.USER || 'root'} ${syncScript} >> ${syncLog} 2>&1") | crontab -`,
         { timeout: 5000 }
       );
       report.ok('Sync cron', 'Installed via user crontab');
@@ -246,7 +222,8 @@ Do NOT trigger layered recall for atomic facts in USER.md / IDENTITY.md / inject
 
   // ── MCPorter config ────────────────────────────────────────────────────────
   const pkgName = 'memos-memu-local-memory-tools-for-agent';
-  const mcporterConfigPath = path.join(env.workspaceDir, 'mcporter.json');
+  // mcporter.json lives in workspace/config/ (not workspace/ directly)
+  const mcporterConfigPath = path.join(env.workspaceDir, 'config', 'mcporter.json');
   let existingConfig = {};
   if (fs.existsSync(mcporterConfigPath)) {
     try {