@steerable/agent-shell-web 0.6.30 → 0.6.31

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@steerable/agent-shell-web",
-  "version": "0.6.30",
+  "version": "0.6.31",
   "type": "module",
   "description": "Steerable framework — product-neutral renderer SPA source for @steerable/agent-shell (React + Vite). Consumed by product web entry points via the `@/` alias (anchored at this package's src/) and the createProductViteConfig factory. Published as a source package (src/), plus the compiled vite.base config factory (vite.base.js + .d.ts) for Node-side config loading.",
   "license": "Apache-2.0",
@@ -46,8 +46,8 @@
     "react-router-dom": "^6.30.0",
     "rehype-raw": "^7.0.0",
     "remark-gfm": "^4.0.1",
-    "@steerable/agent-ui": "0.6.30",
-    "@steerable/agent-protocol": "0.6.30"
+    "@steerable/agent-protocol": "0.6.31",
+    "@steerable/agent-ui": "0.6.31"
   },
   "devDependencies": {
     "@tailwindcss/vite": "^4.3.0",
@@ -60,7 +60,7 @@
     "typescript": "^5.8.3",
     "vite": "^5.4.21",
     "vitest": "^3.2.4",
-    "@steerable/pack-sdk": "0.6.30"
+    "@steerable/pack-sdk": "0.6.31"
   },
   "scripts": {
     "gen": "echo agent-shell-web",

package/public/favicon.svg

@@ -0,0 +1,14 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 48 48" fill="none">
+  <circle cx="24" cy="24" r="17" stroke="#5c6bc0" stroke-width="3.5"/>
+  <circle cx="24" cy="24" r="5" fill="#5c6bc0"/>
+  <g stroke="#5c6bc0" stroke-width="3.5" stroke-linecap="round">
+    <line x1="24" y1="2.5" x2="24" y2="12"/>
+    <line x1="24" y1="36" x2="24" y2="45.5"/>
+    <line x1="2.5" y1="24" x2="12" y2="24"/>
+    <line x1="36" y1="24" x2="45.5" y2="24"/>
+    <line x1="8.8" y1="8.8" x2="15.5" y2="15.5"/>
+    <line x1="32.5" y1="32.5" x2="39.2" y2="39.2"/>
+    <line x1="39.2" y1="8.8" x2="32.5" y2="15.5"/>
+    <line x1="15.5" y1="32.5" x2="8.8" y2="39.2"/>
+  </g>
+</svg>

package/src/assets/logo-steerable.svg

@@ -0,0 +1,14 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 48 48" fill="none">
+  <circle cx="24" cy="24" r="17" stroke="#5c6bc0" stroke-width="3.5"/>
+  <circle cx="24" cy="24" r="5" fill="#5c6bc0"/>
+  <g stroke="#5c6bc0" stroke-width="3.5" stroke-linecap="round">
+    <line x1="24" y1="2.5" x2="24" y2="12"/>
+    <line x1="24" y1="36" x2="24" y2="45.5"/>
+    <line x1="2.5" y1="24" x2="12" y2="24"/>
+    <line x1="36" y1="24" x2="45.5" y2="24"/>
+    <line x1="8.8" y1="8.8" x2="15.5" y2="15.5"/>
+    <line x1="32.5" y1="32.5" x2="39.2" y2="39.2"/>
+    <line x1="39.2" y1="8.8" x2="32.5" y2="15.5"/>
+    <line x1="15.5" y1="32.5" x2="8.8" y2="39.2"/>
+  </g>
+</svg>

package/src/brand.ts

@@ -3,10 +3,10 @@
  * （VITE_BRAND_* define：product.json brand 优先，其次激活包 pack.json
  * brand，3.1）；logo 资产由激活包的 web 模块在注册时经
  * setBrandLogoUrl() 注入（资产静态 import 在包内，只进本产品 bundle）。
- * 未注入时一律回落到 shell 中性默认（Steerable Shell / generic logo）。
+ * 未注入时一律回落到 shell 默认（Steerable Shell / 舵轮标）。
  * 主进程侧对应物见 src/brand.ts。
  */
-import shellLogoUrl from '@/assets/logo-generic.png';
+import shellLogoUrl from '@/assets/logo-steerable.svg';
 
 /** 当前构建的 flavor（开放字符串，0.3g 起不再是二值联合）。 */
 export const APP_FLAVOR: string = import.meta.env.VITE_APP_FLAVOR ?? 'generic';
@@ -23,7 +23,7 @@ export const BRAND_NAME: string = import.meta.env.VITE_BRAND_NAME ?? 'Steerable
 export const BRAND_TITLE: string =
   import.meta.env.VITE_BRAND_TITLE ?? import.meta.env.VITE_BRAND_NAME ?? 'Steerable Shell';
 
-/** shell 默认 logo（中性通用图标）；包品牌 logo 由包 web 模块注册覆盖。 */
+/** shell 默认 logo（Steerable 舵轮标）；包品牌 logo 由包 web 模块注册覆盖。 */
 let brandLogoUrl: string = shellLogoUrl;
 
 /**

package/src/components/AgentSidebar.tsx

@@ -63,7 +63,7 @@
  *   │ ⬡ 智能体管理                     │ ← /settings?section=agents（独立页）
  *   │ ⬡ Skill 设置                    │ ← /settings?section=skills（独立页）
  *   │ 🔌 MCP 设置                     │ ← /settings?section=mcp（独立页）
- *   │  v 会话 · 12                📁+ │ ← 📁+ 新建项目
+ *   │  会话 v                     📁+ │ ← 📁+ 打开新建项目弹窗
  *   │  v 📁 项目A · 3      (hover: +✏📂🗑)│ ← 项目组：折叠/新建/重命名/换文件夹/删
  *   │   ...（项目内对话）              │
  *   │   今天                          │
@@ -73,19 +73,12 @@
  *   │ ⚙ 设置                          │ ← /settings（模型 + 洞察/遥测/用量/搜索/安全）
  *   └─────────────────────────────────┘
  *
- * 项目模式：项目 = 名字 + 绑定文件夹（ProjectRegistry，electron-store）。
- * 项目内对话的 agent 文件读写与命令执行被硬沙箱在该文件夹内（见
- * tool-router.ts ToolExecContext.projectRoot）；无项目对话不沙箱。
+ * 项目模式：项目 = 名字 + 托管家目录（Documents/<应用名>/<项目名>/）+
+ * 可选源文件夹。写入/命令围栏在家目录；源文件夹只放宽读取。
  */
 
-import {
-  useCallback,
-  useEffect,
-  useMemo,
-  useRef,
-  useState,
-} from 'react';
-import { useLocation, useNavigate, useParams } from 'react-router-dom';
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { useLocation, useNavigate, useParams } from "react-router-dom";
 import {
   LuChevronDown,
   LuChevronUp,
@@ -104,10 +97,10 @@ import {
   LuFolderPlus,
   LuPencil,
   LuPlug,
-} from 'react-icons/lu';
-import { parseChatTitle } from '@/lib/chat-title';
-import { getDateGroupLabel, getDateGroupPriority } from '@/lib/date-groups';
-import { getElectronBridge, isElectron } from '@/lib/electron-bridge';
+} from "react-icons/lu";
+import { parseChatTitle } from "@/lib/chat-title";
+import { getDateGroupLabel, getDateGroupPriority } from "@/lib/date-groups";
+import { getElectronBridge, isElectron } from "@/lib/electron-bridge";
 import {
   createProject,
   deleteProject,
@@ -116,17 +109,18 @@ import {
   type LocalChat,
   type LocalChatAgent,
   type LocalProject,
-} from '@/lib/local-api';
-import type { UseChatsAndAgentsResult } from '@/hooks/useChatsAndAgents';
-import type { PackChatSlotContribution } from '@/packs/registry';
-import type { RightPanelState } from '@/layouts/AgentLayout';
-import { BrandLockup } from '@/components/BrandLockup';
+} from "@/lib/local-api";
+import type { UseChatsAndAgentsResult } from "@/hooks/useChatsAndAgents";
+import type { PackChatSlotContribution } from "@/packs/registry";
+import type { RightPanelState } from "@/layouts/AgentLayout";
+import { BrandLockup } from "@/components/BrandLockup";
+import { CreateProjectModal } from "@/components/CreateProjectModal";
 
-const DEFAULT_DOT_COLOR = '#7c3aed';
+const DEFAULT_DOT_COLOR = "#7c3aed";
 
 function agentInitial(agent: LocalChatAgent | null): string {
-  const name = (agent?.name || '').trim();
-  return name ? name[0].toUpperCase() : 'A';
+  const name = (agent?.name || "").trim();
+  return name ? name[0].toUpperCase() : "A";
 }
 
 function AgentDot({
@@ -170,17 +164,17 @@ export function AgentSidebar({
   const location = useLocation();
   const { chatId: currentChatId } = useParams<{ chatId?: string }>();
   const bridge = getElectronBridge();
-  const onSettingsPage = location.pathname === '/settings';
+  const onSettingsPage = location.pathname === "/settings";
   // /settings?section=skills|mcp|agents|（缺省 = 综合设置）—— 各自高亮。
   const settingsSection = useMemo(
-    () => new URLSearchParams(location.search).get('section'),
+    () => new URLSearchParams(location.search).get("section"),
     [location.search],
   );
   const onGeneralSettings =
     onSettingsPage &&
-    settingsSection !== 'skills' &&
-    settingsSection !== 'mcp' &&
-    settingsSection !== 'agents';
+    settingsSection !== "skills" &&
+    settingsSection !== "mcp" &&
+    settingsSection !== "agents";
   const onNewChatHome = !currentChatId && !onSettingsPage;
 
   const {
@@ -198,7 +192,7 @@ export function AgentSidebar({
   const [isMac, setIsMac] = useState(false);
 
   useEffect(() => {
-    if (typeof navigator !== 'undefined') {
+    if (typeof navigator !== "undefined") {
       setIsMac(/Mac|iPod|iPhone|iPad/.test(navigator.platform));
     }
   }, []);
@@ -217,11 +211,18 @@ export function AgentSidebar({
   const [collapsedProjectIds, setCollapsedProjectIds] = useState<Set<string>>(
     () => new Set(),
   );
-  const [renamingProjectId, setRenamingProjectId] = useState<string | null>(null);
-  const [renamingValue, setRenamingValue] = useState('');
-  const [confirmDeleteProjectId, setConfirmDeleteProjectId] = useState<string | null>(null);
-  const [deletingProjectId, setDeletingProjectId] = useState<string | null>(null);
+  const [renamingProjectId, setRenamingProjectId] = useState<string | null>(
+    null,
+  );
+  const [renamingValue, setRenamingValue] = useState("");
+  const [confirmDeleteProjectId, setConfirmDeleteProjectId] = useState<
+    string | null
+  >(null);
+  const [deletingProjectId, setDeletingProjectId] = useState<string | null>(
+    null,
+  );
   const [projectError, setProjectError] = useState<string | null>(null);
+  const [createProjectOpen, setCreateProjectOpen] = useState(false);
 
   const fetchProjects = useCallback(async () => {
     if (!isElectron()) return;
@@ -229,7 +230,7 @@ export function AgentSidebar({
       const res = await listProjects();
       setProjects(res.projects || []);
     } catch (err) {
-      console.error('获取项目列表失败:', err);
+      console.error("获取项目列表失败:", err);
       setProjectError(err instanceof Error ? err.message : String(err));
     }
   }, []);
@@ -238,24 +239,25 @@ export function AgentSidebar({
     void fetchProjects();
   }, [fetchProjects]);
 
-  const handleCreateProject = useCallback(async () => {
-    if (!isElectron()) return;
-    setProjectError(null);
-    try {
-      const result = await bridge?.local?.selectDirectory({
-        title: '选择项目文件夹',
-      });
-      if (!result || result.canceled || result.filePaths.length === 0) return;
-      const folderPath = result.filePaths[0];
-      // 默认用文件夹名做项目名，用户可随后内联重命名。
-      const baseName =
-        folderPath.replace(/[\\/]+$/, '').split(/[\\/]/).pop() || '新项目';
-      await createProject({ name: baseName, folderPath });
-      await fetchProjects();
-    } catch (err) {
-      setProjectError(err instanceof Error ? err.message : String(err));
-    }
-  }, [bridge, fetchProjects]);
+  const handleCreateProject = useCallback(
+    async (input: { name: string; sourceFolders: string[] }) => {
+      setProjectError(null);
+      try {
+        await createProject({
+          name: input.name,
+          ...(input.sourceFolders.length > 0
+            ? { sourceFolders: input.sourceFolders }
+            : {}),
+        });
+        await fetchProjects();
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        setProjectError(message);
+        throw err instanceof Error ? err : new Error(message);
+      }
+    },
+    [fetchProjects],
+  );
 
   const handleRenameProject = useCallback(
     async (projectId: string) => {
@@ -278,7 +280,7 @@ export function AgentSidebar({
       setProjectError(null);
       try {
         const result = await bridge?.local?.selectDirectory({
-          title: '重新选择项目文件夹',
+          title: "重新选择项目文件夹",
         });
         if (!result || result.canceled || result.filePaths.length === 0) return;
         await updateProject(projectId, { folderPath: result.filePaths[0] });
@@ -350,7 +352,7 @@ export function AgentSidebar({
         navigate(`/agent?projectId=${encodeURIComponent(projectId)}`);
         return;
       }
-      navigate('/agent');
+      navigate("/agent");
     },
     [navigate],
   );
@@ -369,7 +371,7 @@ export function AgentSidebar({
         const { displayTitle, isAutomation } = parseChatTitle(chat.title);
         return {
           id: chat.id,
-          title: displayTitle || '新会话',
+          title: displayTitle || "新会话",
           isAutomation,
           isPinned: chat.isPinned,
           sortDate,
@@ -420,7 +422,7 @@ export function AgentSidebar({
     // 分组，「5 天前置顶的会话」会排在「今天」的普通会话之后，置顶语义
     // 就只剩组内有效——与用户点图钉时的预期不符。
     noProjectChats.forEach((chat) => {
-      const label = chat.isPinned ? '置顶' : getDateGroupLabel(chat.sortDate);
+      const label = chat.isPinned ? "置顶" : getDateGroupLabel(chat.sortDate);
       if (!map.has(label)) {
         map.set(label, {
           label,
@@ -448,7 +450,7 @@ export function AgentSidebar({
         const ok = await deleteChat(id);
         if (ok) {
           setConfirmDeleteChatId(null);
-          if (id === currentChatId) navigate('/agent');
+          if (id === currentChatId) navigate("/agent");
         }
       } finally {
         setDeletingChatId(null);
@@ -477,22 +479,17 @@ export function AgentSidebar({
             navigate(`/agent/${chat.id}`);
           }}
           className={[
-            'flex h-7 w-full min-w-0 items-center gap-1.5 rounded-full px-2.5 text-xs transition-colors duration-200',
+            "flex h-7 w-full min-w-0 items-center gap-1.5 rounded-full px-2.5 text-xs transition-colors duration-200",
             isCurrent
-              ? 'bg-agent-foreground/10 font-medium text-agent-foreground'
-              : 'text-agent-muted-foreground hover:bg-agent-foreground/5 hover:text-agent-foreground',
-          ].join(' ')}
+              ? "bg-agent-foreground/10 font-medium text-agent-foreground"
+              : "text-agent-muted-foreground hover:bg-agent-foreground/5 hover:text-agent-foreground",
+          ].join(" ")}
           title={
-            chat.isAutomation
-              ? `[由自动化触发] ${chat.title}`
-              : chat.title
+            chat.isAutomation ? `[由自动化触发] ${chat.title}` : chat.title
           }
         >
           {chat.isPinned && (
-            <span
-              className="shrink-0 text-[10px]"
-              aria-label="已置顶"
-            >
+            <span className="shrink-0 text-[10px]" aria-label="已置顶">
               📌
             </span>
           )}
@@ -503,9 +500,7 @@ export function AgentSidebar({
             />
           )}
           <AgentDot agent={chatAgent} size={16} />
-          <span className="min-w-0 truncate leading-none">
-            {chat.title}
-          </span>
+          <span className="min-w-0 truncate leading-none">{chat.title}</span>
         </button>
         {/* Gradient mask so the trash button doesn't paint
             over the chat title — fade matches the row's
@@ -514,15 +509,15 @@ export function AgentSidebar({
         <div
           aria-hidden="true"
           className={[
-            'pointer-events-none absolute inset-y-0 right-0 w-12 rounded-r-full transition-opacity duration-200',
+            "pointer-events-none absolute inset-y-0 right-0 w-12 rounded-r-full transition-opacity duration-200",
             isConfirmingDelete
               ? isCurrent
-                ? 'bg-gradient-to-l from-agent-canvas via-agent-canvas/95 to-transparent opacity-100'
-                : 'bg-gradient-to-l from-agent-muted via-agent-muted/95 to-transparent opacity-100'
+                ? "bg-gradient-to-l from-agent-canvas via-agent-canvas/95 to-transparent opacity-100"
+                : "bg-gradient-to-l from-agent-muted via-agent-muted/95 to-transparent opacity-100"
               : isCurrent
-                ? 'bg-gradient-to-l from-agent-canvas via-agent-canvas/95 to-transparent opacity-0 group-hover/item:opacity-100'
-                : 'bg-gradient-to-l from-agent-muted via-agent-muted/95 to-transparent opacity-0 group-hover/item:opacity-100',
-          ].join(' ')}
+                ? "bg-gradient-to-l from-agent-canvas via-agent-canvas/95 to-transparent opacity-0 group-hover/item:opacity-100"
+                : "bg-gradient-to-l from-agent-muted via-agent-muted/95 to-transparent opacity-0 group-hover/item:opacity-100",
+          ].join(" ")}
         />
         <button
           type="button"
@@ -532,29 +527,20 @@ export function AgentSidebar({
           }}
           disabled={isDeleting}
           className={[
-            'absolute right-1 top-1/2 flex h-7 w-7 -translate-y-1/2 items-center justify-center rounded-full transition-all duration-200',
-            isConfirmingDelete
-              ? 'bg-agent-destructive/10 text-agent-destructive opacity-100 hover:bg-agent-destructive/20'
-              : 'text-agent-muted-foreground opacity-0 hover:bg-agent-foreground/5 hover:text-agent-destructive group-hover/item:opacity-100 focus:opacity-100',
-            'disabled:cursor-not-allowed disabled:opacity-100',
-          ].join(' ')}
-          title={
-            isConfirmingDelete
-              ? '再次点击确认删除'
-              : '删除会话'
-          }
-          aria-label={
+            "absolute right-1 top-1/2 flex h-7 w-7 -translate-y-1/2 items-center justify-center rounded-full transition-all duration-200",
             isConfirmingDelete
-              ? '再次点击确认删除'
-              : '删除会话'
-          }
+              ? "bg-agent-destructive/10 text-agent-destructive opacity-100 hover:bg-agent-destructive/20"
+              : "text-agent-muted-foreground opacity-0 hover:bg-agent-foreground/5 hover:text-agent-destructive group-hover/item:opacity-100 focus:opacity-100",
+            "disabled:cursor-not-allowed disabled:opacity-100",
+          ].join(" ")}
+          title={isConfirmingDelete ? "再次点击确认删除" : "删除会话"}
+          aria-label={isConfirmingDelete ? "再次点击确认删除" : "删除会话"}
           data-testid="sidebar-chat-delete"
         >
           <LuTrash2
-            className={[
-              'h-3.5 w-3.5',
-              isDeleting ? 'animate-pulse' : '',
-            ].join(' ')}
+            className={["h-3.5 w-3.5", isDeleting ? "animate-pulse" : ""].join(
+              " ",
+            )}
           />
         </button>
       </div>
@@ -587,10 +573,10 @@ export function AgentSidebar({
         container.scrollHeight - 60;
       if (nearBottom) void loadMoreChats();
     };
-    container.addEventListener('scroll', maybeLoadMore, { passive: true });
+    container.addEventListener("scroll", maybeLoadMore, { passive: true });
     const tickId = window.requestAnimationFrame(maybeLoadMore);
     return () => {
-      container.removeEventListener('scroll', maybeLoadMore);
+      container.removeEventListener("scroll", maybeLoadMore);
       window.cancelAnimationFrame(tickId);
     };
   }, [
@@ -608,7 +594,7 @@ export function AgentSidebar({
   useEffect(() => {
     if (!bridge?.onMenuOpenTerminal) return;
     bridge.onMenuOpenTerminal(() => {
-      onToggleRightPanel('terminal');
+      onToggleRightPanel("terminal");
     });
     return () => {
       bridge.offMenuOpenTerminal?.();
@@ -620,7 +606,7 @@ export function AgentSidebar({
   return (
     <div className="flex h-full w-full flex-col border-r border-agent-border/60 bg-agent-muted/70 backdrop-blur-md">
       {/* ───── Brand + actions ───── */}
-      <div className="flex h-9 flex-shrink-0 items-center justify-between px-2.5">
+      <div className="flex h-11 flex-shrink-0 items-center justify-between px-2.5">
         <BrandLockup onClick={() => handleOpenNewChat()} />
         <div className="flex items-center gap-1">
           <button
@@ -643,11 +629,11 @@ export function AgentSidebar({
             type="button"
             onClick={() => handleOpenNewChat()}
             className={[
-              'flex h-7 w-full items-center gap-1.5 rounded-full px-2.5 text-xs transition-colors',
+              "flex h-7 w-full items-center gap-1.5 rounded-full px-2.5 text-xs transition-colors",
               onNewChatHome
-                ? 'bg-agent-foreground/10 font-medium text-agent-foreground'
-                : 'text-agent-muted-foreground hover:bg-agent-foreground/5 hover:text-agent-foreground',
-            ].join(' ')}
+                ? "bg-agent-foreground/10 font-medium text-agent-foreground"
+                : "text-agent-muted-foreground hover:bg-agent-foreground/5 hover:text-agent-foreground",
+            ].join(" ")}
             title="新建对话"
             data-testid="sidebar-new-chat"
           >
@@ -656,13 +642,13 @@ export function AgentSidebar({
           </button>
           <button
             type="button"
-            onClick={() => navigate('/settings?section=agents')}
+            onClick={() => navigate("/settings?section=agents")}
             className={[
-              'flex h-7 w-full items-center gap-1.5 rounded-full px-2.5 text-xs transition-colors',
-              onSettingsPage && settingsSection === 'agents'
-                ? 'bg-agent-foreground/10 font-medium text-agent-foreground'
-                : 'text-agent-muted-foreground hover:bg-agent-foreground/5 hover:text-agent-foreground',
-            ].join(' ')}
+              "flex h-7 w-full items-center gap-1.5 rounded-full px-2.5 text-xs transition-colors",
+              onSettingsPage && settingsSection === "agents"
+                ? "bg-agent-foreground/10 font-medium text-agent-foreground"
+                : "text-agent-muted-foreground hover:bg-agent-foreground/5 hover:text-agent-foreground",
+            ].join(" ")}
             title="智能体管理"
             data-testid="sidebar-agent-settings"
           >
@@ -671,13 +657,13 @@ export function AgentSidebar({
           </button>
           <button
             type="button"
-            onClick={() => navigate('/settings?section=skills')}
+            onClick={() => navigate("/settings?section=skills")}
             className={[
-              'flex h-7 w-full items-center gap-1.5 rounded-full px-2.5 text-xs transition-colors',
-              onSettingsPage && settingsSection === 'skills'
-                ? 'bg-agent-foreground/10 font-medium text-agent-foreground'
-                : 'text-agent-muted-foreground hover:bg-agent-foreground/5 hover:text-agent-foreground',
-            ].join(' ')}
+              "flex h-7 w-full items-center gap-1.5 rounded-full px-2.5 text-xs transition-colors",
+              onSettingsPage && settingsSection === "skills"
+                ? "bg-agent-foreground/10 font-medium text-agent-foreground"
+                : "text-agent-muted-foreground hover:bg-agent-foreground/5 hover:text-agent-foreground",
+            ].join(" ")}
             title="Skill 设置"
             data-testid="sidebar-skill-settings"
           >
@@ -686,13 +672,13 @@ export function AgentSidebar({
           </button>
           <button
             type="button"
-            onClick={() => navigate('/settings?section=mcp')}
+            onClick={() => navigate("/settings?section=mcp")}
             className={[
-              'flex h-7 w-full items-center gap-1.5 rounded-full px-2.5 text-xs transition-colors',
-              onSettingsPage && settingsSection === 'mcp'
-                ? 'bg-agent-foreground/10 font-medium text-agent-foreground'
-                : 'text-agent-muted-foreground hover:bg-agent-foreground/5 hover:text-agent-foreground',
-            ].join(' ')}
+              "flex h-7 w-full items-center gap-1.5 rounded-full px-2.5 text-xs transition-colors",
+              onSettingsPage && settingsSection === "mcp"
+                ? "bg-agent-foreground/10 font-medium text-agent-foreground"
+                : "text-agent-muted-foreground hover:bg-agent-foreground/5 hover:text-agent-foreground",
+            ].join(" ")}
             title="MCP 设置"
             data-testid="sidebar-mcp-settings"
           >
@@ -706,28 +692,22 @@ export function AgentSidebar({
             onClick={() => setChatsExpanded((v) => !v)}
             className="flex h-6 items-center rounded-full px-2.5 text-xs font-semibold tracking-wider text-agent-muted-foreground transition-colors hover:bg-agent-foreground/5 hover:text-agent-foreground"
           >
-            <span className="mr-1">
+            会话
+            <span className="ml-1">
               {chatsExpanded ? (
                 <LuChevronUp className="h-3 w-3" />
               ) : (
                 <LuChevronDown className="h-3 w-3" />
               )}
             </span>
-            会话
-            {normalizedChats.length > 0 && (
-              <span className="ml-1.5 text-[10px] font-normal text-agent-muted-foreground/70">
-                · {normalizedChats.length}
-              </span>
-            )}
           </button>
           <div className="flex items-center gap-1">
-            {/* 新建项目：选文件夹 → 以文件夹名建项目，之后可在组头重命名 */}
             {hasElectron && (
               <button
                 type="button"
-                onClick={() => void handleCreateProject()}
+                onClick={() => setCreateProjectOpen(true)}
                 className="flex h-6 w-6 items-center justify-center rounded-full text-agent-muted-foreground transition-colors duration-200 hover:bg-agent-foreground/5 hover:text-agent-foreground"
-                title="新建项目（绑定文件夹，项目内对话的文件操作被限制在该文件夹）"
+                title="新建项目"
                 aria-label="新建项目"
               >
                 <LuFolderPlus className="h-3.5 w-3.5" />
@@ -768,10 +748,13 @@ export function AgentSidebar({
                           <input
                             autoFocus
                             value={renamingValue}
-                            onChange={(event) => setRenamingValue(event.target.value)}
+                            onChange={(event) =>
+                              setRenamingValue(event.target.value)
+                            }
                             onBlur={() => void handleRenameProject(project.id)}
                             onKeyDown={(event) => {
-                              if (event.key === 'Escape') setRenamingProjectId(null);
+                              if (event.key === "Escape")
+                                setRenamingProjectId(null);
                             }}
                             className="h-6 w-full rounded-agent-md border border-agent-border bg-agent-canvas px-2 text-xs text-agent-foreground focus:outline-none focus:ring-2 focus:ring-agent-foreground/30"
                           />
@@ -824,7 +807,9 @@ export function AgentSidebar({
                             </button>
                             <button
                               type="button"
-                              onClick={() => void handleChangeProjectFolder(project.id)}
+                              onClick={() =>
+                                void handleChangeProjectFolder(project.id)
+                              }
                               className="flex h-5 w-5 items-center justify-center rounded-full text-agent-muted-foreground hover:bg-agent-foreground/10 hover:text-agent-foreground"
                               title="更换绑定文件夹"
                             >
@@ -832,21 +817,23 @@ export function AgentSidebar({
                             </button>
                             <button
                               type="button"
-                              onClick={() => void handleDeleteProject(project.id)}
+                              onClick={() =>
+                                void handleDeleteProject(project.id)
+                              }
                               disabled={deletingProjectId === project.id}
                               className={`flex h-5 w-5 items-center justify-center rounded-full transition-colors ${
                                 confirmDeleteProjectId === project.id
-                                  ? 'bg-agent-destructive/10 text-agent-destructive hover:bg-agent-destructive/20'
-                                  : 'text-agent-muted-foreground hover:bg-agent-foreground/10 hover:text-agent-destructive'
+                                  ? "bg-agent-destructive/10 text-agent-destructive hover:bg-agent-destructive/20"
+                                  : "text-agent-muted-foreground hover:bg-agent-foreground/10 hover:text-agent-destructive"
                               }`}
                               title={
                                 confirmDeleteProjectId === project.id
-                                  ? '再次点击确认删除（会话会保留为无项目对话）'
-                                  : '删除项目（会话保留为无项目对话）'
+                                  ? "再次点击确认删除（会话会保留为无项目对话）"
+                                  : "删除项目（会话保留为无项目对话）"
                               }
                             >
                               <LuTrash2
-                                className={`h-3 w-3 ${deletingProjectId === project.id ? 'animate-pulse' : ''}`}
+                                className={`h-3 w-3 ${deletingProjectId === project.id ? "animate-pulse" : ""}`}
                               />
                             </button>
                           </div>
@@ -887,7 +874,7 @@ export function AgentSidebar({
                     加载更多...
                   </span>
                 ) : hasMoreChats ? (
-                  '继续下滑加载更多'
+                  "继续下滑加载更多"
                 ) : (
                   `共 ${normalizedChats.length} 个会话`
                 )}
@@ -911,20 +898,20 @@ export function AgentSidebar({
         {chatSlots.length === 0 ? (
           <button
             type="button"
-            onClick={() => onToggleRightPanel('terminal')}
+            onClick={() => onToggleRightPanel("terminal")}
             className={[
-              'flex h-7 w-full items-center gap-1.5 rounded-full px-2.5 text-xs transition-colors',
-              rightPanel === 'terminal'
-                ? 'bg-agent-foreground/10 font-medium text-agent-foreground'
-                : 'text-agent-muted-foreground hover:bg-agent-foreground/5 hover:text-foreground',
-            ].join(' ')}
-            title={`${rightPanel === 'terminal' ? '关闭' : '打开'}终端面板 (${isMac ? '⌘T' : 'Ctrl+T'})`}
+              "flex h-7 w-full items-center gap-1.5 rounded-full px-2.5 text-xs transition-colors",
+              rightPanel === "terminal"
+                ? "bg-agent-foreground/10 font-medium text-agent-foreground"
+                : "text-agent-muted-foreground hover:bg-agent-foreground/5 hover:text-foreground",
+            ].join(" ")}
+            title={`${rightPanel === "terminal" ? "关闭" : "打开"}终端面板 (${isMac ? "⌘T" : "Ctrl+T"})`}
             data-testid="sidebar-terminal"
           >
             <LuTerminal className="h-3.5 w-3.5" />
             <span>终端</span>
             <span className="ml-auto text-[10px] text-agent-muted-foreground/70">
-              {isMac ? '⌘T' : 'Ctrl+T'}
+              {isMac ? "⌘T" : "Ctrl+T"}
             </span>
           </button>
         ) : (
@@ -935,14 +922,14 @@ export function AgentSidebar({
           >
             <button
               type="button"
-              onClick={() => onToggleRightPanel('terminal')}
+              onClick={() => onToggleRightPanel("terminal")}
               className={[
-                'flex h-7 flex-1 items-center justify-center gap-1.5 rounded-full text-xs font-medium transition-colors',
-                rightPanel === 'terminal'
-                  ? 'bg-agent-foreground/10 text-agent-foreground'
-                  : 'text-agent-muted-foreground hover:bg-agent-foreground/5 hover:text-agent-foreground',
-              ].join(' ')}
-              title={`${rightPanel === 'terminal' ? '关闭' : '打开'}终端面板`}
+                "flex h-7 flex-1 items-center justify-center gap-1.5 rounded-full text-xs font-medium transition-colors",
+                rightPanel === "terminal"
+                  ? "bg-agent-foreground/10 text-agent-foreground"
+                  : "text-agent-muted-foreground hover:bg-agent-foreground/5 hover:text-agent-foreground",
+              ].join(" ")}
+              title={`${rightPanel === "terminal" ? "关闭" : "打开"}终端面板`}
               data-testid="sidebar-terminal"
             >
               <LuTerminal className="h-3.5 w-3.5" />
@@ -954,12 +941,12 @@ export function AgentSidebar({
                 type="button"
                 onClick={() => onToggleRightPanel(slot.slotId)}
                 className={[
-                  'flex h-7 flex-1 items-center justify-center gap-1.5 rounded-full text-xs font-medium transition-colors',
+                  "flex h-7 flex-1 items-center justify-center gap-1.5 rounded-full text-xs font-medium transition-colors",
                   rightPanel === slot.slotId
-                    ? 'bg-agent-foreground/10 text-agent-foreground'
-                    : 'text-agent-muted-foreground hover:bg-agent-foreground/5 hover:text-agent-foreground',
-                ].join(' ')}
-                title={`${rightPanel === slot.slotId ? '关闭' : '打开'}${slot.title}`}
+                    ? "bg-agent-foreground/10 text-agent-foreground"
+                    : "text-agent-muted-foreground hover:bg-agent-foreground/5 hover:text-agent-foreground",
+                ].join(" ")}
+                title={`${rightPanel === slot.slotId ? "关闭" : "打开"}${slot.title}`}
                 data-testid={`sidebar-slot-${slot.slotId}`}
               >
                 <slot.Icon className="h-3.5 w-3.5" />
@@ -970,13 +957,13 @@ export function AgentSidebar({
         )}
         <button
           type="button"
-          onClick={() => navigate('/settings')}
+          onClick={() => navigate("/settings")}
           className={[
-            'mt-0.5 flex h-7 w-full items-center gap-1.5 rounded-full px-2.5 text-xs transition-colors',
+            "mt-0.5 flex h-7 w-full items-center gap-1.5 rounded-full px-2.5 text-xs transition-colors",
             onGeneralSettings
-              ? 'bg-agent-foreground/10 font-medium text-agent-foreground'
-              : 'text-agent-muted-foreground hover:bg-agent-foreground/5 hover:text-agent-foreground',
-          ].join(' ')}
+              ? "bg-agent-foreground/10 font-medium text-agent-foreground"
+              : "text-agent-muted-foreground hover:bg-agent-foreground/5 hover:text-agent-foreground",
+          ].join(" ")}
           title="设置"
           data-testid="sidebar-llm-settings"
         >
@@ -984,6 +971,12 @@ export function AgentSidebar({
           <span>设置</span>
         </button>
       </div>
+
+      <CreateProjectModal
+        open={createProjectOpen}
+        onClose={() => setCreateProjectOpen(false)}
+        onCreate={handleCreateProject}
+      />
     </div>
   );
 }

package/src/components/BrandLockup.tsx

@@ -30,7 +30,7 @@ export function BrandLockup({ className, onClick }: BrandLockupProps = {}) {
         draggable={false}
       />
       {title ? (
-        <span className="truncate text-xs font-semibold tracking-tight text-agent-foreground leading-none">
+        <span className="truncate text-sm font-semibold tracking-tight text-agent-foreground leading-none">
           {title}
         </span>
       ) : null}

package/src/components/CreateProjectModal.tsx

@@ -0,0 +1,182 @@
+/**
+ * 新建项目弹窗（Codex 式）：项目是带名字的容器，不是「选中的那个文件夹」。
+ * 家目录由后端建在 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 { getElectronBridge, isElectron } from '@/lib/electron-bridge';
+
+export interface CreateProjectModalProps {
+  open: boolean;
+  onClose: () => void;
+  onCreate: (input: { name: string; sourceFolders: string[] }) => Promise<void>;
+}
+
+export function CreateProjectModal({ open, onClose, onCreate }: CreateProjectModalProps) {
+  const [name, setName] = useState('');
+  const [sourceFolders, setSourceFolders] = useState<string[]>([]);
+  const [submitting, setSubmitting] = useState(false);
+  const [error, setError] = useState<string | null>(null);
+
+  useEffect(() => {
+    if (!open) return;
+    setName('');
+    setSourceFolders([]);
+    setSubmitting(false);
+    setError(null);
+    const onKey = (event: KeyboardEvent) => {
+      if (event.key === 'Escape') onClose();
+    };
+    window.addEventListener('keydown', onKey);
+    return () => window.removeEventListener('keydown', onKey);
+  }, [open, onClose]);
+
+  if (!open) return null;
+  if (typeof document === 'undefined') return null;
+
+  const trimmed = name.trim();
+  const homePreview = `~/Documents/${BRAND_NAME}/${trimmed || '项目名'}`;
+
+  const handleAddFolder = async () => {
+    if (!isElectron()) return;
+    const result = await getElectronBridge()?.local?.selectDirectory({
+      title: '添加源文件夹',
+    });
+    if (!result || result.canceled || result.filePaths.length === 0) return;
+    const next = result.filePaths[0];
+    setSourceFolders((prev) => (prev.includes(next) ? prev : [...prev, next]));
+  };
+
+  const handleSubmit = async () => {
+    if (!trimmed || submitting) return;
+    setSubmitting(true);
+    setError(null);
+    try {
+      await onCreate({ name: trimmed, sourceFolders });
+      onClose();
+    } catch (err) {
+      setError(err instanceof Error ? err.message : String(err));
+      setSubmitting(false);
+    }
+  };
+
+  return createPortal(
+    <div
+      className="fixed inset-0 z-[100] flex items-center justify-center bg-black/50 backdrop-blur-sm"
+      onMouseDown={(event) => {
+        if (event.target === event.currentTarget) onClose();
+      }}
+      role="dialog"
+      aria-modal="true"
+      aria-labelledby="create-project-title"
+      data-testid="create-project-dialog"
+    >
+      <div className="flex w-[440px] max-w-[92vw] flex-col overflow-hidden rounded-2xl border border-agent-border bg-agent-canvas shadow-2xl">
+        <div className="flex items-center justify-between px-5 pb-1 pt-4">
+          <h2 id="create-project-title" className="text-base font-semibold text-agent-foreground">
+            新建项目
+          </h2>
+          <button
+            type="button"
+            onClick={onClose}
+            className="rounded-full p-1 text-agent-muted-foreground transition-colors hover:bg-agent-muted hover:text-agent-foreground"
+            aria-label="关闭"
+          >
+            <LuX className="h-4 w-4" />
+          </button>
+        </div>
+
+        <div className="space-y-4 px-5 py-3">
+          <label className="flex h-10 items-center gap-2 rounded-full border border-agent-border bg-agent-canvas px-3 focus-within:border-agent-foreground/40">
+            <LuFolder className="h-4 w-4 shrink-0 text-agent-muted-foreground" />
+            <input
+              type="text"
+              value={name}
+              onChange={(event) => setName(event.target.value)}
+              onKeyDown={(event) => {
+                if (event.key === 'Enter') void handleSubmit();
+              }}
+              placeholder="项目名称"
+              autoFocus
+              className="h-full min-w-0 flex-1 bg-transparent text-sm text-agent-foreground outline-none placeholder:text-agent-muted-foreground"
+              data-testid="create-project-name"
+            />
+          </label>
+          <p className="px-1 text-[11px] text-agent-muted-foreground">
+            默认位置：{homePreview}
+          </p>
+
+          <div>
+            <div className="mb-2 text-sm text-agent-foreground">源文件夹</div>
+            {sourceFolders.length > 0 && (
+              <ul className="mb-2 space-y-1">
+                {sourceFolders.map((folder) => (
+                  <li
+                    key={folder}
+                    className="flex items-center gap-2 rounded-lg bg-agent-muted/40 px-2.5 py-1.5 text-xs text-agent-foreground"
+                  >
+                    <LuFolder className="h-3.5 w-3.5 shrink-0 text-agent-muted-foreground" />
+                    <span className="min-w-0 flex-1 truncate font-mono" title={folder}>
+                      {folder}
+                    </span>
+                    <button
+                      type="button"
+                      onClick={() =>
+                        setSourceFolders((prev) => prev.filter((item) => item !== folder))
+                      }
+                      className="rounded-full p-0.5 text-agent-muted-foreground hover:text-agent-foreground"
+                      aria-label={`移除 ${folder}`}
+                    >
+                      <LuX className="h-3.5 w-3.5" />
+                    </button>
+                  </li>
+                ))}
+              </ul>
+            )}
+            <div className="flex flex-col items-center justify-center gap-3 rounded-2xl border border-dashed border-agent-border px-4 py-8">
+              <span className="text-sm text-agent-muted-foreground">添加此电脑上的文件夹</span>
+              <button
+                type="button"
+                onClick={() => void handleAddFolder()}
+                disabled={!isElectron()}
+                className="flex h-8 items-center gap-1.5 rounded-full border border-agent-border px-4 text-xs font-medium text-agent-foreground transition-colors hover:bg-agent-muted disabled:cursor-not-allowed disabled:opacity-50"
+                data-testid="create-project-add-folder"
+              >
+                <LuFolderPlus className="h-3.5 w-3.5" />
+                添加
+              </button>
+            </div>
+          </div>
+
+          {error && (
+            <p className="text-xs text-agent-destructive" role="alert">
+              {error}
+            </p>
+          )}
+        </div>
+
+        <div className="flex items-center justify-end gap-2 px-5 pb-4 pt-1">
+          <button
+            type="button"
+            onClick={onClose}
+            className="h-9 rounded-full px-4 text-sm text-agent-muted-foreground transition-colors hover:bg-agent-muted hover:text-agent-foreground"
+          >
+            取消
+          </button>
+          <button
+            type="button"
+            onClick={() => void handleSubmit()}
+            disabled={!trimmed || submitting}
+            className="h-9 rounded-full bg-agent-foreground px-4 text-sm font-medium text-agent-canvas transition-opacity disabled:opacity-40"
+            data-testid="create-project-submit"
+          >
+            {submitting ? '创建中…' : '创建项目'}
+          </button>
+        </div>
+      </div>
+    </div>,
+    document.body,
+  );
+}

package/src/components/chat/ChatProjectBadge.tsx

@@ -7,9 +7,12 @@ import {
   LuFolderPlus,
   LuFolderX,
   LuLoaderCircle,
+  LuPlus,
 } from 'react-icons/lu';
+import { CreateProjectModal } from '@/components/CreateProjectModal';
 import { getElectronBridge, isElectron } from '@/lib/electron-bridge';
 import {
+  createProject,
   updateChatProject,
   updateProject,
   type LocalProject,
@@ -93,14 +96,47 @@ function MenuShell({
   );
 }
 
-function MenuSectionLabel({ children }: { children: ReactNode }) {
+function MenuSectionLabel({
+  children,
+  onAdd,
+}: {
+  children: ReactNode;
+  onAdd?: () => void;
+}) {
   return (
-    <div className="px-2 py-1 text-[10px] font-semibold uppercase tracking-wider text-agent-muted-foreground">
-      {children}
+    <div className="flex items-center justify-between gap-1 px-2 py-1">
+      <div className="text-[10px] font-semibold uppercase tracking-wider text-agent-muted-foreground">
+        {children}
+      </div>
+      {onAdd && (
+        <button
+          type="button"
+          onClick={onAdd}
+          className="flex h-5 w-5 items-center justify-center rounded-full text-agent-muted-foreground transition-colors hover:bg-agent-foreground/10 hover:text-agent-foreground"
+          title="新建项目"
+          aria-label="新建项目"
+        >
+          <LuPlus className="h-3 w-3" />
+        </button>
+      )}
     </div>
   );
 }
 
+function CreateProjectMenuItem({ onClick }: { onClick: () => void }) {
+  return (
+    <button
+      type="button"
+      role="menuitem"
+      onClick={onClick}
+      className="flex w-full items-center gap-2 rounded px-2 py-1.5 text-left text-xs text-agent-foreground transition-colors hover:bg-agent-foreground/5"
+    >
+      <LuFolderPlus className="h-3.5 w-3.5 shrink-0 text-agent-muted-foreground" />
+      新建项目
+    </button>
+  );
+}
+
 function ProjectMenuRow({
   project,
   selected,
@@ -147,9 +183,15 @@ export function ChatProjectBadge({
   onChatProjectChanged: () => void | Promise<void>;
 }) {
   const [open, setOpen] = useState(false);
+  const [createOpen, setCreateOpen] = useState(false);
   const [busy, setBusy] = useState(false);
   const [error, setError] = useState<string | null>(null);
 
+  const openCreate = () => {
+    setOpen(false);
+    setCreateOpen(true);
+  };
+
   const otherProjects = project
     ? projects.filter((p) => p.id !== project.id)
     : projects;
@@ -226,7 +268,7 @@ export function ChatProjectBadge({
               </div>
             </>
           ) : (
-            <MenuSectionLabel>关联到项目</MenuSectionLabel>
+            <MenuSectionLabel onAdd={openCreate}>关联到项目</MenuSectionLabel>
           )}
 
           {otherProjects.length > 0 && (
@@ -247,9 +289,12 @@ export function ChatProjectBadge({
             </>
           )}
           {!project && projects.length === 0 && (
-            <div className="px-2 py-1.5 text-[11px] text-agent-muted-foreground/70">
-              还没有项目——先在侧边栏「会话」旁点 📁+ 新建。
-            </div>
+            <>
+              <div className="px-2 py-1.5 text-[11px] text-agent-muted-foreground/70">
+                还没有项目
+              </div>
+              <CreateProjectMenuItem onClick={openCreate} />
+            </>
           )}
 
           {project && (
@@ -283,6 +328,22 @@ export function ChatProjectBadge({
           )}
         </MenuShell>
       )}
+
+      <CreateProjectModal
+        open={createOpen}
+        onClose={() => setCreateOpen(false)}
+        onCreate={async (input) => {
+          const res = await createProject({
+            name: input.name,
+            ...(input.sourceFolders.length > 0 ? { sourceFolders: input.sourceFolders } : {}),
+          });
+          await onProjectsChanged();
+          if (res.project?.id) {
+            await updateChatProject(chatId, res.project.id);
+            await onChatProjectChanged();
+          }
+        }}
+      />
     </div>
   );
 }
@@ -293,15 +354,24 @@ export function ProjectPickerButton({
   projects,
   value,
   onChange,
+  onProjectsChanged,
 }: {
   projects: LocalProject[];
   /** 当前选中的 projectId；null = 无项目。 */
   value: string | null;
   onChange: (projectId: string | null) => void;
+  /** 新建项目后刷新列表。 */
+  onProjectsChanged: () => void | Promise<void>;
 }) {
   const [open, setOpen] = useState(false);
+  const [createOpen, setCreateOpen] = useState(false);
   const selected = value ? (projects.find((p) => p.id === value) ?? null) : null;
 
+  const openCreate = () => {
+    setOpen(false);
+    setCreateOpen(true);
+  };
+
   return (
     <div className="relative">
       <BadgeButton
@@ -319,7 +389,7 @@ export function ProjectPickerButton({
 
       {open && (
         <MenuShell onClose={() => setOpen(false)}>
-          <MenuSectionLabel>新对话所属项目</MenuSectionLabel>
+          <MenuSectionLabel onAdd={openCreate}>新对话所属项目</MenuSectionLabel>
           <button
             type="button"
             role="menuitem"
@@ -349,12 +419,28 @@ export function ProjectPickerButton({
             ))}
           </div>
           {projects.length === 0 && (
-            <div className="px-2 py-1.5 text-[11px] text-agent-muted-foreground/70">
-              还没有项目——先在侧边栏「会话」旁点 📁+ 新建。
-            </div>
+            <>
+              <div className="px-2 py-1.5 text-[11px] text-agent-muted-foreground/70">
+                还没有项目
+              </div>
+              <CreateProjectMenuItem onClick={openCreate} />
+            </>
           )}
         </MenuShell>
       )}
+
+      <CreateProjectModal
+        open={createOpen}
+        onClose={() => setCreateOpen(false)}
+        onCreate={async (input) => {
+          const res = await createProject({
+            name: input.name,
+            ...(input.sourceFolders.length > 0 ? { sourceFolders: input.sourceFolders } : {}),
+          });
+          await onProjectsChanged();
+          if (res.project?.id) onChange(res.project.id);
+        }}
+      />
     </div>
   );
 }

package/src/layouts/AgentLayout.tsx

@@ -450,16 +450,18 @@ function AgentLayoutContent() {
     <div className="relative flex h-full w-full bg-agent-muted/30">
       {sidebarCollapsed ? (
         // 收起态：窄 rail 只放展开按钮。新建对话仍可用 Cmd+N / 菜单触发。
-        <div className="flex h-full w-10 flex-shrink-0 flex-col items-center border-r border-agent-border/60 bg-agent-muted/70 py-2 backdrop-blur-md">
-          <button
-            type="button"
-            onClick={toggleSidebarCollapsed}
-            className="flex h-7 w-7 items-center justify-center rounded-full text-agent-muted-foreground transition-colors duration-200 hover:bg-agent-foreground/5 hover:text-agent-foreground"
-            title="展开侧边栏"
-            aria-label="展开侧边栏"
-          >
-            <LuPanelLeftOpen className="h-3.5 w-3.5" />
-          </button>
+        <div className="flex h-full w-10 flex-shrink-0 flex-col items-center border-r border-agent-border/60 bg-agent-muted/70 backdrop-blur-md">
+          <div className="flex h-11 w-full items-center justify-center">
+            <button
+              type="button"
+              onClick={toggleSidebarCollapsed}
+              className="flex h-7 w-7 items-center justify-center rounded-full text-agent-muted-foreground transition-colors duration-200 hover:bg-agent-foreground/5 hover:text-agent-foreground"
+              title="展开侧边栏"
+              aria-label="展开侧边栏"
+            >
+              <LuPanelLeftOpen className="h-3.5 w-3.5" />
+            </button>
+          </div>
         </div>
       ) : (
         <>

package/src/lib/local-api.ts

@@ -369,6 +369,8 @@ export interface LocalProject {
   id: string;
   name: string;
   folderPath: string;
+  /** 附加源文件夹（只读）。缺省空。 */
+  sourceFolders?: string[];
   /** W6-5: 信任后该项目目录里的规则文件才会注入模型上下文。缺省 false。 */
   trusted?: boolean;
   createdAt: string;
@@ -473,7 +475,11 @@ export async function listProjects() {
   });
 }
 
-export async function createProject(input: { name: string; folderPath: string }) {
+export async function createProject(input: {
+  name: string;
+  folderPath?: string;
+  sourceFolders?: string[];
+}) {
   return bridge().localBackend.request<{ success: boolean; project: LocalProject }>({
     method: 'POST',
     path: '/api/v2/projects',

package/src/pages/AgentPage.tsx

@@ -1234,18 +1234,18 @@ function EmptyChatGate() {
   useEffect(() => {
     setSelectedProjectId(projectIdFromUrl);
   }, [projectIdFromUrl]);
-  useEffect(() => {
+  const fetchProjects = useCallback(async () => {
     if (!isElectron()) return;
-    let cancelled = false;
-    listProjects()
-      .then((res) => {
-        if (!cancelled) setProjects(res.projects ?? []);
-      })
-      .catch(() => {});
-    return () => {
-      cancelled = true;
-    };
+    try {
+      const res = await listProjects();
+      setProjects(res.projects ?? []);
+    } catch {
+      /* 列表失败保持旧数据 */
+    }
   }, []);
+  useEffect(() => {
+    void fetchProjects();
+  }, [fetchProjects]);
 
   useEffect(() => {
     inputRef.current?.focusAtEnd();
@@ -1382,6 +1382,7 @@ function EmptyChatGate() {
                   projects={projects}
                   value={selectedProjectId}
                   onChange={setSelectedProjectId}
+                  onProjectsChanged={fetchProjects}
                 />
               ) : undefined
             }