qq-codex-bridge 0.1.0 → 0.1.2

package/dist/apps/bridge-daemon/src/bootstrap.js

@@ -14,6 +14,7 @@ import { SqliteTranscriptStore } from "../../../packages/store/src/message-repo.
 import { SqliteSessionStore } from "../../../packages/store/src/session-repo.js";
 import { createSqliteDatabase } from "../../../packages/store/src/sqlite.js";
 import { loadConfigFromEnv } from "./config.js";
+const INTERNAL_TURN_EVENT_PATH = "/internal/codex-turn-events";
 export function bootstrap() {
     const config = loadConfigFromEnv(process.env);
     const db = createSqliteDatabase(config.databasePath);
@@ -74,7 +75,16 @@ export function bootstrap() {
                             replyToMessageId: message.messageId
                         })));
                     }
-                    : undefined
+                    : undefined,
+                onTurnEvent: async (event) => {
+                    await postTurnEvent(config.runtime.listenPort, {
+                        ...event,
+                        payload: {
+                            ...event.payload,
+                            replyToMessageId: message.messageId
+                        }
+                    });
+                }
             });
             return drafts.map((draft) => formatQqOutboundDraft(enrichQqOutboundDraft({
                 ...draft,
@@ -98,3 +108,22 @@ export function bootstrap() {
         qqGatewaySessionStore
     };
 }
+async function postTurnEvent(port, event) {
+    try {
+        await fetch(`http://127.0.0.1:${port}${INTERNAL_TURN_EVENT_PATH}`, {
+            method: "POST",
+            headers: {
+                "content-type": "application/json"
+            },
+            body: JSON.stringify(event)
+        });
+    }
+    catch (error) {
+        console.warn("[qq-codex-bridge] turn event callback failed", {
+            turnId: event.turnId,
+            sessionKey: event.sessionKey,
+            error: error instanceof Error ? error.message : String(error)
+        });
+    }
+}
+export { INTERNAL_TURN_EVENT_PATH };

package/dist/apps/bridge-daemon/src/http-server.js

@@ -1,11 +1,31 @@
 import { createServer } from "node:http";
 export function createQqWebhookServer(deps) {
+    return createJsonServer({
+        routePath: deps.webhookPath,
+        dispatchPayload: deps.ingress.dispatchPayload,
+        onDispatchError: deps.onDispatchError
+    });
+}
+export function createInternalTurnEventServer(deps) {
+    return createJsonServer({
+        routePath: deps.routePath,
+        dispatchPayload: deps.ingress.dispatchTurnEvent,
+        onDispatchError: deps.onDispatchError,
+        allowOnlyLocal: true
+    });
+}
+function createJsonServer(deps) {
     return createServer(async (request, response) => {
-        if (request.url !== deps.webhookPath) {
+        if (request.url !== deps.routePath) {
             response.statusCode = 404;
             response.end("not found");
             return;
         }
+        if (deps.allowOnlyLocal && !isLocalRequest(request)) {
+            response.statusCode = 403;
+            response.end("forbidden");
+            return;
+        }
         if (request.method !== "POST") {
             response.statusCode = 405;
             response.end("method not allowed");
@@ -25,7 +45,7 @@ export function createQqWebhookServer(deps) {
             return;
         }
         Promise.resolve()
-            .then(() => deps.ingress.dispatchPayload(payload))
+            .then(() => deps.dispatchPayload(payload))
             .catch((error) => {
             const normalized = error instanceof Error ? error : new Error(typeof error === "string" ? error : "dispatch failed");
             deps.onDispatchError?.(normalized, payload);
@@ -34,3 +54,10 @@ export function createQqWebhookServer(deps) {
         response.end("accepted");
     });
 }
+function isLocalRequest(request) {
+    const address = request.socket.remoteAddress;
+    if (!address) {
+        return false;
+    }
+    return address === "127.0.0.1" || address === "::1" || address === "::ffff:127.0.0.1";
+}

package/dist/apps/bridge-daemon/src/main.js

@@ -1,5 +1,6 @@
 import { pathToFileURL } from "node:url";
-import { bootstrap } from "./bootstrap.js";
+import { bootstrap, INTERNAL_TURN_EVENT_PATH } from "./bootstrap.js";
+import { createInternalTurnEventServer } from "./http-server.js";
 import { ThreadCommandHandler } from "./thread-command-handler.js";
 export function createIngressMessageHandler(deps) {
     return async (message) => {
@@ -24,12 +25,33 @@ export function createIngressMessageHandler(deps) {
 }
 export async function runBridgeDaemon() {
     const app = bootstrap();
+    const internalTurnEventServer = createInternalTurnEventServer({
+        routePath: INTERNAL_TURN_EVENT_PATH,
+        ingress: {
+            dispatchTurnEvent: async (payload) => {
+                await app.orchestrator.handleTurnEvent(payload);
+            }
+        },
+        onDispatchError: (error, payload) => {
+            console.warn("[qq-codex-bridge] internal turn event dispatch failed", {
+                error: error.message,
+                payload
+            });
+        }
+    });
     const threadCommandHandler = new ThreadCommandHandler({
         sessionStore: app.sessionStore,
         transcriptStore: app.transcriptStore,
         desktopDriver: app.adapters.codexDesktop,
         qqEgress: app.adapters.qq.egress
     });
+    await new Promise((resolve, reject) => {
+        internalTurnEventServer.once("error", reject);
+        internalTurnEventServer.listen(app.config.runtime.listenPort, "127.0.0.1", () => {
+            internalTurnEventServer.off("error", reject);
+            resolve();
+        });
+    });
     await app.adapters.qq.ingress.onMessage(createIngressMessageHandler({
         threadCommandHandler,
         orchestrator: app.orchestrator
@@ -37,7 +59,8 @@ export async function runBridgeDaemon() {
     await app.adapters.qq.ingress.start();
     console.log("[qq-codex-bridge] ready", {
         transport: "qq-gateway-websocket",
-        accountKey: "qqbot:default"
+        accountKey: "qqbot:default",
+        internalTurnEventPath: INTERNAL_TURN_EVENT_PATH
     });
 }
 function handleFatal(error) {

package/dist/apps/bridge-daemon/src/thread-command-handler.js

@@ -46,6 +46,34 @@ export class ThreadCommandHandler {
                 await this.deliverControlReply(message, this.buildHelpText());
                 return;
             }
+            if (text === "/h") {
+                await this.deliverControlReply(message, this.buildHelpText());
+                return;
+            }
+            if (text === "/model" || text === "/m") {
+                const state = await this.deps.desktopDriver.getControlState();
+                await this.deliverControlReply(message, this.formatModelReply(state));
+                return;
+            }
+            const switchModelMatch = text.match(/^(?:\/model\s+use|\/mu)\s+(.+)$/);
+            if (switchModelMatch) {
+                const targetModel = switchModelMatch[1].trim();
+                const state = await this.deps.desktopDriver.switchModel(targetModel);
+                await this.deliverControlReply(message, this.formatModelSwitchReply(targetModel, state));
+                return;
+            }
+            if (text === "/quota" || text === "/q") {
+                const quotaSummary = await this.deps.desktopDriver.getQuotaSummary();
+                await this.deliverControlReply(message, this.formatQuotaReply(quotaSummary));
+                return;
+            }
+            if (text === "/status" || text === "/st") {
+                const session = await this.deps.sessionStore.getSession(message.sessionKey);
+                const state = await this.deps.desktopDriver.getControlState();
+                const quotaSummary = await this.deps.desktopDriver.getQuotaSummary();
+                await this.deliverControlReply(message, this.formatStatusReply(session, state, quotaSummary));
+                return;
+            }
             const useMatch = text.match(/^(?:\/thread\s+use|\/tu)\s+(\d+)$/);
             if (useMatch) {
                 const index = Number(useMatch[1]);
@@ -117,8 +145,17 @@ export class ThreadCommandHandler {
             text === "/thread current" ||
             text === "/tc" ||
             text === "/help" ||
+            text === "/h" ||
+            text === "/model" ||
+            text === "/m" ||
+            text === "/quota" ||
+            text === "/q" ||
+            text === "/status" ||
+            text === "/st" ||
             /^\/thread\s+use\s+\d+$/.test(text) ||
             /^\/tu\s+\d+$/.test(text) ||
+            /^\/model\s+use\s+.+$/.test(text) ||
+            /^\/mu\s+.+$/.test(text) ||
             /^\/thread\s+new\s+.+$/.test(text) ||
             /^\/tn\s+.+$/.test(text) ||
             /^\/thread\s+fork\s+.+$/.test(text) ||
@@ -136,7 +173,7 @@ export class ThreadCommandHandler {
             "| 序号 | 项目 | 线程标题 | 最近活动 |",
             "| --- | --- | --- | --- |",
             ...threads.map((thread) => {
-                const index = thread.isCurrent ? `→ ${thread.index}` : `${thread.index}`;
+                const index = thread.isCurrent ? `👉🏻 ${thread.index}` : `${thread.index}`;
                 const project = escapeCell(thread.projectName) || "-";
                 const title = escapeCell(thread.title) || "-";
                 const time = escapeCell(thread.relativeTime) || "-";
@@ -157,7 +194,7 @@ export class ThreadCommandHandler {
     }
     buildHelpText() {
         return [
-            "线程管理命令：",
+            "快捷命令：",
             "",
             "| 用途 | 完整命令 | 简写 |",
             "| --- | --- | --- |",
@@ -166,8 +203,44 @@ export class ThreadCommandHandler {
             "| 切换到指定线程 | `/thread use <序号>` | `/tu <序号>` |",
             "| 新建线程 | `/thread new <标题>` | `/tn <标题>` |",
             "| 基于最近对话 fork 线程 | `/thread fork <标题>` | `/tf <标题>` |",
+            "| 查看当前模型 | `/model` | `/m` |",
+            "| 切换模型 | `/model use <名称>` | `/mu <名称>` |",
+            "| 查看额度信息 | `/quota` | `/q` |",
+            "| 查看当前运行状态 | `/status` | `/st` |",
+            "| 查看帮助 | `/help` | `/h` |",
             "",
-            "建议先发 `/t` 看列表，再用 `/tu 2` 这种方式切换。"
+            "建议先发 `/t` 看列表，再用 `/tu 2` 这种方式切换。",
+            "模型和额度信息来自当前 Codex Desktop 界面，可见性取决于 UI 是否暴露对应信息。"
+        ].join("\n");
+    }
+    formatModelReply(state) {
+        return [
+            `当前模型：${state.model ?? "未识别"}`,
+            `推理强度：${state.reasoningEffort ?? "未识别"}`,
+            `工作区：${state.workspace ?? "未识别"}`,
+            `分支：${state.branch ?? "未识别"}`
+        ].join("\n");
+    }
+    formatModelSwitchReply(targetModel, state) {
+        return [
+            `已切换模型：${state.model ?? targetModel}`,
+            `推理强度：${state.reasoningEffort ?? "未识别"}`,
+            `工作区：${state.workspace ?? "未识别"}`
+        ].join("\n");
+    }
+    formatQuotaReply(quotaSummary) {
+        return `额度信息：${quotaSummary ?? "当前界面未显示明确额度，暂未识别到剩余配额。"}`;
+    }
+    formatStatusReply(session, state, quotaSummary) {
+        return [
+            "当前运行状态：",
+            `线程绑定：${session?.codexThreadRef ?? "未绑定"}`,
+            `模型：${state.model ?? "未识别"}`,
+            `推理强度：${state.reasoningEffort ?? "未识别"}`,
+            `工作区：${state.workspace ?? "未识别"}`,
+            `分支：${state.branch ?? "未识别"}`,
+            `权限：${state.permissionMode ?? "未识别"}`,
+            `额度：${quotaSummary ?? "当前界面未显示明确额度，暂未识别到剩余配额。"}`
         ].join("\n");
     }
     buildNewThreadSeedPrompt(title) {

package/dist/packages/adapters/codex-desktop/src/codex-desktop-driver.js

@@ -1,6 +1,6 @@
 import { randomUUID } from "node:crypto";
 import { DesktopDriverError } from "../../../domain/src/driver.js";
-import { MediaArtifactKind } from "../../../domain/src/message.js";
+import { MediaArtifactKind, TurnEventType } from "../../../domain/src/message.js";
 import { isLikelyComposerSubmitButton } from "./composer-heuristics.js";
 import { parseAssistantReply } from "./reply-parser.js";
 const TARGET_REF_PREFIX = "cdp-target:";
@@ -33,6 +33,32 @@ export class CodexDesktopDriver {
             throw new DesktopDriverError("Codex desktop app is not exposing any inspectable page target", "app_not_ready");
         }
     }
+    async getControlState() {
+        const pageTarget = await this.resolvePageTarget();
+        const state = (await this.cdp.evaluateOnPage(this.buildReadControlStateScript(), pageTarget.id));
+        return (state ?? {
+            model: null,
+            reasoningEffort: null,
+            workspace: null,
+            branch: null,
+            permissionMode: null,
+            quotaSummary: null
+        });
+    }
+    async getQuotaSummary() {
+        const pageTarget = await this.resolvePageTarget();
+        const quotaSummary = (await this.cdp.evaluateOnPage(this.buildReadQuotaSummaryScript(), pageTarget.id));
+        return quotaSummary ?? null;
+    }
+    async switchModel(model) {
+        const pageTarget = await this.resolvePageTarget();
+        const result = (await this.cdp.evaluateOnPage(this.buildSwitchModelScript(model), pageTarget.id));
+        if (!result?.ok) {
+            throw new DesktopDriverError(`Codex desktop model switch failed: ${result?.reason ?? "unknown"}`, "control_not_found");
+        }
+        await this.sleep(300);
+        return this.getControlState();
+    }
     async openOrBindSession(sessionKey, binding) {
         const pageTarget = await this.resolvePageTarget();
         const pageId = pageTarget.id;
@@ -183,6 +209,23 @@ export class CodexDesktopDriver {
         let stablePolls = 0;
         let emittedReplyText = "";
         const emittedMediaReferences = new Set();
+        const turnId = randomUUID();
+        let turnSequence = 0;
+        const emitTurnEvent = async (eventType, payload, isFinal) => {
+            if (!options.onTurnEvent) {
+                return;
+            }
+            turnSequence += 1;
+            await options.onTurnEvent({
+                sessionKey: binding.sessionKey,
+                turnId,
+                sequence: turnSequence,
+                eventType,
+                createdAt: new Date().toISOString(),
+                isFinal,
+                payload
+            });
+        };
         for (let attempt = 0; attempt < this.maxReplyPollAttempts; attempt += 1) {
             const reply = await this.readLatestAssistantSnapshot(targetId);
             const hasReplyText = typeof reply.reply === "string" && reply.reply.trim() !== "";
@@ -203,23 +246,46 @@ export class CodexDesktopDriver {
                     !reply.isStreaming &&
                     stablePolls >= this.replyStablePolls) {
                     this.pendingReplyBaselines.delete(binding.sessionKey);
+                    const finalPayload = {
+                        fullText: candidateReply.reply ?? "",
+                        mediaReferences: candidateReply.mediaReferences
+                    };
                     if (options.onDraft) {
-                        const finalDeltaDraft = this.buildIncrementalDraftFromSnapshot(binding.sessionKey, candidateReply, emittedReplyText, emittedMediaReferences);
+                        const finalDeltaDraft = this.buildIncrementalDraftFromSnapshot(binding.sessionKey, candidateReply, emittedReplyText, emittedMediaReferences, turnId);
                         if (finalDeltaDraft) {
+                            await emitTurnEvent(TurnEventType.Delta, {
+                                text: finalDeltaDraft.text,
+                                fullText: candidateReply.reply ?? "",
+                                mediaReferences: candidateReply.mediaReferences
+                            }, false);
                             emittedReplyText = this.mergeObservedReply(emittedReplyText, candidateReply.reply ?? "");
                             this.mergeObservedMediaReferences(emittedMediaReferences, candidateReply.mediaReferences);
                             await options.onDraft(finalDeltaDraft);
                         }
+                        await emitTurnEvent(TurnEventType.Completed, {
+                            ...finalPayload,
+                            completionReason: "stable"
+                        }, true);
                         return [];
                     }
-                    return [this.buildOutboundDraftFromSnapshot(binding.sessionKey, candidateReply)];
+                    await emitTurnEvent(TurnEventType.Delta, finalPayload, false);
+                    await emitTurnEvent(TurnEventType.Completed, {
+                        ...finalPayload,
+                        completionReason: "stable"
+                    }, true);
+                    return [this.buildOutboundDraftFromSnapshot(binding.sessionKey, candidateReply, turnId)];
                 }
                 if (options.onDraft &&
                     candidateReply &&
                     this.hasAssistantContent(candidateReply) &&
                     stablePolls >= this.partialReplyStablePolls) {
-                    const deltaDraft = this.buildIncrementalDraftFromSnapshot(binding.sessionKey, candidateReply, emittedReplyText, emittedMediaReferences);
+                    const deltaDraft = this.buildIncrementalDraftFromSnapshot(binding.sessionKey, candidateReply, emittedReplyText, emittedMediaReferences, turnId);
                     if (deltaDraft) {
+                        await emitTurnEvent(TurnEventType.Delta, {
+                            text: deltaDraft.text,
+                            fullText: candidateReply.reply ?? "",
+                            mediaReferences: candidateReply.mediaReferences
+                        }, false);
                         emittedReplyText = this.mergeObservedReply(emittedReplyText, candidateReply.reply ?? "");
                         this.mergeObservedMediaReferences(emittedMediaReferences, candidateReply.mediaReferences);
                         await options.onDraft(deltaDraft);
@@ -237,19 +303,39 @@ export class CodexDesktopDriver {
         this.pendingReplyBaselines.delete(binding.sessionKey);
         if (latestNewReply && this.hasAssistantContent(latestNewReply)) {
             if (options.onDraft) {
-                const timeoutDraft = this.buildIncrementalDraftFromSnapshot(binding.sessionKey, latestNewReply, emittedReplyText, emittedMediaReferences);
+                const timeoutDraft = this.buildIncrementalDraftFromSnapshot(binding.sessionKey, latestNewReply, emittedReplyText, emittedMediaReferences, turnId);
                 if (timeoutDraft) {
+                    await emitTurnEvent(TurnEventType.Delta, {
+                        text: timeoutDraft.text,
+                        fullText: latestNewReply.reply ?? "",
+                        mediaReferences: latestNewReply.mediaReferences
+                    }, false);
                     await options.onDraft(timeoutDraft);
                 }
+                await emitTurnEvent(TurnEventType.Completed, {
+                    fullText: latestNewReply.reply ?? "",
+                    mediaReferences: latestNewReply.mediaReferences,
+                    completionReason: "timeout_flush"
+                }, true);
                 return [];
             }
-            return [this.buildOutboundDraftFromSnapshot(binding.sessionKey, latestNewReply)];
+            await emitTurnEvent(TurnEventType.Delta, {
+                fullText: latestNewReply.reply ?? "",
+                mediaReferences: latestNewReply.mediaReferences
+            }, false);
+            await emitTurnEvent(TurnEventType.Completed, {
+                fullText: latestNewReply.reply ?? "",
+                mediaReferences: latestNewReply.mediaReferences,
+                completionReason: "timeout_flush"
+            }, true);
+            return [this.buildOutboundDraftFromSnapshot(binding.sessionKey, latestNewReply, turnId)];
         }
         throw new DesktopDriverError("Codex desktop reply did not arrive before timeout", "reply_timeout");
     }
-    buildOutboundDraftFromSnapshot(sessionKey, snapshot) {
+    buildOutboundDraftFromSnapshot(sessionKey, snapshot, turnId) {
         return {
             draftId: randomUUID(),
+            ...(turnId ? { turnId } : {}),
             sessionKey,
             text: snapshot.reply ?? "",
             ...(snapshot.mediaReferences.length > 0
@@ -260,7 +346,7 @@ export class CodexDesktopDriver {
             createdAt: new Date().toISOString()
         };
     }
-    buildIncrementalDraftFromSnapshot(sessionKey, snapshot, emittedReplyText, emittedMediaReferences) {
+    buildIncrementalDraftFromSnapshot(sessionKey, snapshot, emittedReplyText, emittedMediaReferences, turnId) {
         const fullReply = snapshot.reply ?? "";
         const deltaText = this.extractReplyDelta(emittedReplyText, fullReply).trim();
         const incrementalMediaReferences = snapshot.mediaReferences.filter((reference) => !emittedMediaReferences.has(reference));
@@ -269,6 +355,7 @@ export class CodexDesktopDriver {
         }
         return {
             draftId: randomUUID(),
+            ...(turnId ? { turnId } : {}),
             sessionKey,
             text: deltaText,
             ...(incrementalMediaReferences.length > 0
@@ -874,6 +961,269 @@ export class CodexDesktopDriver {
       };
     })();`;
     }
+    buildReadControlStateScript() {
+        return `
+      (() => {
+        const normalize = (value) => (value || '').replace(/\\s+/g, ' ').trim();
+        const buttons = Array.from(document.querySelectorAll('button,[role="button"],[aria-label]'))
+          .map((node) => {
+            const rect = node instanceof HTMLElement ? node.getBoundingClientRect() : null;
+            return {
+              text: normalize(node.textContent || ''),
+              aria: normalize(node.getAttribute('aria-label') || ''),
+              title: normalize(node.getAttribute('title') || ''),
+              className: String(node.className || ''),
+              x: rect ? rect.x : 0,
+              y: rect ? rect.y : 0,
+              width: rect ? rect.width : 0,
+              height: rect ? rect.height : 0
+            };
+          })
+          .filter((item) => (item.text || item.aria || item.title) && item.y >= window.innerHeight - 180 && item.x >= 320)
+          .sort((left, right) => (left.y - right.y) || (left.x - right.x));
+
+        const modelPattern = /(?:gpt|o1|o3|o4|4\\.1|4\\.5|5\\.4|mini|nano|sonnet|haiku|opus|gemini|claude|qwen|deepseek)/i;
+        const effortPattern = /^(?:低|中|高|minimal|low|medium|high)$/i;
+        const permissionPattern = /(?:访问权限|permission|sandbox)/i;
+        const quotaPattern = /(?:quota|usage|remaining|allowance|credit|credits|余额|额度|剩余|配额|使用量)/i;
+        const ignoredQuotaPattern = /(?:QQBOT_RUNTIME_CONTEXT|<qqmedia>|<!--|-->|会话类型|bridge|runtime\\/media|内部实现|相对路径)/i;
+
+        let model = null;
+        let reasoningEffort = null;
+        let workspace = null;
+        let branch = null;
+        let permissionMode = null;
+
+        for (const item of buttons) {
+          const text = item.text || item.aria || item.title;
+          if (!model && modelPattern.test(text)) {
+            model = text;
+            continue;
+          }
+          if (!reasoningEffort && effortPattern.test(text)) {
+            reasoningEffort = text;
+            continue;
+          }
+          if (!permissionMode && permissionPattern.test(text)) {
+            permissionMode = text;
+            continue;
+          }
+          if (!workspace && /^(?:本地|local|worktree)$/i.test(text)) {
+            workspace = text;
+            continue;
+          }
+          if (!branch && /[\\w.-]+\\/[\\w./-]+/.test(text)) {
+            branch = text;
+          }
+        }
+
+        const bodyLines = (document.body ? document.body.innerText : '')
+          .split('\\n')
+          .map((line) => normalize(line))
+          .filter(Boolean);
+        const quotaLine =
+          bodyLines.find((line) => quotaPattern.test(line) && !ignoredQuotaPattern.test(line)) || null;
+
+        return {
+          model,
+          reasoningEffort,
+          workspace,
+          branch,
+          permissionMode,
+          quotaSummary: quotaLine
+        };
+      })()
+    `;
+    }
+    buildReadQuotaSummaryScript() {
+        return `
+      (() => {
+        const normalize = (value) =>
+          (value || '')
+            .replace(/[\\u200B-\\u200D\\uFEFF]/g, '')
+            .replace(/\\s+/g, ' ')
+            .trim();
+        const clickNode = (node) => {
+          node.dispatchEvent(new MouseEvent('pointerdown', { bubbles: true }));
+          node.dispatchEvent(new MouseEvent('mousedown', { bubbles: true }));
+          node.dispatchEvent(new MouseEvent('mouseup', { bubbles: true }));
+          node.dispatchEvent(new MouseEvent('click', { bubbles: true }));
+        };
+        const collectControls = () =>
+          Array.from(document.querySelectorAll('button,[role="button"],[role="menuitem"],[role="option"],[aria-label]'));
+        const getText = (node) =>
+          normalize(node.textContent || node.getAttribute('aria-label') || node.getAttribute('title') || '');
+        const isQuotaHeader = (line) => line === '剩余额度' || /^remaining usage$/i.test(line);
+        const parseQuotaEntries = (lines) => {
+          const entries = [];
+          for (let index = 0; index < lines.length; index += 1) {
+            const line = lines[index];
+            if (
+              !line ||
+              isQuotaHeader(line) ||
+              /^\\d+%$/.test(line) ||
+              /^(?:继续使用|本地项目|云端|升级至\\s*Pro|了解更多|移至工作树)$/i.test(line)
+            ) {
+              continue;
+            }
+
+            const combinedMatch = line.match(/^(.+?(?:分钟|小时|天|周|月|minutes?|hours?|days?|weeks?|months?))\\s+(\\d+%)\\s+(.+)$/i);
+            if (combinedMatch) {
+              entries.push(\`\${combinedMatch[1]} \${combinedMatch[2]}（\${combinedMatch[3]} 重置）\`);
+              continue;
+            }
+
+            const timeframeMatch = line.match(/^(.+?(?:分钟|小时|天|周|月|minutes?|hours?|days?|weeks?|months?))$/i);
+            if (timeframeMatch && index + 2 < lines.length) {
+              const percentLine = lines[index + 1];
+              const resetLine = lines[index + 2];
+              if (/^\\d+%$/.test(percentLine) && resetLine) {
+                entries.push(\`\${timeframeMatch[1]} \${percentLine}（\${resetLine} 重置）\`);
+                index += 2;
+                continue;
+              }
+            }
+          }
+
+          return entries;
+        };
+
+        const findModeButton = () =>
+          collectControls().find((node) => {
+            if (!(node instanceof HTMLElement)) {
+              return false;
+            }
+            const text = getText(node);
+            const rect = node.getBoundingClientRect();
+            return (
+              rect.y >= window.innerHeight - 120 &&
+              rect.height <= 40 &&
+              rect.width <= 120 &&
+              /^(?:本地|云端|local|cloud)(?:\\d+%)?$/i.test(text)
+            );
+          });
+
+        const modeButton = findModeButton();
+        if (!modeButton) {
+          return null;
+        }
+
+        const readVisibleQuotaSummary = () => {
+          const lines = (document.body ? document.body.innerText : '')
+            .split('\\n')
+            .map((line) => normalize(line))
+            .filter(Boolean);
+          const quotaIndex = lines.findIndex((line) => isQuotaHeader(line));
+          if (quotaIndex < 0) {
+            return null;
+          }
+
+          const quotaBlock = lines.slice(quotaIndex, quotaIndex + 10);
+          const entries = parseQuotaEntries(quotaBlock);
+          return entries.length > 0 ? entries.join('\\n') : null;
+        };
+
+        const ensureQuotaVisible = () =>
+          new Promise((resolve) => {
+            let attempts = 0;
+            let openedMenu = false;
+            let expandedQuota = false;
+            const tick = () => {
+              attempts += 1;
+              const summary = readVisibleQuotaSummary();
+              if (summary) {
+                resolve(summary);
+                return;
+              }
+
+              if (!openedMenu) {
+                clickNode(modeButton);
+                openedMenu = true;
+              }
+
+              const quotaToggle = collectControls().find((node) => /剩余额度|remaining usage/i.test(getText(node)));
+              if (quotaToggle && !expandedQuota) {
+                clickNode(quotaToggle);
+                expandedQuota = true;
+              }
+
+              if (attempts >= 8) {
+                resolve(null);
+                return;
+              }
+
+              setTimeout(tick, 80);
+            };
+
+            tick();
+          });
+
+        return ensureQuotaVisible();
+      })()
+    `;
+    }
+    buildSwitchModelScript(targetModel) {
+        return `
+      (() => {
+        const normalize = (value) => (value || '').replace(/\\s+/g, ' ').trim().toLowerCase();
+        const target = ${JSON.stringify(targetModel)}.trim();
+        const targetNormalized = normalize(target);
+        const matchesModelText = (text) => /(?:gpt|o1|o3|o4|4\\.1|4\\.5|5\\.4|mini|nano|sonnet|haiku|opus|gemini|claude|qwen|deepseek)/i.test(text);
+        const collectControls = () =>
+          Array.from(document.querySelectorAll('button,[role="button"],[role="menuitem"],[role="option"],[aria-label]'));
+        const findModelButton = () =>
+          collectControls().find((node) => {
+            if (!(node instanceof HTMLElement)) {
+              return false;
+            }
+            const rect = node.getBoundingClientRect();
+            const text = (node.textContent || '').replace(/\\s+/g, ' ').trim();
+            return rect.y >= window.innerHeight - 180 && rect.x >= 320 && matchesModelText(text);
+          });
+        const clickNode = (node) => {
+          node.dispatchEvent(new MouseEvent('pointerdown', { bubbles: true }));
+          node.dispatchEvent(new MouseEvent('mousedown', { bubbles: true }));
+          node.dispatchEvent(new MouseEvent('mouseup', { bubbles: true }));
+          node.dispatchEvent(new MouseEvent('click', { bubbles: true }));
+        };
+        const modelButton = findModelButton();
+        if (!modelButton) {
+          return { ok: false, reason: 'model_button_not_found' };
+        }
+        clickNode(modelButton);
+
+        return new Promise((resolve) => {
+          let attempts = 0;
+          const tick = () => {
+            attempts += 1;
+            const option = collectControls().find((node) => {
+              const text = (node.textContent || '').replace(/\\s+/g, ' ').trim();
+              if (!text) {
+                return false;
+              }
+              const normalized = normalize(text);
+              return normalized === targetNormalized || normalized.includes(targetNormalized);
+            });
+
+            if (option) {
+              clickNode(option);
+              resolve({ ok: true });
+              return;
+            }
+
+            if (attempts >= 20) {
+              resolve({ ok: false, reason: 'model_option_not_found' });
+              return;
+            }
+
+            setTimeout(tick, 50);
+          };
+
+          tick();
+        });
+      })()
+    `;
+    }
     buildAssistantReplyProbeScript() {
         return `(() => {
       const assistantUnits = Array.from(

package/dist/packages/domain/src/message.js

@@ -5,3 +5,9 @@ export var MediaArtifactKind;
     MediaArtifactKind["Video"] = "video";
     MediaArtifactKind["File"] = "file";
 })(MediaArtifactKind || (MediaArtifactKind = {}));
+export var TurnEventType;
+(function (TurnEventType) {
+    TurnEventType["Delta"] = "turn.delta";
+    TurnEventType["Status"] = "turn.status";
+    TurnEventType["Completed"] = "turn.completed";
+})(TurnEventType || (TurnEventType = {}));

package/dist/packages/orchestrator/src/bridge-orchestrator.js

@@ -1,8 +1,12 @@
+import { randomUUID } from "node:crypto";
 import { BridgeSessionStatus } from "../../domain/src/session.js";
+import { TurnEventType } from "../../domain/src/message.js";
 import { DesktopDriverError } from "../../domain/src/driver.js";
+import { formatQqOutboundDraft } from "./qq-outbound-format.js";
 export class BridgeOrchestrator {
     deps;
     recentInboundFingerprints = new Map();
+    turnStates = new Map();
     constructor(deps) {
         this.deps = deps;
     }
@@ -53,6 +57,7 @@ export class BridgeOrchestrator {
                     await this.deps.transcriptStore.recordOutbound(draft);
                     try {
                         await this.deps.qqEgress.deliver(draft);
+                        this.recordDeliveredDraft(draft);
                     }
                     catch (error) {
                         const reason = error instanceof Error ? error.message : String(error);
@@ -89,6 +94,52 @@ export class BridgeOrchestrator {
             }
         });
     }
+    async handleTurnEvent(event) {
+        await this.deps.sessionStore.withSessionLock(event.sessionKey, async () => {
+            const state = this.getOrCreateTurnState(event);
+            if (event.sequence <= state.lastSequence) {
+                return;
+            }
+            state.lastSequence = event.sequence;
+            state.lastEventAt = event.createdAt;
+            if (typeof event.payload.fullText === "string") {
+                state.assembledText = event.payload.fullText;
+            }
+            else if (typeof event.payload.text === "string" && event.payload.text.length > 0) {
+                state.assembledText += event.payload.text;
+            }
+            if (event.eventType !== TurnEventType.Completed) {
+                return;
+            }
+            const pendingText = computePendingTurnText(state.sentText, state.assembledText);
+            if (!pendingText) {
+                state.completed = true;
+                state.finalFlushed = true;
+                return;
+            }
+            const draft = formatQqOutboundDraft({
+                draftId: randomUUID(),
+                turnId: event.turnId,
+                sessionKey: event.sessionKey,
+                text: pendingText,
+                createdAt: event.createdAt,
+                ...(event.payload.replyToMessageId
+                    ? { replyToMessageId: event.payload.replyToMessageId }
+                    : {})
+            });
+            if (!draft.text.trim()) {
+                state.sentText = state.assembledText;
+                state.completed = true;
+                state.finalFlushed = true;
+                return;
+            }
+            await this.deps.transcriptStore.recordOutbound(draft);
+            await this.deps.qqEgress.deliver(draft);
+            state.sentText = state.assembledText;
+            state.completed = true;
+            state.finalFlushed = true;
+        });
+    }
     isLikelyDuplicateInbound(message) {
         const record = this.recentInboundFingerprints.get(message.sessionKey);
         if (!record) {
@@ -119,6 +170,39 @@ export class BridgeOrchestrator {
             messageId: message.messageId
         });
     }
+    getOrCreateTurnState(event) {
+        const key = buildTurnStateKey(event.sessionKey, event.turnId);
+        const existing = this.turnStates.get(key);
+        if (existing) {
+            return existing;
+        }
+        const created = {
+            lastSequence: 0,
+            assembledText: "",
+            sentText: "",
+            lastEventAt: null,
+            completed: false,
+            finalFlushed: false
+        };
+        this.turnStates.set(key, created);
+        return created;
+    }
+    recordDeliveredDraft(draft) {
+        if (!draft.turnId || !draft.text) {
+            return;
+        }
+        const key = buildTurnStateKey(draft.sessionKey, draft.turnId);
+        const state = this.turnStates.get(key) ?? {
+            lastSequence: 0,
+            assembledText: "",
+            sentText: "",
+            lastEventAt: null,
+            completed: false,
+            finalFlushed: false
+        };
+        state.sentText += draft.text;
+        this.turnStates.set(key, state);
+    }
 }
 function isRecoverableTurnError(error) {
     return error instanceof DesktopDriverError && error.reason === "reply_timeout";
@@ -141,3 +225,37 @@ function buildInboundFingerprint(message) {
         mediaFingerprint
     ].join("||");
 }
+function buildTurnStateKey(sessionKey, turnId) {
+    return `${sessionKey}::${turnId}`;
+}
+function computePendingTurnText(sentText, fullText) {
+    if (!fullText) {
+        return "";
+    }
+    if (!sentText) {
+        return fullText;
+    }
+    if (fullText.startsWith(sentText)) {
+        return fullText.slice(sentText.length);
+    }
+    if (stripWhitespace(fullText) === stripWhitespace(sentText)) {
+        return "";
+    }
+    const overlap = findSuffixPrefixOverlap(sentText, fullText);
+    if (overlap > 0) {
+        return fullText.slice(overlap);
+    }
+    return fullText;
+}
+function findSuffixPrefixOverlap(previous, next) {
+    const maxLength = Math.min(previous.length, next.length);
+    for (let length = maxLength; length > 0; length -= 1) {
+        if (previous.slice(-length) === next.slice(0, length)) {
+            return length;
+        }
+    }
+    return 0;
+}
+function stripWhitespace(value) {
+    return value.replace(/\s+/g, "");
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qq-codex-bridge",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "A bridge between QQ Official Bot and Codex Desktop, with media relay, STT, thread management, and incremental reply delivery.",
   "type": "module",
   "homepage": "https://github.com/983033995/qq-codex-bridge",