botmux 2.53.0 → 2.55.0

package/dist/cli.js

@@ -26,7 +26,7 @@ import { createInterface } from 'node:readline';
 import { createRequire } from 'node:module';
 import { createHmac, randomBytes } from 'node:crypto';
 import { validateWorkingDir } from './core/working-dir.js';
-import { parseDispatchBotSpec, buildDispatchMessages, buildRepoPrimeText, buildReportContent, eligibleAutoMentionAliases, offTopicSubBotTopic, resolveReportTarget } from './core/dispatch.js';
+import { parseDispatchBotSpec, buildDispatchMessages, buildRepoPrimeText, buildReportContent, eligibleAutoMentionAliases, offTopicSubBotTopic, resolveReportTarget, resolveSendTarget } from './core/dispatch.js';
 import { enableAutostart, disableAutostart, autostartStatus, refreshAutostart } from './autostart.js';
 import { tmuxEnv } from './setup/ensure-tmux.js';
 import { writeBotsJsonAtomic as writeBotsAtomic } from './setup/bots-store.js';
@@ -621,7 +621,7 @@ async function promptBotConfig(rl) {
         return null;
     }
     console.log('✅ 凭证有效（tenant_access_token 已成功获取）\n');
-    console.log('支持的 CLI: 1) claude-code  2) aiden  3) coco  4) codex  5) cursor  6) gemini  7) opencode  8) antigravity  9) mtr  10) hermes  11) codex-app  12) mira  13) seed');
+    console.log('支持的 CLI: 1) claude-code  2) aiden  3) coco（别名 traecli）  4) codex  5) cursor  6) gemini  7) opencode  8) antigravity  9) mtr  10) hermes  11) codex-app  12) mira  13) seed');
     const cliChoice = await ask(rl, 'CLI 适配器 [1]: ');
     let cliId;
     try {
@@ -711,9 +711,10 @@ async function promptEditBotConfig(rl, bot) {
         '留空保留当前值。',
     ]);
     input.larkAppSecret = await ask(rl, `LARK_APP_SECRET [保留当前值]: `);
-    console.log('\n支持的 CLI: 1) claude-code  2) aiden  3) coco  4) codex  5) cursor  6) gemini  7) opencode  8) antigravity  9) mtr  10) hermes  11) codex-app  12) mira  13) seed');
+    console.log('\n支持的 CLI: 1) claude-code  2) aiden  3) coco（别名 traecli）  4) codex  5) cursor  6) gemini  7) opencode  8) antigravity  9) mtr  10) hermes  11) codex-app  12) mira  13) seed');
     printInputHelp('CLI 适配器', [
         '选择 botmux 需要套用哪一种 CLI 参数协议和会话恢复方式。',
+        'coco 的别名 traecli 走同一适配器；二进制名是 traecli 也选 coco 即可。',
         '留空保留当前值；可以输入序号，也可以直接输入适配器 ID。',
     ]);
     input.cliChoice = await ask(rl, `CLI 适配器 [${bot.cliId ?? 'claude-code'}]: `);
@@ -1510,6 +1511,9 @@ function loadSessions() {
     return sessions;
 }
 /** Save a single session back to its appropriate file based on larkAppId. */
+function loadSessionFresh(session) {
+    return loadSessions().get(session.sessionId);
+}
 function saveSession(session) {
     const dataDir = resolveDataDir();
     const fileName = session.larkAppId ? `sessions-${session.larkAppId}.json` : 'sessions.json';
@@ -1522,7 +1526,7 @@ function saveSession(session) {
         }
         catch { /* start fresh */ }
     }
