Hermex

Hermex 是一款基于 SwiftUI 开发的 iPhone 应用程序，专为驱动自托管的 hermes-webui 服务器而设计。它充当移动端的控制面板，允许用户通过 iPhone 与运行在本地硬件（如 Mac、Linux 或 Windows/WSL2）上的 AI 智能体进行交互。

该应用遵循“手机是控制平面，而非计算平面”的设计理念，确保所有的模型推理、工具调用及数据存储均保留在用户自己的服务器上，不经过任何第三方中继。

核心特性

• 原生体验：基于 SwiftUI 构建，专为 iOS 18+ 优化，提供流畅的原生交互，而非简单的网页包装器。
• 完全私密：无分析、无追踪、无订阅费用。应用仅与用户指定的服务器通信，数据不出本地网络或通过加密隧道传输。
• 实时交互：支持发送消息时附带模型选择、推理强度、工作区和配置文件选项；支持附加文件和图像；实时流式显示响应，包括思考过程和工具调用详情。
• 会话管理：浏览、搜索和恢复服务器上的历史对话；支持缓存会话以便离线阅读。
• 任务与技能管理：从手机端查看和编辑智能体计划的 Cron 任务，浏览已安装的技能（Skills）。
• 文件系统浏览：直接在应用内探索服务器的文件系统，管理工作区内容。
• 多模型支持：在服务器配置的任何模型或提供商之间自由切换，支持标记最近使用和收藏的模型。

部署与连接

Hermex 仅为客户端软件，用户需自行搭建后端服务。

1. 运行服务器
在 macOS、Linux 或 Windows/WSL2 上安装并启动 hermes-webui，并设置环境变量 HERMES_WEBUI_PASSWORD 以确保安全。

2. 建立连接通道
由于 iOS 的安全策略（App Transport Security），建议通过以下方式使服务器可从 iPhone 访问：

• HTTPS 反向代理/隧道：使用 Cloudflare Tunnel 或其他反向代理在自有域名上终止 TLS。这是最推荐的方式，只需设置强密码即可保障应用层安全。
• Tailscale：在服务器和 iPhone 上安装 Tailscale，通过 http://<tailnet-ip>:8787 连接。Hermex 允许对 Tailscale 的 100.64.0.0/10 网段使用纯 HTTP 连接。
• 本地测试：仅在模拟器或与服务器同一台 Mac 上进行开发测试时，可使用 http://localhost:8787。

3. 客户端配置
下载 Hermex，输入服务器 URL 和密码即可开始使用。

故障排除

若连接失败，请检查：

• 宿主机器是否处于唤醒状态。
• hermes-webui 进程是否正常运行并可访问 /health 端点。
• 隧道、反向代理或 Tailscale 路由是否已正确建立。
• 输入的服务器 URL 和密码是否准确。

Hermex 为希望完全掌控自己 AI 基础设施的用户提供了一个优雅、安全且高效的移动端入口，实现了真正的本地优先智能体交互。