@steerable/agent-shell-web 0.6.51 → 0.6.52

package/src/components/ConfirmDialog.tsx

@@ -0,0 +1,90 @@
+/**
+ * 破坏性操作的二次确认弹窗。点遮罩或按 Esc 取消；确认进行中不关闭。
+ */
+import { useEffect, useId } from 'react';
+import { createPortal } from 'react-dom';
+
+export interface ConfirmDialogProps {
+  open: boolean;
+  title: string;
+  description: string;
+  confirmLabel?: string;
+  pending?: boolean;
+  onCancel: () => void;
+  onConfirm: () => void;
+  testId?: string;
+}
+
+export function ConfirmDialog({
+  open,
+  title,
+  description,
+  confirmLabel = '删除',
+  pending = false,
+  onCancel,
+  onConfirm,
+  testId = 'confirm-dialog',
+}: ConfirmDialogProps) {
+  const titleId = useId();
+  const descriptionId = useId();
+
+  useEffect(() => {
+    if (!open) return;
+    const onKey = (event: KeyboardEvent) => {
+      if (event.key !== 'Escape' || pending) return;
+      onCancel();
+    };
+    window.addEventListener('keydown', onKey);
+    return () => window.removeEventListener('keydown', onKey);
+  }, [open, pending, onCancel]);
+
+  if (!open || typeof document === 'undefined') return null;
+
+  return createPortal(
+    <div
+      className="fixed inset-0 z-[110] flex items-center justify-center bg-black/50 p-4 backdrop-blur-sm"
+      onMouseDown={(event) => {
+        if (event.target === event.currentTarget && !pending) onCancel();
+      }}
+      role="alertdialog"
+      aria-modal="true"
+      aria-labelledby={titleId}
+      aria-describedby={descriptionId}
+      data-testid={testId}
+    >
+      <div className="w-[380px] max-w-[92vw] rounded-2xl border border-agent-border bg-agent-canvas p-5 shadow-2xl">
+        <h2 id={titleId} className="text-base font-semibold text-agent-foreground">
+          {title}
+        </h2>
+        <p
+          id={descriptionId}
+          className="mt-2 text-sm leading-relaxed text-agent-muted-foreground"
+        >
+          {description}
+        </p>
+        <div className="mt-5 flex justify-end gap-2">
+          <button
+            type="button"
+            onClick={onCancel}
+            disabled={pending}
+            autoFocus
+            className="h-9 rounded-full px-4 text-sm text-agent-muted-foreground transition-colors hover:bg-agent-muted hover:text-agent-foreground disabled:opacity-40"
+            data-testid={`${testId}-cancel`}
+          >
+            取消
+          </button>
+          <button
+            type="button"
+            onClick={onConfirm}
+            disabled={pending}
+            className="h-9 rounded-full bg-agent-destructive px-4 text-sm font-medium text-white transition-opacity hover:opacity-90 disabled:opacity-40"
+            data-testid={`${testId}-confirm`}
+          >
+            {pending ? '删除中…' : confirmLabel}
+          </button>
+        </div>
+      </div>
+    </div>,
+    document.body,
+  );
+}

package/src/components/CreateProjectModal.tsx

@@ -1,11 +1,12 @@
 /**
  * 新建 / 编辑项目弹窗（Codex 式）：项目是带名字的容器，可附加多个源文件夹。
- * 家目录由后端建在 Documents/<应用名>/<项目名>/；源文件夹只放宽读取。
+ * 家目录由后端建在 Documents/<应用名>/<项目名>/；源文件夹及其子目录也可读写。
  */
 import { useEffect, useState } from 'react';
 import { createPortal } from 'react-dom';
 import { LuFolder, LuFolderPlus, LuX } from 'react-icons/lu';
 import { BRAND_NAME } from '@/brand';
