mu-agent-bridge 1.0.71 → 1.0.78

package/dist/tests-ts/zcode-plugin.test.js

@@ -0,0 +1,396 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const strict_1 = __importDefault(require("node:assert/strict"));
+const node_test_1 = __importStar(require("node:test"));
+const childProcess = require("node:child_process");
+const desktop = __importStar(require("../src-ts/plugins/desktop-launch"));
+const cdp_client_1 = require("../src-ts/plugins/zcode/cdp-client");
+const zcode_1 = require("../src-ts/plugins/zcode");
+const agent_1 = require("../src-ts/agent");
+function startupFixture(error = new TypeError("fetch failed", { cause: Object.assign(new Error("端口拒绝连接"), { code: "ECONNREFUSED" }) })) {
+    const platform = Object.getOwnPropertyDescriptor(process, "platform");
+    Object.defineProperty(process, "platform", { value: "win32" });
+    let online = false;
+    let connections = 0;
+    const launches = [];
+    const discovery = node_test_1.mock.method(desktop, "findWindowsExecutable", async () => "D:\\自定义安装\\ZCode\\ZCode.exe");
+    node_test_1.mock.method(cdp_client_1.ZcodeCdpClient.prototype, "connect", async () => { connections++; if (!online)
+        throw error; });
+    node_test_1.mock.method(cdp_client_1.ZcodeCdpClient.prototype, "connected", () => online);
+    node_test_1.mock.method(childProcess, "spawn", (file, args, options) => {
+        launches.push({ file, args, env: options.env });
+        online = true;
+        return { unref() { }, exitCode: null, signalCode: null };
+    });
+    return { launches, discovery, connections: () => connections, online(value) { online = value; }, restore() { node_test_1.mock.restoreAll(); Object.defineProperty(process, "platform", platform); } };
+}
+const startupContext = (config = {}) => ({ config, logger: { info() { }, warn() { }, error() { } } });
+(0, node_test_1.default)("ZCode 后台激活自动发现程序并带 CDP 和附加参数启动，重载重新启动自有桌面", async () => {
+    const fixture = startupFixture();
+    const previous = process.env.ELECTRON_RUN_AS_NODE;
+    process.env.ELECTRON_RUN_AS_NODE = "1";
+    const plugin = new zcode_1.ZcodePlugin();
+    try {
+        const context = startupContext({ cdpPort: 19321, startupArgs: ["--lang=zh-CN", "--test-value=含 空格"] });
+        await plugin.activate(context);
+        strict_1.default.equal((await plugin.health()).status, "ready");
+        strict_1.default.equal(fixture.discovery.mock.calls[0].arguments[0], "ZCode.exe");
+        strict_1.default.equal(fixture.launches[0].file, "D:\\自定义安装\\ZCode\\ZCode.exe");
+        strict_1.default.deepEqual(fixture.launches[0].args, ["--lang=zh-CN", "--test-value=含 空格", "--remote-debugging-address=127.0.0.1", "--remote-debugging-port=19321"]);
+        strict_1.default.equal(fixture.launches[0].env.ELECTRON_RUN_AS_NODE, undefined);
+        await plugin.deactivate("reload");
+        fixture.online(false);
+        await plugin.activate(context);
+        strict_1.default.equal(fixture.launches.length, 2);
+        strict_1.default.ok(fixture.connections() >= 3);
+    }
+    finally {
+        await plugin.deactivate("stop");
+        fixture.restore();
+        if (previous === undefined)
+            delete process.env.ELECTRON_RUN_AS_NODE;
+        else
+            process.env.ELECTRON_RUN_AS_NODE = previous;
+    }
+});
+(0, node_test_1.default)("ZCode 已有 CDP、禁用自动启动和非端口错误均不拉起桌面", async () => {
+    for (const mode of ["connected", "disabled", "page"]) {
+        const fixture = startupFixture(mode === "page" ? new Error("未找到 ZCode 页面 target") : undefined);
+        const plugin = new zcode_1.ZcodePlugin();
+        try {
+            if (mode === "connected")
+                fixture.online(true);
+            const start = plugin.activate(startupContext({ autoStart: mode !== "disabled" }));
+            if (mode === "connected")
+                await start;
+            else
+                await strict_1.default.rejects(start, mode === "page" ? /未找到 ZCode 页面/ : /fetch failed/);
+            strict_1.default.equal(fixture.launches.length, 0);
+            strict_1.default.equal(fixture.discovery.mock.callCount(), 0);
+        }
+        finally {
+            await plugin.deactivate("stop");
+            fixture.restore();
+        }
+    }
+});
+(0, node_test_1.default)("ZCode 找不到安装记录时给出自身程序的配置提示", async () => {
+    const fixture = startupFixture();
+    fixture.discovery.mock.mockImplementation(async () => undefined);
+    const plugin = new zcode_1.ZcodePlugin();
+    try {
+        await strict_1.default.rejects(plugin.activate(startupContext()), /未找到 ZCode.exe.*executablePath/);
+        strict_1.default.equal(fixture.launches.length, 0);
+    }
+    finally {
+        await plugin.deactivate("stop");
+        fixture.restore();
+    }
+});
+(0, node_test_1.default)("ZCode 附加启动参数不能覆盖配置中的 CDP 地址或端口", async () => {
+    const fixture = startupFixture();
+    const plugin = new zcode_1.ZcodePlugin();
+    try {
+        for (const startupArgs of [["--remote-debugging-port=9999"], ["--remote-debugging-address", "0.0.0.0"], [123]]) {
+            await strict_1.default.rejects(plugin.activate(startupContext({ startupArgs })), /startupArgs/);
+        }
+        strict_1.default.equal(fixture.launches.length, 0);
+    }
+    finally {
+        await plugin.deactivate("stop");
+        fixture.restore();
+    }
+});
+(0, node_test_1.default)("ZCode 重载时清理自有进程，委托退出失败也执行清理", async () => {
+    for (const delegateFails of [false, true]) {
+        const fixture = startupFixture();
+        const plugin = new zcode_1.ZcodePlugin();
+        const child = { pid: 4321, exitCode: null, signalCode: null, unref() { } };
+        const cleanup = node_test_1.mock.method(desktop, "terminateOwnedProcess", async () => undefined);
+        try {
+            await plugin.activate(startupContext());
+            plugin.process = child;
+            if (delegateFails)
+                plugin.delegate.deactivate = async () => { throw new Error("委托退出失败"); };
+            if (delegateFails)
+                await strict_1.default.rejects(plugin.deactivate("reload"), /委托退出失败/);
+            else
+                await plugin.deactivate("reload");
+            strict_1.default.equal(cleanup.mock.callCount(), 1);
+            strict_1.default.equal(cleanup.mock.calls[0].arguments[0], child);
+        }
+        finally {
+            await plugin.deactivate("stop");
+            fixture.restore();
+        }
+    }
+});
+(0, node_test_1.default)("zcode CDP 客户端选择 zcode 页面", async () => {
+    const original = globalThis.WebSocket;
+    let url = "";
+    class TestWebSocket {
+        static OPEN = 1;
+        readyState = 0;
+        onopen;
+        onclose;
+        onerror;
+        onmessage;
+        constructor(target) { url = target; queueMicrotask(() => { this.readyState = 1; this.onopen?.(); }); }
+        send(message) { const { id } = JSON.parse(message); queueMicrotask(() => this.onmessage?.({ data: JSON.stringify({ id, result: { result: { value: true } } }) })); }
+        close() { this.readyState = 3; }
+    }
+    globalThis.WebSocket = TestWebSocket;
+    const client = new cdp_client_1.ZcodeCdpClient({
+        timeoutMs: 20,
+        fetchImpl: async () => new Response(JSON.stringify([
+            { type: "page", title: "WorkBuddy", url: "app://workbuddy", webSocketDebuggerUrl: "ws://127.0.0.1:9231/devtools/page/1" },
+            { type: "page", title: "ZCode", url: "app://zcode", webSocketDebuggerUrl: "ws://127.0.0.1:9231/devtools/page/2" },
+        ])),
+    });
+    try {
+        await client.connect();
+        strict_1.default.equal(url, "ws://127.0.0.1:9231/devtools/page/2");
+    }
+    finally {
+        client.close();
+        globalThis.WebSocket = original;
+    }
+});
+(0, node_test_1.default)("zcode CDP 客户端拒绝其他桌面页面", async () => {
+    const client = new cdp_client_1.ZcodeCdpClient({
+        fetchImpl: async () => new Response(JSON.stringify([
+            { type: "page", title: "WorkBuddy", url: "app://workbuddy", webSocketDebuggerUrl: "ws://127.0.0.1:9231/devtools/page/1" },
+        ])),
+    });
+    await strict_1.default.rejects(() => client.connect(), /未找到 ZCode 页面 target/);
+});
+(0, node_test_1.default)("ZCode 重载后仅对发现请求的旧连接重置重试一次，保留端口拒绝错误", async () => {
+    for (const mode of ["reset", "reset-refused", "refused"]) {
+        let attempts = 0;
+        const refused = new TypeError("fetch failed", { cause: Object.assign(new Error("端口拒绝连接"), { code: "ECONNREFUSED" }) });
+        const client = new cdp_client_1.ZcodeCdpClient({ fetchImpl: async () => {
+                attempts++;
+                if (mode !== "refused" && attempts === 1)
+                    throw new TypeError("fetch failed", { cause: Object.assign(new Error("旧连接重置"), { code: "ECONNRESET" }) });
+                if (mode !== "reset")
+                    throw refused;
+                return new Response("[]");
+            } });
+        await strict_1.default.rejects(client.connect(), mode === "reset" ? /未找到 ZCode 页面 target/ : error => error === refused);
+        strict_1.default.equal(attempts, mode === "refused" ? 1 : 2);
+    }
+});
+(0, node_test_1.default)("zcode 插件通过 CDP 客户端返回桌面回复", async () => {
+    const calls = [];
+    const plugin = new zcode_1.ZcodePlugin({ client: {
+            connect: async () => undefined,
+            close() { },
+            connected: () => true,
+            createTask: async () => undefined,
+            direct: async (text) => { calls.push(text); return "ZCODE_DESKTOP_REPLY"; },
+        } });
+    await plugin.activate({ config: { cdpPort: 9231 }, logger: { info() { }, warn() { }, error() { } } });
+    strict_1.default.deepEqual(await plugin.handle({ task: "请回复固定文本", sessionId: "zcode:test" }), { text: "ZCODE_DESKTOP_REPLY", sessionId: "zcode:test" });
+    strict_1.default.deepEqual(calls, ["请回复固定文本"]);
+    await plugin.deactivate("stop");
+});
+(0, node_test_1.default)("ZCode 将包含专家称呼的消息作为普通文本发送", async () => {
+    const plugin = new zcode_1.ZcodePlugin({ client: {
+            connect: async () => undefined, close() { }, connected: () => true,
+            direct: async (text, _timeout, expert) => { strict_1.default.equal(expert, undefined); return text; },
+        } });
+    await plugin.activate({ config: {}, logger: { info() { }, warn() { }, error() { } } });
+    try {
+        strict_1.default.equal((await plugin.handle({ task: "用数学专家解释这个题" })).text, "用数学专家解释这个题");
+    }
+    finally {
+        await plugin.deactivate("stop");
+    }
+});
+(0, node_test_1.default)("ZCode 复用会话层时保留原有等待配置", async () => {
+    const timeouts = [];
+    const plugin = new zcode_1.ZcodePlugin({ client: {
+            connect: async () => undefined, close() { }, connected: () => true,
+            direct: async (_text, timeout) => { timeouts.push(timeout); return "回复"; },
+        } });
+    await plugin.activate({ config: {}, logger: { info() { }, warn() { }, error() { } } });
+    try {
+        await plugin.handle({ task: "默认" });
+        await plugin.handle({ task: "短等待", timeoutMs: 1234 });
+        await plugin.handle({ task: "既有长等待", timeoutMs: 7_200_000 });
+        strict_1.default.deepEqual(timeouts, [3_600_000, 1234, 7_200_000]);
+    }
+    finally {
+        await plugin.deactivate("stop");
+    }
+});
+(0, node_test_1.default)("ZCode 失败后保留原任务绑定，续聊必须恢复原任务", async () => {
+    let desktop = "A";
+    let fail = false;
+    const sent = [];
+    const restored = [];
+    const plugin = new zcode_1.ZcodePlugin({ client: {
+            connect: async () => undefined, close() { }, connected: () => true,
+            createTask: async () => { desktop = "A"; },
+            conversationId: async () => desktop,
+            activateConversation: async (id) => { restored.push(id); desktop = id; },
+            direct: async () => { if (fail) {
+                desktop = "B";
+                throw new Error("桌面任务已切换");
+            } sent.push(desktop); return "回复"; },
+        } });
+    await plugin.activate({ config: {}, logger: { info() { }, warn() { }, error() { } } });
+    try {
+        await plugin.handle({ task: "首轮", sessionId: "peer-A" });
+        fail = true;
+        await strict_1.default.rejects(() => plugin.handle({ task: "切换", sessionId: "peer-A" }), /桌面任务已切换/);
+        fail = false;
+        await plugin.handle({ task: "续聊", sessionId: "peer-A" });
+        strict_1.default.deepEqual(restored, ["A"]);
+        strict_1.default.deepEqual(sent, ["A", "A"]);
+    }
+    finally {
+        await plugin.deactivate("stop");
+    }
+});
+(0, node_test_1.default)("ZCode 会话管理失败使用自身错误码和文案，不冒充 WorkBuddy", async () => {
+    let desktop = "session_original";
+    const plugin = new zcode_1.ZcodePlugin({ client: {
+            connect: async () => undefined, close() { }, connected: () => true,
+            createTask: async () => { desktop = "session_original"; },
+            conversationId: async () => desktop,
+            direct: async () => "回复",
+        } });
+    await plugin.activate({ config: {}, logger: { info() { }, warn() { }, error() { } } });
+    try {
+        await plugin.handle({ task: "首轮", sessionId: "peer-A" });
+        desktop = "session_other";
+        await strict_1.default.rejects(plugin.handle({ task: "续聊", sessionId: "peer-A" }), error => {
+            strict_1.default.ok(error instanceof agent_1.AgentOperationError);
+            strict_1.default.equal(error.code, "ZCODE_TASK_FAILED");
+            strict_1.default.equal(error.stage, "准备或恢复 ZCode 会话");
+            strict_1.default.doesNotMatch((0, agent_1.errorDetails)(error), /WorkBuddy|WORKBUDDY/);
+            strict_1.default.match((0, agent_1.errorDetails)(error), /ZCode 桌面任务已切换/);
+            return true;
+        });
+    }
+    finally {
+        await plugin.deactivate("stop");
+    }
+});
+(0, node_test_1.default)("ZCode 排队请求取消后不创建或切换桌面任务", async () => {
+    let created = 0;
+    const plugin = new zcode_1.ZcodePlugin({ client: {
+            connect: async () => undefined, close() { }, connected: () => true,
+            createTask: async () => { created++; }, direct: async () => "回复",
+        } });
+    await plugin.activate({ config: {}, logger: { info() { }, warn() { }, error() { } } });
+    const controller = new AbortController();
+    controller.abort(new Error("已取消"));
+    try {
+        await strict_1.default.rejects(() => plugin.handle({ task: "已取消请求", sessionId: "cancelled", signal: controller.signal }), /已取消/);
+        strict_1.default.equal(created, 0);
+    }
+    finally {
+        await plugin.deactivate("stop");
+    }
+});
+(0, node_test_1.default)("ZCode 委托将原生任务绑定传给发送端复核", async () => {
+    let desktop;
+    const expected = [];
+    const plugin = new zcode_1.ZcodePlugin({ client: {
+            connect: async () => undefined, close() { }, connected: () => true,
+            createTask: async () => { desktop = undefined; }, conversationId: async () => desktop,
+            direct: async () => "",
+            complete: async (_request, _expert, _newTask, expectedConversationId) => { expected.push(expectedConversationId); desktop = "A"; return { text: "回复" }; },
+        } });
+    await plugin.activate({ config: {}, logger: { info() { }, warn() { }, error() { } } });
+    try {
+        await plugin.handle({ task: "首轮", sessionId: "peer-A" });
+        await plugin.handle({ task: "续聊", sessionId: "peer-A" });
+        strict_1.default.deepEqual(expected, [null, "A"]);
+    }
+    finally {
+        await plugin.deactivate("stop");
+    }
+});
+(0, node_test_1.default)("ZCode CDP 协议错误、页面异常、超时和断线会拒绝请求并清理等待", async () => {
+    const original = globalThis.WebSocket;
+    let socket;
+    let reply = "error";
+    class TestWebSocket {
+        static OPEN = 1;
+        readyState = 0;
+        onopen;
+        onclose;
+        onerror;
+        onmessage;
+        constructor() { socket = this; queueMicrotask(() => { this.readyState = 1; this.onopen?.(); }); }
+        send(raw) {
+            const { id } = JSON.parse(raw);
+            if (reply === "silent")
+                return;
+            const response = reply === "error" ? { id, error: { code: -32000, message: "协议失败" } } : { id, result: { exceptionDetails: { text: "页面异常" } } };
+            queueMicrotask(() => this.onmessage?.({ data: JSON.stringify(response) }));
+        }
+        close() { this.readyState = 3; this.onclose?.(); }
+    }
+    globalThis.WebSocket = TestWebSocket;
+    const client = new cdp_client_1.ZcodeCdpClient({ timeoutMs: 20, fetchImpl: async () => new Response(JSON.stringify([{ type: "page", title: "ZCode", webSocketDebuggerUrl: "ws://127.0.0.1:9231/devtools/page/1" }])) });
+    const internal = client;
+    try {
+        await client.connect();
+        await strict_1.default.rejects(() => internal.cdp("Runtime.evaluate"), /协议失败/);
+        reply = "exception";
+        await strict_1.default.rejects(() => internal.evaluate("1"), /页面异常/);
+        reply = "silent";
+        await strict_1.default.rejects(() => internal.cdp("Runtime.evaluate"), /超时/);
+        strict_1.default.equal(internal.pending.size, 0);
+        const pending = internal.cdp("Runtime.evaluate");
+        const rejected = strict_1.default.rejects(pending, /已关闭|已断开/);
+        socket.close();
+        await rejected;
+        strict_1.default.equal(internal.pending.size, 0);
+        strict_1.default.equal(client.connected(), false);
+    }
+    finally {
+        client.close();
+        globalThis.WebSocket = original;
+    }
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mu-agent-bridge",
-  "version": "1.0.71",
+  "version": "1.0.78",
   "description": "将 AUN Agent 连接到本地桌面 AI 客户端的插件平台。",
   "main": "dist/src-ts/cli.js",
   "bin": {

package/plugins/abweb/dist/src-ts/agent.js

@@ -1,7 +1,42 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AgentOperationError = exports.AgentError = void 0;
+exports.abortable = abortable;
 exports.errorDetails = errorDetails;
+async function abortable(promise, signal) {
+    if (!signal)
+        return promise;
+    if (signal.aborted) {
+        // promise 已在调用方启动，先观察其拒绝，避免预取消时产生未处理拒绝。
+        void promise.catch(() => undefined);
+        signal.throwIfAborted();
+    }
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        const cleanup = () => signal.removeEventListener("abort", abort);
+        const abort = () => {
+            if (settled)
+                return;
+            settled = true;
+            cleanup();
+            reject(signal.reason);
+        };
+        signal.addEventListener("abort", abort, { once: true });
+        promise.then((value) => {
+            if (settled)
+                return;
+            settled = true;
+            cleanup();
+            resolve(value);
+        }, (error) => {
+            if (settled)
+                return;
+            settled = true;
+            cleanup();
+            reject(error);
+        });
+    });
+}
 class AgentError extends Error {
     constructor(message, options) {
         super(message, options);

package/plugins/abweb/dist/src-ts/plugins/abweb/index.js

@@ -5,7 +5,7 @@ const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const MANIFEST = {
     id: "abweb",
-    version: "1.0.11",
+    version: "1.0.15",
     displayName: "Agent Bridge Web",
     entry: "dist/index.js",
     apiVersion: "1",

package/plugins/abweb/dist/src-ts/plugins/abweb/public/app.js

@@ -34,6 +34,7 @@
     let logHasNext = false;
     let loading = false;
     const installingPackages = new Set();
+    let assistantOriginal = {};
     function error(message) { errorNode.textContent = message; errorNode.hidden = !message; }
     function showResult(title, message, failed) {
         node("#operation-result-title").textContent = title;
@@ -76,7 +77,7 @@
         head.append(headRow);
         const body = document.createElement("tbody");
         for (const plugin of items) {
-            const installed = plugins.find((item) => item.id === plugin.name.replace(/^agent-bridge-/, ""));
+            const installed = plugins.find((item) => item.id === (plugin.id ?? plugin.name.replace(/^agent-bridge-/, "")));
             const versionStatus = installed ? pluginVersions[installed.id] : undefined;
             const isUpgrade = Boolean(installed && versionStatus?.packageName === plugin.name && newerVersion(plugin.version, installed.version));
             const row = document.createElement("tr");
@@ -218,7 +219,8 @@
         versionsNode.replaceChildren(...entries.map((entry) => {
             const row = document.createElement("div");
             row.className = "version-row";
-            row.textContent = `${entry.packageName} · 当前 ${entry.currentVersion} · ${entry.latestVersion ? `最新 ${entry.latestVersion}` : "最新版本未知"} · ${entry.state}${entry.error ? ` · ${entry.error}` : ""}`;
+            const state = entry.state === "unpublished" ? "未发布" : entry.state;
+            row.textContent = `${entry.packageName} · 当前 ${entry.currentVersion} · ${entry.latestVersion ? `最新 ${entry.latestVersion}` : "最新版本未知"} · ${state}${entry.error ? ` · ${entry.error}` : ""}`;
             return row;
         }));
         if (!entries.length)
@@ -309,7 +311,7 @@
             status.className = `status status-${plugin.status}`;
             status.textContent = plugin.status;
             if (plugin.type === "agent")
-                type.textContent += ` · ${{ cli: "CLI", cdp: "CDP" }[plugin.manifest?.executionMode ?? ""] ?? "未声明"}`;
+                type.textContent += plugin.manifest?.executionMode === "cli" ? " · CLI" : " · 桌面";
             const dependencies = Object.entries(plugin.manifest?.dependencies ?? {});
             if (dependencies.length) {
                 const detail = document.createElement("small");
@@ -344,6 +346,8 @@
             controls.className = "controls";
             if (plugin.manifest?.executionMode === "cli")
                 controls.append(button("配置", `配置 ${plugin.id}`, () => configureCli(plugin)));
+            if (plugin.id === "personal-assistant")
+                controls.append(button("配置模型", "配置个人助理模型来源", () => configureAssistant(plugin)));
             if (pluginVersions[plugin.id]?.state === "update-available" && plugin.path.includes("node_modules")) {
                 controlsUpgrade(plugin.id);
                 controls.append(button("下载", `下载 ${plugin.id}`, async () => { await request(`/api/plugins/${encodeURIComponent(plugin.id)}/download`, "POST", { packageName: plugin.packageName, version: pluginVersions[plugin.id]?.latestVersion }); await load(); }));
@@ -401,6 +405,70 @@
             detail.hidden = false;
         }).finally(() => { save.disabled = false; });
     };
+    node("#assistant-config-cancel").onclick = () => node("#assistant-config-dialog").close();
+    async function configureAssistant(plugin) {
+        const [config, sourceResult] = await Promise.all([
+            request(`/api/plugins/${encodeURIComponent(plugin.id)}/config`),
+            request("/api/model-providers"),
+        ]);
+        assistantOriginal = config;
+        const select = node("#assistant-model-provider");
+        select.replaceChildren();
+        const add = (value, label, disabled = false) => { const option = document.createElement("option"); option.value = value; option.textContent = label; option.disabled = disabled; select.append(option); };
+        add("openai", "OpenAI 兼容接口");
+        if (config.modelProvider === "claude-cli")
+            add("claude-cli", "Claude CLI（原有配置，用户默认模型）");
+        for (const provider of sourceResult.providers ?? [])
+            add(`plugin:${provider.id}`, `${provider.displayName || provider.id}${provider.available ? "" : `（不可用：${provider.reason || provider.status}）`}`, !provider.available);
+        if (config.modelProvider === "plugin" && config.modelPlugin && !(sourceResult.providers ?? []).some((item) => item.id === config.modelPlugin))
+            add(`plugin:${config.modelPlugin}`, `${config.modelPlugin}（未安装或未声明模型来源）`, true);
+        select.value = config.modelProvider === "plugin" && config.modelPlugin ? `plugin:${config.modelPlugin}` : config.modelProvider ?? "openai";
+        node("#assistant-model").value = config.model ?? "";
+        node("#assistant-endpoint").value = config.endpoint ?? "";
+        node("#assistant-api-key").value = "";
+        node("#assistant-api-key").placeholder = config.apiKey ? "已配置，留空保留" : "可选，本地免认证服务可留空";
+        node("#assistant-timeout").value = String(config.timeoutMs ?? 120000);
+        node("#assistant-allowed-peers").value = config.allowedPeers?.includes("*") ? "" : (config.allowedPeers ?? []).join("\n");
+        node("#assistant-allowed-agents").value = config.allowedAgents?.includes("*") ? "" : (config.allowedAgents ?? []).join("\n");
+        node("#assistant-config-error").hidden = true;
+        node("#assistant-config-dialog").showModal();
+    }
+    node("#assistant-config-form").onsubmit = event => {
+        event.preventDefault();
+        const save = node("#assistant-config-save");
+        save.disabled = true;
+        const source = node("#assistant-model-provider").value;
+        const provider = source.startsWith("plugin:") ? "plugin" : source;
+        const modelPlugin = source.startsWith("plugin:") ? source.slice("plugin:".length) : undefined;
+        const body = {};
+        if (provider !== (assistantOriginal.modelProvider ?? "openai"))
+            body.modelProvider = provider;
+        if (provider === "plugin" && modelPlugin !== assistantOriginal.modelPlugin)
+            body.modelPlugin = modelPlugin;
+        const model = node("#assistant-model").value.trim();
+        const endpoint = node("#assistant-endpoint").value.trim();
+        const apiKey = node("#assistant-api-key").value;
+        if (model && model !== String(assistantOriginal.model ?? ""))
+            body.model = model;
+        if (endpoint && endpoint !== String(assistantOriginal.endpoint ?? ""))
+            body.endpoint = endpoint;
+        if (apiKey.trim())
+            body.apiKey = apiKey.trim();
+        const timeoutMs = Number(node("#assistant-timeout").value);
+        if (timeoutMs !== Number(assistantOriginal.timeoutMs ?? 120000))
+            body.timeoutMs = timeoutMs;
+        for (const [field, selector] of [["allowedPeers", "#assistant-allowed-peers"], ["allowedAgents", "#assistant-allowed-agents"]]) {
+            const entries = [...new Set(node(selector).value.split(/[\s,，]+/).filter(Boolean))];
+            const values = entries.includes("*") ? [] : entries;
+            if (JSON.stringify(values) !== JSON.stringify(assistantOriginal[field]))
+                body[field] = values;
+        }
+        void request("/api/plugins/personal-assistant/config", "PATCH", body).then(result => {
+            node("#assistant-config-dialog").close();
+            showResult("个人助理配置已保存", result.restartRequired || result.action === "restart" ? "配置已保存，需要重启后台后生效。" : "模型来源配置已更新。", false);
+            return load(false);
+        }).catch(cause => { const detail = node("#assistant-config-error"); detail.textContent = String(cause); detail.hidden = false; }).finally(() => { save.disabled = false; });
+    };
     function renderMessages(messages) {
         messagesNode.replaceChildren();
         messagesEmpty.hidden = messages.length > 0;
@@ -453,8 +521,8 @@
     node("#check-versions").onclick = () => void request("/api/versions/check", "POST", {}).then(() => load()).catch((cause) => error(String(cause)));
     node("#save-update-policy").onclick = () => void request("/api/update-policy", "PATCH", { mode: policyNode.value }).then(() => load()).catch((cause) => error(String(cause)));
     node("#save-plugin-trust").onclick = () => { const button = node("#save-plugin-trust"); button.disabled = true; trustStatusNode.textContent = "正在保存…"; void request("/api/plugin-trust", "PATCH", pluginTrustConfig).then(() => { pluginTrustDirty = false; trustStatusNode.textContent = "信任设置已保存"; return load(false); }).catch((cause) => { trustStatusNode.textContent = String(cause); }).finally(() => { button.disabled = false; }); };
-    node("#update-core").onclick = () => { if (confirm("确认升级后台并自动重启？"))
-        void request("/api/update", "POST", {}).then(() => { error("后台正在升级，页面将在几秒后恢复"); }).catch((cause) => error(String(cause))); };
+    node("#update-core").onclick = () => { if (confirm("确认检查后台更新？有更高版本时将升级并自动重启"))
+        void request("/api/update", "POST", {}).then(() => { error("后台正在检查更新，有更高版本时升级并重启；结果请查看运行日志"); }).catch((cause) => error(String(cause))); };
     node("#pair-button").onclick = () => {
         const code = pairCodeNode.value.trim();
         if (!/^\d{6}$/.test(code))