Swift 6 / SwiftUI / macOS 14+

Windows 版即将上线

HermesPet

让 AI 住进 MacBook 刘海里。点一下就聊,按住就说,拖进文件让它自己读。

静态介绍页,内容来自仓库 README 与源码梳理,不是实时数据看板。

核心体验

它把 AI 从"一个窗口"变成 Mac 顶部的常驻工作入口

01

点刘海

灵动岛胶囊呼出聊天窗口,状态、错误、后台任务都在顶部可见。

02

按住说话

全局 Push-to-Talk 录音,松开自动发送,屏幕边缘出现 Apple Intelligence 风格光环。

03

拖进文件

图片直接传给模型;文档只传本地路径,让 Claude / Codex 按需读取,不把全文塞进上下文。

04

并行处理

每个对话独立锁定 AI 后端,翻译、写代码、生图可以同时跑,不互相污染。

产品逻辑

一条消息从输入到完成的路径

  1. 1

    入口收集

    聊天框、截图、语音、快问浮窗、桌面拖拽都会进入同一个 ViewModel。

  2. 2

    会话绑定

    新对话继承上次使用的模式,发出第一条用户消息后锁定该后端。

  3. 3

    后端路由

    在线 API 走 HTTP SSE;Claude / Codex 走本地 CLI 子进程并解析 JSON 流。

  4. 4

    状态回传

    工具调用、文件改动、后台完成、错误重试都通过通知驱动灵动岛更新。

多引擎

不是切换模型,而是给不同任务安排不同工作台

零依赖

在线 AI

选择 DeepSeek、智谱、Kimi 或 OpenAI,填入 API Key 就能开始聊天、翻译、写作和看图。

  • 适合分发给没有 CLI 环境的用户
  • 配置与 Hermes Gateway 完全独立保存
  • 默认新用户进入这一档,降低上手门槛
查看 APIClient.swift

细节能力

这些小东西让它真的像桌面伴侣

技术与隐私

纯原生 macOS,数据边界讲得清楚

技术栈

  • Swift 6 + SwiftUI,非 Electron,非 WebView。
  • ScreenCaptureKit 截屏,Carbon Event Manager 注册全局热键。
  • Claude / Codex 通过本地 CLI 子进程接入,自动检测真实 PATH。
  • 流式输出统一回到 ChatViewModel,按会话和消息 ID 精准落位。

数据边界

  • 对话历史保存在 ~/.hermespet/conversations.json
  • 图片保存在 ~/.hermespet/images/,JSON 里只存路径。
  • Pin 卡片保存在 ~/.hermespet/pins.json
  • AI 调用走用户自己配置的后端,项目本身不代收数据。

安装

拿到 DMG,填一个 API Key,就能让它住进桌面

高级能力可以再安装 Claude Code 或 Codex CLI;不装也可以先用在线 AI 完成日常聊天、翻译、写作和看图。

Windows 版本

HermesPet for Windows 马上上线

系统托盘集成

常驻 Windows 系统托盘,快速访问 AI 助手,无需打开额外窗口。

全局快捷键

自定义全局快捷键,在任何应用中快速唤起 HermesPet,提升工作效率。

多引擎支持

支持在线 AI、Hermes Gateway、Claude Code 等多个后端,满足不同需求。

文件拖拽

直接拖拽文件或截图到 HermesPet,让 AI 快速理解和处理。

Windows 版本正在紧张开发中,敬请期待!

关注项目进展