第1课：什么是HAPI，为什么需要它#
为什么需要它#
想象一下：你正在电脑上使用AI助手（例如Claude Code）。它编写代码、编辑文件、执行命令。但你需要离开——去喝杯咖啡、去开会、或者只是出去走走。没有HAPI的话，你的AI代理会停下来，等着你回到电脑前。有了HAPI，你只需拿出手机就能继续工作——不会丢失任何进度。
HAPI 是一个工具，可以让你从手机、平板电脑或任何浏览器远程控制AI代理。
什么是AI代理？#
AI代理 是一种具有人工智能的程序，能够在你的电脑上执行任务。例如：
- Claude Code（Anthropic出品）——编写和编辑代码
- Codex（OpenAI出品）——也能帮助编写代码
- Gemini CLI（Google出品）——另一个AI助手
- OpenCode ——开源替代方案
它们都在你电脑的终端（命令行）中运行。HAPI不是替代它们，而是"包装"它们——添加了远程控制的能力。
核心功能：Seamless Handoff#
Seamless Handoff（无缝切换）——是在电脑和手机之间切换而不丢失上下文的能力。
工作原理：
- 你在电脑终端中与AI代理一起工作
- 从手机发送消息——控制权自动转移到手机
- 终端中显示"Remote mode — waiting for input"（远程模式——等待输入）
- 回到电脑前，按双空格——又回到本地控制
无需重启，不会丢失数据。同一个会话，同一个状态。
HAPI和Happy有什么区别？#
HAPI受到Happy项目的启发，但架构原理完全不同：
| Happy | HAPI | |
|---|---|---|
| 数据存储位置 | 云服务器上（加密存储） | 你的电脑上 |
| 架构 | 集中式——所有人共用一个服务器 | 去中心化——每人运行自己的hub |
| 服务器功能 | 存储你的加密数据 | Relay只转发流量，不存储任何数据 |
| 安装方式 | 多个服务（数据库、缓存、服务器） | 一条命令 |
简单来说：
- Happy 就像Gmail：你的邮件存储在Google的服务器上（虽然加密了，但毕竟存在那里）。
- HAPI 就像自己的邮件服务器：一切都在你的机器上，而"邮递员"（relay）只是传递信封，不会查看里面的内容。
什么是Hub和Relay？#
- Hub（中心）——是在你电脑上运行的"控制中心"。它存储会话、管理连接并提供Web界面访问。
- Relay（中继器）——是一个中间服务器，只是在你的手机和电脑之间转发加密流量。它无法读取你的数据——数据使用WireGuard + TLS（军事级加密技术）进行加密。
HAPI能做什么#
- 📱 手机控制 ——从任何地方向AI代理发送命令
- ✅ 审批请求 ——AI想编辑文件？在手机上一键审批
- 🔄 无缝切换 ——电脑↔手机之间切换不丢失进度
- 🤖 任选AI ——Claude Code、Codex、Gemini、OpenCode
- 🖥️ 随处终端 ——直接从手机运行命令
- 🎤 语音控制 ——用语音与AI代理对话
- 🔒 安全 ——数据不会离开你的电脑
课程总结#
- HAPI 是一个从手机和浏览器远程控制AI代理的工具
- 核心功能是 Seamless Handoff：在设备之间切换而不丢失上下文
- 与Happy不同，HAPI是去中心化的：数据保留在你的电脑上
- Relay 只转发加密流量——它看不到你的数据
- HAPI支持Claude Code、Codex、Gemini和OpenCode
在下一课中，我们将在你的电脑上安装HAPI。