Aude Code

aude-terminal(7)

NAME

aude-terminal — aude 的交互式终端

DESCRIPTION

本页介绍 ‘aude’ 和 ‘aude attach’ 在终端上的用法。应用使用相同的按键和相同的行。应用中的 Send 发送草稿。 Stop 中断轮次。点按一个候选项会补全光标处的词。

在终端上，会话开始时用块字符显示 aude 这个词，这个词位于两个空行之间。应用在会话列表的顶部显示这个词。

每行的前两列是边栏。消息的第一行在边栏中有一个符号：

‘>’
你输入的行
‘*’
模型的回答
‘%’
队列中的行

思考、工具调用、工具结果、通知和命令的回复都没有符号。模型开始思考时，实录显示 ‘thinking’ 一词。工具结果是 ‘ok’ 一词，或者是 ‘error:’ 加上错误的第一行。

模型的 Markdown 保留其标记。标题和粗体文本显示为粗体。强调显示为斜体。链接带有下划线。代码显示在蓝色底色上。其他颜色都是底色：

灰色
你输入的行
红色
错误
黄色
来自会话的行，例如 ‘interrupted’ 或 ‘rate limited until <time>’

有些关于会话的行不在实录中：

  • 登录行
  • 另一个客户端附加或分离时的 ‘<name> attached’ 或 ‘<name> detached’

THE PROMPT

‘>’ 是会话空闲时的提示符。 ‘%’ 是轮次运行时的提示符。 草稿（draft）是提示符之后的文本。

信息行是提示符下方的一行。它显示以下各项中排在最前的一项：

  1. 关于草稿或按键的说明 (参见 THE ROW)
  2. 你输入一个词时的补全候选项
  3. 概况

概况显示以下各部分，各部分之间用 ‘·’ 连接：

  • 会话名称，在客户端有多个连接时显示。如果两个连接的名称相同，该部分是句柄。
  • 工作目录
  • 在框架的工作树中时，显示 ‘worktree <name>’
  • 分支，或 ‘detached’
  • 上下文大小，例如 ‘42k’
  • 智能体不是默认智能体时，显示 ‘agent <name>’
  • 模型的标识符，如果你设置了推理强度，其后是推理强度

‘~/path/to/repo · main · 42k · agent review · claude-opus-5-5 high’ 是一个示例。概况不显示未知的部分。上下文大小从 200k 起显示为黄色。从 300k 起显示为红色。

轮次运行时，文本带着 ‘>’ 加入该轮次。其他行带着 ‘%’ 在提示符上方等待，直到它们的轮次开始。

KEYS

按键 空闲时 轮次运行时
发送草稿 发送草稿
换行 换行
有草稿时，预备。再按一次时，清除草稿 中断轮次
清除草稿并预备。再按一次时，退出 中断轮次
有草稿时，删除光标后的字符。否则，预备。再按一次时，退出 同左
移动一行，或在第一行或最后一行时翻阅历史草稿 同左
移动光标 同左
移动一个词 同左
移到行首或行尾 同左
删除到词尾 同左
删除光标前或光标后的字符 同左
剪切到行尾、行首或上一个空格 同左
粘贴最后一次剪切的文本 同左
重新绘制提示符 同左
暂存草稿。草稿为空时，取回暂存的草稿 同左
补全光标处的词 同左
插入文本，保留其中的换行 同左

预备（primed）状态的按键在下一次按下时会做更多的事。

Option+Enter 和在 Enter 之前输入的反斜杠也会产生换行。表中没有的按键不起作用。

Terminal.app 把 Shift+Enter 作为 Enter 发送。它用 Home 和 End 滚动自己的窗口。在 Terminal.app 中，请使用 ^J、^A 和 ^E。

把 Option 作为 Meta 发送的终端，会把 Option+Left、Option+Right 和 Option+Delete 发送为 Esc 后跟 b、f 或 d。 aude 把 25 ms 内先后到达的这两个按键读作一个按键。

提示符保留你发送、清除或暂存过的最近 500 条历史草稿。暂存中只保留一条草稿。aude 不会把它们写入磁盘。

THE ROW

按下某些按键后，信息行会显示一条说明，告诉你发生了什么以及如何撤销。这条说明保留到下一次按键。

‘esc again clears the draft’
 
‘^C again quits’
 
‘^D again quits’
 
‘draft cleared · ↑ restores’
按 Up 取回草稿
‘^C again quits · draft cleared · ↑ restores’
 
‘draft stashed · ^S restores’
 
‘draft kept with <name>’
在有草稿时切换走之后显示。这个草稿会随那个连接一起回来。
‘cut to end of line · ^Y pastes’
 
‘cut to start of line · ^Y pastes’
 
‘cut to start of word · ^Y pastes’
 
‘pasted’
 

轮次运行时，信息行不显示 Esc 和 ^C 的说明，因为下一次按下会中断轮次。

QUIT

要退出，请按两次 ^C 或 ^D。 轮次运行时按 ^C 会中断轮次。 ^D 不会中断轮次。

退出不会中断轮次。本地会话在其轮次结束时停止。每个连接都会关闭。因此，以另一个 aude 进程为宿主的会话会继续运行。如果本地会话运行过轮次，aude 会在退出后打印它的恢复行：

resume with: aude --harness <name> --resume <id>

CONNECTIONS

客户端持有你附加的每台机器。除了在 ‘aude attach <url>’ 中，客户端也持有这台机器。它列出每台机器的每个会话。

客户端为你打开的每个会话持有一个连接。其中一个连接处于前台。

以下命令只在客户端中执行：

url
打开 ‘AUDE:’ URL 所指的机器。列出它的会话。那台机器上的可达信息或 ‘aude pair’ 打印了这个 URL。aude 不会在屏幕上显示这个 URL。
[target]
没有目标时，先列出各个连接，再列出每台被持有机器上的其他每个会话。有目标时，如果目标所指的会话没有连接，就打开一个连接。然后把这个会话放到前台。不匹配任何会话的目标会等待每台机器的会话，之后的每次切换也会等待。
[target]
关闭一个连接，默认关闭前台的连接。这个 ‘aude’ 的会话不会分离。要结束它，请退出。 ‘aude attach’ 在最后一个连接关闭时结束。

句柄是 ‘<name>#<tag>@<address>’ 形式。 ‘<tag>’ 是会话 ID 的前 8 个字符。地址是隧道的名称，或者是 ‘127.0.0.1:<port>’ 这种形式，或者是表示这台机器的 ‘local’ 一词。

会话的列表行是 ‘<handle>  <branch>  <harness>  <state>  <unread>’ 的形式。前台连接的列表行随后还有 ‘foreground’ 一词。保留草稿的连接的列表行以 ‘draft’ 一词结尾。 ‘<state>’ 是 aude(1) 的工作状态。

连接打开时打印 ‘attached to <handle>’ 这一行。 /detach 打印 ‘detached from <handle>’ 这一行。切换会先打印列表行，再打印该会话在不处于前台期间说过的内容。每个连接保留自己的草稿。不在前台的连接在其轮次结束时打印 ‘<handle> idle’ 这一行。结束的连接打印 ‘<handle> ended: <reason>’ 这一行，退出之后除外。

COMPLETION

Tab 补全以下这些词：

  • 命令名称
  • 项目的技能
  • 、/effort 和 /agent 的参数
  • 在 /switch 和 /detach 之后，每个连接的句柄

只有一个匹配项时，补全整个词。有多个匹配项时，补全它们共同的开头。信息行显示候选项。补全不会发送任何内容。

SEE ALSO

aude(1), aude-rc(7)