@nextclaw/desktop-extension-wechat 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 NextClaw contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,11 @@
+# @nextclaw/desktop-extension-wechat
+
+微信桌面观察 Extension。它通过 NextClaw Desktop 的辅助功能宿主读取微信窗口，并把新出现的可见消息接入 Observation。
+
+使用前需要：
+
+1. 在 macOS 系统设置中允许 NextClaw Desktop 使用辅助功能。
+2. 在 NextClaw 中分别允许本 Extension 读取和观察微信。
+3. 由 Agent 使用 `bind_context` 或 `subscribe_events`，并将 `extensionId` 设为 `nextclaw-desktop-extension-wechat`。
+
+当前版本只读取和观察可见内容，不发送消息。微信界面未打开、目标对话不可见或授权被撤销时，Observation 会进入可诊断的阻塞状态。

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+import { WechatDesktopObservationService } from "./services/wechat-desktop-observation.service.js";
+import { AccessibilityNode, WechatDesktopObservationConfig, WechatDesktopSnapshot, WechatVisibleMessage } from "./types/wechat-desktop-extension.types.js";
+import { findNewWechatMessages, normalizeWechatObservationConfig, toWechatDesktopSnapshot } from "./utils/wechat-desktop-snapshot.utils.js";
+export { type AccessibilityNode, type WechatDesktopObservationConfig, WechatDesktopObservationService, type WechatDesktopSnapshot, type WechatVisibleMessage, findNewWechatMessages, normalizeWechatObservationConfig, toWechatDesktopSnapshot };

package/dist/index.js

@@ -0,0 +1,3 @@
+import { findNewWechatMessages, normalizeWechatObservationConfig, toWechatDesktopSnapshot } from "./utils/wechat-desktop-snapshot.utils.js";
+import { WechatDesktopObservationService } from "./services/wechat-desktop-observation.service.js";
+export { WechatDesktopObservationService, findNewWechatMessages, normalizeWechatObservationConfig, toWechatDesktopSnapshot };

package/dist/main.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/main.js

@@ -0,0 +1,15 @@
+import { WechatDesktopObservationService } from "./services/wechat-desktop-observation.service.js";
+import { NextClawExtension } from "@nextclaw/extension-sdk";
+//#region src/main.ts
+const extension = new NextClawExtension();
+const observation = new WechatDesktopObservationService(extension.host.desktop);
+extension.observations.provide(observation.handlers);
+process.once("SIGTERM", () => {
+	observation.close();
+	extension.close();
+});
+await extension.ready();
+//#endregion
+export {};
+
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","names":[],"sources":["../src/main.ts"],"sourcesContent":["import { NextClawExtension } from \"@nextclaw/extension-sdk\";\nimport { WechatDesktopObservationService } from \"./services/wechat-desktop-observation.service.js\";\n\nconst extension = new NextClawExtension();\nconst observation = new WechatDesktopObservationService(extension.host.desktop);\nextension.observations.provide(observation.handlers);\n\nprocess.once(\"SIGTERM\", () => {\n  observation.close();\n  extension.close();\n});\n\nawait extension.ready();\n"],"mappings":";;;AAGA,MAAM,YAAY,IAAI,mBAAmB;AACzC,MAAM,cAAc,IAAI,gCAAgC,UAAU,KAAK,QAAQ;AAC/E,UAAU,aAAa,QAAQ,YAAY,SAAS;AAEpD,QAAQ,KAAK,iBAAiB;AAC5B,aAAY,OAAO;AACnB,WAAU,OAAO;EACjB;AAEF,MAAM,UAAU,OAAO"}

package/dist/services/wechat-desktop-observation.service.d.ts

@@ -0,0 +1,16 @@
+import { DesktopHost, ExtensionObservationHandlers } from "@nextclaw/extension-sdk";
+
+//#region src/services/wechat-desktop-observation.service.d.ts
+declare class WechatDesktopObservationService {
+  private readonly desktop;
+  private readonly watches;
+  private readonly removeEventListener;
+  constructor(desktop: DesktopHost);
+  readonly handlers: ExtensionObservationHandlers;
+  close: () => void;
+  private readSnapshot;
+  private readonly onDesktopEvent;
+}
+//#endregion
+export { WechatDesktopObservationService };
+//# sourceMappingURL=wechat-desktop-observation.service.d.ts.map

