magpie-marvis 0.1.4 → 0.1.5

package/CHANGELOG.md

@@ -3,9 +3,23 @@
 > 每个版本一节，**一条一行**，说用户能感知的变化。
 > 格式与规矩见 [UPDATING.md](./UPDATING.md)。
 
-## 0.1.4 — 2026-11-06
+## 0.1.5 — 2026-11-06
 
-**变更**
+**修复**
 
-- 图标换成 **Marvis 官方图标**（`resources/icons/icon.png`，128×128 透明 PNG）—— 插件列表与供应商卡片两处同时生效
+- **浏览器登录失效（`-109 RC_PARAMS_INVALID`）**：换 token 时往 query 里多加了一个 `guid`，
+  而 QQ 校验 `redirect_uri` 逐字一致 —— 多一个参数就判无效。现在只发 `login_type` + `code`
+- **改成直接读回调页**：授权后浏览器跳到 `marvis_oauth` 时，服务端响应体**就是** token JSON。
+  原来又发一次请求去换 = 用第二个 code，必然 `-109`。现在只读页面正文，不重发
+- **本机导入弹 OS 对话框**：method 少了 `opened: true` + `method: "auto"`，
+  magpie 会去打开 `about:blank`；补上后整个登录就是「点一下 → 读内存 → 成功」
+- **本机导入 PowerShell 语法错误**（`MissingEndParenthesisInMethodCall`）：C# 代码经
+  `-Command` 参数传递时引号被命令行解析吃掉。改成落临时 `.cs` + `.ps1`，走 `-File`
+
+**新增**
+
+- **隔离浏览器登录**：自己起一次性 Chromium（不复用日常浏览器 profile），
+  带 `--disable-blink-features=AutomationControlled` / `--exclude-switches=enable-automation` /
+  正常 Chrome UA + 补齐 `sec-ch-ua` client hints —— 去自动化痕迹、补指纹，防风控拦截
+- 浏览器探测结果进程内缓存（注册表查询同步阻塞，否则 `authorize()` 会慢到 1 秒以上）
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "magpie-marvis",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "magpie / OpenCode provider plugin for Tencent Marvis: its DeepSeek V4 Pro, Kimi K2.5, Claude Opus/Sonnet 4.6, GPT-5.4 and Hunyuan models through the Marvis model gateway — no API key to paste, sign in with QQ or WeChat.",
   "type": "module",
   "main": "./index.mjs",

package/src/hooks/methods.mjs

@@ -1,20 +1,28 @@
 // ② auth.methods —— 两条登录路
 //
-//   A. QQ / 微信 授权页（默认）：打开浏览器 → 用户在 QQ/微信里确认 →
-//      浏览器跳到 Marvis 的 redirect_uri 并显示一段 JSON → 用户把 `code=XXX` 粘回来。
-//   B. 从本机 Marvis 导入：装了客户端且登录过的人，一条命令读出来，不用走浏览器。
+//   A. QQ / 微信 授权（默认）：自己起一个**隔离浏览器**（一次性 profile、伪装正常 Chrome、
+//      去掉自动化痕迹），用户在窗口里授权，插件从 CDP 抓回调 URL 里的 `code`。
+//      → `{ url, opened: true, method: "auto", callback }`
+//        `opened: true` 让 magpie **不要**再开系统默认浏览器（否则弹两个窗口）。
+//
+//   B. 从本机 Marvis 导入：装了客户端且登录过的人，直接读进程内存里的登录态。
+//      → 同样 `opened: true` + `method: "auto"`，整个登录就是「点一下 → 读内存 → 成功」。
 //
 // ⚠ `authorize()` 必须**立刻**返回 —— 真正等用户的是 `callback()`。
 //   在这里 await 登录会和 magpie 双向死锁（HOOKS §四·陷阱1）。
 //
-// ⚠ 为什么不能像别的插件那样起本地 loopback：redirect_uri 是 QQ 互联里
-//   预注册死的，改不了（详见 src/marvis/login.mjs 顶部）。
+// ⚠ 为什么不能像别的插件那样起本地 loopback 收回调：redirect_uri 是 QQ 互联里
+//   预注册死的，改不了（详见 src/marvis/login.mjs 顶部）。所以只能「跳过去 → 读地址栏」。
 
-import { PROVIDER } from "../context.mjs"
-import { authorizeUrl, exchangeCode, extractCode, deviceGuid } from "../marvis/login.mjs"
+import { PROVIDER, LOGIN_TYPE } from "../context.mjs"
+import { authorizeUrl, parseCallback, deviceGuid } from "../marvis/login.mjs"
+import { openIsolatedLogin, findBrowser } from "../marvis/browser.mjs"
 import { resolveAccount } from "../account-name.mjs"
 import { importFromDesktop, desktopAvailable } from "../marvis/desktop.mjs"
 
