@steerable/agent-shell-web 0.6.30 → 0.6.32

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,269 @@
+/**
+ * 新建 / 编辑项目弹窗（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 } from '@/lib/electron-bridge';
+
+export interface ProjectFormValues {
+  name: string;
+  sourceFolders: string[];
+}
+
+export interface CreateProjectModalProps {
+  open: boolean;
+  onClose: () => void;
+  onCreate: (input: ProjectFormValues) => Promise<void>;
+  mode?: 'create' | 'edit';
+  initial?: ProjectFormValues;
+  onDelete?: () => Promise<void> | void;
+}
+
+export function CreateProjectModal({
+  open,
+  onClose,
+  onCreate,
+  mode = 'create',
+  initial,
+  onDelete,
+}: CreateProjectModalProps) {
+  const isEdit = mode === 'edit';
+  const [name, setName] = useState(initial?.name ?? '');
+  const [sourceFolders, setSourceFolders] = useState(initial?.sourceFolders ?? []);
+  const [folderDraft, setFolderDraft] = useState('');
+  const [submitting, setSubmitting] = useState(false);
+  const [deleting, setDeleting] = useState(false);
+  const [confirmDelete, setConfirmDelete] = useState(false);
+  const [error, setError] = useState<string | null>(null);
+  const initialFoldersKey = (initial?.sourceFolders ?? []).join('\0');
+
+  useEffect(() => {
+    if (!open) return;
+    setName(initial?.name ?? '');
+    setSourceFolders(initial?.sourceFolders ?? []);
+    setFolderDraft('');
+    setSubmitting(false);
+    setDeleting(false);
+    setConfirmDelete(false);
+    setError(null);
+    const onKey = (event: KeyboardEvent) => {
+      if (event.key === 'Escape') onClose();
+    };
+    window.addEventListener('keydown', onKey);
+    return () => window.removeEventListener('keydown', onKey);
+  }, [open, onClose, initial?.name, initialFoldersKey]);
+
+  if (!open) return null;
+  if (typeof document === 'undefined') return null;
+
+  const trimmed = name.trim();
+  const homePreview = `~/Documents/${BRAND_NAME}/${trimmed || '项目名'}`;
+  const titleId = isEdit ? 'edit-project-title' : 'create-project-title';
+
+  const addSourceFolder = (folder: string) => {
+    const next = folder.trim();
+    if (!next) return;
+    setSourceFolders((prev) => (prev.includes(next) ? prev : [...prev, next]));
+    setFolderDraft('');
+    setError(null);
+  };
+
+  const handleAddFolder = async () => {
+    const typed = folderDraft.trim();
+    if (typed) {
+      addSourceFolder(typed);
+      return;
+    }
+    const result = await getElectronBridge()?.local?.selectDirectory({
+      title: '添加源文件夹',
+    });
+    if (!result || result.canceled || result.filePaths.length === 0) {
+      if (!getElectronBridge()?.local?.selectDirectory) {
+        setError('请输入文件夹路径');
+      }
+      return;
+    }
+    addSourceFolder(result.filePaths[0]);
+  };
+
+  const handleSubmit = async () => {
+    if (!trimmed || submitting || deleting) return;
+    setSubmitting(true);
+    setError(null);
+    try {
+      await onCreate({ name: trimmed, sourceFolders });
+      onClose();
+    } catch (err) {
+      setError(err instanceof Error ? err.message : String(err));
+      setSubmitting(false);
+    }
+  };
+
+  const handleDelete = async () => {
+    if (!onDelete || deleting || submitting) return;
+    if (!confirmDelete) {
+      setConfirmDelete(true);
+      return;
+    }
+    setDeleting(true);
+    setError(null);
+    try {
+      await onDelete();
+      onClose();
+    } catch (err) {
+      setError(err instanceof Error ? err.message : String(err));
+      setDeleting(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={titleId}
+      data-testid={isEdit ? 'edit-project-dialog' : '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={titleId} className="text-base font-semibold text-agent-foreground">
+            {isEdit ? '编辑项目' : '新建项目'}
+          </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={isEdit ? 'edit-project-name' : 'create-project-name'}
+            />
+          </label>
+          {!isEdit && (
+            <p className="px-1 text-[11px] text-agent-muted-foreground">
+              默认位置：{homePreview}
+            </p>
+          )}
+
+          <div>
+            <div className="mb-2 text-sm text-agent-foreground">源文件夹</div>
+            <div className="overflow-hidden rounded-2xl border border-agent-border">
+              {sourceFolders.map((folder) => (
+                <div
+                  key={folder}
+                  className="flex items-center gap-2 border-b border-agent-border/60 px-3 py-2 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>
+                </div>
+              ))}
+              <div className="flex items-center gap-2 px-3 py-2">
+                <LuFolderPlus className="h-3.5 w-3.5 shrink-0 text-agent-muted-foreground" />
+                <input
+                  type="text"
+                  value={folderDraft}
+                  onChange={(event) => setFolderDraft(event.target.value)}
+                  onKeyDown={(event) => {
+                    if (event.key === 'Enter') {
+                      event.preventDefault();
+                      void handleAddFolder();
+                    }
+                  }}
+                  placeholder="输入路径或点添加浏览"
+                  className="h-7 min-w-0 flex-1 bg-transparent text-xs text-agent-foreground outline-none placeholder:text-agent-muted-foreground"
+                  data-testid={isEdit ? 'edit-project-folder-path' : 'create-project-folder-path'}
+                />
+                <button
+                  type="button"
+                  onClick={() => void handleAddFolder()}
+                  className="shrink-0 rounded-full px-2 py-1 text-xs font-medium text-agent-foreground hover:bg-agent-muted"
+                  data-testid={isEdit ? 'edit-project-add-folder' : 'create-project-add-folder'}
+                >
+                  添加
+                </button>
+              </div>
+            </div>
+          </div>
+
+          {error && (
+            <p className="text-xs text-agent-destructive" role="alert">
+              {error}
+            </p>
+          )}
+        </div>
+
+        <div className="flex items-center gap-2 px-5 pb-4 pt-1">
+          {onDelete && (
+            <button
+              type="button"
+              onClick={() => void handleDelete()}
+              disabled={deleting || submitting}
+              title={
+                confirmDelete
+                  ? '再次点击确认删除（会话会保留为无项目对话）'
+                  : '删除项目（会话保留为无项目对话）'
+              }
+              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
+            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 ${
+              onDelete ? '' : 'ml-auto'
+            }`}
+          >
+            取消
+          </button>
+          <button
+            type="button"
+            onClick={() => void handleSubmit()}
+            disabled={!trimmed || submitting || deleting}
+            className="h-9 rounded-full bg-agent-foreground px-4 text-sm font-medium text-agent-canvas transition-opacity disabled:opacity-40"
+            data-testid={isEdit ? 'edit-project-submit' : 'create-project-submit'}
+          >
+            {submitting ? (isEdit ? '保存中…' : '创建中…') : isEdit ? '保存' : '创建项目'}
+          </button>
+        </div>
+      </div>
+    </div>,
+    document.body,
+  );
+}

package/src/components/chat/ApprovalModal.tsx

@@ -161,8 +161,8 @@ export function ApprovalPromptMenu({
                 </p>
               )}
               <p className="mt-2 text-[11px] leading-relaxed text-agent-muted-foreground">
-                默认在工作区沙箱中执行（只能写入当前项目）。写入 Downloads
-                等项目外路径会被系统拒绝；需要时在输入框把沙箱切到「完整权限」后再让
+                默认在工作区沙箱中执行（只能写入当前项目或本对话工作区）。写入
+                Downloads 等工作区外路径会被系统拒绝；需要时在输入框把沙箱切到「完整权限」后再让
                 Agent 重试。
               </p>
             </>

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
@@ -313,13 +383,13 @@ export function ProjectPickerButton({
         title={
           selected
             ? `${selected.folderPath}\n新对话将绑定到此项目`
-            : '为新对话选择项目（可不选）'
+            : '为新对话选择项目。不选则在文稿/<应用名>/conversations/ 下建立本对话工作区'
         }
       />
 
       {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/components/chat/ExecPolicyPicker.tsx

@@ -6,8 +6,8 @@ import type { ExecPolicy } from '@/lib/exec-policy';
  * ExecPolicyPicker — 输入框上的命令沙箱切换（类 Codex 底部权限档）。
  *
  * 切档立刻记住，下一轮才生效：当前回合的 `execSandbox` 已经随流发出。
- * 工作区 = Seatbelt/bwrap 只允许写项目根；完整权限 = 不下发命令沙箱，
- * 本机路径（如 Downloads）不再被 Operation not permitted 拦住。
+ * 工作区 = Seatbelt/bwrap 只允许写项目家目录或本对话工作区；完整权限
+ * = 不下发命令沙箱，本机路径（如 Downloads）不再被 Operation not permitted 拦住。
  */
 
 const OPTIONS: Array<{
@@ -18,7 +18,8 @@ const OPTIONS: Array<{
   {
     id: 'workspace',
     label: '工作区',
-    description: '命令只能写入当前项目；项目外路径会被系统拒绝。',
+    description:
+      '命令只能写入当前项目或本对话工作区（文稿/<应用名>/conversations/）；工作区外路径会被系统拒绝。',
   },
   {
     id: 'full',

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/exec-policy.ts

@@ -2,8 +2,8 @@
  * 会话级命令执行沙箱（类 Codex 的 sandbox_mode）。
  *
  * 作用于下一轮 `chat.stream` 的 `execSandbox`，不是 sidecar 进程沙箱
- * （设置页那一层）。工作区 = 只能写入当前项目；完整权限 = 关闭逐条命令
- * 沙箱。工具审批（允许/拒绝）仍按原策略生效。
+ * （设置页那一层）。工作区 = 只能写入当前项目或本对话工作区；完整权限
+ * = 关闭逐条命令沙箱。工具审批（允许/拒绝）仍按原策略生效。
  */
 
 export type ExecPolicy = 'workspace' | 'full';

package/src/lib/http-bridge.ts

@@ -44,6 +44,15 @@ function authHeaders(): Record<string, string> {
   return token ? { Authorization: `Bearer ${token}` } : {};
 }
 
+function httpErrorMessage(data: unknown, status: number): string {
+  if (data && typeof data === 'object') {
+    const rec = data as { error?: unknown; detail?: unknown };
+    if (typeof rec.error === 'string' && rec.error.trim()) return rec.error;
+    if (typeof rec.detail === 'string' && rec.detail.trim()) return rec.detail;
+  }
+  return `Request failed (${status})`;
+}
+
 async function http<T>(method: string, path: string, body?: unknown): Promise<T> {
   const res = await fetch(path, {
     method,
@@ -53,11 +62,9 @@ async function http<T>(method: string, path: string, body?: unknown): Promise<T>
     },
     body: body !== undefined ? JSON.stringify(body) : undefined,
   });
-  const data = (await res.json().catch(() => null)) as T & { detail?: string };
+  const data = (await res.json().catch(() => null)) as T;
   if (!res.ok) {
-    const err = new Error(
-      (data as { detail?: string } | null)?.detail || `Request failed (${res.status})`,
-    ) as Error & { status?: number };
+    const err = new Error(httpErrorMessage(data, res.status)) as Error & { status?: number };
     err.status = res.status;
     throw err;
   }
@@ -197,9 +204,15 @@ export function createHttpBridge(): ElectronBridge {
     platform: boot.platform,
 
     local: {
-      // 浏览器没有系统目录选择器（showDirectoryPicker 不给路径）。返回
-      // canceled 让 UI 走"手动输入路径"的既有分支。
-      selectDirectory: async () => ({ canceled: true, filePaths: [] }),
+      // 浏览器 File System Access API 不给真实路径。改走宿主
+      // `/host/local/select-directory`（本机系统选择器）；取消或无 GUI
+      // 时返回 canceled，UI 再走手动输入路径。
+      selectDirectory: async (options) =>
+        http<{ canceled: boolean; filePaths: string[] }>(
+          'POST',
+          '/host/local/select-directory',
+          options ?? {},
+        ),
       saveTextFile: async (options) => {
         const blob = new Blob([options.content], { type: 'application/json' });
         const url = URL.createObjectURL(blob);

package/src/lib/local-api.ts

@@ -353,7 +353,7 @@ export interface ResolvedLocalPath {
 
 /**
  * 批量确认正文里提到的路径是否真实存在（用于决定行内代码要不要变成可点击）。
- * 相对路径由后端按对话绑定的项目根解析，无项目时按 home；不存在的候选不回。
+ * 相对路径由后端按对话绑定的项目根解析，无项目时按对话工作区；不存在的候选不回。
  */
 export async function resolveLocalPaths(candidates: string[], chatId?: string | null) {
   return bridge().localBackend.request<{ resolved: ResolvedLocalPath[] }>({
@@ -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',
@@ -483,7 +489,7 @@ export async function createProject(input: { name: string; folderPath: string })
 
 export async function updateProject(
   projectId: string,
-  updates: { name?: string; folderPath?: string },
+  updates: { name?: string; folderPath?: string; sourceFolders?: string[] },
 ) {
   return bridge().localBackend.request<{ success: boolean; project: LocalProject }>({
     method: 'PUT',

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
             }