-    data[session.sessionId] = session;
+    data[session.sessionId] = mergePendingResponseState(session, data[session.sessionId]);
     // Clean up entries where file key doesn't match the entry's sessionId (data corruption)
     for (const [key, val] of Object.entries(data)) {
         if (val && typeof val === 'object' && 'sessionId' in val && val.sessionId !== key) {
@@ -2168,6 +2172,9 @@ botmux v${getVersion()} — IM ↔ AI 编程 CLI 桥接
   lang [zh|en]         切换 UI 语言（无参 = 查看当前设置）
        --bot N         仅改 bots.json 中第 N 个 bot 的 lang
        --unset         清除（global 或 --bot N 配合）
+  voice                配置语音总结（高级功能，独立于 setup）— 交互式填 TTS 引擎+凭证
+       voice status    查看当前语音配置（凭证打码）
+       voice disable   关闭语音功能（移除配置）
 
 定时任务（可在 CLI 会话内自动推断 chat）:
   schedule list                        列出所有任务
@@ -2185,7 +2192,7 @@ botmux v${getVersion()} — IM ↔ AI 编程 CLI 桥接
        --no-mention                    明确声明本条不@任何人
        --quote <message_id>            指定引用某条消息（普通群，默认引用本轮触发消息）
        --no-quote                      不引用，发独立消息（普通群）
-       --card | --text                 强制卡片 / 纯文本（默认按 md 语法自动判断）
+       --voice "<口语文字>"            合成语音气泡发出（需先 botmux voice 配置 TTS）
        --top-level                     发顶层消息（不回复进当前话题）
        --chat-id <oc_xxx>              指定目标群（默认当前话题所在群）
        --anyway                        跳过「@ 到活跃子 bot」护栏强发（见下）
@@ -2637,7 +2644,8 @@ function argValues(args, ...flags) {
 // Card v2 body builder helpers — extracted to im/lark/md-card.ts so the
 // daemon's bridge fallback path can produce identical cards. cmdSend
 // keeps using `buildCardBodyElements` and `hasMarkdown` from there.
-import { buildCardBodyElements, hasMarkdown, brandFooterSegment } from './im/lark/md-card.js';
+import { buildCardBodyElements, brandFooterSegment } from './im/lark/md-card.js';
+import { claimPendingResponseCard, markPendingResponseCardPatchedIfCurrent, mergePendingResponseState } from './core/pending-response.js';
 import { resolveBrandLabel } from './bot-registry.js';
 import { config } from './config.js';
 import { resolveQuoteTarget, validateMentionDecision } from './services/send-policy.js';
@@ -2661,14 +2669,22 @@ async function cmdSend(rest) {
     const files = argValues(rest, '--file', '--files');
     const mentionArgs = argValues(rest, '--mention'); // "open_id:Display Name"
     const contentFile = argValue(rest, '--content-file');
-    const forceCard = rest.includes('--card');
-    const forceText = rest.includes('--text');
+    // 回复一律走交互卡片。`--card` / `--text` 仅为向后兼容被容忍并忽略：纯文本 post
+    // 路径已删除——只有卡片能承载「🔊 语音总结」按钮，且守护进程兜底也一直只发卡片。
     // Publish-mode flags: post a fresh top-level message in a chat instead of
     // replying into the bound thread. Lets a session "publish" to a different
     // chat (e.g. a public release-notes group) while keeping its own thread
     // for streaming-card / progress UI.
     const sendTopLevel = rest.includes('--top-level');
     const overrideChatId = argValue(rest, '--chat-id');
+    // --into <话题根id>: reply this send into a specific topic (a sub-bot's topic,
+    // another thread, etc.) instead of the session's own location. Wins over the
+    // auto/scope default; `dispatch` opens topics, `send --into` posts into them.
+    const sendInto = argValue(rest, '--into');
+    // --voice: synthesize the content into a Feishu voice bubble instead of a
+    // text/card message. The content should be spoken-style prose (the 🔊 button
+    // injects a condense-first instruction before the model calls this).
+    const asVoice = rest.includes('--voice');
     // Quote chain (chat scope): --quote <message_id> overrides the auto target,
     // --no-quote forces a plain (un-quoted) send.
     const explicitQuote = argValue(rest, '--quote');
@@ -2701,7 +2717,7 @@ async function cmdSend(rest) {
         content = readFileSync(contentFile, 'utf-8');
     }
     else {
-        const pos = positionals(rest, ['--card', '--text', '--top-level', '--no-quote', '--mention-back', '--no-mention', '--anyway']);
+        const pos = positionals(rest, ['--card', '--text', '--top-level', '--no-quote', '--mention-back', '--no-mention', '--anyway', '--voice']);
         if (pos.length > 0) {
             content = pos.join(' ');
         }
@@ -2713,6 +2729,70 @@ async function cmdSend(rest) {
         console.error('没有内容可发送。用法:\n  echo "消息" | botmux send\n  botmux send "消息"\n  botmux send --content-file /tmp/msg.md --images /tmp/chart.png');
         process.exit(1);
     }
+    // ── Voice mode ──────────────────────────────────────────────────────────
+    // Synthesize the (already-condensed, colloquial) content into a Feishu voice
+    // bubble and return. Deliberately bypasses the text/card path's mentions,
+    // footer, and @-hard-gate — a voice bubble addresses nobody. Lands in the
+    // same thread/chat the session would normally reply to.
+    if (asVoice) {
+        if (!content.trim()) {
+            console.error('--voice 需要要朗读的文字');
+            process.exit(1);
+        }
+        const { registerBot, loadBotConfigs } = await import('./bot-registry.js');
+        try {
+            for (const cfg of loadBotConfigs())
+                registerBot(cfg);
+        }
+        catch { /* */ }
+        const { uploadFile, sendMessage, replyMessage } = await import('./im/lark/client.js');
+        const { synthesizeVoiceOpus } = await import('./services/voice/index.js');
+        const { rmSync } = await import('node:fs');
+        const appId = s.larkAppId;
+        const targetChatId = overrideChatId ?? s.chatId;
+        const target = resolveSendTarget({ into: sendInto, topLevel: sendTopLevel, chatScope: s.scope === 'chat', chatId: targetChatId, rootMessageId: s.rootMessageId });
+        const sendAudio = (fileKey) => target.mode === 'plain'
+            ? sendMessage(appId, target.chatId, JSON.stringify({ file_key: fileKey }), 'audio')
+            : replyMessage(appId, target.root, JSON.stringify({ file_key: fileKey }), 'audio', true);
+        let dir;
+        try {
+            const out = await synthesizeVoiceOpus(appId, content);
+            dir = out.dir;
+            const fileKey = await uploadFile(appId, out.path, { duration: out.durationMs });
+            const sentAtMs = Date.now();
+            const messageId = await sendAudio(fileKey);
+            // 语音也是一次回复：写 bridge fallback marker，否则本轮会被判为"没发 botmux send"
+            // 而触发兜底，多补一张文本卡。与文本/卡片路径同口径：仅同话题回复才记。
+            if (!sendTopLevel && !overrideChatId && !sendInto) {
+                try {
+                    const markerDir = join(resolveDataDir(), 'turn-sends');
+                    if (!existsSync(markerDir))
+                        mkdirSync(markerDir, { recursive: true });
+                    appendFileSync(join(markerDir, `${sid}.jsonl`), JSON.stringify({ sentAtMs, messageId }) + '\n');
+                }
+                catch { /* best-effort：漏记只多一条兜底，不致命 */ }
+            }
+            console.error(`✓ 已发送语音 ${messageId} ｜ ${Math.round(out.durationMs / 1000)}s`);
+            console.log(JSON.stringify({ success: true, messageId, sessionId: sid, kind: 'voice', durationMs: out.durationMs }));
+        }
+        catch (e) {
+            console.error(`语音发送失败：${e?.message ?? e}`);
+            if (dir) {
+                try {
+                    rmSync(dir, { recursive: true, force: true });
+                }
+                catch { /* */ }
+            }
+            process.exit(1);
+        }
+        if (dir) {
+            try {
+                rmSync(dir, { recursive: true, force: true });
+            }
+            catch { /* */ }
+        }
+        return;
+    }
     // Parse mentions: "open_id:Display Name" or bare "open_id"
     // Bare form appends a trailing <at id=...> to the message and still writes
     // a bot-mention signal — useful when the sender doesn't know the target's
@@ -2763,7 +2843,7 @@ async function cmdSend(rest) {
             registerBot(cfg);
     }
     catch { /* */ }
-    const { sendMessage, replyMessage, uploadImage, uploadFile, MessageWithdrawnError } = await import('./im/lark/client.js');
+    const { sendMessage, replyMessage, uploadImage, uploadFile, deleteMessage, MessageWithdrawnError } = await import('./im/lark/client.js');
     const appId = s.larkAppId;
     // Effective target chat for top-level mode (defaults to session's chat)
     const targetChatId = overrideChatId ?? s.chatId;
@@ -2799,17 +2879,15 @@ async function cmdSend(rest) {
     // Explicit --mention / --mention-back of an off-topic sub-bot → block + point to
     // the right command (--anyway overrides). Prose @Name injection is filtered
     // (dropped, not blocked) at its own site below.
-    if (!rest.includes('--anyway')) {
-        for (const m of mentions) {
-            const seed = offTopicSubBotSeed(m.open_id);
-            if (seed) {
-                console.error(`⚠️ ${m.open_id}${m.name ? `（${m.name}）` : ''} 是 botmux dispatch 派进子话题 ${seed} 的子 bot——\n` +
-                    `它的会话在那条子话题里：在主群 @ 它收不到，反而会另起一个无上下文的新会话。\n` +
-                    `要跟它说，把消息发进它的子话题：\n` +
-                    `  botmux dispatch --into ${seed} --bot ${m.open_id} --brief "..."\n` +
-                    `（确属新会话/有意为之，加 --anyway 强发。）`);
-                process.exit(2);
-            }
+    // Inform, don't block: if @-ing a bot whose session lives in a sub-topic, this
+    // send lands a NEW conversation at the current location. To reply into that
+    // topic instead, use `--into <seed>`. The model picks the destination — no hard
+    // block (that was too aggressive; @-ing a bot in the group to start a fresh
+    // conversation is a legitimate, common intent).
+    for (const m of mentions) {
+        const seed = offTopicSubBotSeed(m.open_id);
+        if (seed) {
+            console.error(`ℹ️ ${m.open_id}${m.name ? `（${m.name}）` : ''} 在子话题 ${seed} 里也有会话；本条发到当前位置（新对话）。要发进那个话题改用 --into ${seed}。`);
         }
     }
     // Oncall addressing only meaningful for replies inside the session's own
@@ -2817,17 +2895,40 @@ async function cmdSend(rest) {
     // oncall as chat-level: in multi-daemon setups this session's bot may not
     // be the one that persisted the binding, but users still expect footer
     // addressing to go to the last caller in the shared oncall workspace.
-    const oncallEntry = !sendTopLevel && !overrideChatId && s.chatId
+    const oncallEntry = !sendTopLevel && !overrideChatId && !sendInto && s.chatId
         ? findOncallChatForAnyBot(s.chatId) : undefined;
     // Dispatch helper: top-level / chat-scope send vs reply-in-thread, single
     // decision point. Used for file attachments (always plain in chat scope).
-    const dispatch = (content, msgType) => (sendTopLevel || isChatScope)
-        ? sendMessage(appId, targetChatId, content, msgType)
-        : replyMessage(appId, s.rootMessageId, content, msgType, true);
+    const sendTarget = resolveSendTarget({ into: sendInto, topLevel: sendTopLevel, chatScope: isChatScope, chatId: targetChatId, rootMessageId: s.rootMessageId });
+    const dispatch = (content, msgType) => sendTarget.mode === 'plain'
+        ? sendMessage(appId, sendTarget.chatId, content, msgType)
+        : replyMessage(appId, sendTarget.root, content, msgType, true);
+    const recordBridgeSendMarker = (sentAtMs, messageId) => {
+        try {
+            const markerDir = join(resolveDataDir(), 'turn-sends');
+            if (!existsSync(markerDir))
+                mkdirSync(markerDir, { recursive: true });
+            const line = JSON.stringify({ sentAtMs, messageId }) + '\n';
+            appendFileSync(join(markerDir, `${sid}.jsonl`), line);
+        }
+        catch { /* best-effort: marker miss only causes a redundant fallback message */ }
+    };
+    const shouldRecordBridgeMarker = !sendTopLevel && !overrideChatId && !sendInto;
+    const dispatchOrPatchPending = async (content, msgType) => {
+        const pendingCardId = msgType === 'interactive' ? claimPendingResponseCard(s) : undefined;
+        const sentId = await dispatchPrimary(content, msgType);
+        const latest = pendingCardId ? loadSessionFresh(s) : undefined;
+        if (pendingCardId && latest?.pendingResponseCardId === pendingCardId) {
+            deleteMessage(appId, pendingCardId)
+                .then(() => { markPendingResponseCardPatchedIfCurrent(latest, pendingCardId); saveSession(latest); })
+                .catch((err) => logger.warn(`[send:${sid.substring(0, 8)}] failed to withdraw pending card after explicit send: ${err?.message ?? err}`));
+        }
+        return sentId;
+    };
     // Quote chain (普通群): the primary message replies to the turn's target so
     // Lark renders a 引用 chain. --quote overrides, --no-quote opts out. Thread
     // scope and --top-level never quote. Withdrawn target → fall back to plain.
-    const quoteTargetId = resolveQuoteTarget({
+    const quoteTargetId = sendInto ? undefined : resolveQuoteTarget({
         isChatScope, sendTopLevel, noQuote, explicitQuote,
         sessionQuoteTargetId: s.quoteTargetId,
     });
@@ -2953,16 +3054,9 @@ async function cmdSend(rest) {
                         }
                         if (alreadyMentioned.has(senderScopedId))
                             break;
-                        // Footgun guard at the auto-injection source: don't turn a prose
-                        // `@OtherSubBot` into a real @ for a dispatched sub-bot that's off-topic
-                        // here — that would spawn a context-less session in the main chat (the
-                        // explicit guard above only saw --mention/--mention-back). Drop the
-                        // injection (don't block the whole send); --anyway forces it through.
-                        const injOffSeed = rest.includes('--anyway') ? null : offTopicSubBotSeed(senderScopedId);
-                        if (injOffSeed) {
-                            console.error(`[botmux send] 跳过正文 @${entry.botName} 自动注入：它是 dispatch 派进子话题 ${injOffSeed} 的子 bot、不在本会话——避免在主群另起无上下文会话（要强发加 --anyway）。`);
-                            break;
-                        }
+                        // Prose `@OtherBot` auto-injection: inject normally. (The off-topic
+                        // sub-bot guard used to DROP this; we now let the model @ freely and
+                        // pick the destination with --into instead of being silently dropped.)
                         mentions.push({ open_id: senderScopedId, name: entry.botName });
                         alreadyMentioned.add(senderScopedId);
                         break;
@@ -2983,9 +3077,6 @@ async function cmdSend(rest) {
                 hasExplicitBotMention: explicitKnownBotMention,
                 knownBotOpenIds,
             });
-        // Decide: interactive card (renders markdown) vs. post (plain text).
-        // Explicit --card / --text wins; otherwise auto-detect markdown syntax.
-        const useCard = forceCard || (!forceText && hasMarkdown(text));
         const mentionMap = new Map();
         for (const m of mentions)
             if (m.name)
@@ -3002,7 +3093,8 @@ async function cmdSend(rest) {
         // we committed to sending — that's the boundary the gate cares about.
         const sentAtMs = Date.now();
         let messageId;
-        if (useCard) {
+        {
+            // 回复一律卡片（纯文本 post 路径已删）。
             // Inline @mention → <at id=open_id></at>; explicit --mention args that
             // weren't inlined are appended to the body. The session owner is
             // rendered in the footer note instead of the body.
@@ -3065,87 +3157,71 @@ async function cmdSend(rest) {
             if (footerRecipients.length > 0) {
                 footerParts.push(`发送给：${footerRecipients.map(id => `<at id=${id}></at>`).join(' ')}`);
             }
-            // Empty brand + no recipients → no footer at all (skip the orphan HR).
-            if (footerParts.length > 0) {
+            // Footer line (brand 个性签名 + 发送给) and the optional 🔊 语音总结 button
+            // share ONE row: footer text on the left (weighted, fills), button pinned
+            // to the far right (auto width). When voice isn't configured the footer
+            // renders alone, as before. Button only on a reply (not --top-level).
+            // v2 cards put buttons inside column_set/column — never the 1.x
+            // `tag:'action'` container (Feishu rejects it, error 200861).
+            let voiceOn = false;
+            if (!sendTopLevel) {
+                try {
+                    const { isVoiceConfigured } = await import('./services/voice/index.js');
+                    voiceOn = isVoiceConfigured(appId);
+                }
+                catch { /* voice module/config unavailable → no button */ }
+            }
+            const footerContent = footerParts.length > 0
+                ? `<font color='grey'>${footerParts.join(' · ')}</font>`
+                : '';
+            if (footerContent || voiceOn) {
                 elements.push({ tag: 'hr' });
-                elements.push({
-                    tag: 'markdown',
-                    text_size: 'notation_small_v2',
-                    content: `<font color='grey'>${footerParts.join(' · ')}</font>`,
-                });
+                if (voiceOn) {
+                    const anchorId = (isChatScope ? s.chatId : s.rootMessageId) ?? s.chatId;
+                    elements.push({
+                        tag: 'column_set',
+                        flex_mode: 'none',
+                        horizontal_spacing: 'default',
+                        columns: [
+                            {
+                                tag: 'column', width: 'weighted', weight: 1, vertical_align: 'center',
+                                elements: [{ tag: 'markdown', text_size: 'notation_small_v2', content: footerContent || ' ' }],
+                            },
+                            {
+                                tag: 'column', width: 'auto', vertical_align: 'center',
+                                elements: [{
+                                        tag: 'button',
+                                        text: { tag: 'plain_text', content: '🔊 语音总结' },
+                                        type: 'default',
+                                        behaviors: [{
+                                                type: 'callback',
+                                                value: { action: 'voice_summary', session_id: sid, root_id: anchorId, lark_app_id: appId, chat_id: targetChatId },
+                                            }],
+                                    }],
+                            },
+                        ],
+                    });
+                }
+                else {
+                    elements.push({
+                        tag: 'markdown',
+                        text_size: 'notation_small_v2',
+                        content: footerContent,
+                    });
+                }
             }
             const cardJson = JSON.stringify({
                 schema: '2.0',
                 config: { update_multi: true },
                 body: { direction: 'vertical', elements },
             });
-            messageId = await dispatchPrimary(cardJson, 'interactive');
-        }
-        else {
-            // Plain-text path: build post content, paragraph per line.
-            const postContent = text ? text.split('\n').map((line) => {
-                if (!mentionPattern)
-                    return [{ tag: 'text', text: line }];
-                const nodes = [];
-                let lastIndex = 0;
-                for (const match of line.matchAll(mentionPattern)) {
-                    const openId = mentionMap.get(match[1].toLowerCase());
-                    if (!openId)
-                        continue;
-                    if (match.index > lastIndex)
-                        nodes.push({ tag: 'text', text: line.slice(lastIndex, match.index) });
-                    nodes.push({ tag: 'at', user_id: openId });
-                    lastIndex = match.index + match[0].length;
-                }
-                if (lastIndex < line.length)
-                    nodes.push({ tag: 'text', text: line.slice(lastIndex) });
-                return nodes.length > 0 ? nodes : [{ tag: 'text', text: line }];
-            }) : [];
-            for (const key of imageKeys)
-                postContent.push([{ tag: 'img', image_key: key }]);
-            // Footer: mirror the card layout — all real mentions go on one
-            // `发送给：` line (human addressee first, then explicit targets, then cc),
-            // separated from the body by a blank paragraph. Ids already inlined in the
-            // body prose are skipped. Top-level publish keeps sendTo empty.
-            const inlinedIds = new Set();
-            for (const para of postContent)
-                for (const n of para)
-                    if (n.tag === 'at')
-                        inlinedIds.add(n.user_id);
-            const footerRecipients = orderedFooterRecipients({
-                sendTo: footerAddressing.sendTo,
-                mentionIds: mentions.map(m => m.open_id),
-                cc: footerAddressing.cc,
-                inlinedIds,
-            });
-            if (footerRecipients.length > 0) {
-                if (postContent.length > 0)
-                    postContent.push([{ tag: 'text', text: '' }]);
-                postContent.push([
-                    { tag: 'text', text: '发送给：' },
-                    ...footerRecipients.map(id => ({ tag: 'at', user_id: id })),
-                ]);
-            }
-            const postJson = JSON.stringify({ zh_cn: { title: '', content: postContent } });
-            messageId = await dispatchPrimary(postJson, 'post');
-        }
-        // Bridge fallback marker — append-only jsonl per session. The worker
-        // gates its non-adopt transcript-driven fallback on whether any send
-        // happened within the current Lark turn's window. Only when this send
-        // landed in the session's own thread (not --top-level, not --chat-id
-        // override) does it cancel that turn's fallback.
-        if (!sendTopLevel && !overrideChatId) {
-            try {
-                const markerDir = join(resolveDataDir(), 'turn-sends');
-                if (!existsSync(markerDir))
-                    mkdirSync(markerDir, { recursive: true });
-                // sentAtMs was captured pre-dispatch (see above). messageId is the
-                // confirmed Lark message id from the now-successful dispatch.
-                const line = JSON.stringify({ sentAtMs, messageId }) + '\n';
-                appendFileSync(join(markerDir, `${sid}.jsonl`), line);
-            }
-            catch { /* best-effort: marker miss only causes a redundant fallback message */ }
+            messageId = await dispatchOrPatchPending(cardJson, 'interactive');
         }
+        // Bridge fallback marker — append-only jsonl per session. Same-thread
+        // sends always suppress transcript fallback; detoured sends suppress only
+        // when they closed a pending response card for this turn.
+        if (shouldRecordBridgeMarker)
+            recordBridgeSendMarker(sentAtMs, messageId);
         // Send file attachments as separate messages
         const fileIds = [];
         for (const fp of files) {
@@ -4157,6 +4233,96 @@ if (process.env.BOTMUX_WORKFLOW === '1') {
         process.exit(2);
     }
 }
+/**
+ * `botmux voice` — standalone voice-summary configuration (advanced feature,
+ * intentionally NOT folded into `botmux setup`). Writes the global `voice`
+ * block to ~/.botmux/config.json. Subcommands: (none)=interactive setup,
+ * `status`=show masked config, `disable`=remove.
+ */
+async function cmdVoiceSetup(args) {
+    const sub = (args[0] ?? '').toLowerCase();
+    const { readGlobalConfig, mergeGlobalConfig } = await import('./global-config.js');
+    const { DEFAULT_SAMI_SPEAKER, DEFAULT_OPENAI_SPEAKER } = await import('./services/voice/index.js');
+    const mask = (s) => (s ? `${s.slice(0, 4)}***` : '(未设)');
+    if (sub === 'status') {
+        const v = readGlobalConfig().voice;
+        if (!v) {
+            console.log('语音功能未配置。运行 `botmux voice` 配置。');
+            return;
+        }
+        console.log('当前语音配置（全局 ~/.botmux/config.json）:');
+        console.log(`  引擎: ${v.engine ?? '(自动)'}`);
+        console.log(`  音色: ${v.speaker ?? '(默认)'}`);
+        if (typeof v.rate === 'number')
+            console.log(`  语速: ${v.rate}`);
+        if (v.sami)
+            console.log(`  SAMI: accessKey=${mask(v.sami.accessKey)} secretKey=${mask(v.sami.secretKey)} appkey=${v.sami.appkey ?? '(未设)'}${v.sami.tokenUrl ? ` tokenUrl=${v.sami.tokenUrl}` : ''}`);
+        if (v.openai)
+            console.log(`  OpenAI: baseUrl=${v.openai.baseUrl ?? '(未设)'} model=${v.openai.model ?? '(未设)'} apiKey=${mask(v.openai.apiKey)}`);
+        return;
+    }
+    if (sub === 'disable' || sub === 'off') {
+        mergeGlobalConfig({ voice: null });
+        console.log('✅ 已移除全局语音配置（回复卡片不再显示「🔊 语音总结」按钮）。重启 daemon 生效。');
+        return;
+    }
+    if (sub && sub !== 'setup') {
+        console.error('用法: botmux voice [status|disable]（无参 = 交互式配置）');
+        process.exit(1);
+    }
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    try {
+        console.log('🔊 配置语音总结（高级功能）。写入全局 ~/.botmux/config.json，重启后生效。\n');
+        const eng = (await ask(rl, '选择 TTS 引擎  [1] SAMI（需 AK/SK/appkey）  [2] OpenAI 兼容（自带 baseUrl/key）: ')).trim();
+        const voice = {};
+        if (eng === '2' || /openai/i.test(eng)) {
+            voice.engine = 'openai';
+            const baseUrl = (await ask(rl, 'baseUrl（如 https://api.openai.com/v1，自托管如 http://127.0.0.1:8880/v1）: ')).trim();
+            const apiKey = (await ask(rl, 'apiKey（无则留空）: ')).trim();
+            const model = (await ask(rl, 'model（如 tts-1 / kokoro）: ')).trim();
+            if (!baseUrl || !model) {
+                console.error('❌ baseUrl 和 model 必填，未写入。');
+                return;
+            }
+            voice.openai = { baseUrl, apiKey, model };
+            const sp = (await ask(rl, `音色 voice（留空=默认 ${DEFAULT_OPENAI_SPEAKER}）: `)).trim();
+            if (sp)
+                voice.speaker = sp;
+        }
+        else {
+            voice.engine = 'sami';
+            const accessKey = (await ask(rl, 'SAMI accessKey: ')).trim();
+            const secretKey = (await ask(rl, 'SAMI secretKey: ')).trim();
+            const appkey = (await ask(rl, 'SAMI appkey: ')).trim();
+            if (!accessKey || !secretKey || !appkey) {
+                console.error('❌ accessKey/secretKey/appkey 都必填，未写入。');
+                return;
+            }
+            voice.sami = { accessKey, secretKey, appkey };
+            const sp = (await ask(rl, `音色 speaker（留空=默认灿灿 ${DEFAULT_SAMI_SPEAKER}）: `)).trim();
+            if (sp)
+                voice.speaker = sp;
+            const adv = (await ask(rl, '自定义 SAMI 端点？一般不用，回车跳过 (y/N): ')).trim().toLowerCase();
+            if (adv === 'y') {
+                const tokenUrl = (await ask(rl, 'tokenUrl（留空用默认）: ')).trim();
+                const wsUrl = (await ask(rl, 'wsUrl（留空用默认）: ')).trim();
+                if (tokenUrl)
+                    voice.sami.tokenUrl = tokenUrl;
+                if (wsUrl)
+                    voice.sami.wsUrl = wsUrl;
+            }
+        }
+        const rate = (await ask(rl, '语速倍率（留空=1.1）: ')).trim();
+        if (rate && !Number.isNaN(Number(rate)))
+            voice.rate = Number(rate);
+        mergeGlobalConfig({ voice: voice });
+        console.log('\n✅ 已写入 voice 配置。`botmux restart` 后，配了语音的机器人回复卡片底部会出现「🔊 语音总结」按钮。');
+        console.log('   查看：`botmux voice status`  关闭：`botmux voice disable`');
+    }
+    finally {
+        rl.close();
+    }
+}
 switch (command) {
     case '--version':
     case '-v':
@@ -4244,6 +4410,9 @@ switch (command) {
     case 'lang':
         cmdLang(process.argv.slice(3));
         break;
+    case 'voice':
+        await cmdVoiceSetup(process.argv.slice(3));
+        break;
     case 'thread': {
         // Removed in favor of `botmux history` (普通群也兼容). Friendly stderr so
         // pre-rename scripts/skills surface the rename instead of "unknown command".