@ycodium-ai/plugin-devices 0.2.3799 → 0.2.3851

package/dist/index.js

@@ -135,6 +135,7 @@ var parseDeviceAction = (platform2, input) => {
       "setPermission",
       "openUrl",
       "launchApp",
+      "relaunchApp",
       "terminateApp",
       "shake",
       "sendPush"
@@ -178,6 +179,7 @@ var parseDeviceAction = (platform2, input) => {
     case "openUrl":
       return { type, url: url(input["url"]) };
     case "launchApp":
+    case "relaunchApp":
     case "terminateApp":
       return { type, appId: appId(platform2, input["appId"]) };
     case "sendPush":
@@ -199,6 +201,7 @@ var IOS_ACTIONS = /* @__PURE__ */ new Set([
   "setPermission",
   "openUrl",
   "launchApp",
+  "relaunchApp",
   "terminateApp",
   "sendPush"
 ]);
@@ -208,10 +211,10 @@ var ANDROID_ACTIONS = /* @__PURE__ */ new Set([
   "setToggle",
   "setOrientation",
   "setLocation",
-  "clearLocation",
   "setPermission",
   "openUrl",
   "launchApp",
+  "relaunchApp",
   "terminateApp"
 ]);
 var IOS_TOGGLES = /* @__PURE__ */ new Set([
@@ -279,6 +282,7 @@ var actionPayload = {
     ),
     branch("openUrl", { url: { type: "string", minLength: 1, maxLength: 2048 } }, ["url"]),
     branch("launchApp", { appId: appId2 }, ["appId"]),
+    branch("relaunchApp", { appId: appId2 }, ["appId"]),
     branch("terminateApp", { appId: appId2 }, ["appId"]),
     branch("shake"),
     branch("sendPush", { appId: appId2, payload: { type: ["string", "object"] } }, ["appId", "payload"])
@@ -358,6 +362,12 @@ var SETTINGS_CARD = {
       labelKey: "settings.androidSdk.label",
       descriptionKey: "settings.androidSdk.description",
       placeholderKey: "settings.androidSdk.placeholder"
+    },
+    {
+      key: "downloadProxy",
+      kind: "proxy",
+      labelKey: "settings.downloadProxy.label",
+      descriptionKey: "settings.downloadProxy.description"
     }
   ]
 };
@@ -632,9 +642,10 @@ var childPath = (root, name) => {
     throw new Error("Archive path escapes its destination");
   return result;
 };
-var downloadArchive = async (item, directory, fetch) => {
+var archivePath = (item, directory) => NodePath.join(directory, item.url.split("/").at(-1));
+var downloadArchive = async (item, directory, fetch, received = () => void 0) => {
   await NodeFSP.mkdir(directory, { recursive: true });
-  const target2 = NodePath.join(directory, item.url.split("/").at(-1));
+  const target2 = archivePath(item, directory);
   if ((await NodeFSP.lstat(target2).catch(() => null))?.isSymbolicLink())
     throw new Error("Download cache entry must not be linked");
   const verify = async () => {
@@ -665,6 +676,7 @@ var downloadArchive = async (item, directory, fetch) => {
           return;
         }
         hash.update(chunk);
+        received(size);
         callback(null, chunk);
       }
     });
@@ -793,6 +805,27 @@ var extractEnvironmentZip = async (file, destination, signal) => {
   }
 };
 
+// src/environmentProgress.ts
+var PUBLISH_INTERVAL_MS = 1e3;
+var SPEED_SMOOTHING = 0.3;
+var throttledEnvironmentProgress = (publish, now = Date.now) => {
+  let last = null;
+  let speed;
+  return (stage) => {
+    const time = now();
+    const same = last?.stage.phase === stage.phase && last.stage.component === stage.component;
+    if (last !== null && same && time - last.time < PUBLISH_INTERVAL_MS) return;
+    if (last !== null && same && stage.receivedBytes !== void 0) {
+      const received = stage.receivedBytes - (last.stage.receivedBytes ?? stage.receivedBytes);
+      const sample = received * 1e3 / (time - last.time);
+      speed = speed === void 0 ? sample : speed + (sample - speed) * SPEED_SMOOTHING;
+    }
+    if (stage.phase !== "download") speed = void 0;
+    last = { stage, time };
+    publish(stage, speed);
+  };
+};
+
 // src/environmentStorage.ts
 import * as NodeFSP2 from "node:fs/promises";
 import * as NodePath2 from "node:path";
@@ -920,7 +953,7 @@ var privateEnvironmentReady = async (root) => {
     await assertPrivatePath(root, NodePath2.join(avd, "config.ini"));
     await assertPrivatePath(root, NodePath2.join(paths.avd, "Ycodium_API_35.ini"));
     const config = await NodeFSP2.readFile(NodePath2.join(avd, "config.ini"), "utf8");
-    const image = /^image\.sysdir\.1=(system-images\/android-35\/default\/(?:x86_64|arm64-v8a)\/)\r?$/m.exec(
+    const image = /^image\.sysdir\.1\s*=\s*(system-images\/android-35\/default\/(?:x86_64|arm64-v8a)\/)\s*$/m.exec(
       config
     )?.[1];
     if (!image) return false;
@@ -980,6 +1013,7 @@ var DeviceEnvironments = class {
   progress = { status: "idle" };
   listeners = /* @__PURE__ */ new Set();
   active = null;
+  job = null;
   nextJobId = 1;
   options;
   constructor(options) {
@@ -1000,19 +1034,36 @@ var DeviceEnvironments = class {
     if (this.busy)
       throw new DeviceError("invalid-input", "Another simulator preparation is already running");
     const id = this.nextJobId++;
+    const job = new AbortController();
+    this.job = job;
     this.publish({ id, status: "working" });
-    this.active = this.prepare(
-      input,
-      (stage) => this.publish({ id, status: "working", stage })
-    ).then(
+    const report = throttledEnvironmentProgress(
+      (stage, bytesPerSecond) => this.publish({
+        id,
+        status: "working",
+        ...stage,
+        ...bytesPerSecond === void 0 ? {} : { bytesPerSecond }
+      })
+    );
+    this.active = this.prepare(input, report, job.signal).then(
       (plan) => this.publish({ id, status: "done", plan }),
       (error) => {
-        this.options.log?.warn("Simulator preparation failed", {
-          detail: error instanceof Error ? error.message : String(error)
-        });
-        this.publish({ id, status: "failed" });
+        if (job.signal.aborted) {
+          this.publish({ id, status: "cancelled" });
+          return;
+        }
+        const message = error instanceof Error ? error.message : String(error);
+        this.options.log?.warn("Simulator preparation failed", { detail: message });
+        this.publish({ id, status: "failed", message });
       }
-    );
+    ).finally(() => {
+      this.job = null;
+    });
+    return this.progress;
+  }
+  /** 只中止正在跑的准备；已下完并校验过的组件留在缓存里，下次不用重下。 */
+  cancel() {
+    this.job?.abort();
     return this.progress;
   }
   async dispose() {
@@ -1071,6 +1122,13 @@ var DeviceEnvironments = class {
     const archives = androidArchives(probe.platform, probe.arch);
     const sdk = await this.options.externalSdk();
     const prepared = await privateEnvironmentReady(root);
+    const installed = await NodeFSP3.lstat(paths.sdk).catch(() => null) !== null;
+    const missing = installed ? [] : await Promise.all(
+      (archives ?? []).map(async (item) => {
+        const cached = await NodeFSP3.lstat(archivePath(item, paths.cache)).catch(() => null);
+        return cached?.size === item.bytes ? 0 : item.bytes;
+      })
+    );
     return {
       platform: "android",
       supported: archives !== null && probe.virtualization.available,
@@ -1078,7 +1136,7 @@ var DeviceEnvironments = class {
       ...sdk.available && sdk.root ? { existingSdkRoot: sdk.root } : {},
       root,
       version: ANDROID_ENVIRONMENT_VERSION,
-      downloadBytes: archives?.reduce((sum, item) => sum + item.bytes, 0) ?? null,
+      downloadBytes: archives ? missing.reduce((sum, bytes) => sum + bytes, 0) : null,
       requiredFreeBytes: 12 * GIB,
       freeBytes: free,
       ready: sdk.available && (sdk.root !== paths.sdk || prepared),
@@ -1106,10 +1164,11 @@ var DeviceEnvironments = class {
       this.busy = false;
     }
   }
-  async prepare(input, progress = () => void 0) {
+  async prepare(input, progress = () => void 0, cancelled) {
+    const signal = cancelled ? AbortSignal.any([this.abort.signal, cancelled]) : this.abort.signal;
     return this.exclusively(async () => {
       const plan = await this.plan(input);
-      this.abort.signal.throwIfAborted();
+      signal.throwIfAborted();
       if (!input.acceptLicenses)
         throw new DeviceError(
           "invalid-input",
@@ -1143,8 +1202,8 @@ var DeviceEnvironments = class {
           NodePath3.join(plan.root, "config")
         ])
           await NodeFSP3.mkdir(directory, { recursive: true });
-        if (input.platform === "ios") await this.prepareIos(plan, progress);
-        else await this.prepareAndroid(plan, progress);
+        if (input.platform === "ios") await this.prepareIos(plan, progress, signal);
+        else await this.prepareAndroid(plan, progress, signal);
       } finally {
         await release?.();
       }
@@ -1152,7 +1211,7 @@ var DeviceEnvironments = class {
       return this.plan(input);
     });
   }
-  async prepareAndroid(plan, progress) {
+  async prepareAndroid(plan, progress, signal) {
     const probe = await this.probe();
     const archives = androidArchives(probe.platform, probe.arch);
     if (!archives) throw new Error("Android host target is unsupported");
@@ -1168,26 +1227,43 @@ var DeviceEnvironments = class {
             "An unrecognized private SDK already exists; its installation will not be overwritten"
           );
       } else {
+        const totalBytes = archives.reduce((sum, item) => sum + item.bytes, 0);
+        let finished = 0;
         for (const item of archives) {
-          progress(item.name);
-          this.abort.signal.throwIfAborted();
+          const received = (bytes) => progress({
+            phase: "download",
+            component: item.name,
+            receivedBytes: finished + bytes,
+            totalBytes
+          });
+          received(0);
+          signal.throwIfAborted();
           const file = await downloadArchive(
             item,
             paths.cache,
-            (url2, init) => this.options.fetch(url2, { ...init, signal: this.abort.signal })
+            (url2, init) => this.options.fetch(url2, { ...init, signal }),
+            received
           );
+          finished += item.bytes;
+          progress({
+            phase: "extract",
+            component: item.name,
+            receivedBytes: finished,
+            totalBytes
+          });
           await extractEnvironmentZip(
             file,
             item.destination === "sdk" ? staging : NodePath3.join(staging, "system-images", "android-35", "default"),
-            this.abort.signal
+            signal
           );
         }
         await NodeFSP3.writeFile(NodePath3.join(staging, ".ycodium-components"), plan.version);
         await NodeFSP3.rename(staging, paths.sdk);
       }
+      progress({ phase: "device" });
       await this.createPrivateAvd(paths.root, probe.arch === "arm64" ? "arm64-v8a" : "x86_64");
-      this.abort.signal.throwIfAborted();
-      progress("validate");
+      signal.throwIfAborted();
+      progress({ phase: "validate" });
       const validated = await this.options.process.run({
         program: "host:node",
         args: [this.options.helperPath, "validate-android", "--sdk", paths.sdk],
@@ -1253,41 +1329,37 @@ target=android-35
       { flag: "wx" }
     );
   }
-  async prepareIos(plan, progress) {
+  async prepareIos(plan, progress, cancelled) {
     if (plan.ready) return;
     const cache = NodePath3.join(plan.root, "cache", `ios-${plan.version}`);
     await NodeFSP3.mkdir(cache, { recursive: true });
-    progress(`iOS ${plan.version}`);
-    if (await this.runApple([
-      "-downloadPlatform",
-      "iOS",
-      "-exportPath",
-      cache,
-      "-buildVersion",
-      plan.version
-    ]) !== 0)
+    progress({ phase: "apple-download", component: `iOS ${plan.version}` });
+    if (await this.runApple(
+      ["-downloadPlatform", "iOS", "-exportPath", cache, "-buildVersion", plan.version],
+      cancelled
+    ) !== 0)
       throw new Error(
         "Apple could not download this iOS runtime; check the selected Xcode version, network and Apple account in Xcode"
       );
     const names = (await NodeFSP3.readdir(cache)).filter((name) => name.endsWith(".dmg"));
     if (names.length !== 1)
       throw new Error("Apple did not return a unique simulator runtime archive");
-    progress("apple-install");
-    if (await this.runApple(["-importPlatform", NodePath3.join(cache, names[0])]) !== 0)
+    progress({ phase: "apple-install" });
+    if (await this.runApple(["-importPlatform", NodePath3.join(cache, names[0])], cancelled) !== 0)
       throw new Error(
         "Apple could not import the runtime. Complete any required permissions in Xcode; Ycodium will not elevate privileges"
       );
     if (!(await this.probe()).xcode.runtimes.some((runtime) => runtime.version === plan.version))
       throw new Error("The requested iOS runtime is still unavailable after Apple's import");
   }
-  async runApple(args) {
-    this.abort.signal.throwIfAborted();
+  async runApple(args, cancelled) {
+    cancelled.throwIfAborted();
     const handle = await this.options.process.spawn({
       program: "host:node",
       args: [this.options.helperPath, "run", "--", "xcodebuild", ...args],
       cwd: this.options.dataDir
     });
-    const signal = AbortSignal.any([this.abort.signal, AbortSignal.timeout(36e5)]);
+    const signal = AbortSignal.any([cancelled, AbortSignal.timeout(36e5)]);
     const terminate = () => {
       void handle.kill().catch(() => void 0);
     };
@@ -1364,6 +1436,13 @@ var registerEnvironmentCommands = (ctx, environments) => {
       confirmAppleInstall: payload["confirmAppleInstall"] === true
     })
   });
+  ctx.command({
+    name: "cancelEnvironment",
+    description: "Cancel the running simulator preparation. Components already downloaded and verified stay in the cache.",
+    scope: "operate",
+    payloadSchema: { type: "object", properties: {}, additionalProperties: false },
+    handle: () => environments.cancel()
+  });
   ctx.stream({
     name: "environmentProgress",
     description: "Current user-triggered simulator preparation progress; subscribing does not start preparation.",
@@ -2022,7 +2101,10 @@ var HubProcess = class {
       "--host",
       "127.0.0.1",
       "--hide-sidebar",
-      "--hide-boot-device"
+      "--hide-boot-device",
+      // hub 默认的 grpc-screenshot 要机器上有 ffmpeg，缺了就一帧都没有；scrcpy 只靠随包的 server。
+      "--stream-source",
+      "scrcpy"
     );
     let handle;
     try {
@@ -2618,6 +2700,10 @@ var runIos = async (tools, udid, action) => {
     case "launchApp":
       await simctl(tools, udid, ["launch", action.appId], "launch");
       return;
+    case "relaunchApp":
+      await simctl(tools, udid, ["terminate", action.appId], "terminate").catch(() => void 0);
+      await simctl(tools, udid, ["launch", action.appId], "launch");
+      return;
     case "terminateApp":
       await simctl(tools, udid, ["terminate", action.appId], "terminate");
       return;
@@ -2634,6 +2720,7 @@ var runIos = async (tools, udid, action) => {
 var adb = (tools, serial, args, operation) => checked(tools.run("adb", ["-s", serial, ...args]), operation);
 var runAndroid = async (tools, serial, action) => {
   const shell = (args, operation) => adb(tools, serial, ["shell", ...args], operation);
+  const launch = (appId3) => shell(["monkey", "-p", appId3, "-c", "android.intent.category.LAUNCHER", "1"], "launch");
   switch (action.type) {
     case "setAppearance":
       await shell(["cmd", "uimode", "night", action.value === "dark" ? "yes" : "no"], "appearance");
@@ -2690,13 +2777,21 @@ var runAndroid = async (tools, serial, action) => {
         "location"
       );
       return;
-    case "clearLocation":
-      return;
     case "setPermission": {
       const permissions = ANDROID_PERMISSIONS[action.permission];
       if (permissions === void 0) throw unsupported("permission", "android");
       const verb = action.decision === "grant" ? "grant" : "revoke";
-      for (const permission of permissions) {
+      const declared = new Set(
+        (await shell(["dumpsys", "package", action.appId], "permission")).split(/[\s:,]+/u)
+      );
+      const requested = permissions.filter((permission) => declared.has(permission));
+      if (requested.length === 0) {
+        throw new DeviceError(
+          "command-failed",
+          `${action.appId} does not declare this permission, so Android cannot change it.`
+        );
+      }
+      for (const permission of requested) {
         await shell(["pm", verb, action.appId, permission], "permission").catch(() => void 0);
       }
       return;
@@ -2708,14 +2803,16 @@ var runAndroid = async (tools, serial, action) => {
       );
       return;
     case "launchApp":
-      await shell(
-        ["monkey", "-p", action.appId, "-c", "android.intent.category.LAUNCHER", "1"],
-        "launch"
-      );
+      await launch(action.appId);
+      return;
+    case "relaunchApp":
+      await shell(["am", "force-stop", action.appId], "terminate");
+      await launch(action.appId);
       return;
     case "terminateApp":
       await shell(["am", "force-stop", action.appId], "terminate");
       return;
+    case "clearLocation":
     case "setLiquidGlass":
     case "setColorFilter":
     case "shake":
@@ -2796,7 +2893,8 @@ var readAndroid = async (tools, serial) => {
   const settings = {
     ...night?.includes("yes") ? { appearance: "dark" } : night?.includes("no") ? { appearance: "light" } : {},
     ...Number.isFinite(scale) ? { textSize: textSizeFromAndroid(scale) } : {},
-    ...animator !== void 0 && animator !== "null" ? { reduceMotion: Number(animator) === 0 } : {},
+    // 没动过这项设置时系统读出 "null"，含义是默认动画，不是未知。
+    ...animator === void 0 ? {} : { reduceMotion: animator !== "null" && Number(animator) === 0 },
     ...wifi === "1" || wifi === "0" ? { networkEnabled: wifi === "1" } : {}
   };
   const foregroundApp = focused?.[1] === void 0 ? null : { id: focused[1] };
@@ -2840,7 +2938,18 @@ var parseHubDeviceList = (value) => {
 var parseHubActionResult = (value) => {
   if (!isRecord3(value) || typeof value["ok"] !== "boolean") return null;
   const text2 = (key2) => typeof value[key2] === "string" ? value[key2] : void 0;
-  return { ok: value["ok"], id: text2("id"), serial: text2("serial"), error: text2("error") };
+  const causes = Array.isArray(value["errors"]) ? value["errors"].flatMap(
+    (item) => isRecord3(item) && typeof item["message"] === "string" ? [
+      [item["message"], typeof item["error"] === "string" ? item["error"] : ""].join(" ").split("\n")[0].trim()
+    ] : []
+  ) : [];
+  const error = [text2("error"), ...causes].filter(Boolean).join(": ");
+  return {
+    ok: value["ok"],
+    id: text2("id"),
+    serial: text2("serial"),
+    error: error === "" ? void 0 : error
+  };
 };
 var HubClient = class {
   origin;
@@ -3072,7 +3181,9 @@ var DeviceService = class {
         }
       }
     }
-    return list.errors.length > 0 ? { devices, detail: list.errors.join("\n") } : { devices };
+    const iosAvailable = (await this.host.platformAvailability("ios")).available;
+    const errors = iosAvailable ? list.errors : list.errors.filter((error) => !error.startsWith("[apple-utils]"));
+    return errors.length > 0 ? { devices, detail: errors.join("\n") } : { devices };
   }
   async refresh(ready) {
     const generation = this.environmentGeneration;
@@ -3563,7 +3674,7 @@ var deviceToolkit = (service) => ({
 var HUB_SERVICE = "hub";
 var index_default = definePlugin({
   id: "devices",
-  apiVersion: 60,
+  apiVersion: 63,
   activate: async (ctx) => {
     const direct = (input, init) => ctx.proxies.fetch(PLUGIN_PROXY_DIRECT).then((fetchDirect) => fetchDirect(input, init));
     const host = new LocalDeviceHost({
@@ -3592,12 +3703,16 @@ var index_default = definePlugin({
     });
     ctx.toolkit(deviceToolkit(service));
     registerCommands(ctx, service);
+    const downloadProxy = ctx.config.downloadProxy;
+    const environmentFetch = (input, init) => ctx.proxies.fetch(
+      !downloadProxy ? void 0 : downloadProxy === PLUGIN_PROXY_DIRECT ? null : downloadProxy
+    ).then((fetchThroughProxy) => fetchThroughProxy(input, init));
     const environments = new DeviceEnvironments({
       dataDir: ctx.paths.dataDir,
       helperPath: NodePath9.join(ctx.paths.pluginDir, "dist", "helper.mjs"),
       runtimeDir: bundledToolPaths(ctx.paths.pluginDir, HUB_SPEC, ctx.paths.runtimeDir).installDir,
       process: ctx.process,
-      fetch: ctx.http,
+      fetch: environmentFetch,
       log: ctx.log,
       externalSdk: async () => {
         const probe = await host.machine(true);
@@ -3609,6 +3724,7 @@ var index_default = definePlugin({
       beforeMutation: () => service.beginEnvironmentMutation(),
       afterPrepared: async () => {
         await service.inspect(true);
+        await service.list();
       }
     });
     registerEnvironmentCommands(ctx, environments);

package/locales/en.json

@@ -41,9 +41,7 @@
     "confirmData": "I understand this permanently deletes apps and data in the private Android virtual device",
     "cleanDevices": "Delete private virtual device data",
     "working": "Checking the machine…",
-    "preparing": "Preparing components. Downloads and Apple's installation can take several minutes. You can return to this panel to check progress.",
     "failed": "The operation could not finish. Check the official guidance, selected disk, network and whether the virtual device is powered off, then retry. More detail is available in this machine's plugin logs.",
-    "done": "Operation completed. Refresh the device list to check and open the simulator.",
     "reasons": {
       "ios-needs-macos": "iOS simulators require a Mac with Xcode.",
       "ios-tools-missing": "The bundled iOS Simulator helpers are missing or could not load on this machine. Repair or update Ycodium with the matching platform components.",
@@ -59,7 +57,27 @@
       "virtualization-probe-failed": "The emulator acceleration status could not be determined. This is not evidence that hardware virtualization is disabled. Retry the check or consult the official setup guidance."
     },
     "unsupported": "This machine can't run the emulator yet, so preparation is unavailable. See the official setup guidance above.",
-    "notEnoughSpace": "Not enough free space on this disk. Choose a directory on another disk above, then check again."
+    "notEnoughSpace": "Not enough free space on this disk. Choose a directory on another disk above, then check again.",
+    "stages": {
+      "starting": "Getting ready…",
+      "download": "Downloading {{component}}",
+      "extract": "Unpacking {{component}}",
+      "device": "Creating the virtual device",
+      "validate": "Checking the installation",
+      "apple-download": "Apple is downloading {{component}}",
+      "apple-install": "Apple is installing the runtime"
+    },
+    "transferred": "{{done}} of {{total}}",
+    "speed": "{{speed}}/s",
+    "timeLeft": "about {{minutes}} min left",
+    "slowDownload": "This download is slow. If this machine uses a proxy, try another one or none under Download proxy in the Devices settings. Cancelling keeps the components that finished.",
+    "continues": "This keeps running if you leave this panel.",
+    "cancel": "Cancel",
+    "cancelled": "Preparation cancelled. Components that finished downloading are kept for next time.",
+    "prepareFailed": "Preparation couldn't finish. Fix the problem below, then try again. Components that finished downloading are kept.",
+    "ready": "This environment is ready. Start the emulator from the list below.",
+    "nothingToDownload": "Nothing to download",
+    "cleaned": "Cleaned up."
   },
   "settings": {
     "card": {
@@ -78,6 +96,10 @@
         "path": "found through adb on PATH"
       }
     },
+    "downloadProxy": {
+      "label": "Download proxy",
+      "description": "Used when downloading emulator components. If downloads are slow, try a different proxy or no proxy."
+    },
     "checkTools": {
       "label": "Check tool versions",
       "description": "Reads the installed device tools without installing or starting anything.",
@@ -222,6 +244,7 @@
       "presetPlaceholder": "Preset…",
       "set": "Set",
       "clear": "Clear",
+      "current": "Set to {{latitude}}, {{longitude}}",
       "sanFrancisco": "San Francisco",
       "newYork": "New York",
       "london": "London",
@@ -272,6 +295,7 @@
     "updateTo": "Verify bundled {{version}}",
     "pendingPolicy": "Device helpers are included with Ycodium. Missing or incomplete components require repairing or updating Ycodium on this machine.",
     "checkHint": "Checking reads the installed tools without installing or starting anything.",
+    "checked": "Checked. The versions above are current.",
     "check": "Check versions",
     "checkFailed": "Could not read the tool versions. Try again.",
     "updateFailed": "Bundled components are missing or incomplete. Repair or update Ycodium on this machine."

package/locales/zh-CN.json

@@ -41,9 +41,7 @@
     "confirmData": "我理解此操作会永久删除私有 Android 虚拟设备中的应用和数据",
     "cleanDevices": "删除私有虚拟设备数据",
     "working": "正在检查这台机器…",
-    "preparing": "正在准备组件。下载与 Apple 安装可能需要几分钟，可稍后回到此面板查看进度。",
     "failed": "操作未能完成。请按官方指引检查所选磁盘、网络及虚拟设备是否已关机，再重试。具体原因可在这台机器的插件日志中查看。",
-    "done": "操作已完成。刷新设备列表以检查并打开模拟器。",
     "reasons": {
       "ios-needs-macos": "iOS 模拟器需要装有 Xcode 的 Mac。",
       "ios-tools-missing": "这台机器上的随包 iOS 模拟器助手缺失或无法加载。请使用匹配的平台组件修复或更新 Ycodium。",
@@ -59,7 +57,27 @@
       "virtualization-probe-failed": "无法确定模拟器加速状态，不能据此认定硬件虚拟化未开启。请重试检查或参考官方设置指引。"
     },
     "unsupported": "这台机器暂时跑不了模拟器，所以现在不能准备。请看上面的官方设置指引。",
-    "notEnoughSpace": "这块磁盘剩余空间不够。请在上面换一个其他磁盘上的目录，再检查一次。"
+    "notEnoughSpace": "这块磁盘剩余空间不够。请在上面换一个其他磁盘上的目录，再检查一次。",
+    "stages": {
+      "starting": "正在准备…",
+      "download": "正在下载 {{component}}",
+      "extract": "正在解包 {{component}}",
+      "device": "正在创建虚拟设备",
+      "validate": "正在检查安装结果",
+      "apple-download": "Apple 正在下载 {{component}}",
+      "apple-install": "Apple 正在安装运行时"
+    },
+    "transferred": "{{done}} / {{total}}",
+    "speed": "{{speed}}/s",
+    "timeLeft": "还需约 {{minutes}} 分钟",
+    "slowDownload": "下载很慢。如果这台机器用了代理，可以在设备设置的「下载代理」里换一个或不走代理。取消后，已下完的组件会保留。",
+    "continues": "离开这个面板后会继续进行。",
+    "cancel": "取消",
+    "cancelled": "已取消准备。已下完的组件会保留，下次不用重下。",
+    "prepareFailed": "准备没能完成。请处理下面的问题后重试，已下完的组件会保留。",
+    "ready": "环境已就绪。请从下方列表启动模拟器。",
+    "nothingToDownload": "无需下载",
+    "cleaned": "已清理。"
   },
   "settings": {
     "card": {
@@ -78,6 +96,10 @@
         "path": "按 PATH 上的 adb 找到"
       }
     },
+    "downloadProxy": {
+      "label": "下载代理",
+      "description": "下载模拟器组件时使用。下载很慢时，可以换一个代理或不走代理。"
+    },
     "checkTools": {
       "label": "检查工具版本",
       "description": "读取已安装的设备工具，不安装也不启动任何东西。",
@@ -222,6 +244,7 @@
       "presetPlaceholder": "预设…",
       "set": "设置",
       "clear": "清除",
+      "current": "已设为 {{latitude}}, {{longitude}}",
       "sanFrancisco": "旧金山",
       "newYork": "纽约",
       "london": "伦敦",
@@ -272,6 +295,7 @@
     "updateTo": "校验随包版本 {{version}}",
     "pendingPolicy": "设备辅助工具随 Ycodium 提供。组件缺失或不完整时，请修复或更新这台机器上的 Ycodium。",
     "checkHint": "检查只读取已装的工具，不安装也不启动任何东西。",
+    "checked": "检查完成，上面的版本是最新读取的结果。",
     "check": "检查版本",
     "checkFailed": "读不到工具版本，请重试。",
     "updateFailed": "随包组件缺失或不完整，请修复或更新这台机器上的 Ycodium。"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ycodium-ai/plugin-devices",
-  "version": "0.2.3799",
+  "version": "0.2.3851",
   "description": "Lets agents drive iOS Simulators and Android Emulators on this machine.",
   "keywords": [
     "android",
@@ -16,6 +16,7 @@
     "dist",
     "locales",
     "assets",
+    "skills",
     "README.md"
   ],
   "type": "module",
@@ -33,9 +34,9 @@
     "tailwindcss": "^4.0.0",
     "typescript": "~6.0.3",
     "vite-plus": "0.2.2",
-    "@ycodium-ai/plugin-api": "0.2.3799",
-    "ycodium-fetch-ports": "0.0.0",
-    "ycodium-sse-stream": "0.0.0"
+    "ycodium-sse-stream": "0.0.0",
+    "@ycodium-ai/plugin-api": "0.2.3851",
+    "ycodium-fetch-ports": "0.0.0"
   },
   "ycodium": {
     "plugin": "./dist/index.js",
@@ -44,6 +45,11 @@
     "description": "Lets agents drive iOS Simulators and Android Emulators on this machine.",
     "descriptionKey": "presentation.description",
     "icon": "./assets/icon.svg",
+    "skills": [
+      {
+        "dir": "./skills/mobile-devices"
+      }
+    ],
     "ui": {
       "assets": "./assets",
       "entry": "ui.js",