wechat-cli 0.1.0__py3-none-any.whl

wechat_cli/assets/controls.swift

@@ -0,0 +1,218 @@
+import AppKit
+import Darwin
+import ApplicationServices
+import Foundation
+
+// Operates only the configured WeChat process, through its own native controls.
+// Never grants permissions. Send confirmation is scoped to the selected file dialog.
+struct ControlError: Error { let code: String }
+var fileSendStarted = false
+let request = try JSONSerialization.jsonObject(with: FileHandle.standardInput.readDataToEndOfFile()) as! [String:Any]
+func emit(_ value: [String:Any]) { let data = try! JSONSerialization.data(withJSONObject:value, options:[.sortedKeys]); FileHandle.standardOutput.write(data) }
+func attribute(_ element: AXUIElement, _ name: String) -> AnyObject? {
+    var value: CFTypeRef?; guard AXUIElementCopyAttributeValue(element,name as CFString,&value) == .success else { return nil }; return value
+}
+func string(_ element: AXUIElement, _ name: String) -> String { attribute(element,name) as? String ?? "" }
+func elements(_ root: AXUIElement) -> [AXUIElement] {
+    var output: [AXUIElement] = [], pending = [root], visited = 0
+    while let element = pending.popLast(), visited < 6000 {
+        visited += 1; output.append(element)
+        if let children = attribute(element,kAXChildrenAttribute) as? [AXUIElement] { pending.append(contentsOf:children.reversed()) }
+    }
+    return output
+}
+func label(_ e: AXUIElement) -> String { [kAXTitleAttribute,kAXDescriptionAttribute,kAXHelpAttribute].map{string(e,$0)}.filter{!$0.isEmpty}.joined(separator:" ") }
+func press(_ e: AXUIElement) throws {
+    if let enabled = attribute(e,kAXEnabledAttribute) as? Bool, !enabled { throw ControlError(code:"native_control_disabled") }
+    var pid:pid_t=0;guard AXUIElementGetPid(e,&pid) == .success else { throw ControlError(code:"native_control_action_failed") }
+    guard let position=attribute(e,kAXPositionAttribute),let size=attribute(e,kAXSizeAttribute),CFGetTypeID(position)==AXValueGetTypeID(),CFGetTypeID(size)==AXValueGetTypeID() else { throw ControlError(code:"native_control_action_failed") }
+    var origin=CGPoint.zero,extent=CGSize.zero
+    guard AXValueGetValue(position as! AXValue,.cgPoint,&origin),AXValueGetValue(size as! AXValue,.cgSize,&extent),extent.width>0,extent.height>0 else { throw ControlError(code:"native_control_action_failed") }
+    let point=CGPoint(x:origin.x+extent.width/2,y:origin.y+extent.height/2)
+    guard let down=CGEvent(mouseEventSource:nil,mouseType:.leftMouseDown,mouseCursorPosition:point,mouseButton:.left),let up=CGEvent(mouseEventSource:nil,mouseType:.leftMouseUp,mouseCursorPosition:point,mouseButton:.left) else { throw ControlError(code:"native_control_action_failed") }
+    guard NSWorkspace.shared.frontmostApplication?.processIdentifier == pid else { throw ControlError(code:"native_app_not_frontmost") }
+    CGEvent(mouseEventSource:nil,mouseType:.mouseMoved,mouseCursorPosition:point,mouseButton:.left)?.post(tap:.cghidEventTap)
+    Thread.sleep(forTimeInterval:0.08)
+    down.post(tap:.cghidEventTap);Thread.sleep(forTimeInterval:0.05);up.post(tap:.cghidEventTap)
+}
+func scrollHistoryUp(_ root:AXUIElement,_ pid:Int32) throws {
+    guard NSWorkspace.shared.frontmostApplication?.processIdentifier == pid,
+          let list=elements(root).first(where:{string($0,kAXIdentifierAttribute)=="chat_message_list"}),
+          let position=attribute(list,kAXPositionAttribute),let size=attribute(list,kAXSizeAttribute) else { throw ControlError(code:"native_attachment_not_visible") }
+    var origin=CGPoint.zero,extent=CGSize.zero
+    guard CFGetTypeID(position)==AXValueGetTypeID(),CFGetTypeID(size)==AXValueGetTypeID(),
+          AXValueGetValue(position as! AXValue,.cgPoint,&origin),AXValueGetValue(size as! AXValue,.cgSize,&extent),extent.width>0,extent.height>0 else { throw ControlError(code:"native_attachment_not_visible") }
+    let point=CGPoint(x:origin.x+extent.width/2,y:origin.y+extent.height/2)
+    CGEvent(mouseEventSource:nil,mouseType:.mouseMoved,mouseCursorPosition:point,mouseButton:.left)?.post(tap:.cghidEventTap)
+    Thread.sleep(forTimeInterval:0.05)
+    CGEvent(scrollWheelEvent2Source:nil,units:.pixel,wheelCount:1,wheel1:600,wheel2:0,wheel3:0)?.post(tap:.cghidEventTap)
+    Thread.sleep(forTimeInterval:0.15)
+}
+func find(_ root: AXUIElement, _ names: [String]) throws -> AXUIElement {
+    let matches = elements(root).filter { e in
+        string(e,kAXRoleAttribute) == kAXButtonRole && names.contains { label(e) == $0 || label(e).hasPrefix($0+"(") || label(e).hasPrefix($0+" (") }
+    }
+    guard let first = matches.last else { throw ControlError(code:"native_control_not_found") }; return first
+}
+func state(_ root: AXUIElement) -> [String:Any] {
+    let list = elements(root)
+    let draft = list.first { string($0,kAXIdentifierAttribute) == "chat_input_field" }
+    let focusedWindow=attribute(root,kAXFocusedWindowAttribute)
+    let fileUiReady=focusedWindow.map{elements($0 as! AXUIElement).contains{string($0,kAXIdentifierAttribute)=="chat_input_field"}} ?? false
+    let title = list.first { string($0,kAXIdentifierAttribute) == "current_chat_name_label" }
+    // Return only active feature controls, not conversation/message contents.
+    let names = list.filter { string($0,kAXRoleAttribute) == kAXButtonRole }.map{label($0)}
+    let featureNames = names.filter { value in ["Voice Input","Send Voice","Cancel","Done","Finish","Stop","Start","Import","语音","取消","完成","停止","开始","导入"].contains{value.hasPrefix($0)} }
+    return ["accessibility":true,"fileUiReady":fileUiReady,"chatName":title.map{string($0,kAXValueAttribute)} ?? "","draft":draft.map{string($0,kAXValueAttribute)} ?? "","controls":Array(Set(featureNames)).sorted()]
+}
+
+func key(_ pid: Int32, _ code: CGKeyCode, _ flags: CGEventFlags = []) throws {
+    guard let down = CGEvent(keyboardEventSource:nil,virtualKey:code,keyDown:true), let up = CGEvent(keyboardEventSource:nil,virtualKey:code,keyDown:false) else { throw ControlError(code:"native_control_failed") }
+    down.flags=flags;up.flags=flags;guard NSWorkspace.shared.frontmostApplication?.processIdentifier == pid else { throw ControlError(code:"native_app_not_frontmost") };down.post(tap:.cghidEventTap);up.post(tap:.cghidEventTap)
+}
+func type(_ pid:Int32, _ value:String) throws {
+    let chars=Array(value.utf16)
+    guard let event=CGEvent(keyboardEventSource:nil,virtualKey:0,keyDown:true) else { throw ControlError(code:"native_control_failed") }
+    chars.withUnsafeBufferPointer { event.keyboardSetUnicodeString(stringLength:chars.count,unicodeString:$0.baseAddress!) }
+    event.postToPid(pid);event.type = .keyUp;event.postToPid(pid)
+}
+func waitFor(_ root:AXUIElement,_ names:[String],_ seconds:Double=3) throws -> AXUIElement {
+    let end=Date().addingTimeInterval(seconds)
+    repeat { if let button=try? find(root,names) { return button };Thread.sleep(forTimeInterval:0.1) } while Date()<end
+    throw ControlError(code:"native_control_not_found")
+}
+func sendFile(_ root:AXUIElement,_ pid:Int32,_ path:String,_ name:String) throws {
+    let expectedChat=state(root)["chatName"] as? String ?? ""
+    // A blank draft and exact chat match are checked before entering the picker.
+    guard (state(root)["draft"] as? String ?? "").isEmpty else { throw ControlError(code:"native_draft_not_empty") }
+    try press(find(root,["Send File","发送文件"]))
+    _ = try waitFor(root,["Open","打开","Choose","选择"])
+    try key(pid,5,[.maskCommand,.maskShift]) // Native NSOpenPanel Go to Folder.
+    Thread.sleep(forTimeInterval:0.15)
+    let fields=elements(root).filter { string($0,kAXRoleAttribute)==kAXTextFieldRole || string($0,kAXRoleAttribute)==kAXComboBoxRole }
+    guard let field=fields.last else { throw ControlError(code:"native_file_picker_not_found") }
+    guard AXUIElementSetAttributeValue(field,kAXValueAttribute as CFString,path as CFString) == .success else { throw ControlError(code:"native_file_picker_not_found") }
+    try key(pid,36);Thread.sleep(forTimeInterval:0.15)
+    // Selecting a file can auto-send in some builds. An error after this action
+    // is an unknown send outcome, never a promise that nothing was sent.
+    do {
+        guard state(root)["chatName"] as? String == expectedChat else { throw ControlError(code:"native_active_chat_mismatch") }
+        guard (state(root)["draft"] as? String ?? "").isEmpty else { throw ControlError(code:"native_draft_not_empty") }
+        fileSendStarted=true
+        try press(waitFor(root,["Open","打开","Choose","选择"]))
+        Thread.sleep(forTimeInterval:0.3)
+        let windows=attribute(root,kAXWindowsAttribute) as? [AXUIElement] ?? []
+        let sheets=windows.flatMap{elements($0).filter{string($0,kAXRoleAttribute)==kAXSheetRole}}
+        for window in windows+sheets {
+            let list=elements(window)
+            let containsName=list.contains { label($0).contains(name) || string($0,kAXValueAttribute).contains(name) }
+            let title=string(window,kAXTitleAttribute)
+            if containsName && (title.contains("Send") || title.contains("发送") || string(window,kAXRoleAttribute)==kAXSheetRole || string(window,kAXSubroleAttribute)=="AXDialog") {
+                if let button=try? find(window,["Send","发送"]) { try press(button);return }
+            }
+        }
+        // This build inserts the selected file into the composer. Send only
+        // that attachment-only draft in the same chat; never send user text.
+        let after=state(root)
+        if after["chatName"] as? String == expectedChat && after["draft"] as? String == "\u{fffc}" {
+            try press(find(root,["Send","发送"]))
+        }
+    } catch { if fileSendStarted { throw ControlError(code:"native_send_outcome_unknown") };throw error }
+}
+
+do {
+    guard AXIsProcessTrusted() else { throw ControlError(code:"native_accessibility_required") }
+    guard let pid = request["pid"] as? Int32, let expected = request["app"] as? String,
+          let app = NSRunningApplication(processIdentifier:pid) else { throw ControlError(code:"native_process_identity_mismatch") }
+    // LaunchServices can report another copy's bundle URL when both share WeChat's bundle ID.
+    // Verify the actual process executable instead, resolving /tmp aliases on both sides.
+    var pathBuffer=[CChar](repeating:0,count:4096)
+    let pathLength=proc_pidpath(pid,&pathBuffer,UInt32(pathBuffer.count))
+    let actualPath=String(cString:pathBuffer)
+    let expectedPath=URL(fileURLWithPath:expected).appendingPathComponent("Contents/MacOS/WeChat").resolvingSymlinksInPath().path
+    guard pathLength>0, URL(fileURLWithPath:actualPath).resolvingSymlinksInPath().path == expectedPath else { throw ControlError(code:"native_process_identity_mismatch") }
+    let root = AXUIElementCreateApplication(pid)
+    let action = request["action"] as? String ?? "status"
+    if action != "status" && action != "attachment.status" {
+        _ = NSApplication.shared
+        if let window=attribute(root,kAXMainWindowAttribute) { AXUIElementPerformAction(window as! AXUIElement,kAXRaiseAction as CFString) }
+        app.activate(options:[.activateIgnoringOtherApps])
+        let deadline=Date().addingTimeInterval(3)
+        while NSWorkspace.shared.frontmostApplication?.processIdentifier != pid && Date()<deadline { RunLoop.current.run(until:Date().addingTimeInterval(0.1)) }
+        guard NSWorkspace.shared.frontmostApplication?.processIdentifier == pid else { throw ControlError(code:"native_app_not_frontmost") }
+    }
+    if let chatName = request["chatName"] as? String, !chatName.isEmpty {
+        guard state(root)["chatName"] as? String == chatName else { throw ControlError(code:"native_active_chat_mismatch") }
+    }
+    if action == "dictation.start" || action == "recording.start" {
+        guard let composer=elements(root).first(where:{string($0,kAXIdentifierAttribute)=="chat_input_field"}) else { throw ControlError(code:"native_control_not_found") }
+        try press(composer)
+        AXUIElementSetAttributeValue(composer,kAXFocusedAttribute as CFString,kCFBooleanTrue)
+    }
+    switch action {
+    case "status": break
+    case "file.send":
+        guard let path=request["filePath"] as? String,let name=request["fileName"] as? String,path.hasPrefix("/"),!name.isEmpty else { throw ControlError(code:"invalid_input") }
+        try sendFile(root,pid,path,name)
+    case "attachment.status":
+        guard let name=request["fileName"] as? String,!name.isEmpty else { throw ControlError(code:"invalid_input") }
+        for window in attribute(root,kAXWindowsAttribute) as? [AXUIElement] ?? [] {
+            let list=elements(window)
+            if list.contains(where:{label($0).contains(name)||string($0,kAXValueAttribute).contains(name)}) &&
+               list.contains(where:{ e in ["File cleared","File expired","文件已清理","文件已过期"].contains { label(e).contains($0)||string(e,kAXValueAttribute).contains($0) } }) {
+                throw ControlError(code:"native_attachment_unavailable")
+            }
+        }
+    case "attachment.download":
+        guard let name=request["fileName"] as? String,!name.isEmpty else { throw ControlError(code:"invalid_input") }
+        var target:AXUIElement?
+        for _ in 0..<20 {
+            guard state(root)["chatName"] as? String == request["chatName"] as? String else { throw ControlError(code:"native_active_chat_mismatch") }
+            let matches=elements(root).filter { e in
+                string(e,kAXIdentifierAttribute)=="chat_bubble_item_view" && elements(e).contains { child in
+                    [label(child),string(child,kAXValueAttribute)].contains { $0.components(separatedBy:"\n").contains { $0.trimmingCharacters(in:.whitespaces)==name } }
+                }
+            }
+            if matches.count>1 { throw ControlError(code:"native_attachment_ambiguous") }
+            if let match=matches.first {target=match;break}
+            try scrollHistoryUp(root,pid)
+        }
+        guard let target=target else { throw ControlError(code:"native_attachment_not_visible") }
+        try press(target)
+        // A file bubble can open WeChat's attachment window first. Activate
+        // only its Download control, scoped to the requested filename.
+        Thread.sleep(forTimeInterval:0.25)
+        for window in attribute(root,kAXWindowsAttribute) as? [AXUIElement] ?? [] {
+            let scoped=elements(window).contains { label($0).contains(name)||string($0,kAXValueAttribute).contains(name) }
+            let main=elements(window).contains { string($0,kAXIdentifierAttribute)=="chat_input_field" }
+            if scoped && !main,let download=try? find(window,["Download","下载"]) {try press(download);break}
+        }
+    case "recording.send":
+        // Only a voice recording window can provide this Send button.
+        let windows=attribute(root,kAXWindowsAttribute) as? [AXUIElement] ?? []
+        guard let window=windows.first(where:{string($0,kAXTitleAttribute).contains("Voice") || string($0,kAXTitleAttribute).contains("语音")}) else { throw ControlError(code:"native_control_not_found") }
+        try press(find(window,["Send","发送"]))
+    case "dictation.start":
+        let e=CGEvent(keyboardEventSource:nil,virtualKey:63,keyDown:true)!;e.type = .flagsChanged;e.flags = .maskSecondaryFn;e.post(tap:.cghidEventTap)
+    case "dictation.stop":
+        let e=CGEvent(keyboardEventSource:nil,virtualKey:63,keyDown:false)!;e.type = .flagsChanged;e.flags = [];e.post(tap:.cghidEventTap)
+    case "dictation.cancel":
+        try key(pid,53);let e=CGEvent(keyboardEventSource:nil,virtualKey:63,keyDown:false)!;e.type = .flagsChanged;e.flags = [];e.post(tap:.cghidEventTap)
+    case "recording.cancel":
+        try key(pid,53);let e=CGEvent(keyboardEventSource:nil,virtualKey:61,keyDown:false)!;e.type = .flagsChanged;e.flags = [];e.post(tap:.cghidEventTap)
+    case "recording.start":
+        let e=CGEvent(keyboardEventSource:nil,virtualKey:61,keyDown:true)!;e.type = .flagsChanged;e.flags = CGEventFlags(rawValue:CGEventFlags.maskAlternate.rawValue | 0x40);e.post(tap:.cghidEventTap)
+    case "recording.stop":
+        let e=CGEvent(keyboardEventSource:nil,virtualKey:61,keyDown:false)!;e.type = .flagsChanged;e.flags = [];e.post(tap:.cghidEventTap)
+    case "import.start": try press(find(root,["Import chat history from phone","从手机导入聊天记录"]))
+    case "import.cancel":
+        let windows=attribute(root,kAXWindowsAttribute) as? [AXUIElement] ?? []
+        guard let window=windows.first(where:{["Import Chat History","导入聊天记录"].contains(string($0,kAXTitleAttribute))}),let close=attribute(window,kAXCloseButtonAttribute) else { throw ControlError(code:"native_control_not_found") }
+        guard AXUIElementPerformAction(close as! AXUIElement,kAXPressAction as CFString) == .success else { throw ControlError(code:"native_control_action_failed") }
+    default: throw ControlError(code:"invalid_native_control")
+    }
+    // WeChat changes controls asynchronously; observe without synthesizing state.
+    if action != "status" && action != "attachment.status" { Thread.sleep(forTimeInterval:0.15) }
+    emit(state(root))
+} catch let error as ControlError { emit(["error":error.code,"possibleSend":fileSendStarted]) }
+catch { emit(["error":"native_control_failed"]) }

