@honor-claw/yoyo 1.4.0-beta.4 → 1.4.1-alpha.2

package/dist/apis/claw-cloud.mjs

@@ -1,44 +1,48 @@
-import { uuid as e } from "../utils/id.mjs";
-import { isOKResponse as t } from "./helpers.mjs";
-import { takeApiHost as n } from "./hosts.mjs";
-import { HttpClient as r } from "./http-client.mjs";
+import { getYoyoPluginVersionCode as e } from "../utils/version.mjs";
+import { uuid as t } from "../utils/id.mjs";
+import { isOKResponse as n } from "./helpers.mjs";
+import { takeApiHost as r } from "./hosts.mjs";
+import { HttpClient as i } from "./http-client.mjs";
 //#region src/apis/claw-cloud.ts
-var i = class {
+var a = class {
 	httpClient;
 	constructor(e, t) {
-		this.httpClient = new r(e, t);
+		this.httpClient = new i(e, t);
 	}
-	async registerDevice(t, n, r) {
-		let i = {
-			"x-trace-id": e(),
-			"x-jwt-token": n.token,
-			"x-device-id": t.deviceId
-		}, a = {
+	async registerDevice(n, r, i) {
+		let a = {
+			"x-trace-id": t(),
+			"x-jwt-token": r.token,
+			"x-device-id": n.deviceId
+		}, o = {
 			businessTag: "YOYO_CLAW",
 			role: "yoyoclaw",
 			deviceInfo: {
-				...t,
-				manufacture: t.manufacture,
-				brand: t.brand,
-				bizExtInfo: r
+				...n,
+				manufacture: n.manufacture,
+				brand: n.brand,
+				bizExtInfo: {
+					...i,
+					pluginVersionCode: e()
+				}
 			}
 		};
 		return this.httpClient.post("/v1/device/registry", {
-			headers: i,
-			body: a
+			headers: a,
+			body: o
 		});
 	}
-	async logoutDevice(t, n) {
+	async logoutDevice(e, n) {
 		let r = {
-			"x-trace-id": e(),
+			"x-trace-id": t(),
 			"x-jwt-token": n.token,
-			"x-device-id": t.deviceId
+			"x-device-id": e.deviceId
 		}, i = {
 			businessTag: "YOYO_CLAW",
 			deviceInfo: {
-				...t,
-				manufacture: t.manufacture,
-				brand: t.brand
+				...e,
+				manufacture: e.manufacture,
+				brand: e.brand
 			}
 		};
 		return this.httpClient.post("/v1/user/logout", {
@@ -46,10 +50,10 @@ var i = class {
 			body: i
 		});
 	}
-	async exchangeToken(n, r) {
-		let i = e(), a = {
+	async exchangeToken(e, r) {
+		let i = t(), a = {
 			"Content-Type": "application/json",
-			"x-device-id": n.deviceId,
+			"x-device-id": e.deviceId,
 			"x-trace-id": i
 		}, o = {};
 		"userId" in r ? a["x-agw-userId"] = r.userId : o = {
@@ -62,13 +66,13 @@ var i = class {
 			headers: a,
 			timeout: 15e3
 		});
-		if (t(s) && s.data.data) return s.data.data;
+		if (n(s) && s.data.data) return s.data.data;
 		throw Error(`failed to get token: ${JSON.stringify(s.data)}, traceId: ${i}`);
 	}
 };
-function a() {
-	let e = n();
-	return new i(`https://${e.clawCloud}/aicloud/yoyo-claw-service`, e.grayTag ? { defaultHeaders: { "x-gray": e.grayTag } } : void 0);
+function o() {
+	let e = r();
+	return new a(`https://${e.clawCloud}/aicloud/yoyo-claw-service`, e.grayTag ? { defaultHeaders: { "x-gray": e.grayTag } } : void 0);
 }
 //#endregion
-export { i as ClawCloudClient, a as createClawCloudClient };
+export { a as ClawCloudClient, o as createClawCloudClient };

package/dist/cloud-channel/message-handler.mjs

@@ -1,6 +1,6 @@
 import { useClawLogger as e } from "../utils/logger.mjs";
 import { StatusEventType as t } from "../services/connection/status-tracker/events.mjs";
-import { processDeviceToolSet as n } from "../modules/device-toolset/processor.mjs";
+import { createDeviceToolSetUpdateAck as n } from "../modules/device-toolset/ack.mjs";
 import "../modules/device-toolset/index.mjs";
 //#region src/cloud-channel/message-handler.ts
 var r = { style: "SOUL.md" }, i = "[yoyoclaw-channel]", a = class {
@@ -167,7 +167,7 @@ var r = { style: "SOUL.md" }, i = "[yoyoclaw-channel]", a = class {
 				this.sendMessage("deviceControl", t, n, "", void 0, o), e().info(`${i} auto pair is completed, requestId: ${r}`);
 				return;
 			}
-			e().debug?.(`${i} trans gateway msg to cloud, session: ${t}, data: ${r.slice(0, 3e3)}`), this.sendMessage("userMessage", t, n, r) || (e().error(`${i} failed to send message, cloud socket closed, session ${t}, device ${s}`), this.sessionManager.closeNodeGatewayClient(t));
+			this.sendMessage("userMessage", t, n, r) || (e().error(`${i} failed to send message, cloud socket closed, session ${t}, device ${s}`), this.sessionManager.closeNodeGatewayClient(t));
 		} catch (t) {
 			e().error(`${i} failed to handle gateway message: ${String(t)}`);
 		}
@@ -206,10 +206,10 @@ var r = { style: "SOUL.md" }, i = "[yoyoclaw-channel]", a = class {
 				e().info(`${i} ${o ? "update" : "fetch"} context '${u}' processed (no reply)`);
 				return;
 			}
-			d.ok ? (e().info(`${i} ${o ? "update" : "fetch"} context successfully`), this.sendContextResponse(a, n, r, s, {
+			d.ok ? (e().info(`${i} ${o ? "update" : "fetch"} context successfully`), this.sendContextResponse(a, n, r, s, d.responsePayload ?? {
 				ok: !0,
 				...d.data
-			})) : (e().error(`${i} failed to ${o ? "update" : "fetch"} context: ${d.error}`), this.sendContextResponse(a, n, r, s, {
+			})) : (e().error(`${i} failed to ${o ? "update" : "fetch"} context: ${d.error}`), this.sendContextResponse(a, n, r, s, d.responsePayload ?? {
 				ok: !1,
 				error: d.error,
 				...d?.data,
@@ -220,20 +220,20 @@ var r = { style: "SOUL.md" }, i = "[yoyoclaw-channel]", a = class {
 			e().error(`${i} error ${o ? "updating" : "fetching"} context '${u}': ${c}`), this.replyContextError(a, n, r, s, c);
 		}
 	}
-	sendMessage(e, t, n, r, i, a) {
-		let o = {
-			msgType: e,
+	sendMessage(t, n, r, a, o, s) {
+		let c = {
+			msgType: t,
 			sourceRole: "yoyoclaw",
 			sourceDeviceId: this.config.deviceInfo.deviceId,
-			traceInfo: n,
+			traceInfo: r,
 			targetRole: "node",
-			targetDeviceId: t,
+			targetDeviceId: n,
 			port: this.config.deviceInfo.port,
-			data: typeof r == "string" ? r : JSON.stringify(r),
-			contexts: i,
-			bizExtInfo: a
+			data: typeof a == "string" ? a : JSON.stringify(a),
+			contexts: o,
+			bizExtInfo: s
 		};
-		return this.config.onReply(o, t);
+		return e().debug?.(`${i} sending message to cloud, msgType: ${c.msgType}, targetDeviceId: ${c.targetDeviceId}, data: ${JSON.stringify(c).slice(0, 3e3)}`), this.config.onReply(c, n);
 	}
 	validateContext(e) {
 		return e?.header?.name ? {
@@ -367,13 +367,14 @@ var r = { style: "SOUL.md" }, i = "[yoyoclaw-channel]", a = class {
 		return !e || t !== "DeviceToolSet" && t !== "UniversalToolSet";
 	}
 	async updateDeviceToolSetContext(e, t, r) {
-		return r?.header.namespace === "yoyoclaw" ? {
-			ok: !0,
-			data: await n(t),
-			noReply: !0
-		} : {
-			ok: !1,
-			error: `Unsupported DeviceToolSet namespace: ${r?.header.namespace ?? "unknown"}`
+		let i = await n({
+			namespace: r?.header.namespace,
+			payload: t
+		});
+		return {
+			ok: i.ok,
+			error: i.error,
+			responsePayload: i.payload
 		};
 	}
 };

package/dist/modules/configs/identity-persist.mjs

@@ -36,7 +36,7 @@ async function f(t) {
 		...o,
 		version: o?.version || a.NEW
 	};
-	return t.legacyDeviceId && (s.legacyDeviceId = t.legacyDeviceId), t.deviceId && (s.deviceId = t.deviceId, s.publicKeyPem = t.publicKeyPem, s.privateKeyPem = t.privateKeyPem, s.createdAtMs = t.createdAtMs), t.version && (s.version = t.version), "gatewayAuthMd5" in t && (s.gatewayAuthMd5 = t.gatewayAuthMd5), await n({
+	return t.legacyDeviceId && (s.legacyDeviceId = t.legacyDeviceId), t.deviceId && (s.deviceId = t.deviceId, s.publicKeyPem = t.publicKeyPem, s.privateKeyPem = t.privateKeyPem, s.createdAtMs = t.createdAtMs), t.version && (s.version = t.version), "gatewayAuthMd5" in t && (s.gatewayAuthMd5 = t.gatewayAuthMd5), "pluginVersionCode" in t && (s.pluginVersionCode = t.pluginVersionCode), await n({
 		rootDir: i,
 		relativePath: l(),
 		data: JSON.stringify(s, null, 2),

package/dist/modules/device/identity.mjs

@@ -49,15 +49,12 @@ async function c() {
 	let r = await s();
 	return await t(r), r;
 }
-async function l() {
-	return (await e())?.gatewayAuthMd5;
-}
-function u(e, t) {
+function l(e, t) {
 	let r = n.createPrivateKey(e);
 	return i(n.sign(null, Buffer.from(t, "utf8"), r));
 }
-function d(e) {
+function u(e) {
 	return i(a(e));
 }
 //#endregion
-export { c as loadOrCreateDeviceIdentity, l as loadPersistedGatewayAuthMd5, d as publicKeyRawBase64UrlFromPem, u as signDevicePayload };
+export { c as loadOrCreateDeviceIdentity, u as publicKeyRawBase64UrlFromPem, l as signDevicePayload };

package/dist/modules/device/index.mjs

@@ -1,6 +1,6 @@
 import "./gateway-auth.mjs";
-import "./identity.mjs";
 import "./registry.mjs";
+import "./identity.mjs";
 import "./device-info.mjs";
 import "./helpers.mjs";
 import "./auth.mjs";

package/dist/modules/device/registry.mjs

@@ -1,26 +1,37 @@
-import { useClawLogger as e } from "../../utils/logger.mjs";
-import { getConfigManager as t } from "../configs/config-manager.mjs";
-import { isOKResponse as n } from "../../apis/helpers.mjs";
-import { createClawCloudClient as r } from "../../apis/claw-cloud.mjs";
-import { updatePersistedIdentity as i } from "../configs/identity-persist.mjs";
+import { getYoyoPluginVersionCode as e } from "../../utils/version.mjs";
+import { useClawLogger as t } from "../../utils/logger.mjs";
+import { getConfigManager as n } from "../configs/config-manager.mjs";
+import { isOKResponse as r } from "../../apis/helpers.mjs";
+import { createClawCloudClient as i } from "../../apis/claw-cloud.mjs";
+import { getPersistedIdentity as a, updatePersistedIdentity as o } from "../configs/identity-persist.mjs";
 import "../configs/index.mjs";
 import "../../apis/index.mjs";
-import { formatHashForLog as a } from "../../utils/hash.mjs";
-import { createGatewayAuthMd5 as o, isSameGatewayAuthMd5 as s } from "./gateway-auth.mjs";
-import { loadPersistedGatewayAuthMd5 as c } from "./identity.mjs";
+import { formatHashForLog as s } from "../../utils/hash.mjs";
+import { createGatewayAuthMd5 as c, isSameGatewayAuthMd5 as l } from "./gateway-auth.mjs";
 //#region src/modules/device/registry.ts
-async function l(e, i) {
-	if (!e || !i) throw Error("设备信息或用户信息缺失");
-	let a = t().getGatewayAuthConfig(), o = await r().registerDevice(e, i, a);
-	if (!n(o)) throw Error(`注册失败：${o.data?.cnMessage}`);
+async function u(t, a) {
+	if (!t || !a) throw Error("设备信息或用户信息缺失");
+	let o = n().getGatewayAuthConfig(), s = c(o), l = e(), u = await i().registerDevice(t, a, o);
+	if (!r(u)) throw Error(`注册失败：${u.data?.cnMessage}`);
+	await f(s, l);
 }
-async function u(n, r) {
-	let u = o(t().getGatewayAuthConfig()), d = await c(), f = e();
-	if (f.info(`[yoyoclaw-registry] checking gateway auth md5: current=${a(u)}, persisted=${a(d)}`), s(d, u)) {
-		f.info("[yoyoclaw-registry] gateway auth unchanged, skipping device registration");
+async function d(r, i) {
+	let o = c(n().getGatewayAuthConfig()), d = e(), f = await a(), p = f?.gatewayAuthMd5, m = f?.pluginVersionCode, h = t();
+	if (h.info(`[yoyoclaw-registry] checking registration state: gatewayAuth current=${s(o)}, persisted=${s(p)}; pluginVersionCode current=${d}, persisted=${m ?? "none"}`), l(p, o) && m === d) {
+		h.info("[yoyoclaw-registry] registration state unchanged, skipping device registration");
 		return;
 	}
-	f.info("[yoyoclaw-registry] gateway auth changed, registering device"), await l(n, r), await i({ gatewayAuthMd5: u }), f.info("[yoyoclaw-registry] gateway auth md5 persisted after device registration");
+	h.info("[yoyoclaw-registry] registration state changed, registering device"), await u(r, i), h.info(`[yoyoclaw-registry] device registration succeeded, pluginVersionCode=${d}`);
+}
+async function f(e, n) {
+	try {
+		await o({
+			gatewayAuthMd5: e,
+			pluginVersionCode: n
+		}), t().info("[yoyoclaw-registry] registration state persisted after device registration");
+	} catch (e) {
+		t().warn(`[yoyoclaw-registry] failed to persist registration state: ${String(e)}`);
+	}
 }
 //#endregion
-export { l as registerDevice, u as registerDeviceIfGatewayAuthChanged };
+export { u as registerDevice, d as registerDeviceIfRegistrationStateChanged };

package/dist/modules/device-toolset/ack.mjs

@@ -0,0 +1,54 @@
+import { processDeviceToolSet as e } from "./processor.mjs";
+//#region src/modules/device-toolset/ack.ts
+var t = "200", n = "500", r = "DeviceToolSet payload missing nodeId";
+async function i(t) {
+	let n = a(t.payload);
+	if (t.namespace !== "yoyoclaw") {
+		let e = `Unsupported DeviceToolSet namespace: ${t.namespace ?? "unknown"}`;
+		return {
+			ok: !1,
+			error: e,
+			payload: s(n, e)
+		};
+	}
+	if (!n) return {
+		ok: !1,
+		error: r,
+		payload: s("", r)
+	};
+	try {
+		return {
+			ok: !0,
+			payload: o(await e(t.payload))
+		};
+	} catch (e) {
+		let t = e instanceof Error ? e.message : String(e);
+		return {
+			ok: !1,
+			error: t,
+			payload: s(n, t)
+		};
+	}
+}
+function a(e) {
+	let t = e?.nodeId;
+	return typeof t == "string" && t.trim() ? t : "";
+}
+function o(e) {
+	return {
+		nodeId: e.nodeId,
+		errorCode: t,
+		changed: e.changed,
+		rawCount: e.rawCount,
+		validCount: e.validCount
+	};
+}
+function s(e, t) {
+	return {
+		nodeId: e,
+		errorCode: n,
+		errorMessage: t
+	};
+}
+//#endregion
+export { i as createDeviceToolSetUpdateAck };

package/dist/modules/device-toolset/archive.mjs

@@ -3,25 +3,20 @@ import { INVALID_TOOL_FILENAME_CHAR_PATTERN as t, TOOL_ARCHIVE_DIR as n } from "
 import r from "node:path";
 //#region src/modules/device-toolset/archive.ts
 async function i(t, i) {
-	let s = 0, c = 0;
+	let s = 0;
 	for (let a of i) {
 		let i = o(a.name);
-		if (!i) {
-			c += 1;
-			continue;
-		}
-		await e({
+		i && (await e({
 			rootDir: t,
 			relativePath: r.join(n, i),
 			data: JSON.stringify(a, null, 2),
 			encoding: "utf8",
 			mkdir: !0
-		}), s += 1;
+		}), s += 1);
 	}
 	return {
 		archiveDir: a(t),
-		writtenCount: s,
-		skippedCount: c
+		writtenCount: s
 	};
 }
 function a(e) {

package/dist/modules/device-toolset/index.mjs

@@ -1,2 +1,3 @@
 import "./normalize.mjs";
 import "./processor.mjs";
+import "./ack.mjs";

package/dist/modules/device-toolset/normalize.mjs

@@ -10,15 +10,14 @@ function t(t) {
 	return t;
 }
 function n(e) {
-	let t = e.nodeId, n = /* @__PURE__ */ new Map(), i = 0;
+	let t = e.nodeId, n = /* @__PURE__ */ new Map();
 	for (let t of e.toolSet) {
 		let e = r(t);
-		e ? n.set(e.name, e) : i += 1;
+		e && n.set(e.name, e);
 	}
 	return {
 		nodeId: t,
-		tools: Array.from(n.values()),
-		skippedCount: i
+		tools: Array.from(n.values())
 	};
 }
 function r(t) {

package/dist/modules/device-toolset/persist.mjs

@@ -36,8 +36,6 @@ async function s(e, t, r) {
 		mkdir: !0
 	}), {
 		changed: !0,
-		nodeCount: d(a.tools),
-		toolCount: Object.keys(a.tools).length,
 		cache: a
 	};
 }
@@ -72,10 +70,5 @@ function l(e, t) {
 function u(e, t) {
 	return [...new Set([...e, t])];
 }
-function d(e) {
-	let t = /* @__PURE__ */ new Set();
-	for (let n of Object.values(e)) for (let e of n.supportedNodeIds) t.add(e);
-	return t.size;
-}
 //#endregion
 export { o as loadDeviceToolSetCache, s as mergeDeviceToolSetCache };

package/dist/modules/device-toolset/processor.mjs

@@ -14,29 +14,29 @@ async function g(n) {
 	let g = p(n), _ = t();
 	if (!_) throw Error("Unable to resolve home directory for DeviceToolSet persistence");
 	let v = m(g);
-	e().info(`[yoyoclaw-device-toolset] process start, nodeId: ${v.nodeId}, tools: ${v.tools.length}, skipped: ${v.skippedCount}`);
+	e().info(`[yoyoclaw-device-toolset] process start, nodeId: ${v.nodeId}, raw: ${g.toolSet.length}, valid: ${v.tools.length}`);
 	let y = u(v.tools);
 	if (e().debug?.(`[yoyoclaw-device-toolset] computed md5, nodeId: ${v.nodeId}, md5: ${y}`), !(await d(_, v.nodeId, y)).changed) {
 		let t = await l(_, h);
 		return e().info(`[yoyoclaw-device-toolset] unchanged, skip refresh, nodeId: ${v.nodeId}, artifactsRestored: ${t.restored}`), {
 			changed: !1,
 			nodeId: v.nodeId,
-			skippedCount: v.skippedCount
+			rawCount: g.toolSet.length,
+			validCount: v.tools.length
 		};
 	}
 	let b = await s(_, v.nodeId, v.tools);
-	e().info(`[yoyoclaw-device-toolset] cache merged, nodeId: ${v.nodeId}, supportedNodes: ${b.nodeCount}, tools: ${b.toolCount}`);
+	e().info(`[yoyoclaw-device-toolset] cache merged, nodeId: ${v.nodeId}, processed: ${v.tools.length}`);
 	let x = b.cache.tools, S = await i(_, v.tools);
-	e().info(`[yoyoclaw-device-toolset] archive refreshed, nodeId: ${v.nodeId}, written: ${S.writtenCount}, skipped: ${S.skippedCount}`);
+	e().info(`[yoyoclaw-device-toolset] archive refreshed, nodeId: ${v.nodeId}, written: ${S.writtenCount}`);
 	let C = await c(h, x);
 	e().info(`[yoyoclaw-device-toolset] skill refreshed, nodeId: ${v.nodeId}, rows: ${C.rowCount}, updated: ${C.updated}`), C.updated && await r(h, v.nodeId);
 	let w = await a(S.archiveDir, o(h));
 	return e().info(`[yoyoclaw-device-toolset] mapping ready, nodeId: ${v.nodeId}, mode: ${w.mode}`), await f(_, v.nodeId, y, Date.now()), e().info(`[yoyoclaw-device-toolset] process complete, nodeId: ${v.nodeId}`), {
 		changed: !0,
 		nodeId: v.nodeId,
-		nodeCount: b.nodeCount,
-		toolCount: b.toolCount,
-		skippedCount: v.skippedCount
+		rawCount: g.toolSet.length,
+		validCount: v.tools.length
 	};
 }
 //#endregion

package/dist/services/connection/impl.mjs

@@ -1,6 +1,6 @@
 import { useClawLogger as e } from "../../utils/logger.mjs";
 import { getConfigManager as t } from "../../modules/configs/config-manager.mjs";
-import { registerDevice as n, registerDeviceIfGatewayAuthChanged as r } from "../../modules/device/registry.mjs";
+import { registerDevice as n, registerDeviceIfRegistrationStateChanged as r } from "../../modules/device/registry.mjs";
 import { getDeviceInfo as i } from "../../modules/device/device-info.mjs";
 import "../../modules/device/index.mjs";
 import { clearToken as a, loadToken as o } from "../../honor-auth/token-manager.mjs";

package/dist/utils/version.mjs

@@ -1,7 +1,17 @@
 //#region src/utils/version.ts
-var e = null;
-function t() {
-	return e === null && (e = "1.4.0-beta.4".includes("beta") || "1.4.0-beta.4".includes("alpha")), !!e;
+var e = null, t = null;
+function n() {
+	return e === null && (e = "1.4.1-alpha.2".includes("beta") || "1.4.1-alpha.2".includes("alpha")), !!e;
+}
+function r(e) {
+	if (!e) return 0;
+	let t = Number.parseInt(e, 10);
+	return Number.isFinite(t) && t >= 0 ? t : 0;
+}
+function i() {
+	if (t !== null) return t;
+	let [e, n, i] = "1.4.1-alpha.2".split("-", 1)[0].split("."), a = r(e), o = r(n), s = r(i);
+	return t = a * 1e6 + o * 1e3 + s, t;
 }
 //#endregion
-export { t as isBetaVersion };
+export { i as getYoyoPluginVersionCode, n as isBetaVersion };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@honor-claw/yoyo",
-  "version": "1.4.0-beta.4",
+  "version": "1.4.1-alpha.2",
   "description": "OpenClaw Honor Yoyo connection plugin",
   "keywords": [
     "ai",
@@ -12,8 +12,7 @@
   "files": [
     "dist",
     "skills",
-    "openclaw.plugin.json",
-    "src/agent/**/*.md"
+    "openclaw.plugin.json"
   ],
   "type": "module",
   "exports": {

package/skills/yoyo-update/SKILL.md

@@ -0,0 +1,166 @@
+---
+name: yoyo-update
+description: >
+  更新 YOYO 插件到最新版本。当用户要求更新、升级 yoyo 插件，或检查 yoyo 插件版本更新时触发。
+metadata: { "openclaw": { "emoji": "🔄", "always": true } }
+---
+
+# YOYO 插件更新
+
+按照以下 5 步工作流完成 YOYO 插件的版本更新。
+
+## 全局规则
+
+- [MANDATORY] **严禁在技能流程内重启网关** — 不得执行 `openclaw gateway stop/start/restart` 或任何网关重启操作
+- [MANDATORY] **严禁卸载插件** — 不得执行 `openclaw plugins uninstall`，否则用户配置将丢失
+- [MANDATORY] 出错时仅汇总错误并给出建议，不得尝试自动修复（尤其是不得通过卸载重装来解决问题）
+- [MANDATORY] 所有面向用户的输出必须使用中文
+- 所有命令在 Windows (bash) 和 Unix (bash) 环境下格式一致，无需区分平台
+
+## 步骤 1：预检查
+
+执行以下命令获取当前插件信息：
+
+```bash
+openclaw plugins info yoyo
+```
+
+**输出字段说明**：
+
+| 字段           | 说明                         | 示例                             |
+| -------------- | ---------------------------- | -------------------------------- |
+| `Status`       | 插件加载状态                 | `loaded` / `error` / `not found` |
+| `Version`      | 当前已安装版本               | `1.3.0-beta.8`                   |
+| `Spec`         | 安装来源标识，含包名和渠道   | `@honor-claw/yoyo@beta`          |
+| `Install path` | 插件安装路径                 | `~/.openclaw/extensions/yoyo`    |
+
+**处理规则**：
+
+- 若插件未找到（输出为空或提示未安装）→ 告知用户"未检测到 YOYO 插件，请先安装"并停止
+- 若状态非 `loaded`（如 `error`）→ 告知用户插件状态异常并展示具体信息，停止流程
+- 若命令本身执行失败 → 告知用户"无法获取插件信息，请确认 OpenClaw 网关正在运行"并停止
+- 成功获取信息 → 提取 `Version` 和 `Spec` 字段值，进入步骤 2
+
+## 步骤 2：检查最新版本
+
+### 2.1 确定当前发布渠道
+
+根据步骤 1 中 `Spec` 字段判断当前发布渠道：
+
+- `Spec` 包含 `@alpha` 后缀 → 渠道为 `alpha`
+- `Spec` 包含 `@beta` 后缀 → 渠道为 `beta`
+- `Spec` 无预发布后缀 → 渠道为 `latest`
+
+### 2.2 查询最新版本
+
+执行以下命令获取所有发布渠道的最新版本：
+
+```bash
+npm view @honor-claw/yoyo dist-tags --json
+```
+
+从 JSON 输出中提取对应渠道的版本号。示例输出：
+
+```json
+{
+  "latest": "1.2.0",
+  "beta": "1.3.0-beta.8",
+  "alpha": "1.4.0-alpha.3"
+}
+```
+
+若 `npm view` 命令失败，回退使用以下命令获取 `latest` 版本：
+
+```bash
+npm view @honor-claw/yoyo version
+```
+
+### 2.3 版本对比
+
+将目标版本（对应渠道最新版）与步骤 1 获取的当前版本进行对比：
+
+- **版本相同** → 告知用户"当前已是最新版本（v{version}），无需更新"并停止流程
+- **版本不同** → 记录当前版本和目标版本，进入步骤 3
+
+## 步骤 3：展示版本差异
+
+向用户展示更新摘要后直接进入步骤 4：
+
+```
+🔄 YOYO 插件更新可用
+
+当前版本：v{当前版本}
+目标版本：v{目标版本}
+发布渠道：{渠道名}
+```
+
+## 步骤 4：执行更新
+
+### 4.1 执行更新命令
+
+```bash
+openclaw plugins update yoyo
+```
+
+注意：该命令可能需要较长时间执行（下载和安装），请使用足够的超时时间。
+
+### 4.2 监控更新进度
+
+实时监控命令输出，根据不同阶段向用户报告进度：
+
+| 输出关键词                             | 向用户报告        | 内部处理                       |
+| -------------------------------------- | ----------------- | ------------------------------ |
+| `Downloading @honor-claw/yoyo@`        | "正在下载插件..." | —                              |
+| `Extracting`                           | 不输出            | 静默跟踪                       |
+| `Installing to`                        | "正在更新插件..." | —                              |
+| `Installing plugin dependencies`       | 不输出            | 静默跟踪                       |
+| `Updated yoyo:`                        | 不输出            | 捕获成功版本信息               |
+| `Config overwrite:` / `Config backup:` | 不输出            | 记录配置备份路径               |
+| `Restart the gateway to load plugins`  | 不输出            | 更新成功的确认信号，进入步骤 5 |
+
+### 4.3 错误处理
+
+若命令执行过程中出现错误（非零退出码或输出中包含错误信息）：
+
+- 记录完整错误输出
+- 不尝试重试或替代方案
+- 直接进入步骤 5 的失败处理流程
+
+## 步骤 5：更新后处理
+
+### 更新成功
+
+向用户报告：
+
+```
+✅ 插件更新完成
+
+更新版本：v{旧版本} → v{新版本}
+
+插件更新完成，重启网关后生效。是否立即重启？
+```
+
+**[MANDATORY] 不得在此步骤中执行网关重启操作。** 仅向用户提问，由用户在下一轮对话中自行决定是否重启。
+
+### 更新失败
+
+向用户报告失败摘要：
+
+```
+❌ 插件更新失败
+
+失败原因：{简要描述错误}
+```
+
+并给出以下建议（根据实际错误类型选择）：
+
+- 网络错误（如 `ECONNREFUSED`、`ETIMEDOUT`）→ "请检查网络连接后重试"
+- 权限错误（如 `EACCES`、`EPERM`）→ "请检查 OpenClaw 安装目录的读写权限"
+- 版本冲突 / 依赖冲突 → "请将以下错误信息反馈给开发团队"
+- 其他未预期错误 → "请将错误信息反馈给开发团队，或稍后重试"
+
+**[MANDATORY] 不得尝试以下操作**：
+- 卸载后重装插件（配置会丢失）
+- 手动删除插件目录
+- 修改插件配置文件来绕过错误
+- 重启网关