+import { ConfirmDialog } from '@/components/ConfirmDialog';
 import { getElectronBridge } from '@/lib/electron-bridge';
 
 export interface ProjectFormValues {
@@ -36,7 +37,7 @@ export function CreateProjectModal({
   const [folderDraft, setFolderDraft] = useState('');
   const [submitting, setSubmitting] = useState(false);
   const [deleting, setDeleting] = useState(false);
-  const [confirmDelete, setConfirmDelete] = useState(false);
+  const [deleteConfirmOpen, setDeleteConfirmOpen] = useState(false);
   const [error, setError] = useState<string | null>(null);
   const initialFoldersKey = (initial?.sourceFolders ?? []).join('\0');
 
@@ -47,14 +48,18 @@ export function CreateProjectModal({
     setFolderDraft('');
     setSubmitting(false);
     setDeleting(false);
-    setConfirmDelete(false);
+    setDeleteConfirmOpen(false);
     setError(null);
+  }, [open, initial?.name, initialFoldersKey]);
+
+  useEffect(() => {
+    if (!open || deleteConfirmOpen) return;
     const onKey = (event: KeyboardEvent) => {
       if (event.key === 'Escape') onClose();
     };
     window.addEventListener('keydown', onKey);
     return () => window.removeEventListener('keydown', onKey);
-  }, [open, onClose, initial?.name, initialFoldersKey]);
+  }, [open, onClose, deleteConfirmOpen]);
 
   if (!open) return null;
   if (typeof document === 'undefined') return null;
@@ -106,10 +111,6 @@ export function CreateProjectModal({
 
   const handleDelete = async () => {
     if (!onDelete || deleting || submitting) return;
-    if (!confirmDelete) {
-      setConfirmDelete(true);
-      return;
-    }
     setDeleting(true);
     setError(null);
     try {
@@ -118,6 +119,7 @@ export function CreateProjectModal({
     } catch (err) {
       setError(err instanceof Error ? err.message : String(err));
       setDeleting(false);
+      setDeleteConfirmOpen(false);
     }
   };
 
@@ -170,7 +172,10 @@ export function CreateProjectModal({
           )}
 
           <div>
-            <div className="mb-2 text-sm text-agent-foreground">源文件夹</div>
+            <div className="mb-1 text-sm text-agent-foreground">源文件夹</div>
+            <p className="mb-2 text-[11px] text-agent-muted-foreground">
+              这些目录及其子目录可读写。
+            </p>
             <div className="overflow-hidden rounded-2xl border border-agent-border">
               {sourceFolders.map((folder) => (
                 <div
@@ -232,17 +237,13 @@ export function CreateProjectModal({
           {onDelete && (
             <button
               type="button"
-              onClick={() => void handleDelete()}
+              onClick={() => setDeleteConfirmOpen(true)}
               disabled={deleting || submitting}
-              title={
-                confirmDelete
-                  ? '再次点击确认删除（会话会保留为无项目对话）'
-                  : '删除项目（会话保留为无项目对话）'
-              }
+              title="删除项目（会话保留为无项目对话）"
               className="mr-auto h-9 rounded-full px-3 text-sm text-agent-destructive transition-colors hover:bg-agent-destructive/10 disabled:opacity-40"
               data-testid="edit-project-delete"
             >
-              {confirmDelete ? '再次点击确认删除' : '删除本地项目'}
+              删除本地项目
             </button>
           )}
           <button
@@ -265,6 +266,21 @@ export function CreateProjectModal({
           </button>
         </div>
       </div>
+      {onDelete && (
+        <ConfirmDialog
+          open={deleteConfirmOpen}
+          title="删除项目"
+          description={`确定删除项目「${trimmed || '未命名'}」？会话会保留为无项目对话。`}
+          confirmLabel="删除项目"
+          pending={deleting}
+          onCancel={() => {
+            if (deleting) return;
+            setDeleteConfirmOpen(false);
+          }}
+          onConfirm={() => void handleDelete()}
+          testId="edit-project-delete-dialog"
+        />
+      )}
     </div>,
     document.body,
   );

package/src/components/chat/ApprovalModal.tsx

@@ -158,8 +158,7 @@ export function ApprovalPromptMenu({
             </p>
           ) : isSandboxEscalation ? (
             <p className="mt-2 text-[11px] leading-relaxed text-agent-muted-foreground">
-              命令已在工作区沙箱中尝试，但被系统拒绝。允许后会仅重试这条原始命令，
-              不再限制它只能写入当前项目或本对话工作区。
+              命令已在工作区沙箱中被拒绝。允许后只重试这条命令，不再限制写入范围。
             </p>
           ) : (
             <>
@@ -169,9 +168,7 @@ export function ApprovalPromptMenu({
                 </p>
               )}
               <p className="mt-2 text-[11px] leading-relaxed text-agent-muted-foreground">
-                默认在工作区沙箱中执行（只能写入当前项目或本对话工作区）。写入
-                Downloads 等工作区外路径会被系统拒绝；需要时在输入框把沙箱切到「完整权限」后再让
-                Agent 重试。
+                在工作区沙箱中执行，范围外的写入会被拒绝。需要写到外面时，把沙箱切到「完整权限」后再试。
               </p>
             </>
           )}

package/src/components/chat/ApprovalPromptProvider.tsx

@@ -13,9 +13,14 @@ import {
   type ApprovalDecisionKind,
   type ApprovalPromptRequest,
 } from '@/lib/electron-bridge';
+import { bindPromptToActiveChat, promptVisibleInChat } from './prompt-chat-scope';
 
 interface ApprovalPromptContextValue {
   queue: ApprovalPromptRequest[];
+  decide: (requestId: string, kind: ApprovalDecisionKind) => void;
+}
+
+interface ApprovalPromptView {
   current: ApprovalPromptRequest | null;
   pendingCount: number;
   decide: (kind: ApprovalDecisionKind) => void;
@@ -23,7 +28,10 @@ interface ApprovalPromptContextValue {
 
 const ApprovalPromptContext = createContext<ApprovalPromptContextValue | null>(null);
 
-/** Keeps approval prompts alive while the active composer presents them. */
+/**
+ * Keeps approval prompts alive across chat navigation. Each composer
+ * presents only the prompt that belongs to its chat.
+ */
 export function ApprovalPromptProvider({ children }: { children: ReactNode }) {
   const [queue, setQueue] = useState<ApprovalPromptRequest[]>([]);
   const decidedRequestIds = useRef(new Set<string>());
@@ -38,10 +46,12 @@ export function ApprovalPromptProvider({ children }: { children: ReactNode }) {
     ) => {
       setQueue((previous) => {
         const known = new Set(previous.map(({ requestId }) => requestId));
-        const additions = requests.filter(
-          ({ requestId }) =>
-            !known.has(requestId) && !decidedRequestIds.current.has(requestId),
-        );
+        const additions = requests
+          .filter(
+            ({ requestId }) =>
+              !known.has(requestId) && !decidedRequestIds.current.has(requestId),
+          )
+          .map(bindPromptToActiveChat);
         if (additions.length === 0) return previous;
         return placement === 'prepend'
           ? [...additions, ...previous]
@@ -65,26 +75,19 @@ export function ApprovalPromptProvider({ children }: { children: ReactNode }) {
     };
   }, []);
 
-  const current = queue[0] ?? null;
-  const decide = useCallback(
-    (kind: ApprovalDecisionKind) => {
-      if (!current) return;
-      const bridge = getElectronBridge();
-      decidedRequestIds.current.add(current.requestId);
-      setQueue((previous) => previous.slice(1));
-      void bridge?.approval?.decide({ requestId: current.requestId, kind });
-    },
-    [current],
-  );
+  const decide = useCallback((requestId: string, kind: ApprovalDecisionKind) => {
+    const bridge = getElectronBridge();
+    decidedRequestIds.current.add(requestId);
+    setQueue((previous) => previous.filter((request) => request.requestId !== requestId));
+    void bridge?.approval?.decide({ requestId, kind });
+  }, []);
 
   const value = useMemo(
     () => ({
       queue,
-      current,
-      pendingCount: Math.max(0, queue.length - 1),
       decide,
     }),
-    [queue, current, decide],
+    [decide, queue],
   );
 
   return (
@@ -94,9 +97,22 @@ export function ApprovalPromptProvider({ children }: { children: ReactNode }) {
   );
 }
 
-/** Returns the approval prompt currently assigned to the chat composer. */
-export function useApprovalPrompt(): ApprovalPromptContextValue | null {
-  return useContext(ApprovalPromptContext);
+/** Returns the approval prompt for this composer’s chat, if one is waiting. */
+export function useApprovalPrompt(chatId?: string | null): ApprovalPromptView | null {
+  const context = useContext(ApprovalPromptContext);
+  return useMemo(() => {
+    if (!context) return null;
+    const mine = context.queue.filter((request) => promptVisibleInChat(request, chatId));
+    const current = mine[0] ?? null;
+    return {
+      current,
+      pendingCount: Math.max(0, mine.length - 1),
+      decide: (kind) => {
+        if (!current) return;
+        context.decide(current.requestId, kind);
+      },
+    };
+  }, [chatId, context]);
 }
 
 /** 返回存在未处理工具权限审批的会话 ID 集合。 */

package/src/components/chat/AskUserPromptProvider.tsx

@@ -9,6 +9,7 @@ import {
   type ReactNode,
 } from 'react';
 import { getElectronBridge, type AskUserPromptRequest } from '@/lib/electron-bridge';
+import { bindPromptToActiveChat, promptVisibleInChat } from './prompt-chat-scope';
 
 type AnswerValue = string | string[];
 
@@ -23,38 +24,6 @@ interface AskUserPromptView {
   answer: (answers: Record<string, AnswerValue>) => void;
 }
 
-/**
- * Chat id from `#/agent/:chatId` (hash router) or `/agent/:chatId`.
- * The running server build drops `chatId` on the ask-user payload.
- */
-function chatIdFromLocation(location: { pathname: string; hash: string }): string | null {
-  const hashed = location.hash.startsWith('#') ? location.hash.slice(1) : '';
-  const raw = hashed || location.pathname;
-  const match = raw.match(/\/agent\/([^/?#]+)/);
-  if (!match?.[1]) return null;
-  try {
-    return decodeURIComponent(match[1]);
-  } catch {
-    return match[1];
-  }
-}
-
-function bindPromptToActiveChat(request: AskUserPromptRequest): AskUserPromptRequest {
-  if (request.chatId) return request;
-  const chatId = chatIdFromLocation(window.location);
-  if (!chatId) return request;
-  return { ...request, chatId };
-}
-
-/** A prompt with a chat id belongs only to that chat. A prompt without one stays visible so an older request is still answerable. */
-function promptVisibleInChat(
-  request: AskUserPromptRequest,
-  chatId: string | null | undefined,
-): boolean {
-  if (!request.chatId) return !chatId;
-  return request.chatId === chatId;
-}
-
 const AskUserPromptContext = createContext<AskUserPromptContextValue | null>(null);
 
 /**

package/src/components/chat/ChatInput.tsx

@@ -19,7 +19,6 @@ import {
   LuArrowUp,
   LuBot,
   LuChevronDown,
-  LuSettings,
   LuSquare,
   LuBlocks,
   LuPlug,
@@ -61,7 +60,7 @@ export type { ExecPolicy, McpToolItem, SkillItem };
  *     product's `chat-input-box`).
  *   - Auto-growing rich text input (1 → 8 lines) that grows as the user types.
  *   - `Enter` to send, `Shift+Enter` for newline (`Cmd/Ctrl+Enter` also sends;
- *     IME composition is guarded so confirming a candidate never submits).
+ *     while streaming, Enter queues and Cmd/Ctrl+Enter steers the current turn).
  *   - Send button on the right; turns into a Stop button when streaming.
  *   - Externally-controlled value (`LocalChatPanel` lifts it so EmptyChat can
  *     inject prompts via `setAndFocusInputMessage`).
@@ -107,15 +106,15 @@ export interface ChatInputProps {
   onSubmit: () => void | Promise<void>;
   onCancel?: () => void;
   /**
-   * 轮中转向（streaming 期间 Enter）：优先把文本注入运行中的回合；注入
+   * 轮中插队（streaming 期间 ⌘/Ctrl+Enter）：优先把文本注入运行中的回合；注入
    * 失败由 hook 兜底——回合仍在跑则排入 W6-2 follow-up 队列（'queued'，
    * 本组件提示"已改为排队"），回合恰好已结束则作为新消息直接发出
    * （'sent'）。三种结果消息都已落地，调用方据此清空草稿。
    */
   onSteer?: (text: string) => Promise<SteerOutcome>;
   /**
-   * W6-2 follow-up 队列：streaming 期间按 ⌘/Ctrl+Enter 把当前文本排入
-   * 待发队列，本轮结束后自动作为下一轮发出（与 Enter 的轮中转向相对）。
+   * W6-2 follow-up 队列：streaming 期间按 Enter 把当前文本排入待发队列，
+   * 本轮结束后自动作为下一轮发出（与 ⌘/Ctrl+Enter 的轮中插队相对）。
    */
   onFollowUp?: (text: string) => void;
   /** 当前排队待发的 follow-up 文本（用于在输入框上方展示待发队列）。 */
@@ -788,7 +787,7 @@ export const ChatInput = forwardRef<ChatInputHandle, ChatInputProps>(
       chats = [],
       selectedAgentId,
       onSelectAgent,
-      onOpenSettings,
+      onOpenSettings: _onOpenSettings,
       toolbarExtras,
       leadingChrome,
       trailingChrome,
@@ -806,7 +805,7 @@ export const ChatInput = forwardRef<ChatInputHandle, ChatInputProps>(
     ref,
   ) {
     const askUserPrompt = useAskUserPrompt(chatId);
-    const approvalPrompt = useApprovalPrompt();
+    const approvalPrompt = useApprovalPrompt(chatId);
     const editorRef = useRef<HTMLDivElement>(null);
     const agentMenuRef = useRef<HTMLDivElement>(null);
     const skillOptionRefs = useRef<Array<HTMLButtonElement | null>>([]);
@@ -863,7 +862,7 @@ export const ChatInput = forwardRef<ChatInputHandle, ChatInputProps>(
     const [mentionQuery, setMentionQuery] = useState<MentionQuery | null>(null);
     const [selectedMentionIndex, setSelectedMentionIndex] = useState(0);
     const [mentionReferences, setMentionReferences] = useState<MentionReference[]>([]);
-    // 转向降级提示：Enter 转向失败被兜底进 W6-2 队列时告知用户"不是注入"，
+    // 插队降级提示：⌘/Ctrl+Enter 插队失败被兜底进 W6-2 队列时告知用户，
     // 几秒后自动消失（队列横幅本身常驻，提示只是动作反馈）。
     const [steerNotice, setSteerNotice] = useState<string | null>(null);
     const steerNoticeTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);
@@ -1145,15 +1144,17 @@ export const ChatInput = forwardRef<ChatInputHandle, ChatInputProps>(
       }
     }, [value, mentionReferences, agents, chats, disabled, skills, mcpTools]);
 
-    // `Cmd+.` / `Ctrl+.` cancels the in-flight stream — matches macOS's
-    // conventional "interrupt" chord (Xcode, Terminal). Bound at the window
-    // level so users can hit it without the textarea being focused.
+    // Escape stops the current turn, matching Codex's graphical composer.
+    // Cmd/Ctrl+. remains as a compatibility alias. Bound at the window level
+    // so users can stop without the editor being focused.
     // Confined to the `isStreaming` window so it never fights with other
     // app-level shortcuts when the chat is idle.
     useEffect(() => {
       if (!isStreaming || !onCancel) return;
       const onKey = (event: globalThis.KeyboardEvent) => {
-        if ((event.metaKey || event.ctrlKey) && event.key === '.') {
+        const isStopAlias = (event.metaKey || event.ctrlKey) && event.key === '.';
+        const isEscape = event.key === 'Escape' && !event.metaKey && !event.ctrlKey && !event.altKey;
+        if (!event.defaultPrevented && (isStopAlias || isEscape)) {
           event.preventDefault();
           onCancel();
         }
@@ -1497,11 +1498,14 @@ export const ChatInput = forwardRef<ChatInputHandle, ChatInputProps>(
         requestHostPaste(event.currentTarget);
         return;
       }
-      // Honor IME composition (`isComposing` true while Chinese input is mid-
-      // selection) — only intercept on plain key events. Enter is exempt
-      // because WKWebView reports it with isComposing/keyCode 229 even after
-      // the candidate is committed.
-      if (event.key !== 'Enter' && (isComposingRef.current || event.nativeEvent.isComposing)) return;
+      // An open composition session owns the keystroke, including Enter used
+      // to confirm the highlighted candidate. Returning without
+      // preventDefault lets the IME commit the word. WKWebView can report
+      // isComposing / keyCode 229 on Enter after the session has already
+      // ended; that case is not an open session (`isComposingRef` is false)
+      // and must still send.
+      if (isComposingRef.current) return;
+      if (event.key !== 'Enter' && event.nativeEvent.isComposing) return;
 
       if (event.key === 'Backspace' || event.key === 'Delete') {
         const editor = editorRef.current;
@@ -1588,31 +1592,31 @@ export const ChatInput = forwardRef<ChatInputHandle, ChatInputProps>(
         }
       }
 
-      // Enter 发送，Shift+Enter 换行（⌘/Ctrl+Enter 作为老习惯保留，同样发送）。
+      // 空闲时 Enter / ⌘/Ctrl+Enter 发送，Shift+Enter 换行。
       // IME 候选确认的 Enter 已被上面的 composition 守卫拦截，不会误发送。
       const isSendCombo =
         event.key === 'Enter' && !event.shiftKey;
       if (isSendCombo) {
         event.preventDefault();
-        // streaming 期间：Enter = 轮中转向（注入运行中的回合；注入不了时
-        // hook 兜底为 W6-2 排队或新回合直发，消息不会丢）；⌘/Ctrl+Enter =
-        // follow-up 排队（本轮结束后自动作为下一轮发出）。
+        // streaming 期间：Enter = follow-up 排队（本轮结束后自动作为下一轮
+        // 发出）；⌘/Ctrl+Enter = 轮中插队（注入运行中的回合；注入不了时
+        // hook 兜底为 W6-2 排队或新回合直发，消息不会丢）。
         if (isStreaming) {
-          if ((event.metaKey || event.ctrlKey) && onFollowUp && trimmed) {
-            onFollowUp(trimmed);
-            onChange('');
-            return;
-          }
-          if (onSteer && trimmed) {
+          if ((event.metaKey || event.ctrlKey) && onSteer && trimmed) {
             void onSteer(trimmed).then((outcome) => {
               // steered / queued / sent 三种结果消息都已落地（注入当前回合 /
               // 进入待发队列 / 作为新回合发出），草稿都可以清；queued 额外
               // 提示用户"不是追加进当前回合"。
               if (outcome === 'queued') {
-                showSteerNotice('当前回合无法追加，已加入排队，本轮结束后自动发出');
+                showSteerNotice('当前回合无法插队，已改为排队，本轮结束后自动发出');
               }
               onChange('');
             });
+            return;
+          }
+          if (onFollowUp && trimmed) {
+            onFollowUp(trimmed);
+            onChange('');
           }
           return;
         }
@@ -1705,7 +1709,7 @@ export const ChatInput = forwardRef<ChatInputHandle, ChatInputProps>(
       <div className="chat-input-container @container relative px-2.5 pb-2.5 pt-1">
         {(leadingChrome || selectedAgent || trailingChrome) && (
           <div
-            className="relative mb-1.5 flex min-w-0 items-center gap-1.5"
+            className="relative mb-1.5 flex min-w-0 items-end gap-1.5"
             data-testid="composer-meta-row"
           >
             {leadingChrome}
@@ -1872,7 +1876,7 @@ export const ChatInput = forwardRef<ChatInputHandle, ChatInputProps>(
           {pendingFollowUps.length > 0 && (
             <div className="flex flex-col gap-1 border-b border-agent-border bg-agent-muted/30 px-2.5 py-1.5">
               <div className="text-[11px] font-medium text-agent-muted-foreground">
-                排队中（{pendingFollowUps.length}）· 本轮结束后自动发出 · 停止将丢弃
+                排队中（{pendingFollowUps.length}）· 本轮结束后自动发出 · 停止后恢复到输入框
               </div>
               {pendingFollowUps.map((text, i) => (
                 <div
@@ -1993,18 +1997,6 @@ export const ChatInput = forwardRef<ChatInputHandle, ChatInputProps>(
               />
                 </>
               )}
-              {onOpenSettings && (
-                <button
-                  type="button"
-                  onClick={onOpenSettings}
-                  className="flex h-6 w-6 shrink-0 items-center justify-center rounded-full text-agent-muted-foreground transition-colors hover:bg-agent-foreground/5 hover:text-agent-foreground"
-                  title="LLM 设置"
-                  aria-label="LLM 设置"
-                  data-testid="chat-llm-settings"
-                >
-                  <LuSettings className="h-3 w-3" />
-                </button>
-              )}
             </div>
             {/* shrink-0：发送键是固定尺寸圆钮，窄容器下不允许被压扁；
                 收缩量由左侧可截断的选择器吸收。 */}
@@ -2016,23 +2008,15 @@ export const ChatInput = forwardRef<ChatInputHandle, ChatInputProps>(
               >
                 {isStreaming ? (
                   <>
-                    <kbd className="rounded border border-agent-border bg-agent-muted px-1 font-sans text-[10px]">
-                      {MOD_KEY_LABEL}
-                    </kbd>
-                    <span className="mx-0.5">+</span>
-                    <kbd className="rounded border border-agent-border bg-agent-muted px-1 font-sans text-[10px]">
-                      .
-                    </kbd>
-                    <span className="ml-1">停止</span>
-                    {onSteer && (
+                    {onFollowUp && (
                       <span className="ml-2">
                         <kbd className="rounded border border-agent-border bg-agent-muted px-1 font-sans text-[10px]">
                           Enter
                         </kbd>
-                        <span className="ml-1">追加</span>
+                        <span className="ml-1">排队</span>
                       </span>
                     )}
-                    {onFollowUp && (
+                    {onSteer && (
                       <span className="ml-2">
                         <kbd className="rounded border border-agent-border bg-agent-muted px-1 font-sans text-[10px]">
                           {MOD_KEY_LABEL}
@@ -2041,9 +2025,15 @@ export const ChatInput = forwardRef<ChatInputHandle, ChatInputProps>(
                         <kbd className="rounded border border-agent-border bg-agent-muted px-1 font-sans text-[10px]">
                           Enter
                         </kbd>
-                        <span className="ml-1">排队</span>
+                        <span className="ml-1">插队</span>
                       </span>
                     )}
+                    <span className="ml-2">
+                      <kbd className="rounded border border-agent-border bg-agent-muted px-1 font-sans text-[10px]">
+                        Esc
+                      </kbd>
+                      <span className="ml-1">停止</span>
+                    </span>
                   </>
                 ) : (
                   <>
@@ -2079,8 +2069,8 @@ export const ChatInput = forwardRef<ChatInputHandle, ChatInputProps>(
                 title={
                   isStreaming
                     ? pendingFollowUps.length > 0
-                      ? `停止生成 (${MOD_KEY_LABEL}+.) · 将丢弃 ${pendingFollowUps.length} 条排队消息`
-                      : `停止生成 (${MOD_KEY_LABEL}+.)`
+                      ? `停止生成 (Esc) · ${pendingFollowUps.length} 条排队消息将恢复到输入框`
+                      : '停止生成 (Esc)'
                     : '发送 (Enter)'
                 }
                 aria-label={isStreaming ? '停止生成' : '发送消息'}
@@ -2291,7 +2281,7 @@ function AgentSelect({
             data-testid="agent-manage"
             onClick={() => {
               onOpenChange(false);
-              navigate('/settings?section=agents');
+              navigate('/settings?section=plugins&tab=agents');
             }}
             className="mt-0.5 flex w-full items-center gap-2 rounded border-t border-agent-border/50 px-2 py-2 text-left text-agent-muted-foreground transition-colors hover:bg-agent-foreground/5 hover:text-agent-foreground"
           >

package/src/components/chat/ChatProjectBadge.tsx

@@ -241,7 +241,7 @@ export function ChatProjectBadge({
         title={
           project
             ? `${project.folderPath}\n点击管理项目归属 / 修改绑定目录`
-            : '把当前对话关联到一个项目（Agent 的文件操作将限制在项目目录内）'
+            : '把当前对话关联到一个项目（文件写入限制在项目家目录、源文件夹，以及这些目录的子目录内）'
         }
       />
 

package/src/components/chat/EmptyChatHero.tsx

@@ -0,0 +1,22 @@
+import { BRAND_HOME_HINT, BRAND_NAME, getBrandLogoUrl } from '@/brand';
+
+/**
+ * 新对话落地页与空会话首屏的品牌区：侧栏同一枚 logo，加一句
+ * 产品可配的副文案（brand.homeHint）。
+ */
+export function EmptyChatHero() {
+  const hint = BRAND_HOME_HINT.trim();
+  return (
+    <div className="text-center">
+      <h1>
+        <img
+          src={getBrandLogoUrl()}
+          alt={BRAND_NAME}
+          className="mx-auto h-12 w-auto max-w-[12rem] select-none object-contain"
+          draggable={false}
+        />
+      </h1>
+      {hint ? <p className="mt-1.5 text-xs text-agent-muted-foreground">{hint}</p> : null}
+    </div>
+  );
+}