wechat_cli/assets/entitlements.plist

@@ -0,0 +1,38 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>com.apple.security.app-sandbox</key>
+	<true/>
+	<key>com.apple.security.application-groups</key>
+	<array>
+		<string>5A4RE8SF68.com.tencent.xinWeChat</string>
+	</array>
+	<key>com.apple.security.cs.allow-jit</key>
+	<true/>
+	<key>com.apple.security.cs.disable-library-validation</key>
+	<true/>
+	<key>com.apple.security.device.audio-input</key>
+	<true/>
+	<key>com.apple.security.device.camera</key>
+	<true/>
+	<key>com.apple.security.files.bookmarks.app-scope</key>
+	<true/>
+	<key>com.apple.security.files.downloads.read-write</key>
+	<true/>
+	<key>com.apple.security.files.user-selected.read-write</key>
+	<true/>
+	<key>com.apple.security.get-task-allow</key>
+	<true/>
+	<key>com.apple.security.network.client</key>
+	<true/>
+	<key>com.apple.security.network.server</key>
+	<true/>
+	<key>com.apple.security.personal-information.location</key>
+	<true/>
+	<key>com.apple.security.personal-information.photos-library</key>
+	<true/>
+	<key>com.apple.security.print</key>
+	<true/>
+</dict>
+</plist>

