@steerable/agent-shell-web 0.6.31 → 0.6.32

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@steerable/agent-shell-web",
-  "version": "0.6.31",
+  "version": "0.6.32",
   "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-protocol": "0.6.31",
-    "@steerable/agent-ui": "0.6.31"
+    "@steerable/agent-protocol": "0.6.32",
+    "@steerable/agent-ui": "0.6.32"
   },
   "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.31"
+    "@steerable/pack-sdk": "0.6.32"
   },
   "scripts": {
     "gen": "echo agent-shell-web",

package/src/components/AgentSidebar.tsx

@@ -64,7 +64,7 @@
  *   │ ⬡ Skill 设置                    │ ← /settings?section=skills（独立页）
  *   │ 🔌 MCP 设置                     │ ← /settings?section=mcp（独立页）
  *   │  会话 v                     📁+ │ ← 📁+ 打开新建项目弹窗
- *   │  v 📁 项目A · 3      (hover: +✏📂🗑)│ ← 项目组：折叠/新建/重命名/换文件夹/删
+ *   │  v 📁 项目A · 3      (hover: +··)│ ← + 新建对话；·· 菜单：重命名/换目录/访达/删
  *   │   ...（项目内对话）              │
  *   │   今天                          │
  *   │   ...（无项目对话，按日期分组）  │ ← 无项目排在项目分组之后
@@ -78,6 +78,7 @@
  */
 
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { createPortal } from "react-dom";
 import { useLocation, useNavigate, useParams } from "react-router-dom";
 import {
   LuChevronDown,
@@ -97,6 +98,7 @@ import {
   LuFolderPlus,
   LuPencil,
   LuPlug,
+  LuEllipsis,
 } from "react-icons/lu";
 import { parseChatTitle } from "@/lib/chat-title";
 import { getDateGroupLabel, getDateGroupPriority } from "@/lib/date-groups";
@@ -105,6 +107,7 @@ import {
   createProject,
   deleteProject,
   listProjects,
+  openLocalPath,
   updateProject,
   type LocalChat,
   type LocalChatAgent,
@@ -141,6 +144,125 @@ function AgentDot({
   );
 }
 
+function placeProjectMenu(anchor: HTMLElement): { top: number; left: number } {
+  const box = anchor.getBoundingClientRect();
+  const width = 224;
+  const left = Math.min(box.right + 4, window.innerWidth - width - 8);
+  return { top: Math.max(8, box.top), left };
+}
+
+function ProjectOverflowMenu({
+  project,
+  chatCount,
+  anchor,
+  revealLabel,
+  confirmDelete,
+  deleting,
+  onClose,
+  onRename,
+  onChangeFolder,
+  onReveal,
+  onDelete,
+}: {
+  project: LocalProject;
+  chatCount: number;
+  anchor: HTMLElement;
+  revealLabel: string;
+  confirmDelete: boolean;
+  deleting: boolean;
+  onClose: () => void;
+  onRename: () => void;
+  onChangeFolder: () => void;
+  onReveal: () => void;
+  onDelete: () => void;
+}) {
+  const pos = placeProjectMenu(anchor);
+  useEffect(() => {
+    const onKey = (event: KeyboardEvent) => {
+      if (event.key === "Escape") onClose();
+    };
+    window.addEventListener("keydown", onKey);
+    return () => window.removeEventListener("keydown", onKey);
+  }, [onClose]);
+  return createPortal(
+    <>
+      <div className="fixed inset-0 z-[90]" onClick={onClose} />
+      <div
+        role="menu"
+        className="fixed z-[91] w-56 overflow-hidden rounded-2xl border border-agent-border bg-agent-canvas p-1 shadow-lg"
+        style={pos}
+        data-testid="project-overflow-menu"
+      >
+        <div className="px-2 py-1.5">
+          <div className="flex items-center gap-2 text-xs font-medium text-agent-foreground">
+            <LuFolder className="h-3.5 w-3.5 shrink-0 text-agent-muted-foreground" />
+            <span className="min-w-0 truncate">{project.name}</span>
+          </div>
+          <div className="mt-0.5 pl-[22px] text-[10px] text-agent-muted-foreground">
+            {chatCount} 个会话
+          </div>
+          <div
+            className="mt-0.5 truncate pl-[22px] font-mono text-[10px] text-agent-muted-foreground/70"
+            title={project.folderPath}
+          >
+            {project.folderPath}
+          </div>
+        </div>
+        <div className="mx-1 my-1 border-t border-agent-border/60" />
+        <button
+          type="button"
+          role="menuitem"
+          title="重命名项目"
+          onClick={onRename}
+          className="flex w-full items-center gap-2 rounded-lg px-2 py-1.5 text-left text-xs text-agent-foreground hover:bg-agent-foreground/5"
+        >
+          <LuPencil className="h-3.5 w-3.5 shrink-0 text-agent-muted-foreground" />
+          重命名
+        </button>
+        <button
+          type="button"
+          role="menuitem"
+          title="编辑项目"
+          onClick={onChangeFolder}
+          className="flex w-full items-center gap-2 rounded-lg px-2 py-1.5 text-left text-xs text-agent-foreground hover:bg-agent-foreground/5"
+        >
+          <LuFolderOpen className="h-3.5 w-3.5 shrink-0 text-agent-muted-foreground" />
+          编辑项目
+        </button>
+        <button
+          type="button"
+          role="menuitem"
+          title={revealLabel}
+          onClick={onReveal}
+          className="flex w-full items-center gap-2 rounded-lg px-2 py-1.5 text-left text-xs text-agent-foreground hover:bg-agent-foreground/5"
+        >
+          <LuFolder className="h-3.5 w-3.5 shrink-0 text-agent-muted-foreground" />
+          {revealLabel}
+        </button>
+        <div className="mx-1 my-1 border-t border-agent-border/60" />
+        <button
+          type="button"
+          role="menuitem"
+          disabled={deleting}
+          title={
+            confirmDelete
+              ? "再次点击确认删除（会话会保留为无项目对话）"
+              : "删除项目（会话保留为无项目对话）"
+          }
+          onClick={onDelete}
+          className={`flex w-full items-center gap-2 rounded-lg px-2 py-1.5 text-left text-xs hover:bg-agent-destructive/10 ${
+            confirmDelete ? "text-agent-destructive" : "text-agent-foreground"
+          }`}
+        >
+          <LuTrash2 className={`h-3.5 w-3.5 shrink-0 ${deleting ? "animate-pulse" : ""}`} />
+          {confirmDelete ? "再次点击确认删除" : "删除项目"}
+        </button>
+      </div>
+    </>,
+    document.body,
+  );
+}
+
 interface AgentSidebarProps {
   data: UseChatsAndAgentsResult;
   /** 右侧栏当前打开的面板：null / 'terminal' / 包槽位 id（互斥）。 */
@@ -205,8 +327,8 @@ export function AgentSidebar({
 
   // ───── 项目模式 ─────
   // 项目列表从 local-backend 拉取（electron-store 持久化）。会话按
-  // projectId 分组：项目分组在上（每个项目一个可折叠分组，组头支持内联
-  // 管理：新建对话 / 重命名 / 换文件夹 / 删除），无项目对话在下（日期分组）。
+  // projectId 分组：项目分组在上（组头 hover：+ 新建对话 / ·· 菜单），
+  // 无项目对话在下（日期分组）。
   const [projects, setProjects] = useState<LocalProject[]>([]);
   const [collapsedProjectIds, setCollapsedProjectIds] = useState<Set<string>>(
     () => new Set(),
@@ -223,6 +345,11 @@ export function AgentSidebar({
   );
   const [projectError, setProjectError] = useState<string | null>(null);
   const [createProjectOpen, setCreateProjectOpen] = useState(false);
+  const [editingProjectId, setEditingProjectId] = useState<string | null>(null);
+  const [projectMenu, setProjectMenu] = useState<{
+    id: string;
+    anchor: HTMLElement;
+  } | null>(null);
 
   const fetchProjects = useCallback(async () => {
     if (!isElectron()) return;
@@ -274,48 +401,80 @@ export function AgentSidebar({
     [renamingValue, fetchProjects],
   );
 
-  const handleChangeProjectFolder = useCallback(
-    async (projectId: string) => {
-      if (!isElectron()) return;
+  const handleUpdateProject = useCallback(
+    async (
+      projectId: string,
+      input: { name: string; sourceFolders: string[] },
+    ) => {
       setProjectError(null);
       try {
-        const result = await bridge?.local?.selectDirectory({
-          title: "重新选择项目文件夹",
+        await updateProject(projectId, {
+          name: input.name,
+          sourceFolders: input.sourceFolders,
         });
-        if (!result || result.canceled || result.filePaths.length === 0) return;
-        await updateProject(projectId, { folderPath: result.filePaths[0] });
         await fetchProjects();
       } catch (err) {
-        setProjectError(err instanceof Error ? err.message : String(err));
+        const message = err instanceof Error ? err.message : String(err);
+        setProjectError(message);
+        throw err instanceof Error ? err : new Error(message);
       }
     },
-    [bridge, fetchProjects],
+    [fetchProjects],
   );
 
-  const handleDeleteProject = useCallback(
+  const removeProject = useCallback(
     async (projectId: string) => {
       if (deletingProjectId === projectId) return;
-      // 与会话删除同款两段确认：第一次点击武装红色按钮，第二次才真删。
-      if (confirmDeleteProjectId !== projectId) {
-        setConfirmDeleteProjectId(projectId);
-        return;
-      }
       try {
         setDeletingProjectId(projectId);
-        // 后端会把该项目下的会话降级为无项目对话（不删会话）。
         await deleteProject(projectId);
         setConfirmDeleteProjectId(null);
+        setProjectMenu(null);
+        setEditingProjectId(null);
         await fetchProjects();
         await data.refreshChats();
       } catch (err) {
-        setProjectError(err instanceof Error ? err.message : String(err));
+        const message = err instanceof Error ? err.message : String(err);
+        setProjectError(message);
+        throw err instanceof Error ? err : new Error(message);
       } finally {
         setDeletingProjectId(null);
       }
     },
-    [confirmDeleteProjectId, deletingProjectId, fetchProjects, data],
+    [deletingProjectId, fetchProjects, data],
+  );
+
+  const handleDeleteProject = useCallback(
+    async (projectId: string) => {
+      // 与会话删除同款两段确认：第一次点击武装红色按钮，第二次才真删。
+      if (confirmDeleteProjectId !== projectId) {
+        setConfirmDeleteProjectId(projectId);
+        return;
+      }
+      try {
+        await removeProject(projectId);
+      } catch {
+        // 横幅已写 projectError
+      }
+    },
+    [confirmDeleteProjectId, removeProject],
   );
 
+  const closeProjectMenu = useCallback(() => {
+    setProjectMenu(null);
+    setConfirmDeleteProjectId(null);
+  }, []);
+
+  const handleRevealProjectFolder = useCallback(async (folderPath: string) => {
+    setProjectError(null);
+    try {
+      const res = await openLocalPath(folderPath);
+      if (!res.success && res.error) setProjectError(res.error);
+    } catch (err) {
+      setProjectError(err instanceof Error ? err.message : String(err));
+    }
+  }, []);
+
   const toggleProjectCollapsed = useCallback((projectId: string) => {
     setCollapsedProjectIds((prev) => {
       const next = new Set(prev);
@@ -733,7 +892,7 @@ export function AgentSidebar({
               </div>
             ) : (
               <>
-                {/* 项目分组在前：组头可折叠，hover 出内联管理动作 */}
+                {/* 项目分组在前：组头可折叠，hover 出 + 新建对话 / ·· 菜单 */}
                 {projectGroups.map(({ project, items }) => (
                   <div key={project.id} className="mb-1">
                     <div className="group/proj relative">
@@ -767,25 +926,30 @@ export function AgentSidebar({
                             className="flex w-full min-w-0 items-center px-2.5 pb-0.5 pt-1.5 text-[10px] font-medium uppercase tracking-wider text-agent-muted-foreground/80 transition-colors hover:text-agent-foreground"
                             title={`${project.name}\n${project.folderPath}`}
                           >
-                            <span className="mr-1">
+                            <LuFolder className="mr-1 h-3 w-3 shrink-0" />
+                            <span className="min-w-0 truncate normal-case">
+                              {project.name}
+                            </span>
+                            <span className="ml-0.5 shrink-0">
                               {collapsedProjectIds.has(project.id) ? (
                                 <LuChevronDown className="h-3 w-3" />
                               ) : (
                                 <LuChevronUp className="h-3 w-3" />
                               )}
                             </span>
-                            <LuFolder className="mr-1 h-3 w-3 shrink-0" />
-                            <span className="min-w-0 truncate normal-case">
-                              {project.name}
-                            </span>
                             {items.length > 0 && (
                               <span className="ml-1 shrink-0 font-normal">
                                 · {items.length}
                               </span>
                             )}
                           </button>
-                          {/* 内联管理：新建对话 / 重命名 / 换文件夹 / 删除（两段确认） */}
-                          <div className="absolute right-1 top-1/2 flex -translate-y-1/2 items-center gap-0.5 opacity-0 transition-opacity group-hover/proj:opacity-100">
+                          <div
+                            className={`absolute right-1 top-1/2 flex -translate-y-1/2 items-center gap-0.5 transition-opacity ${
+                              projectMenu?.id === project.id
+                                ? "opacity-100"
+                                : "opacity-0 group-hover/proj:opacity-100"
+                            }`}
+                          >
                             <button
                               type="button"
                               onClick={() => handleOpenNewChat(project.id)}
@@ -796,45 +960,21 @@ export function AgentSidebar({
                             </button>
                             <button
                               type="button"
-                              onClick={() => {
-                                setRenamingProjectId(project.id);
-                                setRenamingValue(project.name);
+                              aria-label="项目菜单"
+                              aria-expanded={projectMenu?.id === project.id}
+                              onClick={(event) => {
+                                const button = event.currentTarget;
+                                setConfirmDeleteProjectId(null);
+                                setProjectMenu((current) =>
+                                  current?.id === project.id
+                                    ? null
+                                    : { id: project.id, anchor: button },
+                                );
                               }}
                               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="重命名项目"
+                              title="项目菜单"
                             >
-                              <LuPencil className="h-3 w-3" />
-                            </button>
-                            <button
-                              type="button"
-                              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="更换绑定文件夹"
-                            >
-                              <LuFolderOpen className="h-3 w-3" />
-                            </button>
-                            <button
-                              type="button"
-                              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"
-                              }`}
-                              title={
-                                confirmDeleteProjectId === project.id
-                                  ? "再次点击确认删除（会话会保留为无项目对话）"
-                                  : "删除项目（会话保留为无项目对话）"
-                              }
-                            >
-                              <LuTrash2
-                                className={`h-3 w-3 ${deletingProjectId === project.id ? "animate-pulse" : ""}`}
-                              />
+                              <LuEllipsis className="h-3 w-3" />
                             </button>
                           </div>
                         </>
@@ -972,11 +1112,63 @@ export function AgentSidebar({
         </button>
       </div>
 
+      {projectMenu &&
+        (() => {
+          const project = projects.find((item) => item.id === projectMenu.id);
+          if (!project) return null;
+          const chatCount =
+            projectGroups.find((group) => group.project.id === project.id)
+              ?.items.length ?? 0;
+          return (
+            <ProjectOverflowMenu
+              project={project}
+              chatCount={chatCount}
+              anchor={projectMenu.anchor}
+              revealLabel={isMac ? "在访达中显示" : "在文件管理器中显示"}
+              confirmDelete={confirmDeleteProjectId === project.id}
+              deleting={deletingProjectId === project.id}
+              onClose={closeProjectMenu}
+              onRename={() => {
+                setProjectMenu(null);
+                setRenamingProjectId(project.id);
+                setRenamingValue(project.name);
+              }}
+              onChangeFolder={() => {
+                setProjectMenu(null);
+                setEditingProjectId(project.id);
+              }}
+              onReveal={() => {
+                setProjectMenu(null);
+                void handleRevealProjectFolder(project.folderPath);
+              }}
+              onDelete={() => void handleDeleteProject(project.id)}
+            />
+          );
+        })()}
+
       <CreateProjectModal
         open={createProjectOpen}
         onClose={() => setCreateProjectOpen(false)}
         onCreate={handleCreateProject}
       />
+      {editingProjectId &&
+        (() => {
+          const project = projects.find((item) => item.id === editingProjectId);
+          if (!project) return null;
+          return (
+            <CreateProjectModal
+              open
+              mode="edit"
+              initial={{
+                name: project.name,
+                sourceFolders: project.sourceFolders ?? [],
+              }}
+              onClose={() => setEditingProjectId(null)}
+              onCreate={(input) => handleUpdateProject(project.id, input)}
+              onDelete={() => removeProject(project.id)}
+            />
+          );
+        })()}
     </div>
   );
 }

package/src/components/CreateProjectModal.tsx

@@ -1,56 +1,96 @@
 /**
- * 新建项目弹窗（Codex 式）：项目是带名字的容器，不是「选中的那个文件夹」。
- * 家目录由后端建在 Documents/<应用名>/<项目名>/；这里可选附加源文件夹。
+ * 新建 / 编辑项目弹窗（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';
+import { getElectronBridge } from '@/lib/electron-bridge';
+
+export interface ProjectFormValues {
+  name: string;
+  sourceFolders: string[];
+}
 
 export interface CreateProjectModalProps {
   open: boolean;
   onClose: () => void;
-  onCreate: (input: { name: string; sourceFolders: string[] }) => Promise<void>;
+  onCreate: (input: ProjectFormValues) => Promise<void>;
+  mode?: 'create' | 'edit';
+  initial?: ProjectFormValues;
+  onDelete?: () => Promise<void> | void;
 }
 
-export function CreateProjectModal({ open, onClose, onCreate }: CreateProjectModalProps) {
-  const [name, setName] = useState('');
-  const [sourceFolders, setSourceFolders] = useState<string[]>([]);
+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('');
-    setSourceFolders([]);
+    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]);
+  }, [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 () => {
-    if (!isElectron()) return;
+    const typed = folderDraft.trim();
+    if (typed) {
+      addSourceFolder(typed);
+      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]));
+    if (!result || result.canceled || result.filePaths.length === 0) {
+      if (!getElectronBridge()?.local?.selectDirectory) {
+        setError('请输入文件夹路径');
+      }
+      return;
+    }
+    addSourceFolder(result.filePaths[0]);
   };
 
   const handleSubmit = async () => {
-    if (!trimmed || submitting) return;
+    if (!trimmed || submitting || deleting) return;
     setSubmitting(true);
     setError(null);
     try {
@@ -62,6 +102,23 @@ export function CreateProjectModal({ open, onClose, onCreate }: CreateProjectMod
     }
   };
 
+  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"
@@ -70,13 +127,13 @@ export function CreateProjectModal({ open, onClose, onCreate }: CreateProjectMod
       }}
       role="dialog"
       aria-modal="true"
-      aria-labelledby="create-project-title"
-      data-testid="create-project-dialog"
+      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="create-project-title" className="text-base font-semibold text-agent-foreground">
-            新建项目
+          <h2 id={titleId} className="text-base font-semibold text-agent-foreground">
+            {isEdit ? '编辑项目' : '新建项目'}
           </h2>
           <button
             type="button"
@@ -101,52 +158,64 @@ export function CreateProjectModal({ open, onClose, onCreate }: CreateProjectMod
               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"
+              data-testid={isEdit ? 'edit-project-name' : 'create-project-name'}
             />
           </label>
-          <p className="px-1 text-[11px] text-agent-muted-foreground">
-            默认位置：{homePreview}
-          </p>
+          {!isEdit && (
+            <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"
+            <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}`}
                   >
-                    <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>
+                    <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>
 
@@ -157,22 +226,40 @@ export function CreateProjectModal({ open, onClose, onCreate }: CreateProjectMod
           )}
         </div>
 
-        <div className="flex items-center justify-end gap-2 px-5 pb-4 pt-1">
+        <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"
+            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}
+            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="create-project-submit"
+            data-testid={isEdit ? 'edit-project-submit' : 'create-project-submit'}
           >
-            {submitting ? '创建中…' : '创建项目'}
+            {submitting ? (isEdit ? '保存中…' : '创建中…') : isEdit ? '保存' : '创建项目'}
           </button>
         </div>
       </div>

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

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

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/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[] }>({
@@ -489,7 +489,7 @@ export async function createProject(input: {
 
 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',