@steerable/agent-shell-web 0.6.51 → 0.6.52

package/src/hooks/useProjects.ts

@@ -0,0 +1,82 @@
+/**
+ * 侧栏项目分组和输入框「关联到项目」共用这一份列表。
+ * 任一侧新建、改名或改目录后调用 refresh，其它订阅者一起更新。
+ */
+import { useCallback, useEffect, useSyncExternalStore } from 'react';
+import { isElectron } from '@/lib/electron-bridge';
+import { hostToolChrome } from '@/lib/host-tools';
+import { listProjects, type LocalProject } from '@/lib/local-api';
+
+type ProjectsSnapshot = {
+  projects: LocalProject[];
+  error: string | null;
+};
+
+const EMPTY_SNAPSHOT: ProjectsSnapshot = { projects: [], error: null };
+
+let snapshot: ProjectsSnapshot = EMPTY_SNAPSHOT;
+let requestSeq = 0;
+const listeners = new Set<() => void>();
+
+function emit() {
+  for (const listener of listeners) listener();
+}
+
+export function subscribeProjects(listener: () => void): () => void {
+  listeners.add(listener);
+  return () => {
+    listeners.delete(listener);
+  };
+}
+
+export function getProjectsSnapshot(): ProjectsSnapshot {
+  return snapshot;
+}
+
+/** 重新拉取项目列表并通知所有订阅者。非 Electron 或关掉项目入口时清空。 */
+export async function refreshProjects(): Promise<void> {
+  const seq = ++requestSeq;
+  if (!isElectron() || !hostToolChrome('projects')) {
+    if (snapshot.projects.length > 0 || snapshot.error) {
+      snapshot = EMPTY_SNAPSHOT;
+      emit();
+    }
+    return;
+  }
+  try {
+    const res = await listProjects();
+    if (seq !== requestSeq) return;
+    snapshot = { projects: res.projects ?? [], error: null };
+    emit();
+  } catch (err) {
+    if (seq !== requestSeq) return;
+    const message = err instanceof Error ? err.message : String(err);
+    console.error('获取项目列表失败:', err);
+    snapshot = { projects: snapshot.projects, error: message };
+    emit();
+  }
+}
+
+export function useProjects(): {
+  projects: LocalProject[];
+  error: string | null;
+  refresh: () => Promise<void>;
+} {
+  const current = useSyncExternalStore(
+    subscribeProjects,
+    getProjectsSnapshot,
+    getProjectsSnapshot,
+  );
+  useEffect(() => {
+    void refreshProjects();
+  }, []);
+  const refresh = useCallback(() => refreshProjects(), []);
+  return { projects: current.projects, error: current.error, refresh };
+}
+
+/** 测试隔离：丢掉上一个用例留下的列表，并忽略还在飞的请求。 */
+export function resetProjectsStoreForTests(): void {
+  requestSeq += 1;
+  snapshot = EMPTY_SNAPSHOT;
+  emit();
+}

package/src/lib/electron-bridge.ts

@@ -48,6 +48,7 @@ export interface ApprovalPromptRequest {
   mode: string;
   category: string;
   round: number;
+  /** 发起审批的对话。缺省时卡片不绑定会话（旧请求）。 */
   chatId?: string;
 }
 

package/src/lib/exec-policy.ts

@@ -2,7 +2,7 @@
  * 会话级命令执行沙箱（类 Codex 的 sandbox_mode）。
  *
  * 作用于下一轮 `chat.stream` 的 `execSandbox`，不是 sidecar 进程沙箱
- * （设置页那一层）。工作区 = 只能写入当前项目或本对话工作区；完整权限
+ * （设置页那一层）。工作区 = 只能写入项目家目录、源文件夹（含各自子目录）或本对话工作区；完整权限
  * = 关闭逐条命令沙箱。工具审批（允许/拒绝）仍按原策略生效。
  */
 

package/src/lib/local-api.ts

