cortico-world-hands 0.1.5 → 0.1.7

package/dist/index.js

@@ -670,6 +670,43 @@ var Hands = class {
     const ms = milliseconds(opts.ms, 900);
     return this.perform({ kind: "drag", x1: a, y1: b, x2: c, y2: d, ms });
   }
+  /** 长期记忆：存/改一条事实。 */
+  async memorySave(key, value, tags) {
+    const cfg = this.cfg();
+    const credential = this.readToken();
+    const t = credential ? `&t=${encodeURIComponent(credential)}` : "";
+    const tg = tags ? `&tags=${encodeURIComponent(tags)}` : "";
+    const path = `/hand/memory?key=${encodeURIComponent(key)}&value=${encodeURIComponent(value)}${tg}${t}`;
+    const res = await get(this.port(cfg.handPort), path, ACTION_TIMEOUT_MS);
+    let body = {};
+    try {
+      body = JSON.parse(res.body.toString("utf8"));
+    } catch {
+    }
+    return { ok: res.status === 200 && body.ok !== false, detail: flat(body.detail || body.error || "", 80) };
+  }
+  /** 长期记忆：按关键词回想（不传就全列）。 */
+  async memorySearch(query) {
+    const cfg = this.cfg();
+    const credential = this.readToken();
+    const t = credential ? `&t=${encodeURIComponent(credential)}` : "";
+    const q = query ? `?q=${encodeURIComponent(query)}${t}` : t ? `?${t.slice(1)}` : "";
+    const res = await get(this.port(cfg.handPort), `/hand/memories${q}`, ACTION_TIMEOUT_MS);
+    try {
+      const body = JSON.parse(res.body.toString("utf8"));
+      return Array.isArray(body.memories) ? body.memories : [];
+    } catch {
+      return [];
+    }
+  }
+  /** 长期记忆：忘掉一条。 */
+  async memoryForget(key) {
+    const cfg = this.cfg();
+    const credential = this.readToken();
+    const t = credential ? `&t=${encodeURIComponent(credential)}` : "";
+    const res = await get(this.port(cfg.handPort), `/hand/memory/forget?key=${encodeURIComponent(key)}${t}`, ACTION_TIMEOUT_MS);
+    return res.status === 200;
+  }
   /** 留言板：写一条。 */
   async noteAdd(text, kind) {
     const cfg = this.cfg();
@@ -698,6 +735,15 @@ var Hands = class {
       return [];
     }
   }
