mu-agent-bridge 1.0.41 → 1.0.43

package/dist/src-ts/plugins/local-cli/agent.js

@@ -0,0 +1,321 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalCliAgent = void 0;
+exports.resolveWindowsCliShim = resolveWindowsCliShim;
+const node_child_process_1 = require("node:child_process");
+const node_fs_1 = require("node:fs");
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+const node_crypto_1 = require("node:crypto");
+const nativeId = /^[0-9a-f]{8}(?:-[0-9a-f]{4}){3}-[0-9a-f]{12}$/i;
+const maximumOutput = 4 * 1024 * 1024;
+function diagnostic(value) {
+    return value.replace(/\b(?:Bearer\s+)[^\s"']+/gi, "Bearer [已隐藏]")
+        .replace(/((?:[\w-]*(?:token|secret|password|api[_-]?key)[\w-]*)["']?\s*[:=]\s*["']?)[^\s"',}]+/gi, "$1[已隐藏]")
+        .replace(/\b(?:sk-|npm_)[A-Za-z0-9_-]+/g, "[已隐藏]")
+        .replace(/https?:\/\/[^\s"']+/g, text => { try {
+        const url = new URL(text);
+        return `${url.origin}/[路径已隐藏]`;
+    }
+    catch {
+        return "[地址已隐藏]";
+    } })
+        .slice(0, 2000);
+}
+async function resolveWindowsCliShim(file, provider) {
+    const modules = (0, node_path_1.basename)((0, node_path_1.dirname)(file)) === ".bin" ? (0, node_path_1.dirname)((0, node_path_1.dirname)(file)) : (0, node_path_1.join)((0, node_path_1.dirname)(file), "node_modules");
+    const root = (0, node_path_1.join)(modules, ...(provider === "codex" ? ["@openai", "codex"] : ["@anthropic-ai", "claude-code"]));
+    const metadata = JSON.parse(await (0, promises_1.readFile)((0, node_path_1.join)(root, "package.json"), "utf8"));
+    const entry = typeof metadata.bin === "string" ? metadata.bin : metadata.bin?.[provider];
+    if (typeof entry !== "string" || !entry)
+        throw new Error("npm CLI 包未声明可执行入口");
+    const target = (0, node_path_1.resolve)(root, entry), path = (0, node_path_1.relative)(root, target);
+    if ((0, node_path_1.isAbsolute)(entry) || path === ".." || path.startsWith(`..${node_path_1.sep}`))
+        throw new Error("npm CLI 入口路径超出包目录");
+    if (!(await (0, promises_1.stat)(target)).isFile())
+        throw new Error("npm CLI 入口不是文件");
+    await (0, promises_1.access)(target, node_fs_1.constants.R_OK);
+    if ([".js", ".cjs", ".mjs"].includes((0, node_path_1.extname)(target)))
+        return { command: process.execPath, args: [target] };
+    if ((0, node_path_1.extname)(target).toLowerCase() !== ".exe")
+        throw new Error("npm CLI 入口必须是原生 exe 或 Node 脚本");
+    return { command: target, args: [] };
+}
+async function executable(provider, configured) {
+    const candidates = configured ? [(0, node_path_1.resolve)(configured)] : (process.env.PATH ?? "").split(node_path_1.delimiter).filter(Boolean)
+        .flatMap(directory => (process.platform === "win32" ? [".exe", ".cmd", ".bat", ""] : [""]).map(extension => (0, node_path_1.join)(directory, provider + extension)));
+    for (const file of candidates) {
+        try {
+            if (!(await (0, promises_1.stat)(file)).isFile())
+                continue;
+            if (process.platform === "win32" && [".cmd", ".bat"].includes((0, node_path_1.extname)(file).toLowerCase()))
+                return await resolveWindowsCliShim(file, provider);
+            if ([".js", ".cjs", ".mjs"].includes((0, node_path_1.extname)(file))) {
+                await (0, promises_1.access)(file, node_fs_1.constants.R_OK);
+                return { command: process.execPath, args: [file] };
+            }
+            await (0, promises_1.access)(file, process.platform === "win32" ? node_fs_1.constants.F_OK : node_fs_1.constants.X_OK);
+            return { command: file, args: [] };
+        }
+        catch (error) {
+            if (configured)
+                throw new Error(`无法使用 ${provider} CLI 程序：${diagnostic(String(error))}；请检查路径、安装及 daemon 用户的执行权限`);
+        }
+    }
+    throw new Error(`未找到 ${provider} CLI 可执行程序，请安装并在 daemon 用户下登录，或配置 executablePath`);
+}
+class LocalCliAgent {
+    manifest;
+    provider;
+    sessionOperations = ["new"];
+    attachmentInput = false;
+    context;
+    command;
+    cwd = "";
+    timeoutMs = 240000;
+    ready = false;
+    message = "插件尚未启动";
+    version = "";
+    sessions = new Map();
+    writes = Promise.resolve();
+    pending = new Map();
+    children = new Map();
+    constructor(manifest, provider) {
+        this.manifest = manifest;
+        this.provider = provider;
+    }
+    async activate(context) {
+        this.context = context;
+        this.ready = false;
+        try {
+            const cwd = context.config.cwd;
+            if (typeof cwd !== "string" || !cwd.trim() || !(0, node_path_1.isAbsolute)(cwd))
+                throw new Error("请配置已存在的绝对工作目录 cwd");
+            if (!(await (0, promises_1.stat)(cwd)).isDirectory())
+                throw new Error("工作目录 cwd 不是目录");
+            this.cwd = cwd;
+            const timeout = context.config.timeoutMs ?? 240000;
+            if (typeof timeout !== "number" || !Number.isInteger(timeout) || timeout <= 0 || timeout > 2147483647)
+                throw new Error("timeoutMs 必须是有效的正整数毫秒数");
+            this.timeoutMs = timeout;
+            const configured = context.config.executablePath;
+            if (configured !== undefined && typeof configured !== "string")
+                throw new Error("executablePath 必须是路径字符串");
+            this.command = await executable(this.provider, typeof configured === "string" && configured.trim() ? configured : undefined);
+            this.version = (await this.run(["--version"], "", 10000)).stdout.trim();
+            if (!/\d+\.\d+\.\d+/.test(this.version))
+                throw new Error("无法识别 CLI 版本");
+            const help = (await this.run(this.provider === "codex" ? ["exec", "--help"] : ["--help"], "", 10000)).stdout;
+            if (this.provider === "codex" ? !help.includes("--json") || !help.includes("resume") : !help.includes("--output-format") || !help.includes("--resume"))
+                throw new Error("CLI 版本不支持所需的结构化输出和会话恢复，请升级 CLI");
+            this.sessions = new Map();
+            try {
+                const data = JSON.parse(await (0, promises_1.readFile)((0, node_path_1.join)(context.dataDir, "cli-sessions.json"), "utf8"));
+                if (data.version !== 1 || !Array.isArray(data.sessions) || data.sessions.some((entry) => !Array.isArray(entry) || entry.length !== 2 || typeof entry[0] !== "string" || typeof entry[1] !== "string" || !nativeId.test(entry[1])))
+                    throw new Error("CLI 会话映射文件无效，请检查数据文件，不能安全恢复会话");
+                this.sessions = new Map(data.sessions);
+            }
+            catch (error) {
+                if (error.code !== "ENOENT")
+                    throw error;
+            }
+            this.ready = true;
+            this.message = "";
+            context.logger.info("本地 CLI 插件已就绪", { plugin: this.manifest.id, version: diagnostic(this.version) });
+        }
+        catch (error) {
+            this.message = diagnostic(String(error));
+            throw new Error(this.message);
+        }
+    }
+    run(args, input, timeout) {
+        const command = this.command;
+        let child;
+        let stop;
+        const done = new Promise((accept, reject) => {
+            let stdout = "", stderr = "", size = 0, failure = "";
+            child = (0, node_child_process_1.spawn)(command.command, [...command.args, ...args], { cwd: this.cwd, env: process.env, shell: false, windowsHide: true, detached: process.platform !== "win32", stdio: ["pipe", "pipe", "pipe"] });
+            const terminate = (reason) => {
+                if (failure)
+                    return;
+                failure = reason;
+                if (!child.pid)
+                    return;
+                if (process.platform === "win32")
+                    (0, node_child_process_1.execFile)("taskkill.exe", ["/PID", String(child.pid), "/T", "/F"], { windowsHide: true }, () => { });
+                else {
+                    try {
+                        process.kill(-child.pid, "SIGKILL");
+                    }
+                    catch {
+                        child.kill("SIGKILL");
+                    }
+                }
+            };
+            stop = () => terminate("插件已停止，当前 CLI 任务已终止");
+            const timer = setTimeout(() => terminate(`CLI 调用超时（${timeout}ms），请检查登录、网络或权限审批`), timeout);
+            const cleanup = () => { clearTimeout(timer); this.children.delete(child); };
+            child.stdout.setEncoding("utf8");
+            child.stderr.setEncoding("utf8");
+            const collect = (value, error) => {
+                size += Buffer.byteLength(value);
+                if (size > maximumOutput) {
+                    terminate("CLI 输出超过 4MB 限制");
+                    return;
+                }
+                if (error)
+                    stderr += value;
+                else
+                    stdout += value;
+            };
+            child.stdout.on("data", value => collect(value, false));
+            child.stderr.on("data", value => collect(value, true));
+            child.on("error", error => { cleanup(); reject(new Error(`无法启动 ${this.provider} CLI：${diagnostic(String(error))}`)); });
+            child.on("close", (code, signal) => {
+                cleanup();
+                if (failure) {
+                    reject(new Error(failure));
+                    return;
+                }
+                if (code !== 0) {
+                    const detail = diagnostic(stderr || stdout);
+                    const hint = /login|authenticat|not logged|unauthorized|401/i.test(detail) ? "请检查 daemon 运行用户的 CLI 登录状态" : /permission|approval|denied|EACCES/i.test(detail) ? "权限审批受阻，请在本机 CLI 确认目录和工具权限" : "请检查 CLI 配置及网络";
+                    reject(new Error(`${this.provider} CLI 退出码 ${code ?? signal}：${hint}；${detail}`));
+                }
+                else
+                    accept({ stdout, stderr });
+            });
+            child.stdin.on("error", () => { });
+            child.stdin.end(input);
+        });
+        this.children.set(child, { stop, done });
+        return done;
+    }
+    save(session, id) {
+        const operation = this.writes.catch(() => { }).then(async () => {
+            const next = new Map(this.sessions);
+            if (id)
+                next.set(session, id);
+            else
+                next.delete(session);
+            const directory = this.context.dataDir;
+            await (0, promises_1.mkdir)(directory, { recursive: true, mode: 0o700 });
+            const file = (0, node_path_1.join)(directory, "cli-sessions.json"), temporary = `${file}.${(0, node_crypto_1.randomUUID)()}.tmp`;
+            try {
+                await (0, promises_1.writeFile)(temporary, JSON.stringify({ version: 1, sessions: [...next] }), { flag: "wx", mode: 0o600 });
+                await (0, promises_1.rename)(temporary, file);
+            }
+            finally {
+                await (0, promises_1.rm)(temporary, { force: true });
+            }
+            this.sessions = next;
+        });
+        this.writes = operation;
+        return operation;
+    }
+    serial(key, operation) {
+        const next = (this.pending.get(key) ?? Promise.resolve()).catch(() => { }).then(operation);
+        this.pending.set(key, next);
+        return next.finally(() => { if (this.pending.get(key) === next)
+            this.pending.delete(key); });
+    }
+    requireReady() { if (!this.ready)
+        throw new Error(`${this.manifest.displayName} 插件未启动或已停止：${this.message}`); }
+    async handle(request) {
+        this.requireReady();
+        if (request.attachments?.length)
+            throw new Error(`${this.manifest.displayName} 本期不支持附件输入`);
+        if (!request.task?.trim())
+            throw new Error("CLI 任务文本不能为空");
+        const logical = request.sessionId || (0, node_crypto_1.randomUUID)();
+        return this.serial(logical, async () => {
+            this.requireReady();
+            const id = request.newSession ? undefined : this.sessions.get(logical);
+            const args = this.provider === "codex"
+                ? ["exec", ...(id ? ["resume", id] : []), "--json", "-"]
+                : ["--print", "--output-format", "json", ...(id ? ["--resume", id] : [])];
+            const timeout = request.timeoutMs ?? this.timeoutMs;
+            if (!Number.isInteger(timeout) || timeout <= 0 || timeout > 2147483647)
+                throw new Error("任务超时必须是有效的正整数毫秒数");
+            const started = Date.now();
+            this.context.logger.info("本地 CLI 任务开始", { plugin: this.manifest.id, sessionId: logical, resume: Boolean(id) });
+            try {
+                const output = await this.run(args, request.task, timeout);
+                const response = this.parse(output.stdout);
+                if (id && response.id !== id)
+                    throw new Error("CLI 恢复返回的会话 ID 与指定会话不一致，保留原会话绑定");
+                await this.save(logical, response.id);
+                this.context.logger.info("本地 CLI 任务完成", { plugin: this.manifest.id, sessionId: logical, durationMs: Date.now() - started, exitCode: 0 });
+                return { text: response.text, sessionId: logical };
+            }
+            catch (error) {
+                const detail = diagnostic(String(error));
+                this.context.logger.error("本地 CLI 任务失败", { plugin: this.manifest.id, sessionId: logical, durationMs: Date.now() - started, error: detail });
+                throw new Error(`${this.manifest.displayName}：${detail}`);
+            }
+        });
+    }
+    parse(stdout) {
+        let id = "", text = "";
+        try {
+            if (this.provider === "codex") {
+                let completed = false, lastError = "";
+                const messages = [];
+                for (const line of stdout.split(/\r?\n/).filter(line => line.trim())) {
+                    const event = JSON.parse(line);
+                    if (event.type === "thread.started")
+                        id = event.thread_id;
+                    if (event.type === "item.completed" && event.item?.type === "agent_message" && typeof event.item.text === "string")
+                        messages.push(event.item.text);
+                    if (event.type === "turn.failed")
+                        throw new Error(JSON.stringify(event.error ?? event));
+                    // 中途错误后仍可能恢复，必须以最终完成事件判定成功。
+                    if (event.type === "error") {
+                        completed = false;
+                        lastError = JSON.stringify(event.error ?? event);
+                    }
+                    if (event.type === "turn.completed")
+                        completed = true;
+                }
+                if (!completed)
+                    throw new Error(lastError || "缺少完成事件");
+                text = messages.join("\n\n");
+            }
+            else {
+                const event = JSON.parse(stdout);
+                if (event.is_error || event.type !== "result")
+                    throw new Error(JSON.stringify(event.errors ?? event));
+                id = event.session_id;
+                text = event.result;
+            }
+            if (typeof id !== "string" || !nativeId.test(id))
+                throw new Error("缺少有效原生会话 ID");
+            if (typeof text !== "string" || !text.trim())
+                throw new Error("未返回有效回复文本");
+            return { id, text };
+        }
+        catch (error) {
+            throw new Error(`CLI 输出或会话无效：${diagnostic(String(error))}`);
+        }
+    }
+    async controlSession(request) {
+        this.requireReady();
+        return this.serial(request.sessionId, async () => {
+            this.requireReady();
+            await this.save(request.sessionId);
+            return { text: "已新建会话，下条消息将使用新的 CLI 会话", sessionId: (0, node_crypto_1.randomUUID)() };
+        });
+    }
+    async health() {
+        return { status: this.ready ? "ready" : "failed", ...(this.message ? { message: this.message } : {}), details: { executionMode: "cli", version: diagnostic(this.version), activeRequests: this.children.size } };
+    }
+    async deactivate(_reason) {
+        this.ready = false;
+        this.message = "插件已停止";
+        const children = [...this.children.values()];
+        children.forEach(child => child.stop());
+        await Promise.allSettled([...children.map(child => child.done), ...this.pending.values()]);
+        await this.writes.catch(() => { });
+    }
+}
+exports.LocalCliAgent = LocalCliAgent;

package/dist/src-ts/plugins/workbuddy/cdp-client.js

@@ -91,7 +91,9 @@ class WorkbuddyCdpClient {
         pending.reject(new Error("WorkBuddy CDP 已关闭")); this.pending.clear(); }
     async createTask() {
         const snapshot = `(() => { const selected = [...document.querySelectorAll('[data-conversation-id]')].find((item) => String(item.className).includes('_selected_')); const editor = document.querySelector(${JSON.stringify(exports.editorSelector)}); const text = editor?.cloneNode(true); text?.querySelectorAll('[data-slate-placeholder="true"],[data-slate-zero-width]').forEach((item) => item.remove()); return { url: location.href, conversationId: selected?.getAttribute('data-conversation-id') ?? null, selected: Boolean(selected), messages: document.querySelectorAll('.cr-agent[data-message-id]').length, editor: text?.textContent?.replace(/[\\uFEFF\\u200B]/g, '').trim() ?? null, home: Boolean(editor?.querySelector('[data-slate-placeholder="true"]')) }; })()`;
-        const before = await this.evaluate(snapshot);
+        const before = await this.evaluate(`(() => { const state = ${snapshot}; const loginRequired = [...document.querySelectorAll('a,button,[role="button"]')].some(item => /^(?:登录|立即登录|sign in)$/i.test(item.textContent?.trim() ?? '')); return { ...state, loginRequired }; })()`);
+        if (before.loginRequired)
+            throw new Error("WorkBuddy 尚未登录，请先在桌面端登录后重试");
         if (!await this.evaluate(`(() => { const button = [...document.querySelectorAll('button,[role="button"]')].find((item) => item.textContent?.trim() === '新建任务'); if (!button || button.disabled || button.getAttribute('aria-disabled') === 'true') return false; button.click(); return true; })()`))
             throw new Error("WorkBuddy 新建任务入口未找到或不可用");
         // WorkBuddy 首页不分配任务 ID；此时仅接受无选中任务的空白首页。

package/dist/src-ts/plugins/workbuddy/desktop-launch.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.launchWorkbuddyDesktop = launchWorkbuddyDesktop;
+const node_child_process_1 = require("node:child_process");
+function launchWorkbuddyDesktop(executable, args, profileDirectory, port) {
+    // WorkBuddy 会覆盖 Chromium 的用户目录参数，必须使用它自己的环境变量隔离实例。
+    const env = { ...process.env, WORKBUDDY_USER_DATA_DIR: profileDirectory, WORKBUDDY_REMOTE_DEBUGGING_PORT: String(port) };
+    delete env.ELECTRON_RUN_AS_NODE;
+    return (0, node_child_process_1.spawn)(executable, args, { env, detached: true, stdio: "ignore", windowsHide: false });
+}

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

@@ -3,7 +3,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.WorkbuddyPlugin = exports.workbuddyManifest = void 0;
 exports.extractExpertQuery = extractExpertQuery;
 exports.findExecutable = findExecutable;
-const node_child_process_1 = require("node:child_process");
 const node_fs_1 = require("node:fs");
 const promises_1 = require("node:fs/promises");
 const node_os_1 = require("node:os");
@@ -13,6 +12,8 @@ const plugin_1 = require("../../plugin");
 const cdp_client_1 = require("./cdp-client");
 const cli_client_1 = require("./cli-client");
 const session_history_1 = require("./session-history");
+const desktop_launch_1 = require("../desktop-launch");
+const desktop_launch_2 = require("./desktop-launch");
 exports.workbuddyManifest = {
     id: "workbuddy", version: "1.1.13", displayName: "WorkBuddy", type: "agent",
     entry: "dist/index.js", apiVersion: "1", process: "in-process",
@@ -28,13 +29,19 @@ function findExecutable(configured) {
     if (configured)
         return (0, node_fs_1.existsSync)((0, node_path_1.resolve)(configured)) ? (0, node_path_1.resolve)(configured) : undefined;
     const local = process.env.LOCALAPPDATA ?? (0, node_path_1.join)((0, node_os_1.homedir)(), "AppData", "Local");
-    return [(0, node_path_1.join)(local, "Programs", "WorkBuddy", "WorkBuddy.exe"), "D:\\Programs\\WorkBuddy\\WorkBuddy.exe"].find(node_fs_1.existsSync);
+    return [
+        (0, node_path_1.join)(local, "Programs", "WorkBuddy", "WorkBuddy.exe"),
+        (0, node_path_1.join)(local, "Programs", "WorkBuddyAI", "WorkBuddyAI.exe"),
+        "D:\\Programs\\WorkBuddy\\WorkBuddy.exe",
+        "D:\\Programs\\WorkBuddyAI\\WorkBuddyAI.exe",
+    ].find(node_fs_1.existsSync);
 }
 class WorkbuddyPlugin {
     options;
     manifest = exports.workbuddyManifest;
     client;
     process;
+    reconnect;
     cliPath;
     model;
     transport = "auto";
@@ -106,7 +113,7 @@ class WorkbuddyPlugin {
         const port = (0, plugin_1.resolveRuntimePort)(config, context.runtime, "workbuddy", "WORKBUDDY_CDP_PORT", this.options.cdpPort ?? 9229);
         this.client = this.options.client ?? new cdp_client_1.WorkbuddyCdpClient({ port });
         try {
-            await this.connectOrStart(config, context.logger, port);
+            await this.connectOrStart(config, context.logger, port, context.dataDir);
         }
         catch (error) {
             this.failure = error instanceof Error ? error.message : String(error);
@@ -125,10 +132,11 @@ class WorkbuddyPlugin {
     async deactivate(_reason) {
         await this.queue;
         await this.sessionWrites.catch(() => { });
+        await (0, desktop_launch_1.terminateOwnedProcess)(this.process).catch(() => undefined);
         this.client?.close();
         this.client = undefined;
-        // WorkBuddy 是用户桌面应用，插件停止时不结束桌面进程。
         this.process = undefined;
+        this.reconnect = undefined;
     }
     async health() {
         if (this.client?.connected())
@@ -165,6 +173,8 @@ class WorkbuddyPlugin {
             throw new Error("WorkBuddy 新会话缺少 sessionId");
         if (this.transport === "cli" || (this.transport !== "cdp" && this.cliPath) || !this.client?.createTask)
             throw new Error("WorkBuddy 当前传输不支持新建会话");
+        if (!this.client.connected())
+            await this.reconnect?.();
         if (!this.client.connected())
             throw new Error("WorkBuddy CDP 未连接");
         return this.enqueue(async () => {
@@ -181,6 +191,8 @@ class WorkbuddyPlugin {
         const hasAttachments = Array.isArray(request.attachments) && request.attachments.length > 0;
         if (hasAttachments && !this.attachmentInput)
             throw new Error("WorkBuddy 当前传输不支持附件输入");
+        if (!usesCli && !this.client?.connected())
+            await this.reconnect?.();
         const pendingInteractionSessionId = this.client?.pendingInteractionSessionId?.();
         if (!usesCli && pendingInteractionSessionId && pendingInteractionSessionId !== request.sessionId)
             throw new Error("WorkBuddy 正在等待另一个会话的选择");
@@ -303,7 +315,24 @@ class WorkbuddyPlugin {
         this.queue = run.then(() => { this.pending--; }, () => { this.pending--; });
         return run;
     }
-    async connectOrStart(config, logger, port) {
+    async connectOrStart(config, logger, port, dataDir) {
+        const executable = findExecutable(typeof config.executablePath === "string" ? config.executablePath : this.options.executablePath);
+        const profile = (0, node_path_1.join)(dataDir ?? (0, node_path_1.join)((0, node_os_1.homedir)(), ".agent-bridge", "workbuddy"), "desktop");
+        const launch = (file, args) => (0, desktop_launch_2.launchWorkbuddyDesktop)(file, args, profile, port);
+        const timeoutMs = typeof config.startupTimeoutMs === "number" ? config.startupTimeoutMs : 30_000;
+        this.reconnect = async () => {
+            try {
+                await this.client.connect();
+                return;
+            }
+            catch (first) {
+                if (config.autoStart === false || this.options.client || !executable)
+                    throw first;
+                await (0, desktop_launch_1.terminateOwnedProcess)(this.process);
+                this.process = undefined;
+                await (0, desktop_launch_1.launchManagedAndWait)(executable, [`--remote-debugging-port=${port}`], profile, () => this.client.connect(), timeoutMs, child => { this.process = child; }, launch);
+            }
+        };
         try {
             await this.client.connect();
             return;
@@ -311,25 +340,10 @@ class WorkbuddyPlugin {
         catch (first) {
             if (config.autoStart === false || this.options.client)
                 throw first;
-            const executable = findExecutable(typeof config.executablePath === "string" ? config.executablePath : this.options.executablePath);
             if (!executable)
                 throw new Error("未找到 WorkBuddy.exe，请配置 executablePath");
-            this.process = (0, node_child_process_1.spawn)(executable, [`--remote-debugging-port=${port}`], { detached: true, stdio: "ignore", windowsHide: false });
-            this.process.unref();
             logger.info(`WorkBuddy 已启动，等待 CDP ${port}`);
-            const deadline = Date.now() + (typeof config.startupTimeoutMs === "number" ? config.startupTimeoutMs : 30_000);
-            let last = first;
-            while (Date.now() < deadline) {
-                await new Promise((resolve) => setTimeout(resolve, 500));
-                try {
-                    await this.client.connect();
-                    return;
-                }
-                catch (error) {
-                    last = error;
-                }
-            }
-            throw last instanceof Error ? last : new Error("WorkBuddy CDP 启动超时");
+            await (0, desktop_launch_1.launchManagedAndWait)(executable, [`--remote-debugging-port=${port}`], profile, () => this.client.connect(), timeoutMs, child => { this.process = child; }, launch);
         }
     }
 }

package/dist/tests-ts/abweb-cli.test.js

@@ -0,0 +1,65 @@
+"use strict";
+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 promises_1 = require("node:fs/promises");
+const node_vm_1 = require("node:vm");
+const node_test_1 = __importDefault(require("node:test"));
+class Element {
+    hidden = false;
+    open = false;
+    value = "";
+    textContent = "";
+    children = [];
+    options = [];
+    selectedIndex = 0;
+    onclick;
+    onsubmit;
+    append(...children) { this.children.push(...children); }
+    replaceChildren(...children) { this.children = children; }
+    setAttribute() { }
+    showModal() { this.open = true; }
+    close() { this.open = false; }
+}
+(0, node_test_1.default)("abweb CLI 配置入口读取、保存配置且保留通道关联", async () => {
+    const nodes = new Map();
+    const node = (selector) => { if (!nodes.has(selector))
+        nodes.set(selector, new Element()); return nodes.get(selector); };
+    let saved;
+    (0, node_vm_1.runInNewContext)(await (0, promises_1.readFile)("src-ts/plugins/abweb/public/app.js", "utf8"), {
+        document: { querySelector: node, createElement: () => new Element(), hidden: false },
+        localStorage: { getItem: () => null, removeItem() { } }, window: { addEventListener() { } },
+        structuredClone, setInterval() { }, confirm: () => false,
+        fetch: async (path, options) => {
+            let data = {};
+            if (path === "/api/plugins")
+                data = { plugins: [{ id: "codex-cli", displayName: "Codex CLI", type: "agent", version: "1.0.0", status: "installed", path: "plugins/codex-cli", manifest: { executionMode: "cli" } }] };
+            if (path.endsWith("/config")) {
+                if (options.method === "PATCH")
+                    saved = JSON.parse(options.body);
+                data = { cwd: "/原目录", aid: "existing.agentid.cn" };
+            }
+            return { ok: true, status: 200, json: async () => data };
+        },
+    });
+    await new Promise(resolve => setImmediate(resolve));
+    const row = node("#plugins").children[0];
+    strict_1.default.match(row.children[1].textContent, /CLI/);
+    const configure = row.children.at(-1).children.find(child => child.textContent === "配置");
+    strict_1.default.ok(configure, "CLI 插件必须提供配置按钮");
+    await configure.onclick();
+    await new Promise(resolve => setImmediate(resolve));
+    strict_1.default.equal(node("#cli-config-cwd").value, "/原目录");
+    node("#cli-config-cwd").value = "/新目录";
+    node("#cli-config-executable").value = "/路径 空格/codex";
+    node("#cli-config-timeout").value = "240000";
+    node("#cli-config-form").onsubmit({ preventDefault() { } });
+    await new Promise(resolve => setImmediate(resolve));
+    strict_1.default.equal(saved.cwd, "/新目录");
+    strict_1.default.equal(saved.executablePath, "/路径 空格/codex");
+    strict_1.default.equal(saved.timeoutMs, 240000);
+    strict_1.default.equal(saved.aid, undefined, "通过 PATCH 合并配置，不能改写通道关联 AID");
+    strict_1.default.equal(node("#cli-config-dialog").open, false);
+});

package/dist/tests-ts/agent-availability.test.js

@@ -9,19 +9,33 @@ const node_os_1 = require("node:os");
 const node_path_1 = require("node:path");
 const node_test_1 = __importDefault(require("node:test"));
 const agent_availability_1 = require("../src-ts/agent-availability");
+const workbuddy_1 = require("../src-ts/plugins/workbuddy");
 (0, node_test_1.default)("办公 Agent 根据可执行文件和就绪状态决定是否可选", async () => {
     const dir = await (0, promises_1.mkdtemp)((0, node_path_1.join)((0, node_os_1.tmpdir)(), "office-agent-"));
+    const previousLocalAppData = process.env.LOCALAPPDATA;
     try {
         const file = (0, node_path_1.join)(dir, "WorkBuddy.exe");
+        const dshFile = (0, node_path_1.join)(dir, "DeepSeek Harness.exe");
         strict_1.default.deepEqual(await (0, agent_availability_1.agentAvailability)("workbuddy", { executablePath: file }, "ready"), { available: false, reason: "未找到可执行文件" });
         await (0, promises_1.writeFile)(file, "测试程序");
         strict_1.default.deepEqual(await (0, agent_availability_1.agentAvailability)("workbuddy", { executablePath: file }, "ready"), { available: true, reason: "" });
+        const workbuddyAi = (0, node_path_1.join)(dir, "Programs", "WorkBuddyAI", "WorkBuddyAI.exe");
+        await (0, promises_1.mkdir)((0, node_path_1.join)(dir, "Programs", "WorkBuddyAI"), { recursive: true });
+        await (0, promises_1.writeFile)(workbuddyAi, "测试程序");
+        process.env.LOCALAPPDATA = dir;
+        strict_1.default.equal((0, workbuddy_1.findExecutable)(), workbuddyAi);
         strict_1.default.equal((await (0, agent_availability_1.agentAvailability)("workbuddy", { executablePath: file }, "failed")).available, false);
         strict_1.default.equal((await (0, agent_availability_1.agentAvailability)("qwenwork", { executablePath: (0, node_path_1.join)(dir, "missing.exe") }, "ready")).available, false);
         strict_1.default.equal((await (0, agent_availability_1.agentAvailability)("doubao", { executablePath: file }, "ready")).available, true);
-        strict_1.default.equal((await (0, agent_availability_1.agentAvailability)("dsh", {}, "ready")).available, true);
+        strict_1.default.deepEqual(await (0, agent_availability_1.agentAvailability)("dsh", {}, "ready"), { available: false, reason: "未找到可执行文件" });
+        await (0, promises_1.writeFile)(dshFile, "测试程序");
+        strict_1.default.deepEqual(await (0, agent_availability_1.agentAvailability)("dsh", { executablePath: dshFile }, "ready"), { available: true, reason: "" });
     }
     finally {
+        if (previousLocalAppData === undefined)
+            delete process.env.LOCALAPPDATA;
+        else
+            process.env.LOCALAPPDATA = previousLocalAppData;
         await (0, promises_1.rm)(dir, { recursive: true, force: true });
     }
 });

package/dist/tests-ts/aun-default-owner-page.test.js

@@ -32,7 +32,7 @@ const flush = () => new Promise((resolve) => setImmediate(resolve));
             nodes.set(selector, new Element());
         return nodes.get(selector);
     };
-    for (const [selector, keys] of [["#create-form", ["aid", "ownerAid"]], ["#config-form", ["agent_plugin", "allow_from", "aun_path", "encryption_seed"]]]) {
+    for (const [selector, keys] of [["#create-form", ["aid", "ownerAid"]], ["#config-form", ["allow_from", "aun_path", "encryption_seed"]]]) {
         for (const key of keys)
             node(selector).elements[key] = new Element();
     }