安装增强功能

OrcaTerm 通过在服务器上安装增强功能脚本，为终端解锁一系列高级能力。脚本会在 Shell 中注入 OSC 1337 等带外信令钩子，让客户端识别命令边界、当前目录与退出码，从而实现文件编辑器、实例监控、Notebook、会话恢复与 CodeBuddy 等功能。

Important

上传下载是基础服务的必选项，会随安装一并启用；其他增强功能可按需勾选安装。增强功能仅对 Shell 终端（SSH / TAT / 本地终端） 生效，Windows 远程桌面（RDP）不支持。

功能介绍

文件上传支持本地上传和拖拽上传。您可以在命令行选中文件名单击鼠标右键，从而直接下载文件。

会自动在用户服务器安装 vscode server，支持可视化的文件编辑功能，帮助您高效浏览、编辑文件。

在终端底部状态栏会实时显示服务器的 CPU、内存、网络带宽和磁盘 IO 等数据，点击可以在命令面板中展示监控图表。

在终端中直接打开 Notebook 环境，支持以单元格形式执行代码、查看输出，适合数据分析与脚本调试。

安装后可将当前会话的命令历史、工作目录等上下文持久化，断线重连或重启客户端后可恢复到上次状态。详见恢复终端会话。

在终端旁打开 CodeBuddy 代码助手面板，结合当前会话上下文提供代码建议与命令辅助。

参见创建第一个连接，登录服务器。
登录服务器后，在终端内任意位置单击鼠标右键，在功能菜单中选择安装 OrcaTerm 增强功能：
在安装增强功能弹窗中勾选您需要的功能后，单击下一步。

说明：

本次安装操作未勾选的功能，后续可以通过以上路径单击 增强功能 > 安装，再次进入弹窗进行自定义安装。
下一步展示安装增强功能命令，单击 确认安装 即可完成安装。
安装成功后：
- 安装成功后立即生效，监控功能会自动启动。

当检测到服务器已安装的脚本版本落后于客户端版本时，会自动弹出升级提示：

参见创建第一个连接，登录服务器。
在登录服务器后，在终端内任意位置单击鼠标右键，在功能菜单中选择卸载 OrcaTerm 增强功能：
在卸载增强功能弹窗中勾选您要卸载的功能后，单击下一步。

说明：

本次卸载操作未勾选的功能，后续可以通过以上路径单击 增强功能 > 卸载，再次进入弹窗进行卸载。
下一步展示卸载增强功能命令，单击 确认卸载 即可完成卸载。

增强功能脚本通过 Shell 钩子（bash / zsh 的 preexec / precmd、PROMPT_COMMAND / PS1）注入 OSC 转义序列：

OSC 通道	用途
OSC 133 / 6973	提示符就绪信号（Command Start / End），由 xterm parser 处理跨数据块标记
OSC 633	Zsh ZLE 当前 BUFFER 与 line-init 显式就绪信号
OSC 1337	OrcaTerm 增强脚本标记：当前目录（CurrentDir）、命令执行前后标记（PreExec / PostExec）、退出码
OSC 9 / 777 / 99	桌面端统一通知（仅桌面端注册）

这些带外信令由终端原样转发给渲染层，不会被当作命令执行，仅传递位置标记 + 退出码 + 当前目录三类信息，不传送命令明文、输出内容或文件数据。

Note

桌面客户端对增强功能的支持与 Web 端存在差异：

一般无法安装增强功能的原因是实例网络不通，该情况下可以将脚本下载至本地后，将脚本拖拽上传至服务器后，执行安装。

部分实例（如容器、特殊系统）不支持安装增强功能，终端会显示「不支持」状态并禁用安装入口。