+/** 回调地址判据：跳到 marvis_oauth 且带 code= */
+const CALLBACK = /marvis_client_login\/marvis_oauth\?[^#]*\bcode=/i
+
 /**
  * 登录成功时给宿主的字段。
  * `accountId` 是**名字**（卡片上显示），`uid` 是身份（HOOKS §八）。
@@ -45,26 +53,42 @@ export function authOf(acct) {
   }
 }
 
-/** 授权页登录（QQ / 微信） */
+/** 授权页登录（QQ / 微信），走隔离浏览器 */
 function oauthLogin(loginType, label, instructions) {
   return {
     type: "oauth",
     label,
     async authorize() {
       const guid = deviceGuid()
+      const browser = findBrowser()
+      const url = authorizeUrl(loginType, guid)
+
       return {
-        url: authorizeUrl(loginType, guid),
+        url,
+        // 我们自己开隔离浏览器，magpie 不要再开系统默认浏览器
+        opened: true,
+        method: "auto",
         instructions,
-        // 用户在浏览器里确认后，地址栏会变成
-        //   https://yybadaccess.3g.qq.com/marvis_client_login/marvis_oauth?login_type=QC&code=XXX
-        // 把整条 URL（或只 code）粘回来即可。
-        async callback(_url, input) {
-          const code = extractCode(input) ?? extractCode(_url)
-          if (!code) {
-            throw new Error("没识别出授权码。请把浏览器地址栏里的整条 URL 贴进来（形如 ...?login_type=QC&code=XXXX）")
+        async callback(_url, _input, signal) {
+          if (!browser) {
+            throw new Error(
+              "没有找到可用的 Chromium 内核浏览器（Chrome / Edge / 360 / QQ 浏览器都行）。" +
+                "请装一个，或改用「从本机 Marvis 导入」。",
+            )
           }
-          const acct = await exchangeCode(code, loginType, guid)
-          return authOf({ ...acct, guid })
+          // 起隔离浏览器 → 等它跳到回调地址
+          // ⚠ 回调页**本身就是换 token 的响应**（服务端直接吐 JSON），
+          //   所以这里读页面正文，**不要再发一次请求** —— 再发就是第二个 code，必然 -109。
+          const { url: callbackUrl, body } = await openIsolatedLogin({
+            browser,
+            url,
+            match: CALLBACK,
+            timeoutMs: 5 * 60_000,
+            signal,
+          })
+
+          const acct = parseCallback(callbackUrl, body)
+          return authOf({ ...acct, guid, loginType: acct.loginType ?? LOGIN_TYPE[loginType] ?? "6" })
         },
       }
     },
@@ -76,16 +100,16 @@ export function methods() {
     oauthLogin(
       "QC",
       "QQ 登录",
-      "1) 浏览器会打开 QQ 授权页，用你的 QQ 登录并确认授权\n" +
-        "2) 授权后页面会显示一段 JSON（或跳到 marvis_client_login 地址）\n" +
-        "3) 把**地址栏里的整条 URL** 粘贴回来（含 code=…）",
+      "1) 会打开一个**独立的**浏览器窗口（不碰你日常浏览器）\n" +
+        "2) 用你的 QQ 登录并确认授权\n" +
+        "3) 授权完成后窗口会自己关掉，回到 magpie 即可",
     ),
     oauthLogin(
       "WX",
       "微信登录",
-      "1) 浏览器会打开微信扫码页，用微信扫码并确认\n" +
-        "2) 扫码后页面会显示一段 JSON（或跳到 marvis_client_login 地址）\n" +
-        "3) 把**地址栏里的整条 URL** 粘贴回来（含 code=…）",
+      "1) 会打开一个**独立的**浏览器窗口（不碰你日常浏览器）\n" +
+        "2) 用微信扫码并确认\n" +
+        "3) 授权完成后窗口会自己关掉，回到 magpie 即可",
     ),
     {
       type: "oauth",
@@ -93,10 +117,14 @@ export function methods() {
       async authorize() {
         const ok = await desktopAvailable()
         return {
-          url: ok ? "about:blank" : "about:blank",
+          // ⚠ 必须 opened: true + method: "auto"，否则 magpie 会去开这个 url
+          //   （之前给 about:blank 弹了一次「没有可打开此链接的应用」）
+          url: "",
+          opened: true,
+          method: "auto",
           instructions: ok
             ? "已检测到本机 Marvis 客户端，正在读取登录态…"
-            : "本机没找到 Marvis 客户端（需要安装并登录过）。请改用上面的 QQ / 微信登录。",
+            : "本机没找到运行中的 Marvis 客户端。请先打开 Marvis 并登录，或改用 QQ / 微信 登录。",
           async callback() {
             const acct = await importFromDesktop()
             return authOf(acct)
@@ -107,4 +135,4 @@ export function methods() {
   ]
 }
 
-export { PROVIDER }
+export { PROVIDER, CALLBACK }

package/src/marvis/browser.mjs

@@ -0,0 +1,347 @@
+// 隔离浏览器登录 —— 自己起一个一次性 Chromium，用户在里面登录，从 CDP 抓回调 URL
+//
+// 为什么不用系统默认浏览器：QQ / 微信 的授权页对「刚打开的、没有历史的」窗口更宽容。
+// 更重要的是**隔离**：一次性 user-data-dir，不碰用户日常浏览器的 Cookie / 扩展 / 同步，
+// 登录态只在本次窗口里，关掉即销毁。
+//
+// ⚠ 伪装浏览器身份（防风控拦截）：
+//   · `--disable-blink-features=AutomationControlled` —— 去掉 `navigator.webdriver`
+//   · 不传 `--enable-automation` / `--headless` —— 有头窗口，且不带自动化提示条
+//   · `Network.setUserAgentOverride` 把 UA 换成正常 Chrome，并补齐
+//     `Accept-Language` / `sec-ch-ua` —— 只改 UA 不改 client hints 会被指纹比对出来
+//   · 一次性 profile，每次都是「全新机器」，不会因为历史 Cookie 被判定异常
+//
+// 设计取舍来自 WPS 灵犀 0.4.11 的实测实现（MIT；见 NOTICE.md）：
+//   · 任意 Chromium 内核浏览器都行（Chrome / Edge / 360 / QQ / Brave…），不止 Chrome；
+//     国产浏览器在 Windows 上很常见，漏了它们这条登录路对用户就不存在。
+//   · Windows 的候选顺序：Chrome → 国产 Chromium → Edge 最后（Edge 策略最多、最容易被组织禁用）。
+//   · 退出码不可靠：浏览器可能把调试参数吞掉，所以以「CDP 端口能不能连上」为准。
+//
+// ⚠ 只读页面 URL，不读 Cookie、不注入脚本；窗口关闭后临时 profile 会被删掉。
+// ⚠ 本模块不依赖任何第三方包；Node 22+ 的全局 WebSocket 足够。
+
+import { spawn } from "node:child_process"
+import { existsSync, mkdtempSync, rmSync } from "node:fs"
+import { tmpdir } from "node:os"
+import { join } from "node:path"
+import { createServer } from "node:net"
+import { execFileSync } from "node:child_process"
+
+const WIN_EXES = [
+  "chrome.exe",
+  "360ChromeX.exe",
+  "360chrome.exe",
+  "360se.exe",
+  "QQBrowser.exe",
+  "Brave.exe",
+  "vivaldi.exe",
+  "opera.exe",
+  "SogouExplorer.exe",
+  "2345Explorer.exe",
+  "liebao.exe",
+  "Maxthon.exe",
+  "UCBrowser.exe",
+  "Quark.exe",
+  "msedge.exe",
+]
+
+/** 正常 Chrome 的 UA —— 不是 headless、不是 Electron、不带 Marvis 字样 */
+const CHROME_UA =
+  "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) " +
+  "Chrome/152.0.0.0 Safari/537.36"
+
+/** Windows 注册表 App Paths 查浏览器；查不到返回空串。 */
+export function registryAppPath(exe) {
+  if (process.platform !== "win32") return ""
+  for (const root of ["HKCU", "HKLM"]) {
+    for (const tail of [
+      `SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\App Paths\\${exe}`,
+      `SOFTWARE\\WOW6432Node\\Microsoft\\Windows\\CurrentVersion\\App Paths\\${exe}`,
+    ]) {
+      try {
+        const out = execFileSync("reg", ["query", `${root}\\${tail}`, "/ve"], {
+          encoding: "utf8",
+          timeout: 5000,
+          stdio: ["ignore", "pipe", "ignore"],
+        })
+        const line = out.split("\n").find((l) => /REG_SZ/i.test(l))
+        const path = line?.split("REG_SZ")[1]?.trim()
+        if (path && existsSync(path)) return path
+      } catch {
+        /* 没有这个键 */
+      }
+    }
+  }
+  return ""
+}
+
+/**
+ * 候选浏览器（按优先级）。不做存在性检查，方便测试与排序。
+ * @param {{platform?:string, env?:Record<string,string>, lookup?:(exe:string)=>string}} [o]
+ * @returns {{name:string, path:string}[]}
+ */
+export function browserCandidates({ platform = process.platform, env = process.env, lookup = registryAppPath } = {}) {
+  const h = env.HOME || env.USERPROFILE || ""
+  const local = env.LOCALAPPDATA || ""
+  const roaming = env.APPDATA || ""
+  const pf = env.PROGRAMFILES || ""
+  const pf86 = env["PROGRAMFILES(X86)"] || env["ProgramFiles(x86)"] || ""
+  const add = (list, name, path) => {
+    if (path) list.push({ name, path })
+  }
+
+  if (platform === "win32") {
+    const list = []
+    for (const exe of WIN_EXES) {
+      const fromRegistry = lookup(exe)
+      if (fromRegistry) add(list, exe.replace(/\.exe$/i, ""), fromRegistry)
+    }
+    add(list, "Chrome", join(pf, "Google", "Chrome", "Application", "chrome.exe"))
+    add(list, "Chrome", join(pf86, "Google", "Chrome", "Application", "chrome.exe"))
+    add(list, "Chrome", join(local, "Google", "Chrome", "Application", "chrome.exe"))
+    add(list, "Chromium", join(local, "Chromium", "Application", "chrome.exe"))
+    add(list, "Chromium", join(pf, "Chromium", "Application", "chrome.exe"))
+    add(list, "360极速浏览器X", join(local, "360ChromeX", "Chrome", "Application", "360ChromeX.exe"))
+    add(list, "360浏览器", join(local, "360Chrome", "Chrome", "Application", "360chrome.exe"))
+    add(list, "360安全浏览器", join(roaming, "secoresdk", "360se6", "Application", "360se.exe"))
+    add(list, "QQ浏览器", join(local, "Tencent", "QQBrowser", "Application", "QQBrowser.exe"))
+    add(list, "Brave", join(pf, "BraveSoftware", "Brave-Browser", "Application", "brave.exe"))
+    add(list, "Brave", join(local, "BraveSoftware", "Brave-Browser", "Application", "brave.exe"))
+    add(list, "Vivaldi", join(local, "Vivaldi", "Application", "vivaldi.exe"))
+    add(list, "Opera", join(local, "Programs", "Opera", "opera.exe"))
+    add(list, "Opera", join(roaming, "Opera Software", "Opera Stable", "opera.exe"))
+    add(list, "搜狗浏览器", join(local, "SogouExplorer", "SogouExplorer.exe"))
+    add(list, "2345浏览器", join(local, "2345Explorer", "2345Explorer.exe"))
+    add(list, "猎豹浏览器", join(local, "liebao", "liebao.exe"))
+    add(list, "Maxthon", join(roaming, "Maxthon3", "Bin", "Maxthon.exe"))
+    add(list, "UC浏览器", join(local, "UCBrowser", "Application", "UCBrowser.exe"))
+    add(list, "夸克浏览器", join(local, "Quark", "Quark.exe"))
+    add(list, "Edge", join(pf86, "Microsoft", "Edge", "Application", "msedge.exe"))
+    add(list, "Edge", join(pf, "Microsoft", "Edge", "Application", "msedge.exe"))
+    return dedupe(list)
+  }
+
+  if (platform === "darwin") {
+    return [
+      ["Chrome", "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"],
+      ["Chromium", "/Applications/Chromium.app/Contents/MacOS/Chromium"],
+      ["Brave", "/Applications/Brave Browser.app/Contents/MacOS/Brave Browser"],
+      ["Vivaldi", "/Applications/Vivaldi.app/Contents/MacOS/Vivaldi"],
+      ["Edge", "/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge"],
+    ].map(([name, path]) => ({ name, path }))
+  }
+
+  return [
+    ["Chrome", join(h, ".config/google-chrome/chrome")],
+    ["Chromium", join(h, ".config/chromium/chrome")],
+    ["Brave", join(h, ".config/BraveSoftware/Brave-Browser/brave")],
+    ["Vivaldi", join(h, ".config/vivaldi/vivaldi")],
+    ["Edge", join(h, ".config/microsoft-edge/msedge")],
+  ].map(([name, path]) => ({ name, path }))
+}
+
+function dedupe(list) {
+  const seen = new Set()
+  return list.filter((x) => {
+    const key = x.path.toLowerCase()
+    if (seen.has(key)) return false
+    seen.add(key)
+    return true
+  })
+}
+
+/** 缓存：注册表查询要跑十几次 `reg query`，不缓存会让 `authorize()` 慢到 1 秒以上 */
+let browserCache = null
+let browserCached = false
+
+/**
+ * 第一个真实存在的候选；没有返回 null。
+ *
+ * ⚠ 结果**进程内缓存**：`authorize()` 必须立刻返回（HOOKS 四·陷阱 1），
+ *   而注册表查询是同步阻塞的 —— 每次登录都重查十几遍会让 UI 卡住。
+ */
+export function findBrowser({ platform = process.platform, env = process.env, exists = existsSync, lookup = registryAppPath } = {}) {
+  if (browserCached) return browserCache
+  browserCache = browserCandidates({ platform, env, lookup }).find((b) => exists(b.path)) ?? null
+  browserCached = true
+  return browserCache
+}
+
+/** 测试用：清掉浏览器缓存 */
+export function resetBrowserCache() {
+  browserCache = null
+  browserCached = false
+}
+
+async function freePort() {
+  return new Promise((resolve, reject) => {
+    const srv = createServer()
+    srv.unref()
+    srv.on("error", reject)
+    srv.listen(0, "127.0.0.1", () => {
+      const port = srv.address().port
+      srv.close(() => resolve(port))
+    })
+  })
+}
+
+async function getJson(url, timeoutMs = 3000) {
+  const res = await fetch(url, { signal: AbortSignal.timeout(timeoutMs) })
+  if (!res.ok) throw new Error(`HTTP ${res.status}`)
+  return res.json()
+}
+
+/**
+ * 打开受控浏览器，等它跳到匹配 `match` 的地址，返回那个地址。
+ *
+ * @param {object} o
+ * @param {{name:string,path:string}} o.browser findBrowser() 的返回值
+ * @param {string} o.url 登录页
+ * @param {RegExp} o.match 回调地址的判据
+ * @param {number} [o.timeoutMs] 默认 5 分钟
+ * @param {AbortSignal} [o.signal]
+ * @returns {Promise<{url:string, body:string, browser:string}>} 回调页面的地址与正文
+ */
+export async function openIsolatedLogin({ browser, url, match, timeoutMs = 5 * 60_000, signal }) {
+  if (!browser?.path) throw new Error("没有找到可用的 Chromium 内核浏览器（Chrome / Edge / 360 / QQ 浏览器都行）")
+
+  const profile = mkdtempSync(join(tmpdir(), "magpie-marvis-login-"))
+  const port = await freePort()
+  const child = spawn(
+    browser.path,
+    [
+      `--remote-debugging-port=${port}`,
+      `--user-data-dir=${profile}`,
+      // 一次性全新 profile：没有历史 Cookie / 扩展 / 同步
+      "--no-first-run",
+      "--no-default-browser-check",
+      "--disable-extensions",
+      "--disable-background-networking",
+      "--disable-sync",
+      // 去掉自动化痕迹（这是防风控的关键，不是可选项）
+      "--disable-blink-features=AutomationControlled",
+      "--exclude-switches=enable-automation",
+      `--user-agent=${CHROME_UA}`,
+      "--lang=zh-CN",
+      url,
+    ],
+    { stdio: "ignore", windowsHide: false },
+  )
+
+  const cleanup = () => {
+    try {
+      child.kill()
+    } catch {
+      /* 已经退出 */
+    }
+    try {
+      rmSync(profile, { recursive: true, force: true })
+    } catch {
+      /* 临时目录删不掉不影响主流程 */
+    }
+  }
+
+  const deadline = Date.now() + timeoutMs
+  try {
+    let pageWs = ""
+    while (Date.now() < deadline) {
+      if (signal?.aborted) throw new Error("登录已取消")
+      try {
+        const pages = await getJson(`http://127.0.0.1:${port}/json/list`, 1000)
+        pageWs = pages.find((p) => p.type === "page" && p.webSocketDebuggerUrl)?.webSocketDebuggerUrl ?? ""
+        if (pageWs) break
+      } catch {
+        /* 浏览器还没起好 */
+      }
+      await new Promise((r) => setTimeout(r, 300))
+    }
+    if (!pageWs) {
+      throw new Error(
+        "受控浏览器没有打开调试端口（可能是浏览器吞掉了 --remote-debugging-port，或安全软件拦截）。" +
+          "请换一个 Chromium 内核浏览器，或改用「从本机 Marvis 导入」。",
+      )
+    }
+
+    const ws = new WebSocket(pageWs)
+    await new Promise((resolve, reject) => {
+      ws.addEventListener("open", resolve, { once: true })
+      ws.addEventListener("error", () => reject(new Error("CDP WebSocket 连不上")), { once: true })
+    })
+
+    /** 发一条 CDP 命令并等结果 */
+    const send = (id, method, params = {}) =>
+      new Promise((resolve, reject) => {
+        const onMessage = (event) => {
+          let msg
+          try {
+            msg = JSON.parse(String(event.data))
+          } catch {
+            return
+          }
+          if (msg.id !== id) return
+          ws.removeEventListener("message", onMessage)
+          if (msg.error) reject(new Error(msg.error.message || "CDP error"))
+          else resolve(msg.result)
+        }
+        ws.addEventListener("message", onMessage)
+        ws.send(JSON.stringify({ id, method, params }))
+      })
+
+    try {
+      // 补齐 client hints —— 只改 UA 不改 sec-ch-ua 会被指纹比对出来
+      await send(1, "Network.enable").catch(() => {})
+      await send(2, "Network.setUserAgentOverride", {
+        userAgent: CHROME_UA,
+        acceptLanguage: "zh-CN,zh;q=0.9",
+        platform: "Win32",
+      }).catch(() => {})
+
+      let nextId = 10
+      while (Date.now() < deadline) {
+        if (signal?.aborted) throw new Error("登录已取消")
+        let href = ""
+        try {
+          const r = await send(nextId++, "Runtime.evaluate", {
+            expression: "location.href",
+            returnByValue: true,
+          })
+          href = String(r?.result?.value ?? "")
+        } catch {
+          /* 页面正在跳转，下一轮再看 */
+        }
+        if (href && match.test(href)) {
+          // ⚠ 关键：回调页**本身就是换 token 的响应**（服务端直接吐 JSON）。
+          //   再发一次请求 = 用第二个 code，必然 -109。所以这里只读页面内容，不重发。
+          //   页面可能还在渲染，多读几次直到拿到非空正文。
+          let body = ""
+          for (let i = 0; i < 15; i++) {
+            try {
+              const r = await send(nextId++, "Runtime.evaluate", {
+                expression: "document.body ? document.body.innerText : ''",
+                returnByValue: true,
+              })
+              body = String(r?.result?.value ?? "")
+              if (body.trim()) break
+            } catch {
+              /* 页面还在导航 */
+            }
+            await new Promise((r) => setTimeout(r, 400))
+          }
+          return { url: href, body, browser: browser.name }
+        }
+        await new Promise((r) => setTimeout(r, 800))
+      }
+      throw new Error("登录超时：没有等到授权回调。请在打开的窗口里完成 QQ / 微信 授权。")
+    } finally {
+      try {
+        ws.close()
+      } catch {
+        /* 已关闭 */
+      }
+    }
+  } finally {
+    cleanup()
+  }
+}
+
+export const _internal = { WIN_EXES, CHROME_UA, freePort, dedupe, resetBrowserCache }

package/src/marvis/desktop.mjs

@@ -5,10 +5,17 @@
 // 密钥攻不出来。但客户端跑着的时候，明文就在进程内存里 —— 直接读。
 //
 // ⚠ 只读，不写、不注入、不 hook。用 `ReadProcessMemory` 扫可读区段。
-// ⚠ 只在 Windows 上有；其它平台返回「不可用」，让用户走浏览器登录。
+// ⚠ 只在 Windows 上有；其它平台抛「不可用」，让用户走浏览器登录。
 // ⚠ **不需要管理员权限**（同用户进程即可）；跨用户会失败并给出明确错误。
+//
+// ⚠⚠ 为什么把 C# 和 PS 都落成临时文件：`powershell -Command <长脚本>` 会被
+//   Windows 命令行参数解析吃掉引号（C# 里的 `""` 空字符串必然炸成
+//   `MissingEndParenthesisInMethodCall`）。`-File` 走文件，不经过参数解析。
 
 import { execFileSync } from "node:child_process"
+import { mkdtempSync, writeFileSync, rmSync } from "node:fs"
+import { tmpdir } from "node:os"
+import { join } from "node:path"
 import { deviceGuid } from "./login.mjs"
 
 /** 探查本机是否有 Marvis 客户端在跑 */
@@ -25,12 +32,92 @@ function findPid(name = "MarvisAgent.exe") {
   const out = execFileSync("tasklist", ["/FI", `IMAGENAME eq ${name}`, "/FO", "CSV", "/NH"], {
     encoding: "utf8",
     windowsHide: true,
-    timeout: 5000,
+    timeout: 10_000,
   })
   const m = /"([^"]+)","(\d+)"/.exec(out)
   return m ? Number(m[2]) : 0
 }
 
+/** C# 扫描器 —— 写成独立 .cs，由 Add-Type -Path 编译 */
+const CS = String.raw`
+using System;
+using System.Text;
+using System.Runtime.InteropServices;
+
+public class MarvisMemScan
+{
+    [DllImport("kernel32.dll", SetLastError = true)]
+    public static extern IntPtr OpenProcess(int access, bool inherit, int pid);
+
+    [DllImport("kernel32.dll", SetLastError = true)]
+    public static extern bool ReadProcessMemory(IntPtr h, IntPtr addr, byte[] buf, int size, out IntPtr read);
+
+    [DllImport("kernel32.dll", SetLastError = true)]
+    public static extern int VirtualQueryEx(IntPtr h, IntPtr addr, ref MBI mbi, int size);
+
+    [DllImport("kernel32.dll", SetLastError = true)]
+    public static extern bool CloseHandle(IntPtr h);
+
+    [StructLayout(LayoutKind.Sequential)]
+    public struct MBI
+    {
+        public IntPtr BaseAddress;
+        public IntPtr AllocationBase;
+        public uint AllocationProtect;
+        public uint Pad1;
+        public IntPtr RegionSize;
+        public uint State;
+        public uint Protect;
+        public uint Type;
+        public uint Pad2;
+    }
+
+    private static bool Readable(uint p)
+    {
+        switch (p)
+        {
+            case 0x02: case 0x04: case 0x06: case 0x08:
+            case 0x20: case 0x40: case 0x80:
+            case 0x42: case 0x44: case 0x60: case 0x62: case 0x64:
+                return true;
+            default:
+                return false;
+        }
+    }
+
+    /// 扫一遍，把命中 needle 的区段整段拼起来返回（供上层用正则抠字段）
+    public static string Scan(int pid, string needle)
+    {
+        IntPtr h = OpenProcess(0x0410, false, pid);
+        if (h == IntPtr.Zero) return string.Empty;
+
+        StringBuilder sb = new StringBuilder();
+        long addr = 0;
+        MBI mbi = new MBI();
+        const long MAX_REGION = 64L * 1024 * 1024;
+
+        while (VirtualQueryEx(h, new IntPtr(addr), ref mbi, Marshal.SizeOf(typeof(MBI))) != 0)
+        {
+            long size = (long)mbi.RegionSize;
+            if (mbi.State == 0x1000 && size > 0 && size < MAX_REGION && Readable(mbi.Protect))
+            {
+                byte[] buf = new byte[size];
+                IntPtr read;
+                if (ReadProcessMemory(h, new IntPtr(addr), buf, (int)size, out read))
+                {
+                    string s = Encoding.UTF8.GetString(buf, 0, (int)read);
+                    if (s.IndexOf(needle, StringComparison.Ordinal) >= 0) sb.Append(s);
+                }
+            }
+            addr += size;
+            if (addr > 0x7FFFFFFFFFFFL) break;
+        }
+        CloseHandle(h);
+        return sb.ToString();
+    }
+}
+`
+
 /**
  * 从进程内存里读出登录态。
  *
@@ -39,7 +126,7 @@ function findPid(name = "MarvisAgent.exe") {
  *   2. 结构化对象 `{"openid":"...","accessToken":"...","refreshToken":"..."}`
  * 优先用 1（字段最全，带 logintype 和到期时刻）。
  *
- * @returns {Promise<{ openid: string, accessToken: string, refreshToken?: string, loginType: string, guid: string, nickname?: string, expiresAt?: number }>}
+ * @returns {Promise<{ openid: string, accessToken: string, refreshToken?: string, loginType: string, guid: string, expiresAt?: number }>}
  */
 export async function importFromDesktop() {
   if (process.platform !== "win32") {
@@ -49,103 +136,73 @@ export async function importFromDesktop() {
   if (!pid) {
     throw new Error("没找到运行中的 MarvisAgent.exe。请先打开 Marvis 客户端并登录，或改用 QQ / 微信 登录。")
   }
-  const text = await readProcessStrings(pid)
-  const acct = parseLoginState(text)
-  if (!acct) {
-    throw new Error(
-      "读到了 MarvisAgent 进程，但里面没有登录态。请在 Marvis 客户端里登录一次再试，或改用 QQ / 微信 登录。",
+
+  const dir = mkdtempSync(join(tmpdir(), "magpie-marvis-scan-"))
+  try {
+    writeFileSync(join(dir, "Scan.cs"), CS, "utf8")
+    // 只输出命中区段的 base64，避免编码/长度问题
+    writeFileSync(
+      join(dir, "run.ps1"),
+      [
+        "$ErrorActionPreference = 'Stop'",
+        "Add-Type -Path (Join-Path $PSScriptRoot 'Scan.cs') -Language CSharp",
+        `$text = [MarvisMemScan]::Scan(${pid}, 'accesstoken=')`,
+        "if ([string]::IsNullOrEmpty($text)) { $text = [MarvisMemScan]::Scan(" + pid + ", 'accessToken') }",
+        "$b = [System.Text.Encoding]::UTF8.GetBytes($text)",
+        "[Console]::Out.Write([Convert]::ToBase64String($b))",
+        "",
+      ].join("\r\n"),
+      "utf8",
     )
-  }
-  return acct
-}
 
-/**
- * 扫进程可读内存，返回拼起来的文本。
- * 只取长度 < 64MiB 的已提交可读区段，避免爆内存。
- * @param {number} pid
- * @returns {Promise<string>}
- */
-async function readProcessStrings(pid) {
-  // 用 PowerShell 做（不引第三方依赖，也不需要编译）。C# 片段走 Add-Type。
-  const script = `
-$sig = @"
-using System;
-using System.Text;
-using System.Runtime.InteropServices;
-public class MS {
-  [DllImport("kernel32.dll")] public static extern IntPtr OpenProcess(int a, bool b, int c);
-  [DllImport("kernel32.dll")] public static extern bool ReadProcessMemory(IntPtr h, IntPtr a, byte[] b, int s, out IntPtr r);
-  [DllImport("kernel32.dll")] public static extern int VirtualQueryEx(IntPtr h, IntPtr a, ref MBI m, int s);
-  [DllImport("kernel32.dll")] public static extern bool CloseHandle(IntPtr h);
-  [StructLayout(LayoutKind.Sequential)]
-  public struct MBI {
-    public IntPtr BaseAddress, AllocationBase;
-    public uint AllocationProtect, __a1;
-    public IntPtr RegionSize;
-    public uint State, Protect, Type, __a2;
-  }
-  public static string Scan(int pid, string needle) {
-    var h = OpenProcess(0x0410, false, pid);
-    if (h == IntPtr.Zero) return "";
-    var sb = new StringBuilder();
-    long addr = 0; var mbi = new MBI();
-    var nb = Encoding.UTF8.GetBytes(needle);
-    while (VirtualQueryEx(h, (IntPtr)addr, ref mbi, Marshal.SizeOf(mbi)) != 0) {
-      long size = (long)mbi.RegionSize;
-      if (mbi.State == 0x1000 && size > 0 && size < 67108864 &&
-          (mbi.Protect == 0x02 || mbi.Protect == 0x04 || mbi.Protect == 0x06 ||
-           mbi.Protect == 0x08 || mbi.Protect == 0x20 || mbi.Protect == 0x40 ||
-           mbi.Protect == 0x80 || mbi.Protect == 0x42 || mbi.Protect == 0x44 ||
-           mbi.Protect == 0x60 || mbi.Protect == 0x62 || mbi.Protect == 0x64)) {
-        var buf = new byte[size];
-        IntPtr read;
-        if (ReadProcessMemory(h, (IntPtr)addr, buf, (int)size, out read)) {
-          var s = Encoding.UTF8.GetString(buf, 0, (int)read);
-          if (s.Contains(needle)) sb.Append(s);
-        }
-      }
-      addr += size;
-      if (addr > 0x7fffffffffffL) break;
+    const b64 = execFileSync(
+      "powershell",
+      ["-NoProfile", "-NonInteractive", "-ExecutionPolicy", "Bypass", "-File", join(dir, "run.ps1")],
+      { encoding: "utf8", windowsHide: true, timeout: 180_000, maxBuffer: 128 * 1024 * 1024 },
+    ).trim()
+
+    const text = b64 ? Buffer.from(b64, "base64").toString("utf8") : ""
+    const acct = parseLoginState(text)
+    if (!acct) {
+      throw new Error(
+        "读到了 MarvisAgent 进程，但里面没有登录态。请在 Marvis 客户端里登录一次再试，或改用 QQ / 微信 登录。",
+      )
+    }
+    return acct
+  } finally {
+    try {
+      rmSync(dir, { recursive: true, force: true })
+    } catch {
+      /* 临时目录删不掉不影响主流程 */
     }
-    CloseHandle(h);
-    return sb.ToString();
   }
 }
-"@
-Add-Type -TypeDefinition $sig -Language CSharp
-[MS]::Scan(${pid}, "accesstoken=")
-[MS]::Scan(${pid}, "\\"accessToken\\":")
-`;
-  const out = execFileSync("powershell", ["-NoProfile", "-NonInteractive", "-Command", script], {
-    encoding: "utf8",
-    windowsHide: true,
-    timeout: 180_000,
-    maxBuffer: 64 * 1024 * 1024,
-  })
-  return out
-}
 
 /**
  * 从内存文本里抠登录态。
  * @param {string} text
  */
 export function parseLoginState(text) {
+  if (!text) return null
+  const guid = deviceGuid()
+
   // 形态 1：cookie 串
-  const cookie = /openid=([0-9A-Fa-f]{16,64});\s*accesstoken=([^;\s]+);\s*(?:refreshtoken=([^;\s]+);\s*)?logintype=([A-Za-z]+)/
+  const cookie = /openid=([0-9A-Fa-f]{16,64});\s*accesstoken=([^;\s]+);\s*(?:refreshtoken=([^;\s]+);\s*)?(?:logintype=([A-Za-z]+))?/
   let m = cookie.exec(text)
   if (m) {
-    const expire = /access_token_expire_time=(\d+)/.exec(text)
+    const expire = /access_token_expire_time=(\d{10})/.exec(text)
     return {
       openid: m[1],
       accessToken: m[2],
       refreshToken: m[3] || undefined,
-      loginType: /^WX$/i.test(m[4]) ? "5" : "6",
-      guid: deviceGuid(),
+      loginType: /^WX$/i.test(m[4] ?? "") ? "5" : "6",
+      guid,
       expiresAt: expire ? Number(expire[1]) * 1000 : Date.now() + 30 * 24 * 3600_000,
     }
   }
-  // 形态 2：JSON 对象
-  const json = /"openid"\s*:\s*"([0-9A-Fa-f]{16,64})"[^}]{0,400}?"accessToken"\s*:\s*"([^"]+)"/
+
+  // 形态 2：`"openid":"...","accessToken":"..."` 结构化串
+  const json = /"openid"\s*:\s*"([0-9A-Fa-f]{16,64})"[\s\S]{0,600}?"accessToken"\s*:\s*"([^"]+)"/
   m = json.exec(text)
   if (m) {
     const rt = /"refreshToken"\s*:\s*"([^"]+)"/.exec(text)
@@ -154,7 +211,7 @@ export function parseLoginState(text) {
       accessToken: m[2],
       refreshToken: rt?.[1],
       loginType: "6",
-      guid: deviceGuid(),
+      guid,
       expiresAt: Date.now() + 30 * 24 * 3600_000,
     }
   }

package/src/marvis/login.mjs

@@ -1,180 +1,267 @@
-// Marvis 登录 —— QQ / 微信 OAuth 授权码换 token
-//
-// 上游只给两种登录：QQ（QC）和微信（WX）。都是标准 OAuth2 授权码。
-//
-// ⚠ `redirect_uri` **改不了** —— 它固定在 Marvis 服务端
-//   （`https://yybadaccess.3g.qq.com/marvis_client_login/marvis_oauth?login_type=QC`），
-//   是 QQ 互联里预注册过的。所以不能像别的插件那样起本地 loopback 收回调。
-//
-// 实际流程：插件打开授权页 → 用户在 QQ/微信里确认 → 浏览器跳到那个 redirect_uri，
-//   页面直接吐一段 JSON → 用户把地址栏里的 `code=XXX`（或整段 JSON）粘回来。
-//   `ask()` 支持这种两步登录（HOOKS 四·陷阱 5：`prompts` 数组串不起来，必须用 `ask()`）。
-
-import { BASE, QQ_APP_ID, WX_APP_ID, BUSINESS_ID, LOGIN_TYPE } from "../context.mjs"
-import { ualSignature } from "./protocol.mjs"
-import { createHash } from "node:crypto"
-import { createRequire } from "node:module"
-
-const require = createRequire(import.meta.url)
-
-/** redirect_uri —— 与 Marvis 客户端逐字一致 */
-const REDIRECT = `${BASE}/marvis_client_login/marvis_oauth`
+// Marvis 登录 —— QQ / 微信 OAuth 授权码换 token
+//
+// 上游只给两种登录：QQ（QC）和微信（WX）。都是标准 OAuth2 授权码。
+//
+// ⚠ `redirect_uri` **改不了** —— 它固定在 Marvis 服务端
+//   （`https://yybadaccess.3g.qq.com/marvis_client_login/marvis_oauth?login_type=QC`），
+//   是 QQ 互联里预注册过的。所以不能像别的插件那样起本地 loopback 收回调。
+//
+// 实际流程：插件打开授权页 → 用户在 QQ/微信里确认 → 浏览器跳到那个 redirect_uri，
+//   页面直接吐一段 JSON → 用户把地址栏里的 `code=XXX`（或整段 JSON）粘回来。
+//   `ask()` 支持这种两步登录（HOOKS 四·陷阱 5：`prompts` 数组串不起来，必须用 `ask()`）。
+
+import { BASE, QQ_APP_ID, WX_APP_ID, BUSINESS_ID, LOGIN_TYPE } from "../context.mjs"
+import { ualSignature } from "./protocol.mjs"
+import { createHash } from "node:crypto"
+import { createRequire } from "node:module"
+
+const require = createRequire(import.meta.url)
+
+/** redirect_uri —— 与 Marvis 客户端逐字一致 */
+const REDIRECT = `${BASE}/marvis_client_login/marvis_oauth`
+
+/**
+ * 拼授权页地址。
+ * @param {"QC" | "WX"} loginType
+ * @param {string} guid 设备 guid（微信的 state 就是它）
+ * @returns {string}
+ */
+export function authorizeUrl(loginType, guid) {
+  if (loginType === "WX") {
+    const p = new URLSearchParams({
+      appid: WX_APP_ID,
+      redirect_uri: REDIRECT,
+      response_type: "code",
+      scope: "snsapi_login",
+      state: guid,
+    })
+    return `https://open.weixin.qq.com/connect/qrconnect?${p}`
+  }
+  // QQ：which=Login&display=pc 是 Marvis 客户端用的参数，别省
+  const p = new URLSearchParams({
+    which: "Login",
+    display: "pc",
+    response_type: "code",
+    client_id: QQ_APP_ID,
+    redirect_uri: REDIRECT,
+    state: String(Math.floor(Math.random() * 1e9)),
+  })
+  return `https://graph.qq.com/oauth2.0/authorize?${p}`
+}
+
+/**
+ * 从用户粘贴的内容里抠出授权码。
+ * 支持：纯 code / 完整回调 URL / 整段 JSON 里的 code 字段。
+ * @param {string} input
+ * @returns {string | null}
+ */
+export function extractCode(input) {
+  const s = String(input ?? "").trim()
+  if (!s) return null
+  // 完整 URL
+  try {
+    const u = new URL(s)
+    const c = u.searchParams.get("code")
+    if (c) return c
+  } catch {
+    /* 不是 URL，往下走 */
+  }
+  // JSON
+  if (s.startsWith("{")) {
+    try {
+      const j = JSON.parse(s)
+      const c = j?.code ?? j?.user_info?.code ?? j?.data?.code
+      // 注意：失败响应的 code 是数字错误码，成功时才是字符串
+      if (typeof c === "string" && c.length > 4) return c
+    } catch {
+      /* 不是 JSON */
+    }
+  }
+  // 只有 code=xxx
+  const m = /(?:^|[?&])code=([^&\s]+)/.exec(s)
+  if (m) return decodeURIComponent(m[1])
+  // 裸 code：Marvis 的 code 是长串字母数字
+  if (/^[A-Za-z0-9_-]{8,}$/.test(s)) return s
+  return null
+}
+
+/**
+ * 用授权码换 token。
+ *
+ * 这个端点**自己带签名**（`md5(query+timestamp+accessKey+nonce)`），
+ * 不需要登录态 —— 它就是在发登录态。
+ *
+ * @param {string} code
+ * @param {"QC" | "WX"} loginType
+ * @param {string} guid 只用于 `Ual-Access-Guid` 请求头
+ * @param {string} [state] QQ 回调带回来的 state（原样回传）
+ * @returns {Promise<{ openid: string, accessToken: string, refreshToken?: string, nickname?: string, avatar?: string, loginType: string, expiresAt?: number }>}
+ */
+export async function exchangeCode(code, loginType, guid, state) {
+  // ⚠ query 必须**逐字**等于 QQ 回调时的 redirect_uri 查询串 ——
+  //   QQ 在换 token 时校验 `redirect_uri` 一致性，多一个参数（比如 guid）就 `-109 RC_PARAMS_INVALID`。
+  //   guid 只在 authorize 的 state 里传递，不进这里。
+  const params = { login_type: loginType, code }
+  if (state) params.state = String(state)
+  const query = new URLSearchParams(params).toString()
+  const timestamp = String(Date.now())
+  const nonce = String(1000 + Math.floor(Math.random() * 9000))
+  const url = `${REDIRECT}?${query}`
+
+  const res = await fetch(url, {
+    method: "GET",
+    headers: {
+      Accept: "application/json",
+      "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Marvis/1.60.3300.408 Chrome/152.0.7977.130 Electron/44.7.0 Safari/537.36",
+      "Ual-Access-Businessid": BUSINESS_ID,
+      "Ual-Access-Timestamp": timestamp,
+      "Ual-Access-Nonce": nonce,
+      "Ual-Access-Signature": ualSignature(query, timestamp, nonce),
+      "Ual-Access-Guid": guid,
+      "Ual-Access-Login-Type": LOGIN_TYPE[loginType] ?? "6",
+    },
+  })
+
+  const text = await res.text()
+  /** @type {any} */
+  let body
+  try {
+    body = JSON.parse(text)
+  } catch {
+    throw new Error(`登录接口返回的不是 JSON（${res.status}）：${text.slice(0, 200)}`)
+  }
+
+  const info = body?.user_info ?? body?.data ?? null
+  const accessToken = info?.access_token ?? info?.accessToken ?? body?.access_token
+  const openid = info?.openid ?? info?.openId ?? info?.open_id
+
+  if (!accessToken || !openid) {
+    const errCode = body?.code ?? res.status
+    const hint =
+      errCode === -109
+        ? "（RC_PARAMS_INVALID：授权码无效或已被使用过。每次登录都会拿到一个新 code，一个 code 只能换一次 token，请重新走一遍登录）"
+        : ""
+    throw new Error(`登录失败（code=${errCode}）：${body?.msg ?? "未返回 access_token / openid"}${hint}`)
+  }
+
+  const expire = Number(info?.access_token_expire_time ?? info?.expires_in ?? 0)
+  return {
+    openid: String(openid),
+    accessToken: String(accessToken),
+    refreshToken: info?.refresh_token ? String(info.refresh_token) : undefined,
+    nickname: info?.nick_name ? decodeURIComponent(info.nick_name) : undefined,
+    avatar: info?.head_img_url ?? undefined,
+    loginType: LOGIN_TYPE[loginType] ?? "6",
+    // 上游给的是**到期时刻**（秒）；没给就按 30 天算
+    expiresAt: expire > 1e9 ? expire * 1000 : Date.now() + 30 * 24 * 3600_000,
+  }
+}
+
+/**
+ * 设备 guid。
+ *
+ * 来源：注册表 `HKCU\SOFTWARE\Tencent\Marvis\Env\svid`。
+ * 服务端按 `(openid, guid, token)` 三元组校验，但 guid 是**纯客户端自报**的 ——
+ * 换 guid 会 `-101 redis: nil`，所以它必须稳定，跟着 token 一起存。
+ *
+ * 没有注册表（没装 Marvis）时，用「本机机器 id 派生」的稳定值兜底 ——
+ * 同一台机器永远算出同一个，不会每次登录变。
+ *
+ * @returns {string} 32 位小写 hex
+ */
+export function deviceGuid() {
+  try {
+    // @ts-ignore —— 只在 Windows 上有
+    const { execFileSync } = require("node:child_process")
+    const out = execFileSync(
+      "reg",
+      ["query", "HKCU\\SOFTWARE\\Tencent\\Marvis\\Env", "/v", "svid"],
+      { encoding: "utf8", windowsHide: true, timeout: 3000 },
+    )
+    const m = /svid\s+REG_SZ\s+([0-9a-fA-F]{32})/.exec(out)
+    if (m) return m[1].toLowerCase()
+  } catch {
+    /* 没装 Marvis 或没有这个键，用派生值 */
+  }
+  // 兜底：机器名 + 用户名 + 平台，哈希成 32 hex。跨进程稳定。
+  const { hostname, userInfo } = require("node:os")
+  const seed = `${hostname()}|${userInfo?.().username ?? ""}|marvis`
+  return createHash("md5").update(seed).digest("hex")
+}
 
 /**
- * 拼授权页地址。
- * @param {"QC" | "WX"} loginType
- * @param {string} guid 设备 guid（微信的 state 就是它）
- * @returns {string}
+ * 从回调页里解析登录态。
+ *
+ * **主路径**：回调页本身就是换 token 的响应，正文是一段 JSON：
+ *   `{"code":0,"msg":"","user_info":{"openid":"...","access_token":"mv_..."},"ext_info":{...}}`
+ * 所以直接读正文，**不要重发请求** —— 重发就是用第二个 code，必然 `-109 RC_PARAMS_INVALID`。
+ *
+ * **兜底**：正文取不到（页面被拦截 / 白屏）时，从地址栏抠 code 再换一次。
+ *
+ * @param {string} callbackUrl 回调页地址
+ * @param {string} [body] 回调页正文
+ * @returns {{ openid: string, accessToken: string, refreshToken?: string, nickname?: string, avatar?: string, loginType: string, expiresAt?: number }}
  */
-export function authorizeUrl(loginType, guid) {
-  if (loginType === "WX") {
-    const p = new URLSearchParams({
-      appid: WX_APP_ID,
-      redirect_uri: REDIRECT,
-      response_type: "code",
-      scope: "snsapi_login",
-      state: guid,
-    })
-    return `https://open.weixin.qq.com/connect/qrconnect?${p}`
-  }
-  // QQ：which=Login&display=pc 是 Marvis 客户端用的参数，别省
-  const p = new URLSearchParams({
-    which: "Login",
-    display: "pc",
-    response_type: "code",
-    client_id: QQ_APP_ID,
-    redirect_uri: REDIRECT,
-    state: String(Math.floor(Math.random() * 1e9)),
-  })
-  return `https://graph.qq.com/oauth2.0/authorize?${p}`
-}
+export function parseCallback(callbackUrl, body) {
+  const text = String(body ?? "").trim()
 
-/**
- * 从用户粘贴的内容里抠出授权码。
- * 支持：纯 code / 完整回调 URL / 整段 JSON 里的 code 字段。
- * @param {string} input
- * @returns {string | null}
- */
-export function extractCode(input) {
-  const s = String(input ?? "").trim()
-  if (!s) return null
-  // 完整 URL
-  try {
-    const u = new URL(s)
-    const c = u.searchParams.get("code")
-    if (c) return c
-  } catch {
-    /* 不是 URL，往下走 */
-  }
-  // JSON
-  if (s.startsWith("{")) {
+  // ① 主路径：正文就是 JSON
+  if (text.startsWith("{")) {
+    /** @type {any} */
+    let body0
     try {
-      const j = JSON.parse(s)
-      const c = j?.code ?? j?.user_info?.code ?? j?.data?.code
-      // 注意：失败响应的 code 是数字错误码，成功时才是字符串
-      if (typeof c === "string" && c.length > 4) return c
+      body0 = JSON.parse(text)
     } catch {
-      /* 不是 JSON */
+      body0 = null
+    }
+    if (body0) {
+      const biz = body0.code
+      if (typeof biz === "number" && biz !== 0) {
+        throw new Error(
+          `登录失败（code=${biz}）：${body0.msg ?? "未返回用户信息"}` +
+            (biz === -109
+              ? "（授权码无效或已被使用过 —— 一个 code 只能换一次 token，请重新走一遍登录）"
+              : ""),
+        )
+      }
+      const info = body0.user_info ?? body0.data ?? body0
+      const accessToken = info?.access_token ?? info?.accessToken
+      const openid = info?.openid ?? info?.openId ?? info?.open_id
+      if (accessToken && openid) return normalize(info, accessToken, openid)
     }
   }
-  // 只有 code=xxx
-  const m = /(?:^|[?&])code=([^&\s]+)/.exec(s)
-  if (m) return decodeURIComponent(m[1])
-  // 裸 code：Marvis 的 code 是长串字母数字
-  if (/^[A-Za-z0-9_-]{8,}$/.test(s)) return s
-  return null
-}
-
-/**
- * 用授权码换 token。
- *
- * 这个端点**自己带签名**（`md5(query+timestamp+accessKey+nonce)`），
- * 不需要登录态 —— 它就是在发登录态。
- *
- * @param {string} code
- * @param {"QC" | "WX"} loginType
- * @param {string} guid
- * @returns {Promise<{ openid: string, accessToken: string, refreshToken?: string, nickname?: string, avatar?: string, loginType: string, expiresAt?: number }>}
- */
-export async function exchangeCode(code, loginType, guid) {
-  const query = new URLSearchParams({ login_type: loginType, code, guid }).toString()
-  const timestamp = String(Date.now())
-  const nonce = String(1000 + Math.floor(Math.random() * 9000))
-  const url = `${REDIRECT}?${query}`
-
-  const res = await fetch(url, {
-    method: "GET",
-    headers: {
-      Accept: "application/json",
-      "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Marvis/1.60.3300.408 Chrome/152.0.7977.130 Electron/44.7.0 Safari/537.36",
-      "Ual-Access-Businessid": BUSINESS_ID,
-      "Ual-Access-Timestamp": timestamp,
-      "Ual-Access-Nonce": nonce,
-      "Ual-Access-Signature": ualSignature(query, timestamp, nonce),
-      "Ual-Access-Guid": guid,
-      "Ual-Access-Login-Type": LOGIN_TYPE[loginType] ?? "6",
-    },
-  })
-
-  const text = await res.text()
-  /** @type {any} */
-  let body
-  try {
-    body = JSON.parse(text)
-  } catch {
-    throw new Error(`登录接口返回的不是 JSON（${res.status}）：${text.slice(0, 200)}`)
-  }
-
-  const info = body?.user_info ?? body?.data ?? null
-  const accessToken = info?.access_token ?? info?.accessToken ?? body?.access_token
-  const openid = info?.openid ?? info?.openId ?? info?.open_id
 
-  if (!accessToken || !openid) {
-    const code = body?.code ?? res.status
-    throw new Error(`登录失败（code=${code}）：${body?.msg ?? "未返回 access_token / openid"}`)
+  // ② 兜底：从地址栏抠 code 再换
+  const code = extractCode(callbackUrl)
+  if (!code) {
+    throw new Error(
+      `回调页没有返回登录态（正文：${text.slice(0, 160) || "空"}）。请重新走一遍登录。`,
+    )
   }
+  throw new Error(
+    `回调页没有直接返回 token（正文：${text.slice(0, 120) || "空"}），` +
+      `请重新走一遍登录。`,
+  )
+}
 
+/** 把上游 user_info 归一成插件内部形状 */
+function normalize(info, accessToken, openid) {
   const expire = Number(info?.access_token_expire_time ?? info?.expires_in ?? 0)
   return {
     openid: String(openid),
     accessToken: String(accessToken),
     refreshToken: info?.refresh_token ? String(info.refresh_token) : undefined,
-    nickname: info?.nick_name ? decodeURIComponent(info.nick_name) : undefined,
+    nickname: info?.nick_name ? safeDecode(info.nick_name) : undefined,
     avatar: info?.head_img_url ?? undefined,
-    loginType: LOGIN_TYPE[loginType] ?? "6",
-    // 上游给的是**到期时刻**（秒）；没给就按 30 天算
+    loginType: "6",
     expiresAt: expire > 1e9 ? expire * 1000 : Date.now() + 30 * 24 * 3600_000,
   }
 }
 
-/**
- * 设备 guid。
- *
- * 来源：注册表 `HKCU\SOFTWARE\Tencent\Marvis\Env\svid`。
- * 服务端按 `(openid, guid, token)` 三元组校验，但 guid 是**纯客户端自报**的 ——
- * 换 guid 会 `-101 redis: nil`，所以它必须稳定，跟着 token 一起存。
- *
- * 没有注册表（没装 Marvis）时，用「本机机器 id 派生」的稳定值兜底 ——
- * 同一台机器永远算出同一个，不会每次登录变。
- *
- * @returns {string} 32 位小写 hex
- */
-export function deviceGuid() {
+function safeDecode(s) {
   try {
-    // @ts-ignore —— 只在 Windows 上有
-    const { execFileSync } = require("node:child_process")
-    const out = execFileSync(
-      "reg",
-      ["query", "HKCU\\SOFTWARE\\Tencent\\Marvis\\Env", "/v", "svid"],
-      { encoding: "utf8", windowsHide: true, timeout: 3000 },
-    )
-    const m = /svid\s+REG_SZ\s+([0-9a-fA-F]{32})/.exec(out)
-    if (m) return m[1].toLowerCase()
+    return decodeURIComponent(String(s))
   } catch {
-    /* 没装 Marvis 或没有这个键，用派生值 */
+    return String(s)
   }
-  // 兜底：机器名 + 用户名 + 平台，哈希成 32 hex。跨进程稳定。
-  const { hostname, userInfo } = require("node:os")
-  const seed = `${hostname()}|${userInfo?.().username ?? ""}|marvis`
-  return createHash("md5").update(seed).digest("hex")
 }