跳到主要内容

插件

插件安装器会检测一组固定的终端工具在某台机器上装没装,并替你安装或卸载它们, 省得自己去记每个工具用哪个包管理器、包名叫什么。

当前列表固定为 11 个 CLI 工具,是工具安装器,不是第三方扩展市场。安装其他 Agent 不会共享 TT Agent 的模型配置;其账号、API Key 与会话按各工具自己的方式管理。

打开它​

从"文件"菜单里选择"插件…",或者打开命令面板(⌘⇧P)搜索"插件"。它没有专门的 键盘快捷键。

安装器的操作对象是当前聚焦面板所连接的那台机器:从这台 Mac 上的终端打开它,检测和安装 就在本机进行;从一个通过 SSH 连着远程主机的终端打开它,检测和安装就换到那台主机上—— 弹窗、工具列表、可执行的操作两边完全一样。面板的副标题会写明目标("目标:本机"或 "目标:<主机名>"),以及开始探测后识别出的操作系统类型。

能安装哪些工具​

工具条目显示探测或安装状态;这是 CLI 安装管理,不是扩展市场。
工具条目显示探测或安装状态;这是 CLI 安装管理,不是扩展市场。查看原图 ↗
工具用途安装方式
Claude CodeAnthropic 的终端编码 agentnpm
CodexOpenAI 的终端编码 agentnpm
GeminiGoogle 的终端编码 agentnpm
Qwen CodeQwen Code 终端编码 agentnpm
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 配置。