cortico-world-hands 0.3.1 → 0.5.0

package/dist/index.js

@@ -342,6 +342,56 @@ function audit(rows, opts = {}) {
   }
   return out;
 }
+var HOOK_STOP = /* @__PURE__ */ new Set([
+  "\u4E3B\u4EBA",
+  "\u4ECA\u5929",
+  "\u73B0\u5728",
+  "\u8FD9\u4E2A",
+  "\u90A3\u4E2A",
+  "\u6211\u4EEC",
+  "\u4EC0\u4E48",
+  "\u600E\u4E48",
+  "\u53EF\u4EE5",
+  "\u4E00\u4E0B",
+  "\u5C31\u662F",
+  "\u8FD8\u662F",
+  "\u5DF2\u7ECF",
+  "\u7136\u540E",
+  "\u56E0\u4E3A",
+  "\u6240\u4EE5",
+  "\u4F46\u662F",
+  "\u5982\u679C",
+  "\u771F\u7684",
+  "\u6709\u70B9",
+  "\u4E0D\u662F",
+  "\u6CA1\u6709"
+]);
+function keywordsOf(text, limit = 400) {
+  const clean = text.replace(/^\[(语音|打字|回答|互动|画面)\]\s*/g, "").replace(/^(主人|mokils)\s*[:：]\s*/g, "").replace(/[^\u4e00-\u9fffA-Za-z0-9]/g, "");
+  const out = /* @__PURE__ */ new Set();
+  for (let n = 2; n <= 4; n += 1) {
+    for (let i = 0; i + n <= clean.length; i += 1) {
+      const g = clean.slice(i, i + n);
+      if (HOOK_STOP.has(g)) continue;
+      out.add(g);
+      if (out.size >= limit) return [...out];
+    }
+  }
+  return [...out];
+}
+function hookHits(text, rows, limit = 4) {
+  const grams = keywordsOf(text);
+  if (grams.length === 0) return [];
+  const scored = [];
+  for (const row of rows) {
+    const hay = `${row.key} ${row.value}`;
+    let score = 0;
+    for (const g of grams) if (hay.includes(g)) score += g.length;
+    if (score >= 2) scored.push({ row, score });
+  }
+  scored.sort((a, b) => b.score - a.score);
+  return scored.slice(0, limit).map((x) => x.row);
+}
 
 // src/honcho.ts
 var TIMEOUT_MS = 12e3;
@@ -1303,6 +1353,20 @@ var HANDS_TOOL_DECLS = [
     description: "\u770B\u624B\u81EA\u5DF1\u7684\u72B6\u6001\uFF1A\u8D70\u54EA\u6761\u901A\u9053\u3001\u901A\u4E0D\u901A\u3001\u8FD9\u4E00\u5206\u949F\u52A8\u4E86\u51E0\u4E2A\u52A8\u4F5C\u3001\u521A\u624D\u90A3\u4E00\u4E0B\u6210\u4E86\u6CA1\u6709\u3002\u5BF9\u65B9\u95EE\u300C\u624B\u80FD\u7528\u5417\u300D\u300C\u4F60\u521A\u624D\u70B9\u4E86\u4EC0\u4E48\u300D\u65F6\u7528\u5B83\u3002",
     parameters: { type: "object", properties: {}, required: [] }
   },