package/dist/services/wechat-desktop-observation.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wechat-desktop-observation.service.d.ts","names":[],"sources":["../../src/services/wechat-desktop-observation.service.ts"],"mappings":";;;cAqBa,+BAAA;EAAA,iBAIkB,OAAA;EAAA,iBAHZ,OAAA;EAAA,iBACA,mBAAA;cAEY,OAAA,EAAS,WAAA;EAAA,SAI7B,QAAA,EAAU,4BAAA;EAkCnB,KAAA;EAAA,QAKQ,YAAA;EAAA,iBAcS,cAAA;AAAA"}

package/dist/services/wechat-desktop-observation.service.js

@@ -0,0 +1,94 @@
+import { findNewWechatMessages, normalizeWechatObservationConfig, toWechatDesktopSnapshot } from "../utils/wechat-desktop-snapshot.utils.js";
+//#region src/services/wechat-desktop-observation.service.ts
+var WechatDesktopObservationService = class {
+	watches = /* @__PURE__ */ new Map();
+	removeEventListener;
+	constructor(desktop) {
+		this.desktop = desktop;
+		this.removeEventListener = desktop.onEvent(this.onDesktopEvent);
+	}
+	handlers = {
+		read: async ({ config }) => await this.readSnapshot(normalizeWechatObservationConfig(config)),
+		subscribe: async ({ config, emit, signal, subscriptionId }) => {
+			const normalized = normalizeWechatObservationConfig(config);
+			const baseline = await this.readSnapshot(normalized);
+			const observed = await this.desktop.invoke({
+				method: "host.ui.observe",
+				payload: {
+					target: { applicationId: "wechat" },
+					maxDepth: 24,
+					maxNodes: 1e4
+				},
+				caller: { subscriptionId }
+			});
+			this.watches.set(observed.watchId, {
+				config: normalized,
+				snapshot: baseline,
+				emit
+			});
+			const cleanup = async () => {
+				this.watches.delete(observed.watchId);
+				await this.desktop.invoke({
+					method: "host.ui.unobserve",
+					payload: { watchId: observed.watchId },
+					caller: { subscriptionId }
+				}).catch(() => void 0);
+			};
+			signal.addEventListener("abort", () => void cleanup(), { once: true });
+			return cleanup;
+		},
+		replay: "unsupported"
+	};
+	close = () => {
+		this.removeEventListener();
+		this.watches.clear();
+	};
+	readSnapshot = async (config) => {
+		return toWechatDesktopSnapshot({
+			root: await this.desktop.invoke({
+				method: "host.ui.snapshot",
+				payload: {
+					target: { applicationId: "wechat" },
+					maxDepth: 24,
+					maxNodes: 1e4
+				}
+			}),
+			config
+		});
+	};
+	onDesktopEvent = async (event) => {
+		const state = this.watches.get(event.watchId);
+		if (!state) return;
+		const root = readEventSnapshot(event.event);
+		if (!root) return;
+		const next = toWechatDesktopSnapshot({
+			root,
+			config: state.config
+		});
+		const added = findNewWechatMessages(state.snapshot, next);
+		state.snapshot = next;
+		for (const message of added) await state.emit({
+			id: `wechat-${message.id}`,
+			type: "wechat.desktop.message.visible",
+			occurredAt: next.capturedAt,
+			cursor: message.id,
+			dedupeKey: message.id,
+			payload: {
+				applicationId: next.applicationId,
+				...next.conversation ? { conversation: next.conversation } : {},
+				text: message.text,
+				path: message.path
+			},
+			sourceRefs: [`desktop://wechat/${message.id}`]
+		});
+	};
+};
+function readEventSnapshot(value) {
+	if (!value || typeof value !== "object" || Array.isArray(value)) return null;
+	const event = value;
+	return event.type === "snapshotChanged" ? event.snapshot ?? null : null;
+}
+//#endregion
+export { WechatDesktopObservationService };
+
+//# sourceMappingURL=wechat-desktop-observation.service.js.map

package/dist/services/wechat-desktop-observation.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wechat-desktop-observation.service.js","names":[],"sources":["../../src/services/wechat-desktop-observation.service.ts"],"sourcesContent":["import type {\n  DesktopHost,\n  DesktopHostEvent,\n  ExtensionObservationHandlers,\n} from \"@nextclaw/extension-sdk\";\nimport type {\n  WechatDesktopObservationConfig,\n  WechatDesktopSnapshot,\n} from \"../types/wechat-desktop-extension.types.js\";\nimport {\n  findNewWechatMessages,\n  normalizeWechatObservationConfig,\n  toWechatDesktopSnapshot,\n} from \"../utils/wechat-desktop-snapshot.utils.js\";\n\ntype WatchState = {\n  config: WechatDesktopObservationConfig;\n  snapshot: WechatDesktopSnapshot;\n  emit: Parameters<NonNullable<ExtensionObservationHandlers[\"subscribe\"]>>[0][\"emit\"];\n};\n\nexport class WechatDesktopObservationService {\n  private readonly watches = new Map<string, WatchState>();\n  private readonly removeEventListener: () => void;\n\n  constructor(private readonly desktop: DesktopHost) {\n    this.removeEventListener = desktop.onEvent(this.onDesktopEvent);\n  }\n\n  readonly handlers: ExtensionObservationHandlers = {\n    read: async ({ config }) =>\n      await this.readSnapshot(normalizeWechatObservationConfig(config)),\n    subscribe: async ({ config, emit, signal, subscriptionId }) => {\n      const normalized = normalizeWechatObservationConfig(config);\n      const baseline = await this.readSnapshot(normalized);\n      const observed = await this.desktop.invoke<{ watchId: string }>({\n        method: \"host.ui.observe\",\n        payload: {\n          target: { applicationId: \"wechat\" },\n          maxDepth: 24,\n          maxNodes: 10_000,\n        },\n        caller: { subscriptionId },\n      });\n      this.watches.set(observed.watchId, {\n        config: normalized,\n        snapshot: baseline,\n        emit,\n      });\n      const cleanup = async () => {\n        this.watches.delete(observed.watchId);\n        await this.desktop.invoke({\n          method: \"host.ui.unobserve\",\n          payload: { watchId: observed.watchId },\n          caller: { subscriptionId },\n        }).catch(() => undefined);\n      };\n      signal.addEventListener(\"abort\", () => void cleanup(), { once: true });\n      return cleanup;\n    },\n    replay: \"unsupported\",\n  };\n\n  close = (): void => {\n    this.removeEventListener();\n    this.watches.clear();\n  };\n\n  private readSnapshot = async (\n    config: ReturnType<typeof normalizeWechatObservationConfig>,\n  ): Promise<WechatDesktopSnapshot> => {\n    const root = await this.desktop.invoke({\n      method: \"host.ui.snapshot\",\n      payload: {\n        target: { applicationId: \"wechat\" },\n        maxDepth: 24,\n        maxNodes: 10_000,\n      },\n    });\n    return toWechatDesktopSnapshot({ root, config });\n  };\n\n  private readonly onDesktopEvent = async (\n    event: DesktopHostEvent,\n  ): Promise<void> => {\n    const state = this.watches.get(event.watchId);\n    if (!state) return;\n    const root = readEventSnapshot(event.event);\n    if (!root) return;\n    const next = toWechatDesktopSnapshot({\n      root,\n      config: state.config,\n    });\n    const added = findNewWechatMessages(state.snapshot, next);\n    state.snapshot = next;\n    for (const message of added) {\n      await state.emit({\n        id: `wechat-${message.id}`,\n        type: \"wechat.desktop.message.visible\",\n        occurredAt: next.capturedAt,\n        cursor: message.id,\n        dedupeKey: message.id,\n        payload: {\n          applicationId: next.applicationId,\n          ...(next.conversation ? { conversation: next.conversation } : {}),\n          text: message.text,\n          path: message.path,\n        },\n        sourceRefs: [`desktop://wechat/${message.id}`],\n      });\n    }\n  };\n}\n\nfunction readEventSnapshot(value: unknown): unknown | null {\n  if (!value || typeof value !== \"object\" || Array.isArray(value)) return null;\n  const event = value as Record<string, unknown>;\n  return event.type === \"snapshotChanged\" ? event.snapshot ?? null : null;\n}\n"],"mappings":";;AAqBA,IAAa,kCAAb,MAA6C;CAC3C,0BAA2B,IAAI,KAAyB;CACxD;CAEA,YAAY,SAAuC;AAAtB,OAAA,UAAA;AAC3B,OAAK,sBAAsB,QAAQ,QAAQ,KAAK,eAAe;;CAGjE,WAAkD;EAChD,MAAM,OAAO,EAAE,aACb,MAAM,KAAK,aAAa,iCAAiC,OAAO,CAAC;EACnE,WAAW,OAAO,EAAE,QAAQ,MAAM,QAAQ,qBAAqB;GAC7D,MAAM,aAAa,iCAAiC,OAAO;GAC3D,MAAM,WAAW,MAAM,KAAK,aAAa,WAAW;GACpD,MAAM,WAAW,MAAM,KAAK,QAAQ,OAA4B;IAC9D,QAAQ;IACR,SAAS;KACP,QAAQ,EAAE,eAAe,UAAU;KACnC,UAAU;KACV,UAAU;KACX;IACD,QAAQ,EAAE,gBAAgB;IAC3B,CAAC;AACF,QAAK,QAAQ,IAAI,SAAS,SAAS;IACjC,QAAQ;IACR,UAAU;IACV;IACD,CAAC;GACF,MAAM,UAAU,YAAY;AAC1B,SAAK,QAAQ,OAAO,SAAS,QAAQ;AACrC,UAAM,KAAK,QAAQ,OAAO;KACxB,QAAQ;KACR,SAAS,EAAE,SAAS,SAAS,SAAS;KACtC,QAAQ,EAAE,gBAAgB;KAC3B,CAAC,CAAC,YAAY,KAAA,EAAU;;AAE3B,UAAO,iBAAiB,eAAe,KAAK,SAAS,EAAE,EAAE,MAAM,MAAM,CAAC;AACtE,UAAO;;EAET,QAAQ;EACT;CAED,cAAoB;AAClB,OAAK,qBAAqB;AAC1B,OAAK,QAAQ,OAAO;;CAGtB,eAAuB,OACrB,WACmC;AASnC,SAAO,wBAAwB;GAAE,MARpB,MAAM,KAAK,QAAQ,OAAO;IACrC,QAAQ;IACR,SAAS;KACP,QAAQ,EAAE,eAAe,UAAU;KACnC,UAAU;KACV,UAAU;KACX;IACF,CAAC;GACqC;GAAQ,CAAC;;CAGlD,iBAAkC,OAChC,UACkB;EAClB,MAAM,QAAQ,KAAK,QAAQ,IAAI,MAAM,QAAQ;AAC7C,MAAI,CAAC,MAAO;EACZ,MAAM,OAAO,kBAAkB,MAAM,MAAM;AAC3C,MAAI,CAAC,KAAM;EACX,MAAM,OAAO,wBAAwB;GACnC;GACA,QAAQ,MAAM;GACf,CAAC;EACF,MAAM,QAAQ,sBAAsB,MAAM,UAAU,KAAK;AACzD,QAAM,WAAW;AACjB,OAAK,MAAM,WAAW,MACpB,OAAM,MAAM,KAAK;GACf,IAAI,UAAU,QAAQ;GACtB,MAAM;GACN,YAAY,KAAK;GACjB,QAAQ,QAAQ;GAChB,WAAW,QAAQ;GACnB,SAAS;IACP,eAAe,KAAK;IACpB,GAAI,KAAK,eAAe,EAAE,cAAc,KAAK,cAAc,GAAG,EAAE;IAChE,MAAM,QAAQ;IACd,MAAM,QAAQ;IACf;GACD,YAAY,CAAC,oBAAoB,QAAQ,KAAK;GAC/C,CAAC;;;AAKR,SAAS,kBAAkB,OAAgC;AACzD,KAAI,CAAC,SAAS,OAAO,UAAU,YAAY,MAAM,QAAQ,MAAM,CAAE,QAAO;CACxE,MAAM,QAAQ;AACd,QAAO,MAAM,SAAS,oBAAoB,MAAM,YAAY,OAAO"}

