@dsh-overdrive/gateway 0.1.6 → 0.1.8

package/dist/memory.js

@@ -0,0 +1,100 @@
+// 记忆系统（对标 OpenClaw 的 long-term memory）。
+// 按 platform:userId 作用域存储用户显式记忆（/remember），支持搜索（/recall）与删除（/forget）；
+// 入站消息时自动检索相关记忆注入上下文，让 agent「记得你」。
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { randomUUID } from 'node:crypto';
+/** 作用域键：platform:userId（记忆跟随用户，跨频道共享，与 OpenClaw 一致）。 */
+export function memoryScope(adapterId, userId) {
+    return `${adapterId}:${userId}`;
+}
+/** 字符 2-gram：CJK 无空格分词，用共享 bigram 判断相关性（比子串包含更鲁棒）。 */
+function bigrams(text) {
+    const clean = text.toLowerCase();
+    const out = new Set();
+    for (let i = 0; i < clean.length - 1; i++)
+        out.add(clean.slice(i, i + 2));
+    return out;
+}
+/** 纯函数：按查询文本检索记忆——与查询共享任意 2-gram 即相关；空查询返回全部。 */
+export function searchMemories(entries, query) {
+    const queryBigrams = bigrams(query);
+    if (queryBigrams.size === 0)
+        return entries;
+    return entries.filter((entry) => {
+        const memoryBigrams = bigrams(entry.text);
+        for (const gram of queryBigrams) {
+            if (memoryBigrams.has(gram))
+                return true;
+        }
+        return false;
+    });
+}
+/** 纯函数：记忆列表 → 注入文本（拼在用户消息后）。 */
+export function formatMemories(entries) {
+    if (entries.length === 0)
+        return '';
+    const lines = entries.map((e) => `- ${e.text}`).join('\n');
+    return `\n📌 相关记忆：\n${lines}`;
+}
+/** JSON 文件持久化的记忆存储；file 缺省时仅内存（测试/无盘环境用）。 */
+export class MemoryStore {
+    data = new Map();
+    file;
+    constructor(file) {
+        this.file = file;
+        if (file && existsSync(file)) {
+            try {
+                const parsed = JSON.parse(readFileSync(file, 'utf8'));
+                for (const [scope, entries] of Object.entries(parsed)) {
+                    if (Array.isArray(entries))
+                        this.data.set(scope, entries);
+                }
+            }
+            catch {
+                /* 损坏则从空开始 */
+            }
+        }
+    }
+    persist() {
+        if (!this.file)
+            return;
+        try {
+            mkdirSync(dirname(this.file), { recursive: true });
+            writeFileSync(this.file, JSON.stringify(Object.fromEntries(this.data), null, 2), 'utf8');
+        }
+        catch {
+            /* 持久化失败不阻断 */
+        }
+    }
+    add(scope, text) {
+        const entry = { id: randomUUID().slice(0, 8), text: text.trim(), createdAt: new Date().toISOString() };
+        const list = this.data.get(scope) ?? [];
+        list.push(entry);
+        this.data.set(scope, list);
+        this.persist();
+        return entry;
+    }
+    list(scope) {
+        return this.data.get(scope) ?? [];
+    }
+    search(scope, query) {
+        return searchMemories(this.list(scope), query);
+    }
+    /** 删除某作用域下指定 id 的记忆；不存在返回 false。 */
+    remove(scope, id) {
+        const list = this.data.get(scope);
+        if (!list)
+            return false;
+        const next = list.filter((e) => e.id !== id);
+        if (next.length === list.length)
+            return false;
+        this.data.set(scope, next);
+        this.persist();
+        return true;
+    }
+    count(scope) {
+        return this.list(scope).length;
+    }
+}
+//# sourceMappingURL=memory.js.map

