智能助手 Witty CLI 介绍

产品概述

Witty CLI(命令 witty)是 openEuler 终端场景下的 AI 助手命令行入口,面向 openEuler 生态提供自然语言化运维交互体验。它采用单二进制形态,内置 Shell 直输REPL 两种交互入口,通过 SSE 流式传输实时输出 AI 回答,并以 opencode serve 作为执行底座,为用户提供会话、渲染、权限与展示能力。

通过深度集成大模型能力,Witty CLI 支持将自然语言指令精准转化为运维操作,帮助用户快速完成系统查询、日志分析、故障诊断与方案规划,降低 openEuler 新用户入门门槛,简化运维操作流程,全面降低系统运维成本。

支持平台

  • 操作系统:openEuler 24.03 LTS SP3 或更高版本(x86_64 / aarch64)
  • 运行依赖opencode CLI(作为弱依赖随 witty 一并安装)
  • 终端:Bash ≥ 4.0(Shell 直输功能需要)

工作模式

Witty CLI 提供两种使用方式,二者共享同一套会话、渲染、权限与展示核心,差别仅在入口形式:

入口用户动作实际实现
Shell 直输在普通 Bash 提示符直接输入自然语言Shell Adapter 调用 witty ask
REPL 交互运行 witty启动交互式 REPL,内部调用同一套核心

无论哪种入口,输出风格、会话连续性、控制命令都保持一致。

功能特性

  • Shell 直输:在 Bash 提示符直接输入自然语言即可触发 AI 助手
  • REPL 交互:运行 witty 进入交互式 CLI,提示符 witty [<agent>:<model>] >
  • 自动服务管理:自动管理 opencode serve 生命周期(自动启动、健康检测、闲置超时停止、多用户安全隔离)
  • Provider 管理witty provider list / witty provider connect 连接模型服务并切换模型
  • 环境诊断witty doctor 一键检查配置、server、Shell 集成与终端环境
  • 单次提问witty ask <prompt> 流式输出回答后退出,支持管道输入
  • 会话管理:自动恢复当前目录会话,支持 /session list/session continue <id>/new

架构概览

Witty 整体架构图

Witty 的整体架构自上而下贯穿用户接入、运维智能体、运维底座、智能平台、基础设施五个层次,同时覆盖通算(传统集群/单机)与智算(超节点)两种算力形态:

层次说明
用户接入智能交互入口(自然语言交互 / Agent 调度管理 / 智能 Shell)与客户运维系统;Witty CLI 即处于该层
运维智能体智能运维、智能调优、智能问答与 3rd 智能体,提供融合采集、拓扑感知、根因分析、日志异常检测等能力
运维底座运维大模型 / OS 领域大模型、运维元能力集、运维知识服务与运维智能化服务
智能平台向量数据库(openGauss 等)、Agent 开发平台 / 运行时(xiaoO / OpenCode 等)与异构融合 OS
基础设施K + A / K + X 等算力底座

Witty CLI 的全部后端交互建立在 opencode serve 之上:会话操作走 HTTP API,流式事件走 SSE,权限 / Question 回复走 API,Agent / MCP / Session 元信息也来自 OpenCode。

原先通过独立 MCP Server 提供的 RAG 与日志检测能力,在 Witty CLI 中已改为以 Skill 形式提供(详见「使用智能助手 CLI Agent」),无需再手工部署独立的 MCP Server。

相关文档