package/dist/types/wechat-desktop-extension.types.d.ts

@@ -0,0 +1,30 @@
+//#region src/types/wechat-desktop-extension.types.d.ts
+type AccessibilityNode = {
+  role?: string;
+  subrole?: string;
+  title?: string;
+  value?: string;
+  description?: string;
+  identifier?: string;
+  focused?: boolean;
+  children?: AccessibilityNode[];
+};
+type WechatDesktopObservationConfig = {
+  conversation?: string;
+  ignorePrefixes: string[];
+  maxItems: number;
+};
+type WechatVisibleMessage = {
+  id: string;
+  text: string;
+  path: number[];
+};
+type WechatDesktopSnapshot = {
+  applicationId: "wechat";
+  conversation?: string;
+  messages: WechatVisibleMessage[];
+  capturedAt: string;
+};
+//#endregion
+export { AccessibilityNode, WechatDesktopObservationConfig, WechatDesktopSnapshot, WechatVisibleMessage };
+//# sourceMappingURL=wechat-desktop-extension.types.d.ts.map

package/dist/types/wechat-desktop-extension.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wechat-desktop-extension.types.d.ts","names":[],"sources":["../../src/types/wechat-desktop-extension.types.ts"],"mappings":";KAAY,iBAAA;EACV,IAAA;EACA,OAAA;EACA,KAAA;EACA,KAAA;EACA,WAAA;EACA,UAAA;EACA,OAAA;EACA,QAAA,GAAW,iBAAA;AAAA;AAAA,KAGD,8BAAA;EACV,YAAA;EACA,cAAA;EACA,QAAA;AAAA;AAAA,KAGU,oBAAA;EACV,EAAA;EACA,IAAA;EACA,IAAA;AAAA;AAAA,KAGU,qBAAA;EACV,aAAA;EACA,YAAA;EACA,QAAA,EAAU,oBAAA;EACV,UAAA;AAAA"}