package/dist/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../src/memory.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
-{
+{
   "name": "@dsh-overdrive/gateway",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "type": "module",
   "scripts": {
     "build": "tsc"

package/src/adapter.ts

@@ -7,9 +7,18 @@ export interface NormalizedMessage {
 
 export interface OutboundButton { id: string; label: string; }
 
+/** 出站媒体（/send 等）：path 为本地文件路径。 */
+export interface OutboundMedia {
+  kind: 'image' | 'file' | 'voice';
+  path: string;
+  caption?: string;
+}
+
 export interface OutboundPayload {
   text: string;
   buttons?: OutboundButton[];
+  /** 可选：随消息发送的本地媒体文件；不支持媒体的适配器忽略并只发文本。 */
+  media?: OutboundMedia;
 }
 
 /** 按钮回执的点击者身份（用于白名单校验）。chatId 在个别平台回调中可能缺失，缺失时按未授权处理（fail-closed）。 */

package/src/adapters/discord.ts

@@ -102,6 +102,13 @@ export class DiscordAdapter implements Adapter {
       console.error(`[discord] 无法向 ${chatId} 发送（channel 不可用）`);
       return;
     }
+    if (payload.media) {
+      await (channel as { send: (o: unknown) => Promise<unknown> }).send({
+        content: payload.text,
+        files: [payload.media.path],
+      });
+      return;
+    }
     if (payload.buttons?.length) {
       const row = new ActionRowBuilder<ButtonBuilder>().addComponents(
         payload.buttons.map((b) =>

package/src/adapters/slack.ts

@@ -102,6 +102,14 @@ export class SlackAdapter implements Adapter {
   }
 
   async send(chatId: string, payload: OutboundPayload): Promise<void> {
+    if (payload.media) {
+      await this.app.client.files.uploadV2({
+        channel_id: chatId,
+        file: payload.media.path,
+        filename: payload.media.caption ?? payload.media.path.split('/').pop(),
+      });
+      return;
+    }
     await this.app.client.chat.postMessage({
       channel: chatId,
       text: payload.text,

package/src/adapters/telegram.ts

@@ -1,4 +1,4 @@
-import { Bot, InlineKeyboard } from 'grammy';
+import { Bot, InlineKeyboard, InputFile } from 'grammy';
 import type { Adapter, NormalizedMessage, OutboundButton, OutboundPayload } from '../adapter.js';
 
 // ── 纯函数 ────────────────────────────────────────────────────
@@ -118,6 +118,15 @@ export class TelegramAdapter implements Adapter {
   }
 
   async send(chatId: string, payload: OutboundPayload): Promise<void> {
+    if (payload.media) {
+      const file = new InputFile(payload.media.path);
+      if (payload.media.kind === 'image') {
+        await this.bot.api.sendPhoto(chatId, file, { caption: payload.media.caption ?? '' });
+      } else {
+        await this.bot.api.sendDocument(chatId, file, { caption: payload.media.caption ?? '' });
+      }
+      return;
+    }
     if (payload.buttons?.length) {
       const kb = new InlineKeyboard();
       for (const [label, id] of buttonRows(payload.buttons)) kb.text(label, id);

package/src/adapters/whatsapp.ts

@@ -1,3 +1,4 @@
+import { readFileSync } from 'node:fs';
 import makeWASocket, {
   useMultiFileAuthState,
   DisconnectReason,
@@ -199,6 +200,20 @@ export class WhatsAppAdapter implements Adapter {
 
   async send(chatId: string, payload: OutboundPayload): Promise<void> {
     if (!this.sock) return;
+    if (payload.media) {
+      const { kind, path, caption } = payload.media;
+      const buf = readFileSync(path);
+      if (kind === 'image') {
+        await this.sock.sendMessage(chatId, { image: buf, caption: caption ?? '' } satisfies AnyMessageContent);
+      } else {
+        await this.sock.sendMessage(chatId, {
+          document: buf,
+          fileName: caption ?? path,
+          mimetype: 'application/octet-stream',
+        } satisfies AnyMessageContent);
+      }
+      return;
+    }
     if (payload.buttons?.length) {
       this.pendingButtons.set(chatId, payload.buttons);
       // 原生交互按钮优先：Baileys 6.x 的 AnyMessageContent 无 interactive 键，

package/src/commands.ts

@@ -6,10 +6,19 @@ export type ParsedCommand =
   | { kind: 'task'; prompt: string }
   | { kind: 'cron'; schedule: string; prompt: string }
   | { kind: 'crons' }
-  | { kind: 'cronrm'; taskId: string };
+  | { kind: 'cronrm'; taskId: string }
+  | { kind: 'remember'; text: string }
+  | { kind: 'recall'; query: string }
+  | { kind: 'forget'; memoryId: string }
+  | { kind: 'remind'; text: string; inMinutes: number | null; atTime: string | null }
+  | { kind: 'send'; path: string }
+  | { kind: 'status' };
 
 // cron 语法：/cron <分 时 日 月 周> <需求>（schedule 为 5 个空白分隔字段）
 const CRON_RE = /^\/cron\s+(\S+\s+\S+\s+\S+\s+\S+\s+\S+)\s+(.+)$/;
+// /remind in N 分钟/小时/天 <text>（也支持 min/minutes/hour/hours/day/days）；或 /remind at HH:MM <text>
+const REMIND_IN_RE = /^\/remind\s+in\s+(\d+)\s+(\S+)\s+(.+)$/i;
+const REMIND_AT_RE = /^\/remind\s+at\s+(\d{1,2}:\d{2})\s+(.+)$/i;
 
 export function parseCommand(text: string): ParsedCommand | null {
   const trimmed = text.trim();
@@ -18,12 +27,30 @@ export function parseCommand(text: string): ParsedCommand | null {
   if (trimmed === '/agents') return { kind: 'agents' };
   if (trimmed === '/help') return { kind: 'help' };
   if (trimmed === '/crons') return { kind: 'crons' };
+  if (trimmed === '/status') return { kind: 'status' };
   const task = trimmed.match(/^\/task\s+(.+)$/);
   if (task) return { kind: 'task', prompt: task[1] };
   const cron = trimmed.match(CRON_RE);
   if (cron) return { kind: 'cron', schedule: cron[1], prompt: cron[2] };
   const cronrm = trimmed.match(/^\/cronrm\s+(\S+)$/);
   if (cronrm) return { kind: 'cronrm', taskId: cronrm[1] };
+  const remember = trimmed.match(/^\/remember\s+(.+)$/);
+  if (remember) return { kind: 'remember', text: remember[1] };
+  const recall = trimmed.match(/^\/recall\s*(.*)$/);
+  if (recall) return { kind: 'recall', query: recall[1].trim() };
+  const forget = trimmed.match(/^\/forget\s+(\S+)$/);
+  if (forget) return { kind: 'forget', memoryId: forget[1] };
+  const remindIn = trimmed.match(REMIND_IN_RE);
+  if (remindIn) {
+    const unit = (remindIn[2] ?? '').toLowerCase();
+    const n = Number(remindIn[1]);
+    const minutes = /^(小|h|hour)/.test(unit) ? n * 60 : /^(天|d)/.test(unit) ? n * 1440 : n;
+    return { kind: 'remind', text: remindIn[3], inMinutes: minutes, atTime: null };
+  }
+  const remindAt = trimmed.match(REMIND_AT_RE);
+  if (remindAt) return { kind: 'remind', text: remindAt[2], inMinutes: null, atTime: remindAt[1] };
+  const send = trimmed.match(/^\/send\s+(.+)$/);
+  if (send) return { kind: 'send', path: send[1].trim() };
   return null;
 }
 
@@ -34,6 +61,12 @@ export const HELP_TEXT = [
   '/cron <分 时 日 月 周> <需求> — 定时任务',
   '/crons — 查看定时任务列表',
   '/cronrm <任务id> — 删除定时任务',
+  '/remind in 10 分钟 <提醒内容> — 一次性定时提醒（也支持 at HH:MM）',
+  '/remember <事实> — 记住关于我的事',
+  '/recall <关键词> — 回忆相关记忆',
+  '/forget <记忆id> — 删除一条记忆',
+  '/send <文件路径> — 把本地文件/图片发到当前聊天',
+  '/status — 查看运行状态',
   '/agents — 查看子任务状态',
   '/new — 重置会话',
 ].join('\n');

package/src/index.ts

@@ -1,3 +1,5 @@
+import { existsSync } from 'node:fs';
+import { basename } from 'node:path';
 import { GatewayClient, type ServerEvent } from '@dsh-overdrive/sdk';
 import type { Adapter, OutboundPayload } from './adapter.js';
 import { Allowlist, buildSessionKey } from './session.js';
@@ -7,6 +9,7 @@ import { parseCommand, HELP_TEXT, type ParsedCommand } from './commands.js';
 import { TrajectoryAggregator, formatTrajectorySummary } from './trajectory.js';
 import { createStatusServer } from './status.js';
 import { createTranscriber, type AsrTranscriber } from './asr.js';
+import { MemoryStore, memoryScope, formatMemories } from './memory.js';
 
 /**
  * message.delta → 打字指示去重：同一 turn 内首个 delta 触发一次 typing，
@@ -69,9 +72,32 @@ export interface WireOptions {
   allowAll?: boolean;
   /** ASR 转写器；配置了 API key 时启用，语音消息转成文本再发给 agent。 */
   asr?: AsrTranscriber;
+  /** 记忆系统（OpenClaw 式长期记忆）；未提供则记忆命令返回不可用。 */
+  memory?: MemoryStore;
 }
 
-/** 命令面分发：/trace /new /task /cron /agents /help（M4）。 */
+/** 纯函数：一次性提醒的时间 → cron 5 字段表达式（分钟精度）。 */
+export function remindSchedule(minutes: number, atTime: string | null, now = new Date()): string {
+  const target = new Date(now);
+  if (atTime) {
+    const [h, m] = atTime.split(':').map(Number);
+    target.setHours(h, m, 0, 0);
+    if (target <= now) target.setDate(target.getDate() + 1); // 已过则明天
+  } else {
+    target.setMinutes(target.getMinutes() + minutes);
+  }
+  return `${target.getMinutes()} ${target.getHours()} ${target.getDate()} ${target.getMonth() + 1} *`;
+}
+
+/** 纯函数：本地文件路径 → 出站媒体类型（图片/语音/其他文件）。 */
+export function mediaKindFromPath(path: string): 'image' | 'voice' | 'file' {
+  const ext = path.toLowerCase().split('.').pop() ?? '';
+  if (['png', 'jpg', 'jpeg', 'webp', 'gif', 'bmp'].includes(ext)) return 'image';
+  if (['ogg', 'oga', 'opus', 'mp3', 'wav', 'webm', 'm4a', 'aac'].includes(ext)) return 'voice';
+  return 'file';
+}
+
+/** 命令面分发：/trace /new /task /cron /agents /help /remind /remember /recall /forget（M4 + v0.3）。 */
 async function handleCommand(
   adapter: Adapter,
   client: GatewayClient,
@@ -79,6 +105,7 @@ async function handleCommand(
   sessionId: string,
   chatId: string,
   aggregator: TrajectoryAggregator,
+  memory: MemoryStore | undefined,
 ): Promise<void> {
   switch (command.kind) {
     case 'trace': {
@@ -125,6 +152,66 @@ async function handleCommand(
       await adapter.send(chatId, { text: '（M4 简化）子任务状态由 agent 汇报，/task 派发' });
       return;
     }
+    case 'remember': {
+      if (!memory) { await adapter.send(chatId, { text: '记忆系统未启用。' }); return; }
+      const scope = memoryScope(adapter.id, sessionId.split(':')[2] ?? '');
+      const entry = memory.add(scope, command.text);
+      await adapter.send(chatId, { text: `✅ 已记住（\`${entry.id}\`）：${command.text}` });
+      return;
+    }
+    case 'recall': {
+      if (!memory) { await adapter.send(chatId, { text: '记忆系统未启用。' }); return; }
+      const scope = memoryScope(adapter.id, sessionId.split(':')[2] ?? '');
+      const hits = memory.search(scope, command.query);
+      if (hits.length === 0) { await adapter.send(chatId, { text: '没有相关记忆。' }); return; }
+      await adapter.send(chatId, {
+        text: `🧠 ${hits.length} 条记忆：\n` + hits.map((e) => `- \`${e.id}\` ${e.text}`).join('\n'),
+      });
+      return;
+    }
+    case 'forget': {
+      if (!memory) { await adapter.send(chatId, { text: '记忆系统未启用。' }); return; }
+      const scope = memoryScope(adapter.id, sessionId.split(':')[2] ?? '');
+      const ok = memory.remove(scope, command.memoryId);
+      await adapter.send(chatId, { text: ok ? `🗑️ 已删除记忆 \`${command.memoryId}\`` : `未找到记忆 \`${command.memoryId}\`` });
+      return;
+    }
+    case 'remind': {
+      const schedule = remindSchedule(command.inMinutes ?? 0, command.atTime);
+      await client.createTask({ sessionId, kind: 'cron', prompt: `⏰ 提醒：${command.text}`, schedule, once: true });
+      await adapter.send(chatId, {
+        text: `⏰ 已设置提醒「${command.text}」（${command.atTime ? `at ${command.atTime}` : `${command.inMinutes} 分钟后`}，一次性）`,
+      });
+      return;
+    }
+    case 'send': {
+      // 媒体发送（/send <path>）：读本地文件 → 类型判定 → 交给适配器；不支持的平台降级为文本
+      const path = command.path;
+      if (!existsSync(path)) {
+        await adapter.send(chatId, { text: `❌ 找不到文件：${path}` });
+        return;
+      }
+      await adapter.send(chatId, {
+        text: `📎 ${path}`,
+        media: { kind: mediaKindFromPath(path), path, caption: basename(path) },
+      });
+      return;
+    }
+    case 'status': {
+      const connected = adapter.status?.().connected ?? false;
+      const scope = memoryScope(adapter.id, sessionId.split(':')[2] ?? '');
+      const memCount = memory ? memory.count(scope) : 0;
+      const crons = await client.listTasks();
+      await adapter.send(chatId, {
+        text: [
+          `📊 状态`,
+          `- 适配器 ${adapter.id}: ${connected ? '✅ 已连接' : '❌ 未连接'}`,
+          `- 你的记忆: ${memCount} 条`,
+          `- 定时任务: ${crons.tasks.length} 个`,
+        ].join('\n'),
+      });
+      return;
+    }
     case 'help': {
       await adapter.send(chatId, { text: HELP_TEXT });
       return;
@@ -156,10 +243,20 @@ export async function wireAdapter(
       const command = parseCommand(msg.text);
       if (command) {
         console.log(`[gateway][${adapter.id}] 命令: ${JSON.stringify(command)}`);
-        await handleCommand(adapter, client, command, key, msg.chatId, aggregator);
+        await handleCommand(adapter, client, command, key, msg.chatId, aggregator, opts.memory);
         return;
       }
 
+      // OpenClaw 式记忆注入：入站消息前检索相关记忆，拼到文本后让 agent「记得你」
+      if (opts.memory) {
+        const scope = memoryScope(adapter.id, msg.userId);
+        const hits = opts.memory.search(scope, msg.text);
+        if (hits.length > 0) {
+          msg.text = `${msg.text}${formatMemories(hits)}`;
+          console.log(`[gateway][${adapter.id}] 注入 ${hits.length} 条相关记忆`);
+        }
+      }
+
       // ASR 语音转写：配置了 API key 时把语音消息转成文本；失败/未配置走原降级路径
       if (msg.media?.kind === 'voice' && opts.asr?.enabled) {
         const transcript = await opts.asr.transcribe(msg.media);
@@ -246,6 +343,8 @@ async function main(): Promise<void> {
     model: env.asrModel,
   });
   if (asr.enabled) console.log('[gateway] ASR 语音转写已启用');
+  const memory = new MemoryStore(process.env.MEMORY_FILE ?? 'data/memory.json');
+  console.log(`[gateway] 记忆系统已启用（文件: ${process.env.MEMORY_FILE ?? 'data/memory.json'}）`);
 
   const client = new GatewayClient(dshBaseUrl, dshToken);
   await client.health(); // 确认 DSH 侧（或 mock）活着
@@ -253,7 +352,7 @@ async function main(): Promise<void> {
   const adapters: Adapter[] = adapterIds.map((id) => createAdapter(id, env));
   for (const adapter of adapters) {
     await adapter.connect();
-    await wireAdapter(adapter, client, { allowlist, allowAll, asr });
+    await wireAdapter(adapter, client, { allowlist, allowAll, asr, memory });
     console.log(`[gateway] ${adapter.id} 适配器已就绪`);
   }
 

package/src/memory.ts

@@ -0,0 +1,108 @@
+// 记忆系统（对标 OpenClaw 的 long-term memory）。
+// 按 platform:userId 作用域存储用户显式记忆（/remember），支持搜索（/recall）与删除（/forget）；
+// 入站消息时自动检索相关记忆注入上下文，让 agent「记得你」。
+
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { randomUUID } from 'node:crypto';
+
+export interface MemoryEntry {
+  id: string;
+  text: string;
+  createdAt: string;
+}
+
+/** 作用域键：platform:userId（记忆跟随用户，跨频道共享，与 OpenClaw 一致）。 */
+export function memoryScope(adapterId: string, userId: string): string {
+  return `${adapterId}:${userId}`;
+}
+
+/** 字符 2-gram：CJK 无空格分词，用共享 bigram 判断相关性（比子串包含更鲁棒）。 */
+function bigrams(text: string): Set<string> {
+  const clean = text.toLowerCase();
+  const out = new Set<string>();
+  for (let i = 0; i < clean.length - 1; i++) out.add(clean.slice(i, i + 2));
+  return out;
+}
+
+/** 纯函数：按查询文本检索记忆——与查询共享任意 2-gram 即相关；空查询返回全部。 */
+export function searchMemories(entries: MemoryEntry[], query: string): MemoryEntry[] {
+  const queryBigrams = bigrams(query);
+  if (queryBigrams.size === 0) return entries;
+  return entries.filter((entry) => {
+    const memoryBigrams = bigrams(entry.text);
+    for (const gram of queryBigrams) {
+      if (memoryBigrams.has(gram)) return true;
+    }
+    return false;
+  });
+}
+
+/** 纯函数：记忆列表 → 注入文本（拼在用户消息后）。 */
+export function formatMemories(entries: MemoryEntry[]): string {
+  if (entries.length === 0) return '';
+  const lines = entries.map((e) => `- ${e.text}`).join('\n');
+  return `\n📌 相关记忆：\n${lines}`;
+}
+
+/** JSON 文件持久化的记忆存储；file 缺省时仅内存（测试/无盘环境用）。 */
+export class MemoryStore {
+  private readonly data = new Map<string, MemoryEntry[]>();
+  private readonly file?: string;
+
+  constructor(file?: string) {
+    this.file = file;
+    if (file && existsSync(file)) {
+      try {
+        const parsed = JSON.parse(readFileSync(file, 'utf8')) as Record<string, MemoryEntry[]>;
+        for (const [scope, entries] of Object.entries(parsed)) {
+          if (Array.isArray(entries)) this.data.set(scope, entries);
+        }
+      } catch {
+        /* 损坏则从空开始 */
+      }
+    }
+  }
+
+  private persist(): void {
+    if (!this.file) return;
+    try {
+      mkdirSync(dirname(this.file), { recursive: true });
+      writeFileSync(this.file, JSON.stringify(Object.fromEntries(this.data), null, 2), 'utf8');
+    } catch {
+      /* 持久化失败不阻断 */
+    }
+  }
+
+  add(scope: string, text: string): MemoryEntry {
+    const entry: MemoryEntry = { id: randomUUID().slice(0, 8), text: text.trim(), createdAt: new Date().toISOString() };
+    const list = this.data.get(scope) ?? [];
+    list.push(entry);
+    this.data.set(scope, list);
+    this.persist();
+    return entry;
+  }
+
+  list(scope: string): MemoryEntry[] {
+    return this.data.get(scope) ?? [];
+  }
+
+  search(scope: string, query: string): MemoryEntry[] {
+    return searchMemories(this.list(scope), query);
+  }
+
+  /** 删除某作用域下指定 id 的记忆；不存在返回 false。 */
+  remove(scope: string, id: string): boolean {
+    const list = this.data.get(scope);
+    if (!list) return false;
+    const next = list.filter((e) => e.id !== id);
+    if (next.length === list.length) return false;
+    this.data.set(scope, next);
+    this.persist();
+    return true;
+  }
+
+  count(scope: string): number {
+    return this.list(scope).length;
+  }
+}

package/test/commands.test.ts

@@ -21,4 +21,23 @@ describe('parseCommand', () => {
     expect(parseCommand('/task')).toBeNull(); // 缺参数
     expect(parseCommand('/cronrm')).toBeNull(); // 缺任务 id
   });
+  it('识别 /remember /recall /forget', () => {
+    expect(parseCommand('/remember 用户喜欢美式咖啡')).toEqual({ kind: 'remember', text: '用户喜欢美式咖啡' });
+    expect(parseCommand('/recall 咖啡')).toEqual({ kind: 'recall', query: '咖啡' });
+    expect(parseCommand('/recall')).toEqual({ kind: 'recall', query: '' });
+    expect(parseCommand('/forget abc123')).toEqual({ kind: 'forget', memoryId: 'abc123' });
+    expect(parseCommand('/remember')).toBeNull(); // 缺内容
+  });
+  it('识别 /remind（相对时间与定点时间）', () => {
+    expect(parseCommand('/remind in 10 分钟 喝水')).toEqual({ kind: 'remind', text: '喝水', inMinutes: 10, atTime: null });
+    expect(parseCommand('/remind in 2 小时 开会')).toEqual({ kind: 'remind', text: '开会', inMinutes: 120, atTime: null });
+    expect(parseCommand('/remind in 30 minutes 散步')).toEqual({ kind: 'remind', text: '散步', inMinutes: 30, atTime: null });
+    expect(parseCommand('/remind in 1 day 汇报')).toEqual({ kind: 'remind', text: '汇报', inMinutes: 1440, atTime: null });
+    expect(parseCommand('/remind at 14:30 开会')).toEqual({ kind: 'remind', text: '开会', inMinutes: null, atTime: '14:30' });
+  });
+  it('识别 /send 与 /status', () => {
+    expect(parseCommand('/send /tmp/report.png')).toEqual({ kind: 'send', path: '/tmp/report.png' });
+    expect(parseCommand('/status')).toEqual({ kind: 'status' });
+    expect(parseCommand('/send')).toBeNull(); // 缺路径
+  });
 });

package/test/memory.test.ts

@@ -0,0 +1,60 @@
+import { describe, expect, it } from 'vitest';
+import { MemoryStore, formatMemories, memoryScope, searchMemories } from '../src/memory.js';
+
+describe('memoryScope', () => {
+  it('按 platform:userId 作用域（记忆跟随用户跨频道）', () => {
+    expect(memoryScope('telegram', 'u1')).toBe('telegram:u1');
+  });
+});
+
+describe('searchMemories', () => {
+  const entries = [
+    { id: '1', text: '用户喜欢喝美式咖啡', createdAt: 'x' },
+    { id: '2', text: '用户住在杭州', createdAt: 'x' },
+    { id: '3', text: '项目用 TypeScript', createdAt: 'x' },
+  ];
+  it('任一关键词命中即返回', () => {
+    expect(searchMemories(entries, '咖啡').map((e) => e.id)).toEqual(['1']);
+    expect(searchMemories(entries, '杭州 咖啡').map((e) => e.id).sort()).toEqual(['1', '2']);
+  });
+  it('无匹配返回空', () => {
+    expect(searchMemories(entries, '滑雪')).toEqual([]);
+  });
+  it('空查询返回全部', () => {
+    expect(searchMemories(entries, '')).toHaveLength(3);
+  });
+  it('大小写不敏感', () => {
+    expect(searchMemories(entries, 'typescript').map((e) => e.id)).toEqual(['3']);
+  });
+});
+
+describe('formatMemories', () => {
+  it('空列表返回空串', () => {
+    expect(formatMemories([])).toBe('');
+  });
+  it('渲染注入块', () => {
+    const text = formatMemories([{ id: '1', text: '用户住在杭州', createdAt: 'x' }]);
+    expect(text).toContain('📌 相关记忆');
+    expect(text).toContain('用户住在杭州');
+  });
+});
+
+describe('MemoryStore（内存模式）', () => {
+  it('add / list / search / remove 全流程', () => {
+    const store = new MemoryStore(); // 无文件 = 纯内存
+    const entry = store.add('telegram:u1', '用户喜欢喝美式咖啡');
+    expect(store.count('telegram:u1')).toBe(1);
+    expect(store.list('telegram:u1')[0].text).toBe('用户喜欢喝美式咖啡');
+    expect(store.search('telegram:u1', '咖啡')).toHaveLength(1);
+    expect(store.remove('telegram:u1', entry.id)).toBe(true);
+    expect(store.count('telegram:u1')).toBe(0);
+    expect(store.remove('telegram:u1', entry.id)).toBe(false);
+  });
+  it('不同作用域隔离', () => {
+    const store = new MemoryStore();
+    store.add('telegram:u1', 'A 的记忆');
+    store.add('whatsapp:u1', 'B 的记忆');
+    expect(store.list('telegram:u1')).toHaveLength(1);
+    expect(store.list('whatsapp:u1')).toHaveLength(1);
+  });
+});