快速上手
从安装到连上第一台主机，再到打开 AI 助手 — 一篇看完 Hux 的核心闭环。
1. 安装 Hux
根据你的设备到 下载页 安装客户端。Hux 在所有平台上均原生构建：
- macOS 14+：Mac App Store 或 .dmg 直装
- iPadOS / iOS 17+：App Store
- HarmonyOS 5.0.3+：华为 AppGallery
免登录也能用
Hux 启动后即可作为单机客户端使用基础 SSH、SFTP、笔记。登录账号是为了开通 Pro 订阅与跨端加密同步。
2. 添加你的第一台主机
- 1
新建主机
点击侧边栏 "主机" → "+" 按钮。也可以从命令面板（macOS: ⌘K / 移动端：长按） 搜索 "新建主机"。 - 2
填写连接信息
主机别名、Host（IP 或域名）、端口（默认 22）、用户名。认证方式可选：
- 密码登录：填写密码，会用设备密钥环加密保存。
- SSH 密钥：选择或新建 ed25519 / RSA 密钥。私钥可加 passphrase。
- MFA 二步：见 MFA / TOTP，Hux 在连接时自动填充验证码。
- 3
测试并保存
点击 "测试连接" 验证认证与网络。成功后保存。 - 4
（可选）批量导入
如果你的主机在云上，跳过手动添加，到 "主机 → 多云导入" 输入云厂商 AccessKey，自动列出所有 ECS / EC2 实例。详见 多云主机导入。
3. 连接与终端基础
双击主机即可连接。终端内：
- 分屏：右键 / 长按或 ⌘D 横向分屏、⌘⇧D 纵向分屏。每个 pane 可拖出为独立窗口（macOS）。
- 标签页：⌘T 新建 tab，⌘1-9 切换。所有 tab 在断网后会自动重连。
- tmux 集成：检测到远端 tmux 时自动以 control mode 接管，远端会话 映射为 Hux 的 pane / tab。
- 剪贴板：选中即复制，⌘V 粘贴。终端 OSC 52 也会写入系统剪贴板。
- URL 与路径：⌘ + 点击高亮 URL / 文件路径，自动唤起浏览器或 SFTP。
光标位置敏感的快捷键
⌘F 在终端内：搜索缓冲区；在 SFTP 面板内：搜索文件名；在 AI 面板内：搜索对话历史。 相同快捷键根据光标位置上下文切换。
4. 第一次和 AI 对话
打开右侧 AI 面板（⌘⇧A）。第一次使用需要在 "设置 → AI → 模型 Profile" 添加 API Key：
- 选厂商：OpenAI / Anthropic / DeepSeek / Gemini / Qwen / Ollama 等
- 填 API Key（保存在本地加密存储中）
- 可选 base_url，用于企业 LLM Gateway 或代理
设置完毕后，试试问：
@hux 检查一下当前服务器 nginx 是否正常运行
@hux 把 /var/log/nginx/error.log 最近 50 行下载到本地
@hux 这个 K8s pod 一直 CrashLoopBackOff，帮我诊断AI 会自动调用合适的工具（执行远程命令、读日志、查 K8s 资源、打开浏览器查文档 ……），并把思考过程实时呈现。每一步可中断、可回滚。
自带 Key 直连厂商
所有对话直连 LLM 厂商，不经过 Hux 服务器，更不会留存。详见 模型与 API Key。
5. 启用跨端同步
登录账号后，到 "设置 → 同步 → 启用同步" 生成 6 位配对码。在另一台设备上输入相同码 完成配对。同步内容：主机、SSH 密钥、笔记、AI Profile、云凭证、MFA、端口转发规则。
零知识同步
配对码经 PBKDF2 100k 轮派生密钥，AES-256-GCM 加密。Hux 服务器仅存密文。 详见 跨端同步。
下一步
- 键盘快捷键 — 把效率拉满
- AI 助手指南 — 多轮、工具、Sub-agent
- Kubernetes — 把 Lens 的活儿搬进 Hux
- 实时主机监控 — 替代 htop + iotop + docker stats