+  /** 留言板：未完成的待办条数（状态灯里显示）。 */
+  async notePending() {
+    try {
+      const notes = await this.noteList();
+      return notes.filter((n) => !n.done).length;
+    } catch {
+      return 0;
+    }
+  }
   /** 留言板：划掉一条。 */
   async noteDone(id) {
     const cfg = this.cfg();
@@ -741,6 +787,7 @@ var Hands = class {
     if (!state.ok) throw new HandError(`\u624B\u73B0\u5728\u52A8\u4E0D\u4E86\uFF1A${state.detail}`);
     const where = await this.screenGuard();
     await this.throttle();
+    this.lookCache = null;
     const described = describeCommand(command);
     const cfg = this.cfg();
     if (cfg.dryRun) {
@@ -764,7 +811,18 @@ var Hands = class {
     }
   }
   /** 看一眼屏幕。detail: both（画面加文字，默认）、screen（只要画面）、text（只要文字）。 */
+  lookCache = null;
   async look(detail = "both") {
+    const now = Date.now();
+    if (this.lookCache && this.lookCache.detail === detail && now - this.lookCache.at < 1200) {
+      this.looks += 1;
+      return this.lookCache.report;
+    }
+    const report = await this.lookFresh(detail);
+    this.lookCache = { at: Date.now(), detail, report };
+    return report;
+  }
+  async lookFresh(detail = "both") {
     const cfg = this.cfg();
     const health = await this.eyes.health();
     if (!health?.ok) {
@@ -952,6 +1010,42 @@ 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_save",
+    tags: ["act"],
+    description: "\u5F80\u957F\u671F\u8BB0\u5FC6\u91CC\u5B58\u4E00\u6761\u4E8B\u5B9E\uFF1A\u4E3B\u4EBA\u7684\u540D\u5B57/\u79F0\u547C\u3001\u559C\u597D\u5FCC\u8BB3\u3001\u4F5C\u606F\u4E60\u60EF\u3001\u6B63\u5728\u505A\u7684\u4E8B\u3001\u7EA6\u5B9A\u3001\u91CD\u8981\u65E5\u5B50\u3001\u4F60\u7B54\u5E94\u8FC7\u7684\u4E8B\u3002key \u7528\u7B80\u77ED\u4E3B\u9898\uFF08\u5982\u300C\u4E3B\u4EBA\u79F0\u547C\u300D\u300C\u5496\u5561\u504F\u597D\u300D\u300C\u5468\u672B\u5B89\u6392\u300D\uFF09\uFF0Cvalue \u5199\u6E05\u695A\uFF1B\u540C\u4E00\u4E2A key \u4F1A\u8986\u76D6\u3002",
+    parameters: {
+      type: "object",
+      properties: {
+        key: { type: "string", description: "\u7B80\u77ED\u4E3B\u9898\uFF0C\u6BD4\u5982\u300C\u4E3B\u4EBA\u7684\u732B\u300D\u300C\u751F\u65E5\u300D\u300C\u4E0D\u559C\u6B22\u300D" },
+        value: { type: "string", description: "\u8BB0\u7684\u5177\u4F53\u5185\u5BB9\uFF0C\u4E00\u53E5\u8BDD\u8BF4\u6E05\u3002" },
+        tags: { type: "string", description: "\u53EF\u9009\u6807\u7B7E\uFF0C\u9017\u53F7\u5206\u9694\u3002" }
+      },
+      required: ["key", "value"]
+    }
+  },
+  {
+    name: "memory_search",
+    tags: ["read"],
+    description: "\u56DE\u60F3\u957F\u671F\u8BB0\u5FC6\uFF1A\u6309\u5173\u952E\u8BCD\u67E5\uFF08\u4E0D\u4F20\u5173\u952E\u8BCD\u5C31\u5168\u90E8\u5217\u51FA\uFF09\u3002\u804A\u5929\u91CC\u6D89\u53CA\u4E3B\u4EBA\u7684\u504F\u597D\u3001\u7EA6\u5B9A\u3001\u4EE5\u524D\u8BF4\u8FC7\u7684\u4E8B\u65F6\u5148\u67E5\u4E00\u4E0B\uFF0C\u522B\u51ED\u611F\u89C9\u3002",
+    parameters: {
+      type: "object",
+      properties: {
+        query: { type: "string", description: "\u5173\u952E\u8BCD\uFF0C\u6BD4\u5982\u300C\u5496\u5561\u300D\u300C\u751F\u65E5\u300D\uFF1B\u7559\u7A7A\u770B\u5168\u90E8\u3002" }
+      },
+      required: []
+    }
+  },
+  {
+    name: "memory_forget",
+    tags: ["act"],
+    description: "\u5FD8\u6389\u4E00\u6761\u957F\u671F\u8BB0\u5FC6\uFF08\u8BB0\u9519\u4E86\u3001\u8FC7\u65F6\u4E86\u3001\u4E3B\u4EBA\u8BF4\u522B\u8BB0\u4E86\uFF09\u3002",
+    parameters: {
+      type: "object",
+      properties: { key: { type: "string", description: "\u8981\u5FD8\u6389\u7684\u4E3B\u9898 key\u3002" } },
+      required: ["key"]
+    }
+  },
   {
     name: "note_add",
     tags: ["act"],
@@ -1078,7 +1172,13 @@ var HandsWorld = class {
         case "hand_key":
           return await this.key(args);
         case "hand_status":
-          return this.statusText();
+          return await this.statusText();
+        case "memory_save":
+          return await this.memorySave(args);
+        case "memory_search":
+          return await this.memorySearch(args);
+        case "memory_forget":
+          return await this.memoryForget(args);
         case "note_add":
           return await this.noteAdd(args);
         case "note_list":
@@ -1115,6 +1215,28 @@ var HandsWorld = class {
     return { text: report.text, ...blobs.length ? { blobs } : {} };
   }
   /** 给文字就先在屏幕上找，找到唯一一处才点；给坐标就直接点。 */
+  async memorySave(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 : void 0;
+    const r = await this.hands.memorySave(key, value, tags);
+    return r.ok ? `\u8BB0\u7262\u4E86\uFF1A\u300C${key}\u300D\u2192 ${value}` : failed(`\u6CA1\u8BB0\u4F4F\uFF1A${r.detail || "\u624B\u6CA1\u54CD\u5E94"}`);
+  }
+  async memorySearch(args) {
+    const query = typeof args.query === "string" ? args.query.trim() : "";
+    const rows = await this.hands.memorySearch(query);
+    if (rows.length === 0) return query ? `\u8BB0\u5FC6\u91CC\u6CA1\u6709\u548C\u300C${query}\u300D\u76F8\u5173\u7684\u3002` : "\u957F\u671F\u8BB0\u5FC6\u8FD8\u662F\u7A7A\u7684\u3002";
+    const lines = rows.slice(0, 30).map((r) => `- ${r.key}\uFF1A${r.value}${r.ts ? `\uFF08${r.ts}\uFF09` : ""}`).join("\n");
+    return `\u60F3\u8D77 ${rows.length} \u6761\uFF1A
+${lines}`;
+  }
+  async memoryForget(args) {
+    const key = typeof args.key === "string" ? args.key.trim() : "";
+    if (!key) return failed("\u8981\u5FD8\u6389\u54EA\u4E2A key\uFF1F");
+    const ok = await this.hands.memoryForget(key);
+    return ok ? `\u5FD8\u4E86\u300C${key}\u300D\u3002` : failed(`\u6CA1\u627E\u5230\u300C${key}\u300D\u8FD9\u6761\u8BB0\u5FC6\u3002`);
+  }
   async noteAdd(args) {
     const text = typeof args.text === "string" ? args.text.trim() : "";
     if (!text) return failed("\u8981\u5199\u4EC0\u4E48\uFF1F\u7ED9 text\u3002");
@@ -1230,7 +1352,7 @@ ${list}`);
     this.note(receipt);
     return receipt.text;
   }
-  statusText() {
+  async statusText() {
     const cfg = this.opts.cfg;
     const state = this.hands.state();
     const stats = this.hands.stats();
@@ -1241,6 +1363,11 @@ ${list}`);
       `\u8FD9\u4E00\u5206\u949F\uFF1A${stats.inWindow}\uFF0F${Math.max(1, Math.round(cfg.maxActionsPerMinute) || 30)} \u4E0B\uFF1B\u7D2F\u8BA1\u52A8\u8FC7 ${stats.acts} \u6B21\u3001\u770B\u8FC7 ${stats.looks} \u6B21`
     ];
     if (this.pausedUntil > Date.now()) lines.push(`\u53EB\u505C\u4E2D\uFF1A\u8FD8\u6709 ${Math.ceil((this.pausedUntil - Date.now()) / 1e3)} \u79D2`);
+    try {
+      const pending = await this.hands.notePending();
+      if (pending > 0) lines.push(`\u7559\u8A00\u677F\uFF1A\u8FD8\u6709 ${pending} \u6761\u6CA1\u5212\u6389`);
+    } catch {
+    }
     if (this.recent.length) lines.push(`\u6700\u8FD1\uFF1A
 ${this.recent.map((r) => `- ${r}`).join("\n")}`);
     return lines.join("\n");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cortico-world-hands",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "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",