opsxshell/homepage/dist/docs/ai/index.html

<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>终端 AI 助手 · OpsXShell 文档</title>
<meta name="description" content="OpsXShell 运维终端用户文档 — SSH、SFTP、端口转发、RDP/VNC、串口与终端 AI。">
<link rel="icon" type="image/svg+xml" href="data:image/svg+xml,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20viewBox%3D%220%200%2064%2064%22%3E%3Cdefs%3E%3ClinearGradient%20id%3D%22g%22%20x1%3D%220%22%20y1%3D%220%22%20x2%3D%2264%22%20y2%3D%2264%22%20gradientUnits%3D%22userSpaceOnUse%22%3E%3Cstop%20offset%3D%220%22%20stop-color%3D%22%232563EB%22%2F%3E%3Cstop%20offset%3D%221%22%20stop-color%3D%22%2306B6D4%22%2F%3E%3C%2FlinearGradient%3E%3C%2Fdefs%3E%3Crect%20width%3D%2264%22%20height%3D%2264%22%20rx%3D%2214%22%20fill%3D%22url(%23g)%22%2F%3E%3Cg%20stroke%3D%22%23fff%22%20stroke-width%3D%225%22%20stroke-linecap%3D%22round%22%20stroke-linejoin%3D%22round%22%20fill%3D%22none%22%3E%3Cpath%20d%3D%22M17%2025h26%22%2F%3E%3Cpath%20d%3D%22M37%2019l6%206-6%206%22%2F%3E%3Cpath%20d%3D%22M47%2039H21%22%2F%3E%3Cpath%20d%3D%22M27%2033l-6%206%206%206%22%2F%3E%3C%2Fg%3E%3C%2Fsvg%3E">
<link rel="stylesheet" href="/docs/assets/docs.css">
</head>
<body>
<svg xmlns="http://www.w3.org/2000/svg" style="display:none" aria-hidden="true">
<symbol id="i-menu" viewBox="0 0 24 24"><path d="M4 5h16" /> <path d="M4 12h16" /> <path d="M4 19h16" /></symbol>
<symbol id="i-search" viewBox="0 0 24 24"><path d="m21 21-4.34-4.34" /> <circle cx="11" cy="11" r="8" /></symbol>
</svg>
<header class="topbar">
  <div class="topbar-inner">
    <button class="menu-btn" id="menu-btn" aria-label="打开导航"><svg class="i"><use href="#i-menu"/></svg></button>
    <a class="brand" href="/docs">
      <span class="brand-logo"><svg width="28" height="28" viewBox="0 0 64 64" aria-label="OpsXShell"><defs><linearGradient id="lg-docs" x1="0" y1="0" x2="64" y2="64" gradientUnits="userSpaceOnUse"><stop offset="0" stop-color="#2563EB"/><stop offset="1" stop-color="#06B6D4"/></linearGradient></defs><rect width="64" height="64" rx="14" fill="url(#lg-docs)"/><g stroke="#fff" stroke-width="5" stroke-linecap="round" stroke-linejoin="round" fill="none"><path d="M17 25h26"/><path d="M37 19l6 6-6 6"/><path d="M47 39H21"/><path d="M27 33l-6 6 6 6"/></g></svg></span>
      <span class="brand-name">OpsXShell <em>文档</em></span>
    </a>
    <span class="ver-badge">v2.1.1</span>
    <div class="search">
      <input id="search-input" type="search" placeholder="搜索文档…" autocomplete="off" spellcheck="false">
      <div class="search-panel" id="search-panel" hidden></div>
    </div>
    <nav class="top-links">
      <a href="/">官网</a>
      <a href="/#download">下载</a>
    </nav>
  </div>
</header>

<div class="layout" id="layout">
  <aside class="sidebar" id="sidebar">
    
    <div class="nav-group">
      <div class="nav-group-title">开始使用</div>
      
      <a class="nav-link" href="/docs/overview">概述</a>
      
      <a class="nav-link" href="/docs/sessions">会话与主机管理</a>
      
    </div>
    
    <div class="nav-group">
      <div class="nav-group-title">功能指南</div>
      
      <a class="nav-link" href="/docs/terminal">终端与批量执行</a>
      
      <a class="nav-link" href="/docs/sftp">SFTP 文件传输</a>
      
      <a class="nav-link" href="/docs/remote-desktop">远程桌面 RDP / VNC</a>
      
      <a class="nav-link" href="/docs/forwarding">端口转发与 SOCKS5</a>
      
      <a class="nav-link" href="/docs/serial">本地终端与串口</a>
      
      <a class="nav-link active" href="/docs/ai">终端 AI 助手</a>
      
    </div>
    
    <div class="nav-group">
      <div class="nav-group-title">授权与帮助</div>
      
      <a class="nav-link" href="/docs/license">授权与激活</a>
      
      <a class="nav-link" href="/docs/faq">常见问题</a>
      
    </div>
    
    <div class="sidebar-foot">© 2026 OpsXShell · 本地优先的运维终端</div>
  </aside>

  <main class="content">
    <div class="breadcrumb">文档 <span>/</span> 功能指南 <span>/</span> 终端 AI 助手</div>
    <h1 class="page-title">终端 AI 助手</h1>
    <div class="page-meta">更新于 2026-10-16</div>
    <article class="md">
