botmux 2.112.0 → 2.114.0

package/dist/dashboard/web/bot-defaults-page.d.ts

@@ -1,4 +1,4 @@
-import { type BotDefaultsRow, type BotSubstituteTarget, type CliOptionsState } from './bot-defaults.js';
+import { type BotDefaultsRow, type BotSubstituteTarget, type CliOptionsState, type SubstituteTargetResolution } from './bot-defaults.js';
 import { type PageDisposer } from './react-mount.js';
 type PatchBot = (appId: string, patch: Partial<BotDefaultsRow> | ((bot: BotDefaultsRow) => BotDefaultsRow)) => void;
 type CardPrefPatch = Record<string, boolean | string>;
@@ -15,6 +15,13 @@ type SubstituteTargetDraft = {
     name: string;
     persisted: BotSubstituteTarget;
     originalIdField?: SubstituteTargetIdField;
+    resolving?: boolean;
+    resolution?: {
+        ok: boolean;
+        name?: string;
+        avatarUrl?: string;
+        reason?: SubstituteTargetResolution['reason'];
+    };
 };
 /**
  * Build the substitute target to PUT for one edited row. Returns null when the id value is

package/dist/dashboard/web/bot-defaults-page.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bot-defaults-page.d.ts","sourceRoot":"","sources":["../../../src/dashboard/web/bot-defaults-page.tsx"],"names":[],"mappings":"AAEA,OAAO,EAUL,KAAK,cAAc,EAEnB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAcrE,KAAK,QAAQ,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,cAAc,KAAK,cAAc,CAAC,KAAK,IAAI,CAAC;AACpH,KAAK,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,CAAC;AAEtD,KAAK,YAAY,GAAG;IAClB,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,GAAG,CAAC;CACX,CAAC;AAyIF,KAAK,uBAAuB,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AASzE,KAAK,qBAAqB,GAAG;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,uBAAuB,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,mBAAmB,CAAC;IAC/B,eAAe,CAAC,EAAE,uBAAuB,CAAC;CAC3C,CAAC;AAQF;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,IAAI,CAAC,qBAAqB,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,WAAW,GAAG,iBAAiB,CAAC,GACjG,mBAAmB,GAAG,IAAI,CAc5B;AAsiBD,wBAAgB,eAAe,CAAC,KAAK,EAAE;IACrC,GAAG,EAAE,cAAc,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,eAAe,CAAC;IAC1B,QAAQ,EAAE,QAAQ,CAAC;CACpB,+BAkOA;AAujBD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAAE,GAAG,EAAE,cAAc,CAAC;IAAC,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;CAAE,+BA8C9H;AA6+BD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,WAAW,GAAG,YAAY,CAErE"}
+{"version":3,"file":"bot-defaults-page.d.ts","sourceRoot":"","sources":["../../../src/dashboard/web/bot-defaults-page.tsx"],"names":[],"mappings":"AAEA,OAAO,EAWL,KAAK,cAAc,EAEnB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,0BAA0B,EAChC,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAcrE,KAAK,QAAQ,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,cAAc,KAAK,cAAc,CAAC,KAAK,IAAI,CAAC;AACpH,KAAK,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,CAAC;AAEtD,KAAK,YAAY,GAAG;IAClB,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,GAAG,CAAC;CACX,CAAC;AAyIF,KAAK,uBAAuB,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEzE,KAAK,qBAAqB,GAAG;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,uBAAuB,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,mBAAmB,CAAC;IAC/B,eAAe,CAAC,EAAE,uBAAuB,CAAC;IAC1C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE;QACX,EAAE,EAAE,OAAO,CAAC;QACZ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,0BAA0B,CAAC,QAAQ,CAAC,CAAC;KAC/C,CAAC;CACH,CAAC;AAiBF;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,IAAI,CAAC,qBAAqB,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,WAAW,GAAG,iBAAiB,CAAC,GACjG,mBAAmB,GAAG,IAAI,CAc5B;AA2qBD,wBAAgB,eAAe,CAAC,KAAK,EAAE;IACrC,GAAG,EAAE,cAAc,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,eAAe,CAAC;IAC1B,QAAQ,EAAE,QAAQ,CAAC;CACpB,+BAkOA;AAujBD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAAE,GAAG,EAAE,cAAc,CAAC;IAAC,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;CAAE,+BA8C9H;AAupCD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,WAAW,GAAG,YAAY,CAErE"}

package/dist/dashboard/web/bot-defaults-page.js

@@ -1,11 +1,11 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
 import { openBotOnboarding } from './bot-onboarding.js';
-import { agentSelectionKey, cliIdOf, displayCliId, fallbackCliOptionsState, fetchBotDefaults, fetchCliOptions, fmtSince, modelSuggestionsForOption, selectedCliOption, } from './bot-defaults.js';
+import { agentSelectionKey, cliIdOf, displayCliId, fallbackCliOptionsState, fetchBotDefaults, fetchCliOptions, fmtSince, modelSuggestionsForOption, resolveSubstituteTarget, selectedCliOption, } from './bot-defaults.js';
 import { mountReactPage } from './react-mount.js';
 import { useT } from './react-hooks.js';
 import { CreateActionButton, DropdownMenu, Html, InfoTip as BaseInfoTip, LoadingState, RefreshIconButton, dropdownLabel, } from './dashboard-components.js';
-import { botAvatarHtml, loadNameMaps, ui } from './ui.js';
+import { botAvatarHtml, loadNameMaps, overrideBotAvatar, ui } from './ui.js';
 function statusClass(status, extra = '') {
     const suffix = status ? ` ${status.ok ? 'hint-ok' : 'hint-warn-inline'}` : '';
     return `oncall-status${extra ? ` ${extra}` : ''}${suffix}`;
@@ -63,6 +63,13 @@ function nonNegativeInteger(raw, fallback) {
     return Number(value);
 }
 const substituteTargetIdFields = ['email', 'openId', 'userId', 'unionId'];
+function parseSubstituteChats(text) {
+    const values = text.split(/[\r\n,，;；]+/).map(s => s.trim()).filter(Boolean);
+    return [...new Set(values)];
+}
+function formatSubstituteChats(chats) {
+    return (chats ?? []).join('\n');
+}
 function substituteTargetIdField(target) {
     return substituteTargetIdFields.find(field => target?.[field]?.trim()) ?? 'email';
 }
@@ -247,12 +254,114 @@ function BotDefaultsCard(props) {
         return (_jsxs("article", { className: "bd-card bd-profile", "data-appid": bot.larkAppId, children: [_jsxs("header", { className: "bd-profile-head", children: [_jsx(Html, { html: botAvatarHtml({ name, larkAppId: bot.larkAppId }) }), _jsxs("div", { className: "bd-profile-id", children: [_jsx("strong", { children: name }), _jsx("code", { children: bot.larkAppId })] })] }), _jsxs("p", { className: "hint-warn-inline", children: ["\u67E5\u8BE2\u5931\u8D25\uFF1A", bot.error] })] }));
     }
     const def = bot.defaultOncall ?? { enabled: false, workingDir: '', since: 0 };
-    return (_jsxs("article", { className: "bd-card bd-profile", "data-appid": bot.larkAppId, children: [_jsxs("header", { className: "bd-profile-head", children: [_jsx("div", { className: "bd-profile-avatar", children: _jsx(Html, { html: botAvatarHtml({ name, larkAppId: bot.larkAppId, dot: 'ok' }) }) }), _jsx("div", { className: "bd-profile-main", children: _jsx(BotProfileIdentity, { bot: bot, cli: cli, patchBot: patchBot, meta: (_jsxs(_Fragment, { children: [_jsxs("small", { className: "bd-meta-ok", children: ["\u25CF ", tr('botDefaults.metaOnline')] }), _jsxs("small", { "data-oncall-since": true, children: [tr('botDefaults.lastEnabled'), ": ", fmtSince(def.since ?? 0)] }), _jsx("small", { children: tr('botDefaults.autobound', { count: bot.autoboundChatCount ?? 0 }) })] })) }) })] }), _jsxs("div", { className: "bd-body bd-grid", children: [_jsxs("div", { className: "bd-column", children: [_jsxs("section", { className: "bd-tile", children: [_jsx(BotAgentSection, { bot: bot, sessionFallback: cli, cliState: cliState, patchBot: patchBot }), _jsx(WorkingDirSection, { bot: bot, patchBot: patchBot, putCardPref: putCardPref }), bot.cliId !== 'riff' && _jsx(SandboxSection, { bot: bot, patchBot: patchBot }), bot.cliId !== 'riff' && _jsx(BackendTypeSection, { bot: bot, patchBot: patchBot })] }), _jsx("section", { className: "bd-tile", children: _jsx(RuntimeEnvironmentSection, { bot: bot, patchBot: patchBot }) }), _jsx("section", { className: "bd-tile", children: _jsx(GrantSection, { bot: bot, patchBot: patchBot }) })] }), _jsxs("div", { className: "bd-column", children: [_jsxs("section", { className: "bd-tile", children: [_jsx(SessionModeSection, { bot: bot, patchBot: patchBot, putCardPref: putCardPref }), _jsx(SubstituteModeSection, { bot: bot, patchBot: patchBot }), _jsx(CrossBotSection, { bot: bot, putCardPref: putCardPref }), _jsx(SessionCapSection, { bot: bot, patchBot: patchBot })] }), _jsxs("section", { className: "bd-tile", children: [_jsx(CardBehaviorSection, { bot: bot, putCardPref: putCardPref }), _jsx(CodexAppDisplaySection, { bot: bot, putCardPref: putCardPref }), _jsx(SummaryTriggerSection, { bot: bot, patchBot: patchBot }), _jsx(BrandSection, { bot: bot, patchBot: patchBot })] }), _jsx("section", { className: "bd-tile", children: _jsx(RoleSection, { bot: bot, patchBot: patchBot }) })] })] })] }));
+    return (_jsxs("article", { className: "bd-card bd-profile", "data-appid": bot.larkAppId, children: [_jsxs("header", { className: "bd-profile-head", children: [_jsx(BotAvatarControl, { bot: bot, name: name, patchBot: patchBot }), _jsx("div", { className: "bd-profile-main", children: _jsx(BotProfileIdentity, { bot: bot, cli: cli, patchBot: patchBot, meta: (_jsxs(_Fragment, { children: [_jsxs("small", { className: "bd-meta-ok", children: ["\u25CF ", tr('botDefaults.metaOnline')] }), _jsxs("small", { "data-oncall-since": true, children: [tr('botDefaults.lastEnabled'), ": ", fmtSince(def.since ?? 0)] }), _jsx("small", { children: tr('botDefaults.autobound', { count: bot.autoboundChatCount ?? 0 }) })] })) }) })] }), _jsxs("div", { className: "bd-body bd-grid", children: [_jsxs("div", { className: "bd-column", children: [_jsxs("section", { className: "bd-tile", children: [_jsx(BotAgentSection, { bot: bot, sessionFallback: cli, cliState: cliState, patchBot: patchBot }), _jsx(WorkingDirSection, { bot: bot, patchBot: patchBot, putCardPref: putCardPref }), bot.cliId !== 'riff' && _jsx(SandboxSection, { bot: bot, patchBot: patchBot }), bot.cliId !== 'riff' && _jsx(BackendTypeSection, { bot: bot, patchBot: patchBot })] }), _jsx("section", { className: "bd-tile", children: _jsx(RuntimeEnvironmentSection, { bot: bot, patchBot: patchBot }) }), _jsx("section", { className: "bd-tile", children: _jsx(GrantSection, { bot: bot, patchBot: patchBot }) })] }), _jsxs("div", { className: "bd-column", children: [_jsxs("section", { className: "bd-tile", children: [_jsx(SessionModeSection, { bot: bot, patchBot: patchBot, putCardPref: putCardPref }), _jsx(SubstituteModeSection, { bot: bot, patchBot: patchBot }), _jsx(CrossBotSection, { bot: bot, putCardPref: putCardPref }), _jsx(SessionCapSection, { bot: bot, patchBot: patchBot })] }), _jsxs("section", { className: "bd-tile", children: [_jsx(CardBehaviorSection, { bot: bot, putCardPref: putCardPref }), _jsx(CodexAppDisplaySection, { bot: bot, putCardPref: putCardPref }), _jsx(SummaryTriggerSection, { bot: bot, patchBot: patchBot }), _jsx(BrandSection, { bot: bot, patchBot: patchBot })] }), _jsx("section", { className: "bd-tile", children: _jsx(RoleSection, { bot: bot, patchBot: patchBot }) })] })] })] }));
 }
 function RuntimeEnvironmentSection(props) {
     const tr = useT();
     return (_jsxs("section", { className: "bd-section bd-runtime-env", children: [_jsx("h3", { className: "bd-section-title", children: tr('botDefaults.sectionRuntimeEnv') }), _jsx(StartupCommandsSection, { bot: props.bot, patchBot: props.patchBot }), _jsx(LaunchShellSection, { bot: props.bot, patchBot: props.patchBot }), _jsx(EnvSection, { bot: props.bot, patchBot: props.patchBot })] }));
 }
+/** console 头像上传只实测过 512×512 PNG，前端统一归一化成这一形态再上传。 */
+const AVATAR_UPLOAD_SIDE = 512;
+/** 任意用户图片 → 512×512 PNG dataURL（短边 cover 裁剪居中）。 */
+async function normalizeAvatarImage(file) {
+    const bitmap = await createImageBitmap(file);
+    try {
+        const side = Math.min(bitmap.width, bitmap.height);
+        if (!side)
+            throw new Error('empty image');
+        const canvas = document.createElement('canvas');
+        canvas.width = AVATAR_UPLOAD_SIDE;
+        canvas.height = AVATAR_UPLOAD_SIDE;
+        const ctx = canvas.getContext('2d');
+        if (!ctx)
+            throw new Error('canvas unavailable');
+        const sx = (bitmap.width - side) / 2;
+        const sy = (bitmap.height - side) / 2;
+        ctx.drawImage(bitmap, sx, sy, side, side, 0, 0, AVATAR_UPLOAD_SIDE, AVATAR_UPLOAD_SIDE);
+        return canvas.toDataURL('image/png');
+    }
+    finally {
+        bitmap.close();
+    }
+}
+/** 档案头头像：点击选图 → 归一化 → 走开放平台自动化真改飞书应用头像并发版。
+ *  与改名同款失败语义：缺飞书 Web 登录态时给扫码入口，登录成功自动重试。 */
+function BotAvatarControl(props) {
+    const tr = useT();
+    const { bot, name, patchBot } = props;
+    const inputRef = useRef(null);
+    const [busy, setBusy] = useState(false);
+    const [status, setStatus] = useState(null);
+    const [loginVisible, setLoginVisible] = useState(false);
+    const [loginOpen, setLoginOpen] = useState(false);
+    // 待上传图片留到登录成功后重试；成功/明确失败时清掉。
+    const pendingRef = useRef(null);
+    function avatarFailText(error, message) {
+        const known = ['no_session', 'session_expired', 'no_access', 'unsupported_brand'];
+        const detail = known.includes(error) ? tr(`botDefaults.avatarWarn.${error}`) : (message || error);
+        return tr('botDefaults.avatarFailed', { error: detail });
+    }
+    const upload = useCallback(async (imageBase64) => {
+        setBusy(true);
+        setStatus({ text: `⏳ ${tr('botDefaults.avatarUploading')}`, ok: true });
+        try {
+            const res = await sendJson('PUT', `/api/bots/${encodeURIComponent(bot.larkAppId)}/avatar`, { imageBase64 });
+            if (res.ok && res.body.ok) {
+                const url = typeof res.body.avatarUrl === 'string' ? res.body.avatarUrl : '';
+                if (url)
+                    overrideBotAvatar(bot.larkAppId, name, url);
+                // 行内容不变，触发一次重绘让 orb 读到覆写后的头像映射。
+                patchBot(bot.larkAppId, current => ({ ...current }));
+                pendingRef.current = null;
+                setLoginVisible(false);
+                setStatus({ text: `✓ ${tr('botDefaults.avatarOkFeishu')}`, ok: true });
+            }
+            else {
+                const err = String(res.body?.error ?? '');
+                const message = typeof res.body?.message === 'string' ? res.body.message : undefined;
+                setStatus({ text: `✗ ${avatarFailText(err, message ?? responseErrorText(res))}` });
+                const needLogin = err === 'no_session' || err === 'session_expired';
+                setLoginVisible(needLogin);
+                if (!needLogin)
+                    pendingRef.current = null;
+            }
+        }
+        catch (e) {
+            setStatus({ text: `✗ ${tr('botDefaults.avatarFailed', { error: caughtErrorText(e) })}` });
+        }
+        finally {
+            setBusy(false);
+        }
+    }, [bot.larkAppId, name, patchBot, tr]);
+    async function handleFile(file) {
+        if (!file || busy)
+            return;
+        // 归一化阶段就置 busy：canvas 解码大图有可感知耗时，这个窗口里不该还能
+        // 再开一次选图/触发并发提交（服务端另有 per-app 串行队列兜底）。
+        setBusy(true);
+        let dataUrl;
+        try {
+            dataUrl = await normalizeAvatarImage(file);
+        }
+        catch {
+            setBusy(false);
+            setStatus({ text: `✗ ${tr('botDefaults.avatarBadImage')}` });
+            return;
+        }
+        pendingRef.current = dataUrl;
+        await upload(dataUrl);
+    }
+    return (_jsxs("div", { className: "bd-profile-avatar bd-avatar-editable", "data-avatar-control": true, children: [_jsxs("button", { type: "button", className: "bd-avatar-btn", "data-action": "edit-bot-avatar", title: tr('botDefaults.avatarTitle'), "aria-label": tr('botDefaults.avatarTitle'), disabled: busy, onClick: () => inputRef.current?.click(), children: [_jsx(Html, { html: botAvatarHtml({ name, larkAppId: bot.larkAppId, dot: 'ok' }) }), _jsx("span", { className: "bd-avatar-edit-badge", "aria-hidden": "true", children: busy ? '⏳' : '✎' })] }), _jsx("input", { ref: inputRef, type: "file", accept: "image/*", hidden: true, "data-input": "botAvatarFile", onChange: event => {
+                    const file = event.currentTarget.files?.[0];
+                    event.currentTarget.value = ''; // 允许再次选择同一文件
+                    void handleFile(file);
+                } }), status ? (_jsxs("small", { className: statusClass(status, 'bd-avatar-status'), "data-avatar-status": true, children: [status.text, loginVisible ? (_jsx("button", { type: "button", className: "bd-feishu-login", "data-action": "feishu-login-avatar", onClick: () => setLoginOpen(true), children: tr('feishuLogin.entry') })) : null] })) : null, loginOpen ? (_jsx(FeishuLoginModal, { onClose: () => setLoginOpen(false), onSuccess: () => {
+                    setLoginVisible(false);
+                    setLoginOpen(false);
+                    if (pendingRef.current)
+                        void upload(pendingRef.current);
+                } })) : null] }));
+}
 function BotProfileIdentity(props) {
     const tr = useT();
     const { bot, cli, patchBot } = props;
@@ -1141,7 +1250,22 @@ function SubstituteModeSection(props) {
     const tr = useT();
     const initial = props.bot.substituteMode ?? null;
     const [enabled, setEnabled] = useState(initial?.enabled === true);
+    function substituteReasonText(reason) {
+        switch (reason) {
+            case 'cross_app_open_id': return tr('botDefaults.substituteReasonCrossAppOpenId');
+            case 'not_visible': return tr('botDefaults.substituteReasonNotVisible');
+            case 'resolve_failed': return tr('botDefaults.substituteReasonResolveFailed');
+            case 'unresolvable': return tr('botDefaults.substituteReasonUnresolvable');
+            default: return tr('botDefaults.substituteUnresolved');
+        }
+    }
     const [disclosure, setDisclosure] = useState(initial?.disclosure === 'none' ? 'none' : 'prefix');
+    const [replyMode, setReplyMode] = useState(initial?.replyMode === 'quote' ? 'quote' : 'thread');
+    const [controlCard, setControlCard] = useState(initial?.disableControlCard !== true);
+    const [chatsText, setChatsText] = useState(() => formatSubstituteChats(initial?.chats));
+    // 话题群相关开关缺省开：只有显式 false 才是关（与 normalize 语义一致）。
+    const [topicGroups, setTopicGroups] = useState(initial?.topicGroups !== false);
+    const [topicActiveSessionTrigger, setTopicActiveSessionTrigger] = useState(initial?.topicActiveSessionTrigger !== false);
     const [status, setStatus] = useState(null);
     const [busy, setBusy] = useState(false);
     const targetSequence = useRef(0);
@@ -1155,8 +1279,73 @@ function SubstituteModeSection(props) {
             name: target?.name ?? '',
             persisted: target ? { ...target } : {},
             originalIdField: target ? idField : undefined,
+            resolution: target?.name || target?.avatarUrl
+                ? { ok: true, name: target.name, avatarUrl: target.avatarUrl }
+                : undefined,
         };
     }
+    // Monotonic per-row resolve epoch: two quick blurs create two in-flight
+    // requests; only the latest one may apply, or a slow stale response would
+    // overwrite the fresh result (last-completion-wins race).
+    const resolveEpochs = useRef(new Map());
+    async function resolveTargetRow(key) {
+        const epoch = (resolveEpochs.current.get(key) ?? 0) + 1;
+        resolveEpochs.current.set(key, epoch);
+        const isCurrent = () => resolveEpochs.current.get(key) === epoch;
+        setTargetRows(rows => rows.map(row => row.key === key ? { ...row, resolving: true } : row));
+        try {
+            const row = targetRows.find(r => r.key === key);
+            if (!row)
+                return;
+            const idValue = row.idValue.trim();
+            if (!idValue) {
+                setTargetRows(rows => rows.map(r => r.key === key ? { ...r, resolving: false, resolution: undefined } : r));
+                return;
+            }
+            const target = { [row.idField]: idValue };
+            if (row.name.trim())
+                target.name = row.name.trim();
+            const res = await resolveSubstituteTarget(props.bot.larkAppId, target);
+            if (!isCurrent())
+                return;
+            setTargetRows(rows => rows.map(r => {
+                if (r.key !== key)
+                    return r;
+                if (!res.ok)
+                    return { ...r, resolving: false, resolution: { ok: false } };
+                const entry = res.resolution;
+                if (entry?.ok === true) {
+                    // userId passthrough: nothing was verified (no openId / profile) —
+                    // keep the editable name input instead of showing a fake chip.
+                    if (!entry.openId)
+                        return { ...r, resolving: false, resolution: undefined };
+                    const persisted = { ...r.persisted };
+                    persisted.openId = entry.openId;
+                    if (entry.name)
+                        persisted.name = entry.name;
+                    if (entry.avatarUrl)
+                        persisted.avatarUrl = entry.avatarUrl;
+                    return {
+                        ...r,
+                        name: entry.name ?? r.name,
+                        persisted,
+                        resolving: false,
+                        resolution: { ok: true, name: entry.name, avatarUrl: entry.avatarUrl },
+                    };
+                }
+                return {
+                    ...r,
+                    resolving: false,
+                    resolution: { ok: false, reason: entry?.reason },
+                };
+            }));
+        }
+        catch {
+            if (!isCurrent())
+                return;
+            setTargetRows(rows => rows.map(r => r.key === key ? { ...r, resolving: false, resolution: { ok: false } } : r));
+        }
+    }
     const [targetRows, setTargetRows] = useState(() => {
         const targets = initial?.targets ?? [];
         return targets.length ? targets.map(target => makeTargetDraft(target)) : [makeTargetDraft()];
@@ -1169,6 +1358,11 @@ function SubstituteModeSection(props) {
         const next = props.bot.substituteMode ?? null;
         setEnabled(next?.enabled === true);
         setDisclosure(next?.disclosure === 'none' ? 'none' : 'prefix');
+        setReplyMode(next?.replyMode === 'quote' ? 'quote' : 'thread');
+        setControlCard(next?.disableControlCard !== true);
+        setChatsText(formatSubstituteChats(next?.chats));
+        setTopicGroups(next?.topicGroups !== false);
+        setTopicActiveSessionTrigger(next?.topicActiveSessionTrigger !== false);
         const targets = next?.targets ?? [];
         setTargetRows(targets.length ? targets.map(target => makeTargetDraft(target)) : [makeTargetDraft()]);
     }, [props.bot.larkAppId, props.bot.substituteMode]);
@@ -1190,6 +1384,11 @@ function SubstituteModeSection(props) {
                     .filter(Boolean);
                 setEnabled(next?.enabled === true);
                 setDisclosure(next?.disclosure === 'none' ? 'none' : 'prefix');
+                setReplyMode(next?.replyMode === 'quote' ? 'quote' : 'thread');
+                setControlCard(next?.disableControlCard !== true);
+                setChatsText(formatSubstituteChats(next?.chats));
+                setTopicGroups(next?.topicGroups !== false);
+                setTopicActiveSessionTrigger(next?.topicActiveSessionTrigger !== false);
                 if (resolution.length) {
                     skipModeSync.current = true;
                     setTargetRows(rows => {
@@ -1200,16 +1399,27 @@ function SubstituteModeSection(props) {
                             if (index < 0)
                                 return row;
                             const entry = pending.splice(index, 1)[0];
-                            if (entry?.ok !== true)
-                                return row;
-                            const persisted = { ...row.persisted };
-                            if (entry.openId)
-                                persisted.openId = entry.openId;
-                            if (row.idField === 'email')
-                                persisted.email = input;
-                            if (entry.name)
-                                persisted.name = entry.name;
-                            return { ...row, name: entry.name ?? row.name, persisted };
+                            if (entry?.ok === true) {
+                                const persisted = { ...row.persisted };
+                                if (entry.openId)
+                                    persisted.openId = entry.openId;
+                                if (row.idField === 'email')
+                                    persisted.email = input;
+                                if (entry.name)
+                                    persisted.name = entry.name;
+                                if (entry.avatarUrl)
+                                    persisted.avatarUrl = entry.avatarUrl;
+                                return {
+                                    ...row,
+                                    name: entry.name ?? row.name,
+                                    persisted,
+                                    resolution: { ok: true, name: entry.name, avatarUrl: entry.avatarUrl },
+                                };
+                            }
+                            return {
+                                ...row,
+                                resolution: { ok: false, reason: entry?.reason },
+                            };
                         });
                     });
                 }
@@ -1256,26 +1466,33 @@ function SubstituteModeSection(props) {
             setStatus({ text: `✗ ${tr('botDefaults.substituteTargetsInvalid')}` });
             return;
         }
-        void save({ enabled, targets, disclosure });
+        void save({ enabled, targets, disclosure, chats: parseSubstituteChats(chatsText), replyMode, disableControlCard: !controlCard, topicGroups, topicActiveSessionTrigger });
     }
     const disclosureOptions = [
         { value: 'prefix', label: tr('botDefaults.substituteDisclosurePrefix') },
         { value: 'none', label: tr('botDefaults.substituteDisclosureNone') },
     ];
-    return (_jsxs("section", { className: "bd-section bd-substitute-section", children: [_jsx("h3", { className: "bd-section-title", children: tr('botDefaults.sectionSubstitute') }), _jsx(ToggleRow, { checked: enabled, disabled: busy, dataAction: "toggle-substitute-mode", title: tr('botDefaults.substituteEnabled'), help: tr('botDefaults.substituteHelp'), onChange: setEnabled }), _jsx("div", { className: "bd-row", children: _jsxs("div", { className: "bd-field", children: [_jsx(FieldTitle, { children: tr('botDefaults.substituteDisclosure') }), _jsx(DropdownField, { dataInput: "substituteDisclosure", ariaLabel: tr('botDefaults.substituteDisclosure'), value: disclosure, disabled: busy, options: disclosureOptions, onChange: value => setDisclosure(value) })] }) }), _jsxs("div", { className: "bd-row bd-substitute-targets", children: [_jsx(FieldTitle, { help: tr('botDefaults.substituteTargetsHelp'), children: tr('botDefaults.substituteTargets') }), _jsxs("div", { className: "bd-substitute-target-list", "data-input": "substituteTargets", children: [targetRows.map((target, index) => (_jsxs("div", { className: "bd-substitute-target-row", children: [_jsx(DropdownField, { dataInput: `substituteTargetType-${target.key}`, className: "bd-substitute-target-type", ariaLabel: `${tr('botDefaults.substituteTargetType')} ${index + 1}`, value: target.idField, disabled: busy, options: substituteTargetIdFields.map(value => ({
+    const replyModeOptions = [
+        { value: 'thread', label: tr('botDefaults.substituteReplyModeThread') },
+        { value: 'quote', label: tr('botDefaults.substituteReplyModeQuote') },
+    ];
+    return (_jsxs("section", { className: "bd-section bd-substitute-section", children: [_jsx("h3", { className: "bd-section-title", children: tr('botDefaults.sectionSubstitute') }), _jsx(ToggleRow, { checked: enabled, disabled: busy, dataAction: "toggle-substitute-mode", title: tr('botDefaults.substituteEnabled'), help: tr('botDefaults.substituteHelp'), onChange: setEnabled }), _jsx(ToggleRow, { checked: topicGroups, disabled: busy, dataAction: "toggle-substitute-topic-groups", title: tr('botDefaults.substituteTopicGroups'), help: tr('botDefaults.substituteTopicGroupsHelp'), onChange: setTopicGroups }), _jsx(ToggleRow, { checked: topicActiveSessionTrigger, disabled: busy || !topicGroups, dataAction: "toggle-substitute-topic-active", title: tr('botDefaults.substituteTopicActive'), help: tr('botDefaults.substituteTopicActiveHelp'), onChange: setTopicActiveSessionTrigger }), _jsx("div", { className: "bd-row", children: _jsxs("div", { className: "bd-field", children: [_jsx(FieldTitle, { children: tr('botDefaults.substituteDisclosure') }), _jsx(DropdownField, { dataInput: "substituteDisclosure", ariaLabel: tr('botDefaults.substituteDisclosure'), value: disclosure, disabled: busy, options: disclosureOptions, onChange: value => setDisclosure(value) })] }) }), _jsx("div", { className: "bd-row", children: _jsxs("div", { className: "bd-field", children: [_jsx(FieldTitle, { help: tr('botDefaults.substituteReplyModeHelp'), children: tr('botDefaults.substituteReplyMode') }), _jsx(DropdownField, { dataInput: "substituteReplyMode", ariaLabel: tr('botDefaults.substituteReplyMode'), value: replyMode, disabled: busy, options: replyModeOptions, onChange: value => setReplyMode(value) })] }) }), _jsx(ToggleRow, { checked: controlCard, disabled: busy, dataAction: "toggle-substitute-control-card", title: tr('botDefaults.substituteControlCard'), help: tr('botDefaults.substituteControlCardHelp'), onChange: setControlCard }), _jsx("div", { className: "bd-row", children: _jsxs("label", { children: [_jsx(FieldTitle, { help: tr('botDefaults.substituteChatsHelp'), children: tr('botDefaults.substituteChats') }), _jsx("textarea", { "data-input": "substituteChats", rows: 3, placeholder: tr('botDefaults.substituteChatsPlaceholder'), value: chatsText, disabled: busy, onChange: event => setChatsText(event.currentTarget.value) })] }) }), _jsxs("div", { className: "bd-row bd-substitute-targets", children: [_jsx(FieldTitle, { help: tr('botDefaults.substituteTargetsHelp'), children: tr('botDefaults.substituteTargets') }), _jsxs("div", { className: "bd-substitute-target-list", "data-input": "substituteTargets", children: [targetRows.map((target, index) => (_jsxs("div", { className: "bd-substitute-target-row", children: [_jsx(DropdownField, { dataInput: `substituteTargetType-${target.key}`, className: "bd-substitute-target-type", ariaLabel: `${tr('botDefaults.substituteTargetType')} ${index + 1}`, value: target.idField, disabled: busy, options: substituteTargetIdFields.map(value => ({
                                             value,
                                             label: tr(`botDefaults.substituteTarget${value[0].toUpperCase()}${value.slice(1)}`),
                                         })), onChange: idField => {
                                             setTargetRows(rows => rows.map(row => row.key === target.key
-                                                ? { ...row, idField, idValue: row.persisted[idField] ?? '' }
+                                                ? { ...row, idField, idValue: row.persisted[idField] ?? '', resolution: undefined }
                                                 : row));
                                         } }), _jsx("input", { className: "bd-substitute-target-id", type: "text", "data-input": `substituteTargetId-${target.key}`, "aria-label": `${tr('botDefaults.substituteTargetType')} ${index + 1}`, placeholder: tr('botDefaults.substituteTargetIdPlaceholder'), value: target.idValue, disabled: busy, onChange: event => {
                                             const idValue = event.currentTarget.value;
-                                            setTargetRows(rows => rows.map(row => row.key === target.key ? { ...row, idValue } : row));
-                                        } }), _jsx("input", { className: "bd-substitute-target-name", type: "text", "data-input": `substituteTargetName-${target.key}`, "aria-label": `${tr('botDefaults.substituteTargetName')} ${index + 1}`, placeholder: tr('botDefaults.substituteTargetNamePlaceholder'), value: target.name, disabled: busy, onChange: event => {
-                                            const name = event.currentTarget.value;
-                                            setTargetRows(rows => rows.map(row => row.key === target.key ? { ...row, name } : row));
-                                        } }), _jsx("button", { type: "button", className: "bd-substitute-target-remove", "data-action": "remove-substitute-target", title: tr('botDefaults.substituteTargetRemove'), "aria-label": tr('botDefaults.substituteTargetRemove'), disabled: busy, onClick: () => {
+                                            setTargetRows(rows => rows.map(row => row.key === target.key ? { ...row, idValue, resolution: undefined } : row));
+                                        }, onBlur: () => {
+                                            if (target.idValue.trim())
+                                                void resolveTargetRow(target.key);
+                                        } }), _jsx("div", { className: "bd-substitute-target-name", children: target.resolving ? (_jsx("span", { className: "bd-substitute-target-resolving", children: tr('botDefaults.substituteResolving') })) : target.resolution?.ok === true && (target.name || target.resolution.avatarUrl) ? (_jsxs(_Fragment, { children: [target.resolution.avatarUrl ? (_jsx(Html, { html: botAvatarHtml({ name: target.resolution.name, avatarUrl: target.resolution.avatarUrl, size: 'sm' }) })) : null, _jsx("span", { className: "bd-substitute-target-name-chip", "data-chip": `substituteTargetName-${target.key}`, "aria-label": `${tr('botDefaults.substituteTargetName')} ${index + 1}`, children: target.name })] })) : target.resolution?.ok === false ? (_jsx("span", { className: "bd-substitute-target-resolution-badge", children: substituteReasonText(target.resolution.reason) })) : (_jsx("input", { type: "text", "data-input": `substituteTargetName-${target.key}`, "aria-label": `${tr('botDefaults.substituteTargetName')} ${index + 1}`, placeholder: tr('botDefaults.substituteTargetNamePlaceholder'), value: target.name, disabled: busy, onChange: event => {
+                                                const name = event.currentTarget.value;
+                                                setTargetRows(rows => rows.map(row => row.key === target.key ? { ...row, name } : row));
+                                            } })) }), _jsx("button", { type: "button", className: "bd-substitute-target-remove", "data-action": "remove-substitute-target", title: tr('botDefaults.substituteTargetRemove'), "aria-label": tr('botDefaults.substituteTargetRemove'), disabled: busy, onClick: () => {
                                             setTargetRows(rows => {
                                                 const remaining = rows.filter(row => row.key !== target.key);
                                                 return remaining.length ? remaining : [makeTargetDraft()];