日常使用
输入框与快捷键
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:框里的话也排进去,打断这一问,排着队的话马上按顺序发出。
▌ 给登录接口加限流:同一个 IP 每分钟最多 5 次,超了返回 429 ● 读取 path=src/api/auth.py ⎿ 48 行 ⠹ 思考中… (6s · ESC 中断) 顺便把注册接口也加上,同样 5 次 ╭──────────────────────────────────────────────────────────────────╮ │ › │ ╰──────────────────────────────────────────────────────────────────╯
随口问一句:/btw
想问个不相干的小问题,又不想打断它正在做的事,用 /btw 问题:回答中、平时都能用。它看得到到目前为止的对话,但不调工具、不进对话历史,答案显示在一个框里;之前问过的旁支问题会一起带上。
- 旁支问题:
/btw后面直接写问题,回答中也能发。 - 答案框:只显示在这里,不进对话历史,主对话接着做它的事。
答完:下一句建议
每一问答完后,空的输入框里会用灰字给出一句你可能接着要说的话(比如回答最后问「要不要先做第一条」,建议就是「好,先做第一条吧」)。按 Tab 或 → 填进输入框,可以改了再发;直接打字它就消失。
- 建议的下一句:根据刚才的对话猜你可能接着要说的话。
- 采纳提示: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 | 平时 | 切换权限模式,见 权限模式与规则 |
看懂底部两行状态栏
▪ 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 一下就能发;底部两行状态栏告诉你在哪个项目和分支、用的哪个模型、上下文还剩多少。