botmux 2.94.0 → 2.96.0

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

@@ -7,6 +7,14 @@ import { store } from './store.js';
 import { botAvatarHtml, escapeHtml, loadNameMaps, loadingHtml, t } from './ui.js';
 let cache = { bots: [] };
 let loadError = null;
+let cliOptions = [
+    { id: 'claude-code', label: 'Claude' },
+    { id: 'codex', label: 'Codex' },
+    { id: 'traex', label: 'traex' },
+];
+let cliOptionsLoaded = false;
+let ttadkModelDefault = 'glm-5.1';
+let ttadkModelSuggestions = [];
 // master-detail：左侧员工名册选中谁，右侧就渲染谁的档案
 let selectedAppId = null;
 export function displayCliId(bot, sessionFallback) {
@@ -24,6 +32,76 @@ function cliIdOf(appId) {
     }
     return best?.cliId ?? '';
 }
+async function loadCliOptions() {
+    if (cliOptionsLoaded)
+        return;
+    cliOptionsLoaded = true;
+    try {
+        const r = await fetch('/api/cli-options');
+        const body = await r.json().catch(() => ({}));
+        if (r.ok && Array.isArray(body?.options)) {
+            cliOptions = body.options.filter((o) => o && typeof o.id === 'string' && typeof o.label === 'string');
+            if (typeof body.ttadkModelDefault === 'string' && body.ttadkModelDefault.trim()) {
+                ttadkModelDefault = body.ttadkModelDefault.trim();
+            }
+            if (Array.isArray(body.ttadkModelSuggestions)) {
+                ttadkModelSuggestions = body.ttadkModelSuggestions.filter((s) => typeof s === 'string');
+            }
+        }
+    }
+    catch {
+        // Keep the static fallback; saving still works for plain claude-code.
+    }
+}
+function agentSelectionKey(bot, sessionFallback) {
+    const explicit = typeof bot?.agentSelectionKey === 'string' && bot.agentSelectionKey ? bot.agentSelectionKey : '';
+    if (explicit)
+        return explicit;
+    const cli = displayCliId(bot, sessionFallback);
+    return cli || 'claude-code';
+}
+function selectedCliOption(key) {
+    return cliOptions.find(o => o.id === key);
+}
+function modelSuggestionsForOption(opt) {
+    if (opt?.gateway === 'ttadk' && opt.acceptsModel !== false)
+        return ttadkModelSuggestions;
+    return [];
+}
+export function renderBotAgentSection(b, sessionFallback) {
+    const key = agentSelectionKey(b, sessionFallback);
+    const optHtml = cliOptions
+        .map(o => `<option value="${escapeHtml(o.id)}" ${o.id === key ? 'selected' : ''}>${escapeHtml(o.label)}（${escapeHtml(o.id)}）</option>`)
+        .join('');
+    const model = typeof b?.model === 'string' ? b.model : '';
+    const suggestions = modelSuggestionsForOption(selectedCliOption(key));
+    const disabled = selectedCliOption(key)?.gateway === 'ttadk' && selectedCliOption(key)?.acceptsModel === false;
+    return `<section class="bd-section">
+      <h3 class="bd-section-title">${t('botDefaults.sectionAgent')}</h3>
+      <div class="bd-row">
+        <label>
+          <span>${t('botDefaults.agentCli')}</span>
+          <select data-input="agentCliId">${optHtml}</select>
+        </label>
+      </div>
+      <div class="bd-row">
+        <label>
+          <span>${t('botDefaults.agentModel')}</span>
+          <input type="text" data-input="agentModel" list="agent-model-suggestions-${escapeHtml(b.larkAppId)}"
+            placeholder="${escapeHtml(t('botDefaults.agentModelPlaceholder'))}"
+            value="${escapeHtml(model)}" ${disabled ? 'disabled' : ''}>
+          <datalist id="agent-model-suggestions-${escapeHtml(b.larkAppId)}">
+            ${suggestions.map(m => `<option value="${escapeHtml(m)}"></option>`).join('')}
+          </datalist>
+        </label>
+        <small class="bd-help">${t('botDefaults.agentHelp')}</small>
+        <div class="actions">
+          <button type="button" class="primary" data-action="save-agent">${t('botDefaults.agentSave')}</button>
+          <span class="oncall-status" data-agent-status></span>
+        </div>
+      </div>
+    </section>`;
+}
 function pageHtml() {
     return `<section class="page">
 <div class="page-heading">
@@ -89,7 +167,7 @@ export async function renderBotDefaultsPage(root) {
         refreshBtn.disabled = true;
         try {
             botProfileRoleCache.clear();
-            await loadBots();
+            await Promise.all([loadBots(), loadCliOptions()]);
             rerender();
         }
         finally {
@@ -107,7 +185,7 @@ export async function renderBotDefaultsPage(root) {
     });
     // /api/bots 要逐 daemon 探活，慢——先亮 loading 占住右侧详情区。
     listEl.innerHTML = loadingHtml();
-    await loadBots();
+    await Promise.all([loadBots(), loadCliOptions()]);
     function rerender() {
         const f = new FormData(form);
         const q = (f.get('q') ?? '').toLowerCase();
@@ -166,7 +244,11 @@ export async function renderBotDefaultsPage(root) {
       </article>`;
         }
         const def = b.defaultOncall ?? { enabled: false, workingDir: '', since: 0 };