wechat_cli/assets/favicon.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64"><rect width="64" height="64" rx="14" fill="#163f34"/><path d="M14 16h36v27H30l-12 9v-9h-4z" fill="#fff"/><g fill="#163f34"><circle cx="23" cy="29" r="3"/><circle cx="32" cy="29" r="3"/><circle cx="41" cy="29" r="3"/></g></svg>

wechat_cli/assets/index.html

@@ -0,0 +1,10 @@
+<!doctype html>
+<html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
+<title>WeChat local</title><link rel="icon" href="/favicon.svg" type="image/svg+xml"><link rel="stylesheet" href="/style.css"><script src="/app.js" defer></script></head>
+<body><header><div><strong>WeChat local</strong><span>Python gateway</span></div><button id="refresh">Refresh chats</button><button id="connection">Connection</button></header>
+<p id="status" role="status" aria-live="polite">Connecting to your local session…</p>
+<main><aside aria-label="Conversations"><label for="search">Conversations</label><input id="search" type="search" placeholder="Search by name or ID"><nav id="chats"></nav></aside>
+<section id="conversation"><div class="conversation-title"><h1 id="title">Select a conversation</h1><label>History <select id="limit"><option>20</option><option selected>50</option><option>100</option></select></label><button id="history" disabled>Refresh history</button></div>
+<div id="messages" aria-live="polite"></div><form id="compose"><label for="text">Message</label><textarea id="text" maxlength="4096" rows="3" disabled placeholder="Write a message…"></textarea><button id="send" disabled>Send text</button></form>
+<form id="upload"><label for="file">Send file or voice</label><input type="file" id="file"><select id="file-kind"><option value="file">File</option><option value="wav">Voice (mono PCM WAV)</option><option value="silk">Voice (SILK)</option></select><button id="send-file" disabled>Send upload</button></form></section></main>
+<footer>Sign into the configured WeChat app. File sending requires its target chat to be open and Accessibility permission.</footer></body></html>

