OpsXShell 文档 v2.1.1

终端 AI 助手

更新于 2026-10-16

自然语言描述任务,AI 在当前 SSH 连接上真实取证、给出有证据的结论——执行权始终在你手里(专业版)。

配置模型供应商

在「设置 → 大模型」中添加 Provider。内置预设:DeepSeek、Z.AI/GLM、MiniMax、Kimi、Qwen、OpenAI、Anthropic、OpenRouter、Ollama、new-api,也可以从空白配置开始:

  1. 选供应商预设或「自定义」;新配置只在当前表单暂存。
  2. 选模型、核对 Endpoint、输入 API Key;协议与 HTTP 开关在收起的「高级设置」里。
  3. 点「测试连接」——应用会用当前表单里填写的凭据向目标模型发一条「你是什么模型?请简短回答。」,但不会保存任何内容;只有返回成功且回答非空才显示 HTTP 200。
  4. 测试成功后「保存」才可用;Endpoint、模型、协议或凭据一变,测试结果立即失效。
  5. 保存后 API Key 加密存放在本机,设置文件中不含明文,界面也不回显。

new-api、One API、OpenRouter 等网关用「自定义」或相应预设,填自己的 /v1 Endpoint 与实际模型 ID。

在终端里用

终端工具栏点「AI 助手」打开 Agent 面板:

  • 直接输入任务,例如「排查 nginx 为什么启动失败并修复」。回车发送,Shift+回车 换行。
  • 有终端选区时会作为初始上下文;没有选区不抓整屏,Agent 通过真实 SSH 执行自主取证。
  • Agent 最多执行 12 步,每步一条单行命令;界面显示当前主机、命令与风险等级。
  • 执行后的真实输出和退出码回给 AI 判断下一步;连续失败会被要求换方法;相同命令第 3 次会在执行前拦截。
  • 长输出会自动提取错误要点并保留首尾,控制上下文长度。

风险分级与确认

等级 示例 严格模式 宽松模式(默认)
safe df -h、journalctl -u nginx 自动执行 自动执行
low 未知自定义查询命令 自动执行 自动执行
medium 文件写入、普通权限变更 先确认 自动执行
high 服务重启、删除、包安装、K8s 变更 先确认 先确认
critical 格式化磁盘、删除根目录、fork bomb 硬拒绝 硬拒绝
  • 安全模式在任务开始时锁定,运行中不能切换。
  • critical 永远硬拒绝:界面拦一次,命令执行前底层再拦一次,双保险,不存在「确认放行」。
  • 需要确认时,对话框显示本次锁定的模式、目标主机、风险与完整命令,由你选择:拒绝 / 只插入不执行 / 本次执行。

隐私与数据边界

  • 云模型会把所选上下文发给相应供应商;发送前自动脱敏常见敏感信息(密码、Token、Authorization Header、AWS Key、私钥块)。有严格数据边界时用本机 Ollama,并仅在可信本机上开启 HTTP。
  • 关闭面板后任务、命令、工具输出和回答全部清空,不写入历史——OpsXShell 不保存 AI 对话、终端上下文或长期记忆。
  • 终端输出被标记为不可信数据:日志里出现的「忽略规则」之类文字不会变成指令。
  • 不提供独立的 podexec;远端已有的 kubectl、helm、docker 都通过同一条 SSH 执行链使用。