DOCAI · 课程 · L3 · 23 分钟 · 基础入门
界面介绍与导航
把终端界面拆成对话区、工具块、差异区和输入行,讲清一次请求的路径、常用斜杠命令、编辑器面板差异与几个容易误读的信号。
你将学会
- 说出终端界面的四个区域各自负责什么
- 在权限确认和差异区里判断一次改动是否可信
- 用斜杠命令与前缀完成常用导航
这不是一个聊天框
第一次打开终端界面,很多人以为它只是把网页对话搬到了命令行。用上十分钟就会发现差别:它会把「读了哪个文件」「跑了哪条命令」「改了哪几行」逐条摊开。
界面大致分四块:
- 对话区:你的输入和它的说明;
- 工具块:每一次读文件、执行命令、写文件的过程;
- 差异区:改动前后的对照;
- 输入行:当前可以做什么,以及模式提示。
真正要练的是读工具块和差异区,而不是只读最后那段总结。总结是它对自己的描述,工具块才是实际发生的事。
一次请求的完整路径
输入一句话后,通常会经历这些步骤:
- 它说明打算查哪些文件、跑哪些命令;
- 涉及写操作或敏感命令时,界面停下来等你确认;
- 执行后把输出贴回对话;
- 改动以差异形式展示;
- 最后给一段总结。
第二和第四步是关键。确认提示出现时,先看清楚它要执行什么、影响哪些文件,再决定同意还是拒绝。看不懂就拒绝,让它换个做法,成本很低。
差异区要重点看三处:有没有改到任务之外的文件、有没有顺手重写无关逻辑、有没有为了让测试通过而改测试本身。
常用导航命令
会话里输入斜杠命令,可以完成大部分切换:
| 命令 | 作用 | 什么时候用 |
|---|---|---|
/help |
列出可用命令 | 忘了某个名字 |
/status |
看当前模型、账号与配置 | 行为跟预期不符 |
/model |
换模型档位 | 任务难度变化 |
/clear |
清空上下文 | 换一个无关任务 |
/init |
生成项目说明草稿 | 第一次进仓库 |
记不住名字也没关系:输入 / 会列出可用命令,按 Tab 可以直接补全。
输入行里还有两个前缀值得记:@ 用来点名文件或目录,! 用来直接执行一条本地命令。前者比口头描述路径可靠,后者适合你先确认环境、再把结果交给它分析。
操作层面记三个键:Esc 打断当前生成,Ctrl+C 连按两次退出,Ctrl+L 清屏但保留上下文。不同版本可能微调,以界面提示为准。
侧栏、面板与网页版的差别
在编辑器里安装插件后,界面会多出侧栏:会话列表、改动概览、文件定位都在里面。选中一段代码再提问,选区会自动成为上下文,不需要手动贴。
桌面端更接近独立应用:多窗口、拖拽文件、系统通知。网页版则是另一套产品,左侧是会话与项目,顶部是模型切换,和终端界面不是同一张地图。网页版怎么用,可以看界面全览;这里只讲开发时真正会盯的那块屏。
不管在哪个界面,判断标准一致:工具调用是否透明、改动是否可见、权限是否由你掌握。
读懂界面里的信号
几个容易误读的信号:
权限提示不是报错。 它在等你授权,不是执行失败。看清楚内容再点。
工具块折叠不等于没执行。 展开看参数和输出,尤其是删除、移动、批量替换这类动作。
差异为空不等于没改。 可能是改了又被还原,也可能是改在未跟踪的文件里。用版本控制的状态命令再确认一次。
上下文占用会悄悄变满。 长会话里它开始重复、忘记前面的约定,往往不是变笨,而是早期内容被挤出去了。换新会话,把必要的背景重新给一遍。
网页版界面:同一套概念,不同的摆法
网页版和终端不是同一套界面,但概念能一一对上。第一次从网页转到终端、或者反过来用时,先看这张对照表:
| 网页版的位置 | 你熟悉的功能 | 终端里的对应物 |
|---|---|---|
| 左侧栏 | 历史对话、项目 | 会话列表与恢复命令;项目背景靠说明文件 |
| 顶部栏 | 模型选择、设置 | /model、/status、配置文件 |
| 输入框旁 | 上传文件、语音输入 | 直接给路径,或用 @ 点名 |
| 回答下方 | 复制、重新生成、编辑提问 | 复制回答、重新发问、回退会话 |
| 编辑旧消息 | 产生新分支 | 新开会话,或从历史节点继续 |
| 设置页 | 语言、记忆、密钥 | 本地配置与环境变量 |
网页版适合整理思路、写长文、看图片;终端适合在项目里连续操作文件。两边都遵守同一条规则:先看清它读了什么、改了什么,再决定下一步。
网页版还有两个容易被忽略的入口。一是对话分支:修改前面的提问后,旧回答不会消失,而是在旁边长出一个新版本,适合比较两种问法。二是项目:把常用资料放进同一个项目,之后每次对话都能引用,省去反复上传;但项目里的内容同样会占用上下文,资料越多,留给当前任务的余量越少。
常见误读:现象、原因与处理
现象:在网页版里输入 /clear,没有任何反应。
为什么:斜杠命令是终端产品的功能,网页版没有这套命令系统。
怎么办:网页版用新建对话来达到同样目的;终端里再用 /clear,两者不要混用。命令清单见斜杠命令帮助。
现象:按了一次 Ctrl+C,程序还在跑。
为什么:第一次通常是打断当前生成或取消当前动作,连按两次才会退出。
怎么办:先看界面有没有停下;要彻底退出就再按一次,或输入退出命令。不同版本的按键可能调整,以界面提示为准;更多按键见快捷键参考。
现象:权限提示一闪而过,你没看清就点了同意。 为什么:提示会列出命令或文件路径,内容一长就滚出视野;连续操作时容易条件反射。 怎么办:把提示展开,先看动词(删除、覆盖、移动)再看对象;看不懂就拒绝,让它改成分步执行。拒绝的成本远低于误删。
现象:差异区里几乎没内容,你以为这次没改文件。
为什么:差异区主要展开已跟踪文本文件的行级改动;新建文件、二进制文件、纯重命名或移动往往只给一行摘要,看起来接近空白。
怎么办:在项目里跑 git status --short,重点看 ??(未跟踪新文件)、R(重命名)、D(删除)三类标记;再跑 git diff --stat 核对改动行数。两条命令都没有输出,才说明工作区确实没变。非 git 项目就用文件修改时间与备份副本对比确认。
现象:在编辑器侧栏选中一段代码提问,它却分析了整个文件。
为什么:选区是否自动成为上下文,取决于插件版本和当前面板状态。
怎么办:在问题里明确写行号范围,或用 @ 指定文件后再说「只看第几行到第几行」;回答偏离时先纠正范围,不要顺着它的错误前提追问。
把界面用顺,再练问法
先做到三件事:知道在哪里看改动、在哪里打断、在哪里换模型。然后练对话本身——同样一个工具,问法不同,产出的质量差很远。继续看基本对话交互。
自测
先自己回答,再展开对照;答不上来就回到对应小节。01为什么不能只看最后的总结?看答案
总结是工具对自己的描述,可能漏掉顺手改的无关文件,也可能把失败说成完成。实际发生的动作藏在工具块和差异里。
02权限提示出现时,应该按什么顺序判断?看答案
先看要执行什么命令或改哪些文件,再看影响范围是否超出任务,最后决定同意还是拒绝。看不懂就拒绝,换个做法成本很低。
03长会话里它开始重复、忘记约定,通常是什么原因?看答案
多半不是能力下降,而是早期内容被挤出上下文。换新会话,把必要背景重新给一遍,比继续追问更有效。