@deepseek-harness-tui/dsh-tui 0.12.0 → 0.14.0

package/lib/types/screens/Chat.js

@@ -1,11 +1,14 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
 import React from 'react';
 import { t, getLang, setLang, isLang, writeLangPref, readLangPref, subscribeLang, LANGS } from '../i18n.js';
+import { checkForTuiUpdate, installedTuiVersion } from '../update.js';
+import { installedKernelVersion } from '../dsh-adapter/contract.js';
 import { readThemePref } from '../themePrefs.js';
 import { readPresetPref } from '../presetPrefs.js';
 import { readModelPref } from '../modelPrefs.js';
 import { readActivityFrames } from '../activityPrefs.js';
 import { envThemeOverride } from '../components/design-system/ThemeProvider.js';
+import { resolveBrand, setActiveBrand } from '../branding.js';
 import { hasPath } from '../dsh-adapter/settingsEditor.js';
 import { planReload } from '../reload.js';
 import { AlternateScreen, Box, Image, Text, useInput, ScrollBox, useTheme, useTerminalSize } from '../ui.js';
@@ -14,11 +17,13 @@ import { POINTER } from '../terminal-utils/figures.js';
 import { isPlainReturnInput } from '../utils/modifiers.js';
 import { actionMatches, effectiveComboDisplay, primaryComboString } from '../utils/keymap.js';
 import { formatTokens } from '../terminal-utils/format.js';
+import { formatClock } from '../trajectory/format.js';
 import { homeDir } from '../utils/paths.js';
 import { execFileNoThrow } from '../utils/execFileNoThrow.js';
 import { cleanRenderText, cleanScalarText } from '../dsh-adapter/sanitize.js';
 import { deriveModelGroups, modelPickerLanding, recentCatalogModels, RECENTS_GROUP_PROVIDER, } from '../modelGroups.js';
 import { readModelRecents, recordModelUse } from '../modelRecents.js';
+import { WORKING_GATE_NOTICES } from '../commands.js';
 import { TuiDialogStore } from '../dsh-adapter/dialogs.js';
 import { TuiStatusStore } from '../dsh-adapter/status.js';
 import { ActivityStore, useActivity } from '../dsh-adapter/activity-store.js';
@@ -30,11 +35,16 @@ import { renderMathRaster } from '../math/renderer.js';
 const MATH_PREVIEW_SCALE = 2;
 const MATH_PREVIEW_MAX_COLUMNS = 480;
 const MATH_PREVIEW_MAX_ROWS = 64;
-import { runProviderWizard } from '../dsh-adapter/providerWizard.js';
-import { ApprovalStore } from '../dsh-adapter/approvals.js';
+import { runOAuthLogin, runProviderWizard } from '../dsh-adapter/providerWizard.js';
+import { useKernelPicker } from './chat/useKernelPicker.js';
+import { useBackendChannels } from './chat/useBackendChannels.js';
+import { backendModeStatus as modeStatus, backendPermissionCommand, parseMcpCommand } from './chat/backendCommands.js';
+import { PermissionStore } from '../channel/permissions.js';
+import { goalStatusLines, parseGoalCommand } from '../channel/goal-command.js';
 import { AskUserQuestionPanel } from '../components/questions/AskUserQuestionPanel.js';
 import { ApprovalPanel } from '../components/approvals/ApprovalPanel.js';
 import { ExtensionDialog } from '../components/ExtensionDialog.js';
+import { consumeBoundaryRecoveryRemount } from '../ink/update-overflow-guard.js';
 import { useSearchHighlight } from '../ink/hooks/use-search-highlight.js';
 import { useTerminalTitle } from '../ink/hooks/use-terminal-title.js';
 import { useTerminalFocus } from '../ink/hooks/use-terminal-focus.js';
@@ -44,24 +54,35 @@ import { NoSelect } from '../ink/components/NoSelect.js';
 import { LogoHeader, MessageList } from '../components/MessageList.js';
 import { splashFontIdOf } from '../components/splashFonts.js';
 import { StarPrompt, WhaleCouponPrompt } from '../components/StarPrompt.js';
-import { dueStarModal, markStarAsked, STAR_MILESTONES } from '../usageStats.js';
+import { dueStarModal, markStarAsked, pendingStarMilestone, readUsage, STAR_MILESTONES } from '../usageStats.js';
 import { TimelineRail } from '../components/TimelineRail.js';
 import { ScrollbarGutter } from '../components/ScrollbarGutter.js';
 import { normalizeScrollGutter } from '../tuiDisplayPrefs.js';
 import { OverlayAbove } from '../components/OverlayAbove.js';
 import { TooltipLayer } from '../components/Tooltip.js';
 import { PromptInput } from '../components/PromptInput.js';
+import { turnUsageParts } from '../components/TurnUsageRow.js';
+import { AgentTranscriptScene } from './AgentTranscriptScene.js';
+import { agentViewStore } from '../components/sidePanel/agentViewStore.js';
+import { agentComposeTargetOf } from '../components/messages/agentTeam.js';
 import { PromptEditorLayer, usePromptEditorOpen } from '../components/PromptEditor.js';
 import { GoalTodoPanel } from '../components/GoalTodoPanel.js';
+import { useSidePanel } from '../components/sidePanel/useSidePanel.js';
+import { jobsFocusStore } from '../components/sidePanel/jobsFocusStore.js';
+import { SidePanelLayout } from '../components/sidePanel/SidePanelLayout.js';
+import { SidePanelColumn } from '../components/sidePanel/SidePanelColumn.js';
+import { PanelPicker, usePanelPickerRows } from '../components/sidePanel/PanelPicker.js';
 import { AutoRecapRow } from '../components/AutoRecapRow.js';
 import { CompactionStatusRow } from '../components/CompactionStatusRow.js';
 import { BalanceReportRow } from '../components/BalanceReportRow.js';
 import { estimateSessionCostSnapshotCny } from '../deepseekPricing.js';
 import { LoadedContextPanel } from '../components/LoadedContextPanel.js';
-import { StatusLine } from './StatusLine.js';
+import { formatCostReport, StatusLine } from './StatusLine.js';
+import { channelContextOccupancy } from './StatusMetrics.js';
 import { WorkingSpinner, useThinkingStatus } from '../components/WorkingSpinner.js';
 import { ActivityLine, contextPressurePct } from '../components/ActivityLine.js';
 import { ModelPicker } from '../components/ModelPicker.js';
+import { HelpMenu } from '../components/HelpMenu.js';
 import { PluginSceneBoundary } from '../components/PluginSceneBoundary.js';
 import { PluginStatusViewBoundary } from '../components/PluginStatusViewBoundary.js';
 import { ImagePreviewOverlay } from '../components/ImagePreviewOverlay.js';
@@ -81,6 +102,11 @@ import { ColorPicker } from '../components/ColorPicker.js';
 import { EffortSlider } from '../components/EffortSlider.js';
 import { PresetPicker } from '../components/PresetPicker.js';
 import { PermissionsPicker } from '../components/PermissionsPicker.js';
+import { ModePicker } from '../components/ModePicker.js';
+import { KernelPicker } from '../components/KernelPicker.js';
+import { SdkInstallWizard } from '../components/SdkInstallWizard.js';
+import { ChannelPicker } from '../components/ChannelPicker.js';
+import { modeDisplayName } from '../sessionModes.js';
 import { PlanPicker } from '../components/PlanPicker.js';
 import { LangPicker } from '../components/LangPicker.js';
 import { ThemePicker, getThemeOptions } from '../components/ThemePicker.js';
@@ -89,7 +115,10 @@ import { FRAME_PRESETS, PRESET_NAMES } from '../components/activityFrames.js';
 import { ThinkingToggle } from '../components/ThinkingToggle.js';
 import { HistorySearchDialog } from '../components/HistorySearchDialog.js';
 import { RewindPicker } from '../components/RewindPicker.js';
-import { BtwPanel } from '../components/BtwPanel.js';
+import { BtwPanelFallback } from '../components/BtwPanel.js';
+import { btwThreads } from '../components/sidePanel/btw/threads.js';
+import { getBtwContextBudget, getBtwContextTurns } from '../tuiDisplayPrefs.js';
+import { BtwThreadScene } from '../components/sidePanel/btw/BtwThreadScene.js';
 import { RecapPanel } from '../components/RecapPanel.js';
 import { isValidSessionColor, SESSION_COLOR_NAMES } from '../terminal-utils/sessionColors.js';
 import { TipsPanel } from '../components/TipsPanel.js';
@@ -108,6 +137,12 @@ import { useAnimationFrame } from '../ink/hooks/use-animation-frame.js';
 import { useExternalVersion } from '../hooks/useExternalVersion.js';
 import { TrajectoryScene } from './TrajectoryScene.js';
 import { markHomeSeen } from '../homePrefs.js';
+import { markOnboardingDone } from '../onboardingPrefs.js';
+import { Launchpad, launchpadVisible } from './Launchpad.js';
+import { resolveLaunchpadActions } from '../components/launchpadActions.js';
+import { Onboarding } from './Onboarding.js';
+import { appendHistory } from '../history.js';
+import { isHiddenCommandName, isLocalCommandName, parseCommandName } from '../commands.js';
 import { extendTrajectory, projectWave } from '../dsh-adapter/trajectory/index.js';
 import { miniWakeWidth } from '../components/trajectory/MiniWake.js';
 import { readTrajectorySeen, writeTrajectorySeen } from '../trajectoryPrefs.js';
@@ -140,6 +175,27 @@ const COMMAND_RESULT_CELLS = 200;
  *  file, but a healthy import of thousands of conversations finishes well
  *  inside this; without a cap a wedged child would hang the loop forever. */
 const MIGRATE_CHILD_TIMEOUT_MS = 30 * 60 * 1000;
+/**
+ * 落地页参数行四段能点开的既有选择器（第五版）：模型 → /model、思考深度 →
+ * /effort、模式 → /plan、权限预设 → /permission。盖在落地页之上时键盘归
+ * 选择器（见 useInput 的 launchpad 分支注释）；其余 overlay 类型不在此列，
+ * 落地页期间照旧整块让位。
+ */
+const LAUNCHPAD_OVERLAY_KINDS = new Set([
+    'model', 'effort', 'plan', 'preset', 'permission', 'mode',
+    // 第七版：左下角工作目录铭牌点开的工作区菜单（及其二级选择器/流程层）
+    // 也是「盖在落地页之上」的姿态——同一套 pickerPanels 挂载，Esc 回落地页。
+    'workspace-menu', 'workspace-picker', 'workspace-flow',
+    // 第八版：帮助入口也走「盖在落地页之上」的浮层姿态（overlay kind 'help'，
+    // HelpMenu 经 pickerPanels 挂进 OverlayAbove）——不再收掉落地页进对话页。
+    'help',
+    // 内核选择器（/kernel 与启动页「内核」入口）：同一姿态盖在落地页之上，
+    // 点选即切换内核并重启（组合根的 onSwitchBackend）。
+    'kernel',
+    // SDK 安装向导（内核选择器「未安装」行 Enter 进入）：同一姿态，Esc 层级
+    // 一样——向导收回，露出落地页。
+    'sdk-install',
+]);
 function cleanCommandError(error) {
     try {
         if (error instanceof Error) {
@@ -178,6 +234,27 @@ const NO_ROWS = [];
 function capitalize(text) {
     return text.length === 0 ? text : text[0].toUpperCase() + text.slice(1);
 }
+/**
+ * The occupancy line `/tokens` and `/status` print.
+ *
+ * Occupancy has ONE source (see `dsh-adapter/context-occupancy.ts`): this is
+ * the same reading the footer's ctx field, the segmented bar and the
+ * context-low warning use — never the session's cumulative uncached input,
+ * which is a different quantity by orders of magnitude.
+ * @param channel - Live channel surface.
+ * @returns The localized line, or `undefined` when no window is known.
+ */
+function contextOccupancyLine(channel) {
+    const occupancy = channelContextOccupancy(channel);
+    if (occupancy === undefined || occupancy.contextWindow === undefined || occupancy.contextWindow <= 0)
+        return undefined;
+    const percent = Math.max(0, Math.min(100, Math.round((occupancy.usedTokens / occupancy.contextWindow) * 100)));
+    return t('context-occupancy', {
+        percent,
+        used: formatTokens(occupancy.usedTokens),
+        window: formatTokens(occupancy.contextWindow),
+    });
+}
 /** Terminal-title spinner frames. */
 const TITLE_SPINNER_FRAMES = ['⠂', '⠐'];
 /** Searchable transcript text for one row (`/` incsearch):
@@ -230,7 +307,7 @@ const noCouponSnapshot = () => null;
 function peekKey(image, title) {
     return `${title ?? ''} ${image.id}`;
 }
-export function Chat({ channel, questionStore, approvalStore, extensionDialogs, bonusNotices, extensionStatus, activityStore, extensionShortcuts, themeHost, onExit, onUpdate, onRestart, fullscreen = false, trajectorySeen: trajectorySeenProp, injectControllerRef, promptControllerRef: promptControllerRefProp, renderScene, openHomeOnBoot, starPrompt, }) {
+export function Chat({ channel, questionStore, approvalStore, extensionDialogs, bonusNotices, extensionStatus, activityStore, extensionShortcuts, themeHost, onExit, onUpdate, onRestart, onSwitchBackend, onRestartFreshSession, onProbeKernels, onResolveSdkInstallTarget, onStartSdkInstall, onCheckPnpm, sdkInstallPinned, kernelPinned, fullscreen = false, trajectorySeen: trajectorySeenProp, injectControllerRef, promptControllerRef: promptControllerRefProp, renderScene, openHomeOnBoot, launchpadOnBoot, onboardingOnBoot, starPrompt, }) {
     const writeRaw = React.useContext(TerminalWriteContext);
     // Re-render whenever the channel mutates; rows/status are read fresh below.
     // DEFAULT lane on purpose (useExternalVersion): the channel version bumps
@@ -251,7 +328,7 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
     // parks here until the panel decides; shown with priority over a pending
     // questionnaire since it gates a tool about to run. Hosts that pass no
     // approvalStore share one inert instance that never holds an ask.
-    const approvals = approvalStore ?? (fallbackApprovalStore ??= new ApprovalStore());
+    const approvals = approvalStore ?? (fallbackApprovalStore ??= new PermissionStore());
     const approvalSnapshot = React.useSyncExternalStore(listener => approvals.subscribe(listener), () => approvals.getSnapshot());
     // The pending managed plugin dialog (tuiDialogs seam): a plugin's
     // select/confirm/input request parks here until the panel settles it.
@@ -350,7 +427,9 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
     /** Provider display identities for the /model group level; refreshed alongside `models`. */
     const [providerInfos, setProviderInfos] = React.useState([]);
     /** /model 最近使用分组：成功切换即记录（去重置顶，上限 10），重启保留。 */
-    const [modelRecents, setModelRecents] = React.useState(() => readModelRecents());
+    // Recents are per backend: a Claude session's picks never evict the DSH list.
+    const recentsBackend = channel.backendCapabilities?.backendId;
+    const [modelRecents, setModelRecents] = React.useState(() => readModelRecents(undefined, recentsBackend));
     /** Two-level /model: the drilled-in provider route; undefined = group level.
      *  Reset on open; stale ids resolve back to the group level via `activeModelGroup`. */
     const [modelGroup, setModelGroup] = React.useState(undefined);
@@ -384,7 +463,7 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
                 return ok;
             if (name !== undefined)
                 channel.notify(t('model-switched', { name }));
-            setModelRecents(recordModelUse({ provider, id }));
+            setModelRecents(recordModelUse({ provider, id }, undefined, recentsBackend));
             return ok;
         });
     };
@@ -408,7 +487,202 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
      * on" has not been answered yet. Every later launch starts on the chat
      * screen, and the screen stays reachable.
      */
-    const [supervisorOpen, setSupervisorOpen] = React.useState(openHomeOnBoot === true);
+    // 根错误边界恢复后的重挂不是一次启动：启动页、首启引导与会话管理屏都
+    // 不再打开，直接回到对话页（一次性标记由错误边界的恢复路径写入，见
+    // update-overflow-guard）。首次渲染即消费；若这次渲染被丢弃，最坏只是
+    // 多显示一次启动入口。
+    const recoveryRemountOnBoot = consumeBoundaryRecoveryRemount();
+    // 第七版：启动页在开时**不再**预开会话浏览器。旧姿态是「先收落地页再开
+    // 整屏」，浏览器必须提前藏在下面；现在整屏（会话/设置/任务面板）盖在
+    // 落地页**之上**、Esc 退回落地页，按需打开即可——boot 时同时为真反而会
+    // 让浏览器盖住落地页（渲染顺序见各 early-return）。恢复重挂同样不开它。
+    const [supervisorOpen, setSupervisorOpen] = React.useState(openHomeOnBoot === true && launchpadOnBoot !== true && !recoveryRemountOnBoot);
+    /**
+     * The launchpad: the landing page every ordinary launch starts on.
+     *
+     * Seeded from `launchpadOnBoot`, and the screen that closes it is the one
+     * that decides what comes next — a submitted line hands over to the chat
+     * screen, an action hands over to whatever surface that action opens.
+     */
+    const [launchpadOpen, setLaunchpadOpen] = React.useState(launchpadOnBoot === true && !recoveryRemountOnBoot);
+    /**
+     * The launchpad's draft. It lives HERE, not inside the screen, because the
+     * screen unmounts the moment the user submits: a draft owned by an
+     * unmounting component would be lost in exactly the transition it exists
+     * to carry.
+     */
+    const [launchpadDraft, setLaunchpadDraft] = React.useState('');
+    const [launchpadCaret, setLaunchpadCaret] = React.useState(0);
+    const [launchpadFocus, setLaunchpadFocus] = React.useState(-1);
+    /**
+     * 「整屏盖启动页」的显式授权（第七版防御位，用户实测回归：启动页一闪而过
+     * 被顶掉）。整屏分支排在落地页**之前**，任何一处状态在开机后被异步置真
+     * （杂散输入/宿主事件/未来新代码）都会把落地页挤掉。授权位只有**从落地页
+     * 出发的交互**（入口行/空输入 Esc/目录铭牌/命令面板里的整屏命令、Continue
+     * 的兜底浏览器）才置真；覆盖屏全部收起时自动落 false。开机后即便某个整屏
+     * 状态被误置真，落地页仍在最上层——「浮层可以盖、整屏必须经授权」。
+     */
+    const launchpadCoverRef = React.useRef(false);
+    /**
+     * 这一帧到底出不出落地页：状态开着还不够，minimal 模式（`dsh-tui.minimal`）
+     * 下它整块不存在——`minimalMode.ts` 的标志由 channel 在设置落地后写入，
+     * 建 state 时读不到，所以判定必须放在**渲染期**读（与其它 minimal 门同一口径）。
+     * 键盘守卫、渲染分支与"有没有整屏界面"的判定都认这一个值，三者不会分叉。
+     */
+    /**
+     * 右下角铭牌的版本号：`installedTuiVersion()` 每次都要读一遍 package.json，
+     * 而它在一个进程里不会变——mount 时读一次就够。
+     */
+    const tuiVersion = React.useMemo(() => installedTuiVersion(), []);
+    /**
+     * 内核（dsh）版本（第七版：落地页右下角双版本铭牌）。真实来源见
+     * `contract.installedKernelVersion`（宿主 CLI 的 manifest，回落内核线包）；
+     * 两级都读不到 = undefined → 铭牌只画 TUI 段，绝不编造。
+     */
+    const kernelVersion = React.useMemo(() => installedKernelVersion(), []);
+    const launchpadShown = launchpadOpen && launchpadVisible();
+    /**
+     * 落地页之上是否盖着一个参数选择器（第五版：参数行四段各自可点，点开的
+     * 是聊天页同一套 /model · /effort · /plan · /permission overlay）。这时
+     * 键盘归选择器（Esc 关它回到落地页），渲染也要把 pickerPanels 带进
+     * 落地页分支——不然整屏 early-return 把 overlay 吞了，"点了没反应"。
+     */
+    const launchpadOverlayUp = launchpadShown && LAUNCHPAD_OVERLAY_KINDS.has(overlay.kind);
+    /**
+     * 渲染在**覆盖层**（而不是整屏 early-return）的那几个命令。
+     *
+     * 落地页的快捷入口与向导招式卡的「试一下」都走 `runCommand`，而 supervisor /
+     * settings / help 的 early-return 排在两个界面**之后**：不收掉当前界面就是
+     * "点了没反应"，状态还滞留着、等界面关掉才突然弹出来。默认收，白名单只留给覆盖层。
+     */
+    const overlayCommandNames = React.useMemo(() => new Set(['model', 'effort', 'plan', 'preset', 'permission', 'kernel']), []);
+    /**
+     * 打开**整屏界面**的命令（第七版）：从落地页触发这些命令时**不收掉落地页**
+     * ——整屏盖在落地页之上渲染（它们的 early-return 排在落地页分支之前），
+     * Esc 退出整屏回到落地页（草稿/参数/焦点原样保留）。这是「从启动页进入
+     * 对话页的唯一路径 = Enter 提交一条非命令消息」的落地：任何返回键都不再
+     * 把人甩到对话页。其余命令（star / update / help / 转录输出类）的反馈在
+     * 对话页，仍按旧约收掉落地页再执行。
+     */
+    const launchpadScreenCommands = React.useMemo(() => new Set(['home', 'resume', 'agentview', 'settings', 'jobs', 'tree', 'agents', 'setup', 'bg', 'background']), []);
+    /**
+     * 落地页条件位②（有新版本）：`checkForTuiUpdate()`（与 /update 同一条
+     * 判定，src/update.ts）在启动页第一次挂起时后台探一次——registry 延迟
+     * 不许拖慢第一帧；失败/离线静默为 false（绝不放假按钮）。
+     */
+    const [launchpadUpdateAvailable, setLaunchpadUpdateAvailable] = React.useState(false);
+    const launchpadUpdateProbedRef = React.useRef(false);
+    React.useEffect(() => {
+        if (!launchpadShown || launchpadUpdateProbedRef.current)
+            return;
+        launchpadUpdateProbedRef.current = true;
+        void checkForTuiUpdate().then(update => {
+            setLaunchpadUpdateAvailable(update !== undefined);
+        }).catch(() => undefined);
+    }, [launchpadShown]);
+    const canInstallSdk = onResolveSdkInstallTarget !== undefined && onStartSdkInstall !== undefined
+        && onCheckPnpm !== undefined && sdkInstallPinned !== undefined;
+    const { currentId: kernelCurrentId, options: kernelOptions, open: openKernelPicker, pick: pickKernel, reprobe: reprobeKernels } = useKernelPicker({
+        channel, kernelVersion, launchpadShown, onProbeKernels, onSwitchBackend, canInstallSdk, dispatchOverlay,
+    });
+    /**
+     * SDK 安装向导的步骤态（异步进程状态，按 chatOverlay 的分工留在 Chat，
+     * 不进 overlay union）。生命周期约定：向导打开时从 idle 初始化，安装
+     * （checking/running）期间面板保持打开——所有异步落地都发生在面板还在
+     * 的窗口内；关闭路径（Esc/Enter 离开）一律重置回 idle，下一次打开重新
+     * 解析安装目标。
+     */
+    const [sdkPhase, setSdkPhase] = React.useState({ kind: 'idle' });
+    const sdkInstallerRef = React.useRef(undefined);
+    // 打开即解析安装目标（同步、只读 argv + 文件系统）：profile → 确认面板；
+    // standalone / 无 profile → 直接给手动指引面板。
+    React.useEffect(() => {
+        if (overlay.kind !== 'sdk-install' || sdkPhase.kind !== 'idle' || onResolveSdkInstallTarget === undefined)
+            return;
+        const target = onResolveSdkInstallTarget();
+        if (target.kind === 'profile' && sdkInstallPinned !== undefined) {
+            setSdkPhase({ kind: 'confirm', dir: target.dir, version: sdkInstallPinned.version, specifier: sdkInstallPinned.specifier });
+        }
+        else {
+            setSdkPhase({ kind: 'no-target', reason: target.kind === 'standalone' ? 'standalone' : 'no-profile' });
+        }
+    }, [overlay.kind, sdkPhase.kind, onResolveSdkInstallTarget, sdkInstallPinned]);
+    const closeSdkInstallToKernelPicker = () => {
+        setSdkPhase({ kind: 'idle' });
+        dispatchOverlay({ type: 'close' });
+        openKernelPicker();
+    };
+    const closeSdkInstall = () => {
+        setSdkPhase({ kind: 'idle' });
+        dispatchOverlay({ type: 'close' });
+    };
+    const runSdkInstall = (dir) => {
+        if (onStartSdkInstall === undefined || sdkInstallPinned === undefined)
+            return;
+        const installer = onStartSdkInstall(dir);
+        sdkInstallerRef.current = installer;
+        setSdkPhase({ kind: 'running' });
+        void installer.result.then(result => {
+            if (result.kind === 'ok') {
+                // 装好了：重探内核（灰行变亮，无需重启进程），停在完成面板。
+                reprobeKernels();
+                setSdkPhase({ kind: 'done' });
+            }
+            else if (result.kind === 'failed') {
+                setSdkPhase({ kind: 'failed', exitCode: result.exitCode, tail: result.tail, dir, version: sdkInstallPinned.version, specifier: sdkInstallPinned.specifier });
+            }
+            else if (result.kind === 'pnpm-missing') {
+                setSdkPhase({ kind: 'pnpm-missing', dir, version: sdkInstallPinned.version, specifier: sdkInstallPinned.specifier });
+            }
+            else {
+                setSdkPhase({ kind: 'cancelled' });
+            }
+        });
+    };
+    const confirmSdkInstall = (dir) => {
+        if (onCheckPnpm === undefined)
+            return;
+        setSdkPhase({ kind: 'checking' });
+        void onCheckPnpm().then(ok => {
+            if (!ok && sdkInstallPinned !== undefined) {
+                setSdkPhase({ kind: 'pnpm-missing', dir, version: sdkInstallPinned.version, specifier: sdkInstallPinned.specifier });
+                return;
+            }
+            runSdkInstall(dir);
+        });
+    };
+    const host = channel.backendChannels?.();
+    const { rows: channelRows, open: openChannelPicker, pick: pickChannel, setMode: runBackendModeCommand, login: runBackendLogin } = useBackendChannels({
+        channel, host, questionStore, dispatchOverlay, onRestartFreshSession, runOAuthLogin,
+    });
+    /**
+     * 落地页条件位③（投喂一颗 Star）：与开屏求 star 弹窗**同一口径**——
+     * `usageStats`（~/.dsh-tui/usage.json）里有未报过的已达档里程碑
+     * （`pendingStarMilestone`，首档 24h）且本进程尚未 star 成功。star 成功
+     * 后（`starred` 翻真）按钮立即消失；记账过的档不再纠缠。
+     */
+    /**
+     * The first-run guide. Renders above the launchpad (see the prop docs): a
+     * launch that needs setup has not answered the launchpad's question yet.
+     */
+    const [onboardingOpen, setOnboardingOpen] = React.useState(onboardingOnBoot === true && !recoveryRemountOnBoot);
+    /**
+     * 落地页那条"第一次用？跑一遍引导"的横幅认的是**还欠一次引导**，而不是启动快照：
+     * 完成（写进 onboarding.json）之后立刻收掉；跳过刻意保留——没记账，下次启动还会问，
+     * 横幅说的正是这件事。
+     */
+    const [onboardingPending, setOnboardingPending] = React.useState(onboardingOnBoot === true && !recoveryRemountOnBoot);
+    /**
+     * 品牌档（`branding.ts`）：设置项 `dsh-tui.brand`（`auto` = 跟后端）与当前
+     * 后端 id（`backendCapabilities.backendId`，boot 时即定）的合成。开屏词、
+     * 立绘、大字配色读 prop；主题默认档经 `setActiveBrand` 镜像给
+     * ThemeProvider（它挂在 Chat 外层，拿不到 channel）——plugin 已在首帧前
+     * 铺过初值，这里负责 `/settings` 切品牌时的实时跟动。
+     */
+    const brand = resolveBrand(channel.brand, channel.backendCapabilities?.backendId);
+    React.useEffect(() => {
+        setActiveBrand(brand);
+    }, [brand]);
     /** `/tree` opens the session family tree (pi's Session Tree): every rewind
      *  fork stitched back onto the message it diverged from, hover previews,
      *  and per-node rewind/fork/adopt actions. Like the supervisor, a screen. */