<p>自然语言描述任务，AI 在<strong>当前 SSH 连接</strong>上真实取证、给出有证据的结论——执行权始终在你手里（专业版）。</p>
<h2 id="sec-1">配置模型供应商</h2>
<p>在「设置 → 大模型」中添加 Provider。内置预设：DeepSeek、Z.AI/GLM、MiniMax、Kimi、Qwen、OpenAI、Anthropic、OpenRouter、Ollama、new-api，也可以从空白配置开始：</p>
<ol>
<li>选供应商预设或「自定义」；新配置只在当前表单暂存。</li>
<li>选模型、核对 Endpoint、输入 API Key；协议与 HTTP 开关在收起的「高级设置」里。</li>
<li>点「测试连接」——应用会用<strong>当前表单里填写的</strong>凭据向目标模型发一条「你是什么模型？请简短回答。」，但不会保存任何内容；只有返回成功且回答非空才显示 <code>HTTP 200</code>。</li>
<li>测试成功后「保存」才可用；Endpoint、模型、协议或凭据一变，测试结果立即失效。</li>
<li>保存后 API Key 加密存放在本机，设置文件中不含明文，界面也不回显。</li>
</ol>
<p>new-api、One API、OpenRouter 等网关用「自定义」或相应预设，填自己的 <code>/v1</code> Endpoint 与实际模型 ID。</p>
<h2 id="sec-2">在终端里用</h2>
<p>终端工具栏点「AI 助手」打开 Agent 面板：</p>
<ul>
<li>直接输入任务，例如「排查 nginx 为什么启动失败并修复」。回车发送，<code>Shift+回车</code> 换行。</li>
<li>有终端<strong>选区</strong>时会作为初始上下文；没有选区不抓整屏，Agent 通过真实 SSH 执行自主取证。</li>
<li>Agent 最多执行 <strong>12 步</strong>，每步一条单行命令；界面显示当前主机、命令与风险等级。</li>
<li>执行后的真实输出和退出码回给 AI 判断下一步；连续失败会被要求换方法；相同命令第 3 次会在执行前拦截。</li>
<li>长输出会自动提取错误要点并保留首尾，控制上下文长度。</li>
</ul>
<h2 id="sec-3">风险分级与确认</h2>
<table>
<thead>
<tr>
<th>等级</th>
<th>示例</th>
<th>严格模式</th>
<th>宽松模式（默认）</th>
</tr>
</thead>
<tbody>
<tr>
<td>safe</td>
<td><code>df -h</code>、<code>journalctl -u nginx</code></td>
<td>自动执行</td>
<td>自动执行</td>
</tr>
<tr>
<td>low</td>
<td>未知自定义查询命令</td>
<td>自动执行</td>
<td>自动执行</td>
</tr>
<tr>
<td>medium</td>
<td>文件写入、普通权限变更</td>
<td>先确认</td>
<td>自动执行</td>
</tr>
<tr>
<td>high</td>
<td>服务重启、删除、包安装、K8s 变更</td>
<td>先确认</td>
<td>先确认</td>
</tr>
<tr>
<td>critical</td>
<td>格式化磁盘、删除根目录、fork bomb</td>
<td>硬拒绝</td>
<td>硬拒绝</td>
</tr>
</tbody>
</table>
<ul>
<li>安全模式在任务开始时锁定，运行中不能切换。</li>
<li><strong>critical 永远硬拒绝</strong>：界面拦一次，命令执行前底层再拦一次，双保险，不存在「确认放行」。</li>
<li>需要确认时，对话框显示本次锁定的模式、目标主机、风险与完整命令，由你选择：拒绝 / 只插入不执行 / 本次执行。</li>
</ul>
<h2 id="sec-4">隐私与数据边界</h2>
<ul>
<li>云模型会把所选上下文发给相应供应商；<strong>发送前自动脱敏</strong>常见敏感信息（密码、Token、Authorization Header、AWS Key、私钥块）。有严格数据边界时用本机 Ollama，并仅在可信本机上开启 HTTP。</li>
<li>关闭面板后任务、命令、工具输出和回答<strong>全部清空</strong>，不写入历史——OpsXShell 不保存 AI 对话、终端上下文或长期记忆。</li>
<li>终端输出被标记为不可信数据：日志里出现的「忽略规则」之类文字不会变成指令。</li>
<li>不提供独立的 podexec；远端已有的 <code>kubectl</code>、<code>helm</code>、<code>docker</code> 都通过同一条 SSH 执行链使用。</li>
</ul>

    </article>

    <div class="pn-nav">
      
      <a class="pn prev" href="/docs/serial"><span class="pn-label">← 上一页</span><span class="pn-title">本地终端与串口</span></a>
      
      
      <a class="pn next" href="/docs/license"><span class="pn-label">下一页 →</span><span class="pn-title">授权与激活</span></a>
      
    </div>
  </main>

  <aside class="toc">
    <div class="toc-title">本页目录</div>
    <nav class="toc-nav">
      <a class="toc-l2" href="#sec-1">配置模型供应商</a>
      <a class="toc-l2" href="#sec-2">在终端里用</a>
      <a class="toc-l2" href="#sec-3">风险分级与确认</a>
      <a class="toc-l2" href="#sec-4">隐私与数据边界</a>
      
    </nav>
  </aside>
</div>

<script src="/docs/assets/docs.js" defer></script>
</body>
</html>