-        const enabled = !!def.enabled;
+        // 默认工作目录模式（三选一，dashboard 互斥）：oncall > default > off。
+        const wdMode = def.enabled ? 'oncall' : (b.defaultWorkingDir ? 'default' : 'off');
+        // 输入框预填「最可能的目录」：defaultWorkingDir 优先，否则 oncall 目录（disable 后仍保留），
+        // 便于来回切换模式不用重输。
+        const wdDirValue = b.defaultWorkingDir || def.workingDir || '';
         const name = b.botName ?? b.larkAppId;
         const cli = displayCliId(b, cliIdOf(b.larkAppId));
         return `<article class="bd-card bd-profile" data-appid="${escapeHtml(b.larkAppId)}">
@@ -185,23 +267,29 @@ export async function renderBotDefaultsPage(root) {
       </header>
       <div class="bd-body bd-grid">
         <section class="bd-tile">
+          ${renderBotAgentSection(b, cli)}
           <section class="bd-section">
-            <h3 class="bd-section-title">${t('botDefaults.sectionOncall')}</h3>
-            <label class="toggle-row">
-              <input type="checkbox" data-action="toggle" ${enabled ? 'checked' : ''}>
-              <span class="switch" aria-hidden="true"></span>
-              <span class="toggle-tx"><strong>${t('botDefaults.defaultOncall')}</strong>
-              <small>${t('botDefaults.defaultOncallHelp')}。${t('botDefaults.warning')}</small></span>
-            </label>
+            <h3 class="bd-section-title">${t('botDefaults.sectionWorkingDir')}</h3>
             <div class="bd-row">
               <label>
-                <span>${t('botDefaults.workingDir')}</span>
+                <span>${t('botDefaults.workingDirMode')}</span>
+                <select data-input="workingDirMode">
+                  <option value="off" ${wdMode === 'off' ? 'selected' : ''}>${escapeHtml(t('botDefaults.workingDirModeOff'))}</option>
+                  <option value="default" ${wdMode === 'default' ? 'selected' : ''}>${escapeHtml(t('botDefaults.workingDirModeDefault'))}</option>
+                  <option value="oncall" ${wdMode === 'oncall' ? 'selected' : ''}>${escapeHtml(t('botDefaults.workingDirModeOncall'))}</option>
+                </select>
+              </label>
+              <small class="bd-help">${t('botDefaults.workingDirModeHelp')}</small>
+            </div>
+            <div class="bd-row" data-wd-dir-row ${wdMode === 'off' ? 'hidden' : ''}>
+              <label>
+                <span>${t('botDefaults.workingDirField')}</span>
                 <input type="text" data-input="workingDir" placeholder="e.g. /root/iserver/botmux"
-                  value="${escapeHtml(def.workingDir ?? '')}" ${enabled ? '' : 'disabled'}>
+                  value="${escapeHtml(wdDirValue)}">
               </label>
             </div>
             <div class="actions">
-              <button type="button" class="primary" data-action="save">${t('botDefaults.save')}</button>
+              <button type="button" class="primary" data-action="save-working-dir">${t('botDefaults.save')}</button>
               <span class="oncall-status" data-status></span>
             </div>
             ${renderAutoStartControls(b)}
@@ -209,8 +297,8 @@ export async function renderBotDefaultsPage(root) {
           ${renderSandboxSection(b)}
         </section>
         <section class="bd-tile">${renderRoleSection(b)}</section>
-        <section class="bd-tile">${renderSessionModeSection(b)}${renderCrossBotSection(b)}${renderSessionCapSection(b)}${renderStartupCommandsSection(b)}${renderEnvSection(b)}</section>
-        <section class="bd-tile">${renderCardBehaviorSection(b)}${renderBrandSection(b)}</section>
+        <section class="bd-tile">${renderSessionModeSection(b)}${renderCrossBotSection(b)}${renderSessionCapSection(b)}${renderStartupCommandsSection(b)}${renderLaunchShellSection(b)}${renderEnvSection(b)}</section>
+        <section class="bd-tile">${renderCardBehaviorSection(b)}${renderSummaryTriggerSection(b)}${renderBrandSection(b)}</section>
         <section class="bd-tile">${renderGrantSection(b)}</section>
       </div>
     </article>`;