package/dist/utils/wechat-desktop-snapshot.utils.d.ts

@@ -0,0 +1,13 @@
+import { WechatDesktopObservationConfig, WechatDesktopSnapshot, WechatVisibleMessage } from "../types/wechat-desktop-extension.types.js";
+
+//#region src/utils/wechat-desktop-snapshot.utils.d.ts
+declare function normalizeWechatObservationConfig(value: unknown): WechatDesktopObservationConfig;
+declare function toWechatDesktopSnapshot(input: {
+  root: unknown;
+  config: WechatDesktopObservationConfig;
+  capturedAt?: string;
+}): WechatDesktopSnapshot;
+declare function findNewWechatMessages(previous: WechatDesktopSnapshot, next: WechatDesktopSnapshot): WechatVisibleMessage[];
+//#endregion
+export { findNewWechatMessages, normalizeWechatObservationConfig, toWechatDesktopSnapshot };
+//# sourceMappingURL=wechat-desktop-snapshot.utils.d.ts.map

package/dist/utils/wechat-desktop-snapshot.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wechat-desktop-snapshot.utils.d.ts","names":[],"sources":["../../src/utils/wechat-desktop-snapshot.utils.ts"],"mappings":";;;iBAWgB,gCAAA,CACd,KAAA,YACC,8BAAA;AAAA,iBAoBa,uBAAA,CAAwB,KAAA;EACtC,IAAA;EACA,MAAA,EAAQ,8BAAA;EACR,UAAA;AAAA,IACE,qBAAA;AAAA,iBAaY,qBAAA,CACd,QAAA,EAAU,qBAAA,EACV,IAAA,EAAM,qBAAA,GACL,oBAAA"}

package/dist/utils/wechat-desktop-snapshot.utils.js

