文档 — Havos

快速上手

系统要求

🍎 macOS

macOS 12.0 (Monterey) 或更高
4GB 内存推荐（8GB 更佳）
1GB 可用磁盘空间
Intel 或 Apple Silicon 均可

🪟 Windows

Windows 10 1903 或更高
4GB 内存推荐（8GB 更佳）
1GB 可用磁盘空间
64位系统

安装步骤

1

下载安装包

macOS（Intel 芯片）：下载 Havos-1.1.67-mac.dmg（383MB），双击打开，将 Havos 拖入「应用程序」文件夹。首次打开如遇「无法验证开发者」，请右键选择打开。
macOS（Apple 芯片）：下载 Havos-1.1.67-arm64-mac.dmg（379MB），双击打开，将 Havos 拖入「应用程序」文件夹。
Windows：下载 Havos-Setup-1.1.67.exe（214MB），双击运行安装程序，按提示完成安装。
Android 手机端：下载 Havos-1.1.33.apk（27MB），安装后与桌面端登录同一账号即可自动配对。

2

首次启动

macOS 首次启动可能提示「无法验证开发者」——前往「系统设置 → 隐私与安全性」点击「仍要打开」。
Windows 可能被 SmartScreen 拦截——点击「更多信息 → 仍要运行」。

3

登录账号

首次启动需输入手机号，发送验证码完成注册/登录。已有账号直接输入手机号和密码登录。

4

选择模型

登录后，点击顶部栏模型名称，选择一个模型开始使用。推荐新手先用 DeepSeek-V4-Flash 或 通义千问 Plus，响应快、省积分。

5

开始对话

在输入框打字，按回车发送。Havos 会理解意图、调用工具、返回结果。试试输入：「帮我看看桌面上有哪些文件」。

核心概念

理解这 5 个概念，就能用好 Havos。

🤖 Agent — AI 智能体

Agent 是你的 AI 智能体。它不只是聊天——它能理解自然语言指令，自主决策调用哪些工具，串行编排完成任务。你只需要用中文说「帮我做 XX」，Agent 会自动拆解任务、选择工具、执行并返回结果。

示例：你说「把桌面的 report.txt 总结发给张三」，Agent 会：1. 读取文件 → 2. AI 总结 → 3. 查找联系人 → 4. 发送邮件。

🔧 工具 — 16+ 内置能力

Havos 内置 16+ 工具，常用如：

文件类：read_file, write_file, list_files, move_file
终端类：execute_command, run_script
浏览器类：web_search, web_fetch, screenshot
通信类：send_email, send_message, search_contact, compose_email
本地工具调用不单独计费；调用云端模型按 token 计积分。

🧠 记忆 — 三层架构

Havos的记忆系统分三层：

L1 上下文窗口：当前对话的即时记忆，类似人的工作记忆。
L2 FTS5 全文索引：所有历史对话可搜索，需要时自动检索。
L3 摘要压缩层：长期对话自动压缩为摘要，保留关键信息。

这意味着 30 天前说过的需求，Havos 依然记得。

🔌 技能 — MCP协议

MCP（Model Context Protocol）是开源的 AI 工具调用协议。社区已贡献 5,000+ 技能：

数据库操作、图表生成、API 调用、文件转换、代码执行等。

在「设置 → 技能」页面浏览安装，或输入技能包名手动安装。安装后 Havos 自动识别并调用。

📱 Havos 手机 App — 远程指挥通道

Havos 手机 App 是双端协同的另一半。安装后与桌面端登录同一账号自动配对，出门也能用手机指挥电脑干活：

工作原理：手机 App 发消息 → 桌面端接收 → 本地执行 → 工具时间线与结果实时回传到手机。

配对方式：手机 App 与桌面客户端登录同一账号，选择对应设备即完成绑定。之后给设备发消息，就像直接对电脑说话。

更多能力：App 内还有云端对话（电脑关机也能用）、专家广场多智能体、积分购买与流水管理。

常用命令示例

直接用自然语言说，Havos 会理解并执行。

文件操作「帮我在桌面创建一个项目文件夹，叫 my-project」

→ mkdir("~/Desktop/my-project") → mkdir("~/Desktop/my-project/src") → mkdir("~/Desktop/my-project/docs") ✓ 已创建项目文件夹，含 src 和 docs 子目录

数据分析「读取这个 CSV，告诉我行数和列数」

→ read_file("data.csv") // 读取 CSV 文件 → analyze(data) // 统计行数、列数、数据类型 ✓ 共 2,847 行，15 列，包含销售数据

代码处理「把这段代码格式化并保存」

→ formatCode(code, "typescript") // 使用 Prettier 格式化 → write_file("formatted.ts", code) ✓ 代码已格式化并保存到 formatted.ts

网页搜索「搜索网页上最新的 AI 新闻」

→ web_search("最新 AI 新闻 2025") // 搜索 10 条结果 → web_fetch(url) // 抓取前 3 篇内容 ✓ 已抓取前 3 篇，整理为摘要

邮件发送「帮我发一封邮件给张三」

→ search_contact("张三") // 从通讯录查找 → compose_email(to, subject, body) // AI 自动起草邮件内容 → send_email(email) ✓ 邮件已发送给 zhangsan@example.com

快捷键

提高效率的键盘快捷键。

快捷键	功能	说明
`⌘ K / Ctrl K`	新建会话	快速创建新的 AI 对话
`⌘ Enter / Ctrl Enter`	发送消息	在输入框中发送当前消息
`⌘ Shift+A / Ctrl Shift+A`	切换模型	快速打开模型选择器
`⌘ B / Ctrl B`	折叠侧栏	折叠/展开左侧会话列表
`⌘ , / Ctrl ,`	打开设置	进入设置页面
`⌘ D / Ctrl D`	删除会话	删除当前选中的会话
`Esc`	关闭弹窗	关闭当前打开的对话框/弹窗
`⌘ F / Ctrl F`	搜索会话	在会话列表中搜索历史对话

常见问题

Havos 支持 Linux 吗？ +

目前不支持 Linux 原生客户端。推荐使用 macOS 或 Windows。Linux 原生客户端已在后续版本规划中。

积分用完了怎么办？ +

积分用完后可以购买积分包继续使用，或者切换到本地模型（如有配置）。本地工具调用和记忆系统不单独计费，只有调用云端模型时才消耗积分。

可以同时使用多个模型吗？ +

不同对话可用不同模型；同一对话内同一时间只用一个，可随时切换并即时生效。

如何自定义模型 API？ +

在「设置 → 模型管理 → 自定义模型」中，填入 API 地址、密钥和模型名称。支持任意兼容 OpenAI API 格式的模型服务。添加后即可在对话中使用。

数据存储在哪里？ +

Havos 客户端的数据全部存储在本地：对话历史、用户设置、记忆索引、技能配置等。数据目录：macOS：~/Library/Application Support/Havos/；Windows：%APPDATA%\Havos\。你可以随时查看、备份或删除这些数据。

Havos 使用文档