运维工作台
连接主机、执行任务、审查每一步操作
从一个明确的运维任务开始
描述要检查、排障或部署的内容，Agent 会调用真实工具执行，并把每一步命令、输出和结论留在对话里。
点上面的「复制全文」前会先自动生成…
比单条命令多抓这些：master 污点没去、CNI 没起来、系统 Pod 崩溃循环、资源不足 Pending、 fstab 与当前状态不一致、凭据在送模型前已脱敏。
选择一条任务查看详情
这里会展示任务摘要、每一步工具调用和可导出的审计记录。
AI SSH 运维 Agent 使用说明书
复杂功能集中在这里说明。先配置模型和主机，再用对话、任务中心、工作流和安全策略完成运维操作。
模型与 Provider
在左侧选择提供商和模型，再填写对应 API Key。Key 会写入本机 `.env`，只允许受配置约束的 provider 变量和主机密码变量。
Ollama 可免 Key 使用。模型列表接口失败时，系统会回退到 `config/providers.yml` 中配置的模型候选。
安全策略
只读：只允许安全的查询、检查和统计命令。
受控：查询直接执行，状态变更和敏感数据读取需要人工确认。
完整：允许一般状态变更，但灾难性命令仍会被硬阻断。
确认弹窗支持“执行一次”“本次会话放行”和“跳过”。超过 180 秒未处理会自动跳过。
高危审批
当命令命中风险规则，执行会被暂停并弹出确认框。确认后系统会重新提交该命令；拒绝则不会执行。
`mkfs`、写裸盘、关机重启、根目录删除等命令属于硬阻断，不能通过前端确认放行。
设备类型：Linux / Windows / 华为
支持三类被管设备，在「添加设备」里选类型即可，命令风格、监控探针、安全白名单都会自动切换：
① Linux 服务器（默认）—— 标准 Bash，监控用 uptime / free -m / df -h / top。
② Windows Server —— 命令按 PowerShell 解释。两种连接方式：openssh（默认，Server 2019+ 可加装 OpenSSH，支持文件传输）和 winrm（需 pip install pywinrm，端口 5985/5986，不支持文件传输）。监控走 CIM：Win32_Processor / OperatingSystem / LogicalDisk，服务用 Get-Service。
③ 华为网络设备（VRP） —— 交换机/路由器/防火墙。命令用 display 系列，监控用 display cpu-usage / memory-usage / interface brief。强制只读：只放行 display 类命令，配置类（system-view / save / undo / reset…）一律需要人工确认，即使策略设成「完整」也不自动执行。老设备只开 Telnet 的话，连接方式选 telnet。
手写 hosts.yml 的话在主机下加两行即可（类型别名很多，写 huawei / vrp / S5700 都认得）：
core-sw-01:
type: huawei_vrp
transport: ssh
host: 192.168.1.200
port: 22
user: admin
密码只保存在本机 .env 的 HOST_PW_* 变量中，不会发送给大模型。生产环境建议开启 OPS_STRICT_SSH_HOST_KEY=1。
监控与角色探针
设备可在 `hosts.yml` 中填写 `roles: [nginx, mysqld, redis]` 和 `services: [sshd]`。值守监测会按角色挂载对应探针。
Linux 的 roles 认 nginx / mysqld / docker / kubelet / ceph / redis；Windows 上 roles 会映射到对应服务（iis→W3SVC、mssql→MSSQLSERVER、ad→NTDS、hyperv→vmms…）；华为设备上填什么就 display 什么（如 roles: [interface, vlan]）。
全局阈值写在 `config/agent.yml`，单机阈值写在设备配置的 `thresholds` 下，例如 `cpu: 80`。
文件传输
本地上传和下载路径必须在 `OPS_TRANSFER_ROOTS` 允许目录内。默认只允许项目的 `downloads` 目录。
单个文件默认上限为 50MB，可在 `.env` 中用 `OPS_MAX_TRANSFER_BYTES` 调整。
任务中心
每次对话任务都会生成任务 ID，记录主机、模型、执行状态、工具步骤和最终回答。可搜索、查看详情，并用原任务重新执行。
任务日志保存在 `sessions/tasks.jsonl`，适合排查“模型为什么执行了这一步”。
任务运行时发送按钮会切换成“停止”，可以在模型调用结束后或当前命令执行完后暂停任务。
CLI 与启动方式
命令行启动：`python -m ai_agent`。查看主机或提供商：`python -m ai_agent --list-hosts`、`--list-providers`。
指定主机与模型：`python -m ai_agent --host db-server --provider glm --model glm-5`。
Web 启动：`python -m ai_agent.webapp`，可选 `--port 8400 --no-browser`。
授权安全评估
先把 `config/scope.example.yml` 复制为 `config/scope.yml`，填写授权项目、允许网段、排除目标、时间窗口和 Kali 扫描机主机名，再设置 `enabled: true`。
安全评估只执行固定 Nmap 配置和非破坏性检查。目标不在范围内会直接拒绝，不依赖大模型自行判断。
当前版本不包含自动漏洞利用、凭据转储、密码破解、持久化或横向移动。扫描结果、证据和报告保存到 `sessions/security/`。
账户与授权
登录页支持两种进入方式：邮箱 + 密码（正式账号）和访问令牌（游客，只读、只能问 AI，改不了任何配置）。
没有账号就点登录页下面的「没有账户？请注册」：填名称、邮箱、密码，注册后立刻得到一个自己的账号——自己的主机清单、自己的 API Key、自己的记忆库，跟别人互不影响。默认授权 7 天，到期后需要管理员续期。
管理员在控制台能看到谁登录了、什么权限、授权到什么时候，并随时续期、设永久、禁用或改密。
账号有四种权限：owner（什么都能改）> admin（能管配置）> operator（能干活）> viewer（只能看）。
工作流
巡检、日志排障、配置分发、新主机纳管、网站体检和配置备份都已内置成工作流入口。
工作流会将任务指令填入对话，再由 Agent 调用真实工具执行，结果可以沉淀到知识库。
常见问题
401：访问令牌错误，检查 `.env` 的 `OPS_ACCESS_TOKENS`。
未配置 Key：在左侧填写对应 provider 的 API Key。
SSH 失败：检查主机地址、端口、密码变量和网络连通性。
授权安全评估
只允许在 `scope.yml` 白名单、排除项和时间窗口内执行固定扫描与非破坏性检查。
选择一次评估
查看主机画像、开放服务、发现和报告。