cortico-world-hands 0.8.0 → 0.10.0

package/dist/index.js

@@ -1063,6 +1063,30 @@ var Hands = class {
     }
     return { ok: res.status === 200 && body.ok !== false, detail: flat(body.detail || body.error || "", 80) };
   }
+  /** 唤醒屏幕（用 Shizuku 的 input keyevent 224）。 */
+  async wakeScreen() {
+    const cfg = this.cfg();
+    const credential = this.readToken();
+    const t = credential ? `t=${encodeURIComponent(credential)}` : "";
+    const res = await post(this.port(cfg.handPort), `/hand/wake?${t}`, "", 15e3);
+    return res.body.toString("utf8");
+  }
+  /** 解锁锁屏：密码由主人放在本机文件里，这里只触发，不接触密码。 */
+  async unlockScreen() {
+    const cfg = this.cfg();
+    const credential = this.readToken();
+    const t = credential ? `t=${encodeURIComponent(credential)}` : "";
+    const res = await post(this.port(cfg.handPort), `/hand/unlock?${t}`, "", 3e4);
+    return res.body.toString("utf8");
+  }
+  /** 息屏（可选，用来自己测唤醒）。 */
+  async sleepScreen() {
+    const cfg = this.cfg();
+    const credential = this.readToken();
+    const t = credential ? `t=${encodeURIComponent(credential)}` : "";
+    const res = await post(this.port(cfg.handPort), `/hand/sleep?${t}`, "", 15e3);
+    return res.body.toString("utf8");
+  }
   /** 画板：新开一张。 */
   async canvasNew(w = 512, h = 512, bg = "transparent") {
     const cfg = this.cfg();
@@ -1442,6 +1466,24 @@ 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: "screen_wake",
+    tags: ["act"],
+    description: "\u70B9\u4EAE\u5C4F\u5E55\uFF1A\u5C4F\u5E55\u9ED1\u7740\u4E5F\u80FD\u5524\u9192\uFF08\u7528 Shizuku \u7684\u7CFB\u7EDF\u6309\u952E\uFF0Croot/Shizuku \u4EFB\u4E00\u901A\u9053\uFF09\u3002\u4E3B\u4EBA\u8BF4\u300C\u4EAE\u4E00\u4E0B\u5C4F\u300D\u300C\u5E2E\u6211\u628A\u5C4F\u5E55\u70B9\u4EAE\u300D\u65F6\u7528\u5B83\uFF1B\u5931\u8D25\u4F1A\u8FD4\u56DE\u539F\u56E0\u3002",
+    parameters: { type: "object", properties: {} }
+  },
+  {
+    name: "screen_unlock",
+    tags: ["act"],
+    description: "\u89E3\u9501\u9501\u5C4F\uFF1A\u53EA\u5728\u5C4F\u5E55\u9501\u7740\u65F6\u7528\u3002\u5BC6\u7801\u7531\u4E3B\u4EBA\u81EA\u5DF1\u586B\u5728\u672C\u673A\u6587\u4EF6\u91CC\uFF08/sdcard/Download/DSHA/\u9501\u5C4F\u5BC6\u7801.txt\uFF09\uFF0C\u8FD9\u4E2A\u5DE5\u5177\u53EA\u8D1F\u8D23\u89E6\u53D1\uFF0C\u8BFB\u4E0D\u5230\u5BC6\u7801\u4F1A\u544A\u8BC9\u4F60\u6587\u4EF6\u5728\u54EA\u3002\u5931\u8D25\u4F1A\u8FD4\u56DE\u539F\u56E0\u3002",
+    parameters: { type: "object", properties: {} }
+  },
+  {
+    name: "screen_sleep",
+    tags: ["act"],
+    description: "\u628A\u5C4F\u5E55\u5173\u6389\uFF08\u606F\u5C4F\uFF09\u3002\u4E3B\u4EBA\u8BF4\u8981\u5173\u5C4F\u3001\u6216\u8005\u4F60\u60F3\u81EA\u5DF1\u6D4B\u4E00\u4E0B\u5524\u9192\u662F\u5426\u7BA1\u7528\u65F6\u7528\u5B83\u3002",
+    parameters: { type: "object", properties: {} }
+  },
   {
     name: "canvas_new",
     tags: ["act"],
@@ -1901,6 +1943,12 @@ ${lines.join("\n")}
           return await this.diaryRead(args);
         case "skin_install":
           return await this.skinInstall(args);
+        case "screen_wake":
+          return await this.screenWake();
+        case "screen_unlock":
+          return await this.screenUnlock();
+        case "screen_sleep":
+          return await this.screenSleep();
         case "canvas_new":
           return await this.canvasNew(args);
         case "canvas_stroke":
@@ -2025,6 +2073,40 @@ ${lines.join("\n")}
     }
     return `\u8BB0\u7262\u4E86\uFF1A\u300C${key}\u300D\u2192 ${value}${cloud}`;
   }
+  /** 点亮屏幕：成功说清楚，失败给原因。 */
+  async screenWake() {
+    const raw = await this.hands.wakeScreen();
+    try {
+      const r = JSON.parse(raw);
+      if (r.ok) {
+        return r.litBefore ? "\u5C4F\u5E55\u672C\u6765\u5C31\u662F\u4EAE\u7684\u3002" : "\u5C4F\u5E55\u70B9\u4EAE\u4E86\u3002";
+      }
+      return failed(r.error || "\u6CA1\u70B9\u4EAE\uFF0C\u539F\u56E0\u4E0D\u660E");
+    } catch {
+      return failed(raw.slice(0, 120));
+    }
+  }
+  /** 解锁：成功/没锁/失败都给人话。 */
+  async screenUnlock() {
+    const raw = await this.hands.unlockScreen();
+    try {
+      const r = JSON.parse(raw);
+      if (r.ok) return r.detail || "\u89E3\u5F00\u4E86";
+      if (r.needFile) return failed(`${r.error}\uFF08\u6587\u4EF6\uFF1A${r.file}\uFF09`);
+      return failed(r.error || "\u6CA1\u89E3\u5F00\uFF0C\u539F\u56E0\u4E0D\u660E");
+    } catch {
+      return failed(raw.slice(0, 120));
+    }
+  }
+  async screenSleep() {
+    const raw = await this.hands.sleepScreen();
+    try {
+      const r = JSON.parse(raw);
+      return r.ok ? "\u5C4F\u5E55\u5173\u6389\u4E86\u3002" : failed(r.error || "\u6CA1\u5173\u6389\uFF0C\u539F\u56E0\u4E0D\u660E");
+    } catch {
+      return failed(raw.slice(0, 120));
+    }
+  }
   async canvasNew(args) {
     const w = args.w === void 0 ? 512 : Math.max(64, Math.min(2048, Math.round(Number(args.w))));
     const h = args.h === void 0 ? 512 : Math.max(64, Math.min(2048, Math.round(Number(args.h))));

package/package.json

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