@@ -425,11 +699,19 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
     const EMPTY_AGENT_VIEW_ROWS = [];
     const agentViewRows = React.useSyncExternalStore(listener => channel.subscribeAgentView?.(listener) ?? (() => { }), () => channel.agentViewRows?.() ?? EMPTY_AGENT_VIEW_ROWS);
     const backgroundAgentsNeedingInput = agentViewRows.filter(row => row.status === 'needs-input' && !row.current).length;
-    /** Background the attached session and open the supervisor
-     *  (`/bg`, `/background`, and ← on an empty prompt all land here). The
-     *  backgrounded session becomes the screen's return target (final Esc
-     *  attaches back to it). */
+    /** Open the supervisor from `/bg`, `/background`, or an empty-prompt ←.
+     *  DSH backgrounds the attached session first and uses it as the Esc
+     *  return target; other backends keep the current session attached. */
     const backgroundToAgentView = React.useCallback(() => {
+        // The non-DSH backends have a session catalog, but no live background
+        // handoff. Open the shared session manager without pretending to park the
+        // current turn. DSH keeps its existing handoff and Esc return target.
+        const backendId = channel.backendCapabilities?.backendId;
+        if (backendId !== undefined && backendId !== 'dsh') {
+            agentViewOpenSessionRef.current = channel.agentId;
+            setSupervisorOpen(true);
+            return;
+        }
         void channel.backgroundCurrent().then((result) => {
             if (result.ok) {
                 setAgentViewReturnId(result.backgroundedSessionId);
@@ -448,6 +730,16 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
      * `null` 显式关闭，传 actions 覆写两个按钮（不跑真 gh、不开真浏览器）。 */
     /** 本次会话是否已经 star 成功（开屏彩蛋标题切「捡到小星星啦」）。 */
     const [starred, setStarred] = React.useState(false);
+    /**
+     * 落地页条件位③（投喂一颗 Star）：与开屏求 star 弹窗**同一口径**——
+     * `usageStats`（~/.dsh-tui/usage.json）里有未报过的已达档里程碑
+     * （`pendingStarMilestone`，首档 24h）且本进程尚未 star 成功。star 成功
+     * 后（`starred` 翻真）按钮立即消失；记账过的档不再纠缠。readUsage 是
+     * 文件读，只在 starred 翻真或测试缝变化时重算，不逐帧读盘。
+     */
+    const launchpadStarDue = React.useMemo(() => !starred && pendingStarMilestone(readUsage(starPrompt?.dir)) !== null, 
+    // eslint-disable-next-line react-hooks/exhaustive-deps -- dir 经测试缝注入
+    [starred, starPrompt]);
     const [starModal, setStarModal] = React.useState(null);
     // 单发闩：只在第一个"安静的开屏视口"上武装定时器。700ms 窗口内整屏
     // 界面打开 → cleanup 掐掉定时器且**不再重臂**（记账只发生在回调里，
@@ -462,7 +754,7 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
             return;
         if (starPrompt === null)
             return;
-        if (supervisorOpen || treeOpen || settingsOpen || channel.working)
+        if (supervisorOpen || treeOpen || settingsOpen || launchpadShown || onboardingOpen || channel.working)
             return;
         starModalArmedRef.current = true;
         // 让开屏先画半秒：弹窗压在介绍动画之上，而不是同抢第一帧。
@@ -484,7 +776,7 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
         }, 700);
         return () => { clearTimeout(timer); };
         // eslint-disable-next-line react-hooks/exhaustive-deps -- 只在整屏界面开合时重判；闩保证只武装一次
-    }, [supervisorOpen, treeOpen, settingsOpen]);
+    }, [supervisorOpen, treeOpen, settingsOpen, launchpadShown, onboardingOpen]);
     /** `/star` 命令、开屏标语的点击/`Alt+S` 共用的一键动作：异步跑 gh，界面
      * 全程不阻塞，结果回来按四类各报一句（成功 / 没装 gh / 没登录 / 失败）。
      * `starPrompt.onStar` 存在时走同一条测试缝（夹具因此不会真的去 star）。 */
@@ -593,10 +885,35 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
     const workspaceFlowAbortRef = React.useRef(null);
     /** `/preset` agent-preset roster (issue #8): loads async, persists. */
     const [presetOptions, setPresetOptions] = React.useState([]);
+    /**
+     * 落地页参数行的模式段（第六版设计 1）显示 preset 的**显示名**
+     * （Standard/PTC/极简…），名册是异步的——落地页出来时顺手预热一次
+     * （空名册不写；失败静默，段缺省不画）。/preset 自己的加载路径不动。
+     */
+    React.useEffect(() => {
+        if (!launchpadShown || presetOptions.length > 0)
+            return;
+        let cancelled = false;
+        channel.listPresets()
+            .then(list => { if (!cancelled && list.length > 0)
+            setPresetOptions(list); })
+            .catch(() => { });
+        return () => { cancelled = true; };
+    }, [launchpadShown, presetOptions.length, channel]);
     /** `/effort` adapter levels: load async before the slider opens. */
     const [effortOptions, setEffortOptions] = React.useState([]);
+    /** True when those levels are the CLI-standard compatibility ladder (the
+     *  model row declares no tiers of its own) — the slider says so. */
+    const [effortLevelsFallback, setEffortLevelsFallback] = React.useState(false);
     const [themeName, setTheme] = useTheme();
     const { rows: terminalRows } = useTerminalSize();
+    /**
+     * 帮助盖屏（第八版，overlay kind 'help'）的滚动视口：HelpMenu 自带
+     * ScrollBox，键盘（↑/↓/PgUp/PgDn/Home/End）由 Chat 的 overlay 分支驱动。
+     * 视口预算与 PromptInput 的 helpViewportHeight 同式（PR #446 的口径）。
+     */
+    const helpCoverScrollRef = React.useRef(null);
+    const helpCoverViewportHeight = Math.max(3, Math.min(terminalRows - 7, 15));
     const [showAllMessages, setShowAllMessages] = React.useState(false);
     /** Scope the fold to this question: an aborted ask can promote its queued
      *  successor without ever publishing an idle (null) snapshot. */
@@ -612,15 +929,31 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
      *  plugin answering after the user moved on must not open a confirm for
      *  a row they are no longer looking at). */
     const rewindRequestRef = React.useRef(0);
-    /** /btw side-question overlay: pure UI state — the answer never
-     *  enters the transcript or the session log. */
-    const [btw, setBtw] = React.useState(null);
-    const btwAbortRef = React.useRef(null);
-    const closeBtw = () => {
-        btwAbortRef.current?.abort();
-        btwAbortRef.current = null;
-        setBtw(null);
+    /** /btw side-question thread: pure UI state in btwThreads — the answers
+     *  never enter the transcript or the session log. The floating overlay is
+     *  only the FALLBACK surface (btw panel not enabled); with the panel
+     *  enabled the same thread routes to the sidebar instead — one answer,
+     *  exactly one surface. */
+    const [btwOverlayOpen, setBtwOverlayOpen] = React.useState(false);
+    /** ⤢ fullscreen thread scene (openPanelFullscreen 'btw' route). */
+    const [btwSceneOpen, setBtwSceneOpen] = React.useState(false);
+    // Only the fallback overlay reads the thread here. With the overlay closed
+    // the snapshot stays undefined, so an answer streaming into the sidebar
+    // panel does not re-render the whole Chat on every delta.
+    const btwOverlayThread = React.useSyncExternalStore(btwThreads.subscribe, () => (btwOverlayOpen ? btwThreads.get(String(channel.agentId)) : undefined));
+    const closeBtwOverlay = () => {
+        // Fallback parity with the pre-thread overlay: closing cancels the
+        // in-flight ask (completed turns stay in the thread).
+        btwThreads.abortActive(String(channel.agentId));
+        setBtwOverlayOpen(false);
     };
+    /** 有模态或整屏界面时，/btw 的回答不抢着打开面板，只标未读。 */
+    const btwSurfaceFree = () => approvalSnapshot === null && dialogSnapshot === null && questionSnapshot === null
+        && overlay.kind === 'none' && !helpOpen && !starModal && !couponVisible
+        && !supervisorOpen && !treeOpen && !settingsOpen && !jobsPanelOpen
+        && !sceneOpen && channel.pluginScene === undefined
+        && !subagentDashboardOpen && subagentDetailId === null
+        && !onboardingOpen && !launchpadShown && !btwSceneOpen && !promptEditorOpen;
     /** /recap overlay (pi-recap semantics): pure UI state like /btw — the
      *  summary never enters the transcript or session log; applying the
      *  proposed title goes through the normal /rename path. `auto` marks the
@@ -657,14 +990,11 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
         balanceSeqRef.current += 1;
         setBalance(null);
     }, [balanceSessionId]);
-    // A side question belongs to its captured session just like a recap. Chat
-    // remains mounted across /resume, so explicitly retire its request/UI when
-    // the binding changes instead of allowing a former conversation to finish.
-    React.useEffect(() => {
-        btwAbortRef.current?.abort();
-        btwAbortRef.current = null;
-        setBtw(null);
-    }, [channel.agentId]);
+    // A side question belongs to its captured session just like a recap. The
+    // THREAD stays in memory under its own session id (an archived thread may
+    // keep streaming); only the FALLBACK overlay is retired on a binding change
+    // (see the btwSessionIdRef effect above) so an old conversation never leaks
+    // onto the new one's screen.
     // Auto-recap (`dsh-tui.recapOnOpen`): every time the session switches
     // (mount = open/resume, rewind/fork included), summarize its tail into
     // the dim AutoRecapRow. Failures stay silent in auto mode — `/recap`
@@ -755,7 +1085,7 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
         setSearchCursor(0);
         setSearchCount(0);
         setSearchCurrent(0);
-        closeBtw();
+        setBtwOverlayOpen(false);
         repaintTranscript();
     }, [channel.agentId]); // eslint-disable-line react-hooks/exhaustive-deps
     /** The session attached when the agent view opened; a close on a
@@ -772,17 +1102,102 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
     /** Subagent dashboard (Ctrl+A): displays active/completed subagents. */
     const [subagentDashboardOpen, setSubagentDashboardOpen] = React.useState(false);
     const [jobsPanelOpen, setJobsPanelOpen] = React.useState(false);
+    /** Job id the panel should focus on open: set by a transcript card click
+     *  (open the panel AT that job), cleared on close so the keyboard/command
+     *  path reopens at the top. */
+    const [jobsPanelFocusId, setJobsPanelFocusId] = React.useState(null);
+    // Side-panel routing needs the controller, which is created further down;
+    // a ref keeps this identity-stable callback fresh anyway.
+    const sidePanelRef = React.useRef(null);
     // MessageList forwards these open handlers to every memoized row. Their
     // identities must survive token/metrics updates, including for tool rows.
-    const openJobsPanel = React.useCallback(() => setJobsPanelOpen(true), []);
+    const openJobsPanel = React.useCallback((focusId) => {
+        const sidePanel = sidePanelRef.current;
+        // Split mode: open the jobs side panel at the requested job (the focus
+        // lane carries the id; a fresh nonce refocuses even for the same id).
+        if (sidePanel !== null && sidePanel.split && sidePanel.enabledPanelIds.includes('jobs')) {
+            if (typeof focusId === 'string' && focusId !== '')
+                jobsFocusStore.request(focusId);
+            sidePanel.openPanel('jobs', { focus: true });
+            return;
+        }
+        // Narrow / inline fallback: the full-screen overlay (unchanged).
+        if (typeof focusId === 'string' && focusId !== '')
+            setJobsPanelFocusId(focusId);
+        setJobsPanelOpen(true);
+    }, []);
+    // A job card / the panel keeps its output tail fresh while on screen, when
+    // the backend reads output on demand. The control is re-projected on every
+    // read; this handler keeps one identity per channel capability so the
+    // memoized rows are not re-rendered by it.
+    const jobControlRef = React.useRef(channel.jobControl);
+    jobControlRef.current = channel.jobControl;
+    const jobOutputWatchable = typeof channel.jobControl?.watchOutput === 'function';
+    const watchJobOutput = React.useMemo(() => jobOutputWatchable ? (id) => jobControlRef.current?.watchOutput?.(id) ?? (() => undefined) : undefined, [jobOutputWatchable]);
+    /** Ctrl+A / detail 回退：侧栏分栏且 agents 已启用时打开右栏 Panel（内部
+     *  dashboard ↔ detail 二级路由自己管）；窄屏 / inline 保留整屏形态。 */
+    const openSubagentDashboard = React.useCallback(() => {
+        const sidePanel = sidePanelRef.current;
+        if (sidePanel !== null && sidePanel.split && sidePanel.enabledPanelIds.includes('agents')) {
+            sidePanel.openPanel('agents', { focus: true });
+            return;
+        }
+        setSubagentDashboardOpen(true);
+    }, []);
     /** Detail view for a specific subagent (opened from dashboard). */
     const [subagentDetailId, setSubagentDetailId] = React.useState(null);
+    /**
+     * 主屏只读 Agent View：Chat 自己的场景层。父 Chat、Channel 与 PromptInput
+     * 保持挂载（草稿经 draftCache 往返），场景只借用屏幕与键盘；Esc 回到打开它
+     * 的地方（对话 / 代理面板 / 详情 / 转录卡）。不建第二个 Channel。
+     */
+    const [agentView, setAgentView] = React.useState(null);
+    const openAgentView = React.useCallback((agentId, source) => {
+        setAgentView({ agentId, source });
+    }, []);
+    /** 工作台里切到同级或父代理：原地换被查看的代理，Esc 仍回最初的入口。 */
+    const switchViewedAgent = React.useCallback((agentId) => {
+        setAgentView(prev => prev === null ? prev : { ...prev, agentId });
+    }, []);
+    /** 转录卡入口的稳定句柄：MessageList 的 memo 行按 props 身份比较，内联
+     *  箭头会让每个流式 tick 重渲染全部落定行（verify-tool-history-window）。 */
+    const openSubagentViewFromCard = React.useCallback((agentId, rowId) => {
+        openAgentView(agentId, { kind: 'transcript-card', rowId });
+    }, [openAgentView]);
+    // 侧栏 agents 面板 / 其 Detail 的主屏查看请求（面板没有 Chat 的场景 state）。
+    React.useEffect(() => agentViewStore.subscribe(() => {
+        const request = agentViewStore.get();
+        if (request === null)
+            return;
+        const source = request.source === 'agents-dashboard'
+            ? { kind: 'agents-dashboard', ...(request.panel ? { panel: true } : {}) }
+            : { kind: 'agent-detail', agentId: request.agentId, ...(request.panel ? { panel: true } : {}) };
+        setAgentView({ agentId: request.agentId, source });
+    }), []);
+    /** Esc 的返回路由：面板来源回面板（路由经模块记忆保真），整屏来源回整屏。 */
+    const exitAgentView = React.useCallback((source) => {
+        setAgentView(null);
+        const sidePanel = sidePanelRef.current;
+        const panelReturn = (sidePanel !== null && sidePanel.split && sidePanel.enabledPanelIds.includes('agents'));
+        if (source.kind === 'agents-dashboard') {
+            if (source.panel === true && panelReturn)
+                sidePanel.openPanel('agents', { focus: true });
+            else
+                setSubagentDashboardOpen(true);
+            return;
+        }
+        if (source.kind === 'agent-detail') {
+            if (source.panel === true && panelReturn)
+                sidePanel.openPanel('agents', { focus: true });
+            else
+                setSubagentDetailId(source.agentId);
+        }
+    }, []);
     /**
      * Hidden `/deepseek` easter egg: each invocation bumps this key so the
      * logo header remounts and replays the whale spout + text shimmer.
      */
     const [logoNonce, setLogoNonce] = React.useState(0);
-    React.useEffect(() => () => btwAbortRef.current?.abort(), []);
     React.useEffect(() => () => recapAbortRef.current?.abort(), []);
     /**
      * The trajectory scene (issue #80 evolution). Unlike every other overlay
@@ -802,16 +1217,64 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
     const closeScene = React.useCallback(() => {
         setSceneOpen(false);
     }, []);
-    /** Open the scene, mark failures seen, and retire the key hint for good. */
-    const openScene = React.useCallback(() => {
+    /**
+     * 整屏分支的「盖启动页」闸门（第七版防御位，用户实测回归：启动页一闪
+     * 而过被顶掉）。落地页在屏上时，只有**经 `launchpadCoverRef` 授权**
+     * （= 从落地页出发的交互打开）的整屏才盖它；否则该整屏状态被无视
+     * （渲染落到落地页），启动页永远不被开机期的杂散状态挤掉。落地页不在
+     * 屏上时闸门恒开（普通姿态与从前逐字节一致）。
+     *
+     * ⚠ 这一段必须排在组件**所有** early-return 之前（hooks 规则）：曾放在
+     * onboarding/interrupt 分支之后，向导一开就少跑这个 effect，React 直接
+     * 报 hooks 乱序（verify-launchpad-onboarding-chat A2/E5/H2 全红）。
+     */
+    const launchpadGate = () => !launchpadShown || launchpadCoverRef.current;
+    // 覆盖屏全部收起时收回授权：下一次打开必须再经过落地页自己的交互。
+    const launchpadCoverScreenUp = supervisorOpen || treeOpen || settingsOpen
+        || jobsPanelOpen || subagentDashboardOpen || subagentDetailId !== null || sceneOpen
+        || agentView !== null
+        || btwSceneOpen;
+    React.useEffect(() => {
+        if (!launchpadCoverScreenUp)
+            launchpadCoverRef.current = false;
+    }, [launchpadCoverScreenUp]);
+    /**
+     * 从落地页出发的交互要开整屏前先授权（配合 `launchpadGate`）：调用点只在
+     * 落地页自己的回调里（onAction / onCommandPick / onEscape 的会话浏览路）。
+     * 异步误置真的整屏状态没有这道授权 → 闸门挡下，落地页留在最上层。
+     */
+    const authorizeLaunchpadCover = () => { launchpadCoverRef.current = true; };
+    /**
+     * Open the trajectory, mark failures seen, and retire the key hint for good.
+     *
+     * Ctrl+T and `/trace` share this one entry point, and it is SPLIT-AWARE the
+     * same way `/jobs` and `/agents` already are: while the sidebar is
+     * rendering, the trajectory opens as the `trajectory` panel inside it
+     * instead of taking the whole screen. `options.fullscreen` is the escape
+     * hatch the panel's own ⤢ button uses — without it that button would route
+     * straight back into the panel it is trying to leave.
+     */
+    const openScene = React.useCallback((options) => {
+        // /trace, Ctrl+T, the sidebar tab and ⤢ all open the trajectory. A
+        // kernel without a trajectory source reports 'unsupported' and the
+        // scene/panel say so; no entry point refuses on its own, so they can
+        // never disagree about the capability.
         seenFailuresRef.current = trajectoryRef.current?.counts.errors ?? 0;
         setTrajectorySeen(previous => {
             if (!previous)
                 writeTrajectorySeen();
             return true;
         });
+        const controller = sidePanelRef.current;
+        if (options?.fullscreen !== true
+            && controller !== null
+            && controller.split
+            && controller.enabledPanelIds.includes('trajectory')) {
+            controller.openPanel('trajectory', { focus: true });
+            return;
+        }
         setSceneOpen(true);
-    }, []);
+    }, [channel]);
     /**
      * Leave the session supervisor for the conversation.
      *
@@ -840,6 +1303,32 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
             }).catch(() => undefined);
         }
     }, [agentViewReturnId, channel, repaintTranscript]);
+    /**
+     * Leave the first-run guide.
+     *
+     * `done` writes the one-shot marker; `skipped` deliberately does NOT — the
+     * user has not answered, and a later launch is exactly when they might.
+     * Both cases land on the launchpad rather than the transcript: the wizard
+     * interrupted a launch, so the launch resumes where it left off.
+     *
+     * The write is best-effort by design (`markOnboardingDone` returns false
+     * when the data directory is unwritable); a read-only install gets one more
+     * offer next launch, which is the recoverable end of the trade.
+     */
+    const closeOnboarding = React.useCallback((outcome) => {
+        setOnboardingOpen(false);
+        if (outcome === 'done') {
+            const written = markOnboardingDone();
+            setOnboardingPending(false);
+            channel.notify(t(written ? 'onboarding-finished' : 'onboarding-write-failed'), {
+                color: written ? 'success' : 'warning',
+                timeoutMs: written ? 3000 : 6000,
+            });
+        }
+        else {
+            channel.notify(t('onboarding-skipped'), { timeoutMs: 4000 });
+        }
+    }, [channel]);
     /** The startup summary gives way to transcript rows after the first local command or message. */
     const loadedContextVisible = channel.rows.length === 0 && channel.loadedContext !== undefined;
     /** Startup context panel: collapsed by default, toggled with Ctrl+P. */
@@ -1634,6 +2123,69 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
                 : t('migrate-failed', { n: failures }), failures === 0 ? { timeoutMs: 6000 } : { color: 'error', timeoutMs: 10000 });
         })();
     };
