文档会话与项目
文档目录

会话列表

项目、会话列表、收藏、归档和自动归档都在左侧栏;项目按文件夹分组,状态圆点标出运行中、待确认和已完成。

更新于 2026年11月10日

会话列表是回到任何一次对话的入口,把项目、会话、收藏和归档收在一处。左侧栏有三种浏览方式:默认的项目会话列表、收藏视图、归档视图;顶部是「新建任务」,底部是「已归档」入口。

项目

项目指向磁盘上一个真实文件夹,文件、产物、项目下挂的记忆、Skills、MCP、AGENTS.md 都按项目隔离。

新建项目有两个入口,都在项目列表顶部:

  • 从本地文件夹创建:选一个已有目录,适合代码仓库或现成资料,显示为本地项目。
  • 新建空白项目:由 Proma 在托管目录下建一个空文件夹。

当前所在的项目会高亮标记。

项目标题右侧的菜单:

  • 设为当前项目:切换输入框和右侧文件区默认指向的项目。
  • 重命名 / 配置 MCP 与 Skills。
  • 归档项目:整个项目连同会话退出活跃列表,文件与配置不受影响;归档要再确认一次。
  • 删除项目:删除项目下的会话、定时任务、MCP、Skills 与 Proma 工作区配置;本地目录、附加目录、附加文件只解除关联,不会删原始文件(空白项目的托管文件会一起删)。默认项目不能删,至少要留一个项目。
  • 重新选择文件夹 / 在原路径新建空文件夹:本地项目的原目录被移动或删掉时出现,用来重新建立。

会话

会话是一次具体的小任务:写一份方案、改一个页面、整理一批数据。它是最小的上下文单位,也是右侧草稿区的归属。同一个项目下的会话共享项目规则和记忆,但彼此不共享对话上下文。

一个会话处理一件事,任务收尾后新建会话。不相关的任务放进同一个会话会占用大量上下文,Agent 容易遗漏前文。

会话列表

顶部「新建任务」会在当前选中的项目里新建一个会话。

  • 置顶会话在最上面,跨项目集中显示,不跟任何项目一起折叠。
  • 其余会话按项目分组,项目内按最近活跃倒序。项目标题右侧是「新建会话」和「项目菜单」,项目较多时可用顶部「折叠所有项目」一次收起。
  • 定时任务生成的会话不在项目列表里出现,只在左侧「定时任务」工作区按任务展开查看;在结果会话里手动发消息被接管后,才回到所属项目的列表。
  • 每个会话后面是相对时间(几小时前、几天前);有子会话的会话会显示子会话数量和展开开关。
  • 底部「已归档」带归档数量,点进去是单独的归档列表;已归档项目里的会话只在归档视图出现。

会话状态

会话标题前的小圆点表示这一条的状态,没有圆点就是普通历史会话:

  • 蓝色:正在运行。
  • 橙色:等你确认(权限申请、Agent 提问)。
  • 绿色:已运行完成,但你还没打开看过。

会话行尾还有两种小标记,用来判断是否需要现在回到这条会话:

  • 终端图标:这个会话里有终端正在执行命令——Agent 的终端,或你在这个会话里开的标签都算。命令结束图标就消失。
  • 变更请求图标:绑定了 PR 时显示 PR 状态图标(草稿、开启、合并、关闭),角上一个 CI 小圆点表示检查进行中、通过或未通过;只有 worktree 还没有 PR 时,这个位置显示分支图标。悬停约 0.4 秒出卡片,列出分支与前三条 PR 的状态;点它打开该会话的「文件改动」。

会话操作

鼠标移到会话行,右侧出现「更多会话操作」;在行上右键是同一套菜单;行上的星标按钮直接收藏。

  • 引用此会话:把该会话插进当前输入框当引用,也可以把会话从列表直接拖进输入框。
  • 置顶会话:有子会话时会多出一项「含 N 个子会话」,可只置顶这一条。置顶会自动取消归档。
  • 迁移到其他项目:换归属,也换工作目录。
  • 重命名:也可以双击标题就地改。
  • 归档 / 取消归档:父会话与子会话一起进出,归档时如果这个会话正开着,会一起关掉它的窗口。
  • 删除会话:不可恢复;有子会话时会问是否一并删除。
  • 星标:加入收藏,不改变它在项目里的位置。

收藏视图

星标即收藏,也可以把会话直接拖到左侧栏的「收藏」按钮上。收藏是跨项目的清单,用来集中需要反复查看的会话,不代表优先级。

  • 顶部有独立搜索框,只搜收藏范围内的会话。
  • 排序:按收藏时间(默认)、按最新活跃、按项目。
  • 每一行的操作和普通列表一样——置顶、重命名、迁移、归档、删除、引用都能用。
  • 底部「已归档」切到已归档的收藏,回来点「返回收藏会话」。
  • 收藏的会话不会被自动归档;手动归档依然生效,归档后它从收藏视图消失,进已归档收藏。

归档视图

归档是把会话从活跃列表收起来,不是删除:项目列表里不再显示,但仍可查看、恢复、继续对话。

  • 入口是左侧栏底部「已归档」,进入后是另一个列表,点「返回活跃会话」回到常规列表。
  • 归档父会话会同步归档它的子会话;恢复时子会话一起回来。归档当前打开的会话,会同时关掉它在中间区的窗口,回到空状态。
  • 归档项目是另一层操作:整个项目连同会话退出活跃列表,项目文件、会话、配置都不受影响,随时可以「恢复项目」。
  • 归档列表按需加载,首次进入会稍慢;加载失败时顶部出现「无法加载归档会话」并可重试。
  • 未接管的定时任务运行会话在归档视图里单独归到「定时任务」一组,不跟随所属项目。

自动归档

超过指定天数没更新的会话会自动进归档,避免列表越堆越长。

  • 默认 7 天,在设置里可改成 14 / 30 / 60 天,或禁用。
  • 判断依据是最近一次更新时间,不是创建时间。
  • 置顶和星标的会话不会被自动归档。
  • 只管已有会话,草稿不参与。

快捷键

  • Cmd/Ctrl + N:新建任务。
  • Cmd + B(Windows 为 Ctrl + Shift + E):收起或展开左侧栏。
  • Cmd/Ctrl + Shift + F:全局搜索。

注意

  • 本地项目的目录被移走或删掉后,项目会标记「根目录不可用」,该项目的会话发消息会直接报错,要求先恢复文件夹。
  • 空白项目没有用户目录,文件区是 Proma 托管目录:删掉它不会被当成「根目录不可用」,下次访问会自动重建成空目录,原有文件不会回来。
  • 迁移到其他项目只改归属和工作目录,不会重写历史消息里的路径;之前引用过的旧项目文件,移动后可能找不到,建议重新引用一次。
  • 删除会话会连带清掉它的草稿、附件和右侧预览状态,且不可恢复。
  • 列表只是入口,不是存储:需要长期保留的结论写进项目文件或记忆。
  • 会话越长越容易触发上下文压缩并丢掉细节。发现它开始遗漏前文,就应当收尾新开会话。
本页内容