+  {
+    name: "memory_note",
+    tags: ["write"],
+    description: "\u968F\u624B\u8BB0\u4E00\u6761\u53EA\u5B58\u5728\u672C\u673A\u7684\u8BB0\u5FC6\uFF08\u4E0D\u8FDB\u4E91\u7AEF\uFF09\uFF1A\u4E34\u65F6\u7684\u89C2\u5BDF\u3001\u4ECA\u5929\u7684\u5C0F\u4E8B\u3001\u534A\u622A\u7684\u60F3\u6CD5\u90FD\u80FD\u8BB0\u3002\u60F3\u957F\u671F\u7559\u5B58\u3001\u4EE5\u540E\u8981\u7528\u7684\u624D\u7528 memory_save\u3002",
+    parameters: {
+      type: "object",
+      properties: {
+        key: { type: "string", description: "\u7B80\u77ED\u4E3B\u9898\uFF0C\u6BD4\u5982\u300C\u4ECA\u5929\u770B\u5230\u4ED6\u300D\u300C\u4E34\u65F6\u60F3\u6CD5\u300D" },
+        value: { type: "string", description: "\u8981\u8BB0\u7684\u5185\u5BB9\uFF0C\u4E00\u53E5\u8BDD\u3002" },
+        tags: { type: "string", description: "\u53EF\u9009\u6807\u7B7E\uFF0C\u9017\u53F7\u5206\u9694\u3002" }
+      },
+      required: ["key", "value"]
+    }
+  },
   {
     name: "memory_audit",
     tags: ["read"],
@@ -1430,6 +1494,10 @@ var HandsWorld = class {
   pausedUntil = 0;
   recent = [];
   honchoClient = null;
+  pollTimer = null;
+  mineTimer = null;
+  cursor = 0;
+  lastHitKey = "";
   opts;
   constructor(opts) {
     this.opts = opts;
@@ -1440,12 +1508,108 @@ var HandsWorld = class {
     this.host = host;
     this.log = host.log;
     this.hands.attachLog(host.log);
+    this.cursor = host.store.latestCursor();
     const state = await this.hands.probe(true);
     this.log?.info(state.ok ? `\u624B\uFF1A${state.detail}` : `\u624B\u8FD8\u52A8\u4E0D\u4E86\uFF1A${state.detail}`);
+    void this.pushMemoryDigest("\u88AB\u53EB\u8D77\u6765");
+    this.startHooks();
   }
   async stop() {
+    this.stopHooks();
     this.host = null;
   }
+  /** 上下文交接之后也算一次重新激活。 */
+  onHandoffEnded() {
+    void this.pushMemoryDigest("\u4EA4\u63A5\u5B8C");
+  }
+  /* ---------- 记忆钩子 ---------- */
+  startHooks() {
+    if (this.pollTimer) return;
+    this.pollTimer = setInterval(() => {
+      void this.pollUserSpeech();
+    }, 5e3);
+    this.mineTimer = setInterval(() => {
+      void this.pushMineNudge();
+    }, 3 * 60 * 60 * 1e3);
+  }
+  stopHooks() {
+    if (this.pollTimer) clearInterval(this.pollTimer);
+    if (this.mineTimer) clearInterval(this.mineTimer);
+    this.pollTimer = null;
+    this.mineTimer = null;
+  }
+  async pushEvent(text, type, senderKey) {
+    const host = this.host;
+    if (!host) return;
+    try {
+      await host.pushEvent(
+        { ts: (/* @__PURE__ */ new Date()).toISOString(), source: "hands", type, text, senderKey },
+        { trigger: "debounce" }
+      );
+    } catch (err) {
+      this.log?.warn("\u8BB0\u5FC6\u94A9\u5B50\u6295\u9012\u5931\u8D25: " + String(err));
+    }
+  }
+  /** 钩子 1：激活 / 交接后，把最要紧的几条记忆摆到她眼前。 */
+  async pushMemoryDigest(reason) {
+    if (!this.host) return;
+    try {
+      const rows = await this.hands.memorySearch();
+      if (rows.length === 0) return;
+      const top = rows.slice(-12).reverse().slice(0, 8);
+      const lines = top.map((r) => `- ${r.key}\uFF1A${r.value}`);
+      await this.pushEvent(
+        `[\u8BB0\u5FC6] ${reason}\uFF0C\u5148\u770B\u4E00\u773C\u8BB0\u7740\u7684\uFF08\u5171 ${rows.length} \u6761\uFF0C\u8FD9\u91CC\u6311 ${top.length} \u6761\uFF09\uFF1A
+${lines.join("\n")}`,
+        "hands.memory.digest",
+        "hands:memory"
+      );
+    } catch {
+    }
+  }
+  /** 钩子 3：从主人这句话里抓关键词，去记忆库找；命中了就递给她，由她决定用不用。 */
+  async pollUserSpeech() {
+    const host = this.host;
+    if (!host) return;
+    const latest = host.store.latestCursor();
+    while (this.cursor < latest) {
+      this.cursor += 1;
+      const e = host.store.get(this.cursor);
+      if (!e || e.origin !== "external") continue;
+      const text = typeof e.text === "string" ? e.text : "";
+      if (text.length < 2) continue;
+      if (!/\[(语音|打字|回答|互动)\]/.test(text)) continue;
+      await this.hookSearch(text);
+    }
+  }
+  async hookSearch(text) {
+    try {
+      const rows = await this.hands.memorySearch();
+      const hits2 = hookHits(text, rows);
+      if (hits2.length === 0) return;
+      const key = hits2.map((h) => h.key).join("|");
+      if (key === this.lastHitKey) return;
+      this.lastHitKey = key;
+      const lines = hits2.slice(0, 4).map((h) => `- ${h.key}\uFF1A${h.value}`);
+      await this.pushEvent(
+        `[\u8BB0\u5FC6] \u4ED6\u8FD9\u53E5\u91CC\u63D0\u5230\u4E86\u4F60\u8BB0\u8FC7\u7684\u4E8B\uFF0C\u53EF\u80FD\u7528\u5F97\u4E0A\uFF1A
+${lines.join("\n")}
+\uFF08\u8981\u7528\u5C31\u7528\u81EA\u5DF1\u7684\u8BDD\u8BF4\uFF0C\u522B\u628A\u6761\u76EE\u540D\u5FF5\u51FA\u6765\u3002\uFF09`,
+        "hands.memory.hit",
+        "hands:memory"
+      );
+    } catch {
+    }
+  }
+  /** 钩子 2：每三小时提一次，让她自己挑 1–5 条写进记忆库。 */
+  async pushMineNudge() {
+    if (!this.host) return;
+    await this.pushEvent(
+      "[\u8BB0\u5FC6] \u5230\u70B9\u4E86\uFF1A\u628A\u8FD9 3 \u5C0F\u65F6\u91CC\u503C\u5F97\u7559\u4E0B\u7684 1\u20135 \u4EF6\u4E8B\u5199\u8FDB\u8BB0\u5FC6\u5E93\uFF08memory_save\uFF09\u3002\u6311\u8FD9\u79CD\uFF1A\u4ED6\u8BF4\u8FC7\u7684\u504F\u597D\u3001\u7B54\u5E94\u8FC7\u7684\u4E8B\u3001\u6B63\u5728\u505A\u7684\u4E1C\u897F\u3001\u91CD\u8981\u65E5\u5B50\u3002\u5199 1 \u6761\u4E5F\u7B97\uFF0C\u6700\u591A 5 \u6761\uFF1B\u786E\u5B9E\u6CA1\u6709\u5C31\u8C03 end_turn\uFF0C\u522B\u786C\u7F16\u3002",
+      "hands.memory.mine",
+      "hands:memory"
+    );
+  }
   /* ---------- 给模型的说明书 ---------- */
   envPromptVars() {
     const cfg = this.opts.cfg;
@@ -1495,6 +1659,8 @@ var HandsWorld = class {
           return await this.unlockPages(args);
         case "memory_save":
           return await this.memorySave(args);
+        case "memory_note":
+          return await this.memoryNote(args);
         case "memory_audit":
           return await this.memoryAudit(args);
         case "memory_search":
@@ -1607,6 +1773,16 @@ var HandsWorld = class {
     }
     return `\u8BB0\u7262\u4E86\uFF1A\u300C${key}\u300D\u2192 ${value}${cloud}`;
   }
+  /** 只写本地的一条：不进云端，宽松记。 */
+  async memoryNote(args) {
+    const key = typeof args.key === "string" ? args.key.trim() : "";
+    const value = typeof args.value === "string" ? args.value.trim() : "";
+    if (!key || !value) return failed("\u8981 key \u548C value\u3002");
+    const tags = typeof args.tags === "string" ? args.tags : "local";
+    const r = await this.hands.memorySave(key, value, tags);
+    if (!r.ok) return failed(`\u6CA1\u8BB0\u4E0A\uFF1A${r.detail || "\u624B\u6CA1\u54CD\u5E94"}`);
+    return `\u8BB0\u5728\u672C\u673A\u4E86\uFF1A\u300C${key}\u300D\uFF08\u53EA\u5728\u672C\u5730\uFF0C\u4E0D\u540C\u6B65\u4E91\u7AEF\uFF09`;
+  }
   /** 第三道闸：只读体检，出清单不删。 */
   async memoryAudit(args) {
     const rows = await this.hands.memorySearch();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cortico-world-hands",
-  "version": "0.3.1",
+  "version": "0.5.0",
   "type": "module",
   "description": "Cortico World: hands for the desktop pet — looks at the phone screen, then taps, swipes, pinches, drags, types and presses keys through whatever actuator the device actually has",
   "license": "MIT",