智能助手 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)
- 运行依赖:
opencodeCLI(作为弱依赖随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 的整体架构自上而下贯穿用户接入、运维智能体、运维底座、智能平台、基础设施五个层次,同时覆盖通算(传统集群/单机)与智算(超节点)两种算力形态:
| 层次 | 说明 |
|---|---|
| 用户接入 | 智能交互入口(自然语言交互 / 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。
相关文档
文档捉虫