@@ -0,0 +1,67 @@
+import { createHash } from "node:crypto";
+//#region src/utils/wechat-desktop-snapshot.utils.ts
+const DEFAULT_IGNORE_PREFIXES = ["🤖[墨爪]"];
+const MESSAGE_ROLES = new Set([
+	"AXStaticText",
+	"AXTextArea",
+	"AXTextField"
+]);
+function normalizeWechatObservationConfig(value) {
+	const record = asRecord(value);
+	const maxItems = Number(record.maxItems);
+	const ignorePrefixes = Array.isArray(record.ignorePrefixes) ? record.ignorePrefixes.filter((entry) => typeof entry === "string").map((entry) => entry.trim()).filter(Boolean) : DEFAULT_IGNORE_PREFIXES;
+	return {
+		...readString(record.conversation) ? { conversation: readString(record.conversation) } : {},
+		ignorePrefixes,
+		maxItems: Number.isInteger(maxItems) ? Math.max(1, Math.min(100, maxItems)) : 30
+	};
+}
+function toWechatDesktopSnapshot(input) {
+	const messages = [];
+	visitNode(input.root, [], input.config, messages);
+	return {
+		applicationId: "wechat",
+		...input.config.conversation ? { conversation: input.config.conversation } : {},
+		messages: messages.slice(-input.config.maxItems),
+		capturedAt: input.capturedAt ?? (/* @__PURE__ */ new Date()).toISOString()
+	};
+}
+function findNewWechatMessages(previous, next) {
+	const seen = new Set(previous.messages.map((message) => message.id));
+	return next.messages.filter((message) => !seen.has(message.id));
+}
+function visitNode(value, path, config, messages) {
+	const node = asNode(value);
+	if (!node) return;
+	const text = readNodeText(node);
+	if (text && MESSAGE_ROLES.has(node.role ?? "") && !config.ignorePrefixes.some((prefix) => text.startsWith(prefix))) messages.push({
+		id: createHash("sha256").update(`${path.join(".")}\u0000${text}`).digest("hex").slice(0, 24),
+		text,
+		path
+	});
+	for (const [index, child] of (node.children ?? []).entries()) visitNode(child, [...path, index], config, messages);
+}
+function readNodeText(node) {
+	for (const value of [
+		node.value,
+		node.title,
+		node.description
+	]) {
+		const text = readString(value);
+		if (text && text.length <= 8e3) return text;
+	}
+	return null;
+}
+function asNode(value) {
+	return value && typeof value === "object" && !Array.isArray(value) ? value : null;
+}
+function asRecord(value) {
+	return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+function readString(value) {
+	return typeof value === "string" && value.trim() ? value.trim() : void 0;
+}
+//#endregion
+export { findNewWechatMessages, normalizeWechatObservationConfig, toWechatDesktopSnapshot };
+
+//# sourceMappingURL=wechat-desktop-snapshot.utils.js.map

package/dist/utils/wechat-desktop-snapshot.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wechat-desktop-snapshot.utils.js","names":[],"sources":["../../src/utils/wechat-desktop-snapshot.utils.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\nimport type {\n  AccessibilityNode,\n  WechatDesktopObservationConfig,\n  WechatDesktopSnapshot,\n  WechatVisibleMessage,\n} from \"../types/wechat-desktop-extension.types.js\";\n\nconst DEFAULT_IGNORE_PREFIXES = [\"🤖[墨爪]\"];\nconst MESSAGE_ROLES = new Set([\"AXStaticText\", \"AXTextArea\", \"AXTextField\"]);\n\nexport function normalizeWechatObservationConfig(\n  value: unknown,\n): WechatDesktopObservationConfig {\n  const record = asRecord(value);\n  const maxItems = Number(record.maxItems);\n  const ignorePrefixes = Array.isArray(record.ignorePrefixes)\n    ? record.ignorePrefixes\n        .filter((entry): entry is string => typeof entry === \"string\")\n        .map((entry) => entry.trim())\n        .filter(Boolean)\n    : DEFAULT_IGNORE_PREFIXES;\n  return {\n    ...(readString(record.conversation)\n      ? { conversation: readString(record.conversation) }\n      : {}),\n    ignorePrefixes,\n    maxItems: Number.isInteger(maxItems)\n      ? Math.max(1, Math.min(100, maxItems))\n      : 30,\n  };\n}\n\nexport function toWechatDesktopSnapshot(input: {\n  root: unknown;\n  config: WechatDesktopObservationConfig;\n  capturedAt?: string;\n}): WechatDesktopSnapshot {\n  const messages: WechatVisibleMessage[] = [];\n  visitNode(input.root, [], input.config, messages);\n  return {\n    applicationId: \"wechat\",\n    ...(input.config.conversation\n      ? { conversation: input.config.conversation }\n      : {}),\n    messages: messages.slice(-input.config.maxItems),\n    capturedAt: input.capturedAt ?? new Date().toISOString(),\n  };\n}\n\nexport function findNewWechatMessages(\n  previous: WechatDesktopSnapshot,\n  next: WechatDesktopSnapshot,\n): WechatVisibleMessage[] {\n  const seen = new Set(previous.messages.map((message) => message.id));\n  return next.messages.filter((message) => !seen.has(message.id));\n}\n\nfunction visitNode(\n  value: unknown,\n  path: number[],\n  config: WechatDesktopObservationConfig,\n  messages: WechatVisibleMessage[],\n): void {\n  const node = asNode(value);\n  if (!node) return;\n  const text = readNodeText(node);\n  if (\n    text &&\n    MESSAGE_ROLES.has(node.role ?? \"\") &&\n    !config.ignorePrefixes.some((prefix) => text.startsWith(prefix))\n  ) {\n    messages.push({\n      id: createHash(\"sha256\")\n        .update(`${path.join(\".\")}\\u0000${text}`)\n        .digest(\"hex\")\n        .slice(0, 24),\n      text,\n      path,\n    });\n  }\n  for (const [index, child] of (node.children ?? []).entries()) {\n    visitNode(child, [...path, index], config, messages);\n  }\n}\n\nfunction readNodeText(node: AccessibilityNode): string | null {\n  for (const value of [node.value, node.title, node.description]) {\n    const text = readString(value);\n    if (text && text.length <= 8_000) return text;\n  }\n  return null;\n}\n\nfunction asNode(value: unknown): AccessibilityNode | null {\n  return value && typeof value === \"object\" && !Array.isArray(value)\n    ? (value as AccessibilityNode)\n    : null;\n}\n\nfunction asRecord(value: unknown): Record<string, unknown> {\n  return value && typeof value === \"object\" && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : {};\n}\n\nfunction readString(value: unknown): string | undefined {\n  return typeof value === \"string\" && value.trim() ? value.trim() : undefined;\n}\n"],"mappings":";;AAQA,MAAM,0BAA0B,CAAC,SAAS;AAC1C,MAAM,gBAAgB,IAAI,IAAI;CAAC;CAAgB;CAAc;CAAc,CAAC;AAE5E,SAAgB,iCACd,OACgC;CAChC,MAAM,SAAS,SAAS,MAAM;CAC9B,MAAM,WAAW,OAAO,OAAO,SAAS;CACxC,MAAM,iBAAiB,MAAM,QAAQ,OAAO,eAAe,GACvD,OAAO,eACJ,QAAQ,UAA2B,OAAO,UAAU,SAAS,CAC7D,KAAK,UAAU,MAAM,MAAM,CAAC,CAC5B,OAAO,QAAQ,GAClB;AACJ,QAAO;EACL,GAAI,WAAW,OAAO,aAAa,GAC/B,EAAE,cAAc,WAAW,OAAO,aAAa,EAAE,GACjD,EAAE;EACN;EACA,UAAU,OAAO,UAAU,SAAS,GAChC,KAAK,IAAI,GAAG,KAAK,IAAI,KAAK,SAAS,CAAC,GACpC;EACL;;AAGH,SAAgB,wBAAwB,OAId;CACxB,MAAM,WAAmC,EAAE;AAC3C,WAAU,MAAM,MAAM,EAAE,EAAE,MAAM,QAAQ,SAAS;AACjD,QAAO;EACL,eAAe;EACf,GAAI,MAAM,OAAO,eACb,EAAE,cAAc,MAAM,OAAO,cAAc,GAC3C,EAAE;EACN,UAAU,SAAS,MAAM,CAAC,MAAM,OAAO,SAAS;EAChD,YAAY,MAAM,+BAAc,IAAI,MAAM,EAAC,aAAa;EACzD;;AAGH,SAAgB,sBACd,UACA,MACwB;CACxB,MAAM,OAAO,IAAI,IAAI,SAAS,SAAS,KAAK,YAAY,QAAQ,GAAG,CAAC;AACpE,QAAO,KAAK,SAAS,QAAQ,YAAY,CAAC,KAAK,IAAI,QAAQ,GAAG,CAAC;;AAGjE,SAAS,UACP,OACA,MACA,QACA,UACM;CACN,MAAM,OAAO,OAAO,MAAM;AAC1B,KAAI,CAAC,KAAM;CACX,MAAM,OAAO,aAAa,KAAK;AAC/B,KACE,QACA,cAAc,IAAI,KAAK,QAAQ,GAAG,IAClC,CAAC,OAAO,eAAe,MAAM,WAAW,KAAK,WAAW,OAAO,CAAC,CAEhE,UAAS,KAAK;EACZ,IAAI,WAAW,SAAS,CACrB,OAAO,GAAG,KAAK,KAAK,IAAI,CAAC,QAAQ,OAAO,CACxC,OAAO,MAAM,CACb,MAAM,GAAG,GAAG;EACf;EACA;EACD,CAAC;AAEJ,MAAK,MAAM,CAAC,OAAO,WAAW,KAAK,YAAY,EAAE,EAAE,SAAS,CAC1D,WAAU,OAAO,CAAC,GAAG,MAAM,MAAM,EAAE,QAAQ,SAAS;;AAIxD,SAAS,aAAa,MAAwC;AAC5D,MAAK,MAAM,SAAS;EAAC,KAAK;EAAO,KAAK;EAAO,KAAK;EAAY,EAAE;EAC9D,MAAM,OAAO,WAAW,MAAM;AAC9B,MAAI,QAAQ,KAAK,UAAU,IAAO,QAAO;;AAE3C,QAAO;;AAGT,SAAS,OAAO,OAA0C;AACxD,QAAO,SAAS,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,MAAM,GAC7D,QACD;;AAGN,SAAS,SAAS,OAAyC;AACzD,QAAO,SAAS,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,MAAM,GAC7D,QACD,EAAE;;AAGR,SAAS,WAAW,OAAoC;AACtD,QAAO,OAAO,UAAU,YAAY,MAAM,MAAM,GAAG,MAAM,MAAM,GAAG,KAAA"}

