文档工作区与产出
文档目录

终端标签

右侧工作区里的真实终端,可开多个标签、在指定目录执行命令,Agent 也用它执行命令,运行时提供只读的浮动预览。

更新于 2026年11月10日

终端在 Proma 内提供真实 shell:安装依赖、运行测试、启动服务,与 Agent 执行命令用的是同一台机器。它是一个真实 PTY,不是命令回显,vim、ssh、top 这类交互式程序都能正常用;位置是右侧工作区的一个标签,和文件、网页并列。

入口

  • 右侧「+」里的「终端」,开在当前会话目录。
  • 文件树里目录行的终端按钮,或右键「在终端中打开此文件夹」,直接落在那个目录。
  • 「文件改动」的组头、Worktree 行的终端按钮,落在对应仓库或 worktree。
  • Agent 自己执行命令时也会开终端,落在同一片工作区。

标签标题按来源命名:「终端」「终端 · 目录名」「Agent 终端」或「Agent · 命令前 48 字」。

行为

  • 每个标签一个独立终端,切标签只切换显示,进程照常运行。
  • 滚动缓冲保留 5000 行,切回来还能往上翻。
  • 默认 shell 跟随系统 $SHELL,取不到时用系统默认 shell。
  • 背景纯黑、等宽字体,字号跟「外观设置」里终端字号一致。
  • 终端里没有工具栏,没有 shell 选择器,也不能点开链接。
  • 程序自行退出时,末尾追加一行灰字「终端已退出(退出码)」。

Agent 的终端

Agent 开的终端和你的终端在同一栏,只是名字带 Agent。

  • Agent 只能操作自己在本次会话里创建的终端,动不了你手动开的那个。
  • Agent 连续执行命令时,同目录、同 shell、空闲且未操作过的草稿终端会被复用,不会每次都新建终端。
  • Agent 在后台执行命令时,右下角出现「终端预览」浮窗,内容是实时跟随的只读画面;单击即打开完整终端,拖动只移动位置,右上角关闭只在本轮隐藏。
  • 对应的终端标签已经显示在工作区里时,浮窗自动消失,不重复展示。
  • Agent 需要打断自己正在执行的命令时,会往终端里发 Ctrl-C。

注意

  • 关闭标签就结束这个终端进程,关闭后会话不保留,重开是一个新 shell。
  • 退出应用或删除会话时,相关终端一并终止;重启应用后终端标签全部消失,不会恢复。
  • 从目录进入的终端要求目录真实存在,目录没了会提示「无法启动终端:终端工作目录不存在或不是目录」,不会退到主目录;从「+」开的终端则会退到用户主目录。
  • 一次输入超过 64KB 会被拒绝,提示「终端输入无效或过长」。
  • 终端只作为窗口内的一栏,不能拖成独立窗口。
本页内容