+    /**
+     * Close the launchpad and hand the draft to the chat screen.
+     *
+     * THREE cases, and they are genuinely different:
+     *
+     *   - a slash command → `runCommand`, the same dispatch a typed command
+     *     takes in the composer. The line is NOT submitted to the model.
+     *     Recognition is the composer's OWN rule (第六版 BUG 1 修复): the merged
+     *     command list (locals + plugin/registry commands via channel.commandList)
+     *     decides whether the line is a command — isLocalCommandName alone missed
+     *     registry-only names (e.g. /plan, /goal), which then fell through to
+     *     channel.submit and went to the model as a user message.
+     *   - ordinary text  → SENT DIRECTLY (fifth revision, user-reported bug:
+     *     "按了回车就直接进入流式输出"). The line rides the composer's own
+     *     submit path (`channel.submit`, which queues through the DSH inbox
+     *     while a turn is running) — no draft is parked anywhere, the composer
+     *     mounts EMPTY because the content is already gone as the first turn.
+     *   - empty          → nothing to send; just show the conversation.
+     *
+     * History is appended for the two non-empty cases (matching what PromptInput
+     * does on submit) so the launchpad's first line is reachable with ↑ later.
+     */
+    const closeLaunchpad = React.useCallback((submit) => {
+        const text = submit.trim();
+        setLaunchpadOpen(false);
+        // 首启时 openHomeOnBoot 与落地页同时为真：会话浏览器已经开着、只是被落地页盖住。
+        // 提交首句后必须把它收掉，否则用户落到浏览器而不是"草稿就在眼前的对话"，
+        // 与本函数 doc 承诺的落点直接矛盾。
+        setSupervisorOpen(false);
+        setLaunchpadFocus(-1);
+        setLaunchpadDraft('');
+        setLaunchpadCaret(0);
+        if (text === '')
+            return;
+        void appendHistory(text);
+        const parsed = text.startsWith('/') ? parseCommandName(text) : undefined;
+        // 第八版：/help 在落地页上也是盖屏浮层（补全面板被 Esc 收掉后直接
+        // Enter 的那条路）——不收落地页、不进对话页。聊天页里 /help 的行为
+        // 不变（那边不走这个回调）。
+        if (parsed !== undefined && parsed.name === 'help' && launchpadOpen) {
+            dispatchOverlay({ type: 'open', overlay: { kind: 'help' } });
+            return;
+        }
+        // 与 composer 的 tryRunCommand 同一条判定：合并命令表（LOCAL_COMMANDS +
+        // channel.commandList 的插件/registry 命令）里有名字才是命令；hidden
+        // 命令照旧认。判定之外的 / 开头行才走 submit（与聊天页 Enter 行为一致）。
+        if (parsed !== undefined && (isLocalCommandName(parsed.name)
+            || isHiddenCommandName(parsed.name)
+            || channel.commandList.some(entry => entry.name === parsed.name))) {
+            void runCommand(parsed.name, parsed.rawInput);
+            return;
+        }
+        // 直接发送：与 composer 回车同一条提交路径。发出去之后输入框是空的
+        // （内容已作为首轮发出，绝不"既发了又留在框里"），也没有交接提示——
+        // 没有草稿要交，一句"已放进输入框"的 toast 反而是假的。
+        channel.submit(text);
+    }, [channel, launchpadOpen]);
+    /**
+     * The screen's command dispatcher. Every entry point reaches this one
+     * closure — PromptInput's `onRunCommand`, the completion menu, this screen's
+     * own `/` cases, and the launchpad handoff above. There is deliberately no
+     * second dispatcher for the landing page.
+     */
     const runCommand = (name, rawInput = '', images = []) => {
         switch (name) {
             case 'activity': {
@@ -1746,11 +2298,12 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
                     return true;
                 }
                 setHelpOpen(false);
-                void channel.listEfforts().then(({ efforts, defaultEffort }) => {
+                void channel.listEfforts().then(({ efforts, defaultEffort, levelsFallback }) => {
                     // 0/1-tier routes were already notified by listEfforts.
                     if (efforts.length <= 1)
                         return;
                     setEffortOptions(efforts);
+                    setEffortLevelsFallback(levelsFallback === true);
                     const current = channel.reasoningEffort ?? defaultEffort;
                     const index = efforts.findIndex(effort => effort.id === current);
                     // open-if: a picker the user opened during the round trip wins
@@ -1916,9 +2469,24 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
                 setSelectedId(null);
                 setSelectionActive(false);
                 return true;
-            case 'compact':
-                channel.compact();
+            case 'compact': {
+                // The TUI's own transaction is the primary path: it owns the
+                // `tui/compact` decision event, the progress row with live token
+                // count, Esc cancellation, and the settle before a session switch
+                // (issue #1092) — the official `dsh-command-compact` command has none
+                // of that. A composition that mounts no compaction service falls back
+                // to the registry command; one with neither says WHY up front instead
+                // of looking usable and failing on use (channel/capabilities.ts).
+                const compact = channel.capabilities().compact;
+                if (compact.route === 'local') {
+                    channel.compact();
+                    return true;
+                }
+                if (compact.route === 'registry')
+                    return runExternalCommand('compact', rawInput, images);
+                channel.notify(t('capability-unavailable', { name: 'compact', reason: t(compact.reasonKey) }), { color: 'warning', timeoutMs: 8000 });
                 return true;
+            }
             case 'trace':
                 // `/trace` is kept as the discoverable spelling of Ctrl+T: the
                 // command menu is where a user finds out the trajectory exists.
@@ -1946,7 +2514,9 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
                     setHelpOpen(false);
                     const spec = parts[0];
                     const slash = spec.indexOf('/');
-                    const provider = slash >= 0 ? spec.slice(0, slash) : undefined;
+                    // Backend model routes accept an unqualified model id.
+                    const singleProvider = channel.backendCapabilities?.modelRoutes === 'backend';
+                    const provider = slash >= 0 ? spec.slice(0, slash) : singleProvider ? channel.provider : undefined;
                     const id = slash >= 0 ? spec.slice(slash + 1) : spec;
                     if (provider === undefined || id.length === 0 || provider.length === 0) {
                         channel.notify(t('model-usage'), { color: 'warning' });
@@ -1973,7 +2543,7 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
                 let recentsNow = modelRecents;
                 if (channel.provider !== '' && channel.model !== ''
                     && !recentsNow.some(ref => ref.provider === channel.provider && ref.id === channel.model)) {
-                    recentsNow = recordModelUse({ provider: channel.provider, id: channel.model });
+                    recentsNow = recordModelUse({ provider: channel.provider, id: channel.model }, undefined, recentsBackend);
                     setModelRecents(recentsNow);
                 }
                 // Two-level landing: recents (when catalogued) focus their pinned
@@ -2078,14 +2648,39 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
                 });
                 return true;
             case 'tokens': {
-                const usage = t('tokens-usage', { in: formatTokens(channel.tokens.input), out: formatTokens(channel.tokens.output) });
-                if (channel.contextWindow === undefined) {
-                    channel.notify(usage);
-                }
-                else {
-                    const percent = Math.max(0, Math.min(100, Math.round((channel.tokens.input / channel.contextWindow) * 100)));
-                    channel.notify(t('tokens-usage-context', { usage, percent }));
+                // Four separately-labelled facts, never two measures side by side:
+                // what THIS request uploaded (the provider's mutually-exclusive prompt
+                // buckets, with when it was sampled), what the last turn used (its
+                // own ledger, never added into the session counters), what the
+                // session has accumulated, and how full the window is (the channel's
+                // single occupancy reading — the same number the footer and the
+                // context-low warning show).
+                const usage = channel.lastUsage;
+                const lines = [];
+                if (usage !== undefined) {
+                    const upload = usage.input + usage.cacheRead + usage.cacheWrite;
+                    const rate = upload > 0 ? ((usage.cacheRead / upload) * 100).toFixed(1) : '0.0';
+                    lines.push(`${t('tokens-request-upload', {
+                        upload: formatTokens(upload),
+                        input: formatTokens(usage.input),
+                        read: formatTokens(usage.cacheRead),
+                        write: formatTokens(usage.cacheWrite),
+                        rate,
+                    })} · ${t('usage-sampled-at', { time: formatClock(usage.at) })}`);
                 }
+                const turn = channel.turnUsage;
+                if (turn !== undefined)
+                    lines.push(`${t('usage-turn-summary')} ${turnUsageParts(turn).join(' · ')}`);
+                lines.push(t('tokens-session-breakdown', {
+                    input: formatTokens(channel.tokens.input),
+                    output: formatTokens(channel.tokens.output),
+                    read: formatTokens(channel.tokens.cacheRead),
+                    write: formatTokens(channel.tokens.cacheWrite),
+                }));
+                const occupancyLine = contextOccupancyLine(channel);
+                if (occupancyLine !== undefined)
+                    lines.push(occupancyLine);
+                channel.notify(lines.join('\n'));
                 return true;
             }
             case 'resume':
@@ -2098,7 +2693,26 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
              * commands is about muscle memory, not about three surfaces — every one
              * of them lands here, on the same runtime.
              */
-            case 'home':
+            case 'home': {
+                setHelpOpen(false);
+                // Split-aware, like /trace and /jobs: while the sidebar is rendering
+                // and the workspace panel is enabled, the workspace view opens THERE.
+                // The panel's own ⤢ goes back to the full-screen home. The panel reads
+                // the DSH workspace ledger, though: a backend without that capability
+                // (capability snapshots absent on test stubs = DSH) would have its
+                // /resume swallowed by an unsupported panel and no history anywhere —
+                // those keep the full-screen session supervisor.
+                const capabilities = channel.backendCapabilities;
+                const controller = sidePanelRef.current;
+                if ((capabilities === undefined || capabilities.commands.includes('workspace'))
+                    && controller !== null && controller.split && controller.enabledPanelIds.includes('workspace')) {
+                    controller.openPanel('workspace', { focus: true });
+                    return true;
+                }
+                agentViewOpenSessionRef.current = channel.agentId;
+                setSupervisorOpen(true);
+                return true;
+            }
             case 'agentview': {
                 setHelpOpen(false);
                 // The screen opens immediately and loads its own list. Waiting for the
@@ -2110,9 +2724,8 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
             }
             case 'bg':
             case 'background': {
-                // `/background`: the attached session moves to the background
-                // (it keeps running in this process), the terminal lands on a fresh
-                // session, and the supervisor opens on top.
+                // DSH parks the attached session before opening the supervisor;
+                // other backends open it over their still-attached session.
                 setHelpOpen(false);
                 backgroundToAgentView();
                 return true;
@@ -2199,23 +2812,29 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
                 return true;
             case 'status': {
                 const usage = channel.lastUsage;
-                const pct = channel.contextWindow === undefined
-                    ? undefined
-                    : Math.max(0, Math.min(100, Math.round((channel.tokens.input / channel.contextWindow) * 100)));
                 const lines = [
                     `${t('status-model', { model: channel.model })}${channel.reasoningEffort ? ` · ${capitalize(channel.reasoningEffort)} effort` : ''}`,
                     `${t('status-state', { state: channel.working ? t('status-working') : t('status-idle') })}`,
                     `${t('status-session', { id: channel.agentId })}`,
                     `${t('status-dir', { cwd: channel.displayCwd })}${channel.gitBranch ? ` · ${channel.gitBranch}` : ''}`,
-                    `Tokens ${formatTokens(channel.tokens.input)} in → ${formatTokens(channel.tokens.output)} out`,
+                    t('tokens-session-total', {
+                        input: formatTokens(channel.tokens.input),
+                        output: formatTokens(channel.tokens.output),
+                    }),
                 ];
                 if (usage !== undefined) {
                     const total = usage.input + usage.cacheRead + usage.cacheWrite;
                     const rate = total > 0 ? ((usage.cacheRead / total) * 100).toFixed(1) : '0.0';
-                    lines.push(t('cost-cache-rate', { rate, read: formatTokens(usage.cacheRead), write: formatTokens(usage.cacheWrite) }));
+                    lines.push(`${t('cost-cache-rate', { rate, read: formatTokens(usage.cacheRead), write: formatTokens(usage.cacheWrite) })} · ${t('usage-sampled-at', { time: formatClock(usage.at) })}`);
                 }
-                if (pct !== undefined)
-                    lines.push(t('cost-context', { pct }));
+                // The last turn gets its own labelled line so it never reads as part
+                // of the session totals.
+                const turn = channel.turnUsage;
+                if (turn !== undefined)
+                    lines.push(`${t('usage-turn-summary')} ${turnUsageParts(turn).join(' · ')}`);
+                const occupancyLine = contextOccupancyLine(channel);
+                if (occupancyLine !== undefined)
+                    lines.push(occupancyLine);
                 if (channel.sessionTitle)
                     lines.push(t('status-title', { title: channel.sessionTitle }));
                 setHelpOpen(false);
@@ -2225,13 +2844,26 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
             case 'cost': {
                 const usage = channel.lastUsage;
                 const lines = [
-                    `Tokens ${formatTokens(channel.tokens.input)} in → ${formatTokens(channel.tokens.output)} out`,
+                    t('tokens-session-total', {
+                        input: formatTokens(channel.tokens.input),
+                        output: formatTokens(channel.tokens.output),
+                    }),
                 ];
                 if (usage !== undefined) {
                     const total = usage.input + usage.cacheRead + usage.cacheWrite;
                     const rate = total > 0 ? ((usage.cacheRead / total) * 100).toFixed(1) : '0.0';
                     lines.push(t('cost-cache-hit-rate', { rate, read: formatTokens(usage.cacheRead), write: formatTokens(usage.cacheWrite) }));
                 }
+                // A backend that reports its own session cost (Claude) states the
+                // bill itself; the DeepSeek estimate below would only be noise.
+                // oxlint-disable-next-line typescript/no-unnecessary-condition -- partial embedder channels omit the report
+                const report = channel.costReport;
+                if (report !== undefined) {
+                    lines.push(`${formatCostReport(report)} · ${t(report.source === 'backend' ? 'cost-source-backend' : 'status-cost-note')}`);
+                    setHelpOpen(false);
+                    channel.pushLocal('/cost', lines);
+                    return true;
+                }
                 // 金额与拆解：主会话按模型分桶 + 子代理按各自 (provider, model) 分桶；
                 // 全部未计价时只报 token 并标注未计价，不显示 ¥0.00 金额行（DESIGN D4/D6）。
                 const estimate = estimateSessionCostSnapshotCny({
@@ -2274,6 +2906,54 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
                 setSettingsOpen(true);
                 return true;
             }
+            case 'continue': {
+                // 落地页第四版的 Continue（最高频动作）：继续**最近一条可继续会话**。
+                // 数据是真的——`agentViewRows`（含持久化名册，listing 落地后含全部历史）
+                // 里挑 updatedAt 最新的非当前行；没有可继续的就去会话名册挑，失败也不
+                // 静默（notify + 打开 supervisor 让用户自己挑），绝不点了个没反应。
+                setHelpOpen(false);
+                const candidates = agentViewRows.filter(row => !row.current && row.id !== channel.agentId && row.title.trim() !== '');
+                const latest = candidates.reduce((acc, row) => (acc === undefined || row.updatedAt > acc.updatedAt ? row : acc), undefined);
+                if (latest === undefined) {
+                    channel.notify(t('launchpad-continue-none'), { color: 'error', timeoutMs: 6000 });
+                    agentViewOpenSessionRef.current = channel.agentId;
+                    // 第七版：无可继续会话时浏览器盖在落地页之上（不收落地页）——Esc
+                    // 回启动页，与合并入口「会话与工作区」同一条姿态。
+                    setSupervisorOpen(true);
+                    return true;
+                }
+                setLaunchpadOpen(false);
+                void channel.resumeTo(latest.id)
+                    .then((result) => {
+                    if (!result.ok) {
+                        channel.notify(t('launchpad-continue-failed'), { color: 'error', timeoutMs: 8000 });
+                        agentViewOpenSessionRef.current = channel.agentId;
+                        setSupervisorOpen(true);
+                        return;
+                    }
+                    channel.notify(t('resume-resumed'));
+                    suppressLogoIntroRef.current = true;
+                    setAgentViewReturnId(undefined);
+                    repaintTranscript();
+                })
+                    .catch(() => {
+                    channel.notify(t('launchpad-continue-failed'), { color: 'error', timeoutMs: 8000 });
+                });
+                return true;
+            }
+            case 'setup': {
+                // `/setup` re-runs the first-run guide. Unlike the boot path this is
+                // an EXPLICIT request, so it opens unconditionally — a user who typed
+                // it has already decided the wizard is what they want. It reuses the
+                // same screen and the same `onClose`, so completing it here also
+                // (re)writes the one-shot marker.
+                // 第七版：向导的 early-return 在落地页**之前**，天然盖在落地页之上；
+                // 不再收掉落地页——Esc/跳过/完成都回到启动页（旧姿态收掉落地页后，
+                // 向导关掉就落到对话页，正是用户报的 bug 形态之一）。
+                setHelpOpen(false);
+                setOnboardingOpen(true);
+                return true;
+            }
             case 'star': {
                 // 一键 star：**只有用户主动敲 /star 才会跑**（绝不自动）。动作用
                 // runStarAction（与开屏弹窗共用），异步执行、结果用 notify 报。
@@ -2367,6 +3047,11 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
                 return true;
             }
             case 'init': {
+                const backend = channel.backendInit?.();
+                if (backend !== undefined) {
+                    void backend.run();
+                    return true;
+                }
                 const result = channel.initWorkspace();
                 if (result === null)
                     channel.notify(t('agentsmd-create-failed'), { color: 'error' });
@@ -2376,10 +3061,52 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
                     channel.notify(t('agentsmd-created', { result }));
                 return true;
             }
-            case 'jobs':
+            case 'jobs': {
                 setHelpOpen(false);
-                setJobsPanelOpen(true);
+                // Split mode routes to the side panel; narrow terminals keep the
+                // full-screen overlay.
+                if (sidePanel.split && sidePanel.enabledPanelIds.includes('jobs')) {
+                    sidePanel.openPanel('jobs', { focus: true });
+                }
+                else {
+                    setJobsPanelFocusId(null);
+                    setJobsPanelOpen(true);
+                }
                 return true;
+            }
+            case 'panel': {
+                setHelpOpen(false);
+                // 无参 → 面板选择器（overlay 互斥结构内）；有参 → 侧栏命令分发。
+                if (rawInput.trim() === '' && sidePanel.splitAvailable && panelPickerRows.length > 0) {
+                    const current = panelPickerRows.findIndex(row => row.id === sidePanel.activePanelId);
+                    dispatchOverlay({ type: 'open', overlay: { kind: 'panel', index: Math.max(0, current) } });
+                    return true;
+                }
+                if (sidePanel.command(rawInput))
+                    return true;
+                // 分栏不可用（窄屏 / inline / 编辑器展开 / splitEnabled=false）
+                // 或参数未知时的整屏回退与兜底：已知面板走整屏形态，其余消费
+                // 掉并提示——绝不原样返回 false，否则 PromptInput 会把
+                // "/panel …" 当普通消息发给模型。
+                const arg = rawInput.trim().toLowerCase();
+                const target = arg === '' || arg === 'focus' || arg === 'toggle' || arg === 'zoom'
+                    ? sidePanel.activePanelId
+                    : arg;
+                if (target === 'jobs') {
+                    setJobsPanelFocusId(null);
+                    setJobsPanelOpen(true);
+                    return true;
+                }
+                if (target === 'agents') {
+                    setSubagentDashboardOpen(true);
+                    return true;
+                }
+                if (arg === 'toggle' || arg === 'focus' || arg === 'zoom' || arg === '' || target !== undefined) {
+                    channel.notify(t('panel-unavailable-hint'));
+                    return true;
+                }
+                return false;
+            }
             case 'agents':
                 setHelpOpen(false);
                 void channel.listSubagents().then((lines) => {
@@ -2388,6 +3115,8 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
                 return true;
             case 'login': {
                 setHelpOpen(false);
+                if (runBackendLogin())
+                    return true;
                 void channel.describeCredential('DEEPSEEK_API_KEY')
                     .catch(() => undefined)
                     .then(async (status) => {
@@ -2431,9 +3160,14 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
                 });
                 return true;
             }
-            case 'logout':
-                channel.notify(t('login-logout-hint'));
+            case 'logout': {
+                const auth = channel.backendAuth();
+                if (auth?.logout === undefined)
+                    channel.notify(t('login-logout-hint'));
+                else
+                    void auth.logout();
                 return true;
+            }
             case 'permission': {
                 // The command itself is registered by the permission-presets row
                 // (dsh-base): bare `/permission` opens the preset picker and Enter
@@ -2498,15 +3232,32 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
                     setHelpOpen(false);
                     return runPermissionCommand(rawInput, images);
                 }
-                return false;
+                const native = backendPermissionCommand(channel.backendModes?.()?.snapshot(), rawInput, modeDisplayName(channel.mode));
+                if (native === undefined)
+                    return false;
+                if (native.kind === 'unknown') {
+                    channel.notify(t('permission-mode-unknown', { id: native.id }), { color: 'error' });
+                    return true;
+                }
+                setHelpOpen(false);
+                if (native.kind === 'status')
+                    channel.pushLocal('/permission', native.lines);
+                else if (native.kind === 'picker')
+                    dispatchOverlay({ type: 'open', overlay: native.overlay });
+                else
+                    void runBackendModeCommand(native.mode.id, native.mode.name);
+                return true;
             }
             case 'plan': {
                 // Registered by dsh-plan-mode: bare `/plan` opens an on/off picker
                 // marked with the current state instead of toggling blindly; Enter
                 // dispatches `/plan` or `/plan off`. Arguments pass through verbatim
-                // (`/plan off`), and an unmounted row falls back to the default
-                // external path.
-                const mounted = channel.commandList.some(command => command.external && command.name === 'plan');
+                // (`/plan off`). Availability comes from the shared capability facts
+                // (the same read Shift+Tab uses), not from a second command-list
+                // scan; with no registry command the line falls through to the model,
+                // exactly as before.
+                const plan = channel.capabilities().plan;
+                const mounted = plan.route !== 'none';
                 const parts = rawInput.trim().split(/\s+/).filter(Boolean);
                 if (mounted && parts.length === 0) {
                     setHelpOpen(false);
@@ -2536,17 +3287,29 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
                     t('hooks-mount-hint'),
                 ]);
                 return true;
-            case 'mcp':
+            case 'mcp': {
                 setHelpOpen(false);
+                const control = channel.backendMcp?.();
+                const request = parseMcpCommand(rawInput);
+                if (control !== undefined && request.kind !== 'status') {
+                    if (request.kind === 'usage')
+                        channel.notify(t('mcp-control-usage'), { color: 'warning' });
+                    else if (request.kind === 'reconnect')
+                        void control.reconnect(request.name);
+                    else
+                        void control.toggle(request.name, request.enabled);
+                    return true;
+                }
                 channel.pushLocal('/mcp', channel.mcpStatus());
                 return true;
+            }
             case 'update':
                 setHelpOpen(false);
                 if (onUpdate === undefined) {
                     channel.notify(t('update-unavailable'), { color: 'warning' });
                 }
                 else if (channel.working) {
-                    channel.notify(t('update-working'), { color: 'warning' });
+                    channel.notify(t(WORKING_GATE_NOTICES.update), { color: 'warning' });
                 }
                 else {
                     channel.notify(t('update-starting'));
@@ -2630,6 +3393,64 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
                 channel.pushLocal('/reload', lines);
                 return true;
             }
+            case 'goal': {
+                // DSH: the `dsh-command-goal` registry row owns /goal, exactly as the
+                // default branch below would dispatch it.
+                if (channel.commandList.some(command => command.external && command.name === 'goal')) {
+                    setHelpOpen(false);
+                    return runExternalCommand(name, rawInput, images);
+                }
+                // Another backend: the channel core's host over its typed `goals`
+                // capability. None (DSH without the row, or a backend's own `goal`
+                // command) keeps the previous route: the line goes on as text. A
+                // backend with neither never gets here — PromptInput refuses /goal
+                // as unavailable (isUnavailableLocalCommand).
+                const goals = channel.backendGoals?.();
+                if (goals === undefined)
+                    return false;
+                setHelpOpen(false);
+                // The capability calls settle like registry commands: the draft is
+                // consumed only once the backend took the change (a failure is
+                // reported by the host and leaves the line editable). An invalid
+                // line is never sent anywhere: it stays in the composer.
+                const command = parseGoalCommand(rawInput);
+                switch (command.kind) {
+                    case 'status':
+                        channel.pushLocal('/goal', goalStatusLines(channel.goal));
+                        return true;
+                    case 'invalid':
+                        channel.notify(command.reason, { color: 'error' });
+                        return Promise.resolve(false);
+                    case 'set':
+                        return goals.set(command.objective, command.tokenBudget === undefined ? undefined : { tokenBudget: command.tokenBudget });
+                    case 'pause':
+                        return goals.pause();
+                    case 'resume':
+                        return goals.resume();
+                    case 'clear':
+                        return goals.clear();
+                }
+            }
+            case 'channel': {
+                // 渠道选择器。/channel 只在声明了 channels 能力的内核下进命令表，
+                // 能走到这里就说明可用。与 /kernel 一样，再执行一次就收起。
+                setHelpOpen(false);
+                if (overlay.kind === 'channel')
+                    dispatchOverlay({ type: 'close' });
+                else
+                    openChannelPicker();
+                return true;
+            }
+            case 'kernel':
+                // 内核选择器，每个内核下都可用（在对话页里切回 DSH 只有这一条路）。
+                // 确认后由组合根的 onSwitchBackend 记住选择并以新内核重启。与 /help、
+                // 参数行一致：选择器已开着就收起，没开才打开。
+                setHelpOpen(false);
+                if (overlay.kind === 'kernel')
+                    dispatchOverlay({ type: 'close' });
+                else
+                    openKernelPicker();
+                return true;
             case 'restart':
                 // pi-style reload tail: /reload cannot re-read boot-time-only state
                 // (cordis.yml root config, frozen fullscreen layout, newly built
@@ -2640,7 +3461,7 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
                     channel.notify(t('restart-unavailable'), { color: 'warning' });
                 }
                 else if (channel.working) {
-                    channel.notify(t('update-working'), { color: 'warning' });
+                    channel.notify(t(WORKING_GATE_NOTICES.restart), { color: 'warning' });
                 }
                 else {
                     channel.notify(t('restart-starting'));
@@ -2695,30 +3516,28 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
                 return true;
             }
             case 'btw': {
-                // `/btw`：单轮无工具侧问，overlay 态纯 UI，不打断主回合、不写
-                // 会话历史。空参数只提示用法。
+                // `/btw`：单轮无工具侧问，线程只在内存里（btwThreads，按会话
+                // 隔离），不打断主回合、不写会话历史。空参数只提示用法。启用了
+                // btw 面板就进面板线程（有模态界面时不抢开，只标未读）；没启用
+                // 就用浮层。同一个问答只出现在一处。
                 setHelpOpen(false);
                 const question = rawInput.trim();
                 if (!question) {
                     channel.notify(t('btw-usage'), { timeoutMs: 3000 });
                     return true;
                 }
-                btwAbortRef.current?.abort();
-                const controller = new AbortController();
-                btwAbortRef.current = controller;
-                setBtw({ question, answer: '', done: false });
-                void channel.sideQuestion(question, {
-                    signal: controller.signal,
-                    onText: delta => setBtw(prev => (prev ? { ...prev, answer: prev.answer + delta } : prev)),
-                }).then(result => {
-                    if (controller.signal.aborted)
-                        return;
-                    setBtw(prev => (prev ? { ...prev, answer: result.answer ?? prev.answer, error: result.error, done: true } : prev));
-                }).catch(error => {
-                    if (controller.signal.aborted)
-                        return;
-                    setBtw(prev => prev ? { ...prev, error: error instanceof Error ? error.message : String(error), done: true } : prev);
-                });
+                const btwResult = btwThreads.submit(String(channel.agentId), question, (q, options) => channel.sideQuestion(q, options), { recentTurnsLimit: getBtwContextTurns(), contextBudget: getBtwContextBudget() });
+                if (!btwResult.ok) {
+                    channel.notify(t('btw-thread-busy'), { color: 'warning', timeoutMs: 3000 });
+                    return true;
+                }
+                if (sidePanel.enabledPanelIds.includes('btw')) {
+                    if (btwSurfaceFree())
+                        sidePanel.openPanel('btw');
+                }
+                else {
+                    setBtwOverlayOpen(true);
+                }
                 return true;
             }
             case 'deepseek': {
@@ -2785,6 +3604,10 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
         : NO_ROWS;
     /** Open the rewind picker (from PromptInput's double-Esc on an empty input). */
     const openRewind = () => {
+        if (channel.backendCapabilities?.rewind === false) {
+            channel.notify(t('capability-unavailable-backend', { name: 'rewind' }), { color: 'warning', timeoutMs: 4000 });
+            return;
+        }
         // The overlay is not 'rewind' yet this render, so rewindRows is empty —
         // scan directly instead of reading the gated list.
         const candidates = channel.rows
@@ -2854,7 +3677,63 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
      */
     const { columns: terminalColumns } = useTerminalSize();
     const pageInsetX = usePageInset().x;
-    const wakeWidth = miniWakeWidth(terminalColumns);
+    // 侧栏控制器：几何（chatColumns/panelColumns）、焦点与键盘分发都在
+    // 这个 hook 里（设计文档 §16.5——Chat 只多一次调用、一处键盘让位、
+    // 一条 runCommand case）。编辑器展开时几何强制 collapsed。
+    const sidePanel = useSidePanel({
+        columns: terminalColumns,
+        fullscreen,
+        editorOpen: promptEditorOpen,
+    });
+    /**
+     * 「全屏」出口（PanelBar 的 ⤢）：把侧栏里那个面板的内容切到它原本的整屏
+     * 形态。只映射**真的有整屏对应物**的面板 id（能力位 capabilities.fullscreen
+     * 决定按钮画不画，这里决定点了去哪）；没映射到的 id 静默无操作——按钮与
+     * 落地页、键盘入口共用同一个状态位，所以从整屏返回时侧栏还在原处。
+     */
+    const openPanelFullscreen = React.useCallback((panelId) => {
+        if (panelId === 'jobs') {
+            sidePanelRef.current?.focusChat();
+            setJobsPanelOpen(true);
+            return;
+        }
+        if (panelId === 'agents') {
+            sidePanelRef.current?.focusChat();
+            setSubagentDashboardOpen(true);
+            return;
+        }
+        if (panelId === 'trajectory') {
+            sidePanelRef.current?.focusChat();
+            // 强制整屏：默认的 openScene 在分屏下会路由回面板（见它的注释）。
+            openScene({ fullscreen: true });
+            return;
+        }
+        if (panelId === 'workspace') {
+            sidePanelRef.current?.focusChat();
+            setSupervisorOpen(true);
+            return;
+        }
+        if (panelId === 'btw') {
+            // ⤢ 进整屏线程场景：Esc 返回侧栏，不清 thread/draft（面板
+            // mountPolicy=enabled 保挂载，路由/焦点/滚动原样恢复）。
+            sidePanelRef.current?.focusChat();
+            setBtwSceneOpen(true);
+        }
+    }, [openScene]);
+    // openJobsPanel（在上方、identity 稳定）经 ref 读取最新控制器。
+    sidePanelRef.current = sidePanel;
+    /**
+     * 宠物「代言」判定：分屏开着且 companion 是活动面板时，新通知由宠物头顶
+     * 气泡说出，输入框上方的 toast 不再重复同一条。error 色恒不压制（可能
+     * 要行动）。渲染期读控制器状态——与气泡同一提交，无先闪后消的竞态。
+     */
+    const petSaysNotices = React.useCallback((item) => item.color !== 'error' && sidePanel.split && sidePanel.activePanelId === 'companion', [sidePanel.split, sidePanel.activePanelId]);
+    // 聊天列宽：收起时 = 内容区全宽（与现状逐字节一致），分栏时 = 左栏宽。
+    // 所有显式下传的宽度（gutter / 图片预览区 / wake 条）都改用它；转录
+    // 子树则经 SidePanelLayout 的 TerminalSizeContext 覆盖自动拿到。
+    const chatColumns = sidePanel.chatColumns;
+    const wakeWidth = miniWakeWidth(chatColumns);
+    const panelPickerRows = usePanelPickerRows(sidePanel);
     const wakeBand = React.useMemo(() => wakeWidth === 0
         ? undefined
         // `sequence`, not the scene's `compressed`: at sixteen columns an idle
@@ -3021,9 +3900,10 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
     const lastModalEnterAtRef = React.useRef(0);
     const couponVisible = coupon !== null && starModal === null
         && approvalSnapshot === null && dialogSnapshot === null && questionSnapshot === null
-        && overlay.kind === 'none' && btw === null && recap === null
+        && overlay.kind === 'none' && !btwOverlayOpen && recap === null
         && !supervisorOpen && !treeOpen && !settingsOpen && !jobsPanelOpen
-        && !sceneOpen && !subagentDashboardOpen && subagentDetailId === null;
+        && !sceneOpen && !subagentDashboardOpen && subagentDetailId === null
+        && !btwSceneOpen;
     const markCouponShown = React.useCallback((orderId) => {
         bonusNotices?.shown(orderId);
     }, [bonusNotices]);
@@ -3042,10 +3922,27 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
         // still lets the panel receive them. PromptInput now stays mounted but
         // suspended to preserve async command drafts, making this guard also
         // essential for Ctrl+C: it must never clear the hidden composer.
-        if (btw !== null
+        if (btwOverlayOpen
             || overlay.kind === 'tips'
             || (recap !== null && (!recap.auto || recap.expanded)))
             return;
+        // The first-run guide owns the whole terminal while it is up: it is a
+        // wizard with its own step navigation, its own focus ring inside the
+        // pickers it borrows, and no free-text input at all. Registered ABOVE the
+        // launchpad because it renders above it.
+        if (onboardingOpen)
+            return;
+        // The launchpad owns the whole terminal while it is up — including the
+        // plain letters that would otherwise reach the composer, which is exactly
+        // the point: it IS the composer on this screen, and its draft is submitted
+        // directly (see closeLaunchpad). ONE exception (fifth revision): a picker
+        // opened from the param row renders ABOVE the launchpad and therefore owns
+        // the keyboard — fall through to the overlay branches below (Esc closes the
+        // picker back onto the launchpad). The launchpad's own useInput is paused
+        // via inputPaused for exactly this window, so keys the picker does not
+        // consume cannot leak into the draft.
+        if (launchpadShown && !launchpadOverlayUp)
+            return;
         // The session tree owns the whole terminal while it is up: plain letters
         // drive its search, clicks and Enter drive its action menu.
         if (treeOpen)
@@ -3063,12 +3960,20 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
         // Subagent dashboard or detail scene: it owns the keyboard while open.
         if (subagentDashboardOpen || subagentDetailId !== null)
             return;
+        // The main-screen Agent View owns the whole terminal while open (its
+        // composer, scrolling and Esc layering live in the scene).
+        if (agentView !== null)
+            return;
         // The `/jobs` panel replaces the conversation too, so it owns Esc (close)
         // and k (kill) while open. Unguarded, Esc meant to CLOSE the panel also
         // reached the chat:cancel branch below whenever a turn was in flight —
         // dismissing the panel and killing the turn with one key.
         if (jobsPanelOpen)
             return;
+        // The ⤢ btw thread scene owns the keyboard the same way: Esc there
+        // returns to the sidebar (never the chat:cancel branch below).
+        if (btwSceneOpen)
+            return;
         // A plugin scene (dsh-tui-scenes) or the trajectory scene owns the whole
         // screen while open: every key belongs to it. Unguarded, an Esc meant to
         // CLOSE the scene also reached the chat:cancel branch below whenever a
@@ -3093,7 +3998,10 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
         // Events only arrive with mouse tracking on; inline mode never sees
         // them, so this is a no-op there.
         if (key.wheelUp || key.wheelDown) {
-            if (helpOpen)
+            // 焦点在右栏时滚轮不回落到转录：落在面板矩形上的滚轮已由命中
+            // 测试路由给面板自己的 ScrollBox，到达这里的兜底事件不应在
+            // 用户操作右栏时误滚左栏。
+            if (helpOpen || sidePanel.focus === 'panel')
                 return;
             // Any open transient dialog is modal to the wheel; the one exception
             // mirrors the render gate — a workspace picker whose target list has
@@ -3130,7 +4038,8 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
         // pending. The panels bind ↑/↓/Space/Tab/Enter/Esc and never these keys,
         // so paging cannot steal anything from them.
         if ((key.pageUp || key.pageDown) && fullscreen) {
-            if (helpOpen)
+            // 焦点在右栏时 PgUp/PgDn 属于活动面板（经侧栏键盘分发）。
+            if (helpOpen || sidePanel.focus === 'panel')
                 return;
             const overlayModal = overlay.kind !== 'none' &&
                 (overlay.kind !== 'workspace-picker' || workspaceTargets.length > 0);
@@ -3169,6 +4078,12 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
             }
             return;
         }
+        // 侧栏键盘分发（v2.1 优先级）：上面的审批 / 问卷 / 对话框守卫仍然
+        // 最先，其次是侧栏全局快捷键（Ctrl+B / Alt+Z，两种焦点都生效），
+        // 然后焦点在右栏时一切按键归侧栏——活动面板的业务键优先，宿主
+        // 回退键（←/→ 切面板、z、+/-、Esc 回聊天）兜底。
+        if (sidePanel.handleKey(input, key, event))
+            return;
         const returnCandidate = isPlainReturnInput(input, key);
         const returnNow = Date.now();
         const plainReturn = returnCandidate && returnNow - lastModalEnterAtRef.current >= 80;
@@ -3263,6 +4178,32 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
             event.stopImmediatePropagation();
             return;
         }
+        if (overlay.kind === 'help') {
+            // 帮助盖屏（第八版）：Esc/Ctrl+C/Enter 收起回落地页；纵向导航归这个
+            // 视口（与 PromptInput 的 helpOpen 分支同一套键位），其余按键模态吞掉
+            // ——绝不漏进落地页草稿。
+            const page = Math.max(1, helpCoverViewportHeight - 2);
+            if (key.upArrow || key.wheelUp) {
+                helpCoverScrollRef.current?.scrollBy(key.wheelUp ? -3 : -1);
+            }
+            else if (key.downArrow || key.wheelDown) {
+                helpCoverScrollRef.current?.scrollBy(key.wheelDown ? 3 : 1);
+            }
+            else if (key.pageUp || key.pageDown) {
+                helpCoverScrollRef.current?.scrollBy(key.pageUp ? -page : page);
+            }
+            else if (key.home) {
+                helpCoverScrollRef.current?.scrollTo(0);
+            }
+            else if (key.end) {
+                helpCoverScrollRef.current?.scrollTo(Number.MAX_SAFE_INTEGER);
+            }
+            else if (key.escape || (key.ctrl && (input === 'c' || input === 'd')) || plainReturn) {
+                dispatchOverlay({ type: 'close' });
+            }
+            event.stopImmediatePropagation();
+            return;
+        }
         if (overlay.kind === 'thinking') {
             if (key.upArrow || key.downArrow) {
                 dispatchOverlay({ type: 'move', delta: key.upArrow ? -1 : 1, count: 2 });
@@ -3632,6 +4573,84 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
             }
             return;
         }
+        if (overlay.kind === 'mode') {
+            if (key.upArrow || key.downArrow) {
+                dispatchOverlay({ type: 'move', delta: key.upArrow ? -1 : 1, count: overlay.modes.length });
+            }
+            else if (plainReturn) {
+                const option = overlay.modes[overlay.index];
+                dispatchOverlay({ type: 'close' });
+                if (option !== undefined)
+                    void runBackendModeCommand(option.id, option.name);
+            }
+            else if (key.escape) {
+                dispatchOverlay({ type: 'close' });
+            }
+            return;
+        }
+        if (overlay.kind === 'kernel') {
+            // 名册不冻在 overlay 里（kernelOptions 是渲染期派生值）：探测落地后
+            // 选择器自己就刷新成完整目录，不需要重开。
+            if (key.upArrow || key.downArrow) {
+                dispatchOverlay({ type: 'move', delta: key.upArrow ? -1 : 1, count: kernelOptions.length });
+            }
+            else if (plainReturn) {
+                pickKernel(overlay.index);
+            }
+            else if (key.escape) {
+                dispatchOverlay({ type: 'close' });
+            }
+            return;
+        }
+        if (overlay.kind === 'sdk-install') {
+            // 向导按键按步骤态分派；checking/running 期间除 Esc（取消安装）外
+            // 全部吞掉——异步落地只发生在面板还在的窗口内（见 sdkPhase 注释）。
+            if (sdkPhase.kind === 'confirm') {
+                if (plainReturn)
+                    confirmSdkInstall(sdkPhase.dir);
+                else if (key.escape)
+                    closeSdkInstallToKernelPicker();
+            }
+            else if (sdkPhase.kind === 'checking') {
+                // 亚秒级预检，无键可按。
+            }
+            else if (sdkPhase.kind === 'running') {
+                if (key.escape)
+                    sdkInstallerRef.current?.cancel();
+            }
+            else if (sdkPhase.kind === 'done') {
+                if (plainReturn)
+                    closeSdkInstallToKernelPicker();
+                else if (key.escape)
+                    closeSdkInstall();
+            }
+            else if (sdkPhase.kind === 'failed') {
+                if (input === 'r' && !key.ctrl && !key.meta)
+                    confirmSdkInstall(sdkPhase.dir);
+                else if (key.escape)
+                    closeSdkInstallToKernelPicker();
+            }
+            else {
+                // pnpm-missing / cancelled / no-target：Esc 回内核选择器。
+                if (key.escape)
+                    closeSdkInstallToKernelPicker();
+            }
+            return;
+        }
+        if (overlay.kind === 'channel') {
+            // 名册不冻在 overlay 里（channelRows 是渲染期派生值）：切换/导入后
+            // 选择器自己就刷新成新状态，不需要重开。
+            if (key.upArrow || key.downArrow) {
+                dispatchOverlay({ type: 'move', delta: key.upArrow ? -1 : 1, count: channelRows.length });
+            }
+            else if (plainReturn) {
+                pickChannel(overlay.index);
+            }
+            else if (key.escape) {
+                dispatchOverlay({ type: 'close' });
+            }
+            return;
+        }
         if (overlay.kind === 'plan') {
             if (key.upArrow || key.downArrow) {
                 dispatchOverlay({ type: 'move', delta: key.upArrow ? -1 : 1, count: 2 });
@@ -3661,6 +4680,21 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
             }
             return;
         }
+        if (overlay.kind === 'panel') {
+            if (key.upArrow || key.downArrow) {
+                dispatchOverlay({ type: 'move', delta: key.upArrow ? -1 : 1, count: panelPickerRows.length });
+            }
+            else if (plainReturn) {
+                const row = panelPickerRows[overlay.index];
+                dispatchOverlay({ type: 'close' });
+                if (row !== undefined)
+                    sidePanel.openPanel(row.id, { focus: true });
+            }
+            else if (key.escape) {
+                dispatchOverlay({ type: 'close' });
+            }
+            return;
+        }
         if (overlay.kind === 'theme') {
             const options = getThemeOptions(themeHost);
             if (key.upArrow || key.downArrow) {
@@ -3832,11 +4866,12 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
             return;
         }
         if (actionMatches('dashboard', input, key)) {
-            // The subagent dashboard key (default Ctrl+A) opens the dashboard.
-            // Consume the key: without the stop the prompt editor's readline
-            // binding ALSO fires (Ctrl+A moves the caret to line start), so one
-            // press both opens the overlay and jumps the cursor.
-            setSubagentDashboardOpen(true);
+            // The subagent dashboard key (default Ctrl+A) opens the dashboard —
+            // split mode routes it to the agents side panel instead. Consume the
+            // key: without the stop the prompt editor's readline binding ALSO
+            // fires (Ctrl+A moves the caret to line start), so one press both
+            // opens the view and jumps the cursor.
+            openSubagentDashboard();
             event.stopImmediatePropagation();
             return;
         }
@@ -3848,7 +4883,7 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
             return;
         }
         if (actionMatches('history', input, key) && !helpOpen) {
-            setHistoryEntries(loadHistory());
+            setHistoryEntries(loadHistory(channel.cwd));
             dispatchOverlay({
                 type: 'open',
                 overlay: { kind: 'history', query: '', cursor: 0, focus: 0 },
@@ -3873,22 +4908,25 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
                 setSelectedId(null);
             }
         }
+        else if (key.escape && promptControllerRef.current?.consumeEscape()) {
+            // Selection/editor Esc stays with the composer even though Chat's
+            // global listener runs first. Consume it before interrupting the turn.
+            event.stopImmediatePropagation();
+        }
         else if (key.escape && channel.working && !helpOpen && !promptControllerRef.current?.vimActive()) {
             // Esc interrupts a running turn (the prompt input
             // only sees esc when idle, where it has the double-tap-clear meaning).
-            // With messages queued for delivery, interrupt-and-deliver them right
-            // away (Codex behavior); otherwise a plain interrupt parks the queue.
+            // With messages queued, the queue DOCKS (Claude Code parity): the
+            // abort drops the backend copies, the previews park channel-side and
+            // the composer's dock hint offers ↑ to edit one / ⏎ to send them all
+            // — nothing auto-sends. Already-docked rows dock nothing new; the
+            // turn still needs its plain abort.
             // vim mode (either submode) yields: there Esc is a MODE key (INSERT→
             // NORMAL, NORMAL = no-op/cancel pending d) and the prompt owns it;
             // interrupting still works via Ctrl+C / Ctrl+Enter.
             if (channel.pending.length > 0) {
-                const count = channel.interruptAndDeliver(channel.pending.map(item => ({
-                    text: item.text,
-                    images: item.images ?? [],
-                })));
-                if (count > 0) {
-                    channel.notify(t('interrupt-delivered', { n: count }), { timeoutMs: 2500 });
-                }
+                if (channel.interruptAndDock() === 0)
+                    channel.cancel();
             }
             else {
                 channel.cancel();
@@ -4040,10 +5078,17 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
             // (wired to the toast below).
             event.stopImmediatePropagation();
         }
+    }, {
+        // Chat's global layer must see every key before the composer and the
+        // panels it hosts (the handler's yield guards and readline shadowing
+        // both assume it), whether or not they mounted in the same
+        // commit — child effects run first, so append order would put a
+        // first-mount PromptInput ahead of Chat (#1155).
+        prepend: true,
     });
     // Working-activity line (spinner slot): context-pressure prefix shares the
-    // StatusLine thresholds (amber ≥ 80, red ≥ 95).
-    const activityWarnPct = contextPressurePct(channel.lastUsage, channel.contextWindow);
+    // StatusLine thresholds (amber ≥ 80, red ≥ 95) and its occupancy source.
+    const activityWarnPct = contextPressurePct(channelContextOccupancy(channel));
     // Who owns the spinner slot: with the working-activity line on, that slot
     // draws the user's `/activity` preset, so the compaction row borrows the same
     // indicator instead of answering with the classic dot.
@@ -4064,7 +5109,7 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
     // covered screen is unmounted, exactly like the chat-state prompt slot.
     // The panel elements are shared with the prompt-slot chain below so the
     // two mount sites cannot drift.
-    const approvalPanelNode = approvalSnapshot !== null ? (_jsx(ApprovalPanel, { approval: approvalSnapshot, background: approvalSnapshot.agentId !== channel.agentId, onDecide: outcome => approvals.decide(outcome) }, approvalSnapshot.key)) : null;
+    const approvalPanelNode = approvalSnapshot !== null ? (_jsx(ApprovalPanel, { approval: approvalSnapshot, background: approvalSnapshot.agentId !== channel.agentId, onDecide: (outcome, decision) => approvals.decide(outcome, decision) }, approvalSnapshot.key)) : null;
     const questionPanelNode = questionSnapshot !== null ? (_jsx(AskUserQuestionPanel, { question: questionSnapshot.question, position: questionSnapshot.position, total: questionSnapshot.total, answered: questionSnapshot.answered, initialDraft: questionSnapshot.draft, onAnswer: selection => {
             if (!questionStore.stillCurrent(questionSnapshot.key))
                 return;
@@ -4099,8 +5144,201 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
             }
             : undefined, collapsed: questionMinimized, onExpand: () => setMinimizedQuestionKey(null), onToggleFold: () => setMinimizedQuestionKey(previous => previous === questionSnapshot.key ? null : questionSnapshot.key), fullscreen: fullscreen }, questionSnapshot.key)) : null;
     const interruptPanel = approvalPanelNode ?? questionPanelNode;
+    /**
+     * Transient picker panels (pickers/dialogs) - this JSX feeds TWO mount
+     * points since the fifth launchpad revision: the chat page OverlayAbove
+     * (above the input cluster) and the launchpad itself (above its input
+     * card, see the launchpad branch). Defined once so the two never drift.
+     */
+    const backendModeStatus = modeStatus(channel.backendModes?.()?.snapshot(), () => { void runCommand('permission', ''); });
+    /**
+     * 底栏模型段/思考档位段的点击（与模式段同一契约）：后端声明了模型目录或
+     * effort 能力（backendCapabilities 位）才挂，点击 = 既有 /model · /effort
+     * 命令（同一批选择器）；无能力不挂点击，hover 也不承诺（StatusLine 的
+     * effort hover id 与点击同乘，model hover 只是不追加操作行）。
+     */
+    const backendCaps = channel.backendCapabilities;
+    const modelPickerStatus = backendCaps?.models === false
+        ? undefined
+        : { onOpen: () => { void runCommand('model', ''); } };
+    const effortPickerStatus = backendCaps?.effort === false
+        ? undefined
+        : { onOpen: () => { void runCommand('effort', ''); } };
+    const pickerPanels = (_jsxs(_Fragment, { children: [overlay.kind === 'help' && (_jsx(Box, { flexDirection: "column", marginBottom: 1, children: _jsx(HelpMenu, { commands: channel.commandList, viewportHeight: helpCoverViewportHeight, viewportWidth: chatColumns, scrollRef: helpCoverScrollRef, onCommandPick: (name) => {
+                        // 点击命令行 = 把 /name 填进落地页草稿（聊天页 Tab 补全的
+                        // 鼠标等价），浮层收起、人还在启动页（第八版：不许进对话页）。
+                        dispatchOverlay({ type: 'close' });
+                        const filled = '/' + name + ' ';
+                        setLaunchpadDraft(filled);
+                        setLaunchpadCaret(filled.length);
+                        setLaunchpadFocus(-1);
+                    } }) })), overlay.kind === 'thinking' && (_jsx(ThinkingToggle, { currentValue: thinkingVisible, focusIndex: overlay.focus, onPick: (index) => {
+                    // 点击行 = 设焦点 + 应用（与 Enter 同一条路径）
+                    const visible = index === 0;
+                    setThinkingVisible(visible);
+                    dispatchOverlay({ type: 'close' });
+                    channel.notify(t('thinking-toggled', { state: visible ? t('thinking-on') : t('thinking-off') }));
+                } })), overlay.kind === 'workspace-picker' && workspaceTargets.length > 0 && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(WorkspacePicker, { targets: workspaceTargets, focusIndex: overlay.index, currentCwd: channel.cwd, onPick: (index) => {
+                        // 点击行 = 切换该行目标（与 Enter 同一条路径）
+                        const target = workspaceTargets[index];
+                        dispatchOverlay({ type: 'close' });
+                        if (target !== undefined)
+                            void channel.switchWorkspace(target);
+                    } }) })), overlay.kind === 'workspace-menu' && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(WorkspaceMenuPicker, { options: workspaceMenuOptions, focusIndex: overlay.index, onPick: (index) => {
+                        // 点击行 = 执行该行（与 Enter 同一条路径）
+                        runWorkspaceMenuOption(workspaceMenuOptions[index]);
+                    } }) })), overlay.kind === 'workspace-flow' && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(WorkspaceFlowPicker, { title: overlay.flow.title, choices: overlay.flow.choices, focusIndex: overlay.index, busy: overlay.busy, input: overlay.input, onPick: (index) => {
+                        // 点击行 = 设焦点 + 执行分支（与 Enter 同一条路径）；
+                        // busy/输入态在组件侧禁点
+                        const choice = overlay.flow.choices[index];
+                        if (choice === undefined)
+                            return;
+                        dispatchOverlay({ type: 'set-index', kind: 'workspace-flow', index });
+                        runWorkspaceFlowAction(signal => choice.choose(signal));
+                    } }) })), overlay.kind === 'model' && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: models.length === 0 ? (_jsx(ModelPickerLoading, {})) : activeModelGroup === undefined ? (_jsx(ModelPicker, { groups: modelGroups, focusIndex: overlay.index, currentProvider: channel.provider, onPick: (index) => {
+                        // 点击分组行 = 进入该组（与 Enter 同一条路径）
+                        const group = modelGroups[index];
+                        if (!group)
+                            return;
+                        setModelGroup(group.provider);
+                        if (group.provider === RECENTS_GROUP_PROVIDER) {
+                            dispatchOverlay({ type: 'set-index', kind: 'model', index: 0 });
+                            return;
+                        }
+                        const landing = modelPickerLanding(models.filter(model => model.provider === group.provider), channel.provider, channel.model);
+                        dispatchOverlay({ type: 'set-index', kind: 'model', index: landing.index });
+                    } })) : (_jsx(ModelPicker, { models: groupModels, groupLabel: activeModelGroup === RECENTS_GROUP_PROVIDER
+                        ? t('picker-group-recent')
+                        : modelGroups.find(group => group.provider === activeModelGroup)?.label, showBack: modelGroups.length > 1 && !modelPickerDirect, showProviderPrefix: activeModelGroup === RECENTS_GROUP_PROVIDER, focusIndex: overlay.index, currentModel: `${channel.provider}/${channel.model}`, onPick: (index) => {
+                        // 点击行 = 应用该行模型（与 Enter 同一条路径）
+                        const model = groupModels[index];
+                        if (!model)
+                            return;
+                        dispatchOverlay({ type: 'close' });
+                        void switchModelRecorded(model.provider, model.id, model.name);
+                    } })) })), overlay.kind === 'migrate' && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(MigratePicker, { rows: migrateRows ?? [], focusIndex: overlay.index, checked: migrateChecked, loading: migrateRows === null, onPick: (index) => {
+                        const row = (migrateRows ?? [])[index];
+                        if (!row)
+                            return;
+                        setMigrateChecked(current => {
+                            const next = new Set(current);
+                            if (next.has(row.agentId))
+                                next.delete(row.agentId);
+                            else
+                                next.add(row.agentId);
+                            return next;
+                        });
+                    } }) })), overlay.kind === 'migrate-confirm' && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(MigrateConfirm, { rows: migratePending }) })), overlay.kind === 'skills' && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: skillsList === null ? (_jsx(SkillsPickerLoading, {})) : (_jsx(SkillsPicker, { skills: skillsList, focusIndex: overlay.index, onPick: (index) => {
+                        const skill = skillsList[index];
+                        if (!skill)
+                            return;
+                        dispatchOverlay({ type: 'close' });
+                        if (skill.userInvocable)
+                            setHistoryFill(`/${skill.name} `);
+                    } })) })), overlay.kind === 'activity' && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(ActivityPicker, { focusIndex: overlay.index, currentPreset: channel.activityFrames, onPick: (index) => {
+                        dispatchOverlay({ type: 'close' });
+                        const name = PRESET_NAMES[index];
+                        if (name)
+                            channel.setActivityFrames(name);
+                    } }) })), overlay.kind === 'color' && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(ColorPicker, { focusIndex: overlay.index, currentColor: channel.sessionColor, onPick: (index) => {
+                        dispatchOverlay({ type: 'close' });
+                        const name = SESSION_COLOR_NAMES[index];
+                        if (name) {
+                            channel.setSessionColor(name);
+                            channel.notify(t('color-set', { name }), { color: 'success' });
+                        }
+                    } }) })), overlay.kind === 'panel' && panelPickerRows.length > 0 && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(PanelPicker, { rows: panelPickerRows, focusIndex: overlay.index, activeId: sidePanel.activePanelId, onPick: (index) => {
+                        const row = panelPickerRows[index];
+                        dispatchOverlay({ type: 'close' });
+                        if (row !== undefined)
+                            sidePanel.openPanel(row.id, { focus: true });
+                    } }) })), overlay.kind === 'effort' && effortOptions.length > 1 && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(EffortSlider, { options: effortOptions, focusIndex: overlay.index, currentId: channel.reasoningEffort, levelsFallback: effortLevelsFallback, 
+                    // 点击档位 = 移到该档并即时应用（与 ←/→ 同语义）
+                    onPick: (index) => {
+                        dispatchOverlay({ type: 'set-index', kind: 'effort', index });
+                        const option = effortOptions[index];
+                        if (option)
+                            void channel.setEffort(option.id);
+                    } }) })), overlay.kind === 'preset' && presetOptions.length > 0 && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(PresetPicker, { presets: presetOptions, focusIndex: overlay.index, currentPreset: channel.agentPreset, onPick: (index) => {
+                        dispatchOverlay({ type: 'close' });
+                        const option = presetOptions[index];
+                        if (option)
+                            void channel.switchPreset(option.id);
+                    } }) })), overlay.kind === 'permission' && overlay.snapshot.options.length > 0 && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(PermissionsPicker, { options: overlay.snapshot.options, focusIndex: overlay.index, currentValue: overlay.snapshot.current?.value, cwd: channel.cwd, onPick: (index) => {
+                        if (approvalSnapshot !== null || questionSnapshot !== null || dialogSnapshot !== null)
+                            return;
+                        const option = overlay.snapshot.options[index];
+                        dispatchOverlay({ type: 'close' });
+                        if (option !== undefined)
+                            void runPermissionCommand(` ${option.value}`);
+                    } }) })), overlay.kind === 'mode' && overlay.modes.length > 0 && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(ModePicker, { modes: overlay.modes, focusIndex: overlay.index, currentId: overlay.currentId, onPick: (index) => {
+                        if (approvalSnapshot !== null || questionSnapshot !== null || dialogSnapshot !== null)
+                            return;
+                        const option = overlay.modes[index];
+                        dispatchOverlay({ type: 'close' });
+                        if (option !== undefined)
+                            void runBackendModeCommand(option.id, option.name);
+                    } }) })), overlay.kind === 'kernel' && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(KernelPicker, { options: kernelOptions, focusIndex: overlay.index, pinned: kernelPinned === true, onPick: (index) => {
+                        if (approvalSnapshot !== null || questionSnapshot !== null || dialogSnapshot !== null)
+                            return;
+                        pickKernel(index);
+                    } }) })), overlay.kind === 'sdk-install' && sdkPhase.kind !== 'idle' && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(SdkInstallWizard, { phase: sdkPhase }) })), overlay.kind === 'channel' && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(ChannelPicker, { rows: channelRows, focusIndex: overlay.index, onPick: (index) => {
+                        if (approvalSnapshot !== null || questionSnapshot !== null || dialogSnapshot !== null)
+                            return;
+                        pickChannel(index);
+                    } }) })), overlay.kind === 'plan' && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(PlanPicker, { focusIndex: overlay.index, currentOn: channel.mode.plan === true, onPick: (index) => {
+                        dispatchOverlay({ type: 'close' });
+                        const on = index === 0;
+                        void runExternalCommand('plan', on ? '' : ' off');
+                    } }) })), overlay.kind === 'lang' && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(LangPicker, { focusIndex: overlay.index, currentLang: getLang(), onPick: (index) => {
+                        const lang = LANGS[index];
+                        if (lang === undefined)
+                            return;
+                        dispatchOverlay({ type: 'close' });
+                        applyLang(lang);
+                    } }) })), overlay.kind === 'theme' && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(ThemePicker, { focusIndex: overlay.index, currentTheme: themeName, themeHost: themeHost, onPick: (index) => {
+                        dispatchOverlay({ type: 'close' });
+                        const name = getThemeOptions(themeHost)[index]?.value;
+                        if (name !== undefined) {
+                            const ok = setTheme(name);
+                            channel.notify(ok ? t('theme-switched-saved', { name }) : t('theme-switch-failed', { name }), { color: ok ? 'success' : 'error' });
+                        }
+                    } }) })), overlay.kind === 'history' && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(HistorySearchDialog, { query: overlay.query, cursorOffset: overlay.cursor, matches: historyMatches, focusIndex: overlay.focus, onPick: (index) => {
+                        // 点击行 = 填入该历史命令（与 Enter 同路径）
+                        const entry = historyMatches[index];
+                        if (entry) {
+                            setHistoryFill(entry.text);
+                            dispatchOverlay({ type: 'close' });
+                        }
+                    } }) })), overlay.kind === 'rewind' && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(RewindPicker, { rows: rewindRows, focusIndex: overlay.index, confirmRow: overlay.confirm, modes: overlay.modes, modeIndex: overlay.modeIndex, busy: overlay.busy, onPickRow: (index) => {
+                        // 列表页点击只选中：进入确认态保留键盘 Enter 显式触发
+                        dispatchOverlay({ type: 'set-index', kind: 'rewind', index });
+                    }, onConfirm: () => {
+                        // 确认页即显式确认层，点击直接执行（与 Enter 同路径）
+                        const row = overlay.confirm;
+                        if (row === null)
+                            return;
+                        dispatchOverlay({ type: 'close' });
+                        void performRewind(row);
+                    }, onPickMode: (index) => {
+                        // 模式列表点击直接执行该模式（与 Enter 同路径）
+                        const row = overlay.confirm;
+                        if (row === null)
+                            return;
+                        // 模式页仅当 modes 非空才渲染，这里空安全取值
+                        const mode = index === 0 ? null : (overlay.modes?.[index - 1]?.id ?? null);
+                        dispatchOverlay({ type: 'close' });
+                        void performRewind(row, mode);
+                    } }) })), overlay.kind === 'file-actions' && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(FileActionsPanel, { path: overlay.path, isDir: overlay.isDir, focusIndex: overlay.index, onPick: (index) => {
+                        // 点击行直接执行该动作（与 Enter 同路径）
+                        const path = overlay.path;
+                        dispatchOverlay({ type: 'close' });
+                        runFileAction(index, path);
+                    } }) })), overlay.kind === 'search' && _jsx(TranscriptSearch, { query: searchQuery, cursorOffset: searchCursor, count: searchCount, current: searchCurrent })] }));
     const screenOpen = channel.pluginScene !== undefined || supervisorOpen || settingsOpen