@@ -354,6 +442,29 @@ export async function renderBotDefaultsPage(root) {
       <div class="actions"><span class="oncall-status" data-crossbot-status></span></div>
     </section>`;
     }
+    function renderSummaryTriggerSection(b) {
+        const range = b.summaryRange ?? { limit: 50, sinceHours: 24 };
+        const limit = Number.isInteger(range.limit) && range.limit >= 0 ? range.limit : 50;
+        const sinceHours = Number.isInteger(range.sinceHours) && range.sinceHours >= 0 ? range.sinceHours : 24;
+        return `<section class="bd-section">
+      <h3 class="bd-section-title">${t('botDefaults.sectionSummaryTrigger')}</h3>
+      <div class="bd-row bd-summary-limits">
+        <label>
+          <span>${t('botDefaults.summaryLimit')}</span>
+          <input type="number" min="0" step="1" data-input="summaryLimit" value="${limit}">
+        </label>
+        <label>
+          <span>${t('botDefaults.summarySinceHours')}</span>
+          <input type="number" min="0" step="1" data-input="summarySinceHours" value="${sinceHours}">
+        </label>
+      </div>
+      <small class="bd-help">${t('botDefaults.summaryLimitHelp')}</small>
+      <div class="actions">
+        <button type="button" class="primary" data-action="save-summary-trigger">${t('botDefaults.summarySave')}</button>
+        <span class="oncall-status" data-summary-trigger-status></span>
+      </div>
+    </section>`;
+    }
     // 会话模式：私聊（p2pMode）+ 普通群（regularGroupReplyMode）两个默认会话方式
     // 放在同一板块，各自一个下拉、一改即保存。
     //   • p2pMode             → PUT /api/bots/:appId/p2p-mode（走 applyConfigField，与 /botconfig 同路径）
@@ -364,7 +475,7 @@ export async function renderBotDefaultsPage(root) {
         const p2p = b.p2pMode === 'chat' ? 'chat' : 'thread';
         const regular = (b.regularGroupReplyMode === 'new-topic' || b.regularGroupReplyMode === 'shared' || b.regularGroupReplyMode === 'chat-topic')
             ? b.regularGroupReplyMode : 'chat';
-        const mention = (b.regularGroupMentionMode === 'topic' || b.regularGroupMentionMode === 'never')
+        const mention = (b.regularGroupMentionMode === 'topic' || b.regularGroupMentionMode === 'never' || b.regularGroupMentionMode === 'ambient')
             ? b.regularGroupMentionMode : 'always';
         const docMode = b.docSubscribeDefaultMode === 'all' ? 'all' : 'mention-only';
         const opt = (v, label) => `<option value="${v}" ${regular === v ? 'selected' : ''}>${escapeHtml(label)}</option>`;
@@ -407,6 +518,7 @@ export async function renderBotDefaultsPage(root) {
             ${mopt('always', t('botDefaults.mentionModeAlways'))}
             ${mopt('topic', t('botDefaults.mentionModeTopic'))}
             ${mopt('never', t('botDefaults.mentionModeNever'))}
+            ${mopt('ambient', t('botDefaults.mentionModeAmbient'))}
           </select>
         </label>
         <small class="bd-help">${t('botDefaults.mentionModeHelp')}</small>
@@ -475,6 +587,24 @@ export async function renderBotDefaultsPage(root) {
       </div>
     </div>`;
     }
