AI 助手指南

核心理念

Hux 的 AI 不仅看得见你正在做什么（活跃 pane、当前主机、最近命令、监控数据）， 还能动手帮你做 — 通过 tool use 直接执行远程命令、读写文件、 查 K8s 资源、操作浏览器。所有动作可中断、可回滚、可追溯。

对话基础

• ⌘⇧A 打开 / 关闭 AI 面板（移动端：底部 AI 按钮）
• 消息支持 Markdown，代码块带语法高亮
• 消息支持流式输出，可随时停止
• 历史对话本地持久化，按主机 / 项目分组

引用上下文

在输入框使用 @ 引用，AI 会自动拉到上下文：

• @host:web-01 引用某台主机
• @pane 引用当前活跃 pane 的最近输出
• @file:/etc/nginx/nginx.conf 引用远端文件
• @k8s:pod/api-7d9 引用某个 K8s 资源

工具调用（Tool Use）

AI 在一轮回复中可声明多个工具调用，Hux 会并发执行（而非串行）， 典型运维任务加速 40-60%。预置工具包括：

• terminal_exec：在指定主机的活跃 shell 执行命令，返回输出。 危险命令（rm / dd / kill / systemctl stop 等）默认需人工确认。
• file_read / file_write：读写远端文件（走 SFTP），支持 diff 预览。
• k8s_*：get / describe / logs / exec / port-forward / events / cp。
• docker_*：ps / logs / inspect / exec / compose 操作。
• monitor_query：查询当前监控数据（CPU / Mem / 网络 / 进程）。
• browser_*：通过 Browser MCP 打开网页 / 抓取内容，实时查文档。
• db_query：连接 Hux 数据库客户端中已配置的数据库执行 SQL。

思考过程（Thinking / Reasoning）

支持 Claude Extended Thinking、DeepSeek Hybrid、Qwen Thinking 等厂商的推理模式。 推理 token 会作为独立 block 显示在回复上方，灰色折叠，点击展开：

▸ 看到 worker pod CrashLoopBackOff
▸ 先看 logs → 连接 Redis 时 connection reset
▸ Redis 端口对 worker 的 NetworkPolicy 是否开放？
▸ 调 k8s_describe networkpolicy 验证
→ 决定：放开 worker → redis:6379 egress

在"设置 → AI → 思考模式"中切换 auto / on / off，或为某个 Skill 单独设置。

Skill（技能角色）

Skill 是预置好的系统提示词 + 工具白名单 + 模型偏好组合。预置 3 个：

• Terminal Assistant：通用终端助手，简洁直接。
• DevOps Helper：擅长 Docker / K8s / CI / 监控，会主动联检相关资源。
• DBA Helper：擅长 SQL 优化、explain、表结构变更，谨慎对待写操作。

自定义 Skill 在"设置 → AI → 我的 Skill"，可指定模型、思考模式、可用工具、初始 system prompt。详见 Skill 与提示词。

Sub-agent

当父 agent 判断任务可以并行拆解（如"对这 12 台主机做安全巡检"），它会派生 sub-agent 独立执行各自任务，结果回流父 agent 汇总。在面板上以可折叠树形显示：

■ 安全巡检 (parent)
├ ■ web-01：检查 SSH / sudoers / 防火墙 → 3 项 OK
├ ■ web-02：检查 SSH / sudoers / 防火墙 → 发现 root 登录开放 ⚠
├ ■ db-01：检查 Redis 鉴权 / 端口暴露 → 全部 OK
└ ■ 总结：1 台主机有风险，已生成修复脚本

MCP 服务接入

Hux 作为 MCP Client，可连接 HTTP 和 stdio 两种 transport 的 MCP server，让 AI 获得自定义工具能力（例如：你的内部告警系统、CI 流水线、知识库）。详见 MCP 服务接入。

中断 / 重试 / 历史

• 对话过程中可随时点击 "停止"，Hux 等当前工具调用 graceful 退出后写入终止事件
• 每条 AI 消息有 "重试此处" — 从该处重新生成，可换模型
• 所有事件（用户消息、AI 文本、思考、工具调用、错误）按 seq 严格有序，永远可回放

常见用法

排查 K8s Pod 异常

@hux 这个 pod 一直 CrashLoopBackOff，帮我诊断（光标在 pod 列表选中行）

主机巡检

@hux 检查这台主机的磁盘、内存、僵尸进程，生成一份巡检报告

日志分析

@hux 过去 24 小时 nginx error 日志里出现频率最高的 5 类错误

SQL 写入

@hux 帮我写一个迁移脚本：给 orders 表加索引 (user_id, created_at)， 注意百万级表要避免锁