package/nextclaw.extension.json

@@ -0,0 +1,46 @@
+{
+  "id": "nextclaw-desktop-extension-wechat",
+  "name": "微信桌面观察",
+  "version": "0.1.0",
+  "server": {
+    "type": "stdio",
+    "command": "node",
+    "args": ["dist/main.js"]
+  },
+  "contributes": {
+    "hostCapabilities": {
+      "desktopAutomation": {
+        "access": ["ui.read", "ui.observe"]
+      }
+    },
+    "observations": {
+      "read": {
+        "description": "读取当前微信窗口中可见的对话和消息。",
+        "configSchema": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "conversation": { "type": "string" },
+            "maxItems": { "type": "integer", "minimum": 1, "maximum": 100 }
+          }
+        }
+      },
+      "events": {
+        "description": "微信窗口出现新的可见消息时通知当前会话。",
+        "replay": "unsupported",
+        "configSchema": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "conversation": { "type": "string" },
+            "ignorePrefixes": {
+              "type": "array",
+              "items": { "type": "string" }
+            },
+            "maxItems": { "type": "integer", "minimum": 1, "maximum": 100 }
+          }
+        }
+      }
+    }
+  }
+}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@nextclaw/desktop-extension-wechat",
+  "version": "0.2.0",
+  "private": false,
+  "description": "NextClaw WeChat Desktop observation extension.",
+  "type": "module",
+  "exports": {
+    ".": {
+      "development": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "nextclaw.extension.json",
+    "README.md"
+  ],
+  "dependencies": {
+    "@nextclaw/extension-sdk": "0.5.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.17.6",
+    "typescript": "^5.6.3",
+    "vitest": "^4.1.2"
+  },
+  "scripts": {
+    "build": "tsdown src/index.ts src/main.ts --dts.sourcemap --clean --target es2022 --no-fixedExtension --unbundle",
+    "lint": "eslint src --max-warnings=0",
+    "test": "vitest run",
+    "tsc": "tsc -p tsconfig.json"
+  }
+}