+    // 启动 shell launchShell：启动 CLI 用的 shell（zsh|bash|sh 或绝对路径），覆盖 $SHELL。
+    // 用于登录 $SHELL（如 bash）的 rc 文件里 `exec zsh` 跳转、导致 CLI 起不来的场景。
+    // next-session 生效。PUT /api/bot-launch-shell 落 bots.json。
+    function renderLaunchShellSection(b) {
+        const val = typeof b.launchShell === 'string' ? b.launchShell : '';
+        return `<div class="bd-subsection">
+      <h4 class="bd-subsection-title">${t('botDefaults.sectionLaunchShell')}</h4>
+      <p class="bd-section-note">${t('botDefaults.launchShellHelp')}</p>
+      <input type="text" data-input="launchShell"
+        placeholder="${escapeHtml(t('botDefaults.launchShellPlaceholder'))}"
+        value="${escapeHtml(val)}"
+        style="width:100%;box-sizing:border-box;font:13px/1.5 ui-monospace,Menlo,monospace;padding:10px">
+      <div class="actions">
+        <button type="button" class="primary" data-action="save-launch-shell">${t('botDefaults.launchShellSave')}</button>
+        <span class="oncall-status" data-launch-shell-status></span>
+      </div>
+    </div>`;
+    }
     // 环境变量 env：注入到本 bot CLI 进程的环境变量（JSON 对象），如让某个 bot 走 GLM/
     // 第三方服务商（ANTHROPIC_BASE_URL+ANTHROPIC_AUTH_TOKEN）或设 HTTPS_PROXY。next-session
     // 生效（下个新会话起注入）。PUT /api/bots/:appId/env 落 bots.json，跨后端按会话注入