wechat_cli/assets/native-agent.js

@@ -0,0 +1,334 @@
+// Frida runtime script, not a Node module. Loaded only by the native bridge.
+// Read native results; message calls run inside a registered native task context.
+const nativeProfile = globalThis.WECHAT_NATIVE_PROFILE;
+const nativeState = { state: 'waiting_for_module', protocol: 'wechat-macos',
+  connected: false, installed: false, enumerationObserved: false, chats: [],
+  messageReadsObserved: 0, failure: null };
+let liveNativeBase = null;
+let liveEnumerationAddress = null;
+let liveManagerSlot = null;
+
+function managerSlotForEnumeration(enumeration) {
+  const callsite = enumeration.add(0x68);
+  if (!readable(callsite, 4)) return null;
+  const call = callsite.readU32();
+  if ((call & 0xfc000000) >>> 0 !== 0x94000000) return null;
+  let displacement = call & 0x3ffffff;
+  if (displacement & 0x2000000) displacement -= 0x4000000;
+  const helper = callsite.add(displacement * 4);
+  if (!readable(helper, 12)) return null;
+  const adrp = helper.readU32();
+  const ldr = helper.add(4).readU32();
+  if ((adrp & 0x9f00001f) >>> 0 !== 0x90000008 || (ldr & 0xffc003ff) >>> 0 !== 0xf9400100 || helper.add(8).readU32() !== 0xd65f03c0) return null;
+  let immediate = ((adrp >>> 5) & 0x7ffff) * 4 + ((adrp >>> 29) & 3);
+  if (immediate & 0x100000) immediate -= 0x200000;
+  const slot = helper.and(ptr('0xfffffffffffff000')).add(immediate * 4096).add(((ldr >>> 10) & 4095) * 8);
+  if (readable(slot, 8)) return slot;
+  // Mach region enumeration can omit specially mapped pages. Test only this
+  // metadata-derived pointer slot; NativePointer raises on unreadable memory.
+  try { slot.readPointer(); return slot; } catch (_) { return null; }
+}
+
+function readable(address, bytes) {
+  if (address.isNull() || !Number.isSafeInteger(bytes) || bytes < 0 || bytes > 1048576) return false;
+  // Guarded reads validate only a recovered field's bounds. Walking every Mach
+  // region for each string is extremely slow in the protected WeChat image.
+  try { address.readByteArray(bytes); return true; } catch (_) { return false; }
+}
+function hexBytes(address, count) {
+  return Array.from(new Uint8Array(address.readByteArray(count)), byte => byte.toString(16).padStart(2, '0')).join('');
+}
+function install(module) {
+  if (nativeState.installed || module.name !== 'wechat.dylib' || !module.path.includes('/Contents/Resources/') || module.size < 100000000) return;
+  try {
+    if (Process.arch !== nativeProfile.arch) throw Error('unsupported_architecture');
+    const enumeration = module.base.add(nativeProfile.enumeration.offset);
+    const managerSlot = managerSlotForEnumeration(enumeration);
+    if (!managerSlot) {
+      nativeState.state = 'waiting_for_live_image';
+      return;
+    }
+    for (const name of ['enumeration', 'initialMessages', 'pagedMessages']) {
+      const entry = nativeProfile[name];
+      const address = module.base.add(entry.offset);
+      const executable = Process.findRangeByAddress(address);
+      if (!executable || !executable.protection.includes('x')) throw Error('native_module_not_executable');
+      if (!readable(address, entry.signature.length / 2) || hexBytes(address, entry.signature.length / 2) !== entry.signature) throw Error('native_signature_mismatch');
+    }
+    nativeState.installed = true;
+    liveNativeBase = module.base;
+    liveEnumerationAddress = enumeration;
+    liveManagerSlot = managerSlot;
+    nativeState.state = 'native_ready';
+  } catch (error) {
+    nativeState.failure = error.message;
+    nativeState.state = 'error';
+  }
+}
+
+let nativeSupport;
+function supportFunctions() {
+  if(nativeSupport) return nativeSupport;
+  const module=Module.load(globalThis.WECHAT_NATIVE_SUPPORT);
+  const exports=new Map(module.enumerateExports().map(entry=>[entry.name,entry.address]));
+  const ownExport=name=>{const address=exports.get(name);if(!address)throw Error('native_support_export_missing');return address;};
+  nativeSupport={
+    selfId:new NativeFunction(ownExport('bridge_self_id'),'pointer',['pointer','pointer'],{exceptions:'steal'}),
+    importControl:new NativeFunction(ownExport('bridge_import_control'),'pointer',['pointer','pointer','pointer','pointer','uint'],{exceptions:'steal'}),
+    captureVoice:new NativeFunction(ownExport('bridge_capture_recorded_voice'),'pointer',['pointer','pointer'],{exceptions:'steal'}),
+    sendVoice:new NativeFunction(ownExport('bridge_send_voice'),'pointer',['pointer','pointer','pointer','pointer','pointer','pointer','pointer','uint','uint','bool'],{exceptions:'steal'}),
+    ocr:new NativeFunction(ownExport('bridge_extract_image_text'),'pointer',['pointer','pointer','pointer','pointer','pointer'],{exceptions:'steal'}),
+    transcribe:new NativeFunction(ownExport('bridge_start_voice_transcription'),'pointer',['pointer','pointer','pointer','pointer','pointer','pointer','pointer'],{exceptions:'steal'}),
+    transcript:new NativeFunction(ownExport('bridge_voice_transcription_result'),'pointer',['pointer','pointer','pointer','pointer'],{exceptions:'steal'}),
+    probeProcessor:new NativeFunction(ownExport('bridge_probe_text_processor_v2'),'pointer',['pointer','pointer','pointer','pointer','pointer'],{exceptions:'steal'}),
+    prepareText:new NativeFunction(ownExport('bridge_prepare_text_v2'),'pointer',['pointer','pointer','pointer','pointer','pointer','pointer','pointer'],{exceptions:'steal'}),
+    send:new NativeFunction(ownExport('bridge_send_text_v2'),'pointer',['pointer','pointer','pointer','pointer','pointer','pointer','pointer'],{exceptions:'steal'}),
+    stage:new NativeFunction(ownExport('bridge_last_stage'),'uint',[]),
+    hasTask:new NativeFunction(ownExport('bridge_has_task_context'),'bool',['pointer']),
+    chats:new NativeFunction(ownExport('bridge_read_chats_v2'),'pointer',['pointer','pointer','pointer','pointer','pointer'],{exceptions:'steal'}),
+    cachedAttachment:new NativeFunction(ownExport('bridge_cached_attachment'),'pointer',['pointer','uint64','pointer'],{exceptions:'steal'}),
+    cachedMedia:new NativeFunction(ownExport('bridge_cached_media'),'pointer',['pointer'],{exceptions:'steal'}),
+    messages:new NativeFunction(ownExport('bridge_read_messages'),'pointer',['pointer','pointer','pointer','pointer','pointer','pointer','uint','pointer'],{exceptions:'steal'})};
+  return nativeSupport;
+}
+function nativeEntry(name) {
+  if(!liveNativeBase) throw Error('native_module_missing');
+  const entry=nativeProfile[name];
+  if(!entry) throw Error('native_feature_unavailable');
+  const address=liveNativeBase.add(entry.offset);
+  if(!readable(address,entry.signature.length/2)||hexBytes(address,entry.signature.length/2)!==entry.signature) throw Error('native_signature_mismatch');
+  return address;
+}
+
+let migrationHooksInstalled=false;
+const migrationState={starts:0,listenerAttempts:0,listenerReady:false};
+function installMigrationHooks(){
+  if(migrationHooksInstalled)return;
+  Interceptor.attach(nativeEntry('migrationStart'),{onEnter(){migrationState.starts++;migrationState.listenerReady=false;}});
+  Interceptor.attach(nativeEntry('migrationRoamStart'),{onEnter(){migrationState.listenerAttempts++;},onLeave(result){migrationState.listenerReady=Boolean(result.toInt32()&255);}});
+  migrationHooksInstalled=true;
+}
+let microphoneHooksInstalled=false;
+const microphoneState={dictation:{starts:0,finishes:0,active:false},recording:{starts:0,active:false}};
+let controlledRecording=null;
+function installMicrophoneHooks(){
+  if(microphoneHooksInstalled)return;
+  nativeEntry('dictationStart');nativeEntry('dictationFinish');nativeEntry('recordingStart');nativeEntry('recordingSend');nativeEntry('recordingBackendStart');
+  Interceptor.attach(nativeEntry('dictationStart'),{onEnter(){microphoneState.dictation.starts++;microphoneState.dictation.active=true;}});
+  Interceptor.attach(nativeEntry('dictationFinish'),{onEnter(args){microphoneState.dictation.finishes++;microphoneState.dictation.active=false;microphoneState.dictation.finishReason=args[1].toInt32();}});
+  Interceptor.attach(nativeEntry('recordingStart'),{onEnter(){microphoneState.recording.starts++;microphoneState.recording.active=true;}});
+  Interceptor.attach(nativeEntry('recordingBackendStart'),{onEnter(){if(controlledRecording){microphoneState.recording.starts++;microphoneState.recording.active=true;}}});
+  const entry=nativeEntry('recordingSend'),original=new NativeFunction(entry,'void',['pointer','pointer']);
+  const replacement=new NativeCallback((context,audio)=>{
+    if(!controlledRecording){original(context,audio);return;}
+    // API-owned recording is intercepted before native SendVoice queues it.
+    // The caller must invoke the separate send endpoint to transmit it.
+    microphoneState.recording.active=false;
+    try{const value=decodeResult(supportFunctions().captureVoice(context,audio));
+      if(value.chatId!==controlledRecording.chatId)throw Error('native_recording_recipient_changed');
+      controlledRecording.result=value;controlledRecording.status='recorded';
+    }catch(error){controlledRecording.status='failed';controlledRecording.error=error.message;}
+  },'void',['pointer','pointer']);
+  Interceptor.replace(entry,replacement);microphoneHooksInstalled=true;
+}
+function accountContext() {
+  if(!nativeState.installed) rpc.exports.discoverLiveImage();
+  if(!liveManagerSlot) throw Error('native_module_missing');
+  const manager=liveManagerSlot.readPointer();
+  if(!readable(manager,0x78)) throw Error('native_manager_unavailable');
+  const vtable=manager.readPointer();
+  if(!readable(vtable.add(0x68),8)) throw Error('native_manager_unavailable');
+  return {manager,getter:vtable.add(0x68).readPointer(),available:!manager.add(0x68).readPointer().isNull()};
+}
+function decodeResult(address) {
+  const value=JSON.parse(address.readUtf8String());
+  if(value.error) throw Error(value.error);
+  return value;
+}
+function nameFunctions() {
+  const addresses=[nativeEntry('accountServices'),nativeEntry('contactService'),nativeEntry('contactDisplayName')];
+  const table=Memory.alloc(addresses.length*Process.pointerSize);
+  addresses.forEach((address,i)=>table.add(i*Process.pointerSize).writePointer(address));
+  return table;
+}
+function recentFunctions() {
+  const addresses=[nativeEntry('accountServices'),nativeEntry('messageService'),nativeEntry('initialMessages'),nativeEntry('sessionService'),liveNativeBase.add(nativeProfile.sessionServiceMarkerOffset),nativeEntry('copySessions'),nativeEntry('sessionDestructor'),nativeEntry('isMinimizedSession'),nativeEntry('isPinnedSession')];
+  const table=Memory.alloc(addresses.length*Process.pointerSize);
+  addresses.forEach((address,i)=>table.add(i*Process.pointerSize).writePointer(address));
+  return table;
+}
+function refreshConversations(withNames=false) {
+  const context=accountContext();
+  if(!context.available) {nativeState.chats=[];nativeState.connected=false;throw Error('native_account_not_ready');}
+  const value=decodeResult(supportFunctions().chats(nativeEntry('enumeration'),context.getter,context.manager,withNames?nameFunctions():ptr(0),withNames?recentFunctions():ptr(0)));
+  nativeState.chats=value.items;nativeState.enumerationObserved=true;nativeState.connected=true;nativeState.failure=null;
+  return value;
+}
+function nativeMessages(chatId,limit,mediaMessageId=null) {
+  if(mediaMessageId!==null&&!/^\d{1,20}$/.test(mediaMessageId))throw Error('native_invalid_media_id');
+  if(typeof chatId!=='string'||!chatId||chatId.length>1024||/[\x00-\x1f\x7f]/.test(chatId))throw Error('invalid_chat_id');
+  if(!Number.isInteger(limit)||limit<1||limit>100)throw Error('invalid_limit');
+  refreshConversations();
+  if(!nativeState.chats.some(chat=>chat.id===chatId))throw Error('native_chat_not_found');
+  const context=accountContext();
+  if(nativePendingRead) throw Error('native_bridge_busy');
+  const services=nativeEntry('accountServices'),service=nativeEntry('messageService'),initial=Memory.alloc(8*Process.pointerSize);
+  [nativeEntry('initialMessages'),nativeEntry('messageUiConversion'),nativeEntry('messageUiDestructor'),nativeEntry('accountServices'),nativeEntry('contactService'),nativeEntry('contactDisplayName'),nativeEntry('voiceAudioPath'),nativeEntry('voiceDataGetter')].forEach((address,i)=>initial.add(i*Process.pointerSize).writePointer(address));
+  const chat=Memory.allocUtf8String(chatId);const support=supportFunctions();
+  return inNativeTask(()=>{
+    const value=decodeResult(support.messages(context.getter,context.manager,services,service,initial,chat,limit,mediaMessageId===null?ptr(0):Memory.allocUtf8String(mediaMessageId)));
+    nativeState.historyVerified=nativeState.historyVerified||value.items.some(item=>item.content?.length>0);
+    for(const item of value.items){if([3,34,43,47,49,62].includes(item.type))for(const key of [item.id,item.serverId])if(/^\d{12,20}$/.test(key))observedMediaHashes.add(key);for(const match of item.content.matchAll(/(?:md5|voicemd5)=["']([a-f0-9]{32})["']/gi))observedMediaHashes.add(match[1].toLowerCase());for(const hash of Object.values(item.nativeMediaFields??{}))if(/^[a-zA-Z0-9_.-]{8,128}$/.test(hash)&&!hash.includes('..'))observedMediaHashes.add(hash);}
+    nativeState.messageReadsObserved++;
+    return value;
+  });
+}
+function nativeSendText(chatId,text,prepare=false) {
+  if(typeof chatId!=='string'||!chatId||chatId.length>1024||/[\x00-\x1f\x7f]/.test(chatId))throw Error('invalid_chat_id');
+  if(['@placeholder_foldgroup','brandsessionholder','brandservicesessionholder'].includes(chatId))throw Error('native_invalid_recipient');
+  if(typeof text!=='string'||!text.trim()||text.length>4096||text.includes('\0'))throw Error('invalid_text');
+  refreshConversations();
+  if(!nativeState.chats.some(chat=>chat.id===chatId))throw Error('native_chat_not_found');
+  const context=accountContext(),functions=Memory.alloc(4*Process.pointerSize);
+  ['makeNativeUuid','makeUiSendInfo','sendGroupMessages','sendResultDestructor'].forEach((name,i)=>functions.add(i*Process.pointerSize).writePointer(nativeEntry(name)));
+  const chat=Memory.allocUtf8String(chatId),content=Memory.allocUtf8String(text),services=nativeEntry('accountServices'),service=nativeEntry('messageService');
+  // Native UiSendInfo was verified with a server-acknowledged File Transfer test.
+  return inNativeTask(()=>decodeResult((prepare?supportFunctions().prepareText:supportFunctions().send)(context.getter,context.manager,services,service,functions,chat,content)));
+
+}
+function inNativeTask(work) {
+  if(nativePendingRead) throw Error('native_bridge_busy');
+  const guard=nativeEntry('taskContextGuard'),support=supportFunctions();
+  return new Promise((resolve,reject)=>{
+    let listener,timer,finished=false;
+    const finish=(error,value)=>{
+      if(finished)return;finished=true;clearTimeout(timer);nativePendingRead=false;
+      listener?.detach();
+      if(error)reject(error);else resolve(value);
+    };
+    nativePendingRead=true;
+    timer=setTimeout(()=>finish(Error('native_task_context_unavailable')),12000);
+    try {listener=Interceptor.attach(guard,{onEnter(){
+      if(finished||!nativePendingRead||nativeTaskReadActive)return;
+      if(!support.hasTask(liveNativeBase.add(nativeProfile.taskContextTlsOffset)))return;
+      nativeTaskReadActive=true;
+      try{finish(null,work());}
+      catch(error){lastNativeFault={address:error.address?.toString(),offset:error.address&&liveNativeBase?error.address.sub(liveNativeBase).toString():null};finish(error);}
+      finally{nativeTaskReadActive=false;}
+    }});}catch(error){finish(error);}
+  });
+}
+const observedMediaHashes=new Set();
+let nativePendingRead=false,nativeTaskReadActive=false;
+let lastNativeFault=null;
+const observer = Process.attachModuleObserver({ onAdded: install });
+rpc.exports = {
+  startupStatus() {
+    let applicationRunning = null;
+    try {
+      const app = Module.getGlobalExportByName('NSApp').readPointer();
+      if (!app.isNull()) {
+        const register = new NativeFunction(Module.getGlobalExportByName('sel_registerName'), 'pointer', ['pointer']);
+        const message = new NativeFunction(Module.getGlobalExportByName('objc_msgSend'), 'bool', ['pointer', 'pointer']);
+        applicationRunning = message(app, register(Memory.allocUtf8String('isRunning')));
+      }
+    } catch (_) {}
+    return { pid:Process.id, executable:Process.mainModule.path, applicationRunning, largeModules: Process.enumerateModules()
+      .filter(module => module.size > 50000000 && !module.path.startsWith('/System/') && !module.path.startsWith('/usr/lib/'))
+      .map(module => ({ name: module.name, path: module.path, size: module.size })) };
+  },
+  discoverLiveImage() {
+    if (nativeState.installed) return { installed: true, candidatesChecked: 0 };
+    let bytesChecked = 0;
+    let candidatesChecked = 0;
+    const ranges = Process.enumerateRanges({ protection: 'r-x', coalesce: true })
+      .filter(range => {
+        if (range.protection !== 'r-x' || range.size < 128 || range.size > 536870912) return false;
+        const owner = Process.findModuleByAddress(range.base);
+        return owner === null || (!owner.path.startsWith('/System/') && !owner.path.startsWith('/usr/lib/'));
+      })
+      .sort((a, b) => b.size - a.size);
+    for (const range of ranges.slice(0, 512)) {
+      if (bytesChecked + range.size > 805306368) break;
+      bytesChecked += range.size;
+      for (const hit of Memory.scanSync(range.base, range.size, nativeProfile.enumeration.scanPattern)) {
+        candidatesChecked++;
+        const base = hit.address.sub(nativeProfile.enumeration.offset);
+        if (!managerSlotForEnumeration(hit.address)) continue;
+        install({ name: 'wechat.dylib', path: '/Contents/Resources/live-native-image', size: range.size, base });
+        if (nativeState.installed) return { installed: true, candidatesChecked, bytesChecked };
+      }
+    }
+    return { installed: false, candidatesChecked, bytesChecked };
+  },
+  status() {
+    let accountAvailable = false;
+    try {accountAvailable=accountContext().available;nativeState.failure=null;} catch(error) {nativeState.failure=error.message;}
+    return { protocol: nativeState.protocol, state: nativeState.state, wechatVersion:nativeProfile.version, build:nativeProfile.build,
+      installationNoticeSuppression:{installed:Boolean(globalThis.WECHAT_INSTALL_NOTICE?.installed),suppressed:globalThis.WECHAT_INSTALL_NOTICE?.suppressed??0},
+      connected: accountAvailable, accountAvailable, installed: nativeState.installed,
+      enumerationObserved: nativeState.enumerationObserved,
+      chatCount: nativeState.chats.length, messageReadsObserved: nativeState.messageReadsObserved,
+      failure: nativeState.failure, lastNativeFault, lastNativeStage:nativeSupport?.stage(), messagesImplemented: true, historyVerified: Boolean(nativeState.historyVerified), sendsImplemented: true };
+  },
+  probeTextProcessor() {const context=accountContext();const addresses=[nativeEntry('accountServices'),nativeEntry('messageService'),nativeEntry('sendProcessor')];return inNativeTask(()=>{const value=decodeResult(supportFunctions().probeProcessor(context.getter,context.manager,...addresses));value.processorVtableOffset=ptr(value.processorVtable).sub(liveNativeBase).toString();delete value.processorVtable;return value;});},
+  voiceData(chatId,id){return nativeMessages(chatId,100,id);},
+  importControl(action){accountContext();installMigrationHooks();if(![0,1,2].includes(action))throw Error('invalid_input');const result=decodeResult(supportFunctions().importControl(nativeEntry('migrationWindow'),nativeEntry('migrationStopServices'),nativeEntry('migrationCancelTransfer'),nativeEntry('migrationBusyKind'),action));return {...result,...migrationState};},
+  migrationStatus(){return rpc.exports.importControl(0);},
+  selfId(){const context=accountContext();return decodeResult(supportFunctions().selfId(context.getter,context.manager));},
+  microphoneStatus(){accountContext();installMicrophoneHooks();return {dictation:{...microphoneState.dictation},recording:{...microphoneState.recording,status:controlledRecording?.status??'idle'}};},
+  armRecording(chatId){accountContext();installMicrophoneHooks();if(controlledRecording)throw Error('native_bridge_busy');refreshConversations();if(!nativeState.chats.some(chat=>chat.id===chatId))throw Error('native_chat_not_found');controlledRecording={chatId,status:'armed'};return {status:'armed'};},
+  recordingResult(){if(!controlledRecording)throw Error('native_recording_unavailable');return {status:controlledRecording.status,...(controlledRecording.result??{}),...(controlledRecording.error?{error:controlledRecording.error}:{})};},
+  discardRecording(){controlledRecording=null;microphoneState.recording.active=false;return {status:'discarded'};},
+  sendVoice(chatId,dataBase64,durationMs,prepare=false){
+    if(typeof chatId!=='string'||!chatId||chatId.length>1024||/[\x00-\x1f\x7f]/.test(chatId))throw Error('invalid_chat_id');
+    if(['@placeholder_foldgroup','brandsessionholder','brandservicesessionholder'].includes(chatId))throw Error('native_invalid_recipient');
+    refreshConversations();if(!nativeState.chats.some(chat=>chat.id===chatId))throw Error('native_chat_not_found');
+    if(typeof dataBase64!=='string'||dataBase64.length>1398104||dataBase64.length%4||!/^[A-Za-z0-9+/]+={0,2}$/.test(dataBase64)||!Number.isInteger(durationMs)||durationMs<1000||durationMs>60000)throw Error('invalid_voice');
+    const alphabet='ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/',values=[];let acc=0,bits=0;
+    for(const c of dataBase64){if(c==='=')break;acc=(acc<<6)|alphabet.indexOf(c);bits+=6;if(bits>=8){bits-=8;values.push((acc>>>bits)&255);}}
+    const bytes=new Uint8Array(values);if(bytes.length<10||bytes.length>1048576)throw Error('invalid_voice');
+    const buffer=Memory.alloc(bytes.length);buffer.writeByteArray(bytes);
+    const context=accountContext(),functions=Memory.alloc(4*Process.pointerSize);
+    ['makeNativeUuid','makeVoiceSendInfo','sendGroupMessages','sendResultDestructor'].forEach((name,i)=>functions.add(i*Process.pointerSize).writePointer(nativeEntry(name)));
+    return inNativeTask(()=>decodeResult(supportFunctions().sendVoice(context.getter,context.manager,nativeEntry('accountServices'),nativeEntry('messageService'),functions,Memory.allocUtf8String(chatId),buffer,bytes.length,durationMs,prepare?1:0)));
+  },
+  extractImageText(dataBase64){
+    if(typeof dataBase64!=='string'||dataBase64.length<4||dataBase64.length>11184812||dataBase64.length%4||!/^[A-Za-z0-9+/]+={0,2}$/.test(dataBase64))throw Error('native_invalid_ocr_image');
+    const context=accountContext(),functions=Memory.alloc(3*Process.pointerSize);
+    ['ocrService','ocrInitialize','ocrLocalRecognition'].forEach((name,i)=>functions.add(i*Process.pointerSize).writePointer(nativeEntry(name)));
+    const services=nativeEntry('accountServices'),image=Memory.allocUtf8String(dataBase64);
+    return inNativeTask(()=>decodeResult(supportFunctions().ocr(context.getter,context.manager,services,functions,image)));
+  },
+  voiceTranscriptionResult(chatId,id){
+    if(typeof chatId!=='string'||!chatId||chatId.length>1024||/[\x00-\x1f\x7f]/.test(chatId)||!/^\d{1,20}$/.test(id))throw Error('invalid_chat_id');
+    const context=accountContext();return decodeResult(supportFunctions().transcript(context.getter,context.manager,Memory.allocUtf8String(chatId),Memory.allocUtf8String(id)));
+  },
+  transcribeVoice(chatId,id){
+    if(typeof chatId!=='string'||!chatId||chatId.length>1024||/[\x00-\x1f\x7f]/.test(chatId)||!/^\d{1,20}$/.test(id))throw Error('invalid_chat_id');
+    refreshConversations();if(!nativeState.chats.some(chat=>chat.id===chatId))throw Error('native_chat_not_found');
+    const context=accountContext(),functions=Memory.alloc(7*Process.pointerSize);
+    ['initialMessages','messageUiConversion','messageUiDestructor','voiceFrontRegistry'].forEach((name,i)=>functions.add(i*Process.pointerSize).writePointer(nativeEntry(name)));
+    functions.add(4*Process.pointerSize).writePointer(liveNativeBase.add(nativeProfile.voiceFrontDescriptorOffset));
+    functions.add(5*Process.pointerSize).writePointer(nativeEntry('voiceTranscriptionStart'));
+    functions.add(6*Process.pointerSize).writePointer(nativeEntry('voiceTranscriptionAttach'));
+    const services=nativeEntry('accountServices'),service=nativeEntry('messageService'),chat=Memory.allocUtf8String(chatId),message=Memory.allocUtf8String(id);
+    return inNativeTask(()=>decodeResult(supportFunctions().transcribe(context.getter,context.manager,services,service,functions,chat,message)));
+  },
+  async attachmentData(chatId,id) {
+      const value=await nativeMessages(chatId,100),message=value.items.find(item=>item.id===id);
+      if(!message||message.type!==49||!/<appmsg[\s>]/.test(message.content)||!/<type>6<\/type>/.test(message.content))throw Error('invalid_media_type');
+      const name=message.nativeMediaFields?.['344'],match=message.content.match(/<totallen>(\d+)<\/totallen>/);
+      const size=match?Number(match[1]):0;if(!name||!Number.isSafeInteger(size)||size<1||size>128*1024*1024)throw Error('native_media_not_cached');
+      const context=accountContext(),support=supportFunctions(),self=decodeResult(support.selfId(context.getter,context.manager)).id;
+      return decodeResult(support.cachedAttachment(Memory.allocUtf8String(name),size,Memory.allocUtf8String(self)));
+  },
+  cachedMedia(hash) {accountContext();if(!observedMediaHashes.has(hash))throw Error('native_invalid_media_id');return decodeResult(supportFunctions().cachedMedia(Memory.allocUtf8String(hash)));},
+  prepareText(chatId,text) {return nativeSendText(chatId,text,true);},
+  sendText(chatId,text) {return nativeSendText(chatId,text);},
+  listMessages(chatId,limit) {return nativeMessages(chatId,limit);},
+  listChats() {
+    if(!accountContext().available) throw Error('native_account_not_ready');
+    return inNativeTask(()=>refreshConversations(true));
+  },
+};

wechat_cli/assets/pdf-thumbnail.swift

@@ -0,0 +1,13 @@
+import AppKit
+import PDFKit
+import Foundation
+// Render the first page of an already retrieved PDF. No network or external app.
+guard CommandLine.arguments.count == 3,
+      let document=PDFDocument(url:URL(fileURLWithPath:CommandLine.arguments[1])),
+      let page=document.page(at:0) else { exit(1) }
+let bounds=page.bounds(for:.mediaBox)
+guard bounds.width>0,bounds.height>0,bounds.width.isFinite,bounds.height.isFinite else { exit(1) }
+let image=page.thumbnail(of:NSSize(width:320,height:420),for:.mediaBox)
+guard let tiff=image.tiffRepresentation,let bitmap=NSBitmapImageRep(data:tiff),
+      let png=bitmap.representation(using:.png,properties:[:]) else { exit(1) }
+do {try png.write(to:URL(fileURLWithPath:CommandLine.arguments[2]),options:.atomic)} catch {exit(1)}