A local-first multi-agent app development platform, built on PenguinHarness
title: 对话 description: 与 Agent 开始对话,实时跟进它的工作,并在 Task 运行期间插话。
对话页是你和 Agent 一起工作的地方:在这里开始对话,看 Agent 的工作过程流式呈现,并在 Task 运行时随时插话。对话旁边的侧边面板还能查看它的文件、Trace、定时任务等。
- 刚开始用,先看开始对话和发送消息。
- Agent 工作期间能做什么,见 Task 运行期间。
- 想改变对话的运行方式,见切换思考等级、切换模型、交接给其他 Agent 和分叉对话。
- 想随时掌握 Agent 的状态,见查看 Agent 的工作过程、查看 Session 统计和管理上下文。
- 熟悉界面布局,见使用侧边面板和整理对话列表。
- 速查,见快捷键和限制。
开始对话
新对话从草稿开始,发送第一条消息时才创建 Session。
- 在侧边栏选择新建对话。草稿默认使用 Project 新对话默认值里的那个 Agent,前提是它还在这个 Project 里;否则用
default_agent,再没有就用第一个 Agent。 - 在输入框上方选择 Agent、Workspace(服务器上的一个目录,在目录浏览器中选取;不选目录时点击其左下角的从临时工作区开始)、审批模式、Model 和思考等级。
- 输入消息,按 Enter 发送。
Session 创建后,Workspace 就锁定了;模型仍然可以换,见切换模型。
几点说明:
- Project 的新对话默认值(在 Project 设置中,见 Web App)会预填新草稿的 Agent、Workspace 和审批模式,模型则默认为 Project 的默认模型。思考等级优先显示 Agent 自己的等级,没有时用 Project 的默认值,再没有就是 medium(中)。
- 在草稿里切换思考等级或模型,切换后的值就成为新的默认值:思考等级立即写回所选 Agent 的
model.thinking_level,模型则沿用到你的下一个对话。 - 草稿按用户和 Project 保存所选项、正文和选中的 Skill。草稿里有已输入的文字时再点新建对话,这份草稿会移到侧边栏的草稿分组。
审批模式共四种,见工具与审批。
| 选择器中的名称 | 模式 | 工具调用 |
|---|---|---|
| 全部放行 | allow-all |
全部直接执行,不询问 |
| 全部拒绝 | deny-all |
全部拒绝 |
| 放行只读 | read-only |
只读工具直接执行,其余调用等你审批 |
| 总是询问 | always-ask |
每次调用都等你审批 |
从示例 Prompt 开始
草稿页在输入框下方把示例 Prompt 分放在几个折叠夹里,同一时间只展开一个。点击某一行,这条 Prompt 会填入输入框,但不会发送,你可以先读一读、改一改再发。内置示例还会顺带选中它需要的 Skill。
保存自己的快捷指令
最后一个折叠夹我的快捷指令用来存放你自己的 Prompt,最多 3 条。
- 在输入框里写好 Prompt。
- 在我的快捷指令中选择新建快捷指令。编辑框会带上输入框里的内容,并把第一行建议为名称。
- 保存。
一条快捷指令由名称(最多 40 个字符)和 Prompt(最多 4000 个字符)组成,不绑定 Skill。快捷指令按用户保存在服务器上,换浏览器、换机器都还在。每行都有编辑和删除操作,删除前会确认。保存和删除都等服务器写入成功才收框:被拒绝时编辑框(连同你写下的名称与 Prompt)或那张确认框会留着,原因写在框里,再点一次就是重试。折叠夹标题会显示用量,例如 2/3;存满 3 条后,新建快捷指令这一行不再出现。设这个上限,是为了让它和内置折叠夹一样高。
发送消息
按 Enter 发送,Shift+Enter 换行。输入框为空时,按上、下方向键可以调出你在本 Session 里输入过的消息。
附加图片和文件
- 直接把图片粘贴到输入框。粘贴只接受图片。
- 粘贴很长的文本(超过 20,000 个字符或 400 行,比如一整段日志)时,它会作为文本文件
pasted-<日期>-<时间>.txt加入附件,而不是塞进输入框,输入因此保持流畅;模型仍会读到全部内容。目标模式不接受文件附件,此时照常粘贴为文本。 - 在 + 菜单(更多输入方式)中选择上传图片或上传文件。
附件不限类型。选中的文件按选择顺序以小卡片的形式显示在正文上方,可以逐个移除;只有附件、没有文字的消息也能发送。
大小和数量限制分两个时刻检查:
- 选择或拖入文件时:超过单个文件大小上限(默认 100MB)的文件,或超过 20MB 的图片,会在读取之前被拒绝,提示中写明当前生效的上限。
- 发送时:一条消息默认最多 20 个文件、合计 120MB,超出时发送失败,提示「一条消息附加的文件过多。」或「请求体过大。」
管理员可以在设置 › 上传限制中修改这两个大小。嵌入对话的图片另有 20MB 上限,不随它们变化:这类图片会进入对话和 Trace,此后每次恢复 Session,都要再付出一次它的体积。
发送时,附件写入 Session 的 scratchpad,随 Session 一起删除。对话中显示一条「附加文件」提示;文件内容本身不进入对话,模型用文件工具按路径逐个读取。如果模型不支持图片输入,图片也会这样存进 scratchpad、以文件路径传给模型,输入框上方会给出提示。
把文件拖到对话区
在对话页或草稿页,都可以把文件拖到对话内容或输入框上。
- 拖动经过这个区域时,会出现覆盖整个区域的「松开以添加附件」浮层。拖动文字等非文件内容时不触发。
- 松开即把整批文件加入附件。图片按粘贴图片的方式处理,其余文件成为附件,校验和报错与 + 菜单一致。
- Task 运行期间也可以拖入,这时附件按运行中发送方式发送。
- 目标模式下,拖入的图片照常添加,文件会被拒绝并给出提示。
只有对话区会接收附件。把文件拖到侧边栏、顶栏、其他面板或没有输入框的页面上,什么都不会发生,浏览器也不会跳转去打开这个文件。另一个拖放目标是文件浏览面板,它会把文件上传到 Workspace,见文件面板。文件浏览面板还能把文件、目录或选中的一段内容作为小卡片加进你的消息。
使用斜杠命令
输入 / 打开斜杠菜单,按 Enter 或 Tab 执行高亮的条目。Task 运行或压缩期间,菜单不会弹出。
| 命令 | 作用 |
|---|---|
/compact |
压缩上下文 |
/agent |
把对话交接给另一个 Agent,见交接给其他 Agent |
/model |
用另一个模型开一个新对话,见切换模型 |
/goal |
开启目标模式,见设定目标 |
| Skill 名称 | 选中或取消一个已安装的 Skill;选中的 Skill 随消息一起发送 |
/compact、/agent 和 /model 只在已经开始的对话里出现:草稿没有可压缩的上下文,Agent 和模型也在一开始就选定了。
设定目标
目标模式(在 + 菜单中,或输入 /goal)把你的消息变成一个目标。之后 harness 会一轮接一轮地运行 Task,直到目标完成、受阻或用完 Token 预算;预算可以在目标小卡片上设置。
- Agent 需要安装
goal插件。 - 目标必须是文字。图片可以一起带上,文件附件会被拒绝。
- Task 运行期间不能开启目标模式。
见目标模式。
Task 运行期间
Task 运行时,输入框仍可使用,工具栏上只保留一个操作按钮。输入框为空时它是停止,点击结束 Task;正在进行的压缩也能用它停止。
插话或排队
Task 运行时输入了内容,发送按钮的行为取决于 + 菜单底部的运行中发送方式,这个选择记在当前浏览器里。
- 插话(默认):按钮显示为发送给运行中的 Agent。文字、图片和文件随 Agent 的下一轮送达,消息显示为用户插话。
- 排队:按钮显示为排队为下一条消息。消息先存在服务端,本轮运行结束后作为一条普通的新消息自动发出。在此之前,输入框上方逐条列出排队中的消息(「跟进消息已排队,本轮结束后自动发送:…」)。刷新页面后队列仍在。
有几种草稿不能插话:
- 只选了 Skill,没有文字、图片或文件时,改为排队。
- 已暂存
/agent的选择时,发送会立即打开新对话。 - 已暂存
/model的选择时,发送要等本轮结束:按钮保持为停止,输入框上方有一行说明。
撤回消息
还没送达 Agent 的插话(「插话已排队,将随下一轮送达:…」)和每条排队中的跟进消息,行尾都有一个撤回按钮(弯回的箭头)。点击后,消息连同附件回到输入框,排在你已输入的文字前面,可以修改后重新发送。
- 已经送达 Agent 的插话不能撤回,已经开始发送的跟进消息也不能。
- 如果插话送达之前运行就结束了(常见的情形是工具还在运行时你按了停止),这条消息会连同附件自动回到输入框。
审批工具调用
工具调用需要你审批时,对话里会出现允许和拒绝按钮,它所在的步骤组也会展开。子 Agent 有待审批的调用时,它那一行会显示琥珀色圆点。Session 进行中可以随时更改审批模式,见工具与审批。
把工具调用转入后台
exec_command 或 run_subagent 调用运行满 10 秒后,这一行会出现转入后台执行。点击后调用立即返回一个任务句柄,不会中止任何工作,本轮也不再等它,直接往下进行。结果之后以后台任务通知的形式送达。这一行随后标为 [后台任务],转入后台的命令会出现在会话进程中。
重试或放弃
模型请求失败、harness 要等待 2 秒及以上再重试时,重试提示行会倒计时到下一次尝试。选择立即重试跳过剩余等待,选择放弃结束 Task。
模型供应商拒绝的请求(例如 API key 无效)会以一行错误结束本次运行(「[错误]:模型请求错误:…」)。解决问题后重新发送即可,比如到模型库页更新 key。
切换思考等级
输入框的思考等级选择器提供 low(低)、medium(中)、high(高)、xhigh(极高)和 max(最高)几档。
在已经开始的对话里,选择器显示 Agent 配置的等级(Agent 没有设置时显示「—」),并一直跟随它,直到你自己选一档。在此之前发送消息不带等级,所以对 Agent 设置的修改会持续生效。你选定的等级保存在 Session 上:
- 刷新页面后不变。
- 这段对话之后的每次运行都用它,之后再改 Agent 设置也不影响。
- 不会写回 Agent 设置。
对话中途切换等级会降低提示词缓存命中率、增加成本,所以会先弹出确认框:
- 压缩后切换(推荐):先像
/compact一样压缩上下文,压缩结束后再应用新等级。压缩失败、被中断或无法启动时,等级照样切换,并以提示或报错说明。 - 仍要切换:立即应用。
- 取消:保持当前等级。
压缩只能在对话空闲时启动,所以 Task 运行期间第一项不可用,旁边有说明,另外两项照常可用。对话还没有消息、重选当前显示的等级,或者刚成功压缩完,切换时都不弹确认框。
切换模型
换模型有两种方式,作用不同。
在本对话内
点击输入框工具栏上的模型名称,选另一个模型。Task 运行期间和压缩期间选择器不可用,选当前模型没有反应。会先弹出确认框,因为切换要先用当前模型压缩上下文:
- 压缩并切换:先用当前模型压缩上下文(总是生成摘要,即使 Agent 配置为清空),然后本对话在新模型上继续。压缩失败或被中断时,对话保持在当前模型上。
- 取消:保持当前模型。
刚压缩完或刚切换完时没有可压缩的内容,确认框会说明不会再次压缩,按钮只写切换;还没有消息的对话直接切换。
切换在对话中显示为一条压缩行,后面跟一行「模型已切换 · A → B」标记(没有内容可压缩时只有标记:刚压缩完或刚切换完,或最后一个请求没有完成)。压缩失败只显示失败的压缩行,没有标记。切换完成后,模型徽标、上下文窗口和费用估算都跟随新模型。
开新会话
/model 新开一个 Session 在另一个模型上延续对话,本对话保持不变。
- 在输入框输入
/model,选择一个模型。它以小卡片的形式出现在正文上方,此时还不会发送。 - 可以接着输入要说的话。输入框为空时,会发送「换用新模型继续这段对话」。
- 按 Enter。
新 Session 沿用原来的 Agent、Workspace 和审批模式,开头有一条「换模型新开的会话(原模型 …),延续原会话」横幅,可以点回原对话;模型需要早先的历史时,会自己读取原对话的 Trace 文件。
- 交接要等 Session 空闲,因为新 Session 要从原 Session 的 Trace 接续,而运行中的一轮或压缩还在写这个文件。等待期间,输入框上方有一行说明。
- 要取消,点小卡片上的 ×,或在正文开头按 Backspace。
- 小卡片随草稿一起保存,刷新页面或去别的对话再回来都还在。
交接给其他 Agent
- 在输入框输入
/agent,选择一个 Agent。它以小卡片的形式出现在正文上方,此时还不会发送。 - 输入要一并带过去的消息。
- 按 Enter。
系统会为这个 Agent 打开一个新对话,带上你的文字,并注明是从哪段对话交接来的。输入框为空时,只发送交接本身。和 /model 一样,× 或 Backspace 可以取消,小卡片也随草稿保存。
分叉对话
每条完成的回复下方有一行统计:输入和输出 Token、TPS、用时和成本,然后是回复时间、复制和分叉。宽屏上,鼠标指向回复时才显示这一行;手机上一直显示,但不显示 TPS。只有含文字的回复才提供分叉。
- 选择分叉(从这里分叉对话)。
- 确认。截至这条回复的对话会复制成一个新对话,原对话保持不变。
分叉得到的是一个新 Session,沿用相同的 Agent、模型、Workspace 和审批模式。它的 Trace 和 scratchpad 都是独立的副本,所以即使删除了原对话,图片和文件仍能正常显示。同一对话的多个分叉依次命名为 原标题 (1)、原标题 (2) 等,不随界面语言变化,编号也不会复用。
查看 Agent 的工作过程
- 文字随生成逐步显示,思考块可以折叠。
- 步骤,即思考和工具调用,归在一个标着运行中或运行完毕的分组下,显示步数和用时。分组运行时展开、结束后收起,组内有调用需要审批时会再次展开。
- 工具卡片可以展开查看参数和输出,运行时有实时计时。卡片标题是模型写的说明,或缩短后的文件路径。内置工具用短名显示(
read_file显示为「读取」,完整名称在悬停提示里),可以在设置 › 外观中关闭工具短名。其他工具(含 MCP 工具)始终显示原名。 - 压缩会留下一行,标题就是状态:进行中为压缩中,结束后为压缩完毕(清空上下文时为清空中、清空完毕),并带用时。进行期间,这一行在请求的思考内容到达后出现思考部分,摘要开始生成时出现结果部分,两部分默认折叠,各有自己的用时。压缩结束后这一行收回成一行。压缩失败时,标题保持为压缩(或清空),下面一行写明原因。
- MCP 连接,即首次连接 MCP 服务器,会留下一行,显示发现的工具数,并列出不可用的服务器。展开后每个服务器一组,显示状态、工具数和连接用时;再展开可以看到工具列表或失败原因。
- 子 Agent 各自留下一行,显示头像、名称、短 Session id,运行中带转圈动画,有工具调用待审批时带琥珀色圆点。点击这一行会打开智能体面板:上方是该 Task 的调用图,每个节点显示运行时长;下方是所选子 Agent 的实时对话。嵌套的工具卡片和审批与主对话完全一致,子 Agent 还有自己的输入框,跳转到该会话可以把它作为完整对话打开。当前 Task 派生子 Agent 时,智能体面板会自动打开,每个 Task 只自动打开一次。
更早的消息
打开对话时只加载最近 20 轮。滚动到顶部附近会再加载 20 轮,阅读位置保持不动;某一轮的输出特别大时,一次加载的轮数会少一些。图片随滚动进入视野时才加载。加载失败时,点击「更早的对话加载失败,点击重试」。没有更早的内容时,顶部显示「已是对话开头」。轮次编号和顶部统计都从对话开头算起,与一次加载全部的结果一致。
要回到最新消息,选择回到最新消息。对话较长时,左侧留白处有一列刻度,每个刻度对应一轮问答:指向刻度可以预览,点击即跳转。留白放不下时(例如在手机上),工具栏会出现对话索引按钮,列出同样的内容。
使用侧边面板
对话页有两个放面板的侧栏:右侧栏和下侧栏,用对话工具栏右上角的右侧栏和下侧栏按钮显示或隐藏。空的侧栏会列出可以打开的面板;用添加面板可以再加一个,面板也可以移到另一侧。对话开始后才能使用这些面板,文件浏览除外:在新建对话页上,它浏览为新对话选定的文件夹,入口是工作区胶囊右侧的文件浏览按钮(见文件面板)。
| 面板 | 内容 |
|---|---|
| 智能体面板 | 本 Task 的子 Agent:调用图和每个子 Agent 的实时对话 |
| 文件浏览 | Workspace 中的文件,可预览、编辑和上传,见文件面板 |
| 记忆 | Agent 的记忆 |
| 轨迹观测 | 对话的 Trace 文件:汇总、每轮统计、执行时间线和逐条事件,可以导出 |
| 远程控制 | 把对话绑定到聊天软件,见远程控制 |
| 定时任务 | 按计划向这段对话发送 Prompt 的任务,见定时任务 |
| 终端 | 一个 Shell,见使用终端 |
每段对话会在当前浏览器里记住自己的面板布局,切换对话时恢复。隐藏侧栏不会改变其中的面板,未保存的编辑也会保留。子 Agent 等待审批时,放着智能体面板的那个侧栏按钮上会出现琥珀色圆点;智能体面板没有打开时,圆点在右侧栏按钮上。
想把侧栏拉到最大,点侧栏头部的全屏,或者把它的边界拖过最大宽度(下侧栏为最大高度)。右侧栏随即盖住对话,下侧栏则一直长到工具栏下方;带标题和统计信息的工具栏、左边的侧边栏都保持不动,标签和添加面板照常可用。点同一位置的退出全屏,或把边界拖回来,即可恢复。切换对话、隐藏侧栏、关闭最后一个标签,或者有面板在被它盖住的侧栏里打开时,全屏也会自动结束。
用快捷方式悬浮球打开面板
桌面宽度下右侧栏关闭时,或窄屏下没有打开任何面板时,对话区右缘内侧 32px 处会浮着一个圆形的快捷方式按钮。草稿页不显示它;对话历史正在加载或加载失败时也不显示。
- 点击按钮,或聚焦后按 Enter 或空格键。按钮左侧会展开一圈圆形入口:智能体面板、文件浏览、记忆、轨迹观测、远程控制、定时任务和终端,最后是隐藏悬浮球。
- 指向或聚焦某个入口,按钮下方会显示它的名称。
- 选择入口。桌面宽度下面板在右侧栏打开,窄屏下在底部弹层中打开,按钮随即消失。
几点说明:
- 入口只有图标,没有悬停提示,名称显示在按钮下方。指向或聚焦按钮本身时,下方文字说明点击后的效果:打开或关闭。
- 上、下方向键在按钮和各入口之间移动,Home 和 End 跳到两端。按 Esc、点击别处、滚动或用 Tab 移走焦点,都会收起这圈入口。
- 靠近对话区顶部或底部时,这圈入口会缩短,只显示放得下的部分。
- 按钮可以沿右缘上下拖动,短按仍是点击。松手后按钮贴回边缘,不会停在工具栏或输入框上;它的位置记在当前浏览器里,所有对话共用。
- 右侧栏关闭时,如果有子 Agent 在等待审批,按钮和其中的智能体面板入口上都会出现琥珀色圆点。
- 隐藏悬浮球会让按钮不再出现,同时提示在哪里重新打开:设置 › 外观中的快捷方式悬浮球开关。
使用终端
终端以标签页的形式出现在侧栏里,也可以在独立的 /terminal 页面中打开。
- Ctrl+` 显示或隐藏终端标签页。没有打开的终端时,会接管一个没有被任何对话占用、仍在运行的 Shell,或者新建一个。
- Ctrl+Shift+` 在侧栏里新建一个终端。
- 终端获得焦点时按 Ctrl+Alt+`,确认后关闭这个终端,与点击标签页上的 × 效果相同。这个按键不会传给 Shell;Ctrl+W 则会传给 Shell,是 readline 的删词。
这三个终端按键在 Mac 上同样用 Control 键。
查看 Session 统计
对话工具栏右侧显示 Session 的累计数据:Token、成本和用时。对话还有后台任务时,旁边会多一个图标,并显示任务数量。窄屏上,这些统计合并为一个 Session 信息图标。Task 运行期间,标题旁显示沙漏和运行中。
点击这组统计会打开详情卡片:
- Agent、Model、Session id(旁边有复制按钮)、Workspace 路径,以及 Session 的创建时间。
- 总 Token,含缓存命中率和子 Agent 的用量。
- 成本,只在模型配置了价格时显示;带星号表示部分用量没有价格。
- 用时,括号里有两项,形如
用时 10.3s(API 5s,工具 5.3s)。API 是花在模型请求里的时间,已扣除等待你审批的时间;工具是各次工具执行覆盖的实际时间,并行的工具只算一次。两项是各自独立的测量,并不是对总用时的拆分:后台工具会和模型解码同时进行,审批等待和 harness 开销又不属于任何一项,所以两项之和可能大于、也可能小于总用时。
应用里的复制按钮都在按钮本身给出反馈:图标短暂变成对勾。对话行菜单中的复制 Session ID 则改为弹出「已复制」提示。
会话进程
详情卡片的会话进程列出对话启动的后台进程:超过等待时间仍在运行的命令、用 run_in_background 启动的命令,以及通过转入后台执行转入后台的命令。每行显示命令、启动时间和 pid。检测到进程所服务的地址时,运行中的行会附上链接(取其输出中最后打印的本机 URL,否则取其进程组监听的端口)。
- 停止会结束整个进程组,并把这一行从列表移除。对话会得知这个进程是被停止的,而不是运行失败,模型因此知道服务已经关掉,不会把它当作崩溃去重启。
- 已退出的行标注「已退出」,带移除按钮,可以把这一条从列表中删除。
[!WARNING] 移除进程立即生效,且不可撤销。它捕获的输出会一并删除,之后无法再让模型读取这些输出。输出还有用的话,请先保留这一行。
管理上下文
工具栏右侧的上下文圆环显示上下文的占用程度,标尺是压缩触发的位置:Agent 的 compaction.max_context_length,但不超过模型窗口允许的大小。占用超过 80% 时变成琥珀色,超过 95% 时变成红色。刚压缩完时圆环是空的,要等下一次请求回报用量。
点击圆环打开上下文面板:
- 已用量与阈值。
- 一条与模型完整窗口等长的横条(下方标着「最大上下文 N」),按系统提示词、工具定义、用户消息、模型消息、工具请求和工具结果分段。点击某一段或某个图例行会保持高亮,再点一次取消。
- 工具用量 Top 5 或文件用量 Top 5,用工具和文件按钮切换。文件只列文件名,悬停可以看到完整路径。
横条上的虚线标记就是压缩阈值。虚线右侧的斜纹部分是模型还有、但 Session 暂时用不到的空间,因为压缩会先触发。
修改压缩阈值
- 拖动虚线标记,或者聚焦后按左、右方向键:每按一次移动 1,000 Token,按住 Shift 时移动 10,000。
- 松开鼠标或按 Enter,弹出修改压缩阈值对话框,数值仍可修改。按 Esc 取消。
- 确认。新阈值写入 Agent,并立即对这段对话生效,运行中也不例外。
填入超过模型窗口的值也会被接受,同时提示实际生效的是窗口大小。如果模型窗口本来就小于 Agent 的阈值,输入框上方会出现提示,并提供打开 Agent 设置和忽略两个按钮。
整理对话列表
侧边栏列出当前 Project 的对话。搜索会话按标题筛选已经加载的对话。
在列表选项(列表顶部的滑块图标)中:
- 分组方式:按工作区分组(默认)、按智能体分组或按时间分组(分为近一天、近一月和更早)。
- 排序方式:最近更新或手动排序(拖动行来排序)。手动排序只在使用鼠标或触控板时提供。
旁边的按钮随分组方式变化:新建工作区、创建 Agent 或新建对话。分组可以置顶,也可以拖动调整顺序;分组上的 + 按钮用来在该分组里新建对话。
按工作区分组时,系统自己创建的目录会并入同一个临时工作区分组:一种是没有选择 Workspace 时对话自动得到的目录,另一种是评估为每道题目、每次运行创建的测试 Workspace。两者都直接位于 Agent 的 workspaces/ 目录下,这个目录下的所有目录都归入该分组。
行操作
- 鼠标指向某一行时,行尾的最近活跃时间换成两个按钮:归档和更多(…)。用 Tab 移到这两个按钮上时也会显示。
- 右键点击这一行、在触屏上长按、按 Shift+F10,或者选择更多,都能打开行菜单:置顶、重命名对话、远程控制(见远程控制)、归档、复制 Session ID 和删除对话。按 Esc、点击别处或滚动列表会关闭菜单。
- 删除对话需要确认,删除后对话的消息和 Trace 会被永久移除。
只有在对话行和文件浏览面板里,右键菜单才会替代浏览器自带的菜单。置顶的对话排在所属分组的最前面。置顶只在活跃列表中提供,置顶状态按 Project 记在浏览器里。
行标记
| 标记 | 含义 |
|---|---|
| 翻转的沙漏 | Session 正在运行 |
| 向中线合拢的横条 | Session 正在压缩 |
| 绿点 | 有一次运行已经结束,你还没有查看;只出现在你自己的对话上,后台会话中的会话不显示 |
| 绿色小活动波形 | Session 仍有后台任务:超过等待时间仍在运行的命令,或正在跑一轮的后台子 Agent。悬停提示会显示数量,例如「2 个后台任务」 |
| 琥珀色数字 | 有工具调用等待审批 |
| 置顶标记 | 对话已置顶 |
| 远程控制图标 | 这段对话已启用消息软件连接 |
| 闹钟 | 绑定到这段对话的定时任务还会触发,见定时任务 |
插头、日历、两个机器人或 >_ 提示符 |
在后台会话折叠夹中,表示是什么打开了这个 Session:Agent API、定时任务的一次运行、父 Agent 或 penguin run |
后台任务标记与其他标记互不影响:对话已经空闲、但 dev server 还开着时,标记仍在;最后一个后台任务结束的那一刻标记就会消失,无需刷新。
折叠夹
每个分组的活跃对话下方是它的两个折叠夹:后台会话和已归档,各自在展开时才加载其中的对话。按时间分组时,整个 Project 共用一组折叠夹,加载更多会话用来加载更早的对话。
- 后台会话收纳由程序而不是你打开的 Session:外部程序经 Agent API 开出的会话、定时任务的每次运行、子 Agent 会话,以及
penguin run创建的会话,其中包括评估为每道题目、每次运行启动的测试 Session。每一行都带一个标明来源的图标(API、定时任务、子智能体或 CLI),悬停时显示。 - 已归档收纳所有已归档的对话,无论来源。
- 公司模式的工位会话与工单会话不在其中任何一处,归档与否、哪种模式下都一样:它们只列在公司模式自己的页面里。
- 打开后台会话时,它所在的折叠夹会自动展开。最近一次对话以及删除当前对话后跳转到的对话,都只会是你自己的对话,不会是后台会话或公司模式的会话。
- 只有折叠夹、没有活跃对话的分组(例如只跑过评估的 Agent)默认折叠,排在其他分组之后(置顶的分组除外),分组标题变浅,并显示折叠的对话数。展开过一次后,在这个 Project 中会一直保持展开。
分组里的活跃对话和每个展开的折叠夹,一次都显示 10 条。展开其余 N 个对话每次再显示 10 条:先显示已经加载的,不够时才向服务器取。显示超过 10 条后,收起可以折回前 10 条。分组超过 10 个时,列表每页显示 10 个分组,下方有翻页控件。
快捷键
| 按键 | 作用 |
|---|---|
| Enter | 发送消息,或执行高亮的斜杠命令 |
| Shift+Enter | 换行 |
| 上 / 下方向键 | 输入框为空时,调出本 Session 输入过的消息 |
| Tab | 执行高亮的斜杠命令 |
| Backspace | 在正文开头按下时,移除暂存的 /agent 或 /model 小卡片 |
| Shift+F10 | 打开当前聚焦的对话行或文件浏览面板的右键菜单 |
| Esc | 关闭菜单;收起快捷方式悬浮球;取消待确认的阈值修改 |
| 左 / 右方向键 | 聚焦压缩阈值标记时,每次移动 1,000 Token(按住 Shift 为 10,000) |
| Ctrl+Alt+S | 打开侧边栏的搜索会话 |
| Ctrl+Alt+N | 新建对话 |
| Ctrl+Alt+1 | 显示或隐藏侧边栏 |
| Ctrl+Alt+2 | 显示或隐藏右侧栏 |
| Ctrl+Alt+3 | 显示或隐藏下侧栏 |
| Ctrl+` | 显示或隐藏终端标签页 |
| Ctrl+Shift+` | 新建终端 |
| Ctrl+Alt+` | 确认后关闭当前聚焦的终端 |
| Ctrl+S | 在文件浏览面板的编辑器或手册中保存 |
在 Mac 上,Ctrl+S 以及终端之外的 Ctrl+Alt 组合里,Ctrl 换成 ⌘(⌘S、⌥⌘S);三个终端按键在 Mac 上同样用 Control 键。从 Ctrl+Alt+S 起的各行都是缺省组合,可以在系统设置 › 快捷键中修改。
限制
| 项目 | 限制 |
|---|---|
| 嵌入对话的图片 | 20MB,与附件上限分开 |
| 每条消息的附件数 | 20 个文件 |
| 附件大小 | 默认单个文件 100MB、单条消息合计 120MB;管理员可在上传限制中修改 |
| 快捷指令 | 每个用户 3 条;名称最多 40 个字符,Prompt 最多 4000 个字符 |
| 历史消息 | 打开时加载最近 20 轮,之后每次加载 20 轮;每次加载的消息最多 4 MiB,但至少一轮 |
| 对话列表 | 每个分组或折叠夹一次显示 10 条对话;每页 10 个分组 |
| 转入后台执行 | 调用运行满 10 秒后提供 |
| 重试倒计时 | 等待 2 秒及以上时显示 |
| 上下文圆环 | 超过 80% 为琥珀色,超过 95% 为红色 |
工作原理
你在对话中的一些操作会以结构化文本的形式写进对话,查看 Trace 时可能会注意到:
/model开的新 Session,第一条消息以[model_switch_from]块开头,写明原 Session、它的标题、Trace 文件、Workspace,以及原来的供应商和模型,后面跟着你的消息。新对话把这个块显示为「换模型新开的会话」横幅。在本对话内切换模型不写这个块:它记录为一次普通压缩,新上下文的session_meta记录新模型。- 插话以
[user_steering]用户消息的形式,随 Agent 的下一轮送达。 - 选中的 Skill 放在
[use_skills]块里随消息发送。 - 每个附件会在消息里加一行
[attached file: <path>]。