hanafubuki-agent

终端界面

Fullscreen 与 Scrollback、界面布局、按键、输入框、斜杠命令、首次设置、设置中心及其页面、旁路对话及其窗格、子代理和指挥中心、@ 和 $ 提及、阅读、选择和复制对话、对话记录、编辑之前的消息、审批与提问,以及恢复会话。

不带子命令运行 hanafubuki-agent 会打开终端界面。后面跟上一段文本时,它会作为第一条消息发送:

hanafubuki-agent
hanafubuki-agent "找出这个项目里没有测试覆盖的模块"

界面启动时没有会话:发送第一条消息时才创建会话,需要会话的命令(/model、/effort、/mode、/compact、/status、/context)也会先创建一个。只是启动再退出不会留下空会话。没有默认 Provider 或没有选择模型时,界面会打开首次设置,而不是让第一条消息失败。因其他原因无法创建会话时,对话中会用红色说明原因,界面保持打开,下一条消息会再试一次。

新的空对话在空间足够时会显示猫娘 Hana 的彩色点阵动画。居中姿态要求窗格至少有 64 列,且输入框上方在标题和提示之外还空出 18 行。居中姿态适当加宽,放平的手贴着输入框上沿。她先淡入,再以八秒为周期轻轻摆动、眨眼、偶尔动一下猫耳。输入内容时淡出,清空草稿后重新出现;发送消息或开始回合后,本次会话不再显示,包括执行 /clear 后,/new 则可以再次显示。窗口过小、首次设置及弹出界面优先占用空间。Fullscreen 和 Scrollback 均支持,动画不会保存进会话历史,也不会发送给模型。

在 /config interface 或 /tui 中,通过 Welcome mascot(tui.welcomeEnabled,默认开启)和 Welcome mascot theme(tui.welcomeTheme)控制开屏点阵图。默认 random 在每次新空会话中随机选择一次;固定选项为 center、left_peek、right_sleep、right_read、lower_left,分别是加宽后的居中姿态、左侧边缘探头、右侧睡觉、右侧读书和左下角半露头。每种姿态有自己的位置和最小显示尺寸,较小的姿态所需空行更少。设置即时生效并遵循配置层优先级,不会让已开始对话的形象重新出现;关闭后停止动画刷新。/theme 与同一全局设置页的 Syntax theme 共用注册的 tui.theme 设置及预览选择器。

终端界面需要标准输入和标准输出都是终端;在管道或重定向中运行时,它会提示改用 exec 并以退出码 2 退出。-m、-C、--add-dir、--permission-mode 等全局选项同样适用。

Fullscreen 与 Scrollback

界面以两种方式之一显示对话,启动时决定,直到退出都不变:

  • Fullscreen(默认):界面占用终端的备用屏幕,在底部区域上方自己绘制对话。滚动、选择、搜索和复制都在界面内完成(见阅读对话),退出后对话不会留在终端里。
  • Scrollback:界面占据终端的下部,对话写进上方终端自己的滚动历史中,所以可以像普通命令输出一样向上滚动、选择和复制,退出后也会留在终端里。最新的条目留在界面绘制的部分,即尾部,在写入之前像 Fullscreen 一样就地更新和展开(阅读对话)。

除非下列设置另有要求,界面以 Fullscreen 启动,按顺序第一条适用的生效:

  1. 命令行中的 --no-alt-screen:本次运行使用 Scrollback。
  2. tui.alternateScreen = "never":使用 Scrollback。"auto"(默认)在 SSH 会话中(设置了 SSH_TTY 或 SSH_CONNECTION)使用 Scrollback,"always" 从不。
  3. tui.fullscreenTranscript = false:使用 Scrollback。/tui 在设置中心中打开它。

这些键见配置参考。

两种方式下,调整终端大小后对话都会按新的宽度重新排版:Fullscreen 立即进行,Scrollback 在大小稳定片刻后把对话重新写入终端(阅读对话、渲染)。

界面布局

Fullscreen 下,对话占满底部区域上方的屏幕。Scrollback 下,界面绘制底部区域和它上方对话最新的条目(尾部),对话的其余部分在更上方的滚动历史中。

启动时(以及 /new 和恢复会话时),先在左上角显示一个信息框,包含版本、模型和工作目录;有新版本时也在这里显示更新提示(更新)。会话还没有创建时,显示的是它将使用的模型:-m 指定的,否则是配置中的。底部区域从上到下是:

  1. 状态行:回合进行中显示 • Working 25s • esc to interrupt,包括已用时间;回合思考过之后显示 • Working 25s (Thinking 20.7s) • esc to interrupt,括号中是整个回合到目前为止的思考时间,只在模型思考时增长(思考过程)。模型请求重试时改为 Reconnecting 1/3: 原因。等待审批或回答问题时,工作计时暂停。状态行在整个回合中保持显示,模型输出回答时也是。
  2. 等待中的消息:有消息在等待回合时显示(见下文)。回合进行中,回合读取了这些消息之后,它们占用的行留作空行,直到回合结束,所以上方的对话不会每次都移动。
  3. 输入框:以 › 开头。
  4. 底栏:状态栏默认显示模型及其推理强度、工作目录和会话标题。下一行单独显示可用的 ← for agents · ? for shortcuts。草稿排队、退出、历史翻页(esc latest)、选择和搜索等提示也显示在状态栏下方。回合运行中输入草稿时显示 tab to queue message。

审批、提问以及 /model 和 /mode 的选择列表打开时,会暂时替换状态行和输入框。回合结束时,选择列表保持打开;/model 的列表在任何 Provider 回答之前就打开,随每个 Provider 的回答填入(模型列表)。各项设置(包括 /providers 和 /mcp)都在全屏的设置中心中。

对话记录中,你的消息以 › 开头;工具调用在开始的位置显示为 • Running 工具名: 对象(命令显示为 • Running 命令;对象是它作用的东西:命令行、路径、查询),并在原处就地变为它做了什么,默认折叠:• Ran cargo test 加输出的最后几行、• Edited src/lib.rs (+12 -3)、• Read src/lib.rs (lines 1–120)、• Called 工具名 加它返回内容的前几行(工具调用);思考显示为 • Thinking 3.4s,之后变为 • Thought · 20.7s(思考过程);任务计划显示为 • Updated Plan · 1/5 complete 和它的步骤;错误以红色的 ■ 开头。调用过工具或更新过任务计划的回合成功完成时,会在回答之后显示一次 ─ Worked for 1m 05s ─ 分隔线,回合思考过时为 ─ Worked for 1m 05s · thought for 20.7s ─。中途的进度消息照常流式显示,不插入这条分隔线;中断或失败的回合、纯文本回合以及 ! shell 命令也不添加它。

按键