-        || subagentDetailId !== null || subagentDashboardOpen || sceneOpen;
+        || subagentDetailId !== null || subagentDashboardOpen || sceneOpen
+        || agentView !== null
+        || launchpadShown || onboardingOpen;
     if (interruptPanel !== null && screenOpen) {
         const node = (_jsx(Box, { flexDirection: "column", width: "100%", paddingX: 1, children: interruptPanel }));
         return fullscreen ? node : _jsx(AlternateScreen, { children: node });
@@ -4126,6 +5364,29 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
             }, children: renderScene ? renderScene(pluginScene.id, channel) : _jsxs(Text, { children: ["Scene unavailable: ", pluginScene.id] }) }));
         return fullscreen ? node : _jsx(AlternateScreen, { children: node });
     }
+    /**
+     * The first-run guide — the FIRST frame of a fresh installation.
+     *
+     * It sits above every other screen because it answers a question that comes
+     * before all of them: "is this thing wired up at all". A launch that needs
+     * setup has nothing useful to show behind a browser or a landing page.
+     *
+     * `activeModel` is deliberately undefined here: the wizard's model step
+     * switches models through `channel.switchModel`, which is the same path the
+     * chat screen uses, so a switch made inside the wizard is already live when
+     * the user lands on the launcher.
+     */
+    if (onboardingOpen) {
+        const node = (_jsx(Onboarding, { channel: channel, themeHost: themeHost, onClose: closeOnboarding, onApplyLang: applyLang, onRunCommand: (name) => {
+                // 与落地页的 onAction 同一条规则：打开整屏界面的命令要先把向导收掉。
+                // 走 `closeOnboarding('skipped')` 而不是直接置 false——用户是去试命令、
+                // 没答完引导，按 skipped 的口径不记账（下次启动还会问）。
+                if (!overlayCommandNames.has(name))
+                    closeOnboarding('skipped');
+                void runCommand(name, '');
+            } }));
+        return fullscreen ? node : _jsx(AlternateScreen, { children: node });
+    }
     /**
      * The session supervisor: a screen in the same sense as the tree — an early
      * return after every hook above has run, so there is no transcript
@@ -4142,7 +5403,7 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
      * while they read the list, which is why closing the screen only repaints
      * the transcript when the attached session actually changed.
      */
