插件
插件安装器会检测一组固定的终端工具在某台机器上装没装,并替你安装或卸载它们, 省得自己去记每个工具用哪个包管理器、包名叫什么。
当前列表固定为 11 个 CLI 工具,是工具安装器,不是第三方扩展市场。安装其他 Agent 不会共享 TT Agent 的模型配置;其账号、API Key 与会话按各工具自己的方式管理。
打开它
从"文件"菜单里选择"插件…",或者打开命令面板(⌘⇧P)搜索"插件"。它没有专门的
键盘快捷键。
安装器的操作对象是当前聚焦面板所连接的那台机器:从这台 Mac 上的终端打开它,检测和安装
就在本机进行;从一个通过 SSH 连着远程主机的终端打开它,检测和安装就换到那台主机上——
弹窗、工具列表、可执行的操作两边完全一样。面板的副标题会写明目标("目标:本机"或
"目标:<主机名>"),以及开始探测后识别出的操作系统类型。
能安装哪些工具

| 工具 | 用途 | 安装方式 |
|---|---|---|
| Claude Code | Anthropic 的终端编码 agent | npm |
| Codex | OpenAI 的终端编码 agent | npm |
| Gemini | Google 的终端编码 agent | npm |
| Qwen Code | Qwen Code 终端编码 agent | npm |
| tmux | 终端复用器,断线不丢会话 | 系统包管理器 |
| btop | 资源监视器 | 系统包管理器 |
| fzf | 模糊查找器 | 系统包管理器 |
| ripgrep | 极快的代码搜索 | 系统包管理器 |
| fd | 更好用的 find | 系统包管理器 |
| ncdu | 磁盘占用分析 | 系统包管理器 |
| aria2 | 多线程下载工具 | 系统包管理器 |
前四个是作为全局 npm 包安装的,所以目标机器上必须已经有 Node.js 和 npm——安装器不会替你
装这两样。其余几个走目标机器上探测到的系统包管理器:macOS 上是 Homebrew,Debian/Ubuntu
上是 apt,RHEL 系是 dnf(探测不到就退回 yum),Arch 是 pacman,openSUSE 是
zypper。同一个工具在不同包管理器里的包名可能不一样——比如 fd 在 apt 和 dnf 下叫
fd-find。
如果安装器在目标机器上认不出支持的包管理器,会直接对那个工具报"该系统暂不支持自动安装", 而不是硬猜一条命令去跑。
安装是怎么进行的
打开这个面板会把列表里的工具逐一探测一遍——不是一次性全部探测,这样不会一下子给远程主机
甩过去几十条并发命令——过程中会显示"正在探测 <工具>(i/N)"。探测完成后,底部状态行
要么确认所有插件都已安装,要么说明还有几个没装。一个"刷新"按钮能重新跑一遍整个检测。
安装或卸载一个工具时,会跑对应的命令(npm install -g …、brew install … 等等),
走的是和终端命令一样的远程执行链路——这也是为什么不管目标是这台 Mac 还是一台 SSH 主机,
表现都完全一致。命令是非交互式运行的,跑之前会先把普通登录 shell 本该自动加载的那些环境
补上——Homebrew 的环境变量、由 nvm 管理的 Node、以及 ~/.local/bin——因为在非登录 shell
里这些都不会自动生效。
每条命令的输出都会追加到面板底部的日志区,出了问题时能直接看到到底跑了什么、输出了什么, 而不只是成功还是失败这一个结果。
每个条目的状态
每一行都带一个表示当前状态的角标:
- 检测中…——正在探测,或者还没探测过。
- 未安装——探测过,确认没装;会出现一个"安装"按钮。
- 已安装——探测过,确认已装;这时出现的是"卸载"按钮。
- 执行中…——这个工具的安装或卸载正在进行。
卸载前会先要求确认,并说明这只是把工具从目标机器上移除,随时可以重新安装。
失败的时候
安装或卸载失败不会只把问题留在日志里等你自己发现——底部状态栏会显示
"「<工具>」执行失败,详情见下方日志",并带一个自己的"重试"按钮。如果命令的输出里出现
了 sudo,日志还会额外加一行提示:需要密码,请改到终端里手动执行安装命令——安装器所有
命令都是非交互式运行的,没法回应密码提示。
每次安装或卸载操作完成后,面板都会重新探测一遍,而不是只看命令的退出码——一次 npm
安装可能退出码是 0,但可执行文件其实并没有进到 PATH 里,如果只看退出码就会被误判成
"已安装",而实际上还用不了。
每次打开这个面板都会把整份列表重新探测一遍,不会沿用上次打开时的结果,所以看到的 永远是这台机器当下的真实状态。
Claude Code 与 TT Agent 的依赖
安装 Claude Code 会更新连接到同一台机器的终端中的独立 Claude 模式可用状态。TT Agent 运行时随桌面应用内置,通过 wsh 操作远端 shell。参见 TT Agent 配置。