WinCode
Sessions

项目管理

创建、打开、置顶、移除本地项目,以及项目与会话的关系

项目管理

WinCode 里的"项目"本质是一条目录登记记录。它不会修改你的文件夹,只是把路径保存到 SQLite,从而把后续创建的所有会话归属到这个目录下。

侧边栏项目列表

打开一个项目

点击侧边栏"本地项目"标题旁的 打开项目 按钮,会弹出系统目录选择器(@tauri-apps/plugin-dialogopen({ directory: true }))。

选中后:

  1. 前端从路径末段推导默认显示名,例如 /Users/me/workspace/foofoo
  2. 调用 projectOpen(path, name),写入 projects
  3. 重新拉取 projectList() 刷新列表
  4. 新打开的项目默认折叠,首次点击项目名称时才会加载第一页会话

项目右键菜单

对项目行点右键(或悬停后点更多按钮),有这些操作:

操作说明
置顶项目 / 取消置顶切换 pinned,置顶项目始终排在列表最前
在资源管理器中打开调用系统文件管理器(Finder / Explorer)打开项目目录
移除项目弹出确认对话框,需输入"确定删除"四个字才能执行

⚠️ 移除项目是危险操作:会同时删除该项目下的所有会话(totalCount 条),且不可撤销。确认对话框会显示具体数量。

新建会话

每个项目行悬停时显示 + 按钮,点击即可在当前项目下新建会话。逻辑位于 Sidebar.handleNewSession:

const session = await sessionCreate({ projectPath });
prependSession(projectPath, session); // 插到分页列表首
setActiveSession(session.id);
openTab('chat', { sessionId, folderPath, folderName });

会话创建后自动激活,并在顶部标签栏打开一个对应 Tab。

项目文件面板

点击项目行的文件图标(或顶部工作区的"项目文件"按钮),会打开右侧 Chat Explorer 面板,显示项目目录树,方便浏览代码。此面板与侧边栏独立,宽度同样可拖拽。

未分类会话

历史原因导致没有 projectPath 的会话会集中显示在"本地项目"下方,标题为"未分类"。它们同样支持置顶、重命名、删除、导出等操作。

相关文档

On this page