-    if (supervisorOpen) {
+    if (supervisorOpen && launchpadGate()) {
         /**
          * Live state per session, from the channel's own agent-view projection.
          * Reading the projection rather than a parallel source is what keeps this
@@ -4150,7 +5411,7 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
          * about which session is waiting for input.
          */
         const agentRowOf = (sessionId) => agentViewRows.find(row => row.id === sessionId);
-        const supervisorNode = (_jsx(SessionSupervisor, { channel: channel, home: homeDir(), onClose: closeHome, approval: approvalSnapshot, onApprove: outcome => approvals.decide(outcome), onOpenSession: async (sessionId) => {
+        const supervisorNode = (_jsx(SessionSupervisor, { channel: channel, home: homeDir(), onClose: closeHome, approval: approvalSnapshot, onApprove: (outcome, decision) => approvals.decide(outcome, decision), onOpenSession: async (sessionId) => {
                 // A refusal is reported by the screen itself (see `openSession`):
                 // the composer that draws channel notifications is not mounted here.
                 const result = await channel.resumeTo(sessionId);
@@ -4160,6 +5421,15 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
                 suppressLogoIntroRef.current = true;
                 setAgentViewReturnId(undefined);
                 setSupervisorOpen(false);
+                // 第七版：明确选中一个会话 = 有意导航（与 Esc「退出」相对）——浏览页
+                // 与盖在它底下的落地页**一起收**，人落在那个会话的聊天页。只收浏览页
+                // 会露出启动页，正是用户实测的「选完会话还是回到启动页」。落地页的
+                // 草稿/焦点也按 closeLaunchpad 同一口径清掉（进入的是别的会话，旧草稿
+                // 不该跟过去）。
+                setLaunchpadOpen(false);
+                setLaunchpadFocus(-1);
+                setLaunchpadDraft('');
+                setLaunchpadCaret(0);
                 repaintTranscript();
                 return result;
             }, onNewSession: async (target) => {
@@ -4168,14 +5438,24 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
                     suppressLogoIntroRef.current = true;
                     setAgentViewReturnId(undefined);
                     setSupervisorOpen(false);
+                    // 同 onOpenSession：新建/切工作区会话也是有意导航，落地页一并收。
+                    setLaunchpadOpen(false);
+                    setLaunchpadFocus(-1);
+                    setLaunchpadDraft('');
+                    setLaunchpadCaret(0);
                     repaintTranscript();
                 }
                 return ok;
             }, onStopSession: async (sessionId) => channel.stopBackgroundAgent?.(sessionId) ?? false, liveStateOf: (sessionId) => {
                 const row = agentRowOf(sessionId);
-                return row === undefined
-                    ? undefined
-                    : { status: row.status, live: row.live, current: row.current, summary: row.summary };
+                if (row !== undefined)
+                    return { status: row.status, live: row.live, current: row.current, summary: row.summary };
+                // Without agent view, only this terminal's current session has live state.
+                // oxlint-disable-next-line typescript/no-unnecessary-condition -- runtime guard: headless hosts render Chat with a partial channel
+                const hasAgentView = channel.backendCapabilities?.commands.includes('agentview') ?? true;
+                if (hasAgentView || sessionId !== channel.agentId)
+                    return undefined;
+                return { status: channel.working ? 'working' : 'idle', live: true, current: true, summary: '' };
             } }));
         // Inline hosts enter the alternate screen for the duration; full-screen
         // hosts are already in it and must not nest a second one.
@@ -4185,7 +5465,7 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
     // conversation (an early return after every hook above has run), so there
     // is no transcript underneath to be repainted or bled through. The dropped
     // turn's prompt returns through the same fill path a rewind picker uses.
-    if (treeOpen) {
+    if (treeOpen && launchpadGate()) {
         const tree = (_jsx(SessionTree, { channel: channel, currentSessionId: channel.agentId, onClose: () => setTreeOpen(false), onRestoreText: (text) => {
                 // The tree rewound to a node and is handing that turn's prompt back,
                 // exactly like the picker does. It belongs to the binding the tree
@@ -4198,21 +5478,47 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
     // The settings screen follows the browser's rule exactly: it REPLACES the
     // conversation (an early return after every hook above has run), so there
     // is no transcript underneath to be repainted or bled through.
-    if (settingsOpen) {
+    if (settingsOpen && launchpadGate()) {
         const screen = _jsx(Settings, { channel: channel, onClose: () => setSettingsOpen(false) });
         return fullscreen ? screen : _jsx(AlternateScreen, { children: screen });
     }
+    // Main-screen read-only Agent View: a scene over the mounted Chat, with no
+    // second Channel and no change of the bound session. It borrows the screen
+    // the way the trajectory scene does; Chat stays mounted, so the parent's
+    // rows, draft, pending queue and usage are untouched by the round trip.
+    // Esc returns to wherever the view was opened from.
+    if (agentView !== null && launchpadGate()) {
+        const viewSubagent = channel.subagents.find(s => s.agentId === agentView.agentId);
+        if (!viewSubagent) {
+            // The roster lost this child (session switch): pop the view, don't crash.
+            setAgentView(null);
+            return null;
+        }
+        // Headless stubs mount Chat without a subagentControl at all.
+        const messageControl = channel.subagentControl?.message;
+        const loadTranscript = channel.subagentControl?.history;
+        const viewMessages = messageControl === undefined ? [] : messageControl.messages().filter(m => m.from === agentView.agentId || m.to === agentView.agentId);
+        const viewTarget = agentComposeTargetOf(agentView.agentId, new Map(channel.subagents.map(s => [s.agentId, s.description])));
+        const viewScene = (_jsx(AgentTranscriptScene, { subagent: viewSubagent, source: agentView.source, onExit: () => exitAgentView(agentView.source), ...(loadTranscript === undefined ? {} : { loadTranscript }), messages: viewMessages, ...(messageControl === undefined ? {} : { compose: { control: messageControl, target: viewTarget } }), roster: channel.subagents, 
+            // Switching to a sibling or the parent swaps the viewed agent in
+            // place; Esc still returns to the original entry point.
+            onSwitchAgent: switchViewedAgent }));
+        return fullscreen ? viewScene : _jsx(AlternateScreen, { children: viewScene });
+    }
     // Subagent detail scene: displays detailed view of a specific subagent.
     // Like the browser and settings, it replaces the conversation entirely.
-    if (subagentDetailId !== null) {
+    if (subagentDetailId !== null && launchpadGate()) {
         const subagent = channel.subagents.find(s => s.agentId === subagentDetailId);
         if (!subagent) {
-            // Agent not found, go back to dashboard
+            // Agent not found, go back to the dashboard (side panel when split).
             setSubagentDetailId(null);
-            setSubagentDashboardOpen(true);
+            openSubagentDashboard();
             return null;
         }
-        const scene = (_jsx(SubagentDetailScene, { subagent: subagent, onInterrupt: (id) => channel.subagentControl.interrupt(id), onBack: () => {
+        const detailControl = channel.subagentControl?.message;
+        const detailMessages = detailControl === undefined ? [] : detailControl.messages().filter(m => m.from === subagent.agentId || m.to === subagent.agentId);
+        const detailTarget = agentComposeTargetOf(subagent.agentId, new Map(channel.subagents.map(s => [s.agentId, s.description])));
+        const scene = (_jsx(SubagentDetailScene, { subagent: subagent, onInterrupt: (id) => channel.subagentControl?.interrupt(id), ...(channel.subagentControl?.history === undefined ? {} : { loadTranscript: channel.subagentControl.history }), onOpenView: () => openAgentView(subagent.agentId, { kind: 'agent-detail', agentId: subagent.agentId }), messages: detailMessages, ...(detailControl === undefined ? {} : { compose: { control: detailControl, target: detailTarget } }), onBack: () => {
                 setSubagentDetailId(null);
                 setSubagentDashboardOpen(true);
             } }));
@@ -4220,8 +5526,8 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
     }
     // Jobs panel: background jobs (running/killed) with kill/inspect actions.
     // Like the browser and settings, it replaces the conversation entirely.
-    if (jobsPanelOpen) {
-        const panel = (_jsx(JobsPanel, { jobs: channel.backgroundJobs ?? [], onClose: () => setJobsPanelOpen(false), onKill: (id) => {
+    if (jobsPanelOpen && launchpadGate()) {
+        const panel = (_jsx(JobsPanel, { jobs: channel.backgroundJobs ?? [], initialFocusId: jobsPanelFocusId ?? undefined, onClose: () => { setJobsPanelOpen(false); setJobsPanelFocusId(null); }, onWatchOutput: watchJobOutput, onKill: (id) => {
                 // Stub channels (verify harnesses) have no jobControl — surface
                 // the same failure toast as a refused kill instead of throwing.
                 if (channel.jobControl?.kill(id) !== true) {
@@ -4230,19 +5536,28 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
             } }));
         return fullscreen ? panel : _jsx(AlternateScreen, { children: panel });
     }
+    // ⤢ btw thread scene (openPanelFullscreen 'btw'): the whole-terminal form
+    // of the sidebar panel. Esc returns to the sidebar exactly as it was — the
+    // thread and the composer draft live in btwThreads, nothing is cleared.
+    if (btwSceneOpen && launchpadGate()) {
+        const scene = (_jsx(BtwThreadScene, { channel: channel, onClose: () => setBtwSceneOpen(false) }));
+        return fullscreen ? scene : _jsx(AlternateScreen, { children: scene });
+    }
     // Subagent dashboard: displays all active and completed subagents.
     // Like the browser and settings, it replaces the conversation entirely.
-    if (subagentDashboardOpen) {
+    if (subagentDashboardOpen && launchpadGate()) {
+        // No kernel serves agents from other sessions yet, so the dashboard gets
+        // no `peers`; once one does, pass them here.
         const dashboard = (_jsx(SubagentDashboard, { subagents: [...channel.subagents], onSelect: (id) => {
                 setSubagentDashboardOpen(false);
                 setSubagentDetailId(id);
-            }, onClose: () => setSubagentDashboardOpen(false) }));
+            }, onOpenView: (id) => openAgentView(id, { kind: 'agents-dashboard' }), messages: channel.subagentControl?.message?.messages(), onClose: () => setSubagentDashboardOpen(false) }));
         return fullscreen ? dashboard : _jsx(AlternateScreen, { children: dashboard });
     }
     /** Prompt input is inert while a modal dialog owns the keyboard. The
      *  overlay union covers every picker/dialog and /tips in one check;
      *  message-selection mode and the /btw panel live outside it. */
-    const promptSelectionActive = selectionActive || overlay.kind !== 'none' || btw !== null;
+    const promptSelectionActive = selectionActive || overlay.kind !== 'none' || btwOverlayOpen;
     // These panels replace the visible composer, but PromptInput remains
     // mounted (suspended) so an async registry command cannot lose its exact
     // text/image draft while it waits for a user decision.
@@ -4250,7 +5565,7 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
         || dialogSnapshot !== null
         || overlay.kind === 'tips'
         || (recap !== null && (!recap.auto || recap.expanded))
-        || btw !== null
+        || btwOverlayOpen
         || questionPanelNode !== null
         || starModal !== null
         || couponVisible;
@@ -4262,10 +5577,158 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
     // `<AlternateScreen>` is skipped when the app is already fullscreen —
     // nesting it would emit a second DEC 1049, and its unmount would drop the
     // whole app back to the main screen.
-    if (sceneOpen) {
+    if (sceneOpen && launchpadGate()) {
         const scene = _jsx(TrajectoryScene, { channel: channel, build: trajectory, onClose: closeScene });
         return fullscreen ? scene : _jsx(AlternateScreen, { children: scene });
     }
+    /**
+     * The launchpad — the landing page an ordinary launch starts on.
+     *
+     * 第七版渲染姿态：early-return 排在**所有整屏界面（会话浏览器 / 设置 /
+     * 任务面板 / 家谱 / 子代理 / 轨迹场景）之后**——从落地页打开的整屏盖在
+     * 落地页之上，Esc 退出整屏回到这里（草稿/参数/焦点原样保留）。硬约束：
+     * 从启动页进入对话页的唯一路径是**提交一条非命令消息**（Enter 发送）；
+     * 任何 Esc/返回都回到启动页。参数行点开的选择器经 `pickerPanels` +
+     * `inputPaused` 渲染在本屏之上，Esc 关掉它也回到这里。
+     */
+    if (launchpadShown) {
+        // 参数行的「模式/权限」两段（第三版）：模式看 channel.mode.plan；权限看
+        // permissionPresets() 的当前身份——只认 runtime 名册，legacy/unavailable 与
+        // 抛错都按「拿不到」处理（缺省不画那一段，两段都可选）。
+        let launchpadPermission;
+        try {
+            const snapshot = channel.permissionPresets();
+            launchpadPermission = snapshot.availability === 'runtime' ? snapshot.current?.name : undefined;
+        }
+        catch {
+            launchpadPermission = undefined;
+        }
+        // 第七版动作表：状态快照全部来自既有数据源（详见 launchpadActions.ts）——
+        //   - lastSessionTitle = agentViewRows（含持久化名册）里最近一条非当前会话
+        //     的标题——listing 是异步的，落地前没有 Continue、落地后自动长出来；
+        //   - jobsRunning / updateAvailable / starDue = 条件位三连（后台任务面 /
+        //     checkForTuiUpdate / usageStats 里程碑口径）。
+        const resumableRows = agentViewRows
+            .filter(row => !row.current && row.id !== channel.agentId && row.title.trim() !== '');
+        const latestRow = resumableRows.reduce((best, row) => (best === undefined || row.updatedAt > best.updatedAt ? row : best), undefined);
+        const launchpadActions = resolveLaunchpadActions({
+            lastSessionTitle: latestRow?.title,
+            // 条件位①：后台任务面是真数据（JobsPanel 同一个 channel.backgroundJobs），
+            // running/stopping 都算「在跑」。
+            jobsRunning: (channel.backgroundJobs ?? []).some(job => job.status === 'running' || job.status === 'stopping'),
+            updateAvailable: launchpadUpdateAvailable,
+            starDue: launchpadStarDue,
+            // 内核入口带名（「内核 · Claude」）：backendId 是内核身份的唯一来源。
+            backendId: kernelCurrentId,
+        });
+        const launchpad = (_jsx(Launchpad, { query: launchpadDraft, cursorOffset: launchpadCaret, focusIndex: launchpadFocus, isTerminalFocused: terminalFocused, whale: channel.whale, whaleIdle: channel.whaleIdle, whaleGirl: channel.whaleGirl, fontId: splashFontIdOf(channel.splashFont), brand: brand, starred: starred, onStarClick: runStarAction, firstRun: onboardingPending, actions: launchpadActions, 
+            // 参数行四段点开的既有选择器（第五版）：pickerPanels 与聊天页共用
+            // 同一份 JSX，盖在落地页之上；选择器开着时落地页键盘让位（inputPaused）。
+            overlayPanel: launchpadOverlayUp ? pickerPanels : undefined, inputPaused: launchpadOverlayUp, onParamPick: (segment) => {
+                // 四段 → 既有命令：model→/model、effort→/effort、preset→/preset、
+                // permission→/permission。全部在 overlayCommandNames 白名单里，
+                // 落地页不收，选择器盖上来。
+                // 第八版切换式（用户原话「点一下是展开 再点一下收起来」）：**同一段**
+                // 再点/再按 Enter = 收起（展开 ↔ 收起，键盘与鼠标同一条 onParamPick）。
+                // 点另一段仍直接切换，点空白/Esc 仍收起（上一版契约不回退）。
+                if (overlay.kind === segment) {
+                    dispatchOverlay({ type: 'close' });
+                    return;
+                }
+                // BUG 3（点另一段直接切换）：/effort 的选择器是异步 open-if（when:
+                // ['none']），盖着别的选择器时会被丢弃——这就是"点了没反应"的根因。
+                // 先把屏上的参数选择器收掉再开新的，一个在屏、且就是点的那段。
+                if (overlay.kind !== 'none') {
+                    dispatchOverlay({ type: 'close' });
+                }
+                void runCommand(segment, '');
+            }, onQueryChange: (text, cursor) => {
+                setLaunchpadDraft(text);
+                setLaunchpadCaret(cursor);
+            }, onSubmit: closeLaunchpad, onFocusChange: setLaunchpadFocus, onAction: (action) => {
+                // 第八版（用户实测：「刚点帮助，不知道为什么直接进入聊天页面了」）：
+                // 帮助**不属于**离开启动页的两条路（Enter 发非命令消息 / 会话浏览
+                // 里选中会话）——它盖在落地页之上（overlay kind 'help'），再点同一
+                // 入口 = 收起（与参数段同一条切换语义）。
+                if (action.command === 'help') {
+                    dispatchOverlay(overlay.kind === 'help'
+                        ? { type: 'close' }
+                        : { type: 'open', overlay: { kind: 'help' } });
+                    return;
+                }
+                // 第七版姿态：覆盖层命令（overlayCommandNames）盖在落地页之上；
+                // **整屏命令**（launchpadScreenCommands：会话与工作区 / 设置 / 后台
+                // 任务 / 家谱 / 子代理 / 引导）也盖在落地页之上——落地页不收，
+                // Esc 退出整屏回到落地页（草稿/参数/焦点都在）。整屏要先过
+                // launchpadGate 的授权位（防御：异步误置的整屏状态盖不走启动页）。
+                // 其余命令（star / update——反馈在对话页的转录/通知）仍收掉落地页
+                // 再执行，这是用户主动执行命令，不是「返回」。
+                if (launchpadScreenCommands.has(action.command)) {
+                    authorizeLaunchpadCover();
+                }
+                else if (!overlayCommandNames.has(action.command)) {
+                    setLaunchpadOpen(false);
+                }
+                void runCommand(action.command, '');
+            }, onEscape: (intent) => {
+                if (intent === 'exit') {
+                    requestExit();
+                    return;
+                }
+                // 空输入按 Esc：这一屏的"下一步"通常是去挑工作区/会话。第七版：
+                // 会话浏览器**盖在落地页之上**（落地页不收）——Esc 退出浏览器回到
+                // 落地页，绝不落到对话页。这是从落地页出发的交互：过闸门授权。
+                agentViewOpenSessionRef.current = channel.agentId;
+                authorizeLaunchpadCover();
+                setSupervisorOpen(true);
+            }, onBlankClick: () => {
+                // BUG 3（点别处关掉选择器）：沿用"点空白收回焦点"的兜底路径——
+                // 有参数选择器盖在落地页之上时，空白点击先把选择器收掉（焦点照旧
+                // 收回输入框）。选择器内部的点击已被 Launchpad 的浮层包装拦住
+                // 冒泡，不会走到这里。
+                if (overlay.kind !== 'none')
+                    dispatchOverlay({ type: 'close' });
+                setLaunchpadFocus(-1);
+            }, model: channel.modelDisplay ?? channel.model, effort: channel.reasoningEffort, preset: channel.agentPreset === undefined
+                ? undefined
+                : presetOptions.find(option => option.id === channel.agentPreset)?.name ?? channel.agentPreset, permission: launchpadPermission, commands: launchpadOverlayUp || !launchpadDraft.startsWith('/')
+                ? undefined
+                : channel.commandCompletions(launchpadDraft), onCommandPick: (commandLine) => {
+                // 补全面板选中（Enter/Tab/点击）：走 runCommand，与快捷入口同一条
+                // 白名单口径——覆盖层与整屏命令（第七版 launchpadScreenCommands）
+                // 不收落地页（盖在它之上），其余收掉再执行。/help 与快捷入口同一条
+                // 拦截：盖屏浮层，不进对话页（第八版）。
+                const parsed = parseCommandName(commandLine);
+                if (parsed === undefined)
+                    return;
+                if (parsed.name === 'help') {
+                    dispatchOverlay({ type: 'open', overlay: { kind: 'help' } });
+                    return;
+                }
+                if (launchpadScreenCommands.has(parsed.name)) {
+                    authorizeLaunchpadCover();
+                }
+                else if (!overlayCommandNames.has(parsed.name)) {
+                    setLaunchpadOpen(false);
+                }
+                void runCommand(parsed.name, parsed.rawInput);
+            }, cwd: channel.displayCwd, branch: channel.gitBranch, tuiVersion: tuiVersion, 
+            // 右下角的内核行：与选择器同一份目录，标出当前内核，点它打开选择器。
+            kernels: kernelOptions, onKernelPick: () => openKernelPicker(), 
+            // 左下角工作目录铭牌（第七版）：点开/回车开既有 /workspace 菜单——
+            // workspace-menu 在 LAUNCHPAD_OVERLAY_KINDS 里，选择器盖在落地页之上，
+            // Esc 回落地页（与参数行选择器同一姿态），不新造面板。
+            onOpenWorkspace: () => { void runCommand('workspace', ''); } }));
+        // 落地页这一屏的完整树（AC-4）：Tooltip 单例层挂在**最外层最后**——与下面
+        // 聊天主树末尾那处（SidePanelLayout 里）是同一个组件、同一条"单例层挂树尾"
+        // 姿态；参数行被截断的段（ParamChip 写的锚点）hover 600ms 后由它画完整名。
+        // 本屏没有滚动、也没有面板几何过渡 ⇒ 不需要 subscribeInvalidation；但**必须**给
+        // invalidationKey：选择器是**盖在落地页之上**的浮层，落地页不卸载、指针也不一定
+        // 离开被悬停的那一段，没有这个键时旧卡片会继续画在选择器上方（复核场景回归见
+        // `verify-launchpad-onboarding-chat` 的 R4）。
+        const node = (_jsxs(_Fragment, { children: [launchpad, _jsx(TooltipLayer, { invalidationKey: overlay.kind })] }));
+        return fullscreen ? node : _jsx(AlternateScreen, { children: node });
+    }
     // 浮层整体挂载条件：与内部各面板的可见条件同值（数据门在
     // dialogOverlayVisible 里逐面板镜像）。关闭时把整个 absolute 浮层从树里
     // 移除——渲染器的"移除 absolute 节点"检测只看被移除子树自身的
@@ -4276,6 +5739,7 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
         workspaceTargetCount: workspaceTargets.length,
         effortOptionCount: effortOptions.length,
         presetOptionCount: presetOptions.length,
+        panelCount: panelPickerRows.length,
     }) && !(overlay.kind === 'permission'
         && (approvalSnapshot !== null || questionSnapshot !== null || dialogSnapshot !== null));
     // The sticky header pins the turn owning the viewport top row once its
@@ -4298,8 +5762,8 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
     // the transcript viewport height from the ScrollBox handle and the content
     // column width. The full-screen (editor-open) placement uses the terminal.
     const imagePreviewRegion = promptEditorOpen
-        ? { columns: terminalColumns, rows: terminalRows }
-        : { columns: terminalColumns, rows: handle?.getViewportHeight() ?? terminalRows };
+        ? { columns: chatColumns, rows: terminalRows }
+        : { columns: chatColumns, rows: handle?.getViewportHeight() ?? terminalRows };
     const imagePreviewNode = activePreview !== null && (activePreview.peek || imagePreviewOwned)
         ? (_jsx(ImagePreviewOverlay, { image: activePreview.image, title: activePreview.title, navigation: previewGallery.length > 1 && previewIndex >= 0 ? {
                 index: previewIndex, total: previewGallery.length,
@@ -4308,253 +5772,128 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
                 ? () => setPeekSuppressed(peekKey(activePreview.image, activePreview.title))
                 : () => dispatchOverlay({ type: 'close-if', kind: 'image-preview' }), region: imagePreviewRegion }))
         : null;
-    return (_jsxs(Box, { ref: wakeTickRef, flexDirection: "column", flexGrow: 1, width: "100%", children: [!isSticky && timeline.activeId !== null && (_jsx(PinnedTurnHeader, { text: anchorUserText || null, onClick: () => {
-                    // Click snaps the pinned prompt to the viewport top. Jump by the
-                    // SAME content coordinate the
-                    // rail's tick uses (timeline turn top = the prompt TEXT top):
-                    // the element-based seek lands the row wrapper's margin at the
-                    // top instead — one row shy of the text top the anchor rule
-                    // compares against — and the header would flip to the previous
-                    // turn immediately after the click.
-                    const turn = timeline.turns.find(t => t.id === anchorUserRowId);
-                    if (turn)
-                        handle?.scrollTo(turn.top);
-                    else if (anchorUserRowId !== null)
-                        seekRow(anchorUserRowId);
-                    else
-                        handle?.scrollToBottom();
-                } })), _jsxs(Box, { flexDirection: "row", flexGrow: 1, flexShrink: 1, marginRight: -pageInsetX, children: [_jsxs(ScrollBox, { ref: setHandle, flexDirection: "column", flexGrow: 1, flexShrink: 1, stickyScroll: true, children: [_jsx(LogoHeader, { model: channel.model, effort: channel.reasoningEffort, cwd: channel.displayCwd, 
-                                // 大字字面（设置项 `dsh-tui.splashFont`）：`daily` 交回按天轮换
-                                // （`undefined`），其余 pin 住一款。
-                                fontId: splashFontIdOf(channel.splashFont), whale: channel.whale, whaleIdle: channel.whaleIdle && whaleArtVisible, whaleGirl: channel.whaleGirl, starred: starred, onStarClick: runStarAction, working: channel.working, 
-                                // Resuming a long session skips the ~3.4s opening animation: it
-                                // keeps firing low-frequency React commits that compete with the
-                                // transcript mount batches (and the first wheel events) for the
-                                // frame budget right when the user wants to read history. Fresh
-                                // sessions keep the full intro; restored ones settle instantly.
-                                // A remount after a whole screen closed also settles instantly
-                                // (see suppressLogoIntroRef).
-                                skipIntro: suppressLogoIntroRef.current || channel.rows.length > 30 }, logoNonce), loadedContextVisible && (_jsx(LoadedContextPanel, { context: channel.loadedContext, open: loadedContextOpen, onToggle: toggleLoadedContext })), _jsx(MessageList, { rows: channel.rows, failureHintRowId: failureHintRowId, failureHint: t('traj-hint-failure', { key: primaryComboString('trajectory') }), expanded: expanded, expandedRows: expandedRows, selectedId: selectionActive ? selectedId : null, onToggleRow: toggleRowExpanded, streamViewToggledRows: streamViewToggledRows, onToggleStreamView: toggleStreamView, model: channel.model, diffLayout: channel.diffLayout, thinkingFold: channel.thinkingFold, toolBackground: channel.toolBackground, foldTerminalCommand: channel.foldTerminalCommand, smoothStreaming: channel.smoothStreaming, activityFrames: channel.activityFrames, showAll: showAllMessages, thinkingVisible: thinkingVisible, historyPaintEnabled: !fullscreen, onToggleAll: () => { setShowAllMessages(previous => !previous); }, onLoadOlder: () => channel.loadOlder(), registerRowRef: registerRowRef, scrollHandle: handle, forceMountRowId: forceMountRowId, newSinceRowId: isSticky ? null : lastSeenRowIdRef.current, onUnseenCount: setUnseenCount, onTimeline: setTimeline, onOpenSubagent: setSubagentDetailId, onOpenJobs: openJobsPanel, onOpenFile: openFileActions, sessionCwd: channel.cwd, onPreviewImage: openImagePreview, suppressImageGraphics: activePreview !== null })] }), (() => {
-                        // Gutter mode (settings `dsh-tui.scrollGutter`): the timeline
-                        // rail (default), the proportional scrollbar, or nothing. The
-                        // slot keeps its 2 columns in both rendered modes (Qwen's
-                        // permanent-gutter rule — an appearing/disappearing gutter
-                        // changes the transcript width and rewraps everything).
-                        const gutter = normalizeScrollGutter(channel.scrollGutter);
-                        if (gutter === 'hidden')
-                            return null;
-                        if (gutter === 'scrollbar') {
-                            return _jsx(ScrollbarGutter, { handle: handle, terminalWidth: terminalColumns });
-                        }
-                        return (_jsx(TimelineRail, { handle: handle, turns: timeline.turns, activeId: timeline.activeId, upId: timeline.upId, downId: timeline.downId, terminalWidth: terminalColumns, hoverEnabled: !promptSelectionActive, onRevealTurn: revealAndSeekRow }));
-                    })(), !promptEditorOpen && imagePreviewNode] }), _jsxs(Box, { flexDirection: "column", flexShrink: 0, children: [showPill && (_jsx(NewMessagesPill, { count: unseenCount, onClick: () => handle?.scrollToBottom() })), channel.working &&
-                        (activitySlot &&
-                            workingActivity !== undefined &&
-                            workingActivity.line !== '' &&
-                            workingActivity.phase !== 'idle' ? (_jsx(Box, { marginTop: 1, children: _jsx(ActivityLine, { activity: workingActivity, activityFrames: channel.activityFrames, warnPct: activityWarnPct, warnDanger: activityWarnPct !== undefined && activityWarnPct >= 95, 
-                                // Upload = real tokens of the last request; download =
-                                // the animated chars/4 estimate, matching the classic
-                                // spinner's counter (the suffix used raw chars before,
-                                // inflating the reading next to a real upload number). An
-                                // automatic compaction mid-turn badges THIS line too — it is
-                                // the spinner slot whenever real activity data exists.
-                                suffix: `${lastUploadTokens > 0 ? ` · ↑ ${formatTokens(lastUploadTokens)}` : ''} · ↓ ${formatTokens(Math.round(channel.responseChars / 4))} tokens${compactionBadge === undefined ? '' : ` · ${compactionBadge}`}` }) })) : (_jsx(WorkingSpinner, { mode: channel.spinnerMode, hasActiveTools: channel.activeToolCount > 0, responseLengthRef: responseLengthRef, uploadTokensRef: uploadTokensRef, loadingStartTimeRef: loadingStartTimeRef, totalPausedMsRef: totalPausedMsRef, pauseStartTimeRef: pauseStartTimeRef, thinkingStatus: thinkingStatus, suffix: compactionBadge }))), !channel.working && channel.compaction !== undefined && (_jsx(CompactionStatusRow, { compaction: channel.compaction, activityPreset: activitySlot ? channel.activityFrames : undefined })), _jsx(GoalTodoPanel, { channel: channel, collapsed: todoCollapsed, onToggle: () => setTodoCollapsed(previous => !previous) }), recap !== null && recap.auto && !recap.expanded && (_jsx(AutoRecapRow, { summary: recap.summary, streaming: !recap.done, onExpand: () => setRecap(prev => (prev ? { ...prev, expanded: true } : prev)), onDismiss: () => closeRecap() })), balance !== null && (_jsx(BalanceReportRow, { result: balance.result, refreshing: balance.refreshing, tokens: channel.tokens, model: channel.model, provider: channel.provider, mainCost: channel.mainCost, subagentCost: channel.subagentCost, onRefresh: runBalance, onDismiss: () => setBalance(null) })), statusEntries.length > 0 && (_jsx(Text, { dimColor: true, wrap: "truncate", children: statusEntries.map(entry => entry.text).join(' · ') })), activePreview === null && statusViews.map(view => (_jsx(PluginStatusViewBoundary, { viewKey: view.key, onError: (key, error) => statusContributions.reportViewError(key, error), children: _jsx(Box, { flexDirection: "column", flexShrink: 0, maxHeight: view.maxRows, overflow: "hidden", children: _jsx(Box, { flexDirection: "column", flexShrink: 0, children: React.createElement(view.component, {
-                                    React,
-                                    ui: STATUS_VIEW_UI,
-                                }) }) }) }, `${view.key}:${view.registrationId}`))), _jsxs(Box, { flexDirection: "column", flexShrink: 0, children: [approvalPanelNode !== null ? (approvalPanelNode) : dialogSnapshot !== null ? (_jsx(ExtensionDialog, { dialog: dialogSnapshot, onDecide: value => dialogs.decide(dialogSnapshot.key, value), onCancel: () => dialogs.cancel(dialogSnapshot.key) }, dialogSnapshot.key)) : overlay.kind === 'tips' ? (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(TipsPanel, { onClose: () => dispatchOverlay({ type: 'close-if', kind: 'tips' }) }) })) : recap !== null && (!recap.auto || recap.expanded) ? (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(RecapPanel, { summary: recap.summary, title: recap.title, error: recap.error, streaming: !recap.done, titleApplied: recap.titleApplied, onClose: () => {
-                                        // An expanded auto recap collapses back to its dim row;
-                                        // a manual /recap closes outright.
-                                        if (recap.auto) {
-                                            setRecap(prev => (prev ? { ...prev, expanded: false } : prev));
-                                        }
-                                        else {
-                                            closeRecap();
-                                        }
-                                    }, onCopy: () => {
-                                        void setClipboard(recap.summary ?? '').then(raw => { if (raw)
-                                            writeRaw?.(raw); });
-                                        channel.notify(t('copied-chars', { n: (recap.summary ?? '').length }), { timeoutMs: 1500 });
-                                    }, onApplyTitle: () => {
-                                        if (recap.title === undefined || recap.titleApplied)
-                                            return;
-                                        channel.renameSession(recap.title);
-                                        setRecap(prev => (prev ? { ...prev, titleApplied: true } : prev));
-                                        channel.notify(t('recap-title-applied-notify', { title: recap.title }), { color: 'success' });
-                                    } }) })) : btw !== null ? (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(BtwPanel, { question: btw.question, answer: btw.answer, error: btw.error, streaming: !btw.done, onClose: closeBtw, onCopy: () => {
-                                        void setClipboard(btw.answer ?? '').then(raw => { if (raw)
-                                            writeRaw?.(raw); });
-                                        channel.notify(t('copied-chars', { n: (btw.answer ?? '').length }), { timeoutMs: 1500 });
-                                    } }) })) : questionPanelNode !== null ? (questionPanelNode) : null, _jsx(PromptInput, { channel: channel, suspended: promptReplacementOpen, draftCache: promptDraftRef.current, helpOpen: helpOpen, onToggleHelp: () => { setHelpOpen(previous => !previous); }, onRunCommand: runCommand, selectionActive: promptSelectionActive, fillText: historyFill, onFillConsumed: () => setHistoryFill(null), onRewindRequest: openRewind, onBackgroundRequest: backgroundToAgentView, 
-                                // The 🏠 at the head of the input row opens the same session screen
-                                // `/resume` and `/agentview` open — one surface, three doors. It is
-                                // gated on this prop rather than a setting, so hosts that mount the
-                                // prompt without a session screen (and the layout regressions that
-                                // pin the row's column budget) keep the row they had.
-                                onOpenSessions: () => {
-                                    agentViewOpenSessionRef.current = channel.agentId;
-                                    setSupervisorOpen(true);
-                                }, backgroundAgentsNeedingInput: 
-                                // Only the real channel supplies the seam; pre-agent-view test
-                                // stubs must not grow the footer row (layout-dependent
-                                // regressions pin the visible row count). The footer only
-                                // renders while some session actually waits (N > 0): a
-                                // permanent idle row would steal a transcript row on every
-                                // real channel — one row is enough to scroll the startup
-                                // header fully off a short terminal, pausing its viewport
-                                // clock and shifting every row-count layout invariant.
-                                channel.agentViewRows !== undefined && backgroundAgentsNeedingInput > 0
-                                    ? backgroundAgentsNeedingInput
-                                    : undefined, controllerRef: promptControllerRef, onCaretImage: handleCaretImage, caretPreviewOpen: peekPreview !== null, onDismissCaretPreview: dismissPeek }, "prompt-input"), _jsx(StatusLine, { channel: channel, activity: workingActivity, selectionActive: selectionActive, helpOpen: helpOpen, wake: wakeBand === undefined
-                                    ? undefined
-                                    : {
-                                        band: wakeBand,
-                                        hint: trajectorySeen ? undefined : primaryComboString('trajectory'),
-                                        tick: Math.floor(wakeTime / 120),
-                                        onOpen: openScene,
-                                        hoverHint: primaryComboString('trajectory'),
-                                    } }), dialogOverlayOpen && (_jsxs(OverlayAbove, { maxHeight: Math.max(terminalRows - 8, 1), children: [overlay.kind === 'thinking' && (_jsx(ThinkingToggle, { currentValue: thinkingVisible, focusIndex: overlay.focus, onPick: (index) => {
-                                            // 点击行 = 设焦点 + 应用（与 Enter 同一条路径）
-                                            const visible = index === 0;
-                                            setThinkingVisible(visible);
-                                            dispatchOverlay({ type: 'close' });
-                                            channel.notify(t('thinking-toggled', { state: visible ? t('thinking-on') : t('thinking-off') }));
-                                        } })), overlay.kind === 'workspace-picker' && workspaceTargets.length > 0 && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(WorkspacePicker, { targets: workspaceTargets, focusIndex: overlay.index, currentCwd: channel.cwd, onPick: (index) => {
-                                                // 点击行 = 切换该行目标（与 Enter 同一条路径）
-                                                const target = workspaceTargets[index];
-                                                dispatchOverlay({ type: 'close' });
-                                                if (target !== undefined)
-                                                    void channel.switchWorkspace(target);
-                                            } }) })), overlay.kind === 'workspace-menu' && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(WorkspaceMenuPicker, { options: workspaceMenuOptions, focusIndex: overlay.index, onPick: (index) => {
-                                                // 点击行 = 执行该行（与 Enter 同一条路径）
-                                                runWorkspaceMenuOption(workspaceMenuOptions[index]);
-                                            } }) })), overlay.kind === 'workspace-flow' && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(WorkspaceFlowPicker, { title: overlay.flow.title, choices: overlay.flow.choices, focusIndex: overlay.index, busy: overlay.busy, input: overlay.input, onPick: (index) => {
-                                                // 点击行 = 设焦点 + 执行分支（与 Enter 同一条路径）；
-                                                // busy/输入态在组件侧禁点
-                                                const choice = overlay.flow.choices[index];
-                                                if (choice === undefined)
-                                                    return;
-                                                dispatchOverlay({ type: 'set-index', kind: 'workspace-flow', index });
-                                                runWorkspaceFlowAction(signal => choice.choose(signal));
-                                            } }) })), overlay.kind === 'model' && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: models.length === 0 ? (_jsx(ModelPickerLoading, {})) : activeModelGroup === undefined ? (_jsx(ModelPicker, { groups: modelGroups, focusIndex: overlay.index, currentProvider: channel.provider, onPick: (index) => {
-                                                // 点击分组行 = 进入该组（与 Enter 同一条路径）
-                                                const group = modelGroups[index];
-                                                if (!group)
-                                                    return;
-                                                setModelGroup(group.provider);
-                                                if (group.provider === RECENTS_GROUP_PROVIDER) {
-                                                    dispatchOverlay({ type: 'set-index', kind: 'model', index: 0 });
-                                                    return;
-                                                }
-                                                const landing = modelPickerLanding(models.filter(model => model.provider === group.provider), channel.provider, channel.model);
-                                                dispatchOverlay({ type: 'set-index', kind: 'model', index: landing.index });
-                                            } })) : (_jsx(ModelPicker, { models: groupModels, groupLabel: activeModelGroup === RECENTS_GROUP_PROVIDER
-                                                ? t('picker-group-recent')
-                                                : modelGroups.find(group => group.provider === activeModelGroup)?.label, showBack: modelGroups.length > 1 && !modelPickerDirect, showProviderPrefix: activeModelGroup === RECENTS_GROUP_PROVIDER, focusIndex: overlay.index, currentModel: `${channel.provider}/${channel.model}`, onPick: (index) => {
-                                                // 点击行 = 应用该行模型（与 Enter 同一条路径）
-                                                const model = groupModels[index];
-                                                if (!model)
-                                                    return;
-                                                dispatchOverlay({ type: 'close' });
-                                                void switchModelRecorded(model.provider, model.id, model.name);
-                                            } })) })), overlay.kind === 'migrate' && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(MigratePicker, { rows: migrateRows ?? [], focusIndex: overlay.index, checked: migrateChecked, loading: migrateRows === null, onPick: (index) => {
-                                                const row = (migrateRows ?? [])[index];
-                                                if (!row)
-                                                    return;
-                                                setMigrateChecked(current => {
-                                                    const next = new Set(current);
-                                                    if (next.has(row.agentId))
-                                                        next.delete(row.agentId);
-                                                    else
-                                                        next.add(row.agentId);
-                                                    return next;
-                                                });
-                                            } }) })), overlay.kind === 'migrate-confirm' && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(MigrateConfirm, { rows: migratePending }) })), overlay.kind === 'skills' && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: skillsList === null ? (_jsx(SkillsPickerLoading, {})) : (_jsx(SkillsPicker, { skills: skillsList, focusIndex: overlay.index, onPick: (index) => {
-                                                const skill = skillsList[index];
-                                                if (!skill)
-                                                    return;
-                                                dispatchOverlay({ type: 'close' });
-                                                if (skill.userInvocable)
-                                                    setHistoryFill(`/${skill.name} `);
-                                            } })) })), overlay.kind === 'activity' && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(ActivityPicker, { focusIndex: overlay.index, currentPreset: channel.activityFrames, onPick: (index) => {
-                                                dispatchOverlay({ type: 'close' });
-                                                const name = PRESET_NAMES[index];
-                                                if (name)
-                                                    channel.setActivityFrames(name);
-                                            } }) })), overlay.kind === 'color' && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(ColorPicker, { focusIndex: overlay.index, currentColor: channel.sessionColor, onPick: (index) => {
-                                                dispatchOverlay({ type: 'close' });
-                                                const name = SESSION_COLOR_NAMES[index];
-                                                if (name) {
-                                                    channel.setSessionColor(name);
-                                                    channel.notify(t('color-set', { name }), { color: 'success' });
-                                                }
-                                            } }) })), overlay.kind === 'effort' && effortOptions.length > 1 && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(EffortSlider, { options: effortOptions, focusIndex: overlay.index, currentId: channel.reasoningEffort, 
-                                            // 点击档位 = 移到该档并即时应用（与 ←/→ 同语义）
-                                            onPick: (index) => {
-                                                dispatchOverlay({ type: 'set-index', kind: 'effort', index });
-                                                const option = effortOptions[index];
-                                                if (option)
-                                                    void channel.setEffort(option.id);
-                                            } }) })), overlay.kind === 'preset' && presetOptions.length > 0 && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(PresetPicker, { presets: presetOptions, focusIndex: overlay.index, currentPreset: channel.agentPreset, onPick: (index) => {
-                                                dispatchOverlay({ type: 'close' });
-                                                const option = presetOptions[index];
-                                                if (option)
-                                                    void channel.switchPreset(option.id);
-                                            } }) })), overlay.kind === 'permission' && overlay.snapshot.options.length > 0 && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(PermissionsPicker, { options: overlay.snapshot.options, focusIndex: overlay.index, currentValue: overlay.snapshot.current?.value, cwd: channel.cwd, onPick: (index) => {
-                                                if (approvalSnapshot !== null || questionSnapshot !== null || dialogSnapshot !== null)
-                                                    return;
-                                                const option = overlay.snapshot.options[index];
-                                                dispatchOverlay({ type: 'close' });
-                                                if (option !== undefined)
-                                                    void runPermissionCommand(` ${option.value}`);
-                                            } }) })), overlay.kind === 'plan' && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(PlanPicker, { focusIndex: overlay.index, currentOn: channel.mode.plan === true, onPick: (index) => {
-                                                dispatchOverlay({ type: 'close' });
-                                                const on = index === 0;
-                                                void runExternalCommand('plan', on ? '' : ' off');
-                                            } }) })), overlay.kind === 'lang' && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(LangPicker, { focusIndex: overlay.index, currentLang: getLang(), onPick: (index) => {
-                                                const lang = LANGS[index];
-                                                if (lang === undefined)
-                                                    return;
-                                                dispatchOverlay({ type: 'close' });
-                                                applyLang(lang);
-                                            } }) })), overlay.kind === 'theme' && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(ThemePicker, { focusIndex: overlay.index, currentTheme: themeName, themeHost: themeHost, onPick: (index) => {
-                                                dispatchOverlay({ type: 'close' });
-                                                const name = getThemeOptions(themeHost)[index]?.value;
-                                                if (name !== undefined) {
-                                                    const ok = setTheme(name);
-                                                    channel.notify(ok ? t('theme-switched-saved', { name }) : t('theme-switch-failed', { name }), { color: ok ? 'success' : 'error' });
+    return (_jsxs(Box, { ref: wakeTickRef, flexDirection: "column", flexGrow: 1, width: "100%", children: [_jsxs(SidePanelLayout, { geometry: sidePanel.geometry, focus: sidePanel.focus, onActivateChat: sidePanel.focusChat, onActivatePanel: sidePanel.focusPanel, side: _jsx(SidePanelColumn, { width: sidePanel.panelColumns, controller: sidePanel, channel: channel, activity: workingActivity, attention: {
+                        approvals: approvalSnapshot !== null ? 1 : 0,
+                        questions: questionSnapshot !== null ? 1 : 0,
+                    }, trajectory: trajectory, onExpand: openPanelFullscreen }), children: [!isSticky && timeline.activeId !== null && (_jsx(PinnedTurnHeader, { text: anchorUserText || null, onClick: () => {
+                            // Click snaps the pinned prompt to the viewport top. Jump by the
+                            // SAME content coordinate the
+                            // rail's tick uses (timeline turn top = the prompt TEXT top):
+                            // the element-based seek lands the row wrapper's margin at the
+                            // top instead — one row shy of the text top the anchor rule
+                            // compares against — and the header would flip to the previous
+                            // turn immediately after the click.
+                            const turn = timeline.turns.find(t => t.id === anchorUserRowId);
+                            if (turn)
+                                handle?.scrollTo(turn.top);
+                            else if (anchorUserRowId !== null)
+                                seekRow(anchorUserRowId);
+                            else
+                                handle?.scrollToBottom();
+                        } })), _jsxs(Box, { flexDirection: "row", flexGrow: 1, flexShrink: 1, marginRight: sidePanel.split ? 0 : -pageInsetX, children: [_jsxs(ScrollBox, { ref: setHandle, flexDirection: "column", flexGrow: 1, flexShrink: 1, stickyScroll: true, children: [_jsx(LogoHeader, { model: channel.modelDisplay ?? channel.model, effort: channel.reasoningEffort, cwd: channel.displayCwd, 
+                                        // 大字字面（设置项 `dsh-tui.splashFont`）：`daily` 交回按天轮换
+                                        // （`undefined`），其余 pin 住一款。
+                                        fontId: splashFontIdOf(channel.splashFont), whale: channel.whale, whaleIdle: channel.whaleIdle && whaleArtVisible, whaleGirl: channel.whaleGirl, brand: brand, starred: starred, onStarClick: runStarAction, working: channel.working, 
+                                        // Resuming a long session skips the ~3.4s opening animation: it
+                                        // keeps firing low-frequency React commits that compete with the
+                                        // transcript mount batches (and the first wheel events) for the
+                                        // frame budget right when the user wants to read history. Fresh
+                                        // sessions keep the full intro; restored ones settle instantly.
+                                        // A remount after a whole screen closed also settles instantly
+                                        // (see suppressLogoIntroRef).
+                                        skipIntro: suppressLogoIntroRef.current || channel.rows.length > 30 }, logoNonce), loadedContextVisible && (_jsx(LoadedContextPanel, { context: channel.loadedContext, open: loadedContextOpen, onToggle: toggleLoadedContext })), _jsx(MessageList, { rows: channel.rows, failureHintRowId: failureHintRowId, failureHint: t('traj-hint-failure', { key: primaryComboString('trajectory') }), expanded: expanded, expandedRows: expandedRows, selectedId: selectionActive ? selectedId : null, onToggleRow: toggleRowExpanded, streamViewToggledRows: streamViewToggledRows, onToggleStreamView: toggleStreamView, model: channel.modelDisplay ?? channel.model, diffLayout: channel.diffLayout, thinkingFold: channel.thinkingFold, jobGroupFold: channel.jobGroupFold, toolBackground: channel.toolBackground, foldTerminalCommand: channel.foldTerminalCommand, turnUsageRow: channel.turnUsageRow, smoothStreaming: channel.smoothStreaming, activityFrames: channel.activityFrames, showAll: showAllMessages, thinkingVisible: thinkingVisible, historyPaintEnabled: !fullscreen, fullscreen: fullscreen, onToggleAll: () => { setShowAllMessages(previous => !previous); }, onLoadOlder: () => channel.loadOlder(), registerRowRef: registerRowRef, scrollHandle: handle, forceMountRowId: forceMountRowId, newSinceRowId: isSticky ? null : lastSeenRowIdRef.current, onUnseenCount: setUnseenCount, onTimeline: setTimeline, onOpenSubagent: setSubagentDetailId, onOpenSubagentView: openSubagentViewFromCard, onOpenJobs: openJobsPanel, onOpenFile: openFileActions, sessionCwd: channel.cwd, onPreviewImage: openImagePreview, suppressImageGraphics: activePreview !== null, olderHistory: channel.olderHistory, onWatchJobOutput: watchJobOutput })] }), (() => {
+                                // Gutter mode (settings `dsh-tui.scrollGutter`): the timeline
+                                // rail (default), the proportional scrollbar, or nothing. The
+                                // slot keeps its 2 columns in both rendered modes (Qwen's
+                                // permanent-gutter rule — an appearing/disappearing gutter
+                                // changes the transcript width and rewraps everything).
+                                const gutter = normalizeScrollGutter(channel.scrollGutter);
+                                if (gutter === 'hidden')
+                                    return null;
+                                if (gutter === 'scrollbar') {
+                                    return _jsx(ScrollbarGutter, { handle: handle, terminalWidth: chatColumns });
+                                }
+                                return (_jsx(TimelineRail, { handle: handle, turns: timeline.turns, activeId: timeline.activeId, upId: timeline.upId, downId: timeline.downId, terminalWidth: chatColumns, hoverEnabled: !promptSelectionActive, onRevealTurn: revealAndSeekRow }));
+                            })(), !promptEditorOpen && imagePreviewNode] }), _jsxs(Box, { flexDirection: "column", flexShrink: 0, children: [showPill && (_jsx(NewMessagesPill, { count: unseenCount, onClick: () => handle?.scrollToBottom() })), channel.working &&
+                                (activitySlot &&
+                                    workingActivity !== undefined &&
+                                    workingActivity.line !== '' &&
+                                    workingActivity.phase !== 'idle' ? (_jsx(Box, { marginTop: 1, children: _jsx(ActivityLine, { activity: workingActivity, activityFrames: channel.activityFrames, warnPct: activityWarnPct, warnDanger: activityWarnPct !== undefined && activityWarnPct >= 95, 
+                                        // Upload = real tokens of the last request; download =
+                                        // the animated chars/4 estimate, matching the classic
+                                        // spinner's counter (the suffix used raw chars before,
+                                        // inflating the reading next to a real upload number). An
+                                        // automatic compaction mid-turn badges THIS line too — it is
+                                        // the spinner slot whenever real activity data exists.
+                                        suffix: `${lastUploadTokens > 0 ? ` · ↑ ${formatTokens(lastUploadTokens)}` : ''} · ↓ ${formatTokens(Math.round(channel.responseChars / 4))} tokens${compactionBadge === undefined ? '' : ` · ${compactionBadge}`}` }) })) : (_jsx(WorkingSpinner, { mode: channel.spinnerMode, hasActiveTools: channel.activeToolCount > 0, responseLengthRef: responseLengthRef, uploadTokensRef: uploadTokensRef, loadingStartTimeRef: loadingStartTimeRef, totalPausedMsRef: totalPausedMsRef, pauseStartTimeRef: pauseStartTimeRef, thinkingStatus: thinkingStatus, suffix: compactionBadge }))), !channel.working && channel.compaction !== undefined && (_jsx(CompactionStatusRow, { compaction: channel.compaction, activityPreset: activitySlot ? channel.activityFrames : undefined })), !(sidePanel.split && sidePanel.enabledPanelIds.includes('todo')) && (_jsx(GoalTodoPanel, { channel: channel, collapsed: todoCollapsed, onToggle: () => setTodoCollapsed(previous => !previous) })), recap !== null && recap.auto && !recap.expanded && (_jsx(AutoRecapRow, { summary: recap.summary, streaming: !recap.done, onExpand: () => setRecap(prev => (prev ? { ...prev, expanded: true } : prev)), onDismiss: () => closeRecap() })), balance !== null && (_jsx(BalanceReportRow, { result: balance.result, refreshing: balance.refreshing, tokens: channel.tokens, model: channel.modelDisplay ?? channel.model, provider: channel.provider, mainCost: channel.mainCost, subagentCost: channel.subagentCost, onRefresh: runBalance, onDismiss: () => setBalance(null) })), statusEntries.length > 0 && (_jsx(Text, { dimColor: true, wrap: "truncate", children: statusEntries.map(entry => entry.text).join(' · ') })), activePreview === null && statusViews.map(view => (_jsx(PluginStatusViewBoundary, { viewKey: view.key, onError: (key, error) => statusContributions.reportViewError(key, error), children: _jsx(Box, { flexDirection: "column", flexShrink: 0, maxHeight: view.maxRows, overflow: "hidden", children: _jsx(Box, { flexDirection: "column", flexShrink: 0, children: React.createElement(view.component, {
+                                            React,
+                                            ui: STATUS_VIEW_UI,
+                                        }) }) }) }, `${view.key}:${view.registrationId}`))), _jsxs(Box, { flexDirection: "column", flexShrink: 0, children: [approvalPanelNode !== null ? (approvalPanelNode) : dialogSnapshot !== null ? (_jsx(ExtensionDialog, { dialog: dialogSnapshot, onDecide: value => dialogs.decide(dialogSnapshot.key, value), onCancel: () => dialogs.cancel(dialogSnapshot.key) }, dialogSnapshot.key)) : overlay.kind === 'tips' ? (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(TipsPanel, { onClose: () => dispatchOverlay({ type: 'close-if', kind: 'tips' }) }) })) : recap !== null && (!recap.auto || recap.expanded) ? (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(RecapPanel, { summary: recap.summary, title: recap.title, error: recap.error, streaming: !recap.done, titleApplied: recap.titleApplied, onClose: () => {
+                                                // An expanded auto recap collapses back to its dim row;
+                                                // a manual /recap closes outright.
+                                                if (recap.auto) {
+                                                    setRecap(prev => (prev ? { ...prev, expanded: false } : prev));
                                                 }
-                                            } }) })), overlay.kind === 'history' && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(HistorySearchDialog, { query: overlay.query, cursorOffset: overlay.cursor, matches: historyMatches, focusIndex: overlay.focus, onPick: (index) => {
-                                                // 点击行 = 填入该历史命令（与 Enter 同路径）
-                                                const entry = historyMatches[index];
-                                                if (entry) {
-                                                    setHistoryFill(entry.text);
-                                                    dispatchOverlay({ type: 'close' });
+                                                else {
+                                                    closeRecap();
                                                 }
-                                            } }) })), overlay.kind === 'rewind' && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(RewindPicker, { rows: rewindRows, focusIndex: overlay.index, confirmRow: overlay.confirm, modes: overlay.modes, modeIndex: overlay.modeIndex, busy: overlay.busy, onPickRow: (index) => {
-                                                // 列表页点击只选中：进入确认态保留键盘 Enter 显式触发
-                                                dispatchOverlay({ type: 'set-index', kind: 'rewind', index });
-                                            }, onConfirm: () => {
-                                                // 确认页即显式确认层，点击直接执行（与 Enter 同路径）
-                                                const row = overlay.confirm;
-                                                if (row === null)
-                                                    return;
-                                                dispatchOverlay({ type: 'close' });
-                                                void performRewind(row);
-                                            }, onPickMode: (index) => {
-                                                // 模式列表点击直接执行该模式（与 Enter 同路径）
-                                                const row = overlay.confirm;
-                                                if (row === null)
+                                            }, onCopy: () => {
+                                                void setClipboard(recap.summary ?? '').then(raw => { if (raw)
+                                                    writeRaw?.(raw); });
+                                                channel.notify(t('copied-chars', { n: (recap.summary ?? '').length }), { timeoutMs: 1500 });
+                                            }, onApplyTitle: () => {
+                                                if (recap.title === undefined || recap.titleApplied)
                                                     return;
-                                                // 模式页仅当 modes 非空才渲染，这里空安全取值
-                                                const mode = index === 0 ? null : (overlay.modes?.[index - 1]?.id ?? null);
-                                                dispatchOverlay({ type: 'close' });
-                                                void performRewind(row, mode);
-                                            } }) })), overlay.kind === 'file-actions' && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(FileActionsPanel, { path: overlay.path, isDir: overlay.isDir, focusIndex: overlay.index, onPick: (index) => {
-                                                // 点击行直接执行该动作（与 Enter 同路径）
-                                                const path = overlay.path;
-                                                dispatchOverlay({ type: 'close' });
-                                                runFileAction(index, path);
-                                            } }) })), overlay.kind === 'search' && _jsx(TranscriptSearch, { query: searchQuery, cursorOffset: searchCursor, count: searchCount, current: searchCurrent })] }))] })] }), _jsx(TooltipLayer, { invalidationKey: `${overlay.kind}:${dialogOverlayOpen}:${btw !== null}`, subscribeInvalidation: subscribeTooltipInvalidation }), _jsx(PromptEditorLayer, {}), promptEditorOpen && imagePreviewNode, starModal !== null && STAR_MILESTONES[starModal.index] !== undefined && (_jsx(StarPrompt, { milestone: STAR_MILESTONES[starModal.index], actions: starModalActions, onClose: closeStarModal, initialPhase: starModal.phase })), couponVisible && coupon !== null && (_jsx(WhaleCouponPrompt, { notice: coupon, onShown: markCouponShown, onClose: closeCoupon }))] }));
+                                                channel.renameSession(recap.title);
+                                                setRecap(prev => (prev ? { ...prev, titleApplied: true } : prev));
+                                                channel.notify(t('recap-title-applied-notify', { title: recap.title }), { color: 'success' });
+                                            } }) })) : btwOverlayOpen && !sidePanel.enabledPanelIds.includes('btw') ? (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(BtwPanelFallback, { thread: btwOverlayThread, onClose: closeBtwOverlay, onCopy: answer => {
+                                                void setClipboard(answer).then(raw => { if (raw)
+                                                    writeRaw?.(raw); });
+                                                channel.notify(t('copied-chars', { n: answer.length }), { timeoutMs: 1500 });
+                                            } }) })) : questionPanelNode !== null ? (questionPanelNode) : null, _jsx(PromptInput, { channel: channel, suspended: promptReplacementOpen, 
+                                        // 宠物面板是活动面板时，通知由它的头顶气泡「说出来」，输入框上方
+                                        // 不再重复弹同一条（error 色除外——可能要行动的信号永远走 toast）。
+                                        // 渲染期判定（split + activePanelId），与气泡同一次提交切换，不会
+                                        // 先闪一帧 toast 再消失。
+                                        toastSuppressed: petSaysNotices, draftCache: promptDraftRef.current, helpOpen: helpOpen, onToggleHelp: () => { setHelpOpen(previous => !previous); }, onRunCommand: runCommand, selectionActive: promptSelectionActive, fillText: historyFill, onFillConsumed: () => setHistoryFill(null), onRewindRequest: openRewind, onBackgroundRequest: backgroundToAgentView, 
+                                        // The 🏠 at the head of the input row opens the same session screen
+                                        // `/resume` and `/agentview` open — one surface, three doors. It is
+                                        // gated on this prop rather than a setting, so hosts that mount the
+                                        // prompt without a session screen (and the layout regressions that
+                                        // pin the row's column budget) keep the row they had.
+                                        onOpenSessions: () => {
+                                            agentViewOpenSessionRef.current = channel.agentId;
+                                            setSupervisorOpen(true);
+                                        }, backgroundAgentsNeedingInput: 
+                                        // Only the real channel supplies the seam; pre-agent-view test
+                                        // stubs must not grow the footer row (layout-dependent
+                                        // regressions pin the visible row count). The footer only
+                                        // renders while some session actually waits (N > 0): a
+                                        // permanent idle row would steal a transcript row on every
+                                        // real channel — one row is enough to scroll the startup
+                                        // header fully off a short terminal, pausing its viewport
+                                        // clock and shifting every row-count layout invariant.
+                                        channel.agentViewRows !== undefined && backgroundAgentsNeedingInput > 0
+                                            ? backgroundAgentsNeedingInput
+                                            : undefined, controllerRef: promptControllerRef, onCaretImage: handleCaretImage, caretPreviewOpen: peekPreview !== null, onDismissCaretPreview: dismissPeek }, "prompt-input"), _jsx(StatusLine, { channel: channel, activity: workingActivity, selectionActive: selectionActive, helpOpen: helpOpen, 
+                                        // Backend-native permission modes: the footer mode segment always
+                                        // shows (the base mode included) and clicks into the same
+                                        // /permission picker the command opens (the launchpad param row's
+                                        // route). DSH answers an empty list here — no prop, byte-identical
+                                        // rendering.
+                                        backendMode: backendModeStatus, 
+                                        // 模型段/思考档位段：能力位在才可点，点击走既有 /model · /effort
+                                        // 命令（与模式段打开 /permission 完全同构）。
+                                        modelPicker: modelPickerStatus, effortPicker: effortPickerStatus, wake: wakeBand === undefined
+                                            ? undefined
+                                            : {
+                                                band: wakeBand,
+                                                hint: trajectorySeen ? undefined : primaryComboString('trajectory'),
+                                                tick: Math.floor(wakeTime / 120),
+                                                onOpen: openScene,
+                                                hoverHint: primaryComboString('trajectory'),
+                                            } }), dialogOverlayOpen && (_jsx(OverlayAbove, { maxHeight: Math.max(terminalRows - 8, 1), children: pickerPanels }))] })] }), _jsx(TooltipLayer, { invalidationKey: `${overlay.kind}:${dialogOverlayOpen}:${btwOverlayOpen}`, subscribeInvalidation: subscribeTooltipInvalidation })] }), _jsx(PromptEditorLayer, {}), promptEditorOpen && imagePreviewNode, starModal !== null && STAR_MILESTONES[starModal.index] !== undefined && (_jsx(StarPrompt, { milestone: STAR_MILESTONES[starModal.index], actions: starModalActions, onClose: closeStarModal, initialPhase: starModal.phase })), couponVisible && coupon !== null && (_jsx(WhaleCouponPrompt, { notice: coupon, onShown: markCouponShown, onClose: closeCoupon }))] }));
 }
 /**
  * The pinned prompt header shown above the ScrollBox while the user has