跳到正文
heng-agent v0.5.0
Esc
使用指南目录

日常使用

输入框与快捷键

heng-agent 的输入框怎么用:换行、@ 附文件、! 自己跑命令、粘贴截图;回答过程中接着打字排队、插话、Ctrl+X Ctrl+S 立刻发送、/btw 随口问一句;答完 Tab 采纳下一句建议;ESC、Ctrl+C 各管什么;底部两行状态栏怎么看。

预计用时
约 6 分钟
适用版本
v0.5.0 及以上

写一条消息

Enter 发送,Shift+Enter 换行(其他终端里用 Ctrl+J 或 Alt+Enter;Windows Terminal 里 Shift+Enter 不能换行时运行 /terminal-setup)。写消息时这几个前缀最常用:

写法 作用
/ 补全斜杠命令,全部命令见 斜杠命令速查
@路径 补全文件路径,发送时把文件内容直接附上
!命令 自己直接跑命令(不经过模型),输出附在你下一句话里告诉模型
# 一句话 不发给模型,记进项目或用户的 HENG.md,见 项目记忆

拖入文件、粘贴截图也行:消息里出现的文件绝对路径发送时自动变成附件。Windows Terminal 里粘贴截图用 Alt+V(它自己处理 Ctrl+V 且只粘文字)。

回答过程中接着说

它在干活时输入框一直在,不用等它答完:

  • 接着打字,Enter 把这句话排进队列,灰色列在输入框上方。普通的话在这批工具跑完时插进这一问,模型下一步就能看到;
  • 斜杠命令等这一问结束再执行,/status、/usage、/tasks、/effort、/think 这类不发给模型的马上执行;
  • 光标在第一行时按 ↑,把排着队的话全部取回来改;
  • 不想等了按 Ctrl+X Ctrl+S:框里的话也排进去,打断这一问,排着队的话马上按顺序发出。
heng-agent — D:\code\my-app(界面示意)
▌ 给登录接口加限流:同一个 IP 每分钟最多 5 次,超了返回 429

● 读取 path=src/api/auth.py
  ⎿ 48 行
⠹ 思考中… (6s · ESC 中断)

顺便把注册接口也加上,同样 5 次
╭──────────────────────────────────────────────────────────────────╮
│ ›                                                                │
╰──────────────────────────────────────────────────────────────────╯

随口问一句:/btw

想问个不相干的小问题,又不想打断它正在做的事,用 /btw 问题:回答中、平时都能用。它看得到到目前为止的对话,但不调工具、不进对话历史,答案显示在一个框里;之前问过的旁支问题会一起带上。

/btw 随口问一句:答案在单独的框里。点击图片放大。 图中按 ①② 标出了正文提到的位置 截自 v0.5.0 · Windows Terminal
  1. 旁支问题:/btw 后面直接写问题,回答中也能发。
  2. 答案框:只显示在这里,不进对话历史,主对话接着做它的事。

答完:下一句建议

每一问答完后,空的输入框里会用灰字给出一句你可能接着要说的话(比如回答最后问「要不要先做第一条」,建议就是「好,先做第一条吧」)。按 Tab 或 → 填进输入框,可以改了再发;直接打字它就消失。

答完一问,输入框里出现灰字建议。点击图片放大。 图中按 ①② 标出了正文提到的位置 截自 v0.5.0 · Windows Terminal
  1. 建议的下一句:根据刚才的对话猜你可能接着要说的话。
  2. 采纳提示:Tab 或 → 填进输入框,改了再按 Enter 发。

没有明显的下一步时不给,计划模式里也不给。每一问会多一次模型请求:主对话读写过缓存时这次请求几乎全部读缓存,不缓存的服务只带最近 3 问压成的几千字。不想要就关掉:

/config set settings.prompt_suggestions false

打断、清空、退出

按键 什么时候 作用
ESC 或 Ctrl+C 回答中 打断这一问:等模型时立刻断开,跑命令时连同子进程一起停掉;框里没发的草稿留着,排着队的话接着发
双击 ESC 输入框里有字 清空输入框
双击 ESC 输入框是空的 等于 /rewind:选一问,对话与它改过的文件一起回到它之前,见 撤销与回退
Ctrl+C 平时 第一次清空输入框;空输入框里连按两次退出
↑ 清空之后 清掉的草稿存进了历史,按 ↑ 找回
Ctrl+B 命令跑着时 转到后台,见 后台任务
Ctrl+T 平时 显示 / 隐藏输入框上方的任务清单
Ctrl+L 平时 清屏
Shift+Tab 平时 切换权限模式,见 权限模式与规则

看懂底部两行状态栏

heng-agent — D:\code\my-app(界面示意)
▪ my-app  master* | deepseek · deepseek-v4-pro | ✓ MCP 2 | 42 t/s | 上下文 ██░░░░░░ 18% 180k/1M
⏵ 手动确认 已开启 (Shift+Tab 切换) · 后台 1
  • 第一行:项目名与 git 分支(* = 有没提交的改动)· 服务商与模型 · MCP · 上一次的输出速度 · 上下文进度条 · 额度。窗口窄时按 额度 → 速度 → 分支 → 服务商名 → token 数 → 进度条 的顺序省掉,不会截断;
  • MCP:⠹ MCP 3 橙色是还在连(数字是已连上的个数),✓ MCP 6 绿色是都连上了,✗ MCP 5 红色是有连不上的,/mcp 看原因;
  • 速度:低于 15 t/s 标成橙色,多半是中转站拥堵或限流;
  • 额度:按服务地址认出服务商,用同一把密钥查(每 3 分钟最多一次)。DeepSeek、Moonshot、硅基流动显示余额,Kimi Code、智谱 GLM Coding Plan 显示套餐用量,new-api / one-api 类中转站显示余额或已用多少;查不到的不显示;
  • 第二行:权限模式与提醒,比如后台任务个数、快到自动压缩。

做完是这样

回答过程中你接着说的话排在输入框上方,这批工具跑完它就看到了;答完输入框里有一句灰字建议,Tab 一下就能发;底部两行状态栏告诉你在哪个项目和分支、用的哪个模型、上下文还剩多少。

最后更新: