跳到主要内容

Termia Agent

TT Agent 是 Termia 内置的 shell 助手,运行时随应用一起打包。它接管一个终端面板,使用该面板的连接和工作目录上下文;退出后,面板回到 shell。Agent 可以通过 shell 工具读取日志、执行命令和修改文件。修改生产主机前,应检查拟执行的命令及其结果。

内置 Agent 运行时​

安装包包含 TT Agent 的 gen.mjs 运行时及配置,不需要另行安装 Agent CLI 或配置 CLI 路径。在 AI 设置中选择 Provider 与模型即可使用。Node.js 使用安装包中的可执行文件,或系统 PATH 中的 Node.js。

启动与退出​

从终端模式栏或面板菜单选择 TT Agent。
从终端模式栏或面板菜单选择 TT Agent。查看原图 ↗

点击终端模式栏里的 Termia 智能体 / TT Agent,或输入:

tt
tt "分析这个服务为何启动失败"
tt --resume
tt --resume <session-id>

tt "<提示词>" 会开启一个带初始提示词的交互式 Agent 会话,不是无交互的一次性任务,也不会因此自动启用无限制执行。Resume 恢复的是 Agent 对话,不会重新接管一个远端 shell 进程,也不会重新启动已经结束的命令。

输入 exit、按 Ctrl+D,或切回终端退出 Agent。当前有前台程序占用终端时,先正常退出或完成它的保存提示。Agent 启动失败会在终端中显示原因,并恢复 shell。

本机与远端模式​

Agent 运行时始终位于桌面电脑上。面板连接 SSH 或 WSL 时,shell 操作通过现有 wsh/RPC 连接路由到目标机器。远端不需要安装 Agent 运行时或 Node.js,但 wsh 必须启用并正常工作。启动远端 Agent 时可能会先连接主机或安装 helper。

关闭应用会停止本机 Agent 运行时。需要在桌面断开后继续运行的远端任务,请有意识地放入 tmux、screen 或其他持久任务服务。Termia 目前没有托管的后台 Agent 执行服务。

选择 Provider 与模型​

选择并配置 TT Agent 使用的 Provider。
选择并配置 TT Agent 使用的 Provider。查看原图 ↗

打开 设置 → AI → 管理 Provider 与模型…。TT Agent 的模型选择由所有会话共用,不是每个面板独立设置。切换当前 Provider、模型或其凭据会使用新配置重启正在运行的 TT Agent;请先完成或暂停正在进行的操作。

使用自己的模型服务(BYOK)​

添加一个兼容 OpenAI API 的自定义 Provider,填写名称、API 基础地址、API Key 和模型 ID。端点提供模型列表时,可以使用获取/探测模型操作。保存后选择该 Provider 和模型使其生效。不校验认证的本地端点可以接受占位 Key。

BYOK 不需要 Termia 账号。 请求直接发送到配置的端点。内置 Provider 需要可用的 Termia 服务并登录;源码构建不自带免费的模型服务。使用自定义模型与云同步互不依赖。

自定义 Provider 可以编辑或删除。删除当前 Provider 后可能回退到内置默认值;未登录时,请先选择另一个自定义 Provider 再启动 Agent。

上下文与命令纠错​

真实失败命令后的纠错建议。规则与修复历史可提供建议,AI 建议另需可用模型服务;采纳前先检查提案。
真实失败命令后的纠错建议。规则与修复历史可提供建议,AI 建议另需可用模型服务;采纳前先检查提案。查看原图 ↗

绑定到面板的片段和笔记可以提供 Agent 上下文;环境变量绑定影响终端环境。当前绑定作用域是全局与单个面板,不是按主机或主机组自动关联的运维手册。

独立的命令纠错开关在 shell 命令失败后,根据工具输出、个人修复记录、规则或 AI 提供建议。插入建议后先在提示符检查,再自行执行,也可以忽略。它不是主动故障监控,也不是输入时的 shell 自动补全。

其他编程 CLI​

Claude Code、Codex、Gemini 等工具可以安装后作为终端程序运行。它们有独立的运行时、认证、审批和会话行为;选择 TT Agent 模型不会统一配置这些工具。

排查问题​

  • 未登录时内置模型不可用:登录或改选自定义 Provider。
  • 认证/模型列表请求失败:检查 API Key 和 API 地址,不要填写服务商网站首页。
  • 远端命令失败:先检查 SSH 与 wsh;普通 SSH shell 可用不代表 helper 已启用。
  • Agent 无法启动:检查安装包是否包含 bin/gen.mjs,以及内置 Node.js 或系统 PATH 中的 Node.js 是否可用。源码构建时,打包前运行 task copy:gen-cli。