@@ -387,7 +387,7 @@ export interface LocalProject {
   id: string;
   name: string;
   folderPath: string;
-  /** 附加源文件夹（只读）。缺省空。 */
+  /** 附加源文件夹（可读写，含其子目录）。缺省空。 */
   sourceFolders?: string[];
   /** W6-5: 信任后该项目目录里的规则文件才会注入模型上下文。缺省 false。 */
   trusted?: boolean;

package/src/pages/AgentPage.tsx

@@ -9,6 +9,7 @@ import {
   regenerateChatMessage,
 } from "@/lib/chat-transport";
 import { ChatHeader } from "@/components/ChatHeader";
+import { EmptyChatHero } from "@/components/chat/EmptyChatHero";
 import { LocalChatPanel } from "@/components/chat/LocalChatPanel";
 import { ModelPicker } from "@/components/chat/ModelPicker";
 import {
@@ -51,18 +52,17 @@ import {
 import { ProjectTrustBanner } from "@/components/chat/ProjectTrustBanner";
 import {
   getChatLiveStream,
-  listProjects,
   type ChatLiveStream,
   type LocalChatMessage,
-  type LocalProject,
 } from "@/lib/local-api";
+import { useProjects } from "@/hooks/useProjects";
 import type { AgentOutletContext } from "@/layouts/AgentLayout";
 import {
   setPendingFirstMessage,
   takePendingFirstMessage,
 } from "@/lib/pending-first-message";
 import { isOrchestrationSettingEnabled } from "@/lib/orchestration-settings";
-import { BRAND_NAME, pickDefaultAgentId } from "@/brand";
+import { pickDefaultAgentId } from "@/brand";
 import {
   appendAttachmentRefs,
   collectImageAttachments,
@@ -380,20 +380,8 @@ function AgentChatView({
 
   // 当前会话绑定的项目 — Codex 式 cwd 指示：输入框上方显示项目名徽章，
   // 点击可关联到其他项目 / 修改项目目录 / 移出项目。无项目会话不显示。
-  const [projects, setProjects] = useState<LocalProject[]>([]);
   const showProjectsChrome = hostToolChrome("projects");
-  const fetchProjects = useCallback(async () => {
-    if (!isElectron() || !hostToolChrome("projects")) return;
-    try {
-      const res = await listProjects();
-      setProjects(res.projects ?? []);
-    } catch {
-      /* 列表失败保持旧数据 */
-    }
-  }, []);
-  useEffect(() => {
-    void fetchProjects();
-  }, [fetchProjects]);
+  const { projects, refresh: fetchProjects } = useProjects();
   const chatProject = chat?.projectId
     ? (projects.find((p) => p.id === chat.projectId) ?? null)
     : null;
@@ -695,6 +683,7 @@ function AgentChatView({
     pendingFollowUps,
     removeFollowUp,
     cancel,
+    setMessages,
     appendMessage,
   } = useChatStream({
     transport,
@@ -708,6 +697,15 @@ function AgentChatView({
   // 新 mount 没发起流，所以 isStreaming=false，但后端快照 liveStream.active
   // 为 true —— 此时用快照叠出「正在运行」的助手气泡 + 部分工具卡片/时间线。
   const remoteStreaming = liveStream.active === true && !isStreaming;
+  // 切回运行中的远端回合时，本 mount 没有 useChatStream 的本地队列。显式
+  // 保留 Enter 排队的消息，等远端回合结束后再由本 mount 依次发出。
+  const [remoteFollowUps, setRemoteFollowUps] = useState<string[]>([]);
+  const remoteFollowUpsRef = useRef<string[]>([]);
+  const updateRemoteFollowUps = useCallback((update: (current: string[]) => string[]) => {
+    const next = update(remoteFollowUpsRef.current);
+    remoteFollowUpsRef.current = next;
+    setRemoteFollowUps(next);
+  }, []);
 
   // 远端轮中转向：transport.steer 按 chatId 找活跃流，天然支持「切回后注入」
   // ——不像 useChatStream.steerOrFollowUpUserMessage 那样被本地 isStreamingRef
@@ -725,8 +723,8 @@ function AgentChatView({
         });
         return "steered";
       }
-      // 回合可能恰好已结束——回落 queued 让 ChatInput 给出提示，紧跟着的
-      // re-hydrate 会把最终消息拉出来。
+      // 回合可能恰好已结束——回落 queued，由 handleSteer 放进远端待发
+      // 队列；轮询确认回合结束后先对账历史，再启动下一轮。
       return "queued";
     },
     [transport, appendMessage],
@@ -752,16 +750,9 @@ function AgentChatView({
     };
   }, [chatId, remoteStreaming]);
 
-  // 快照从 active=true → false 的边沿：远端回合结束了，re-hydrate 出最终
-  // 落库消息（含真实 message id / executedActions / timeline）。
+  // 快照从 active=true → false 的边沿在 handleSubmit 声明后处理：没有排队
+  // 消息时重新水合，有排队消息时直接启动下一轮。
   const wasLiveActiveRef = useRef(liveStream.active === true);
-  useEffect(() => {
-    const nowActive = liveStream.active === true;
-    if (wasLiveActiveRef.current && !nowActive) {
-      onBranchTick();
-    }
-    wasLiveActiveRef.current = nowActive;
-  }, [liveStream.active, onBranchTick]);
 
   // W7-1: 中断提示卡的可见性。初值来自 messages 响应的 interrupted 标记；
   // 点击「继续」/「忽略」或用户手动发起新一轮时本地清除（继续成功后后端的
@@ -821,7 +812,8 @@ function AgentChatView({
   const handleCancel = useCallback(() => {
     transport.cancelActive();
     cancel();
-  }, [transport, cancel]);
+    updateRemoteFollowUps(() => []);
+  }, [transport, cancel, updateRemoteFollowUps]);
 
   // Reset the in-flight queue on every new user submit. We do this in a
   // wrapper rather than directly in `handleUnknownEvent`, because there's no
@@ -887,6 +879,48 @@ function AgentChatView({
     [handleSubmit],
   );
 
+  // 远端回合结束时，优先发送用户在等待期间排队的内容。第一条启动新回合，
+  // 其余条目进入 useChatStream 的本地队列；没有排队内容才重新水合历史。
+  useEffect(() => {
+    const nowActive = liveStream.active === true;
+    if (wasLiveActiveRef.current && !nowActive) {
+      const queued = remoteFollowUpsRef.current;
+      if (queued.length > 0) {
+        updateRemoteFollowUps(() => []);
+        void (async () => {
+          try {
+            const response = await getElectronBridge()?.localBackend.request<{
+              messages?: ChatMessageWithMetadata[];
+            }>({
+              method: "GET",
+              path: `/api/v2/chats/${encodeURIComponent(chatId)}/messages?limit=200`,
+            });
+            if (response?.messages) {
+              setMessages(chronological(response.messages));
+            }
+          } catch {
+            // 排队内容仍须发出；后续刷新会补齐刚结束的远端回复。
+          }
+          void handleSubmit({ content: queued[0] });
+          for (const content of queued.slice(1)) {
+            followUpUserMessage({ content });
+          }
+        })();
+      } else {
+        onBranchTick();
+      }
+    }
+    wasLiveActiveRef.current = nowActive;
+  }, [
+    followUpUserMessage,
+    chatId,
+    handleSubmit,
+    liveStream.active,
+    onBranchTick,
+    setMessages,
+    updateRemoteFollowUps,
+  ]);
+
   useEffect(() => {
     const bridge = getElectronBridge();
     if (!bridge?.onSuggestedReplies) return;
@@ -946,28 +980,38 @@ function AgentChatView({
     setInterrupted(false);
   }, []);
 
-  // 轮中转向 + 失败兜底（W6-2）：streaming 期间 Enter 优先注入运行中的
+  // 轮中插队 + 失败兜底（W6-2）：streaming 期间 ⌘/Ctrl+Enter 优先注入运行中的
   // CoreLoop 回合；注入不了时 hook 按回合实况降级——仍在跑则排入待发队列
   // （'queued'，ChatInput 提示"已改为排队"），恰好已结束则作为新回合直发
   // （'sent'）。消息不会丢，ChatInput 对任何结果都清草稿。
   const handleSteer = useCallback(
-    (text: string) =>
-      remoteStreaming ? steerRemote(text) : steerOrFollowUpUserMessage(text),
-    [remoteStreaming, steerRemote, steerOrFollowUpUserMessage],
+    async (text: string) => {
+      if (!remoteStreaming) return steerOrFollowUpUserMessage(text);
+      const outcome = await steerRemote(text);
+      if (outcome === "queued") {
+        updateRemoteFollowUps((current) => [...current, text]);
+      }
+      return outcome;
+    },
+    [
+      remoteStreaming,
+      steerRemote,
+      steerOrFollowUpUserMessage,
+      updateRemoteFollowUps,
+    ],
   );
 
-  // follow-up 排队（W6-2）：streaming 期间 ⌘/Ctrl+Enter 把文本排入待发
-  // 队列，本轮结束后自动作为下一轮发出。与转向（注入当前回合）相对。
-  // 切回后的远端回合没有本地 follow-up 队列可挂，降级为注入当前回合。
+  // follow-up 排队（W6-2）：streaming 期间 Enter 把文本排入待发队列，
+  // 本轮结束后自动作为下一轮发出。与 ⌘/Ctrl+Enter 插队相对。
   const handleFollowUp = useCallback(
     (text: string) => {
       if (remoteStreaming) {
-        void steerRemote(text);
+        updateRemoteFollowUps((current) => [...current, text]);
         return;
       }
       followUpUserMessage({ content: text });
     },
-    [remoteStreaming, steerRemote, followUpUserMessage],
+    [remoteStreaming, followUpUserMessage, updateRemoteFollowUps],
   );
 
   // 首页输入框接力：EmptyChatGate 建好 chat 并跳转后，首条消息暂存在
@@ -1053,6 +1097,10 @@ function AgentChatView({
       }),
     );
     return () => {
+      // 切走不取消回合。正在流式时卸载不要把侧栏指示清掉，侧栏会轮询
+      // live-stream，等回合结束后再摘。本页确认已结束时，下一次 effect
+      // 会带 isStreaming:false。
+      if (effectiveIsStreaming) return;
       window.dispatchEvent(
         new CustomEvent("chat:streaming-change", {
           detail: { chatId, isStreaming: false },
@@ -1087,6 +1135,20 @@ function AgentChatView({
       suggestedReplies.messageId === tailAssistantDbId)
       ? suggestedReplies.suggestions
       : undefined;
+  const visiblePendingFollowUps = [
+    ...pendingFollowUps.map((message) => message.content),
+    ...remoteFollowUps,
+  ];
+  const handleRemovePendingFollowUp = (index: number) => {
+    if (index < pendingFollowUps.length) {
+      removeFollowUp(index);
+      return;
+    }
+    const remoteIndex = index - pendingFollowUps.length;
+    updateRemoteFollowUps((current) =>
+      current.filter((_, itemIndex) => itemIndex !== remoteIndex),
+    );
+  };
 
   return (
     <div className="flex h-full w-full flex-col">
@@ -1103,13 +1165,10 @@ function AgentChatView({
         onCancel={handleCancel}
         onSteer={handleSteer}
         onFollowUp={handleFollowUp}
-        pendingFollowUps={pendingFollowUps.map((m) => m.content)}
-        onRemoveFollowUp={removeFollowUp}
+        pendingFollowUps={visiblePendingFollowUps}
+        onRemoveFollowUp={handleRemovePendingFollowUp}
         className="flex-1"
-        emptyHero={{
-          title: BRAND_NAME,
-          subtitle: '输入消息，直接开始一段新对话。',
-        }}
+        emptyHero
         header={
           <ChatHeader
             chat={chat}
@@ -1171,6 +1230,11 @@ function AgentChatView({
             reasoningEffort={effortOverride}
             onSelectModel={setModelOverride}
             onSelectEffort={setEffortOverride}
+            onOpenSettings={
+              isElectron() && settingsChrome("llm")
+                ? () => setLlmSettingsOpen(true)
+                : undefined
+            }
             disabled={isStreaming}
           />
         }
@@ -1275,7 +1339,6 @@ function EmptyChatGate() {
 
   // 落地页项目选择：还没有 chat 可绑，选中的 projectId 在首次提交
   // createChat 时一并传入。侧栏项目组「+」会带 ?projectId= 预选。
-  const [projects, setProjects] = useState<LocalProject[]>([]);
   const [selectedProjectId, setSelectedProjectId] = useState<string | null>(
     projectIdFromUrl,
   );
@@ -1283,18 +1346,7 @@ function EmptyChatGate() {
     setSelectedProjectId(projectIdFromUrl);
   }, [projectIdFromUrl]);
   const showProjectsChrome = hostToolChrome("projects");
-  const fetchProjects = useCallback(async () => {
-    if (!isElectron() || !hostToolChrome("projects")) return;
-    try {
-      const res = await listProjects();
-      setProjects(res.projects ?? []);
-    } catch {
-      /* 列表失败保持旧数据 */
-    }
-  }, []);
-  useEffect(() => {
-    void fetchProjects();
-  }, [fetchProjects]);
+  const { projects, refresh: fetchProjects } = useProjects();
 
   useEffect(() => {
     inputRef.current?.focusAtEnd();
@@ -1404,14 +1456,7 @@ function EmptyChatGate() {
       data-testid="empty-chat-home"
     >
       <div className="flex w-full max-w-3xl flex-col items-center gap-4">
-        <div className="text-center">
-          <h1 className="text-xl font-semibold tracking-tight text-agent-foreground">
-            {BRAND_NAME}
-          </h1>
-          <p className="mt-1.5 text-xs text-agent-muted-foreground">
-            输入消息，直接开始一段新对话。
-          </p>
-        </div>
+        <EmptyChatHero />
         <div className="w-full">
           <ChatInput
             ref={inputRef}
@@ -1440,6 +1485,11 @@ function EmptyChatGate() {
                 reasoningEffort={effortOverride}
                 onSelectModel={setModelOverride}
                 onSelectEffort={setEffortOverride}
+                onOpenSettings={
+                  isElectron() && settingsChrome("llm")
+                    ? () => setLlmSettingsOpen(true)
+                    : undefined
+                }
                 disabled={!isElectron() || isCreating}
               />
             }

package/src/pages/SettingsPage.tsx

@@ -44,27 +44,71 @@ import { settingsChrome } from '@/lib/host-tools';
 import { isPortableEnabled } from '@/lib/portable';
 import type { AgentOutletContext } from '@/layouts/AgentLayout';
 
-type SettingsSection = 'skills' | 'mcp' | 'agents' | 'general';
+type SettingsSection = 'plugins' | 'general';
+type PluginTab = 'agents' | 'skills' | 'mcp' | 'web-search';
+
+const PLUGIN_TABS: readonly PluginTab[] = ['agents', 'skills', 'mcp', 'web-search'];
+
+const PLUGIN_TAB_META: Record<
+  PluginTab,
+  { label: string; noun: string; Icon: typeof LuBot }
+> = {
+  agents: { label: '智能体', noun: '智能体', Icon: LuBot },
+  skills: { label: 'Skills', noun: '技能', Icon: LuBlocks },
+  mcp: { label: 'MCP', noun: 'MCP 服务', Icon: LuPlug },
+  'web-search': { label: '网络搜索', noun: '网络搜索', Icon: LuSearch },
+};
+
+function isPluginTab(value: string | null): value is PluginTab {
+  return (PLUGIN_TABS as readonly string[]).includes(value ?? '');
+}
+
+function pluginsSummary(tabs: readonly PluginTab[]): string {
+  const nouns = tabs.map((id) => PLUGIN_TAB_META[id].noun);
+  if (nouns.length <= 1) return `管理${nouns[0] ?? '插件'}。`;
+  return `管理${nouns.slice(0, -1).join('、')}和${nouns[nouns.length - 1]}。`;
+}
+
+function enabledPluginTabs(): PluginTab[] {
+  return PLUGIN_TABS.filter((id) => settingsChrome(id));
+}
 
 function resolveSection(raw: string | null): SettingsSection {
-  if (raw === 'skills' && settingsChrome('skills')) return 'skills';
-  if (raw === 'mcp' && settingsChrome('mcp')) return 'mcp';
-  if (raw === 'agents' && settingsChrome('agents')) return 'agents';
+  if (raw === 'plugins') return enabledPluginTabs().length > 0 ? 'plugins' : 'general';
+  if ((raw === 'agents' || raw === 'skills' || raw === 'mcp') && settingsChrome(raw)) {
+    return 'plugins';
+  }
   return 'general';
 }
 
+/** `?section=agents|skills|mcp` 是旧深链，仍打开插件页上对应分类。 */
+function resolvePluginTab(section: string | null, tab: string | null): PluginTab | null {
+  const enabled = enabledPluginTabs();
+  const requested =
+    section === 'agents' || section === 'skills' || section === 'mcp' ? section : tab;
+  if (isPluginTab(requested) && enabled.includes(requested)) {
+    return requested;
+  }
+  return enabled[0] ?? null;
+}
+
 /**
  * `/settings` — 右侧内容区的设置页，按 `?section=` 分成独立页面：
- *   - `skills`  侧栏「Skill 设置」
- *   - `mcp`     侧栏「MCP 设置」
- *   - `agents`  侧栏「智能体管理」
+ *   - `plugins`  侧栏「插件」。顶栏分类切换智能体 / Skills / MCP / 网络搜索
+ *     （`?tab=`，旧的 `?section=agents|skills|mcp` 仍落到对应分类）
  *   - 缺省/`general`  侧栏底「设置」（界面 / 模型 / 搜索 / 用量 / 安全 / 洞察 / 遥测 / 关于）
  *
  * Panel 数据自管理（挂载即拉取），页面本身不持有后端状态。
  */
 export function SettingsPage() {
-  const [searchParams] = useSearchParams();
-  const section = resolveSection(searchParams.get('section'));
+  const [searchParams, setSearchParams] = useSearchParams();
+  const rawSection = searchParams.get('section');
+  const section = resolveSection(rawSection);
+  const pluginTab = section === 'plugins' ? resolvePluginTab(rawSection, searchParams.get('tab')) : null;
+  const pluginTabs = section === 'plugins' ? enabledPluginTabs() : [];
+  const selectPluginTab = useCallback((id: PluginTab) => {
+    setSearchParams({ section: 'plugins', tab: id });
+  }, [setSearchParams]);
   const catalog = useOutletContext<AgentOutletContext | null>();
   const release = useAppRelease();
   const llmPanelRef = useRef<LlmSettingsPanelHandle>(null);
@@ -227,19 +271,46 @@ export function SettingsPage() {
     }
   }, [menuItems]);
 
-  const title =
-    section === 'mcp'
-      ? 'MCP 设置'
-      : section === 'skills'
-        ? 'Skill 设置'
-        : section === 'agents'
-          ? '智能体管理'
-          : '设置';
+  const title = section === 'plugins' ? '插件' : '设置';
 
   return (
     <div ref={pageContainerRef} className="flex h-full w-full flex-col overflow-hidden">
       <header className="flex h-9 flex-shrink-0 items-center justify-between gap-2 border-b border-agent-border px-2.5">
-        <h1 className="text-xs font-semibold text-agent-foreground">{title}</h1>
+        <div className="flex min-w-0 items-center gap-2">
+          <h1 className="shrink-0 text-xs font-semibold text-agent-foreground">{title}</h1>
+          {section === 'plugins' && pluginTabs.length > 1 && (
+            <div
+              role="tablist"
+              aria-label="插件"
+              data-testid="plugins-tabs"
+              className="flex min-w-0 items-center gap-1"
+            >
+              {pluginTabs.map((id) => {
+                const meta = PLUGIN_TAB_META[id];
+                const active = pluginTab === id;
+                return (
+                  <button
+                    key={id}
+                    type="button"
+                    role="tab"
+                    aria-selected={active}
+                    data-testid={`plugins-tab-${id}`}
+                    onClick={() => selectPluginTab(id)}
+                    className={[
+                      'flex h-7 items-center gap-1.5 rounded-full px-2.5 text-xs transition-colors',
+                      active
+                        ? 'bg-agent-foreground/10 font-medium text-agent-foreground'
+                        : 'text-agent-muted-foreground hover:bg-agent-foreground/5 hover:text-agent-foreground',
+                    ].join(' ')}
+                  >
+                    <meta.Icon className="h-3.5 w-3.5" />
+                    {meta.label}
+                  </button>
+                );
+              })}
+            </div>
+          )}
+        </div>
         {section === 'general' && settingsChrome('llm') && (
           <SettingsSaveButton
             testId="settings-header-save"
@@ -276,34 +347,48 @@ export function SettingsPage() {
               </p>
             )}
 
-          {section === 'skills' && (
-            <section className="space-y-2" data-testid="settings-section-skills">
-              <h2 className="flex items-center gap-1.5 text-xs font-semibold text-agent-foreground">
-                <LuBlocks className="h-3.5 w-3.5 text-agent-muted-foreground" />
-                本地技能
-              </h2>
-              <SkillsSettingsPanel />
-            </section>
-          )}
-
-          {section === 'mcp' && (
-            <section className="space-y-2" data-testid="settings-section-mcp">
-              <h2 className="flex items-center gap-1.5 text-xs font-semibold text-agent-foreground">
-                <LuPlug className="h-3.5 w-3.5 text-agent-muted-foreground" />
-                MCP 服务
-              </h2>
-              <McpSettingsPanel />
-            </section>
-          )}
-
-          {section === 'agents' && (
-            <section className="space-y-2" data-testid="settings-section-agents">
-              <h2 className="flex items-center gap-1.5 text-xs font-semibold text-agent-foreground">
-                <LuBot className="h-3.5 w-3.5 text-agent-muted-foreground" />
-                智能体
-              </h2>
-              <AgentsSettingsPanel onCatalogChange={catalog?.refreshAgents} />
-            </section>
+          {section === 'plugins' && (
+            <>
+              <p className="text-xs text-agent-muted-foreground" data-testid="plugins-summary">
+                {pluginsSummary(pluginTabs)}
+              </p>
+              {pluginTab === 'skills' && (
+                <section className="space-y-2" data-testid="settings-section-skills">
+                  <h2 className="flex items-center gap-1.5 text-xs font-semibold text-agent-foreground">
+                    <LuBlocks className="h-3.5 w-3.5 text-agent-muted-foreground" />
+                    本地技能
+                  </h2>
+                  <SkillsSettingsPanel />
+                </section>
+              )}
+              {pluginTab === 'mcp' && (
+                <section className="space-y-2" data-testid="settings-section-mcp">
+                  <h2 className="flex items-center gap-1.5 text-xs font-semibold text-agent-foreground">
+                    <LuPlug className="h-3.5 w-3.5 text-agent-muted-foreground" />
+                    MCP 服务
+                  </h2>
+                  <McpSettingsPanel />
+                </section>
+              )}
+              {pluginTab === 'agents' && (
+                <section className="space-y-2" data-testid="settings-section-agents">
+                  <h2 className="flex items-center gap-1.5 text-xs font-semibold text-agent-foreground">
+                    <LuBot className="h-3.5 w-3.5 text-agent-muted-foreground" />
+                    智能体
+                  </h2>
+                  <AgentsSettingsPanel onCatalogChange={catalog?.refreshAgents} />
+                </section>
+              )}
+              {pluginTab === 'web-search' && settingsChrome('web-search') && (
+                <section className="space-y-2" data-testid="settings-section-web-search">
+                  <h2 className="flex items-center gap-1.5 text-xs font-semibold text-agent-foreground">
+                    <LuSearch className="h-3.5 w-3.5 text-agent-muted-foreground" />
+                    网络搜索
+                  </h2>
+                  <WebSearchSettingsPanel />
+                </section>
+              )}
+            </>
           )}
 
           {section === 'general' && (

package/src/vite-env.d.ts

@@ -5,6 +5,8 @@ interface ImportMetaEnv {
   readonly VITE_BRAND_NAME?: string;
   readonly VITE_BRAND_TITLE?: string;
   readonly VITE_BRAND_TAGLINE?: string;
+  /** 新对话落地页副文案。空字符串表示不显示。 */
+  readonly VITE_BRAND_HOME_HINT?: string;
   readonly VITE_DEFAULT_AGENT_ID?: string;
   readonly VITE_HOST_TOOLS?: string;
   readonly VITE_APPROVAL?: string;

package/vite.base.js

@@ -52,6 +52,7 @@ export function createProductViteConfig(options) {
             'import.meta.env.VITE_BRAND_NAME': JSON.stringify(brand?.displayName ?? 'Steerable Shell'),
             'import.meta.env.VITE_BRAND_TITLE': JSON.stringify(brand?.title ?? ''),
             'import.meta.env.VITE_BRAND_TAGLINE': JSON.stringify(brand?.tagline ?? '一款本地桌面 AI 伙伴'),
+            'import.meta.env.VITE_BRAND_HOME_HINT': JSON.stringify(brand?.homeHint ?? '输入消息，直接开始一段新对话。'),
             'import.meta.env.VITE_DEFAULT_AGENT_ID': JSON.stringify(brand?.defaultAgentId ?? 'local-assistant'),
             // 宿主工具族 / 安全询问：与 node 侧 setProductConfig 读同一份 product.json。
             'import.meta.env.VITE_HOST_TOOLS': JSON.stringify(JSON.stringify(product.hostTools ?? {})),