文档 — Havos

快速上手

系统要求

🍎 macOS

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

🪟 Windows

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

安装步骤

1

下载安装包

macOS：下载 Havos-1.0.0-mac.dmg（231MB），双击打开，将 Havos 拖入「应用程序」文件夹。
Windows：下载 Havos-1.0.0-win-x64.zip（173MB），解压到任意目录，双击 Havos.exe 运行。

2

首次启动

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

3

登录账号

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

4

选择模型

登录后，点击顶部栏模型名称，选择一个模型开始使用。推荐新手先用 DeepSeek V4 Flash 或 Qwen-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
工具调用永久免费，不消耗积分。

🧠 记忆 — 三层架构

Havos的记忆系统分三层：

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

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

🔌 技能 — MCP协议

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

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

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

📱 龙信IM — 远程操控通道

龙信IM是Havos的远程操控通道。绑定手机后，出门也能用手机操控电脑：

工作原理：手机龙信发消息 → Havos接收 → 本地执行 → 结果回传到龙信对话框。

绑定方式：在Havos设置页点击「绑定龙信IM」，用手机扫码登录龙信客户端即可。绑定后，给"Havos Agent"联系人发消息，就像直接对电脑说话。

安全：消息端到端加密，不经过第三方服务器。即使网络被截获，也无法读取内容。

常用命令示例

直接用自然语言说，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篇内容 ✓ 找到5条最新AI新闻，已整理摘要

邮件发送 "帮我发一封邮件给张三"

→ search_contact("张三") // 从通讯录查找 → compose_email(to, subject, body) // AI自动起草邮件内容 → send_email(email) ✓ 邮件已发送给 zhangsan@co.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 使用文档