@@ -675,53 +805,136 @@ export async function renderBotDefaultsPage(root) {
         listEl.querySelectorAll('.bd-card').forEach(card => {
             const appId = card.dataset.appid;
             void ensureProfileRolesLoaded(appId, card);
-            const toggle = card.querySelector('input[data-action=toggle]');
+            // ── 默认工作目录模式（三选一互斥：off / default / oncall）─────────────────
+            const wdModeSel = card.querySelector('select[data-input=workingDirMode]');
             const input = card.querySelector('input[data-input=workingDir]');
-            const saveBtn = card.querySelector('button[data-action=save]');
+            const wdDirRow = card.querySelector('[data-wd-dir-row]');
+            const saveBtn = card.querySelector('button[data-action=save-working-dir]');
             const statusEl = card.querySelector('[data-status]');
-            if (!toggle || !input || !saveBtn || !statusEl)
+            if (!wdModeSel || !input || !saveBtn || !statusEl)
                 return; // error card
-            toggle.addEventListener('change', () => {
-                input.disabled = !toggle.checked;
-                if (toggle.checked)
+            // ── Agent CLI / model (next-session) ─────────────────────────────────
+            const agentCliSel = card.querySelector('select[data-input=agentCliId]');
+            const agentModelInput = card.querySelector('input[data-input=agentModel]');
+            const agentSaveBtn = card.querySelector('button[data-action=save-agent]');
+            const agentStatusEl = card.querySelector('[data-agent-status]');
+            function syncAgentModelField() {
+                if (!agentCliSel || !agentModelInput)
+                    return;
+                const list = card.querySelector(`#agent-model-suggestions-${CSS.escape(appId)}`);
+                const opt = selectedCliOption(agentCliSel.value);
+                const isTtadk = opt?.gateway === 'ttadk';
+                const acceptsModel = isTtadk && opt.acceptsModel !== false;
+                if (isTtadk && !acceptsModel) {
+                    if (list)
+                        list.innerHTML = '';
+                    agentModelInput.value = '';
+                    agentModelInput.disabled = true;
+                    agentModelInput.placeholder = t('botOnboarding.modelTtadkCocoPlaceholder');
+                    return;
+                }
+                agentModelInput.disabled = false;
+                if (acceptsModel) {
+                    if (list)
+                        list.innerHTML = ttadkModelSuggestions.map(m => `<option value="${escapeHtml(m)}"></option>`).join('');
+                    agentModelInput.placeholder = t('botOnboarding.modelTtadkPlaceholder').replace('{model}', ttadkModelDefault);
+                    if (!agentModelInput.value.trim())
+                        agentModelInput.value = ttadkModelDefault;
+                }
+                else {
+                    if (list)
+                        list.innerHTML = '';
+                    agentModelInput.placeholder = t('botDefaults.agentModelPlaceholder');
+                    if (agentModelInput.value.trim() === ttadkModelDefault)
+                        agentModelInput.value = '';
+                }
+            }
+            if (agentCliSel && agentModelInput && agentSaveBtn && agentStatusEl) {
+                agentCliSel.addEventListener('change', syncAgentModelField);
+                agentSaveBtn.addEventListener('click', async () => {
+                    agentStatusEl.textContent = '';
+                    agentStatusEl.className = 'oncall-status';
+                    agentSaveBtn.disabled = true;
+                    agentCliSel.disabled = true;
+                    agentModelInput.disabled = true;
+                    try {
+                        const r = await fetch(`/api/bots/${encodeURIComponent(appId)}/agent`, {
+                            method: 'PUT',
+                            headers: { 'content-type': 'application/json' },
+                            body: JSON.stringify({ cliId: agentCliSel.value, model: agentModelInput.value }),
+                        });
+                        const body = await r.json().catch(() => ({}));
+                        if (r.ok && body.ok) {
+                            agentStatusEl.textContent = `✓ ${t('botDefaults.agentSaved')}`;
+                            agentStatusEl.classList.add('hint-ok');
+                            const cached = cache.bots.find((bb) => bb.larkAppId === appId);
+                            if (cached) {
+                                cached.cliId = body.cliId;
+                                cached.wrapperCli = body.wrapperCli ?? null;
+                                cached.model = body.model ?? '';
+                                cached.agentSelectionKey = body.selectionKey ?? agentCliSel.value;
+                            }
+                        }
+                        else {
+                            agentStatusEl.textContent = `✗ ${body.error ?? r.status}`;
+                            agentStatusEl.classList.add('hint-warn-inline');
+                        }
+                    }
+                    catch (e) {
+                        agentStatusEl.textContent = `✗ ${e?.message ?? e}`;
+                        agentStatusEl.classList.add('hint-warn-inline');
+                    }
+                    finally {
+                        agentSaveBtn.disabled = false;
+                        agentCliSel.disabled = false;
+                        agentModelInput.disabled = false;
+                        syncAgentModelField();
+                    }
+                });
+            }
+            // 选「关闭」隐藏目录输入框；选其它则显示并聚焦（off 不需要目录）。
+            wdModeSel.addEventListener('change', () => {
+                const off = wdModeSel.value === 'off';
+                if (wdDirRow)
+                    wdDirRow.hidden = off;
+                if (!off)
                     input.focus();
             });
             saveBtn.addEventListener('click', async () => {
                 statusEl.textContent = '';
                 statusEl.className = 'oncall-status';
-                const enabled = toggle.checked;
+                const mode = wdModeSel.value;
                 const workingDir = input.value.trim();
-                if (enabled && !workingDir) {
+                if (mode !== 'off' && !workingDir) {
                     statusEl.textContent = t('botDefaults.required');
                     statusEl.classList.add('hint-warn-inline');
                     return;
                 }
                 saveBtn.disabled = true;
                 try {
-                    const r = await fetch(`/api/bots/${encodeURIComponent(appId)}/default-oncall`, {
+                    const r = await fetch(`/api/bots/${encodeURIComponent(appId)}/working-dir-mode`, {
                         method: 'PUT',
                         headers: { 'content-type': 'application/json' },
-                        body: JSON.stringify({ enabled, workingDir }),
+                        body: JSON.stringify({ mode, workingDir }),
                     });
                     const body = await r.json().catch(() => ({}));
                     if (r.ok && body.ok) {
                         const resolvedNote = body.resolvedPath ? ` → ${body.resolvedPath}` : '';
-                        statusEl.textContent = enabled
-                            ? `✓ 已开启${resolvedNote}（未绑定的群下次开话题自动 oncall）`
-                            : '✓ 已关闭（已绑定的群不动）';
+                        statusEl.textContent = `✓ ${t('botDefaults.workingDirSaved')}${resolvedNote}`;
                         statusEl.classList.add('hint-ok');
                         // Patch in-cache snapshot so the next manual Refresh / filter
-                        // rerender shows the new since/workingDir. We deliberately don't
-                        // call rerender() here — that would rebuild the card and wipe the
-                        // success toast the user just saw.
+                        // rerender reflects the new mode. We deliberately don't call
+                        // rerender() here — that would rebuild the card and wipe the toast.
                         const cached = cache.bots.find((b) => b.larkAppId === appId);
-                        if (cached && body.defaultOncall)
-                            cached.defaultOncall = body.defaultOncall;
-                        // Update the visible "上次启用时间" line in-place so the user
-                        // sees the timestamp jump without losing the toast.
+                        if (cached) {
+                            if (body.defaultOncall)
+                                cached.defaultOncall = body.defaultOncall;
+                            cached.defaultWorkingDir = body.defaultWorkingDir ?? null;
+                        }
+                        // Oncall 模式 re-stamps `since` → reflect it in the meta line.
                         const metaEl = card.querySelector('[data-oncall-since]');
                         if (metaEl && body.defaultOncall?.since != null) {
-                            metaEl.textContent = `上次启用时间：${fmtSince(body.defaultOncall.since)}`;
+                            metaEl.textContent = `${t('botDefaults.lastEnabled')}: ${fmtSince(body.defaultOncall.since)}`;
                         }
                     }
                     else {
@@ -889,6 +1102,67 @@ export async function renderBotDefaultsPage(root) {
                     putCardPref({ botToBotSameDir: crossBotCb.checked }, crossBotCb, crossBotStatusEl);
                 });
             }
+            // ── /summary 总结范围 ───────────────────────────────────────────────
+            const summaryLimitInput = card.querySelector('input[data-input=summaryLimit]');
+            const summarySinceInput = card.querySelector('input[data-input=summarySinceHours]');
+            const summarySaveBtn = card.querySelector('button[data-action=save-summary-trigger]');
+            const summaryStatusEl = card.querySelector('[data-summary-trigger-status]');
+            function readNonNegativeInt(input, fallback) {
+                const raw = input.value.trim();
+                if (raw === '')
+                    return fallback;
+                if (!/^(0|[1-9]\d*)$/.test(raw))
+                    return null;
+                return Number(raw);
+            }
+            if (summaryLimitInput && summarySinceInput && summarySaveBtn) {
+                summarySaveBtn.addEventListener('click', async () => {
+                    if (!summaryStatusEl)
+                        return;
+                    summaryStatusEl.textContent = '';
+                    summaryStatusEl.className = 'oncall-status';
+                    const limit = readNonNegativeInt(summaryLimitInput, 50);
+                    const sinceHours = readNonNegativeInt(summarySinceInput, 24);
+                    if (limit == null || sinceHours == null) {
+                        summaryStatusEl.textContent = `✗ ${t('botDefaults.summaryNumberInvalid')}`;
+                        summaryStatusEl.classList.add('hint-warn-inline');
+                        return;
+                    }
+                    summarySaveBtn.disabled = true;
+                    try {
+                        const r = await fetch(`/api/bots/${encodeURIComponent(appId)}/summary-range`, {
+                            method: 'PUT',
+                            headers: { 'content-type': 'application/json' },
+                            body: JSON.stringify({
+                                limit,
+                                sinceHours,
+                            }),
+                        });
+                        const body = await r.json().catch(() => ({}));
+                        if (r.ok && body.ok) {
+                            summaryStatusEl.textContent = `✓ ${t('botDefaults.cardPrefSaved')}`;
+                            summaryStatusEl.classList.add('hint-ok');
+                            const next = body.summaryRange ?? { limit, sinceHours };
+                            summaryLimitInput.value = String(Number.isInteger(next.limit) && next.limit >= 0 ? next.limit : limit);
+                            summarySinceInput.value = String(Number.isInteger(next.sinceHours) && next.sinceHours >= 0 ? next.sinceHours : sinceHours);
+                            const cached = cache.bots.find((bb) => bb.larkAppId === appId);
+                            if (cached)
+                                cached.summaryRange = next;
+                        }
+                        else {
+                            summaryStatusEl.textContent = `✗ ${body.error ?? r.status}`;
+                            summaryStatusEl.classList.add('hint-warn-inline');
+                        }
+                    }
+                    catch (e) {
+                        summaryStatusEl.textContent = `✗ ${e?.message ?? e}`;
+                        summaryStatusEl.classList.add('hint-warn-inline');
+                    }
+                    finally {
+                        summarySaveBtn.disabled = false;
+                    }
+                });
+            }
             // ── File sandbox toggle (auto-save on change) ─────────────────────────
             const sandboxCb = card.querySelector('input[data-action=toggle-sandbox]');
             const sandboxStatusEl = card.querySelector('[data-sandbox-status]');
@@ -1330,6 +1604,47 @@ export async function renderBotDefaultsPage(root) {
                     }
                 });
             }
+            // ── 启动 shell launchShell（shell 名或绝对路径；空＝清除→回 $SHELL） ──────
+            const launchShellEl = card.querySelector('input[data-input=launchShell]');
+            const launchShellSaveBtn = card.querySelector('button[data-action=save-launch-shell]');
+            const launchShellStatusEl = card.querySelector('[data-launch-shell-status]');
+            if (launchShellEl && launchShellSaveBtn) {
+                launchShellSaveBtn.addEventListener('click', async () => {
+                    if (!launchShellStatusEl)
+                        return;
+                    launchShellStatusEl.textContent = '';
+                    launchShellStatusEl.className = 'oncall-status';
+                    launchShellSaveBtn.disabled = true;
+                    try {
+                        const r = await fetch(`/api/bots/${encodeURIComponent(appId)}/launch-shell`, {
+                            method: 'PUT',
+                            headers: { 'content-type': 'application/json' },
+                            body: JSON.stringify({ launchShell: launchShellEl.value }),
+                        });
+                        const body = await r.json().catch(() => ({}));
+                        if (r.ok && body.ok) {
+                            launchShellStatusEl.textContent = `✓ ${t('botDefaults.cardPrefSaved')}`;
+                            launchShellStatusEl.classList.add('hint-ok');
+                            const next = typeof body.launchShell === 'string' ? body.launchShell : '';
+                            launchShellEl.value = next;
+                            const cached = cache.bots.find((bb) => bb.larkAppId === appId);
+                            if (cached)
+                                cached.launchShell = next;
+                        }
+                        else {
+                            launchShellStatusEl.textContent = `✗ ${body.error ?? r.status}`;
+                            launchShellStatusEl.classList.add('hint-warn-inline');
+                        }
+                    }
+                    catch (e) {
+                        launchShellStatusEl.textContent = `✗ ${e?.message ?? e}`;
+                        launchShellStatusEl.classList.add('hint-warn-inline');
+                    }
+                    finally {
+                        launchShellSaveBtn.disabled = false;
+                    }
+                });
+            }
             // ── 环境变量 env（JSON 对象；空＝清除） ──────────────────────────────
             const envEl = card.querySelector('textarea[data-input=env]');
             const envSaveBtn = card.querySelector('button[data-action=save-env]');