@lanbaolu/dsh-wechat-bridge 0.1.0 → 0.2.0

package/lib/index.js

@@ -12,7 +12,7 @@
 import { createServer } from 'node:http';
 import { randomBytes } from 'node:crypto';
 import { spawn } from 'node:child_process';
-import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync, appendFileSync, unlinkSync, chmodSync } from 'node:fs';
+import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync, appendFileSync, statSync, unlinkSync, chmodSync } from 'node:fs';
 import { join, dirname, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { homedir } from 'node:os';
@@ -21,6 +21,7 @@ import { defineTool } from '@deepseek-ai/dsh-tools';
 import { SessionId } from '@deepseek-ai/dsh-session';
 import { createUserMessage } from '@deepseek-ai/dsh-llm';
 import { startQrLogin, checkQrStatus } from './bridge/wechat/login.js';
+import { loadJson, saveJson, validateAccountId } from './bridge/store.js';
 export const name = '@lanbaolu/dsh-wechat-bridge';
 /** Host services the plugin needs. `webServer` is optional (headless profiles). */
 export const inject = ['tools', 'agents', 'agentDefaultModel'];
@@ -28,7 +29,7 @@ export const Config = z.object({
     dataDir: z.string().default(''),
     host: z.string().default('127.0.0.1'),
     port: z.number().min(0).max(65535).default(0),
-    autoStart: z.boolean().default(false),
+    autoStart: z.boolean().default(true),
     provider: z.string().default(''),
     model: z.string().default(''),
     workingDirectory: z.string().default(''),
@@ -62,6 +63,8 @@ export function apply(ctx, config) {
     const activeSessionIds = new Set();
     const creating = new Map();
     const streamClients = new Map();
+    /** Accounts waiting to switch to a selected project after the current turn ends. */
+    const pendingProjectSwitches = new Set();
     let bridgeChild;
     let bridgeStartedAt;
     let internalServer;
@@ -96,6 +99,37 @@ export function apply(ctx, config) {
             saveSessionIdMap(map);
         }
     }
+    // -------------------------------------------------------------------------
+    // Explicit project-conversation binding (Web panel selection)
+    // -------------------------------------------------------------------------
+    const selectedSessionIdPath = join(dataDir, 'selected-sessions.json');
+    function loadSelectedSessionIds() {
+        try {
+            const raw = JSON.parse(readFileSync(selectedSessionIdPath, 'utf8'));
+            return raw && typeof raw === 'object' ? raw : {};
+        }
+        catch {
+            return {};
+        }
+    }
+    function saveSelectedSessionIds(map) {
+        mkdirSync(dataDir, { recursive: true });
+        writeFileSync(selectedSessionIdPath, JSON.stringify(map, null, 2) + '\n', 'utf8');
+    }
+    function persistSelectedSessionId(accountId, dshSessionId) {
+        validateAccountId(accountId);
+        const map = loadSelectedSessionIds();
+        map[accountId] = dshSessionId;
+        saveSelectedSessionIds(map);
+    }
+    function removeSelectedSessionId(accountId) {
+        const map = loadSelectedSessionIds();
+        if (accountId in map) {
+            delete map[accountId];
+            saveSelectedSessionIds(map);
+        }
+    }
+    const selectedSessionIds = new Map(Object.entries(loadSelectedSessionIds()));
     function newDshSessionId(accountId) {
         return `wb-${accountId}-${Date.now()}-${randomBytes(4).toString('hex')}`;
     }
@@ -103,6 +137,14 @@ export function apply(ctx, config) {
     // Agent management
     // -------------------------------------------------------------------------
     async function ensureAgent(accountId, input) {
+        // If the model just selected a project from inside a WeChat turn, finish
+        // tearing down the old bridge agent before accepting the next message.
+        if (pendingProjectSwitches.has(accountId)) {
+            pendingProjectSwitches.delete(accountId);
+            if (agents.has(accountId)) {
+                await disposeAgent(accountId, { preserveSelection: true });
+            }
+        }
         const existing = agents.get(accountId);
         if (existing)
             return existing;
@@ -121,14 +163,21 @@ export function apply(ctx, config) {
             };
             // Resume the persisted DSH session when possible; create a fresh one only
             // when there is no mapping, the old log is gone/corrupt, or the requested
-            // workspace differs from the persisted session's cwd.
+            // workspace differs from the persisted session's cwd (unless the user
+            // explicitly bound the bridge to a project conversation).
+            const selectedSessionId = selectedSessionIds.get(accountId);
             let dshSessionId = sessionIds.get(accountId);
             let handle;
             let resumed = false;
+            let isSelected = false;
+            let selectedCwd;
+            if (!dshSessionId)
+                dshSessionId = selectedSessionId;
             if (!dshSessionId) {
                 const sessionMap = loadSessionIdMap();
                 dshSessionId = sessionMap[accountId] || undefined;
             }
+            isSelected = !!selectedSessionId && dshSessionId === selectedSessionId;
             if (dshSessionId) {
                 try {
                     const candidate = await ctx.agents.resume({
@@ -136,7 +185,9 @@ export function apply(ctx, config) {
                         agentOptions,
                     });
                     const persistedCwd = candidate.agent.session.header.cwd;
-                    if (input?.cwd && persistedCwd && resolve(input.cwd) !== resolve(persistedCwd)) {
+                    selectedCwd = persistedCwd || undefined;
+                    const cwdMismatch = input?.cwd && persistedCwd && resolve(input.cwd) !== resolve(persistedCwd);
+                    if (cwdMismatch && !isSelected) {
                         debugLog('resume cwd mismatch, create new', {
                             accountId,
                             dshSessionId,
@@ -161,8 +212,17 @@ export function apply(ctx, config) {
                 }
             }
             if (!handle) {
+                if (isSelected) {
+                    debugLog('selected project session resume failed, clearing binding', {
+                        accountId,
+                        dshSessionId,
+                    });
+                    selectedSessionIds.delete(accountId);
+                    removeSelectedSessionId(accountId);
+                    isSelected = false;
+                }
                 dshSessionId = newDshSessionId(accountId);
-                debugLog('ensureAgent create', { accountId, dshSessionId, provider, model, selection, resumed: false });
+                debugLog('ensureAgent create', { accountId, dshSessionId, provider, model, selection, resumed: false, selected: false });
                 handle = await ctx.agents.create({
                     sessionId: SessionId(dshSessionId),
                     meta: input?.cwd ? { cwd: resolve(input.cwd) } : undefined,
@@ -170,16 +230,27 @@ export function apply(ctx, config) {
                 });
             }
             else {
-                debugLog('ensureAgent resume', { accountId, dshSessionId, provider, model, selection, resumed: true });
+                debugLog('ensureAgent resume', { accountId, dshSessionId, provider, model, selection, resumed: true, selected: isSelected });
             }
             const finalSessionId = dshSessionId;
             sessionIds.set(accountId, finalSessionId);
             persistSessionId(accountId, finalSessionId);
+            if (isSelected) {
+                persistSelectedSessionId(accountId, finalSessionId);
+            }
+            else if (selectedSessionIds.has(accountId)) {
+                selectedSessionIds.delete(accountId);
+                removeSelectedSessionId(accountId);
+            }
             agents.set(accountId, handle);
             activeSessionIds.add(finalSessionId);
-            debugLog('agent ready', { accountId, dshSessionId: finalSessionId, provider, model, selection, resumed });
-            if (input?.cwd)
+            debugLog('agent ready', { accountId, dshSessionId: finalSessionId, provider, model, selection, resumed, selected: isSelected });
+            if (isSelected && selectedCwd) {
+                await attachSessionToWorkspace(finalSessionId, selectedCwd);
+            }
+            else if (input?.cwd) {
                 await attachSessionToWorkspace(finalSessionId, resolve(input.cwd));
+            }
             return handle;
         })();
         creating.set(accountId, task);
@@ -190,7 +261,7 @@ export function apply(ctx, config) {
             creating.delete(accountId);
         }
     }
-    async function disposeAgent(accountId) {
+    async function disposeAgent(accountId, options) {
         const handle = agents.get(accountId);
         const dshSessionId = sessionIds.get(accountId);
         if (dshSessionId)
@@ -198,6 +269,10 @@ export function apply(ctx, config) {
         sessionIds.delete(accountId);
         agents.delete(accountId);
         removePersistedSessionId(accountId);
+        if (!options?.preserveSelection && selectedSessionIds.has(accountId)) {
+            selectedSessionIds.delete(accountId);
+            removeSelectedSessionId(accountId);
+        }
         if (handle)
             await handle.dispose();
         closeStreams(accountId);
@@ -223,6 +298,217 @@ export function apply(ctx, config) {
         }
     }
     // -------------------------------------------------------------------------
+    // Project conversation selection (Web panel)
+    // -------------------------------------------------------------------------
+    function latestAccountId() {
+        try {
+            const accountsDir = join(dataDir, 'accounts');
+            const files = readdirSync(accountsDir).filter((file) => file.endsWith('.json'));
+            if (files.length === 0)
+                return undefined;
+            let latestFile = files[0];
+            let latestMtime = 0;
+            for (const file of files) {
+                const stat = statSync(join(accountsDir, file));
+                if (stat.mtimeMs > latestMtime) {
+                    latestMtime = stat.mtimeMs;
+                    latestFile = file;
+                }
+            }
+            return latestFile.replace(/\.json$/, '');
+        }
+        catch {
+            return undefined;
+        }
+    }
+    async function listProjectSessions() {
+        const registry = ctx.get('workspaceRegistry');
+        if (!registry?.list)
+            return [];
+        const sessionsService = ctx.get('sessions');
+        const persistence = ctx.get('sessionPersistence');
+        const headerById = new Map();
+        const liveIds = new Set();
+        for (const session of sessionsService?.list() ?? []) {
+            const id = String(session.id ?? session.header.id);
+            if (!id)
+                continue;
+            liveIds.add(id);
+            headerById.set(id, {
+                cwd: session.header.cwd,
+                createdAt: session.header.createdAt,
+            });
+        }
+        if (persistence?.listSnapshots) {
+            try {
+                for (const snap of await persistence.listSnapshots()) {
+                    const id = String(snap.header.id);
+                    if (!id)
+                        continue;
+                    if (!headerById.has(id)) {
+                        headerById.set(id, {
+                            cwd: snap.header.cwd,
+                            createdAt: snap.header.createdAt,
+                        });
+                    }
+                }
+            }
+            catch (err) {
+                debugLog('listProjectSessions snapshots failed', { error: err instanceof Error ? err.message : String(err) });
+            }
+        }
+        const items = [];
+        for (const ws of registry.list()) {
+            for (const sid of ws.sessionIds) {
+                const sessionId = String(sid);
+                const header = headerById.get(sessionId);
+                items.push({
+                    sessionId,
+                    workspaceId: ws.id,
+                    workspaceTitle: ws.title,
+                    path: ws.path,
+                    cwd: header?.cwd || ws.path,
+                    createdAt: header?.createdAt || ws.createdAt,
+                    live: liveIds.has(sessionId),
+                });
+            }
+        }
+        return items;
+    }
+    async function selectedProjectPayload(accountId) {
+        const target = accountId || latestAccountId();
+        if (!target)
+            return null;
+        const selectedId = selectedSessionIds.get(target);
+        if (!selectedId)
+            return null;
+        const items = await listProjectSessions();
+        const item = items.find((candidate) => candidate.sessionId === selectedId);
+        if (!item)
+            return null;
+        return {
+            sessionId: selectedId,
+            workspaceId: item.workspaceId,
+            workspaceTitle: item.workspaceTitle,
+            path: item.path,
+        };
+    }
+    function accountIdForAgent(agent) {
+        if (!agent?.session?.id)
+            return undefined;
+        const sid = String(agent.session.id);
+        for (const [accountId, dshSessionId] of sessionIds) {
+            if (dshSessionId === sid)
+                return accountId;
+        }
+        return undefined;
+    }
+    async function selectProjectFromAgent(agent, sessionId) {
+        const accountId = accountIdForAgent(agent);
+        if (!accountId) {
+            return { ok: false, error: '当前不是微信桥接会话，无法切换项目。' };
+        }
+        const items = await listProjectSessions();
+        const item = items.find((candidate) => candidate.sessionId === sessionId);
+        if (!item) {
+            return { ok: false, error: '未找到该项目会话，请先使用 wechat_bridge_list_projects 查看可绑定项目。' };
+        }
+        const currentDshSessionId = sessionIds.get(accountId);
+        if (sessionId === currentDshSessionId) {
+            return {
+                ok: true,
+                accountId,
+                selectedSessionId: sessionId,
+                project: item,
+                message: `已经在项目 ${item.workspaceTitle} 中。`,
+            };
+        }
+        const sessionsService = ctx.get('sessions');
+        if (sessionsService?.get(SessionId(sessionId))) {
+            return { ok: false, error: '该项目会话当前正在 DSH 中打开，请先在 DSH 中关闭该会话后再进入。' };
+        }
+        selectedSessionIds.set(accountId, sessionId);
+        persistSelectedSessionId(accountId, sessionId);
+        resetBridgeAccountSession(accountId, item.path);
+        pendingProjectSwitches.add(accountId);
+        return {
+            ok: true,
+            accountId,
+            selectedSessionId: sessionId,
+            project: item,
+            message: `已进入项目 ${item.workspaceTitle}（${item.path}），后续对话会记录到这个项目。`,
+        };
+    }
+    function readBridgeAccountSession(accountId) {
+        validateAccountId(accountId);
+        return loadJson(join(dataDir, 'sessions', `${accountId}.json`), {});
+    }
+    function writeBridgeAccountSession(accountId, session) {
+        validateAccountId(accountId);
+        saveJson(join(dataDir, 'sessions', `${accountId}.json`), session);
+    }
+    function resetBridgeAccountSession(accountId, cwd) {
+        const session = readBridgeAccountSession(accountId);
+        session.workingDirectory = cwd;
+        session.state = 'idle';
+        session.chatHistory = [];
+        writeBridgeAccountSession(accountId, session);
+    }
+    async function selectProjectSession(dshSessionId, accountId) {
+        const target = accountId || latestAccountId();
+        if (!target)
+            return { ok: false, error: '没有已绑定的微信账号，请先扫码绑定。' };
+        const items = await listProjectSessions();
+        const item = items.find((candidate) => candidate.sessionId === dshSessionId);
+        if (!item)
+            return { ok: false, error: '指定的会话不存在或不属于任何项目。' };
+        // If the user is re-selecting the conversation the bridge already owns,
+        // treat it as a no-op instead of disposing the live agent.
+        const currentDshSessionId = sessionIds.get(target);
+        if (dshSessionId === currentDshSessionId) {
+            return {
+                ok: true,
+                accountId: target,
+                selectedSessionId: dshSessionId,
+                project: item,
+                daemon: '已经绑定到该项目会话。',
+            };
+        }
+        // A live DSH session can only be owned by one agent loop. If the selected
+        // conversation is currently open in the DSH UI, refuse before touching the
+        // current bridge agent instead of silently falling back on the next message.
+        const sessionsService = ctx.get('sessions');
+        if (sessionsService?.get(SessionId(dshSessionId))) {
+            return { ok: false, error: '该会话当前正在 DSH 中打开，请先在 DSH 中关闭该会话后再绑定。' };
+        }
+        // Drop the current bridge-owned agent so the next message resumes the
+        // selected project conversation instead of the previous bridge session.
+        if (agents.has(target) || sessionIds.has(target)) {
+            await disposeAgent(target);
+        }
+        selectedSessionIds.set(target, dshSessionId);
+        persistSelectedSessionId(target, dshSessionId);
+        resetBridgeAccountSession(target, item.path);
+        const daemonResult = daemonRunning() ? await restartDaemon() : { ok: true, message: '守护进程未运行，绑定将在下次启动时生效。' };
+        return {
+            ok: true,
+            accountId: target,
+            selectedSessionId: dshSessionId,
+            project: item,
+            daemon: daemonResult.message,
+        };
+    }
+    async function detachProjectSession(accountId) {
+        const target = accountId || latestAccountId();
+        if (!target)
+            return { ok: false, error: '没有已绑定的微信账号。' };
+        await disposeAgent(target);
+        const config = readBridgeConfig();
+        resetBridgeAccountSession(target, config.workingDirectory);
+        const daemonResult = daemonRunning() ? await restartDaemon() : { ok: true, message: '守护进程未运行，解除绑定将在下次启动时生效。' };
+        return { ok: true, accountId: target, daemon: daemonResult.message };
+    }
+    // -------------------------------------------------------------------------
     // SSE broadcast
     // -------------------------------------------------------------------------
     function broadcast(sessionId, event) {
@@ -274,6 +560,15 @@ export function apply(ctx, config) {
         else if (event.type === 'turn/end') {
             debugLog('session turn/end', { accountId, sessionId: sid, reason: event.data.reason });
             broadcast(accountId, { type: 'done', turn: event.data.turn, message: 'turn ended' });
+            if (pendingProjectSwitches.has(accountId)) {
+                pendingProjectSwitches.delete(accountId);
+                void disposeAgent(accountId, { preserveSelection: true }).catch((err) => {
+                    debugLog('pending project switch dispose failed', {
+                        accountId,
+                        error: err instanceof Error ? err.message : String(err),
+                    });
+                });
+            }
         }
     });
     // -------------------------------------------------------------------------
@@ -307,6 +602,22 @@ export function apply(ctx, config) {
                 sendJson(res, 200, await statusPayload());
                 return;
             }
+            if (req.method === 'GET' && url.pathname === '/api/projects') {
+                sendJson(res, 200, { ok: true, items: await listProjectSessions() });
+                return;
+            }
+            if (req.method === 'POST' && url.pathname === '/api/projects/select') {
+                const body = await readBody(req);
+                const sessionId = String(body.sessionId || '');
+                const result = await selectProjectSession(sessionId);
+                sendJson(res, result.ok ? 200 : 400, result);
+                return;
+            }
+            if (req.method === 'POST' && url.pathname === '/api/projects/detach') {
+                const result = await detachProjectSession();
+                sendJson(res, result.ok ? 200 : 400, result);
+                return;
+            }
             if (req.method === 'POST' && url.pathname === '/api/prompt') {
                 const body = await readBody(req);
                 const sessionId = String(body.sessionId || 'default');
@@ -551,11 +862,16 @@ export function apply(ctx, config) {
             config.workingDirectory = pendingSetup.workingDirectory;
             saveBridgeConfig(config);
             pendingSetup = undefined;
+            // A newly bound account only takes effect after the daemon reloads the
+            // latest account file. Restart when running, otherwise start it so the
+            // user does not have to manually restart after every re-scan.
+            const daemonResult = daemonRunning() ? await restartDaemon() : await startDaemon();
             return {
                 ok: true,
                 status: 'confirmed',
                 accountId: result.account.accountId,
                 workingDirectory: config.workingDirectory,
+                daemon: daemonResult.message,
             };
         }
         if (result.status === 'expired') {
@@ -604,6 +920,7 @@ export function apply(ctx, config) {
             workingDirectory: readBridgeConfig().workingDirectory,
             accounts: accountFiles,
             sessions: [...sessionIds.keys()],
+            selectedProject: await selectedProjectPayload(),
         };
     }
     // -------------------------------------------------------------------------
@@ -643,6 +960,52 @@ export function apply(ctx, config) {
                 res.end(readDaemonLogs(200));
             },
         }));
+        disposers.push(webServer.register({
+            kind: 'exact',
+            path: '/@lanbaolu/dsh-wechat-bridge/projects',
+            handler: async (_req, res) => {
+                const result = await listProjectSessions();
+                res.writeHead(200, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ ok: true, items: result }));
+            },
+        }));
+        disposers.push(webServer.register({
+            kind: 'exact',
+            path: '/@lanbaolu/dsh-wechat-bridge/projects/select',
+            handler: async (req, res) => {
+                try {
+                    const body = await readBody(req);
+                    const sessionId = typeof body.sessionId === 'string' ? body.sessionId : '';
+                    const accountId = typeof body.accountId === 'string' && body.accountId ? body.accountId : undefined;
+                    const result = await selectProjectSession(sessionId, accountId);
+                    res.writeHead(result.ok ? 200 : 400, { 'Content-Type': 'application/json' });
+                    res.end(JSON.stringify(result));
+                }
+                catch (err) {
+                    const message = err instanceof Error ? err.message : String(err);
+                    res.writeHead(400, { 'Content-Type': 'application/json' });
+                    res.end(JSON.stringify({ ok: false, error: message }));
+                }
+            },
+        }));
+        disposers.push(webServer.register({
+            kind: 'exact',
+            path: '/@lanbaolu/dsh-wechat-bridge/projects/detach',
+            handler: async (req, res) => {
+                try {
+                    const body = await readBody(req).catch(() => ({}));
+                    const accountId = body && typeof body.accountId === 'string' && body.accountId ? body.accountId : undefined;
+                    const result = await detachProjectSession(accountId);
+                    res.writeHead(result.ok ? 200 : 400, { 'Content-Type': 'application/json' });
+                    res.end(JSON.stringify(result));
+                }
+                catch (err) {
+                    const message = err instanceof Error ? err.message : String(err);
+                    res.writeHead(400, { 'Content-Type': 'application/json' });
+                    res.end(JSON.stringify({ ok: false, error: message }));
+                }
+            },
+        }));
         disposers.push(webServer.register({
             kind: 'exact',
             path: '/@lanbaolu/dsh-wechat-bridge/setup/start',
@@ -704,6 +1067,72 @@ export function apply(ctx, config) {
                 };
             },
         }));
+        ctx.tools.register(defineTool({
+            name: 'wechat_bridge_list_projects',
+            description: '列出 DSH 中可进入/可绑定的项目会话（含项目名、路径、会话 ID）。当用户询问“有哪些项目”“看看我有什么项目”“我要看下项目”“我在哪个项目”“想继续某个项目”“有个任务想做”等意图，或用户描述内容可能对应某个项目时，都应调用此工具查看项目，不要要求用户使用固定句式。',
+            parameters: {},
+            output: {
+                schema: {
+                    type: 'object',
+                    additionalProperties: false,
+                    properties: {
+                        ok: { type: 'boolean', required: true },
+                        message: { type: 'string', required: true },
+                        projects: {
+                            type: 'array',
+                            required: true,
+                            items: {
+                                type: 'object',
+                                additionalProperties: false,
+                                properties: {
+                                    sessionId: { type: 'string', required: true },
+                                    workspaceTitle: { type: 'string', required: true },
+                                    path: { type: 'string', required: true },
+                                    live: { type: 'boolean', required: true },
+                                },
+                            },
+                        },
+                    },
+                },
+                render: (_args, value) => [{
+                        type: 'text',
+                        text: value.projects.length === 0
+                            ? '当前没有可绑定的项目会话。'
+                            : `📁 可进入的项目会话（${value.projects.length} 个）：\n` + value.projects.map((p, i) => `${i + 1}. ${p.workspaceTitle} · ${p.path} · ${p.sessionId.slice(-8)}`).join('\n'),
+                    }],
+            },
+            execute: async () => {
+                const items = await listProjectSessions();
+                return {
+                    ok: true,
+                    message: `共 ${items.length} 个项目会话`,
+                    projects: items.map((item) => ({
+                        sessionId: item.sessionId,
+                        workspaceTitle: item.workspaceTitle,
+                        path: item.path,
+                        live: item.live,
+                    })),
+                };
+            },
+        }));
+        ctx.tools.register(defineTool({
+            name: 'wechat_bridge_select_project',
+            description: '进入一个 DSH 项目会话。微信桥接会话中，模型应先调用 wechat_bridge_list_projects 获取 sessionId，再调用本工具切换到对应项目；切换后后续微信对话会记录到该项目。支持用户自然语言模糊指代，例如“进入某某项目”“去这个项目”“继续在 XXX 里做”“我现在要做 XXX”等，模型应根据上下文/项目列表选择对应 sessionId。',
+            parameters: {
+                sessionId: { type: 'string', description: '要进入的项目会话 ID，来自 wechat_bridge_list_projects 返回的 sessionId。' },
+            },
+            output: simpleOutput,
+            execute: async (args, exec) => {
+                const result = await selectProjectFromAgent(exec?.agent, args.sessionId);
+                if (!result.ok) {
+                    throw new Error(String(result.error || '进入项目失败'));
+                }
+                return {
+                    ok: true,
+                    message: String(result.message || '已进入项目。'),
+                };
+            },
+        }));
         ctx.tools.register(defineTool({
             name: 'wechat_bridge_start',
             description: '启动 DSH 微信桥接守护进程。需要先完成微信扫码绑定（wechat_bridge_setup 或 node lib/bridge/main.js setup）。',
@@ -804,7 +1233,24 @@ export function apply(ctx, config) {
         internalServer = server;
         registerTools();
         const webDisposers = registerWebRoutes();
+        // Watchdog: after sleep/wake or an unexpected daemon exit, automatically
+        // bring the bridge back instead of requiring the user to click Start.
+        let healthTimer;
+        if (config.autoStart) {
+            healthTimer = setInterval(() => {
+                if (daemonRunning())
+                    return;
+                startDaemon().then(result => {
+                    ctx.logger?.info?.('[dsh-wechat-bridge] watchdog auto-start', result);
+                }).catch(err => {
+                    ctx.logger?.warn?.('[dsh-wechat-bridge] watchdog auto-start failed', { error: String(err) });
+                });
+            }, 15_000);
+            healthTimer.unref?.();
+        }
         return () => {
+            if (healthTimer)
+                clearInterval(healthTimer);
             for (const dispose of webDisposers)
                 dispose();
             for (const handle of agents.values()) {