cortico-world-hands 0.1.2 → 0.1.3

package/dist/index.js

@@ -670,6 +670,38 @@ var Hands = class {
     const ms = milliseconds(opts.ms, 900);
     return this.perform({ kind: "drag", x1: a, y1: b, x2: c, y2: d, ms });
   }
+  /** 留言板：写一条。 */
+  async noteAdd(text) {
+    const cfg = this.cfg();
+    const token = cfg.handToken ? `&t=${encodeURIComponent(cfg.handToken)}` : "";
+    const path = `/hand/note?text=${encodeURIComponent(text)}${token}`;
+    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 noteList() {
+    const cfg = this.cfg();
+    const token = cfg.handToken ? `?t=${encodeURIComponent(cfg.handToken)}` : "";
+    const res = await get(this.port(cfg.handPort), `/hand/notes${token}`, ACTION_TIMEOUT_MS);
+    try {
+      const body = JSON.parse(res.body.toString("utf8"));
+      return Array.isArray(body.notes) ? body.notes : [];
+    } catch {
+      return [];
+    }
+  }
+  /** 留言板：划掉一条。 */
+  async noteDone(id) {
+    const cfg = this.cfg();
+    const token = cfg.handToken ? `&t=${encodeURIComponent(cfg.handToken)}` : "";
+    const res = await get(this.port(cfg.handPort), `/hand/note/done?id=${encodeURIComponent(id)}${token}`, ACTION_TIMEOUT_MS);
+    return res.status === 200;
+  }
   /** 一屏屏翻着找文字（只查不点）。 */
   async findItem(text, opts = {}) {
     const cfg = this.cfg();
@@ -915,6 +947,36 @@ 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: "note_add",
+    tags: ["act"],
+    description: "\u5728\u7559\u8A00\u677F\u4E0A\u5199\u4E00\u6761\uFF1A\u60F3\u8BF4\u7684\u8BDD\u3001\u60F3\u8BB0\u7684\u4E8B\u3001\u5F85\u529E\u3001\u7ED9\u81EA\u5DF1\u7684\u63D0\u9192\u3002\u60F3\u8BB0\u5C31\u8BB0\uFF0C\u4E0D\u7528\u7B49\u5BF9\u65B9\u540C\u610F\uFF1B\u4E00\u6761\u522B\u592A\u957F\uFF08\u4E00\u53E5\u8BDD\u6700\u597D\uFF09\u3002",
+    parameters: {
+      type: "object",
+      properties: {
+        text: { type: "string", description: "\u8981\u5199\u4E0B\u7684\u5185\u5BB9\u3002" }
+      },
+      required: ["text"]
+    }
+  },
+  {
+    name: "note_list",
+    tags: ["read"],
+    description: "\u770B\u7559\u8A00\u677F\uFF1A\u6709\u54EA\u4E9B\u6CA1\u5212\u6389\u7684\u3001\u90FD\u5199\u4E86\u4EC0\u4E48\u3002\u5BF9\u65B9\u95EE\u300C\u4F60\u8BB0\u4E86\u4EC0\u4E48\u300D\u300C\u7559\u8A00\u677F\u4E0A\u6709\u5565\u300D\u65F6\u7528\u5B83\u3002",
+    parameters: { type: "object", properties: {}, required: [] }
+  },
+  {
+    name: "note_done",
+    tags: ["act"],
+    description: "\u628A\u7559\u8A00\u677F\u4E0A\u67D0\u4E00\u6761\u5212\u6389\uFF08\u505A\u5B8C\u4E86/\u4E0D\u7528\u4E86\uFF09\u3002\u5148\u7528 note_list \u62FF\u5230 id\u3002",
+    parameters: {
+      type: "object",
+      properties: {
+        id: { type: "string", description: "\u7559\u8A00\u7684 id\uFF08note_list \u91CC\u80FD\u770B\u5230\uFF09\u3002" }
+      },
+      required: ["id"]
+    }
+  },
   {
     name: "hand_stop",
     tags: ["flow"],
@@ -1001,6 +1063,12 @@ var HandsWorld = class {
           return await this.key(args);
         case "hand_status":
           return this.statusText();
+        case "note_add":
+          return await this.noteAdd(args);
+        case "note_list":
+          return await this.noteList();
+        case "note_done":
+          return await this.noteDone(args);
         case "hand_stop":
           return this.stopHands();
         default:
@@ -1031,6 +1099,27 @@ var HandsWorld = class {
     return { text: report.text, ...blobs.length ? { blobs } : {} };
   }
   /** 给文字就先在屏幕上找，找到唯一一处才点；给坐标就直接点。 */
+  async noteAdd(args) {
+    const text = typeof args.text === "string" ? args.text.trim() : "";
+    if (!text) return failed("\u8981\u5199\u4EC0\u4E48\uFF1F\u7ED9 text\u3002");
+    const result = await this.hands.noteAdd(text);
+    if (!result.ok) return failed(`\u6CA1\u5199\u8FDB\u7559\u8A00\u677F\uFF1A${result.detail || "\u624B\u6CA1\u54CD\u5E94"}`);
+    return `\u5199\u5728\u7559\u8A00\u677F\u4E0A\u4E86\uFF1A\u300C${text}\u300D`;
+  }
+  async noteList() {
+    const notes = await this.hands.noteList();
+    if (notes.length === 0) return "\u7559\u8A00\u677F\u662F\u7A7A\u7684\u3002";
+    const open = notes.filter((n) => !n.done);
+    const lines = open.map((n) => `- [${n.id}] ${n.ts} ${n.text}`).join("\n");
+    return `\u7559\u8A00\u677F\u4E0A\u6709 ${notes.length} \u6761\uFF0C\u672A\u5B8C ${open.length} \u6761\uFF1A
+${lines || "\uFF08\u90FD\u5212\u6389\u4E86\uFF09"}`;
+  }
+  async noteDone(args) {
+    const id = typeof args.id === "string" ? args.id.trim() : "";
+    if (!id) return failed("\u8981\u5212\u6389\u54EA\u6761\uFF1F\u7ED9 id\uFF08note_list \u91CC\u80FD\u770B\u5230\uFF09\u3002");
+    const ok = await this.hands.noteDone(id);
+    return ok ? `\u5212\u6389\u4E86 ${id}\u3002` : failed(`\u6CA1\u627E\u5230 id=${id} \u7684\u7559\u8A00\u3002`);
+  }
   async pinch(args) {
     const scale = Number(args.scale);
     if (!Number.isFinite(scale) || scale <= 0) return failed("scale \u8981\u662F\u6B63\u6570\uFF0C\u6BD4\u5982 1.5 \u653E\u5927\u30010.6 \u7F29\u5C0F\u3002");

package/package.json

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