按键作用
Enter发送消息:开始新回合;回合进行中则作为补充消息,在下一步引导它(见下文)。在弹出列表中选择当前项
Tab回合进行中,把消息排入队列,等回合结束后发送;没有回合运行时,和 Enter 一样发送。在命令列表中补全命令名;在文件列表中插入文件路径
Shift+Left、Alt+Up把最后一条待发消息放回输入框供你修改:优先是回合还没发出的 steering,其次是最后一条排队的消息,再次是为回合结束保留的消息
Shift+Enter、Ctrl+J换行。Shift+Enter 需要终端支持增强键盘协议,否则请用 Ctrl+J
Up、Down(Ctrl-P、Ctrl-N)输入框为空时,翻看本次运行和之前会话中的最近输入;在弹出列表中移动
Ctrl-R搜索发送过的消息,包括本次运行和之前的会话中的(见下文)
Ctrl-V(WSL 下为 Ctrl-Alt-V)把剪贴板中的图片作为 [Image #1] 附加到消息;剪贴板中只有文本时,粘贴文本(见下文)
Ctrl-G在你的编辑器(VISUAL 或 EDITOR)中编辑草稿(见下文)
Esc关闭弹出列表;否则中断正在运行的回合,并立即发送回合还没读到的补充消息。没有回合运行时,在空输入框上按两次:编辑之前的消息(见下文)
Ctrl-C依次:在审批中拒绝;清空有内容的输入框;中断正在运行的回合;1 秒内再按一次则退出
Ctrl-D输入框为空时,1 秒内按两次退出;输入框有内容时向后删除一个字符
Ctrl-TFullscreen:就地显示对话的详细内容;Scrollback:打开对话记录(见下文)
Ctrl-O展开对话中的每一次思考;全部已展开时,全部折叠(见下文)
Left(输入框为空时)打开指挥中心
?(输入框为空时)显示或隐藏快捷键说明(见下文)
Shift+Tab在默认模式和计划模式之间切换会话,和 /mode 一样;回合进行中不可用
Alt+, 和 Alt+.把推理强度降低或提高一档
Alt+Left 和 Alt+Right(输入框为空时)显示会话及其子代理中的上一个或下一个;输入框有内容时按词移动
Ctrl+/在当前选中的 agent 与已打开的旁路对话之间切换焦点
Ctrl-X P打开预设
Ctrl-X Left、Right、Tab、X打开了旁路对话或子代理时:主对话、旁路对话、另一个对话;关闭它(见下文)

Fullscreen 下还有阅读对话的按键:Page Up/Page Down、F3、F4、Ctrl-Space 等,见阅读对话;Scrollback 下,F4 聚焦尾部的活动。

以上是默认按键。按键映射可以修改其中各个动作的按键(Enter、Tab 排队、Shift+Left 编辑排队的消息、历史及其搜索、粘贴图片、外部编辑器、Esc 中断、Ctrl-T、Ctrl-O、?、Shift+Tab、Alt+, 和 Alt+.、Alt+Left 和 Alt+Right、编辑键、对话和分页器的按键、指挥中心的会话操作);Ctrl-C、Ctrl-D 以及弹出列表和列表自己的按键(包括 Tab 的补全)保持不变。

输入框支持常见的 Emacs 风格编辑键:Ctrl-A/E 到行首/行尾,Ctrl-W 删除前一个词,Ctrl-U/K 删除到行首/行尾,Alt-B/F 按词移动等。

无论回合在做什么,Esc 都会中断它,包括模型正在输出回答的时候。Esc 从不发送输入框中的草稿:有补充消息在等待时,把它们作为下一个回合发送;否则等待中的消息回到输入框(见下文)。

快捷键说明

在空输入框上按 ?,输入框下方按三组显示按键:窗口足够宽时三组并排,否则分两列或一列;再按 ? 隐藏,输入框接收的按键(输入文字、Enter、方向键)也会隐藏它。每个按键都是按键映射当前给这个动作的按键:改绑的按键显示新的按键,取消绑定的动作不显示。多数提示只显示单键;后台任务也会显示其配置的组合键,默认为 leader t。

  Keyboard shortcuts

  Compose                        Session                                        Transcript (open first)
  /         Commands             tab                Send message                ctrl + t                           Open transcript
  @         Mention files        shift + tab        Change mode                 f3                                 Find text
  !         Shell command        alt + ,            Less reasoning              pgup / pgdn                        Scroll
  ctrl + j  New line             alt + .            More reasoning              ctrl + space                       Start selection
  ctrl + v  Paste image          ←                  Agents (empty prompt)       ctrl + home / ctrl + end           Top / latest
  ctrl + g  External editor      leader t           Background tasks            shift + alt + , / shift + alt + .  Top / latest
  ctrl + r  Search history       alt + ← / alt + →  Subagents (empty prompt)
  esc esc   Edit last message    f4                 Inspect activity
                                 ctrl + c           Quit

  /keymap customize
  • Compose:! 运行 shell 命令,Ctrl+V 附加剪贴板中的图片(WSL 下显示为 ctrl + alt + v,那里的终端用 Ctrl+V 粘贴文本),Ctrl+G 在你的编辑器中编辑草稿,Ctrl+R 搜索发送过的消息(见下文);终端能区分 Shift+Enter 时,换行键显示为 Shift+Enter。Session:回合进行中,Tab 显示为 Queue message,Ctrl+C 显示为 Interrupt。Transcript:阅读对话的按键(阅读对话),Fullscreen 下在输入框旁边就能用,Scrollback 下在 Ctrl+T 打开对话记录之后使用。
  • 在旁路对话或正在显示的子代理中,模式、推理强度和编辑之前的消息属于主对话,不显示。
  • 屏幕高度不够全部显示时,列表被截断,并提示 … more: /keymap;/keymap 列出所有动作。
  • Shift+Tab 在回合进行中不可用,和 /mode 一样。Alt+, 和 Alt+. 在 /effort 提供的档位之间切换(见下文)。Alt+Left 和 Alt+Right 在会话及其子代理之间循环切换(见下文)。

输入框

在草稿里点击会把光标放到点击处,落在该行显示的列上,所以长消息是在你看到的地方修改,而不是用方向键移过去。在草稿上滚动滚轮会按行移动光标,文本随之滚动。

  • 粘贴:超过 1000 个字符的粘贴内容在输入框中显示为 [Pasted Content 1234 chars] 占位符,发送时展开;删除占位符就删除了这段粘贴。
  • 图片(与 Codex 相同):按 Ctrl-V 把剪贴板中的图片附加到消息中光标所在处,显示为 [Image #1],之后依次是 [Image #2] 等;WSL 下改用 Ctrl-Alt-V,因为那里 Ctrl-V 是终端的粘贴。在文件管理器中复制的图片文件按原位置附加;图片本身(截图、在浏览器中复制的图片)保存为 PNG,即 clipboard-1.png 等,放在界面在系统临时目录中创建的一个目录里。WSL 下 Linux 看到的剪贴板不是 Windows 的,因此会通过 PowerShell(先 powershell.exe,再 pwsh)取得 Windows 剪贴板中的图片。粘贴的内容如果正好是一个图片文件的路径(带引号、空格转义、file:// URL,或者 Windows 路径,WSL 下读作对应的 /mnt/c/… 路径),同样附加该文件,后面跟一个空格;指向其他内容的路径保持为文本。消息可以只有图片。占位符是一个整体:Backspace 会整个删除它,同时去掉它的图片(并删除它的 PNG),后面的图片重新编号。模型读到的消息在你放置的位置保留这些标签,图片按顺序跟在消息之后,所以 compare [Image #1] with [Image #2] 能指明它们;对话中显示这条消息,并为每张图片显示一行 [Image #1: clipboard-1.png]。Agent 在消息发送时读取每张图片并保存自己的副本:回合开始后,或者对补充消息而言,模型读到它之后,PNG 就被删除;界面退出时,目录连同其中剩下的文件一起删除。只能附加 PNG、JPEG、GIF 和 WebP 图片,每张不超过 20 MiB 和 4000 万像素,每条消息最多 8 张;超出的会立即被拒绝并说明原因(photo.bmp is not a PNG, JPEG, GIF or WebP image, the formats a model is sent.、… is too large to attach: …、A message carries at most 8 images; remove one first.),路径则保留为文本。剪贴板中只有文本、没有图片时,像终端的粘贴一样粘贴文本;两者都没有时,Ctrl-V 提示 There is no image on the clipboard.;没有可读的剪贴板时(没有显示服务,或者通过 SSH 使用的终端,其剪贴板属于另一台机器),提示 The clipboard cannot be read (…); save the image to a file and paste its path instead.。有些终端在剪贴板中是图片时发送一次空的粘贴,这同样会附加剪贴板中的图片,没有图片时什么也不提示。弹出列表或历史搜索打开时,Ctrl-V 不起作用;! 命令不带图片(A `!` command takes no images.)。已知会话的模型不读图时,带图片的消息留在输入框中(This model does not read images (reported); remove the image or switch with /model.,见图片);没有任何来源说明时照常发送。Up、Down 和 Ctrl-R 取回本次运行的消息时连同其图片一起取回,PNG 已被删除的图片连同标签一起略去;更早会话中的消息取回时不带标签,因为它的图片不会被读回。放回输入框的消息,或者合并为一条发送的消息,都保留各自的图片,并按顺序重新编号。Ctrl-G 把标签原样交给编辑器:标签留在原处或被移动,都保留其图片;标签被删除则去掉其图片,其余的重新编号。按键映射中的 composer.paste_image 可以改绑 Ctrl-V 和 Ctrl-Alt-V;在 Windows 上 Ctrl-Alt-V 是 AltGr,不会粘贴图片。
  • 历史(与 Codex 相同):输入框为空时,Up 调出最新输入,再按则调出更早的输入;Down 向更新的输入移动,越过最新一条后清空输入框。Ctrl-P 和 Ctrl-N 的作用相同。先翻看本次运行的消息和已执行的 / 命令(保留参数,也包括被 Ctrl-C 清空的草稿),再翻看之前会话中的最近输入,包括恢复的会话,范围与下文 Ctrl-R 使用的有界历史相同。已出现在本次运行中的文字不会在持久化历史中重复显示。调出的文字未修改时,光标在开头或末尾都可以继续翻看;光标在文字内部或内容已修改时,上下键正常移动光标。调出 / 命令时不会打开补全列表,因此可以继续用这些按键翻看历史;编辑命令后恢复补全。有弹出列表时,这些按键优先操作列表。/ 命令只保留在本次运行中;从补全列表执行时记录完整命令名称,单纯按 Tab 补全不会记录。第一次按 Up 或 Ctrl-R 会在后台读取一次持久化历史;等待时开始编辑、粘贴或恢复的草稿,不会被稍后读到的历史覆盖。
  • 搜索历史:按 Ctrl-R,输入框下方一行变为 reverse-i-search:(与 Codex 相同)。输入或粘贴要找的内容,不区分大小写;输入框会在草稿的位置显示包含它的最新一条消息,并高亮找到的文字。搜索先查本次运行中提交过的消息和 / 命令,再查你在 Agent 各个会话中发送过的内容,从最新的开始:消息、补充消息和按输入原样记录的 ! 命令,最多最近 1,000 条,相同的文字只出现一次;子代理的会话不包括在内。这些内容只在第一次按 Up 或 Ctrl-R 时读取一次,读到之前搜索行显示 searching。Ctrl-R 或 Up 显示更早的匹配,Ctrl-S 或 Down 显示更新的匹配,到头时保持当前的匹配。Enter 把匹配放进输入框供你修改,并不发送;Esc 或 Ctrl-C 关闭搜索,把草稿原样放回,回合进行中也一样,回合会继续运行。找不到时这一行显示 no match,并显示你的草稿。Backspace 删除搜索内容的一个字符,Ctrl-U 删除全部。搜索期间交还给输入框的消息(被中断的回合中等待的消息)放进 Esc 放回的草稿中。按键映射中的 composer.history_search 可以改绑 Ctrl-R;搜索中的其他按键保持不变。
  • 在编辑器中编辑:按 Ctrl-G,在你的编辑器中打开草稿(与 Codex 相同):使用 VISUAL 中的命令,没有则用 EDITOR 中的,取界面启动时的值;设为空的变量视为未设置。命令可以带参数和引号,例如 code --wait:在 Windows 上按 Windows 命令行的规则解析,反斜杠是路径的一部分,并且程序会结合扩展名在 PATH 中查找,所以 code 能找到 code.cmd。草稿(其中的大段粘贴已展开)写入一个临时 .md 文件,界面把终端交给编辑器并等待它退出:期间离开 Fullscreen 的屏幕并交还终端的各种模式,之后再收回。输入框下方一行显示 Save and close external editor to continue.,在 Scrollback 下,编辑器在另一个窗口中打开草稿时可以看到;这种编辑器必须等窗口关闭后才退出(code --wait)。编辑器成功退出后,它保存的内容成为草稿,末尾的空行被去掉;原样带回的大段粘贴重新显示为占位符(改过的则保留为文本)。没有设置编辑器时,界面提示 Set VISUAL or EDITOR to edit the message in an editor.;找不到编辑器、无法启动、以错误退出,或文件不再是文本时,对话中会说明原因,草稿保持不变。弹出列表或历史搜索打开时,Ctrl-G 不起作用。回合进行中也可以使用:回合继续运行,编辑器关闭后对话再显示它做了什么。编辑器在另一个窗口中打开草稿时,终端处于普通模式:此时在终端中按 Ctrl-C 会停止界面,就像停止 shell 运行的任何程序一样。按键映射中的 composer.external_editor 可以改绑 Ctrl-G。
  • 引导正在运行的回合:回合进行中按 Enter 发送的消息交给正在运行的回合,模型在下一步读到它:正在进行的工具调用完成之后,或者给出回答之后,回合会接着进行。在此之前,它显示在输入框上方的 Messages to be submitted after next tool call (press esc to interrupt and send immediately) 之下;模型读到之后,它才写入对话。多条消息按顺序发送。回合还没开始时按 Enter,消息会排入队列(见下文)。
  • 排队消息:回合进行中按 Tab,消息排入 Queued follow-up inputs;没有回合运行时,Tab 和 Enter 一样直接发送。用 Tab 输入的命令和 Enter 一样立即执行。回合结束后,排队的消息从最早的一条开始,每条各开始一个回合,依次进行,回合失败后也一样。Shift+Left(或 Alt+Up)把最后一条待发消息放回输入框,放在草稿之前,供你修改:优先是回合还没发出的 steering(Messages to be submitted after next tool call),其次是最后一条排队的消息,再次是为回合结束保留的消息。已经发给回合的 steering 不会被取回,因为 Agent 已经持有它;回合结束后、或 Esc 已把它们安排为立即发送时,也不再取回。待发送消息被消费、发送或取回编辑时,预览立即收缩,不在 Working 与输入框之间保留空行。
  • 不会丢失消息:回合没有读到的补充消息(回合先结束了、失败了,或 Agent 拒收了这条消息)会在回合结束时发送,等待期间显示在 Messages to be submitted at end of turn 之下;多条会合并成一条消息,先于排队的消息发送。
  • 中断:有补充消息在等待时按 Esc,会中断回合并立即把它们合并成一条,作为下一个回合发送(Model interrupted to submit steer instructions.);队列和你的草稿保持不变。Ctrl-C,或没有补充消息等待时按 Esc,只中断、不发送:等待中的消息(补充消息、等待回合结束的消息和排队的消息)回到输入框,每条一行,放在草稿之前。
  • Shell 命令:以 ! 开头的消息把其余部分作为 shell 命令运行,单独占一个回合,不询问模型(与 Codex 相同)。它通过 exec_command 工具在会话的沙箱和工作目录中运行,直到退出,最长为命令超时(pluginOptions.execution.commandTimeoutMinutes)、工具超时(toolIdleTimeoutSeconds)(未配置时各为 10 分钟)以及嵌入宿主设置的回合期限(默认不设)中最短的一个,所以只调高命令超时并不能让它运行更久;按 Esc 会停止它,终止它的进程。草稿以 ! 开头时,输入框下方一行显示 ! shell command · runs in the session's sandbox。输入命令本身就是批准,所以无论权限模式如何都不会弹出询问;插件中总是要求由人决定的审批规则仍会询问。git clone 的规则(哪些操作需要审批)读取的是命令的程序和参数,而不是 shell 脚本,所以 !git clone … 不会询问就运行。它显示为 • You ran ls 加上它的输出(工具调用)。没有模型可以请求越出沙箱,所以被沙箱阻止的命令(断网时的安装、写入可写根目录之外)直接失败;失败的命令会多一行,说明 ! 命令在会话的沙箱中运行(/permissions)。从你的下一条消息起,模型就能读到它:命令、退出码、耗时和输出。只输入 ! 会显示用法(Prefix a command with ! to run it locally)。回合进行中,命令会被拒绝(A turn is running; wait for it or interrupt it first.)并留在输入框中;Plan 模式下也会被拒绝。命令运行时发送的消息会等它结束,和按 Tab 排队一样。Up 和 Down 会按输入时的样子调出它,Ctrl-R 也能找到它,之后的运行中也一样。
  • 每个对话各有一个队列:主对话、旁路对话和正在显示的子代理各自排队,在后台的对话也会继续处理它的队列。旁路对话关闭或离开子代理时,它等待中的消息随之丢弃。有回合运行或有消息等待时,不能把对话切换到另一个会话(/new、/resume、编辑之前的消息)。

斜杠命令

以 / 开头的消息是命令。输入 / 会弹出命令列表,并随输入的名字缩小范围。

命令作用回合中
/model从已启用 Provider 的模型中选择本会话的模型:列表立即打开,每个 Provider 回答后填入它的模型,每个模型显示窗口以及是否思考、是否读图(模型列表)。/model forget 遗忘 Provider 的拒绝教给会话模型的信息(遗忘学到的信息)不可用
/effort [level|default]选择本会话的推理强度:该模型已知的档位,然后是 Default(Provider 的默认值)和 Custom(手动输入);没有已知档位时只有 Default 和 Custom。/effort LEVEL 和 /effort default 直接设置(见下文)不可用
/providers [policy]在设置中心打开 Provider:添加、编辑、测试和删除,把其中一个设为默认并选择新会话使用的模型;/providers policy 打开模型策略(见下文)可用
/mode在默认模式和计划模式之间选择不可用
/role [name]在轮次之间给会话一个角色;不带名字时从可用角色中选择(见下文)不可用
/permissions [mode]选择本会话的权限预设(Read only、Default、Auto-review,或确认后的 Full access);带预设或模式时直接设置(见下文)可用
/approve列出本会话中被自动审查拒绝的操作(最近十个);选中的一个获准重试一次(见下文)可用
/setup-default-sandboxWindows:通过 UAC 初始化或修复提升沙箱,成功后保存 elevated/workspace-write 默认配置。随后用 /permissions 选择当前会话预设(沙箱)。不可用
/skills列出 Skill、它们是否启用,以及目录中的问题可用
/rename [name]重命名会话:打开填有当前标题的输入框,模型给出的建议标题到达后显示出来;带名字时直接重命名(见下文)不可用
/new离开当前会话,下一条消息开始一个新会话(默认模式),之前的会话保留在历史中不可用
/archive确认后归档会话并离开它,与 /new 一样不可用
/delete确认后永久删除会话及其子会话,并离开它不可用
/resume [id|title]打开恢复选择器(见下文);带会话 ID 或标题时直接恢复该会话不可用
/fork [name]把会话当前的状态复制成一个新会话,给了名字时用它命名,之后在副本中继续;在 Git 仓库中会先询问副本在这里运行还是在新的工作树中运行不可用
/worktree在新的 Git 工作树中继续当前对话或开始新对话,或浏览工作树(见下文)不可用
/init让 Agent 为仓库写一份 AGENTS.md 贡献指南;已有的 AGENTS.md 不会改动不可用
/compact立即压缩会话的上下文,与自动压缩相同;有压缩在后台运行时,等待并采用它(期间开始的轮次可能先采用它:/compact 随之结束)不可用
/compression [cache]会话的分层压缩:它的块、尚可折叠的范围和节省的 token;cache 显示它的缓存报告可用
/recap由会话的模型简要回顾对话,有下一步时一并给出不可用
/review [instructions]在只读的子会话中评审仓库的改动,并把发现报告到对话中:打开目标选择器,或按你的要求评审(见下文)不可用
/side [message]、/btw打开会话的旁路对话,或再次显示它,并把消息发到那里;/side close 关闭它(见下文)可用
/subagents列出会话的子代理及其状态,并用其中一个代替会话显示(见下文)可用
/agents指挥中心:会话及其状态,按标题分组,可以打开、新建(也可以在新工作树中)、分叉、重命名、停止、置顶、隐藏、归档或删除(见下文)可用
/goal [objective]显示会话的目标及可做的操作,或设置目标;clear、pause、resume、edit(见下文)可用
/copy复制最后一个回答,或其中的某个代码块或引用;Fullscreen 下还可以在对话中选择任意部分可用
/export [path]把对话以 Markdown 复制到剪贴板,或保存到文件(见下文)不可用
/diff在分页器中显示第一个工作区目录的 git diff,包括未跟踪的文件可用
/mention插入 @,打开统一提及选择器可用
/status显示模型和推理强度、Provider、工作区目录、生效的权限模式(会话自己的,否则是配置的)、会话模式、角色(不是 default 时,连同它收窄了什么)、会话 ID、token 用量、上下文窗口的剩余比例连同窗口大小及其来源(configured、learned、reported、models.dev 或 built-in),或窗口未知(unknown (compacts on the Provider's error))、对模型已知的信息改变推理强度时实际发送的值,以及后台的压缩(compacting in the background,或已就绪、等待安装)可用
/context会话上下文里有什么:最近一次请求按组相对窗口的占用,然后是提示缓存(见下文)是
/pwd、/cwd显示工作目录(第一个工作区目录)和其他工作区目录可用
/cd [path]切换工作目录;不带路径时切换到主目录(见下文)不可用
/plugins打开插件浏览器(设置中心的一个页面):已安装插件、市场和内置插件;安装、启用、停用、更新和卸载插件,添加市场(见下文)可用
/mcp在设置中心打开 MCP 服务器(见下文)。/mcp verbose 列出服务器:连接状态、错误、命令或 URL、工具。/mcp login ID 打开其中一个的登录可用
/hooks打开钩子浏览器(设置中心的一个页面):各事件的钩子及其信任状态和开关;信任钩子、开启或关闭钩子(见下文)可用
/raw [on|off]以生成对话的原始纯文本显示对话,不带样式,便于用终端自己的选择复制;不带参数时切换(见下文)可用
/theme在设置中心打开语法高亮主题的页面,移动时实时预览可用
/statusline在设置中心打开状态栏的页面:项目和颜色;/statusline 项目 [--colors|--no-colors] 只对本次运行有效--no-colors]` 只对本次运行有效
/title在设置中心打开终端标题的页面;/title 项目 或 /title --clear 只对本次运行有效可用
/tui在设置中心打开终端界面的设置,在那里为下次启动选择 Fullscreen可用
/config [目标]设置中心:所有设置分标签页显示,改动即保存;带目标时在某个标签页、分节、集合或页面打开(见下文)可用
/keymap [debug]在设置中心打开按键映射的页面,修改某个动作的按键;/keymap debug 列出所有动作的按键(见下文)可用
/presets在设置中心打开预设的页面:运行、新建、编辑和删除保存在 0 到 9 号位置的输入(见下文)可用
/memories打开设置中心的 Memory 标签页:使用和生成记忆,以及它的 Memory store 页面:本会话是否参与记忆和重置可用
/warnings列出本次运行的警告,可以复制或忽略(见下文)可用
/tasks管理后台 Agent 和终端;查看、关闭或恢复暂停的唤醒是
/ps列出会话的后台终端:命令、状态、目录、最近的输出可用
/stop、/clean确认后停止会话的所有后台终端可用
/clear [name]清空终端的滚动历史和屏幕(Fullscreen 下清空对话)并离开会话;下一个会话使用这个名字不可用
/quit、/exit退出可用
  • 回合进行中输入不可用的命令,会显示 '/x' is disabled while a task is in progress.。/model 和 /effort 在回合中可用,但都要等回合结束后才应用(提示 Model will change to X after this turn、Reasoning effort will be set to Y after this turn):回合发出的每个请求都是它被准入时的那个。模型还带着自己的传输,所以在回合中取用另一个提供方的模型会把它的名字发往旧端点。压缩进行中仍会拒绝两者,因为它的摘要会按模型已不再拥有的窗口来衡量。
  • 不认识的 /名字 不会发送,而是提示 Unrecognized command。包含斜杠的路径(如 /usr/bin/env)或以空格开头的文本会作为普通消息发送。
  • 除 /model(forget)、/effort、/permissions、/role、/rename、/resume、/fork、/review、/side、/goal、/export、/cd、/clear、/compression(cache)、/raw、/config、/providers(policy)、/mcp、/statusline、/title 和 /keymap 外,命令不带参数。/compact now 这样在名字后面写了内容的消息会作为普通消息发给模型;/model 后面跟 forget 以外的内容时,会提示 Usage: /model [forget]。/mcp 后面跟 verbose 或 login ID 以外的内容时,会提示 Usage: /mcp [verbose | login ID];/providers 后面跟 policy 以外的内容时提示 Usage: /providers [policy],/compression 后面跟 cache 以外的内容时提示 Usage: /compression [cache]。
  • /raw 立即生效并保存(tui.rawOutput),下次启动时沿用。Fullscreen 下整个对话以原始形式重新显示;Scrollback 下已经写入滚动历史的内容保持不变,只有之后的内容是原始形式,直到调整终端大小后滚动历史按当前的形式重新写入。已结束的回答或计划显示它的 Markdown;流式输出期间显示去掉样式的各行。/raw 后面跟 on、off 以外的内容时,会提示 Usage: /raw [on|off]。
  • tui.fullscreenTranscript(/tui)从下次启动起生效:正在运行的界面保持当前方式。届时 --no-alt-screen 和 tui.alternateScreen 仍然适用。
  • 命令或它打开的列表因内部错误(panic)失败时,该命令在本次运行的剩余时间内关闭:对话中显示 '/x' failed and is turned off for the rest of this run,命令列表不再列出它,再输入它会提示它已关闭。会话、输入框和其他命令照常工作。聊天本身(输入框、对话内容、流式回答)的内部错误仍会结束界面,结束前会恢复终端状态。

模型列表

表格显示与各列对齐的 Model、Provider、Context、Thinking 和 Vision 标题。提供商名称在 Context 列旁右对齐,使用与其他数据列相同的正常文字颜色。提供商设置中的模型选择器也使用这些标题;窄屏继续使用逐行展示能力信息的布局。

/model 立即打开列表,不等任何 Provider 回答。会话的模型排在第一行,附上已经知道的信息(它自己的设置、一次拒绝教会的、上一次列表、打开时的 models.dev、内置窗口;不为它发出任何请求),之后每个已启用的 Provider 各占一行,显示 listing…。每个 Provider 由单独的请求列出,一回答,它的模型就替换它那一行,顺序固定:Provider 按名字排列,每个 Provider 的模型按其列表的顺序。所以一个缓慢或无法访问的 Provider 不会拖住其他 Provider。列表下方的 • Listing models… 3 of 6 Providers answered · 4s 统计已经回答(列出或失败)的 Provider 数和列表已等待的时间;所有 Provider 都回答后这一行消失。没有启用任何 Provider 时,显示 No Provider is enabled: /providers adds one.。新到的行保留你在搜索中输入的内容、选中的行以及它在屏幕上的位置:移动的是它周围的行,而不是它。

每个模型的一行显示它的 ID、它的 Provider,以及标题下的三列:

  Model                                    Provider  Context  Thinking  Vision
› claude-sonnet-4-5 (current)             Anthropic     200K  yes       yes
  gpt-5.1                                    OpenAI     272K  ?         ?
  meta-llama/llama-3.1-405b-instruct:f…  OpenRouter     131K  no        no
  Team gateway                           listing…
  Work proxy                             not listed: 401 Unauthorized
  • Context 是模型的窗口(200K、1.05M),Thinking 表示它是否推理,Vision 表示它是否读图:yes、no,没有任何来源说明时为 ?。这些是模型本身的信息,命名方式与 /status 和 doctor --online 相同(模型)。模型策略的 contextWindowTokens 和 imageInput = "disabled" 适用于会话运行的任何模型,所以列表只在标题下说明一次(The model policy sets every session's window to 128K; images are never sent.)。
  • 过长的 ID 在它那一行用 … 截断,在此之前 Provider 名先缩短到 10 列。不足约 51 列时每一行分两行显示:ID(放得下时后面跟着 Provider),下面是 context 200K · thinking yes · vision yes。
  • 列表下方显示选中模型的各项信息及其来源:claude-sonnet-4-5 · Anthropic: context 200K (reported) · max output 64K (reported) · thinking low, medium, high (reported) · vision yes (reported);或者 context not known (compacts on the Provider's error)、thinking yes, levels not known (models.dev)、thinking no (learned: the Provider refused it)、vision not known。
  • 再下面的按键说明以 ? not known 结尾;models.dev 关闭(默认)且某一行有 ? 时,还会加上 models.dev can fill these: /config modelMetadata。

输入的文字会搜索模型 ID、列表给出的模型名称以及 Provider 的名字(openrouter、Sonnet)。Up 和 Down 会跳过仍在列出的 Provider;Page Up 和 Page Down 按一屏的行数移动选中项,到列表两端就停住而不绕回。在模型上按 Enter 会把它设为本会话的模型并关闭列表,即使其他 Provider 仍在列出。在列出失败的 Provider 上(not listed: …,完整的错误显示在列表下方,按键说明为 enter lists again)按 Enter 会重新列出它。Esc 随时关闭列表:仍在进行的列出会完成,它们报告的模型信息会像 Agent 自己列出时一样保存,但回答找不到列表,会被丢弃;再次执行 /model 会开始一个新的列表。每个列表都实时读取:不显示之前列表的内容。

会话命令

  • /rename 打开一行输入框,填有会话的标题。输入框打开时,会请会话的模型根据目前的对话给出一个标题:它显示在输入框下方(Suggested: …),按 Tab 填入输入框。Enter 重命名,Esc 取消。titles 插件关闭或无从建议时,会显示 No title suggestion。/rename 名字 直接重命名。没有会话时,/rename 会先创建一个。
  • /archive 和 /delete 会先确认(默认选中“No”一项)。之后界面与 /new 之后一样没有会话。归档的会话可以在恢复选择器的归档列表(Tab)中找到,在那里按 Ctrl+A 或 Enter 恢复。删除无法撤销,会一并删除会话的子会话。见会话。
  • /fork [名字] 在会话最新提交的记录处分叉:副本带有完整的对话,界面之后在副本中继续,原会话保持原样。给了名字时副本使用这个名字。工作目录位于 Git 仓库中且 worktree 插件在运行时,会先询问副本在哪里运行:Fork here(在这里),或 Fork into a new worktree(在新的工作树中),后者就是 /worktree 的 Continue this conversation(见下文)。
  • /clear [名字] 在 Scrollback 下清空终端的滚动历史和屏幕,在 Fullscreen 下清空对话,然后与 /new 一样离开会话。给了名字时,下一条消息创建的会话使用这个名字。
  • /export 提供 Copy to clipboard(复制到剪贴板)和 Save to file(保存到文件)。保存时会询问文件名,默认是第一个工作区目录下的 hanafubuki-agent-session-ID.md。/export 路径 直接保存到该路径。相对路径以第一个工作区目录为基准(不展开 ~);已有的文件不会被替换,导出会失败。格式见会话。
  • /copy 提供整个最后回答(Markdown)、每个围栏代码块(原样,不含围栏)和每段引用(不含 >);Fullscreen 下还有 Select in the transcript(在对话中选择):对话中出现一个光标,方向键移动它,v 或空格开始选择,y 或 Enter 复制,Esc 或 q 退出。回答从会话的历史中读取,所以恢复的会话的最后回答也能复制。
  • /ps 把会话的后台终端写入对话:每个命令、它的状态(和退出码)、目录和最后三行输出。/stop(或 /clean)先确认,然后停止全部后台终端,向所属会话报告每次关闭以便它恢复,并说明停止了几个;没能停止的会单独报告。
  • /recap 先写出 Writing a recap…,再写出回顾:对话是关于什么的、进展到哪里,有待回答的问题或约定的下一步时,以 Next: 给出。它读取最近的几轮交流,不含工具输出,不会向会话提交任何内容。Provider 或网关拒绝结构化输出时它照样可用:请求会改为强制调用工具再发,再不行就以纯文本发(Provider 与模型)。recap 插件关闭时,会说明回顾不可用及原因。
  • /init 把一段固定的提示作为你的消息发送:写一份 AGENTS.md,即仓库的简短贡献指南(结构、命令、风格、测试、提交约定),已有的 AGENTS.md 保持不变。提示来自 Codex。

角色

会话的角色收窄它可以使用的东西:它的工具、为它贡献内容的插件、最宽松的权限模式。新会话的角色是 --role 指定的那个,否则是 default。

  • /role 名字 在下一个轮次之前给会话这个角色:它的指令、它设置了的模型和推理强度,以及它的收窄。对话中显示 Role set to 名字。没有任何来源定义的角色、或不可用的角色会被拒绝,并列出可用的角色。/role default 再去掉所有收窄。
  • 单独的 /role 列出可用的角色及其描述的第一行,会话当前的角色被标出;选中的那个按 /role 名字 的方式设置。
  • 轮次进行中不可用。没有会话时,/role 会先创建一个。
  • 角色显示在 /status 中,也可以用状态栏的 role 项显示。

推理强度

/effort 列出会话模型可选的推理强度,当前值标为 (current);选中的那个在下一个轮次生效,对话中显示 Reasoning effort set to 档位:

  Select Reasoning Effort
  The reasoning effort of gpt-5 in this session.

  1. low
  2. medium (model default)
› 3. high (current)
  4. Default                 unset: the Provider's default
  5. Custom…                 type an effort
  • 档位来自模型自己的 reasoningEfforts,否则来自其 Provider 的目录;来自 models.dev 的档位不会提供(推理强度与思考过程)。没有已知档位时只有 Default 和 Custom;模型不接受推理参数时,副标题会说明,从 Provider 的拒绝学到时说 The Provider refused the reasoning parameter。
  • Default 取消设置,使用 Provider 的默认值。Custom 打开单行输入框,当前值是自定义值时预先填入;Enter 时先检查,不接受的值(如 none)留在输入框中并显示原因。列表中没有的当前值显示为 Custom: max (current)。
  • /effort 档位 直接设置任意推理强度(发送时按模型的档位收窄),/effort default 取消设置。
  • 轮次进行中可用,和 /model 一样在回合结束后应用。压缩进行中会拒绝。没有会话时,/effort 会先创建一个。
  • Alt+, 和 Alt+. 在上述档位中把推理强度降低或提高一档,条件与 /effort 相同。未设置的推理强度,或不在档位中的值,从模型的默认档位开始,没有默认档位时从第一个档位开始;到了一端就保持不变,并提示 Reasoning is already at the highest level (High).。没有已知档位时提示 No reasoning levels are known for this model; use /effort to type one.。
  • 推理强度显示在 /status 中,也显示在状态栏的 model-with-reasoning 项(默认显示)中。设置中心的模型策略中,推理强度一行提供相同的选项,设置的是新会话使用的推理强度(设置)。

权限

权限模式一开始是配置中的模式(permissionMode 或 --permission-mode);见权限。

  • /permissions 列出 Codex 的预设,每个都是一个权限模式加一个沙箱模式:Read only(手动,read-only)、Default(手动,workspace-write)、Auto-review(自动审查,workspace-write)和 Full access(完全访问,没有沙箱)。生效的预设被选中:会话自己的模式,否则是配置的模式;两者组成不了预设时,不选中任何一个。选择 Full access 时会先确认(默认选中 Cancel)。这台机器没有沙箱时,需要沙箱的预设不能选择。选中一个预设会为本会话同时设置两种模式。没有会话时,/permissions 会先创建一个。
  • /permissions read-only 或 /permissions default 直接设置这个预设。/permissions manual、/permissions auto-review 或 /permissions full-access(也可以写 auto_review 和 full_access)只直接设置权限模式,不再确认,沙箱保持不变:模式的名字不会被当作预设。
  • 权限和沙箱模式随会话保存,恢复时还原,重启 Agent 后恢复也一样。同一次 TUI 运行中的 /new 和 /clear 继承当前模式;退出 Agent 后重新以空对话启动时使用配置默认值。permissionMode 和 sandboxMode 不变,其他已有会话和分叉保持自己的模式,正在运行的回合保持开始时的模式。见单个会话的模式和单个会话的沙箱。
  • 自动批准审核的每次审核各有独立活动条目。第一行显示白色闪烁圆点、Reviewing approval request 和实时耗时;待审核操作从第二行的 └ 后开始,换行后与操作内容对齐,无需展开条目即可看到。审核结果(批准、拒绝、超时、失败或中止)会替换标题并停止计时;批准后默认只显示一行标题,使用 Show details 展开操作内容和理由,恢复会话后也一样。批准显示绿色常亮圆点,拒绝、超时、失败或中止显示红色常亮圆点。返回的理由在条目详情中展开查看,无需展开工具输出。后端没有提供审核文本流,因此界面不会模拟;已结束的审核从保存的审核记录恢复,采用相同布局并保留原始耗时和理由。
  • /approve 列出本会话中被自动审查拒绝的操作,最新的在前:每个都有摘要和审查给出的理由,可以搜索。界面为每个会话保留从打开它起最近的十个,所以恢复的会话不会列出之前的拒绝。选中的操作会获得批准:模型从下一次请求起看到这次批准,重试仍要经过审查(批准被拒绝的操作)。没有被拒绝的操作时,会显示 No denied actions to approve.。回合进行中 Agent 会拒绝批准,对话中会说明原因。

工作目录和工作树

  • /cd [路径] 把 路径 设为工作目录:第一个工作区目录,后面跟着它的 Git 根目录和 --add-dir 指定的目录。相对路径以当前工作目录为基准;~ 和 ~/… 表示主目录,只输入 /cd 也是。会话在那里继续:它的下一个回合在新的工作区目录中工作。回合、压缩或后台终端正在运行时,以及目录不存在时,Agent 会拒绝,对话中会说明原因,什么都不会改变。
  • 项目配置不会跟随 /cd:它的信任级别和项目的 config.toml 仍是界面启动时读取的那些,直到重新启动界面。
  • /worktree 在工作目录位于 Git 仓库中且 worktree 插件在运行时打开一个菜单(否则说明为什么不可用):
    • Continue this conversation(继续当前对话)新建一个工作树,把会话分叉到其中(工作树),把工作目录切换过去,之后在分叉出的会话中继续。还没有对话时,这一项不可选。
    • Start a new conversation(开始新对话)新建一个工作树并把工作目录切换过去,此时没有会话:你的下一条消息创建的会话归属于这个工作树。
    • Browse worktrees(浏览工作树)列出仓库的工作树,每个都带有提交、分支(新建的显示 detached)和所属会话。选中一个后可以选择 Resume session N(恢复会话)、Copy path(复制路径)和 Remove worktree(删除工作树);删除前会先确认(默认选中 Cancel),会删除检出的文件及其本地修改,会话保留。工作目录所在的工作树不会被删除:先用 /cd 离开它。
  • 新建工作树之后的某一步(分叉、切换目录)失败时,工作树会保留,对话中会说明它的位置;可以在 Browse worktrees 中删除它。

首次设置

界面启动时如果没有默认 Provider(没有配置,或者都未启用),或者没有为新会话选择模型(也没有用 -m 指定),它会在 Provider 处打开设置中心,而不是让第一条消息失败:

  • 没有 Provider:按 a 添加一个。填写名称、协议、基础 URL 和令牌,再选择 Add a Provider:第一个 Provider 就是默认的。在它上面按 Enter 打开它的记录,其中 List models 测试它,Choose the model 列出它的模型:选中的模型和这个 Provider 就是新会话使用的。
  • 有 Provider 但都未启用:打开其中一个的 Enabled,或添加一个。
  • 有默认 Provider 但没有模型:选择 Choose the model 来设置新会话的默认模型。也可以按 Esc 退出设置,再用 /model 为当前会话选择模型,随后即可发送消息。

按 Esc 返回上一页,在标签页上关闭设置中心,输入框随即可用。设置完成前发送的消息会留在输入框中,对话中有一行说明原因,设置中心会再次打开。选好模型后,下一条消息就会创建会话。/new 会像启动时一样重新检查。

表单

设置中心各页面中的表单(插件的选项和设置、预设、手动输入的模型 ID)使用这些按键:

按键作用
Tab、Down下一个字段;在最后一个时回到第一个
Shift+Tab、Up上一个字段;在第一个时回到最后一个
Enter下一个字段;在操作(Save)上执行它
Space、Left、Right切换选项或开关([x])
Esc返回
  • 文本字段使用与输入框相同的编辑键。每个字段有自己的剪切缓冲区(Ctrl-K、Ctrl-U、Ctrl-W,然后 Ctrl-Y),从机密字段中删掉的文本不能粘贴(yank)到另一个字段。
  • 机密值默认遮蔽。Ctrl+R 显示或隐藏当前获得焦点的密钥字段,提示在 ctrl+r show secret 和 ctrl+r hide secret 之间切换。切换不会保存或改动值;未获得焦点的字段仍遮蔽,重新打开编辑框时恢复遮蔽。粘贴的文本进入当前获得焦点的字段,换行会被去掉。
  • 字段有问题时,会在它下方用红色说明,焦点也移到那里。保存时 Agent 拒绝的内容会显示在表单下方,表单中填写的内容保留。

Provider

/providers 在设置中心打开 Provider:每一项显示协议和基础 URL,默认的一项旁标有 default,停用的旁标有 off。Provider 的记录包含它的字段(令牌默认显示为 ••••;Enter 编辑已保存的值,Ctrl+R 显示或隐藏)以及动作 Make default、List models(用于测试)、Choose the model 和 Delete。Choose the model 在 Provider 回答之前显示加载行,之后按模型列表的列显示它的模型,下方是选中模型的各项信息。/providers policy 打开模型策略。字段和模型页面见 Provider 与模型。

插件

/plugins 打开插件浏览器(对应 Codex 的插件目录),它是设置中心的一个页面(Plugins 中的 Plugin browser),有三个标签页,用 ←/→ 切换:Installed(已安装)、Marketplaces(市场)和 Built-in(内置)。每个改动立即保存;进行中时页面会显示(Installing…),完成后重新读取全部内容。对应的命令见命令行参考。

  • Installed 列出已安装插件:每个插件的状态、版本、需要审查的 hook 和问题。空格启用或停用选中的插件;Enter 打开它(它的来源、版本、格式、Skill、MCP 服务器、hook、角色和问题);o 打开代码插件的选项,前提是它的 configSchema 能降低为选项(即下面的通用选项表单;保存时写入它的设置,选项未描述的键保留,并重新启动它的代码);Install from a directory… 要求输入一个插件目录,按 <名字>@local 安装。
  • 插件页面提供 Disable plugin 或 Enable plugin、有 hook 等待信任时的 Trust its N hook(s)、代码插件的权限未授予时的 Grant its permissions(说明它的代码能访问什么;Code 一行显示它的访客状态)、代码插件的 Settings(一个以单个 JSON 对象编辑其设置的表单,按清单的 configSchema 校验;留空表示移除;它的代码以新设置重新启动)、Update plugin(从它的市场或目录重新安装)、Retry plugin(重新加载,并再次启动失败的访客)和 Uninstall plugin(会询问是否保留它的数据目录)。下面列出它的来源、版本、格式、Skill、MCP 服务器、hook 和问题。
  • Marketplaces 列出已添加的市场,每个显示来源和其中已安装的插件数量。Enter 打开一个市场:列出它的插件,标为 Available、Installed、Disabled 或 Not installable;在未安装的插件上按 Enter 显示 Install plugin。Ctrl+U 升级 git 市场,Ctrl+R 确认后删除市场。Add a marketplace… 要求输入来源:owner/repo、git URL 或本地市场目录。
  • 安装带 hook 的插件后,会列出这些 hook 的命令并询问是否信任(Trust them,或 Not now:之后在 /hooks 或插件页面信任)。hook 只有被信任后才会运行。
  • Built-in 列出编译进 Agent 的插件(以及宿主的插件)及其状态和摘要:空格或 Enter 启用或停用(disabledPlugins;核心插件不能停用),r 重新启动失败的插件,o 打开有选项的插件的选项([pluginOptions.名字])。
  • 选项表单是通用的:插件的每个选项一个字段,标签为它的摘要和键,形式为开关、数字(占位符显示它的界限)、选择、文本(机密时显示为圆点)或用逗号分隔的文本列表。保存时按写入的方式检查每个值,不合适的字段下显示原因;只写入改动过的值,写入用户的 config.toml(内置插件的 [pluginOptions.NAME],代码插件的 [plugins."ID"].settings),插件立即接受它们。表单包含内置插件声明的全部选项,超过 64 项也不会截断。这些选项同样是设置中心 Plugins 标签页中该插件自己分节的行。

Esc 返回上一页,在标签页上回到设置中心。用 --safe-mode 启动时,浏览器会提示没有加载任何已安装插件。

MCP 服务器

/mcp 在设置中心打开 MCP 服务器(在 Tools 中):每一项显示命令或 URL、连接阶段、连接后的工具数量和最近的错误。服务器的记录包含传输方式、环境变量或 HTTP 头、协议模式和各项策略(包括按工具的策略),以及动作 Delete、Connect、Disconnect、Refresh、Log out 和 Log in(打开它的 OAuth 登录)。它的机密在旁边的 MCP secrets 中。启用的已安装插件运行的服务器是同样在旁边的 Plugins' MCP servers:每一项显示所属插件、连接阶段和工具,你可以启用或停用它,只保留某些工具或去掉某些工具([plugins."ID".mcpServers.NAME],插件);它如何运行仍由插件决定,/mcp verbose 也会列出它们。见 MCP。

评审

/review 打开评审目标的选择器:Review uncommitted changes(未提交的改动:已暂存、未暂存和未跟踪的文件)、Review against a base branch(相对基础分支:仓库的本地分支,当前分支标为 (current),可搜索)、Review a commit(一个提交:最近 100 个提交,可按标题或哈希搜索)和 Custom review instructions(自定义要求:一行输入框)。在列表中按 Esc 回到预设。不在 Git 仓库中时,基础分支和提交两项不可用,并显示原因。/review 要求 直接按你的要求评审。评审如何运行见会话。

  • 评审会把结果报告回对话,所以会话必须已经有过一个回合:发送第一条消息之前,/review 会提示 Send a message first; a review reports back into a conversation.。回合进行中或另一个评审运行时,不会开始评审。
  • 评审运行时,对话中显示 >> Code review started: … <<,状态行显示 Reviewing …。按 Esc、Ctrl-C 或输入 /review cancel 取消它(<< Code review cancelled >>)。这期间你发送的消息显示在输入框上方的 Messages to be submitted at end of turn 之下,评审结束后再发送,这样它开始的回合能读到评审的发现。有这样的消息等待时,Esc 不会取消评审(会给出提示):Ctrl-C 会取消,并把消息放回输入框。
  • 评审结束后,<< Code review finished >> 之后依次是结论及其置信度、说明,以及每条发现:优先级和标题、文件和行,以及正文。
  • review 插件关闭时,/review 会说明评审不可用及原因。

目标

/goal 目标内容 为会话设置目标(会话);/goal --tokens N 目标内容 同时设置 token 预算(200000、200k、2m)。会话的目标尚未完成时,会先询问 Replace goal?(替换目标?),默认选中保留当前目标。空闲时设置或恢复活动目标,会立即通过正常消息提交路径发送目标内容并开始执行。在回合进行中设置的目标,会在该回合的下一个回答时被接手,不会重复启动回合。

  • 只输入 /goal 时显示目标:目标内容、状态、已用 token(及预算)和已用时间,以及可做的操作:Pause goal(暂停,活动的目标)或 Resume goal(恢复,暂停或阻塞的目标)、Edit objective(编辑目标内容)、Set token budget(设置 token 预算)和 Clear goal(清除目标)。没有目标时会说明,并给出用法。
  • /goal pause、/goal resume 和 /goal clear 直接执行;/goal edit 打开填有目标内容的输入框。编辑目标内容或设置预算都会重新设置目标:用量从零开始。
  • 没有会话时,/goal 会先创建一个。goal 插件关闭时,会说明目标不可用及原因。
  • 目标自动显示在状态行下方的快捷键提示行右侧(展开快捷键列表时位于列表底部),不占用状态行宽度,无需设置 /statusline goal:Pursuing goal 显示运行耗时或显式预算用量,暂停、阻塞、预算用尽和完成分别显示 Goal paused、Goal stalled、Goal unmet、Goal achieved。目标事件和恢复会话都会更新显示;只有活动目标运行时才增加耗时。/new 和清除目标会移除指示器。可选的状态行 goal 项仍在左侧显示目标内容与状态。

钩子

/hooks 打开钩子浏览器,它是设置中心的一个页面(Tools 中的 Hook review):列出钩子事件,每个事件显示它有几个钩子、几个在运行(已信任且开启)、几个需要审查,下方列出配置中被跳过的内容及原因。Enter 打开一个事件:每个钩子显示它的 matcher 和命令、信任状态(trusted、new, review required 或 modified since trusted, review required)、是否开启、配置它的文件和超时。空格或 Enter 开启或关闭选中的钩子,t 信任它,Esc 返回,在事件列表上回到设置中心。在事件列表中,t 经确认后信任所有需要审查的钩子。每个改动立即保存,作为 Hooks 集合的动作(Tools 标签页,每个钩子的记录显示它完整的定义:命令、超时、状态消息和写在哪里),之后重新读取钩子。钩子在它的文件中定义,从不在设置中心定义。

界面启动时如果有需要审查的钩子(新的,或信任之后被修改的),对话中会显示 N hooks need review: /hooks,并记下这条警告;不会有任何东西等你处理。

旁路对话

在旁路界面中,/close 或 hide_pane 的按键关闭该界面并中断它的回合,运行中也可使用,不会退出主 Agent。旁路界面里的 Ctrl-C 保持它在记录中的含义(复制选中的文字、清空草稿、中断回合),因此不再关闭界面。主界面仍支持 /side close。旁路界面命令列表包含 /close 和 /subagents,隐藏 /side 和 /btw;主界面的 Ctrl-C 保持原有中断/退出行为。

/side(或 /btw)打开会话的旁路对话:在会话旁边临时开的一段对话,用来快速问一个问题,而不打扰会话正在做的事。/side 问题 打开它并把问题发到那里。会话必须已经有过回合:在你发送第一条消息之前,/side 会提示 '/side' is unavailable until the current conversation has started.。评审运行期间,或会话的上下文正在压缩时,也会拒绝打开。

  • Fullscreen:旁路对话是停靠在对话右侧的窗格,有自己的对话、输入框和状态栏;每个窗格顶部有一行标题,两个窗格之间有分隔线。窗格打开时获得焦点。它的消息发给旁路会话,主对话的消息发给主会话,两边都保持运行:一边的回合在你于另一边输入时继续进行。屏幕窄于 100 列或放大(leader z)时,获得焦点的对话占满屏幕,上方显示它的标题。用鼠标拖动分隔线,或用 leader < 和 leader >,调整窗格宽度;leader = 让两个窗格等宽;在另一个窗格中单击会让它获得焦点。
  • Scrollback:界面切换到旁路对话:先在回滚区写入 Side conversation · ctrl-x x or /close closes · Esc returns,再写旁路对话。这期间主对话写出的内容会先保留,回到主对话时再写入。
  • 返回和关闭:在空输入框上、没有任务运行时按 Esc(chat.edit_previous 的按键),或 leader left,回到主对话。旁路对话保持打开:/side、leader right 或 leader tab 会再次显示它,连同它的记录和草稿。旁路界面的 /close、主界面的 /side close,或 leader x(hide_pane)关闭它:中断它正在运行的回合并丢弃这个会话(Side conversation closed.)。主对话切换到别的会话时(/new、/resume、/fork 等),它也会被关闭。
  • 旁路对话支持以下查看命令:/copy、/agents、/tasks、/export、/raw、/diff、/mention、/status、/warnings、/pwd、/close 和 /subagents。弹出列表只列出这些;其他命令会提示 '/x' is unavailable here; Esc returns to the main conversation.。旁路对话中之前的消息不能编辑。

窗格的按键是按键映射中的动作,默认是前导键(Ctrl-X)再按一个键:

Ctrl+/ 在当前选中的 agent 与旁路对话之间切换焦点,保留两边的草稿。兼容旧终端上报的 Ctrl+_ 或 Ctrl+7,可通过 global.toggle_side_conversation 重新绑定;原有的 leader tab 也保留。未打开旁路对话时,此键不执行操作。旁路对话开启或获得焦点时,空输入框下的 Alt+Left、Alt+Right 仍可切换 agent:仅改变 agent 面板,旁路的记录、草稿和运行中的回合都保留。Fullscreen 下,选中的子 agent 与旁路面板并排显示。从旁路返回时先聚焦选中的 agent;在子 agent 上再按 Esc 返回主 agent。

按键动作作用
leftglobal.focus_pane_left回到主对话
rightglobal.focus_pane_right让旁路对话获得焦点
tabglobal.toggle_side_conversation切换到另一个对话
<、>global.move_divider_left、global.move_divider_right移动分隔线(Fullscreen)
=global.equalize_pane_widths让两个窗格等宽(Fullscreen)
zglobal.toggle_pane_zoom只显示获得焦点的窗格,或恢复两个窗格(Fullscreen)
xglobal.hide_pane关闭旁路对话,或离开正在显示的子代理

在 Fullscreen 中,打开了第二个对话时,前导键等待第二个键期间,获得焦点的窗格中会有一个方框列出这些按键。

子代理

子代理界面中也可打开列表,选择 Main agent 返回主界面,或直接切换其他 agent。模型、路径和标题所在状态行开头显示当前 agent。协作调用显示 Starting agent、Interacting with、Interacted with、Waiting for agents 和 Finished waiting;结果逐个标出 Completed、Failed 等状态。无法读取的状态单独显示警告,不影响其他条目。

/subagents把主 agent 和整个会话树的子代理写入对话,每个都带有状态(running、waiting、idle、failed 或 closed)、它运行的模型和推理强度(使用其 Provider 的默认值时为 default),例如 counter idle · gpt-5.4-mini · low,以及它最近一次回答的开头,然后打开它们的列表,每一项的说明也是这样(idle · gpt-5.4-mini · low,然后是回答的开头);有子代理在运行时,列表会跟着它们的状态更新。Enter 用选中的子代理代替会话显示,上方是 Subagent NAME · from PARENT · Esc or ctrl-x left returns:它的记录和 /resume 显示的一样;它在运行时,它的回合会继续显示(回答逐步输出,工具调用逐个出现,它等待的批准在那里询问,包括显示它之前就已提出的批准,Esc 中断它)。在那里发送的消息发给这个子代理。

  • 在空输入框上、没有任务运行时按 Esc,或 leader left、leader x,回到会话;会话自己的回合在这期间一直在继续。
  • 唤醒:模型在子代理工作时结束了回合的会话,会不运行任何东西地等待它们;在工作行的位置显示 Waiting for 1 agent — resumes by itself · /tasks(或 2 agents)。子代理结束或给它发消息时,会话自行恢复:一个回合开始,以列出所报告内容的 • Background updates 单元开头,模型像在任何回合中一样回应它(wakeOnBackgroundTasks 打开时,默认如此;工具)。显示子代理或旁路对话时也是如此:主对话的回合在那里运行,你回来时就能看到。这期间你输入的消息是你自己的回合,它会先读到在它之前报告的内容。在会话的回合上按 Esc 会暂停它的唤醒,直到你的下一条消息,这一行显示 Paused: 1 agent still running — send a message to resume;没有你的消息时连续 100 个被唤醒的回合也会暂停。其他会话的子代理不会在这里唤醒任何东西:它们报告的内容随那个会话的下一个回合读到。
  • 在空输入框上按 Alt+Right 和 Alt+Left,按这个列表的顺序在会话及其子代理之间循环切换:从会话到第一个子代理,从最后一个回到会话。没有子代理时提示 This session has no subagents.;打开了旁路对话时,提示先关闭它。
  • 在 Fullscreen 中子代理占满屏幕;在 Scrollback 中界面切换到它,和旁路对话一样。它可用的命令和旁路对话相同。打开了旁路对话时不能显示子代理:先关闭旁路对话。
  • 子代理的审批和问题:子代理使用父会话的权限模式。后台事件流在请求发出时将它显示出来,以 Subagent NAME: 标记;你的回答发给这个子代理。父会话回合结束时请求仍保留,在别处回答后或子代理回合结束时关闭。旁路对话获得焦点时,请求在主对话中等待:Fullscreen 显示主对话窗格,Scrollback 则在返回时显示。状态列表也由事件流刷新,包括模型变更;空闲子代理不再被轮询。只有正在显示其对话的子代理,仍通过日志读取流式输出。

后台任务

输入框底部的状态和快捷提示随宽度换行。在主 Agent 或子 Agent 中看到的后台计数均覆盖整棵会话树。重新打开正在运行的子 Agent 时,工作和思考计时从该回合的快照恢复。全局设置按当前页面显示可选条目的序号和总数。命令、技能、提及和模型选择器也显示当前位置,可用滚轮选择、点击条目执行。

/tasks 或 leader t(默认为 Ctrl+X 后按 T)打开后台任务管理器,回合运行时也可使用。在 Fullscreen 和 Scrollback 中均占满屏幕;Esc 返回会话。

  • Agents 显示会话的子 Agent 树,以及各自的状态、运行或等待的持续时间、模型和角色。选中后查看最初的任务、最近回答及其终端;Enter 打开该 Agent 的会话。waiting 表示仍有后台工作,closed 表示不再接受消息。
  • Terminals 显示整棵树的后台终端,包括命令、状态、持续时间、所属 Agent、目录及最近三行输出。Enter 展开所选终端现有的输出;Page Up、Page Down 滚动详情。
  • 点击 Agents 或 Terminals,或按 a、t 直接打开对应分区。Tab 循环切换。点击列表行选中任务,在列表上滚动切换选中项,在详情上滚动阅读内容。点击页脚操作即可执行。关闭确认框中可滚动选择后按 Enter,或直接点击对应选项。x 在确认后关闭所选 Agent(连同其后代)或终端。Terminals 中的 X 在确认后停止根会话的全部终端。停止后,其 Agent 会收到后台更新。
  • 页脚显示 wake: on、wake: paused (you interrupted) 或 wake: off (wakeOnBackgroundTasks)。r 恢复暂停的唤醒,也会处理后代排队的更新;不会启用已关闭的唤醒策略。

视图在后台工作发生变化时刷新,不逐行刷新输出;重新打开会读取最新输出。/ps 和 /subagents 保留简短列表,并以 /tasks to manage 结尾。模型等待后台工作时,输入框仍可编辑,等待行提示 /tasks。命令中心以 N updates 标记有待处理唤醒事件的会话。

指挥中心

命令中心的快捷键帮助按宽度自动切换为三列、两列或单列,列内按键对齐。提示反映当前键位设置,未绑定的操作不显示。窗口较矮时可用上下方向键、Page Up/Down、Home/End 或鼠标滚轮滚动查看;Esc 或 ? 返回列表。本项目特有的 c / Children 保留在 View 分组中。

/agents、在空输入框上按 Left(此时底栏显示 ← for agents)或 global.open_agents(没有默认按键)会在整个屏幕上打开指挥中心(Scrollback 中使用备用屏幕)。只有在输入框获得按键且为空、没有打开弹出列表、这个对话中可以运行 /agents,并且 Left 仍是 editor.move_left 的按键时,Left 才会打开它;否则 Left 和以前一样移动光标。

它列出没有父会话的会话,和恢复会话选择器一样;每个会话的状态是它自己和它的子会话(子代理和评审)中最紧急的那个:

  • Needs input(红色 ●):会话或它的某个子会话在等待审批或提问的回答。
  • Error(红色 !):它自己的最近一个回合失败了。
  • Working(绿色 ●):有回合在运行。
  • Ready(青色 ○):最近一个回合已完成。
  • Inactive(暗色 ○):最近一个回合被中断或取消。回合失败的子会话算作 Inactive:它的失败不需要你处理。

会话按标题分组,标题后是数量(筛选隐藏了一部分时显示为 2 of 5):按项目、目录、状态或模型分组,由 tui.agentsGrouping 决定。项目是会话目录在仓库主检出中对应的目录,所以仓库某个工作树中的会话归入创建这个工作树的检出。同一标题下最近的会话在前。正在显示的会话标有 (shown),打开指挥中心时选中它。向下滚动时会读取更多会话。

  • 置顶:在已读取的会话中,你置顶(p)的会话排在最前,位于 Pinned 标题下,无论按什么分组。
  • 未读:自上次显示以来有变化(它自己或它的某个子会话)的会话标题加粗;不需要你处理时显示蓝色 ●。主对话显示一个会话时,以及指挥中心在显示它时打开,都算显示过它;从未在这里显示过的会话不会标为未读,在指挥中心里做的重命名或恢复也不算新变化。
  • 隐藏:h 把会话从所有标签页中隐藏。搜索会再次列出它,标有 (hidden);打开它就会重新显示。

置顶、隐藏的会话以及每个会话上次显示的时间属于界面自己,保存在数据目录的 tui-state.json 中(数据目录);会话本身对此一无所知。

宽度达到 90 列时,列表旁的详情面板会显示选中会话的更多信息:标题和状态、模型和推理强度、分支和已用 token、目录;它的子会话(子代理和评审)及其状态;它和它的子会话中最紧急的那个在等你做什么(审批的对象或提问)以及正在做什么;它最近的回答(Last message)和引出这个回答的消息(Prompt)。c 把按键交给它的子会话:Up 和 Down 选择,Enter 或 Right 像 /subagents 那样在父会话旁显示这个子会话,x 关闭子代理及其存活子树并告知父会话(仍可接收后续任务);其他类型的子会话则中断回合,Esc、Left 或 c 回到会话列表。不足 90 列时,子会话获得按键期间,详情面板代替列表显示。

按键作用
Up、Down(k、j)移动选择;越过一端时到另一端
Page Up、Page Down、Home、End移动一页,或到第一个、最后一个会话
Enter、Right用这个会话代替正在显示的会话。在 Archived 中恢复它
Tab、Shift-Tab、1–6筛选:All、Needs you、Working、Ready、Inactive、Archived,除 Archived 外都显示数量
/、F3搜索标题:输入的文字会缩小列表,Enter 打开选中的会话,Esc 结束搜索
n离开正在显示的会话:下一条消息开始新会话
w进入新的工作树,和 /worktree 的“开始新对话”一样:下一条消息在那里开始会话(工作树)
o打开恢复会话选择器(agents.resume),与 /resume 相同
f在会话的最新位置分叉,并在副本中继续
r重命名会话:就地编辑标题,Enter 保存,Esc 取消
x中断会话的回合
p置顶会话,或取消置顶
h隐藏会话
c把按键交给详情面板中会话的子会话(见上文)
a先确认,再归档会话及其子会话;在 Archived 中恢复它
Backspace先确认,再删除会话及其子会话
g切换到下一种分组:项目、目录、状态、模型,并保存到 tui.agentsGrouping
?显示按 Navigate、Tasks、View 分组的 Task shortcuts
点击、滚轮点击标签页显示那个筛选,点击会话或子会话选中它,点击已选中的那个打开它;滚轮移动三行
Esc、q关闭指挥中心

确认框默认选中 Cancel:Up 或 Down 选择,Enter 确认,Esc 取消。会话操作的按键(/、F3、n、w、f、r、x、p、h、c、a、Backspace 和 g)属于按键映射的 agents 上下文(见下文);其他按键保持不变。

打开、新建(包括在工作树中新建)和分叉会改变主对话,所以在它的回合运行期间会被拒绝。正在显示的会话用 /archive 和 /delete 归档和删除,不在这里操作。指挥中心从不等待读取:会话、它们的子会话和选中会话最近的一轮交流,都在它自己的线程上读取,时机是打开时、滚动时和每次操作后。指挥中心打开期间,这个线程还会每秒四次查看 Agent 持有的会话:每个会话的变化、它在等待的审批或提问,以及它正在做什么。有变化的内容会重新读取,指挥中心不需要按键就会跟着更新:没有父会话的会话变化时重读列表,子会话变化时重读其父会话的子会话,选中的会话变化时重读详情。外观层(facade)没有覆盖所有会话的事件流,所以这里的查看和子代理的查看一样,读取会话的当前状态;Agent 没有持有的会话不会变化。

@ 和 $ 提及

提及菜单采用 Codex 的统一选择器,在输入框上方打开,正常页脚仍保留在下方。输入文字会进行模糊筛选并突出匹配字符;异步结果到来时,菜单保持预留高度。

  • @ 列出已启用的插件与独立 Skill。输入查询后,还会搜索文件、目录和其他可用任务。属于已列出插件的 Skill 仍可在 $ 菜单中单独选择。三个分类为 All Results、Filesystem Only 和 Plugins。
  • $ 列出已启用的 Skill 和配置中已启用的 MCP 服务器,分别标记 [Skill]、[MCP]。本项目使用自身的 MCP 目录承接 Codex 的 OpenAI 账户 Apps 目录。精确名称、前缀和其他模糊匹配依次排序;同一匹配层级中,最近 50 次确认选择的频率决定优先顺序,并在重启后保留。$HOME、$1、$(command) 等 shell 表达式不会打开菜单。
按键效果
上下方向键、Ctrl-P/Ctrl-N选择条目,到首尾时循环
@ 中的左右方向键切换分类
Tab 或 Enter插入选中的提及,不发送草稿
Esc关闭当前这一处的菜单,直到查询内容变化

@ 没有匹配条目时,Enter 正常发送文本;$ 空菜单不会发送。菜单打开时,Tab 用于补全而不是排队,Esc 用于关闭菜单而不是中断回合。

文件搜索遵守 .gitignore 等忽略规则,即使不在 Git 仓库中也是如此。第一个工作区根目录下的路径为相对路径,其他根目录下为绝对路径,含空格时加引号。选择图片会将其作为附件加入;其他文件和目录仅插入路径,由模型使用工具读取。补全不会丢失草稿中的其他图片和大段粘贴占位符。

选中的 Skill、插件、MCP 服务器和任务作为完整引用处理,按 Backspace 会删除整个标签。即使名称相同,其唯一身份也会贯穿排队、编辑、外部编辑器、历史召回和重新打开会话。对话中显示简短标签,保存的消息文本携带 skill://、plugin://、mcp:// 或 thread:// 链接。选中的 Skill 绑定确切目录项;MCP 链接不会误调用同名 Skill。插件和 MCP 引用为正常的工具发现流程标明来源,不会启用已禁用的能力。

任务引用由 threads 插件的只读工具 read_thread 承接。模型读取该任务当前的用户和助手消息,并可用 olderCursor 和 throughRevision 继续向前分页;不会复制思考内容和图片载荷。引用为当前任务提供上下文,不会继承另一段对话的指令或授权。

阅读对话

成功的 update_plan 调用只显示一个 Updated Plan 清单,恢复会话后保留相同的步骤和说明。展开 Skill 列表、工具发现和 MCP 资源结果时,会显示返回的条目和嵌套字段(包括失败详情),而不只是条数。

Fullscreen 下,对话会跟随最新输出,直到你向上滚动。向上滚动后,回合继续运行时视图停留在原处,输入框上方会出现 ↓ Back to bottom 控件(下方有新内容时为 New activity · ...),用它回到最新输出。

按 Enter 发送消息时,该对话也会自动回到底部,并恢复跟随新输出,包括向正在运行的回合发送引导消息。按 Tab 发送或排队消息时也一样。仅输入草稿或插入换行会保留当前阅读位置。

按键或操作作用
鼠标滚轮滚动三行
Page Up/Page Down滚动一页
Ctrl-Home、Ctrl-End(Alt-<、Alt->)到会话开头(会读取更早的消息)或最新输出
Esc、点击控件回到最新输出
输入框为空时按 Enter回到最新输出
拖动选择文本;双击选择一个词,三击选择一行,Shift-点击扩展选择
Ctrl-Space用键盘开始选择;方向键和 Shift-方向键移动
Ctrl-X [选择模式:对话中出现一个光标,用按键移动,选择并复制
Ctrl-C、Ctrl-Shift-C、Ctrl-Insert有选择时:复制
Enter有选择时:复制并回到最新输出
右键单击复制选择的内容
Esc有选择时:取消选择
F3查找文本:输入查询,Enter 接受匹配,Ctrl-P/Ctrl-N 转到更早或更新的匹配,Esc 取消
点击条目的控件或标题行显示或隐藏它的详情:在标题行的同一个格子上按下并松开,所以从标题行开始的拖动仍然是选择(见下文)
F4聚焦最近的活动(工具调用、思考、任务计划、较长的消息):Up/Down 在活动间移动,Enter 或点击显示或隐藏详情,Esc 离开
Ctrl-T就地显示整个对话的详细内容(每次思考的全文、工具调用的完整输出);Ctrl-T 或 Esc 返回

还有更多内容可显示的条目,下方单独一行带有控件:思考(它的文本)、折叠时显示不全的工具调用(剩下的是输出行时为 + 12 lines,否则为 + Show details;见工具调用)、列表超过五个显示行的任务计划(说明文字始终显示在列表上方,折叠时按原顺序显示前五行),以及超过 12 行的你的消息(折叠时显示前 12 行,+ 8 lines)。展开后控件变为 − Hide details 或 − Show less。没有更多内容的条目没有控件。条目的标题行是它第一行有文字的行(消息的第一行):点击标题行也会切换,紧接着的第二次点击会再切换回来,而不是选择一个词。展开或折叠标题行在屏幕上的条目时,标题行保持在原来的那一行。每个条目单独展开,进行中的条目完成时保持原来的状态。

选择、搜索或聚焦活动期间,对话下方的底栏会显示相应的按键。复制的内容放到系统剪贴板;没有系统剪贴板时(例如通过 SSH),内容发送给终端(OSC 52),大多数终端会把它放到自己的剪贴板上,界面会提示这次复制未经确认。复制的结果在输入框上方显示几秒钟。

审批、提问或列表打开时,按键由它们处理;鼠标仍然可以滚动和选择,Ctrl-C 仍然复制已选择的内容。

Fullscreen 会捕获鼠标,所以使用终端自己的选择时通常需要按住 Shift 拖动。要用终端的选择复制,可以用 /raw 显示不带样式的对话。

Scrollback 下,对话由终端保存:用终端滚动、选择和复制。最新的条目留在底部区域上方的尾部,排版与 Fullscreen 相同:思考和工具调用在其中就地更新,条目的控件(+ 12 lines、+ Show details)显示或隐藏它的详情。

  • 尾部将要超过屏幕的 60%(至少 8 行)时,其中最早的已完成条目按显示的样子写入滚动历史;折叠且还有更多内容的条目末尾写有 ctrl + t to expand。回答超过上限时逐行写入,且只写入已提交的行:仍可能改变的部分(正在到达的表格、正在到达的一行)留在尾部。仍在进行的条目不会被写入:比尾部还高时,显示它的第一行和最新的几行。
  • 你发送下一条消息时,先把尾部整个写入,所以已结束回合的条目在此之前都可以展开。在原处打开另一个会话(/new、恢复会话)和切换到另一个对话时也会写入,退出时写入剩下的部分。
  • 回合进行中尾部不会变矮:折叠一个条目会留下空行,直到下一次写入。展开条目时先用这些空行;超出时尾部从底部区域向上增高,所以上方的条目(包括它的标题行)上移增加的行数。
  • 点击控件或条目的标题行显示或隐藏详情,按 F4 再按 Enter 也可以(Up/Down 在尾部的活动之间移动,Esc 离开)。
  • 为了接收点击,尾部显示控件时界面会捕获鼠标。滚轮的第一次滚动把鼠标交还给终端,终端从下一次滚动起开始滚动,直到你按下一个键或出现下一个条目。按住 Shift 拖动仍由终端选择。设置 tui.scrollbackMouse = "off" 时从不捕获鼠标;按键和对话记录仍然可用。
  • 已经写入的条目在对话记录(Ctrl-T)中展开。
  • 调整终端大小后,大小保持 75 ms 不变时,界面清除终端的滚动历史和屏幕,按新的宽度重新写入对话,每个条目保持写入时的样子(展开的仍然展开);尾部保持不变。写入的行数大致是终端滚动历史保留的行数:最后 1,000 行(Windows Terminal 中 9,001 行,WezTerm 中 3,500 行,Alacritty 中 10,000 行),省略了更早的行时,上方显示 Earlier messages are available — press ctrl + t to view the full transcript;对话记录中有全部内容。清除会带走底部区域上方的一切:界面启动前 shell 输出的内容、之前会话的行、另一个对话的行以及它们之间的分隔行。不响应这个序列(CSI 3 J)清除滚动历史的终端或终端复用器,会把旧的行保留在新的行上方。对话记录、设置中心或其他全屏视图打开时,重新写入要等它关闭后进行。
  • 调整大小时正在流式输出的回答此后按新的宽度继续,已提交的行保持原来的宽度;它结束后,对话会再重新写入一次,回答按新的宽度排版。

上下文压缩从 Agent 预留任务起就有独立活动条目,依次显示排队、压缩中、等待安装,以及完成(Context compacted)、失败或取消。耗时从 Agent 的开始时间戳计算,并在终态时间戳处停止。Agent 提供的摘要文本实时更新到条目详情中;默认收起,点击标题或按 F4 后 Enter 展开。更新始终替换同一条目,并保留展开状态。失败或取消会保留已收到的部分摘要;自动压缩失败也保留在 /warnings 中,失败的 /compact 仍会说明错误。恢复会话时,保存的摘要可展开查看;旧历史没有耗时,不会编造。正在进行的压缩从会话快照恢复。Provider 以请求过长为由拒绝、会话采用由此学到的窗口时(上下文窗口与压缩),对话会在随后的压缩之前提示一次:• The Provider refused the request as too long; this model's window is taken as 131072 from now on.

分层压缩

在 hierarchical 压缩策略下,模型用它的 compress 工具把对话中的片段折叠成它自己写的摘要。compress 调用以折叠的形式显示:标题行列出它折叠的范围及其主题(• Compressed context m00002–m00005 Setup),下面是它回执的第一行([Compressed m00002–m00005 → 1 block(s), ~8000 tokens saved.])。模型写的摘要和回执的其余部分是它的详情,在对话记录、Fullscreen 下的 Ctrl-T 和 F4 中显示。恢复的会话以同样的方式显示它的 compress 调用。

/compression 读取会话的压缩情况,既不改变会话,也不询问模型:

  • 面板(来自 billion-context):上下文相对窗口的占用、压缩之后发送的内容及其构成、折叠提醒及其给出的范围,以及每个活动块的层级、它替换的 token 数、摘要的大小和主题。下面是计数(已应用的 compress 调用、压缩和吸收的 token、存储和取回的工具结果),contentStore 开启时还有内容存储的大小。
  • /compression cache 显示缓存报告:最近一次请求的 token 和每次折叠,以及折叠节省的量。缓存的 token 是 Provider 报告的缓存读取;未报告的 Provider 显示为没有缓存。
  • 从未运行过该策略的会话会说明它没有使用分层压缩。

状态栏的 compression 项显示活动块数和折叠掉的 token 数。

如果压缩在某次请求中失败(其算法发生 panic),对话会显示一条警告 ⚠ Context compression failed; this turn goes on with the full history: …,回合余下部分按 standard 运行;/warnings 会保留这条警告。

上下文

/context 显示会话最近一次请求包含了什么,既不改变会话,也不询问模型。它读取的是快照,所以回合进行中也能用,此时显示该回合最近发送的请求。例如(略去了部分行):

/context

  Last request: about 75k tokens (estimated: about 4 bytes a token) · the Provider counted 74k
  Context window: 200k

  Instructions                 █░░░░░░░░░░░░░░░░░░░   3%   6.2k
  Tools (15)                   █░░░░░░░░░░░░░░░░░░░   5%    10k
  MCP/plugin tools (3)         ░░░░░░░░░░░░░░░░░░░░   1%   2.1k
  Context sections             ░░░░░░░░░░░░░░░░░░░░   2%   4.3k
    environment                ░░░░░░░░░░░░░░░░░░░░   0%    450
    skill_catalog              ░░░░░░░░░░░░░░░░░░░░   2%   3.9k
  User messages                ░░░░░░░░░░░░░░░░░░░░   2%   4.1k
  Assistant messages           █░░░░░░░░░░░░░░░░░░░   6%    13k
  Tool calls and outputs       ███░░░░░░░░░░░░░░░░░  16%    31k
  Free                         ████████████░░░░░░░░  62%   125k

  Cached tokens: last 61k · session 300k
  Uncached tokens: last 13k · session 110k
  Cache hit rate: last 82.4% · session 73.2% — 300k of 410k prompt tokens from cache (6 requests)
  • 各组按 billion-context 面板列出其明细的方式排列:每组一行,带一条表示它占窗口份额的条形、百分比和 token 数。依次是:指令;工具,Tools (N) 是 Agent 及其内置插件的,MCP/plugin tools (N) 是 MCP 服务器和已安装插件的;上下文分段,在它们的合计之下按类型各占一行;用户消息、助手消息、回传的推理、工具调用及其输出、续接上下文和压缩摘要;图片及其数量;请求的其余部分(Other request fields:模型、各项设置、请求本身的框架);以及 Free,即窗口减去请求。没有内容的组不显示。窗口未知时,各份额都相对于请求本身,也没有 Free 行。
  • 这些数字是估算:Agent 自己的估算,按请求序列化后的内容约每 4 字节一个 token、图片按其自身规则计算,也就是每次检查请求是否超出窗口时用的估算。各组相加等于请求的估算。标题行会注明这一点,响应返回后旁边是 Provider 统计的提示 token 数(在此之前,或者 Provider 没有报告时,显示 no count from the Provider)。
  • 本次运行还没有发送请求时,或者压缩替换了历史之后,它显示对下一次请求的估算,构建方式与压缩检查下一次请求时相同:不运行工具,也不调用模型。由于它在采样步骤之外构建,不包含插件为采样步骤准备的内容,在回合之外也不包含上下文分段;标题行会说明这一点。如果连这也无法构建,它会说明原因。
  • 提示缓存:Cached tokens(从 Provider 缓存读取的部分)、Uncached tokens(提示的其余部分)和 Cache hit rate,各自分为最近一次请求和整个会话,然后是会话的提示 token 中有多少来自缓存,以及统计了多少次报告了缓存数字的请求。会话的命中率按其全部提示 token 计算,包括没有报告缓存数字的响应。不报告任何缓存数字的 Provider 显示 not reported,从不显示 0%。
  • 宽度较窄时条形会变短,过长的标签用 … 截断;Fullscreen 与 Scrollback 中的显示相同。

对话记录

Scrollback 下,Ctrl-T 在终端的备用屏幕上打开整个会话的对话记录(T R A N S C R I P T),以紧凑方式显示,条目的控件显示它的详情(点击控件或标题行,或按 F4 再按 Enter,与阅读对话相同;Ctrl-O 切换每一次思考);再按一次 Ctrl-T 显示每个条目的详细内容,第三次关闭。/diff 以同样的方式显示差异。Fullscreen 下,Ctrl-T 改为就地显示对话的详细内容(见上文),/diff 覆盖屏幕直到你关闭它。

按键作用
Up/Down(k/j)滚动一行
Page Up/Page Down(Space、Ctrl-B/F)滚动一页
Ctrl-U/Ctrl-D滚动半页
Home/End到开头/结尾
q、Esc、Ctrl-C关闭
Ctrl-T(对话记录)详细,再关闭
Ctrl-O展开每一次思考,或全部折叠

详细内容中,对话记录显示每次思考的全文,每个工具调用都展开显示(滚动历史中是它们写入时的样子)。两种方式下,仍在进行的思考和工具调用都显示在它们开始的位置,并就地更新。其中的选择、复制和搜索与阅读对话相同(拖动、Ctrl-Space、F3)。

分页器打开期间回合继续运行,新内容立即出现在对话记录中,关闭后出现在尾部。

编辑之前的消息

输入框为空、没有回合运行、也没有打开任何列表或界面时,按 Esc 会显示 esc again to edit a previous message;按其他任意键则取消。再按一次 Esc 开始浏览你发过的消息,并高亮最近的一条:Fullscreen 下就地浏览,Scrollback 下在对话记录中浏览,两者都使用简洁视图。底部显示 Browsing · ←/→ prompt · ↑/↓ scroll · ctrl+t details · ↵ edit · esc back。

按键作用
←/→(h/l)上一条或下一条消息
↑/↓(k/j)滚动一行
Ctrl-T显示或隐藏详细内容
Enter编辑高亮的消息
Esc回到开始浏览时的位置,不做编辑

Fullscreen 下,对话的其他按键(Page Up/Page Down、Home/End、F3)照常可用,按其他任意键则结束浏览;Scrollback 下对话记录的按键照常可用,q 关闭它。

Enter 在会话的副本中编辑:会话在这条消息所在回合之前分叉,界面切换到分叉出的会话,它的对话停在这条消息之前,这条消息回到输入框中,供你修改后发送。原会话被完整归档:hanafubuki-agent sessions list --archived 可以找到它(见会话)。Agent 修改过的文件不会恢复,本次运行中第一次编辑时会提示这一点。消息附带的图片随消息一起回到输入框,显示为 [Image #1] 等,使用的是会话保存的副本。

  • 回合进行中发送的消息(补充消息)不是一个独立回合的开始,不能单独编辑:请编辑开始那个回合的消息。
  • 回合运行时,Esc 和以前一样中断回合;在没有回合运行、也没有消息等待之前,编辑会被拒绝。
  • 还没有发过消息时,第二次 Esc 显示 No previous message to edit.。Fullscreen 下只能浏览已加载的消息,向上滚动会加载更早的消息;Scrollback 下为恢复的会话最近 200 项中的消息。

思考过程

正在思考、压缩上下文和自动审核命令时,标题使用与 Working 相同的流动高亮,左侧圆点以白色闪烁。思考或压缩结束后,圆点保持显示并停止闪烁;从历史恢复的已完成活动也保持静态。状态行中的 Thinking 在正在思考且启用动画时也会高亮;已完成的活动和累计思考时间保持静态显示。

模型的每一段思考(一个推理条目)都是单独的条目,位于对话中发生的位置,与回答和工具调用按顺序排列:一个先思考、调用工具、再思考然后回答的步骤显示四个条目。模型思考时它显示为 • Thinking 3.4s,以十分之一秒计数;这段思考结束时,它在原处变为 • Thought · 20.7s(超过一分钟时为 1m 05s)。模型开始回答或调用工具时,这段思考最迟就此结束,即使 Provider 稍后才报告思考完成(Responses API 可能如此);Provider 此后发送的这段思考内容不在这里显示,但会保存下来,恢复会话时可以看到。

每个条目默认折叠为这一行,收到文本后带有 + Show details 控件。点击控件或这一行本身(Fullscreen 下、Scrollback 下条目还在尾部时,以及在对话记录中),或按 F4 再按 Enter,会在下方以暗色的 Markdown 显示文本,模型仍在思考时随流更新;− Hide details 再将它隐藏。每个条目单独展开,完成时保持展开。Ctrl-O 一次展开对话中的每一次思考(Scrollback 下是尾部中的思考,对话记录打开时是其中的思考),全部已展开时则全部折叠;之后的思考仍然以折叠开始。

Provider 没有发送文本时只有这一行,没有控件。如果回合在思考结束前就结束了(出错或被中断),这一行以已经过去的时间结束。Scrollback 下,思考离开尾部时按显示的样子写入滚动历史,之后无法再更改;对话记录(Ctrl-T)仍可展开它,再按一次 Ctrl-T 显示每一次思考的全文,与 Fullscreen 下 Ctrl-T 的详细对话一样。恢复会话时,每一段思考以同样的方式重放,默认折叠;文本在 Agent 的上限处被截断的思考显示为 • Thought · 20.7s (truncated)。

状态行会加上整个回合的思考时间 (Thinking 20.7s),回合完成后的分隔线也会写明 thought for 20.7s;两者都在思考结束处停止,回答流出时不会继续计时。

能看到什么取决于 Provider 发送了什么:有的只发送思考摘要,有的发送原始思考文本,有的什么也不发送。见 Provider 与模型。

工具调用

无论是哪个工具,一次工具调用都是一个条目,起初是折叠的。标题行说明它做了什么,圆点为绿色,失败时为红色,运行时是旋转指示;下方 └ 之后最多只有几行。它的控件(剩下的是输出行时为 + 12 lines,否则为 + Show details)在原处展开它,与阅读对话相同;对话记录的详细视图和 /raw 中每个调用都是展开的。折叠时已显示全部内容的调用没有控件。

工具折叠时展开后
exec_command• Ran cargo test(! 命令为 • You ran ls)、输出的最后 3 行(没有输出时为 (no output)),失败时加 exit 101 · 4.2s,在后台继续运行时加 still running · 4.2s;运行时为到目前为止的最后 3 行(见下文)$ cargo test、工具返回的完整输出,然后是 ✓ 4.2s 或 ✗ exit 101 · 4.2s 以及运行的目录;运行时为到目前为止的输出
write_stdin、resize_execution• Interacting with terminals,完成后为 • Interacted with terminals;每行显示等待、发送输入或调整大小及会话编号各次调用的输出和退出状态
apply_patch• Edited src/lib.rs (+12 -3)(Added、Deleted),或 • Edited 3 files (+20 -5) 并每个文件一行;没有应用时为 Failed to edit差异:每行前是行号(更新的文件从补丁应用的位置起算,没有应用时不带行号)和符号,带底色,块之间是 ⋮(渲染)
read_file• Read src/lib.rs (lines 1–120)文本,前面是行号,按文件的语言高亮
list_directory• Listed src (24 entries)各条目,目录在前,文件带大小
search_text• Searched "foo" in src (7 matches)每个匹配一行 路径:行: 文本,查询按原样匹配之处加粗
view_image运行时为 • Viewing image,完成后为 • Viewed image;下方显示 View 路径,多张图片使用复数每次图片调用的完整结果及媒体元数据
网络工具运行时为 • Searching the web,完成后为 • Searched the web;每行显示动作及查询或网址,搜索附带结果数量各结果的标题和地址、所取页面的标题和前 40 行,以及其他网络工具的完整结果
tool_list、search_tools运行时为 • Discovering tools,完成后为 • Discovered tools;每行显示 List tools / Search tools完整发现结果,包括普通搜索返回的 schema
create_goal、get_goal、update_goal运行时为 • Managing goal,完成后为 • Managed goal;每行显示 Create goal、Read goal 或 Update goal,下方显示状态、目标、Token 和耗时(含显式预算及剩余用量);未设置目标时显示 No goal set.完整目标结果
request_user_input等待时为 • Asking user,完成后为 • Asked user;下方显示 Ask 及问题标题,完成后显示每个问题 → 用户所选答案的文字完整询问结果
update_plan运行时为 • Updating plan,完成后为 • Updated plan;下方显示 Update plan 及对象完整计划结果
move_path、delete_path• Moved a → b、• Deleted x(没有更多内容)
Skill 工具运行时为 • Using skills,完成后为 • Used skills;每行显示动作和 Skill ID,例如 Read skill user:rust、Enable skill user:rust每次调用的完整指令或结果
MCP 工具及资源工具运行时为 • Calling MCP,完成后为 • Called MCP;每行显示完整工具名及对象,或 List resources / Read resource每次调用的完整结果,包括结构化字段和媒体摘要
记忆工具• Using memory,完成后为 • Used memory;列出、搜索、读取或提交记忆便笺,附资源、查询或操作资源 ID 与大小、带行号的匹配、带行号的正文或便笺回执
read_thread• Reading conversations,完成后为 • Read conversations;附会话编号返回的消息和分页信息
上下文工具• Managing context,完成后为 • Managed context;恢复、搜索、新上下文、缓存、吸收、检索和规则各次调用的完整结果;compress 保持独立的折叠回执
子代理工具Starting agent / Started agent、Sending message to / Sent message to、Assigning task to / Assigned task to、Interrupting agent / Interrupt requested for,以及等待、列出状态;默认显示结果前 3 行完整任务或消息、实际模型与思考强度、代理名称和编号、已记录的 Provider 与角色、消息送达结果或代理结果
其他插件工具• Called 工具名: 对象(或 • Failed)和它返回内容的前 3 行:文本(JSON 显示为一行);图片或音频显示为类型和大小(image/png · 33.2 KiB),链接或资源显示为地址;或者结构化结果的字段全部内容,JSON 缩进显示(渲染)

连续的读取、列出和搜索调用共用一个条目,与 Codex 相同:有调用在运行时为 • Exploring,之后为 • Explored,每个调用一行(连续的读取合为 Read a.rs, b.rs,List src (24 entries),Search "foo" in src (7 matches)),有调用失败时标题加 · 1 failed。展开后,每个调用按上表显示。它们之间出现任何其他条目(思考、消息、其他工具)都会开始一个新条目;单独一个调用按它自己的方式显示。compress 调用折叠显示(分层压缩)。

图片、Skill、MCP、工具发现、网络、目标、用户询问、终端交互、记忆、会话读取和上下文管理调用即使只有一次也采用紧凑分组。任务计划保持清单展示。记忆便笺显示为等待整合,不表示已经生效。展开时保留分类标题。Responses 原生搜索和普通函数搜索都归入工具发现类别。网络类别包括各类搜索、网页获取、研究、天气、缓存查询和搜索提供者检查。连续同类调用共用一个条目;切换类别,或插入消息、思考、其他工具时结束该组。MCP 名称保留命名空间,方便区分不同服务器中的同名工具。未完成的调用标记为 (running);失败时标题显示失败数,对应行标记 (failed),下方保留错误预览。成功结果收起到可展开的详情中。恢复会话时使用相同的分组;调用被中断后停止动画并标记失败。

未分组的调用,其显示内容在它完成后才读取,所以标题行可能在片刻之后才变化:在此之前显示为 • Called 工具名(命令为 • Ran 命令)。从调用开始到那时,标题行下方有一个暗色的行,占住它最初几行的位置(命令运行时为 (running…),其他情况为 …),这些行出现时替换它,而不是把上方的内容推开:调用完成时只增加它折叠后其余的行、它的控件,以及失败的命令的退出状态。恢复的会话以同样的方式显示其中的调用,并像当时一样分组。命令的输出是工具返回的内容,即 Agent 渲染终端文本之后的结果(命令和终端),带着程序输出时的颜色(渲染)。

命令运行时,它的输出流式显示在它的条目中。+ Show details 控件从调用开始就出现,无需等待输出,并保持到最终显示到达。展开一次后,新输出会持续显示,无需再次点击。标题行为 • Running cargo test · 3.4s,带有到目前为止的时间(标题行最后一行放不下时间的最大宽度 · 99h 59m 59s 时不显示,所以标题行不会随着时间增长重新换行);下方各行是它已输出的最后 3 行,与终端显示的相同:原地重绘的行(进度条、伪终端重绘的一行)在原处变化。展开后显示 $ cargo test 和到目前为止的各行。超过 400 行时保留最前的 200 行和最新的 200 行,中间是 … +N lines;超过 1 KiB 的行会被截断,… 代表被跳过的输出。条目在下一帧绘制,而不是每段输出都绘制一次。命令返回 session id 后,条目仍保持运行状态,后续输出继续流式显示,即使模型已经结束本轮对话;界面显示无需调用 write_stdin 轮询。进程实际结束后,计时停止并显示退出状态。前台命令使用工具最终返回的内容显示结果;后台命令保留有界的实时输出。/ps 也能查看后台终端。重新打开会话时,仍显示历史中保存的工具返回结果。

询问和目标结果默认显示前五行文字,长行自动换行以保留答案;通过 Show details 查看完整结果。实时显示和恢复会话都从保存的工具参数与结果生成这些摘要。

启动子代理后显示名称和编号、启动结果中实际使用的模型与思考强度,以及任务开头。消息和追加任务会区分已送达当前回合、已排队等待下一回合、已启动新回合;中断结果显示原状态,等待结果保留超时、空闲、完成答案或错误。默认视图会截短长行及较长结果,通过 Show details 查看完整的已保存内容。恢复会话时重建相同展示;旧结果缺少模型信息时会说明未记录。

审批

权限模式要求审批的工具调用会弹出确认框,标明操作类型(如 Would you like to run the following command?)、摘要和风险等级:

选项按键
Yes, proceed:允许这一次y 或 1
Yes, and don't ask again this session:本会话内同类操作不再询问(仅在可用时提供)a 或 2
No:拒绝n 或 Esc

模型请求在沙箱之外运行的命令,会在摘要中说明这一点,并附上模型的问题(… outside the sandbox in 目录: 命令 (reason: 问题));对它选择本会话内允许,只允许这条命令以后在沙箱外运行。

也可以用 Up/Down 选择后按 Enter。Ctrl-C 拒绝当前请求以及排在后面的所有请求。其他请求会排队,依次弹出。对话记录中会留下 ✔ You approved ... 或 ✗ You did not approve ...。

子代理等待的审批也以同样的方式显示在它的父会话中,摘要以 Subagent NAME: 开头(子代理)。

提问

模型可以向你提出一个或多个问题,每个问题都有几个选项。界面显示 Question 1/2、问题和选项:

  • Up/Down(k/j)选择,Enter 确认并进入下一题,最后一题按 Enter 提交。
  • 数字键直接选择对应的选项并前进。
  • Left 回到上一题,Right 或 Tab 进入下一题。
  • Esc 或 Ctrl-C 中断回合。

问题只能从选项中选择,不能输入自由文本。

恢复会话

hanafubuki-agent resume           # 打开恢复选择器
hanafubuki-agent resume 12        # 恢复会话 12
hanafubuki-agent resume --last    # 恢复最近一个运行过回合的会话
hanafubuki-agent resume 12 "继续" # 恢复后发送一条消息

恢复选择器按最后更新时间列出运行过回合的会话:更新时间、创建时所在的 Git 分支和目录(有会话带有它们时才显示),以及标题(还没有命名时是第一条消息)。子会话不列出。直接输入文字可以搜索标题,Up/Down 和 Page Up/Page Down 移动,Enter 恢复,Esc 返回(在 resume 启动时则回到没有会话的界面),Ctrl-C 退出。

  • 归档的会话。 Tab 在会话和归档的会话之间切换。Ctrl+A 归档选中的会话;在归档列表中则是恢复它(在那里按 Enter 也会恢复),它随即离开列表。界面正在显示的会话不能在这里归档,要用 /archive。
  • 在界面中。 /resume 打开选择器。/resume ID 恢复该 ID 的会话,/resume 标题 恢复唯一有这个标题的会话;没有或有多个会话使用这个标题时,选择器打开并搜索它。

恢复后,界面显示信息框和会话最近的 200 项记录:消息、模型提出的计划、工具调用及其输出、上下文压缩。Fullscreen 下,向上滚动到更早的记录时,每次读取 200 项(↑ Loading earlier messages…);输出先于调用被读取的工具调用不显示输出。Scrollback 下更早的记录不显示,并提示 Earlier messages are not shown.。之后发送的消息接着这个会话继续。

没有可恢复的会话时,resume --last 与 hanafubuki-agent 一样以没有会话的状态启动。会话 ID 可以用 hanafubuki-agent sessions list 查看,见会话。

退出

输入 /quit 或 /exit,或者在 1 秒内按两次 Ctrl-C(输入框为空时也可以按两次 Ctrl-D)。退出时界面恢复终端状态(Fullscreen 下离开备用屏幕,对话也随之消失)并关闭 Agent。如果当前有主会话,随后会打印恢复命令:

To continue this session, run:
  hanafubuki-agent resume 12

命令指向主会话,即使退出前显示的是旁路对话或子代理。没有打开会话时不显示提示,包括执行 /new、/archive 或 /delete 之后。显式指定的 --data-dir 会以绝对路径保留在命令中,并按 Unix 上的 POSIX shell 或 Windows 上的 PowerShell 规则加引号。退出会停止本地 Agent;这条命令用于恢复已保存的历史,不表示任务仍在后台继续运行。

退出码为 0;Agent 无法启动、要恢复的会话无法打开或无法设置 -m 指定的模型、终端无法使用时为 1;没有终端时为 2。

渲染

回答、计划和思考中的 Markdown 按 Codex 的方式显示:

  • 列表。 无序列表项的标记是 •;有序列表项保留编号。一个列表项占了不止一行时(换行、有多个段落或嵌套列表),同一列表的下一项前空一行。在 Fullscreen 和对话记录中,回答或计划结束后,这样的列表每两项之间都空一行,与 Codex 相同。
  • 任务列表。 - [ ] 和 - [x] 显示为 ☐ 和 ☑,取代项目符号;有序列表项则显示在编号之后。列表项的后续行与它的文字对齐缩进。
  • 表格。 管道表格按列排版:表头加粗,下面是粗分隔线,行与行之间是细分隔线,每列按分隔行的标记对齐(:---、:---:、---:)。单元格保留强调、代码和链接,在列内换行;宽字符(中日韩文字、emoji)占两列。表格比对话宽时,长词元(路径、URL)的列先让出宽度,然后是文字的列,最后是短值的列。
  • 太窄的表格。 当短值会被拆开、文字会挤成一条窄长的竖条,或者每列连三格都放不下时,每一行改为显示成一条记录:每个单元格一行 表头 值,记录之间用分隔线隔开;终端非常窄时,每个表头单独一行,值在它下面。只有表头没有行的表格这时保留它的管道源码。
  • 表格后的文字。 紧跟在表格后、没有管道符的一行,Markdown 解析器会把它当成表格的一行;它显示在表格之后,作为普通文字。
  • 围栏里的表格。 在回答中,内容含有表格的 ```md 或 ```markdown 围栏显示为其中的 Markdown,而不是代码。其他围栏仍是代码,不含表格的 Markdown 围栏也是。
  • 链接。 网页链接以链接样式显示文字,并作为指向其地址的终端超链接(OSC 8),在终端中点击即可打开。在已知能打开这类链接的终端上(见下文),只显示文字:docs。在其他终端上,以及在终端复用器中,文字后面跟着地址,地址同样带有链接:docs (https://example.com/docs);文字什么都不显示的链接在所有终端上都显示地址。正文中直接写出的网页地址(https://example.com/a,不在代码中)也使用链接样式,并以同样的方式带有链接。只有带主机名、不超过 8 KiB 的 http 或 https 地址会成为超链接,其中的控制字符会被去掉。指向本地文件的链接显示文字和文件的路径;文件在会话的工作目录下时,路径相对于该目录,位置写作 :行:列:the parser (src/parse.rs:12:3);没有文字时只显示路径。它不是超链接,其他链接(mailto: 等)也不是,它们显示文字和目标。思考中的链接显示为文字,各自带着地址。
  • 长地址。 网页地址在一行放得下时保持完整,宁可移到下一行也不拆开。比对话还宽的地址在每行的边缘截断,与终端自己换行的方式相同,每一段都打开完整的地址。在表格单元格中,地址在它的列内换行。界面的选择复制、查找栏搜索的都是显示出来的文字:地址被隐藏时,/raw 会显示带地址的 Markdown。
  • 数学公式。 TeX 数学公式以 Unicode 记号显示,与 Codex 相同。行内公式写在 $…$ 或 \(…\) 之间:$\alpha^2 + \beta_{10}$ 显示为 α² + β₁₀,$\sqrt{x}$ 显示为 √(x),$\frac{a}{b}$ 显示为 ((a)/(b))。独占几行、写在 $$…$$ 或 \[…\] 之间的是独立公式,需要时占多行:分数是分子、分数线、分母上下排列,求和与积分的上下限在符号的上方和下方,aligned 方程按列对齐,pmatrix 用高的圆括号括起,\boxed 加上边框。希腊字母、运算符、关系符、箭头、集合与逻辑符号、\mathbb、\mathcal、重音、\text、\left/\right 定界符,以及有 Unicode 上标或下标的字符都会转换;其他上下标照写(x_{gpt})。公式用到转换器不认识的命令(\unknown、\sqrt[3]、matrix),独立公式比对话宽度减去四列还宽,或者多行的独立公式位于列表或引用中时,按源码显示,像文字一样换行。代码、链接和 HTML 中的公式保持原样;```latex 围栏也一样,它是代码。公式从不带链接,也不按地址的样式显示。
  • 保持为文字的美元符号。 单个 $ 只在以下情况下开始一个公式:它没有被转义(\$),后面不是空格、( 或 {($(cmd)、${HOME}),并且同一行中 4 KiB 以内有一个结束的 $,它不在空格之后,后面也不紧跟字母或数字($5 and $10、$HOME/$USER、$x=$y);没有运算符的数字(($5) or ($10))和全大写的单词($USD$)也不是公式。中日韩文字算作字母:公式 $x^2$ 很 是公式,公式$x^2$很 不是(\(x^2\) 在哪里都是公式)。$$ 和 \[ 只在同一行中前面没有任何内容时才开始独立公式,列表标记和引用的 > 也算内容(echo $$ 和 - $$x$$ 保持为文字);跨多行、结束符所在行后面还有文字的独立公式不算公式。这些是 Codex 的规则,也有它的局限:结束的 $ 后面跟着标点时,像 s/^a$/b$/ 这样的文字会成为公式(显示为 s/^a/b/);文字之后的 $$ 会与 4 KiB 以内下一个不在行首的 $$ 配对,两者之间的公式按原样显示;以 $$ 或 \[ 开头而一直没有闭合的一行,会让回答余下的部分都按原样显示;\(…\) 和 \[…\] 没有这样的保护,所以 Markdown 中转义的圆括号和方括号也会成为公式:f\(x\) 显示为 fx,s/\(a\)\(b\)/\2\1/ 显示为 s/ab/\2\1/,单独一行的 \[note\] 显示为 note,空的 foo\(\) 保留反斜杠,而单靠 Markdown 会显示圆括号和方括号(关闭数学公式时它们保留反斜杠)。写在代码(`…`)中则都不会发生。
  • 图表。 已闭合的 ```mermaid 围栏属于 Codex 能绘制的子集时,用制表符绘制成文本图表,与 Codex 相同:流程图(flowchart 或 graph,默认自上而下,可写 LR、RL 或 BT;矩形 A[…]、带 ◇ 的判断 A{…}、圆角的体育场形 A([…]),节点标签中的 <br>;实线、虚线和双向的边及其标签;& 分组、链式写法和环);时序图(participant 和 actor、别名、箭头 ->、->>、-->、-->>、-x 和 --x、发给自己的消息、覆盖一个或两个参与者的 Note over,以及可以嵌套的 loop、带一个 else 的 alt、opt、critical 和 break);平面状态图(stateDiagram-v2 或 stateDiagram,[*] 作为开始和结束,带标签的转换,描述);类图(成员,继承、组合、聚合、关联、依赖和实现,基数,标签);实体关系图(带 PK、FK、UK 和注释的属性,四种基数)。节点按图的方向依次排列,每条边有自己的通道,线条从不合并;交叉处是 ╪。方框使用语法主题的类型颜色,线条使用它的注释颜色。标签中的中日韩文字和 emoji 算作两列。图表中的内容从不带链接,也不按地址的样式显示。
  • 保持为代码的图表。 无法绘制的围栏先显示一行说明原因的暗色文字,再像普通代码块一样显示它的代码:其他种类的图(pie、gantt、gitGraph、mindmap 等);子集之外的语法(子图、其他节点形状、样式、click、%%{init: …}%% 这样的指令、节点标签中 <br> 以外的 HTML、&amp; 这样的实体、组合字符或零宽字符、非 ASCII 的标识符);或者超出限制的图:源码超过 16 KiB,超过 16 个节点、24 条边(& 展开后计算)或一个节点中 16 个成员,超过 8 个参与者、64 个事件或 4 层嵌套片段,一行标签超过 40 列,或者无论宽度多少,绘图超过 65,536 个单元格。绘图比对话宽度(减去列表或引用的缩进)还宽时,显示 This Mermaid diagram doesn't fit the current terminal width. 这一行和代码。回答中一直没有闭合的围栏显示代码,不加说明;空的围栏什么也不显示。

例如,回答中的这个围栏:

flowchart TD
    A[Request] --> B{Valid?}
    B -->|yes| C[Reply]
    B -->|no| A

在 40 列下绘制为:

┌──────────┐
│ Request  │
│          ├────────┐
│          ├◄───────╪───┐
└──────────┘        │   │
                    │   │
                    │   │
┌──────────┐        │   │
│ ◇ Valid? │        │   │
│          ├◄───────┘   │
│          ├──yes─────┐ │
│          ├──no──────╪─┘
└──────────┘          │
                      │
                      │
┌──────────┐          │
│ Reply    │          │
│          ├◄─────────┘
└──────────┘

每条边从源节点的 ├ 出发,在目标节点的 ├◄ 进入;标签写在出发的位置。同一张图写成 flowchart LR 时从左到右排列,宽 41 列,所以在 40 列下改为显示说明和代码。

回答或计划流式输出时,内容随到随显示,与 Codex 相同:

  • 每一行在它的换行符到达后渲染,它的各行随后提交,每帧一行;积压时(八行在等待,或有一行已等待 120 ms)一次全部提交。提交的行不再改变。
  • 后续行仍可能改变的部分留在已提交的行之后,随新行到达重新绘制:表格从表头开始,直到后面出现别的块(每到达一行都重新排版表格,每一行在它的整行到达后才显示);```md 围栏在闭合前显示为代码,闭合后显示为其中的表格,或仍是代码;单独一行的列表项标记(它的文字可能出现在标记所在的行);以本地文件链接结尾的一行(后面的 : 说明 行会接在它后面)。在 Scrollback 中这部分留在尾部,提交后才写入滚动历史。
  • 仍在到达的那一行随着增长显示(最多显示最后 8 KiB),表格和围栏中除外;链接在地址完整之前显示为 [链接文字]。
  • 独立公式到达期间从开始的那一行起显示为源码,在结束符到达之前留在已提交的行之后;结束符到达后再排版。公式内仍在到达的那一行显示为源码并换行;开始独立公式的一行($$\frac{1}{2}$$)在它的换行符到达之前也是如此。在结束符之前就结束或被中断的回答保留公式的源码。
  • 围栏代码块随到达逐行高亮。
  • ```mermaid 围栏到达期间显示为代码,逐行高亮,留在已提交的行之后;它的结束围栏把它变成图表(或说明和代码),直到后面出现别的块之前都留在那里,所以期间调整大小仍可改变它。在围栏内结束或被中断的回答保留它的代码。
  • 在 Fullscreen 和对话记录中,列表流式输出时各项之间没有空行;回答结束后按上面的方式加上空行,所以列表中有多行列表项的回答在结束时会多出几行。
  • 回答结束后,它的各行由按 Markdown 排版的回答取代。若已提交的行与之不同(=== 行把上一行变成标题、链接的定义在使用之后才到达、调整了大小),Scrollback 会再重新写入一次对话。

回答和计划保留它们的 Markdown,按显示时的宽度排版:调整终端大小后,表格在按列排版和记录之间切换,独立公式在排版和源码之间切换,图表在绘图和说明加代码之间切换,列表、文字和代码按新的宽度换行,在 Fullscreen、对话记录和 Scrollback 的重新写入中都是如此(阅读对话)。流式输出期间调整大小时,尚未提交的部分按新的宽度排版;已提交的行保持原来的宽度,直到流结束,由按 Markdown 排版的回答取代。恢复的会话中的回答和计划从一开始就按 Markdown 排版。选择或搜索的匹配在结束之前保持它建立时的各行,按新的宽度重新换行。

命令的输出保留程序输出的颜色和属性,与 Codex 相同:运行时的条目中、完成之后以及恢复的会话中都是如此,模型运行的命令和 ! 命令都一样:

  • 保留什么。 程序的 SGR 序列(ESC [ … m)设置的前景色和背景色、粗体、暗色、斜体、下划线和反显。16 种基本颜色是终端自己的颜色,因此跟随终端的主题;256 色调色板和 24 位颜色原样传递。闪烁、隐藏文字、删除线、上划线和下划线颜色被丢弃,文字按普通样式显示。
  • 从不保留什么。 其他所有序列像以前一样作用于文字或被丢弃(回车、行内移动和擦除;其他光标移动、标题、超链接、写剪贴板、切换屏幕等),到达屏幕的只有样式:输出无法移动光标、修改标题、写剪贴板,也无法让颜色延续到它自己的文字之外。
  • 在哪里显示。 折叠时,最后几行以各自的颜色变暗显示;展开时和在对话记录中,折行后的行保留颜色。样式像在终端中一样从一行延续到下一行,直到程序重置它;在被跳过的输出(流式显示时的 … 行,结果中的 [… N bytes omitted …])之后重新从普通样式开始。/raw、剪贴板、查找栏和导出只看到文字。
  • 什么时候有颜色。 命令以 NO_COLOR=1 和 TERM=dumb 运行(环境变量),所以大多数程序不输出颜色;强制输出颜色的程序(ls --color=always、cargo --color=always、grep --color=always)或者无论如何都写出这些序列的程序会显示颜色。在伪终端中,颜色取自屏幕的单元格,在屏幕应用了所有序列之后读取,所以用 Windows ConPTY 的序列重绘时,它画出的颜色也会保留。模型从不读到这些颜色:它得到的是纯文本。

四个设置可以关闭这些渲染,对此后显示的内容以及调整大小后重新排版的回答和计划生效(在设置中心的 Interface 标签页,或用 config set):

  • tui.rendering.tables = false 时,表格以及含有表格的 ```md 围栏按源码显示。
  • tui.rendering.lists = false 时,- 和 [ ]/[x] 按原样显示。
  • tui.rendering.math = false 时,每个公式连同定界符和 TeX 按原样显示。公式仍按上面的规则识别,所以其中的反斜杠、* 和 _ 不会被当成 Markdown:\(x^{2}\) 保留反斜杠,而单靠 Markdown 会把它们去掉。流式输出时仍未闭合的独立公式照样如上保留。
  • tui.rendering.mermaid = false 时,```mermaid 围栏显示为原本的代码块,不加说明,流式输出时也像普通代码块一样。

工具的其他输出和补丁的差异按 Codex 的方式排版:

  • JSON。 工具返回的文本是一个 JSON 值时(MCP 工具的结果、插件的输出),折叠时显示为一行,每个 : 和 , 后面加一个空格:{"name": "ratatui", "versions": ["0.29", "0.30"]}。展开时和在对话记录中缩进两个空格,每个值一行。键保持原来的顺序,数字和转义保持原来的写法。不是一个 JSON 值的文本,以及超过 1 MiB 或嵌套超过 128 层的 JSON,按原样显示;/raw 中的文本也都按原样显示。
  • 各项内容。 工具的输出逐项显示:图片或音频显示为媒体类型和大小(image/png · 33.2 KiB),从不显示数据本身;链接显示为 link: URI;嵌入的资源显示为 embedded resource: URI,后面是它的文本,二进制资源则是它的媒体类型和大小。服务器放在这些字段中的换行和转义序列不会显示。
  • 差异。 补丁展开后的差异每行一行:行号、符号,然后是这一行,按文件的语言逐块高亮。新增的文件从 1 开始编号;更新的文件从每块在文件中应用的位置起算,删除的行按补丁前的文件编号,其他行按补丁后的文件编号;没有应用的补丁,或者在 Agent 记录这些位置之前记录的补丁,其更新不带行号。长行按显示宽度折行(宽字符两列,制表符四列),续行对齐到行号和符号之后;长路径在自身下方折行。
  • 差异的颜色。 新增和删除的行从左到右整行带底色:24 位颜色的终端中是深绿和深红(#213A2B、#4A221D),256 色的终端中是调色板颜色 22 和 52(终端要求)。16 色时没有底色:符号和没有高亮的行显示为绿色或红色。语法主题为 markup.inserted 和 markup.deleted(或 diff.inserted 和 diff.deleted)设置了背景色时,改用主题的背景色。主题的颜色会调整到在底色上清晰可读;在 16 色的终端中,主题的 24 位颜色不会显示在差异中。Codex 在浅色背景上使用浅色配色;界面不向终端查询背景色,所以总是使用深色配色,与 Codex 在终端没有应答时相同。

语法高亮

命令行从开始显示 Running 到结束显示 Ran 都使用语法主题着色,包括后台继续运行的命令和 ! 命令。展开条目可查看完整的高亮命令。

回答中的围栏代码(```rust)按语言高亮:语言可以是名称、别名或文件扩展名。没有标明语言,或者语言界面不认识的代码块保持纯文本。补丁的差异按每个文件的扩展名逐块高亮,显示在各自的底色上(渲染);/diff 的输出也按每个文件的扩展名高亮,+ 和 - 保留各自的颜色,删除的行变暗。超过 512 KiB 或 10,000 行、或者有一行超过 4 KiB 的代码不做高亮。

语法和 32 个主题来自 two-face 附带的集合(选自 bat)。/theme 在设置中心打开主题页面,列出它们和自定义主题:

  • 在列表中移动时,高亮的主题立即生效,并显示在一段示例差异上:终端较宽时在列表旁边,否则在列表下方。输入文字可以筛选列表。
  • Enter 保留这个主题,并保存为 tui.theme。Esc 和 Ctrl-C 恢复打开列表时使用的主题。
  • 自定义主题是数据目录下 themes/ 目录中的 .tmTheme 文件,名字是去掉 .tmTheme 的文件名。无法作为主题读取的文件不会列出;与内置主题同名的自定义主题以内置主题为准。
  • 没有设置 tui.theme 时使用 ansi 主题,它用终端自己的调色板着色,因此在浅色和深色背景下都清晰。tui.theme 指定的主题不存在,或者自定义主题无法读取时,会产生一条警告,并使用默认主题。
  • 对话中已经显示的内容保持绘制时的颜色。

状态栏和终端标题

输入框下方的底栏显示状态栏:关于会话的若干项目,以 · 分隔。还没有值的项目不显示:不在 Git 仓库中时没有分支,会话有标题之前没有标题。tui.statusLineColors 为真时,每个项目取主题中的颜色;否则整行变暗。

项目可以指定自己的位置,在 tui.statusLine 里写作 model:right-2:底栏的第 1 到 9 行,左端或右端。只写 ID 时在第一行左侧。在 /statusline 的设置页里,l 和 r 把高亮的项目放到左端或右端,1 到 9 放到对应的行,p 在四个角之间循环;o 循环切换溢出规则,列表下方的按键说明会列出这些键。按键说明上方的预览按底栏的实际布局逐行绘制,所以按 Enter 保存之前就能看到按键的效果。一行放不下同一个位置上的内容时,由 tui.statusLineOverflow 决定:wrap-all(默认)两侧都换行,wrap-left 保留右侧的行并把左侧换到它下面,truncate 在右侧开始处截断左侧。

项目的颜色来自主题;tui.statusLinePalette 可以逐项覆盖(model:cyan、context-window:#ff8800)。/statusline palette 无需手写即可编辑一项:从状态栏自己的项目 id 中选,或直接输入一个,然后从十六个颜色名中选,或输入 #rrggbb。颜色是十六个 ANSI 名称之一(black 到 white,另有 gray 和 light*),或 #rrggbb;无法读取的条目会被忽略并给出警告。--no-colors 仍会把整行变暗,与调色板无关。

第二行右侧是各项计数,形如 2 terminals · 1 agent · 3 warnings,按此顺序,为零的项不显示,全为零时整块为空。点击其中一项会打开它对应的地方:终端和 Agent 打开 /tasks 的相应页签,警告打开 /warnings。警告就是 /warnings 会列出的那些,忽略一条后计数随之减少。

项目显示
model模型
model-with-reasoning模型及其推理强度(默认显示)
background-tasks保留为设置项,但状态行不再显示它:运行中的终端、Agent 和警告计数是底栏的第二行,各自可点击,都没有时该项为空
reasoning推理强度
current-dir工作目录,主目录写作 ~(默认显示)
git-branch第一个工作区目录检出的分支,分离状态时是短提交号,从 .git 读取
context-remaining、context-usedContext 75% left、Context 25% used,知道模型的上下文窗口之后显示
context-windowContext 1M,模型的上下文窗口大小,知道之后显示
context-used-tokens、context-left-tokens184K used、816K left,上下文中已有的 token 与剩余空间,知道窗口之后显示
cache-hit-rateCache 87% hit:上一次提示中被提供方缓存命中的比例,在提供方上报缓存读或写之后显示
cache-hit-tokens、cache-miss-tokensCache 79K read、Cache 12K uncached:上一次提示中命中与未命中缓存的部分
used-tokens会话的输入和输出 token 总数,有用量之后显示
total-input-tokens、total-output-tokens12K in、3.4K out
session-id会话 ID
session-title会话标题(默认显示)
task-progressTasks 2/5:最近的任务计划中已完成的步骤数和总步骤数
permission-mode会话的权限模式,没有时是配置的 permissionMode
goalGoal: 目标 (状态),会话设有目标时显示
compression3 blocks, 42K saved:分层压缩的活动块数和折叠所替换的 token 数,会话运行过它之后显示
roleRole: 名字,会话有 default 以外的角色时显示

终端标题(OSC 0)有自己的项目,以 | 连接;默认是旋转指示、会话标题和项目名称。

项目显示
app-namehanafubuki-agent
project-name工作目录的名称
current-dir工作目录
activity回合运行时的旋转指示
run-stateReady 或 Working
session-title会话标题
model模型
task-progressTasks 2/5
  • 不带参数的 /statusline 或 /title 在设置中心打开它的设置页面:上下键移动,空格打开或关闭高亮的项目,左右键调整它的顺序,Enter 保存(tui.statusLine 和 tui.statusLineColors,或 tui.terminalTitle),Esc 取消。状态栏的设置界面预览这一行,会话还没有的值用示例代替。标题的设置界面打开期间直接设置终端标题;Esc 会恢复原来的标题。
  • 带参数时只对本次运行有效,不会保存。/statusline git-branch context-remaining 按这个顺序显示这些项目;--colors 和 --no-colors 打开或关闭颜色。/title app-name model 设置标题的项目;/title --clear 把标题交还给终端。不认识的项目会被拒绝,并列出所有项目。
  • [tui] 中界面不认识的项目会被忽略,每个都产生一条警告。
  • 标题写入前会清理:删除控制字符和不可见的或双向文本格式字符,连续空白合并为一个空格,最长 240 个字符。在 GNU Screen 中(设置了 STY)只使用 ASCII。
  • 第一次设置标题前,界面把终端原来的标题压入终端的标题栈(XTWINOPS),不再设置标题时和退出时再弹出恢复。不支持标题栈的终端会留下空标题。

按键映射

下表中的每个动作都有默认按键,tui.keymap.上下文.动作 可以修改它们:一个按键或一组按键,[] 表示取消这个动作的绑定。动作先取它所在上下文中的设置,没有时取 tui.keymap.global.动作(只要没有同名的全局动作:global.page_up 同时设置 transcript.page_up 和 pager.page_up),再没有时使用默认按键。

[tui.keymap.global]
open_transcript = "ctrl-q"
leader = "ctrl-b"

[tui.keymap.chat]
toggle_thinking = ["ctrl-o", "f2"]
open_presets = "ctrl-b 1"

[tui.keymap.editor]
yank = []
  • 按键写作修饰键加按键,用 - 连接:ctrl-t、alt-<、shift-enter、page-down、f3、space、minus;大写字母等于 shift- 加这个字母。符号带不带 Shift 都匹配,因为各终端的报告方式不同;但在带 Ctrl 或 Alt 时,不需要 Shift 的符号(美式键盘上的 ,、.、/ 等)加上 Shift 就是另一个键:alt-shift-, 是 Alt+<,不是 alt-,。
  • 组合键是用空格分开的两个按键(ctrl-q o):第一个键等待第二个键一秒钟。leader K 是前导键(global.leader,默认 Ctrl-X)再按 K;前导键会一直等到下一个键。没有完成任何组合的按键,或 Esc,会把两个键都丢弃。如果配置的某个按键正是默认前导键,它优先:除非 global.leader 另行设置,前导键就没有绑定。
  • 上下文是读取按键的地方:global 处处有效,chat 和 composer 在输入框获得按键时有效,editor 在所有文本输入框中有效,transcript 在 Fullscreen 的对话中(与输入框同时)有效,pager 在对话记录和 /diff 中有效,agents 在指挥中心中有效。在输入框旁边,不能绑定会输入文字的按键(不带 Ctrl 或 Alt 的字母),也不能绑定以它开头的组合键;只在输入框为空时读取的动作(composer.show_shortcuts、composer.previous_agent、composer.next_agent)可以绑定这样的按键,但仍不能绑定以它开头的组合键。
  • 冲突:同一个按键(或组合键)不能触发同时读取的两个动作,不能是另一个动作的组合键的开头,也不能是界面保留的 Ctrl-C(以及 Ctrl-D,编辑框和分页器中除外)。默认就共用按键的动作仍然允许:chat.interrupt_turn 和 chat.edit_previous(Esc)、composer.submit 和 editor.insert_newline(Enter)、历史和编辑框的 Up、Down、global.open_transcript 和 pager.close_transcript、composer.previous_agent 和 editor.move_word_left(Alt+Left)、composer.next_agent 和 editor.move_word_right(Alt+Right)。
  • 无法使用的设置(不认识的上下文或动作、不是按键的字符串、冲突)会让这个动作保留默认按键,并产生一条警告。

/keymap 在设置中心打开按键映射页面,列出所有动作及其按键(输入文字可以搜索)。选中一个动作后,可以替换它的按键或增加一个(一个按键、两个按键,或前导键加一个按键)、删除其中一个、取消绑定,或恢复默认按键。新的按键在按下时捕获(Esc 取消);冲突的按键会被拒绝并说明原因,可以再换一个。修改保存到 tui.keymap,立即生效。/keymap debug 列出每个动作的按键,并标明 default(默认)或 configured(已配置)。

弹出列表、列表、表单、审批和提问保留它们自己的按键(方向键、Enter、Esc、Tab),对话中的选择、搜索和选择模式、浏览之前的消息,以及历史搜索(Up、Down、Ctrl-S、Enter、Esc)也一样。

动作默认按键作用
global.leaderctrl-x开始一个前导键组合(leader p)的键
global.open_transcriptctrl-t显示对话的详细内容(Fullscreen)或打开对话记录(Scrollback)
global.find_transcriptf3在对话中查找文本
global.focus_activityf4聚焦工具调用的分组,以展开或折叠
global.select_transcriptleader [用键盘在对话中选择(Fullscreen)
global.focus_pane_leftleader left从旁路对话或子代理回到主对话
global.focus_pane_rightleader right让旁路对话获得焦点
global.toggle_side_conversationleader tab在主对话和旁路对话之间切换
global.move_divider_leftleader <向左移动窗格分隔线:旁路窗格变宽(Fullscreen)
global.move_divider_rightleader >向右移动窗格分隔线:旁路窗格变窄(Fullscreen)
global.equalize_pane_widthsleader =让两个窗格等宽(Fullscreen)
global.toggle_pane_zoomleader z只显示获得焦点的窗格,或恢复两个窗格(Fullscreen)
global.hide_paneleader x关闭旁路对话,或离开正在显示的子代理
global.open_agents无打开指挥中心(在空输入框上按 Left 也会打开)
global.open_tasksleader t打开后台任务管理器
chat.interrupt_turnesc中断正在运行的回合
chat.edit_previousesc在空输入框上按两次:编辑之前的消息
chat.edit_queued_messageshift-left、alt-up把最后一条待发消息放回输入框
chat.toggle_thinkingctrl-o展开或折叠每一次思考
chat.open_presetsleader p打开预设
chat.cycle_modeshift-tab在默认模式和计划模式之间切换
chat.reasoning_downalt-,把推理强度降低一档
chat.reasoning_upalt-.把推理强度提高一档
composer.submitenter发送消息
composer.queuetab回合进行中:把消息排入队列,等回合结束后发送
composer.history_previousup、ctrl-p上一条发送过的消息
composer.history_nextdown、ctrl-n下一条发送过的消息
composer.paste_imagectrl-v、ctrl-alt-v把剪贴板中的图片附加到消息(Ctrl-Alt-V 用于 WSL)
composer.external_editorctrl-g在外部编辑器(VISUAL,没有则 EDITOR)中编辑草稿
composer.history_searchctrl-r搜索发送过的消息,包括本次运行和之前的会话中的
composer.show_shortcuts?输入框为空时:显示或隐藏快捷键说明
composer.previous_agentalt-left输入框为空时:显示会话及其子代理中的上一个
composer.next_agentalt-right输入框为空时:显示会话及其子代理中的下一个
editor.insert_newlinectrl-j、ctrl-m、enter、shift-enter、alt-enter、ctrl-enter换行
editor.move_leftleft、ctrl-b左移
editor.move_rightright、ctrl-f右移
editor.move_upup、ctrl-p上移
editor.move_downdown、ctrl-n下移
editor.move_word_leftalt-b、alt-left、ctrl-left移到前一个词
editor.move_word_rightalt-f、alt-right、ctrl-right移过下一个词
editor.move_line_starthome、ctrl-a移到行首
editor.move_line_endend、ctrl-e移到行尾
editor.delete_backwardbackspace、shift-backspace、ctrl-h删除前一个字符
editor.delete_forwarddelete、shift-delete、ctrl-d删除后一个字符
editor.delete_backward_wordalt-backspace、ctrl-backspace、ctrl-w、ctrl-alt-h删除前一个词
editor.delete_forward_wordalt-delete、ctrl-delete、alt-d删除后一个词
editor.kill_line_startctrl-u删除到行首
editor.kill_line_endctrl-k删除到行尾
editor.yankctrl-y粘回最近删除的内容
transcript.page_uppage-up对话向上滚动一页
transcript.page_downpage-down对话向下滚动一页
transcript.jump_topctrl-home、alt-<、alt-shift-,到对话开头
transcript.jump_bottomctrl-end、alt->、alt-shift-.到最新输出
transcript.start_selectionctrl-space从视图第一行开始选择
pager.scroll_upup、k向上滚动一行
pager.scroll_downdown、j向下滚动一行
pager.page_uppage-up、shift-space、ctrl-b向上滚动一页
pager.page_downpage-down、space、ctrl-f向下滚动一页
pager.half_page_upctrl-u向上滚动半页
pager.half_page_downctrl-d向下滚动半页
pager.jump_tophome到开头
pager.jump_bottomend到结尾
pager.closeq、esc关闭分页器
pager.close_transcriptctrl-t显示对话记录的详细内容,再关闭它
agents.searchf3、/搜索会话标题
agents.new_taskn开始新会话
agents.new_worktreew在新工作树中开始新会话
agents.forkf分叉会话
agents.renamer重命名会话
agents.stopx中断会话的回合
agents.toggle_pinp置顶会话,或取消置顶
agents.hideh隐藏会话
agents.childrenc选择会话的子代理和评审
agents.archivea归档会话,或在 Archived 中恢复它
agents.deletebackspace删除会话
agents.toggle_groupingg按项目、目录、状态或模型分组

预设

预设是保存在 0 到 9 号位置中的一段输入(tui.presets."N"),可以带一个标签。运行时,它像输入后发送一样经过斜杠命令的解析,因此可以是一条消息,也可以是 /status、/statusline git-branch --colors 这样的命令。输入不能为空,不能超过 8000 字节,也不能以 ! 开头。

/presets(或 Ctrl-X P)在设置中心打开预设页面,列出所有位置;运行预设时先关闭设置中心:

按键作用
0–9运行这个位置的预设
Enter运行选中的预设
n新建预设:位置(第一个空位)、输入和标签
s从当前设置新建预设:会话的 /permissions …、终端标题的 /title … 或状态栏的 /statusline …
e编辑选中的预设
d按 y 确认后删除选中的预设

本界面中 /model 不接受模型作为参数,所以模型不能做成预设。配置档、项目配置或 -c 中设置的预设优先于用户文件中的:保存到这个位置时会说明这一点。

设置

标题显示完整的页面路径,例如 Settings › Model policy › Model。点击任意上级路径可直接返回该页面,并像返回操作一样取消子页面。窄窗口中的长路径会换行。

/config 在整个屏幕上打开设置中心(Scrollback 下是备用屏幕),仿照 Codex 的 /config:Agent 的所有设置,从它的设置目录读取,分在几个标签页中(General、Model、Tools、Memory、Context、Network、Interface、Plugins、Advanced;标签页会显示它有几个值存在问题)。每一行是标签 · 值 · 说明:[x] On 或 [ ] Off、选项的标签、数字、文本(为空时是 (empty))、列表的各项(没有时是 (none))、已设置的机密显示为 ••••、(unset),当你的 config.toml 之上的某一层设置了它时,后面会有暗色的 · profile NAME、· project 或 · -c。某一层的值无法使用时,说明的位置改为显示原因。标题下方的状态行平时为空。成功提示显示三秒后自动消失,错误提示会保留。结果包括:Saved、Saved · the project layer overrides it(或 the profile NAME layer、the -c layer)、Saved · applies at next launch、Saved · applies from the next session、Could not save: …。写入改动期间显示 Saving…,动作运行期间显示该动作(List models…、Add a Provider…)。最底一行说明选中行的按键作用。说明列不足 45 列时,选中行的说明移到列表下方。

  • 左、右键切换标签页;上、下、Page Up、Page Down、Home、End 移动;Esc 返回,在标签页上则关闭设置中心。
  • / 搜索所有标签页:设置、集合、记录和页面的标签、键、值、关键词和摘要。结果的说明是它所在的标签页和分节。Enter 离开搜索框进入结果,Esc 清空搜索。
  • 布尔值用 Enter 或空格立即保存。选项打开它的值列表,当前值标有 (current),不能选的值变暗并显示原因;选中一个即保存。选项或文本(模型策略的推理强度)打开它的值,然后是 Default(取消设置)和 Custom,后者在行内编辑,与文本相同(推理强度)。文本、数字或路径在行内编辑:Enter 按写入的方式检查并保存,被拒绝时编辑框保留并显示原因(Esc 取消)。文本列表以列表打开:Enter 编辑或添加一项,d 删除一项,每次改动都会保存。需要一起保存的设置(网页搜索服务及其 URL)以带 Save 的小表单打开。
  • r 重置选中的设置:从你的 config.toml 中删除它,下一层(或默认值)重新生效。
  • 集合(Provider、模型覆盖、模型策略、MCP 服务器、MCP 机密、插件的 MCP 服务器、插件、已安装的插件及其默认策略、市场、Skill、沙箱维护、钩子、角色及角色文件;独立模式下还有 profile、配置层和项目)打开它的记录,每条显示状态和摘要,上方显示它无法读取的部分。Enter 把一条记录打开为字段表单,每个字段改动时即保存;记录拒绝的字段保持标记为 unsaved,随下一次改动一起发送(例如先改 MCP 服务器的传输方式,再填它的 URL)。在记录的字段上按 r 取消设置它(profile 的某个键、模型的窗口、插件服务器回到插件自己的工具)。表单的其余行是记录的动作(Make default、List models、Connect、Update、Trust、Delete……);其中一些(如 Delete 和 Trust)会先询问。a 添加一条记录(一个由 Add 保存的表单,字段从 add 将写入的值开始;MCP 服务器、模型覆盖、profile、项目和角色在其中命名,已安装的插件用 PLUGIN@MARKETPLACE 或它的目录命名),d 在询问后删除选中的记录。机密默认显示为 ••••。Enter 打开已保存的值进行编辑;Ctrl+R 显示或隐藏,不触发保存;Enter 保存编辑,Esc 取消。在别处写入的记录(角色文件、profile 或插件中的角色、内置角色)只显示,并说明写在哪里;钩子的定义是它的摘要,写在它的文件中。对 providers.toml 或 mcp.toml 的写入如果被其他改动抢先,会被拒绝:记录会重新读取,你的改动保留,可以再次保存。模型策略是只有一条记录的集合,直接以表单打开。
  • 页面:语法主题、状态栏和终端标题这几行打开主题选择和两个设置界面;Keymap 和 Presets 行(Interface)、Plugin browser(Plugins)、Hook review(Tools)和 Memory store(Memory)打开按键映射、预设、插件浏览器、钩子浏览器,以及记忆的状态、参与和重置。Provider 的 Choose the model 和 MCP 服务器的 Log in 是它们记录的页面。Esc 回到打开它们的那一行。页面保存的内容(绑定的按键、预设、主题)也会显示在标题下方。这些页面只在设置中心中:原来打开它们的命令现在在设置中心打开它们。
  • 鼠标:滚轮移动选择,点击标签页显示它,点击一行选中它,点击已选中的行等同于 Enter。

Model policy 中的 Model 行会打开默认 Provider 的模型列表,显示与 /model 相同的上下文窗口、思考和读图信息。搜索或移动选择后按 Enter,保存为新会话的默认模型。选择 Enter a model id… 可以手动输入模型名称,获取列表失败时也可使用。Esc 取消,不会修改当前会话的模型。需要使用其他 Provider 时,先选择 Default Provider。

/config 目标 在某个标签页(memory)、分节(web、compaction、tui、pluginOptions.subagents)、集合(providers、providerModels、modelPolicy、mcp、mcpSecrets、pluginMcp、packages、roles)或页面(theme、statusline、title、keymap、presets、plugin-browser、hook-review、memory-store)打开设置中心。各命令是它的快捷方式:/providers 即 /config providers(policy:modelPolicy),/mcp 即 /config mcp,/plugins 对应 plugin-browser,/hooks 对应 hook-review,/memories 对应 memory,/tui 对应 tui,/theme、/statusline、/title、/keymap 和 /presets 对应各自的页面。每次写入都在界面的事件循环之外进行,一次一个;设置中心从不等待它。分层不再是一个页面:每一行会标出设置它的那一层,profile 和项目是集合,/warnings 保留各层无法使用的内容。会话角色由 /role 负责。目标不对应其中任何一个时,会提示没有这样的设置页面。config set 是修改单个键的命令行等价方式。

警告

界面或 Agent 无法按配置使用的内容会在本次运行中保留下来,/warnings 列出它们:最新的在前,每条只出现一次,并按来源计数:

  • configuration:读取 config.toml、providers.toml 和 mcp.toml 时做的修复(配置恢复),以及 config.toml 的某一层中设置无法使用的内容:不认识的键,或被下一层替换的值;
  • roles:读取角色时略去的内容、同一来源中定义了两次的角色,以及每个不可用的角色及其原因;
  • plugins:失败的插件,或被排除在回合之外的插件;
  • installed plugins:已安装插件无法使用的内容:清单字段、组件、它的角色略去的内容、因同名而让位的 MCP 服务器;代码失败的插件(10 分钟内第四次失败,或启动失败),直到重试为止,以及它的代码遗漏的内容;
  • MCP:服务器最近的错误或警告,以及读取 mcp.toml 时做的修复;
  • hooks:钩子配置中的问题;
  • panics:Agent 捕获到的内部错误;
  • compaction:回合运行的压缩失败(上文);
  • interface:因内部错误而关闭的命令、[tui] 中不认识的主题或项目、无法使用的按键映射设置。

启动时如果有警告,会有一行说明数量(2 warnings: /warnings)。在列表中,c 复制选中的警告,d 在本次运行的剩余时间内忽略它。没有警告时,/warnings 显示 No warnings.。

更新

界面启动时(hanafubuki-agent 和 hanafubuki-agent resume;exec 和其他命令从不这样做,没有终端时也不会),命令行在后台向 GitHub 询问是否有更新的版本发布,最多每 20 小时一次;界面不等待回答。发现更新的版本时,会在对话左上角显示版本、模型和目录的信息框内展示提示:

╭───────────────────────────────────────────────────╮
│ >_ hanafubuki-agent (v0.2.0)                      │
│                                                   │
│ model:     gpt-5.1                                │
│ directory: ~/src/project                          │
│                                                   │
│ Update available: 0.3.0 · hanafubuki-agent update │
╰───────────────────────────────────────────────────╯
  • 窗口较窄时,信息框中的提示和安装命令会换行,不会隐藏;底栏保留状态栏和快捷键提示。信息框是对话记录的一部分,长对话中可滚动到开头查看。
  • 缓存中已有的新版本在首个会话信息框中显示;后台检查收到结果后刷新该信息框。新建、恢复和旁支对话使用同一个当前更新提示。
  • 后面的命令取决于这个副本的安装方式:发布的二进制文件是 hanafubuki-agent update,用 cargo install 安装的是 cargo install --locked hanafubuki-agent-cli,其他情况是 hanafubuki-agent update --check,它会说明该怎么做(update)。
  • 只有稳定版本、且比当前版本新的才算。检查失败(没有网络、GitHub 的速率限制、读不懂的回答)时什么也不显示,下次启动时再检查。从源码检出构建的副本(target/debug、target/release 或 cargo install --path)从不检查。
  • 回答保存在 update-check.json 中。设置中的 Check for updates 和 hanafubuki-agent update --check 会立即刷新同一个缓存,不受 20 小时间隔限制。设置中检查成功后,返回主界面即可看到信息框更新,下次启动也能根据新缓存显示更新询问。检查失败时保留原缓存。

启动时的更新提示

之前的检查发现的版本比当前版本新时,下一次启动会先询问,再启动 Agent:此时 Agent 的任何部分都还没有运行,所以不会获取锁,也没有插件占用更新要替换的可执行文件。界面与 Codex 的相同:


  Update available · 0.2.0 → 0.3.0
  Release notes: https://github.com/licyk/hanafubuki-agent/releases/tag/v0.3.0

› 1. Update now (downloads 0.3.0 and replaces this executable)
  2. Skip
  3. Skip until next version

  enter continue · esc skip
  • Update now 在终端中运行 hanafubuki-agent update:清空屏幕,重新查询最新版本(可能比显示的更新,这次查询会像 update 一样发送 GITHUB_TOKEN),打印它的各行输出,然后程序结束;再次启动即运行新版本。更新失败时,错误信息会说明保留了什么,可执行文件保持原样,程序以退出码 1 结束,下一次启动会再次询问。对于用 cargo install 安装的副本(Linux 和 macOS),这一项显示为 Update now (runs `cargo install --locked hanafubuki-agent-cli`),安装在其他位置时带 --root,并运行 cargo。
  • Skip 启动界面;下一次启动会再次询问。
  • Skip until next version 启动界面,在发现更新的版本之前不再询问;这个版本以 dismissedVersion 保存在 update-check.json 中。信息框中的提示仍然显示它。
  • 上方向键或 k、下方向键或 j 移动高亮,到头后回绕;Enter 选择高亮项;1、2、3 立即选择;Esc、Ctrl+C 和 Ctrl+D 相当于 Skip。界面出现之前输入的内容会被丢弃,所以程序启动时按下的 Enter 永远不会选择 Update now。
  • 它在 hanafubuki-agent 和 hanafubuki-agent resume 中显示;在命令行中给出了提示词时(hanafubuki-agent "fix the tests"、resume ID PROMPT)、检查关闭时、从源码检出构建的副本都不显示,exec 中和没有终端时也从不显示。这个副本无法在这里更新时(不可写的目录、没有发布二进制文件的平台、Windows 上用 cargo 安装的副本)也不显示:信息框中的提示会改为说明该怎么做。
  • 在两种呈现方式下它都占据整个屏幕,做出选择后、界面启动前被清除;滚动缓冲区中不会留下它的任何内容。窗口较窄或较矮时它会换行,并保持高亮项和按键说明那一行可见,最小约到 20 列、4 行;空行先让出空间,其次是标题和发布说明。
  • 同时启动的两个窗口可能都会询问。两者都选择 Update now 时,第二个会发现可执行文件已经更新,并如实说明(… is already 0.3.0 (another process updated it).)。
  • 在 Windows 上,启动时还会删除之前的更新留下的、已经没有程序在运行的可执行文件(hanafubuki-agent.exe.NUMBER.outdated),无论检查是否开启。

检查发送的内容:一个 HTTPS 请求,GET https://api.github.com/repos/licyk/hanafubuki-agent/releases/latest,带有 Accept: application/vnd.github+json 和 User-Agent: hanafubuki-agent/VERSION(这个副本的版本),经过 network.proxy。不发送任何令牌、Cookie 或标识(GITHUB_TOKEN 也不发送),也不发送你的配置、会话或项目的任何内容;GitHub 看到的是请求的地址和版本,和下载时一样。失败只以其类别记录在 debug 级别的日志中。

关闭它:设置 tui.checkForUpdates = false(配置参考),或把 HANAFUBUKI_AGENT_NO_UPDATE_CHECK 设为任意非空值(环境变量):这样不会发送自动检查请求,也不显示缓存提示和启动时的更新询问。两者都在下次启动时生效。手动执行 Check for updates 或 update --check 仍然会检查;在设置中手动检查可以更新当前信息框,但不会重新开启自动检查。

终端要求

  • 终端需要响应光标位置查询,否则界面无法启动。
  • 只使用基本的 ANSI 颜色和粗体、暗色、斜体,以及网页链接的 OSC 8 超链接;每个超链接都在光标移走之前关闭。不认识 OSC 8 的终端显示不带超链接的文字。命令的输出还显示它输出时的颜色和属性(渲染),包括 256 色和 24 位颜色、下划线和反显,不支持它们的终端尽力显示。
  • 差异的底色(渲染)取决于终端的颜色深度,按 Codex 的方式从环境变量判断:COLORTERM=truecolor 或 24bit、以 direct 或 truecolor 结尾的 TERM,或 iTerm2,为 24 位颜色;以 256color(或 256)结尾的 TERM 或 Apple Terminal 为 256 色;其他情况,以及 stdout 不是终端、设置了 TERM=dumb 或 NO_COLOR 时,为 16 色。FORCE_COLOR(1 到 3)或 CLICOLOR_FORCE 可以指定它。Windows Terminal(WT_SESSION)算作 24 位颜色,除非设置了 FORCE_COLOR。
  • 网页链接是否只显示文字取决于终端,启动时根据环境变量判断(TERM_PROGRAM、WT_SESSION、VTE_VERSION、TERM 以及 Codex 读取的其他变量,按它的顺序),没有对应的设置。Ghostty、iTerm2、WezTerm、Rex、kitty、Visual Studio Code 的终端、Alacritty、Windows Terminal、Konsole、GNOME Terminal 和其他 VTE 终端只显示文字。Terminal.app、Warp、Windows 控制台、无法识别的终端、TERM=dumb、tmux、Zellij 和 GNU screen(以及 TERM 以 screen 或 tmux 开头时)在文字后保留地址;输出不是终端时也一样。
  • 点击链接时,由终端按它自己的方式打开,通常需要按住 Ctrl 或 Cmd。Fullscreen 会捕获鼠标,所以只有按住终端的绕过键(通常是 Shift,与终端自己的选择相同)时,终端才能收到点击;界面收到的点击照常起作用(选择、展开或折叠的控件),不会打开任何链接。界面自己不打开链接。
  • Fullscreen 使用备用屏幕和鼠标(SGR 报告)。
  • Scrollback 下,分页器和恢复选择器使用备用屏幕,期间鼠标滚轮相当于方向键;对话记录会捕获鼠标用于选择和控件。启用行内鼠标捕获时,输入框选择器和弹窗也接受点击和滚轮操作。在它们之外,Scrollback 只在尾部显示控件时捕获点击和滚轮(SGR 报告;Windows 上是控制台的鼠标输入,捕获期间关闭快速编辑模式),直到滚轮第一次滚动(tui.scrollbackMouse)。

咨询 Advisor

在 /advisor-settings(别名 /advisor-models)可分别配置审查、备用和执行模型。先选择该项的提供商,再从它的模型列表中搜索或手动输入模型 ID。选择只写入对应的 Advisor 设置。输入 /advisor-manual 这个修复覆盖了哪些失败路径? 可单次咨询,回答直接显示在对话中。输入 /advisor 后,执行模型可以主动请求审查。/advisor-off 停用并解除重复工具门控对本会话的阻止。会话激活仅对当前对话有效,持久激活也适用于后续对话。

开启反馈记录后,输入 /advisor-stats 可查看本地保留记录的采纳和验证统计。

输入 /status 可查看当前会话的激活状态和咨询次数。在 /statusline 中添加 advisor,可在底栏持续显示次数和可选上限。手动回复会显示提供商返回的 token 用量;提供商未报告的用量或价格按未知处理。

执行模型咨询时,对话中显示 Consulting Advisor,完成后变为 Consulted Advisor。预览展示实际回答的模型、问题和建议;展开 Show details 可查看完整问答和追问引用。反馈记录会显示采纳情况和验证结果。

本页目录