/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */
#content_views .toc,
/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */
#content_views.markdown_views > p:empty:has(+ .toc),
#content_views.markdown_views > .toc + p:empty,
/* 富文本旧版目录标记 */
#content_views.htmledit_views #main-toc,
#content_views.htmledit_views #hr-toc,
#content_views.htmledit_views p[id*=\”-toc\”] {
display: none !important;
}
/* 目录去掉后,紧跟的首个标题不再多出一块上边距 */
#content_views.markdown_views > .toc + h1,
#content_views.markdown_views > .toc + h2,
#content_views.markdown_views > .toc + h3,
#content_views.markdown_views > .toc + h4,
#content_views.markdown_views > .toc + p:empty + h1,
#content_views.markdown_views > .toc + p:empty + h2,
#content_views.markdown_views > .toc + p:empty + h3,
#content_views.markdown_views > .toc + p:empty + h4 {
margin-top: 0 !important;
}
在服务器终端里敲完一条命令,下一条为什么已经补在光标后面?
SSH 到一台 Linux 上,git status 刚跑完,提示符回来。光标后面已经有一行浅色的 git diff。那不是你敲进去的,回车也还没按下。
腾讯云 OrcaTerm 是连到你自己 Linux 服务器的终端,Web 端和桌面客户端都能开。这行浅色字是它的命令预测。整条链路分成三段:壳用 OSC 交出命令边界,客户端在边界上预取一整句,再按你此刻的输入从这句里切出后缀,画进光标所在的格子。你每打一个字,都不会再发一次预测请求。
命令边界来自钩子,不来自空闲计时
zsh 里,preexec 在回车之后、命令开始之前运行;precmd 在上一条结束、新提示符打出来之前运行。OrcaTerm 用 add-zsh-hook 注册具名函数,不覆盖你自己的 preexec / precmd。precmd 的第一行就把 $? 存下来。后面只要再跑子进程,退出码就不是刚才那条命令的了。
这两个钩子各写一条 OSC 1337,BEL 结束。终端协议里 OSC 是带外序列,解析器吃掉,不会进屏幕缓冲。
ESC ] 1337 ; PreExecMarker ; git status BEL
ESC ] 1337 ; PostExecMarker ; Exit=0 ; CurrentDir=/home/dev/app BEL
PreExecMarker 后面是你刚回车的那一行,终端用它记下「正在跑的命令」。PostExecMarker 里的 Exit 是刚才存下的退出码,CurrentDir 是当时的 $PWD。提示符再被 OSC 133 的 PS 和 PE 包住,客户端才知道哪一段是提示符、输入区从哪一列开始。zsh 里这些字节必须用 %{ %} 包起来,否则算进 PS1 的显示宽度,Tab 补全和多行输入的光标会错位。oh-my-zsh、powerlevel10k、starship 会在 precmd 里重写 PS1,所以包装函数也挂在 precmd 上,每次画提示符之前把标记补回去。
bash 用 PROMPT_COMMAND 和 PS1 打同一类标记。桌面客户端打开本机的 macOS 或 Linux 终端时,这套钩子只活在当前会话里,不改磁盘上的 ~/.zshrc。连远程 Linux 时,要在终端里右键,从增强功能装上脚本,远程壳才会发这些序列。本机 Windows 终端不预测。SSH 或 TAT 连到 Linux 可以。切到 AI 助手模式时预测停掉,输入留给对话。
终端只有在退出码真的记下来时才把这次执行当成一条完成的命令,并据此发起预测。全屏程序走了备用屏幕、或者结束时没有退出码,这次不记入历史,预测也不会开始。下一次 PostExecMarker 到达时,上一轮还没画出来的候选先清掉。新结果回来之前,光标后面不会先闪旧的那一句。
预取的上下文和你正在打的字是两套数据
请求在命令记完时发出,输入固定是 predict next terminal command。真正的终端状态放在三个字符串字段里:systemContext、currentTaskContext、lastCommandFailure。当前输入、终端块、原始历史记录不在这份载荷里。缓存键也只用这三个字段,两分钟内同一份上下文不再请求。上一条命令如果已经写进 currentTaskContext 的最后一条,就不会再单独送一遍。
currentTaskContext 最多 5 条,从旧到新。历史里先去掉最后一条,再取最多 4 条,然后拼上刚刚结束的那条。最近 3 条可以带输出,更早的若本身有输出,字段写成 outputOmitted: true,正文不带。这和「输出被截断」不是同一个标记。截断用 outputTruncated: true,并在正文里写明省掉了多少字符。省掉的是中间,头尾都留:头大约占预算的三成,尾是剩下的部分。最新一条的预算是 4000 字符,更早那几条是 1000。模型被要求把省略当成「没看到」,不能当成这条命令没有输出。
出站之前命令和输出走不同的清洗。命令行按 shell 语法拆参数,再遮密码、token 这一类值;输出只剥 CSI、OSC,再做文本替换,不把日志当 shell 去解析。超长输出先截出一段扫描窗口再脱敏,窗口外的内容不会进请求。目录只做家目录归约:/home/<用户>、/Users/<用户>、C:\\Users\\<用户> 收成 ~。主机名、用户名、IP、会话号不进上下文。耗时用起止时间相减得到 durationMs,原始时间戳不送。
lastCommandFailure 是客户端自己从输出里判的,只覆盖「命令不存在」。退出码为 0 时不做这步。先去掉 ANSI,再用 bash、zsh 和 Windows 的 command not found / is not recognized 句式抽出命令名。纠错是一份固定命令表上的编辑距离,距离大于 1 就没有建议;末尾多打的数字会先剥掉再查表,例如 grep1 对上 grep。这个建议和模型返回的三句是分开的,模型只是能在上下文里看到它。
模型按推荐顺序回 3 条完整命令。客户端丢掉空串、和当前输入完全相同的句子、重复项,再用一组正则丢掉递归强制删除这类句子,最后留下最多 3 条。这组正则不是 shell 语法分析,引号、命令替换可以绕过它,所以它只决定灰字出不出现,不代替执行前的确认。连续 3 次超时或失败之后,这次会话不再发预测;一次成功或一次空结果把计数清零。单次请求 5 秒到点就中止。后返回的响应用请求序号丢掉,避免上一条命令的 git diff 画到下一条命令的提示符上。
灰字是后缀,而且要和 PTY 里的输入对齐
空提示符上,第一条候选整句画出来。你已经打出字符之后,只在候选以这段字符开头时,把多出来的后缀留下。Linux 上区分大小写。Windows、PowerShell、cmd 先按小写比较,切后缀时仍按原始字符串的长度切,所以补出来的大小写还是模型写的那一版。对不上就什么都不画。匹配全在本地,候选列表不变。
画之前还有一道和终端状态的核对。命令文本必须和产生这条建议时的文本一致;这条命令还不能已经有输出;光标必须停在输入区末尾;壳自己的补全文本必须是空的。键已经送到 PTY、回显还没回来的那几十毫秒里,状态轮询仍可能读到按键之前的空提示符。这段时间标成 pending,灰字先卸掉,也不许慢回来的空提示符预测再贴上去。pending 的基线是按键前那一版输入,回显一旦和基线不同才解除。
接受之后也有同样的窗口。右箭头把后缀 sendData 进 PTY,终端里的真实输入要等回显才变长。在真实输入仍是「已接受的那句」的前缀时,不再把旧后缀画一次,否则 diff 会叠两遍。真实输入偏离这句之后,这个保护才取消。
绘制用的是 xterm 的 decoration,挂在光标 marker 上,不另算一层像素坐标。真正下笔前再看光标那一格:格里已经有字符,就认为是壳的历史补全,这次不画。powerlevel10k 的右侧提示符和光标之间是空格,空格不算补全,灰字仍可以画。默认接受键是右箭头,灰字旁边可以改成 Tab 或 Shift+右箭头。接受只送后缀,不送回车。
所以 git status 后面那行 git diff,是 PostExecMarker 触发的一次预取;你后来打的字只决定这句还剩哪一段能放在光标后面。命令还在跑、没有退出码、或者光标那一格已经被壳占住,这行浅色字都不会出现。

网硕互联帮助中心



评论前必须登录!
注册