随身智能体客户端 fireishott/Kallisti

Kallisti

Kallisti 是一个自托管的 iPhone 和 iPad 个人 AI 智能体客户端。它后端无关：BYOB，自带后端。 Kallisti 是手机；大脑由你选择。

没有托管厂商后端。你自带智能体、自带模型、自带 TLS 端点。对话、凭据和媒体都留在你掌控的基础设施上。源代码以 MIT 许可开源，可自由自行构建。

BYOB：自带后端

Kallisti 通过一套客户端协议与你的智能体通信，传输方式可互换。选择与你所运行环境匹配的那一种：

| 后端 | 传输方式 | 你需要运行的内容 |
| DeepSeek Harness | 直接 HTTP + SSE | 带 dsh-phone-api 插件的 DSH |
| 任何 OpenAI 兼容的智能体 API | Kallisti relay + connector | 本仓库中的 relay 和 connector，置于你智能体 API 服务器之前 |
| 智能体网关（例如 Hermes Agent） | 原生 WebSocket | 该网关，外加用于推送和媒体的可选 connector |

模型由你的后端路由决定：托管 API、本地路由器或设备端推理。模型选择器、技能浏览器、配置编辑器和日志都从你连接的后端读取，绝不硬编码。

传输方式在构建时选择。特定主机的值绝不写入源码：DSH 构建从不受跟踪的 Config/DSH.local.xcconfig 读取其 token 和 base URL（参见 Config/DSH.example.xcconfig）；不提供该文件，应用就会为 relay 和原生网关传输方式构建。

状态

Kallisti 处于私有测试阶段。TestFlight 邀请正在陆续发放给我们的 beta 测试者——如果你有兴趣加入，请通过 Discussions 标签联系我们。

该应用可用于日常使用。聊天、内嵌 TUI 终端和手写笔记均已可用；Talk（语音模式）和 watchOS 即将推出，正在积极开发中。仍有一些粗糙之处，应用正在持续迭代。

亮点

- BYOB - DeepSeek Harness、relay + connector 或原生网关；你的模型，你的主机
- 流式聊天，具备持久会话和发件箱恢复
- 流式 Markdown、代码块、工具活动和推理状态
- 嵌入式 TUI 终端模式 - 通过 PTY 桥接在应用内运行真正的 agent TUI，支持触摸滚动、会话恢复和实时工具计时器
- 一次性配对码登录，支持原生网关模式
- 对 agent 生成的图像进行经过身份验证的内联渲染
- 推送通知，支持按设备路由和应用内收件箱
- 锁屏上的实时活动，带有时长心跳
- 小组件和通知服务扩展
- 使用 Apple Pencil 的手写笔记、OCR / AI 增强，以及同步即会话（iPad）
- 可选的 HealthKit、CoreLocation 和 CoreMotion 同步，并在应用内提供后台同步开关
- 网关状态、日志、重启、软件更新检查，以及真实的连接阶段
- 连接延迟监控和可搜索的辅助模型切换

功能

聊天

- 流式 Markdown 聊天，带语法高亮代码块
- 实时工具活动和推理状态
- 会话历史、从后端目录中按会话选择模型，以及配置文件选择
- 持久发件箱，支持感知截止时间的恢复
- 草稿文本在重新连接和视图重建后仍会保留
- 每个活动回合只有一个实时思考占位符
- 打开时进入你最近活跃的对话，首次启动时则进入新会话

TUI 终端

- 真正的终端模拟器（SwiftTerm），连接到连接器的 /v1/terminal PTY 桥接
- 触摸滚动模式和长按文本选择
- 可恢复会话：关闭或进入后台后继续同一个 TUI 会话，或重新开始
- 实时推理标题、带时长计时器的工具行，以及粘性状态栏（模型、上下文窗口、会话时钟）
- 返回聊天标签页时，终端会干净地重启

笔记（iPad）

- 在横线纸上使用 Apple Pencil 手写
- 同步时通过 agent 进行 OCR 和 AI 增强
- 每条笔记作为独立会话同步；每次编辑都会追加到该会话
- 手动同步按钮，带实时进度条，或从 2 分钟到 24 小时的定时同步
- 同步期间显示实时推理气泡，让你知道 agent 实际在做什么

媒体

- agent 响应中的本地 MEDIA: 路径会以内联方式渲染为经过身份验证的图像
- 原生图像上传会在提交提示词前通过网关暂存
- 网关重启后，历史图像仍可访问
- 媒体服务仅限于配置的 agent 媒体根目录
- 等比适配缩略图，确保聊天布局一致

移动端

- 后台回合的推送通知，通过安装 ID 按设备限定范围
- 锁屏上的实时活动，带有时长心跳
- 应用内通知收件箱，支持关闭和稍后提醒操作
- 小组件和通知服务扩展
- Talk（语音模式） 即将推出 - 按键说话，支持可配置的 ASR/TTS 和 Apple 语音回退
- 可选的 HealthKit、CoreLocation 和 CoreMotion 同步，并在应用内切换 HealthKit 后台交付
- 使用 Apple Pencil 手写笔记，OCR 和 AI 增强（仅 iPad）

网关控制

- 具有真实、可信阶段的连接状态
- 手动重置连接
- 网关日志、重启和软件更新检查
- 设置中的实时连接器延迟读数
- 已连接后端的配置编辑器：DSH 配置文件补丁（实时应用）或代理配置（保存并重启），带服务器端 YAML 验证和备份

开发中

- Talk（语音模式） - 按键说话，可配置 ASR/TTS 提供商和 Apple 语音回退。打断、音频会话管理和实时转录显示。尚未可用 - 已知进行中的工作。
- watchOS 应用 - 原生配套手表体验，即将推出
- 插件引擎 - 第三方插件注册、生命周期和面向社区扩展的插件 API。开发中。
- 扩展笔记流水线并改进 TUI 终端
- 针对长会话历史和大媒体的性能优化

架构

Kallisti iOS
├─ DSH transport -> DeepSeek Harness /phone/v1 (HTTP + SSE)
├─ Relay transport -> Kallisti relay -> connector -> your agent's API server
└─ Native transport -> agent gateway WebSocket
+ optional Kallisti connector (push, sensors, authenticated media, terminal bridge)
+ your TLS endpoint or tailnet for remote access

每种传输都实现相同的客户端协议，因此无论你接入哪种后端，聊天、流式传输、工具活动、会话、模型和设置的行为都一致。在原生模式下，网关 WebSocket 承载聊天和会话流量。连接器增加了移动服务：APNs 推送注册、实时活动、传感器同步、经过身份验证的媒体传输以及 TUI 终端 PTY 桥接。对于远程访问，运维人员将 TLS 反向代理（例如 Caddy）置于网关和连接器之前。

连接模式记录在 docs/CONNECTION_MODES.md 中，生产架构记录在 docs/PRODUCTION_ARCHITECTURE.md 中，威胁模型记录在 docs/THREAT_MODEL.md 中。

要求

- iOS 18 或更高版本
- 你运行的后端：DeepSeek Harness、中继后兼容 OpenAI 的代理 API，或诸如 Hermes Agent 的代理网关
- 可选连接器需要 Python 3.11 或更高版本
- 仅当你从源代码构建时才需要 Xcode 16 或更高版本以及 Apple Developer 账户

快速开始

TestFlight 测试版

Kallisti 处于私人测试阶段。一旦你收到 TestFlight 邀请，安装 Kallisti，将其与你的代理网关配对，即可完成设置。测试版路径无需 Apple Developer 账户或 Xcode 设置。

如果你想要推送通知、HealthKit 同步、实时活动、经过身份验证的媒体传输或 TUI 终端，请在你的代理主机上运行可选连接器：

cd connector
python3 -m venv .venv
. .venv/bin/activate
pip install -e .
kallisti run

在仓库之外配置密钥和环境特定的 URL。不要提交凭据、私钥、设备标识符、内部主机名或生产日志。连接器在你配置的端口上为推送注册、实时活动和经过身份验证的媒体提供 HTTP 外观。

从源代码构建

Kallisti 在 MIT 许可下开源，可免费构建。对于想要自己签名构建的折腾者：

git clone https://github.com/fireishott/Kallisti.git
cd Kallisti
open Herald.xcodeproj

选择 Kallisti scheme，选择你的 Apple Developer 团队，然后构建到模拟器或已注册设备。对于 DeepSeek Harness 构建，将 Config/DSH.example.xcconfig 复制为 Config/DSH.local.xcconfig，填入你的 token 和 base URL，并将其传递给构建：

xcodebuild -project Herald.xcodeproj -scheme Kallisti -xcconfig Config/DSH.local.xcconfig build

永远不要提交 .local.xcconfig；它已被 gitignore。详细的构建说明见 docs/BUILDING.md，配置选项见 docs/CONFIGURATION.md。

在设备上登录

1. 启动 Kallisti 并选择原生网关模式。
2. 从你的 agent 主机生成一次性配对码。
3. 在应用中输入该配对码。该配对码永远不会持久化在设备上。

推送通知

推送投递通过连接器使用 APNs。应用注册一个以其安装 ID 为键的 APNs token，因此多设备设置会将通知路由到正确的设备。实时活动注册使用单独的 token 类型。

有关中继和推送代理架构，请参阅 docs/PUSH_RELAY.md；有关能力设置（后台模式、推送权限、实时活动），请参阅 docs/IOS_CAPABILITIES.md。

原生媒体投递

Agent 响应可以包含本地 MEDIA: 路径。在原生模式下，Kallisti 将支持的路径转换为经过身份验证的 /v1/native/media 路由。连接器：

- 验证网关 cookie 会话、原生 bearer token 或持久化的配对设备 token；
- 仅提供配置的 agent 媒体根目录下受支持的图像文件；
- 拒绝路径遍历、不支持的类型、缺失文件以及超过 10 MB 的文件；
- 返回私有缓存标头，并且绝不暴露任意文件系统路径。

测试

iOS
xcodebuild test \
-project Herald.xcodeproj \
-scheme Kallisti \
-destination 'platform=iOS Simulator,name=iPhone 16 Pro'

Connector
cd connector
pytest

使用你 Xcode 主机上已安装的模拟器目标。

安全与隐私

- 凭据存储在 iOS Keychain 中。
- 网关密码不会嵌入应用或仓库中。
- 媒体和控制端点需要身份验证。
- 配对码为一次性使用，且永远不会持久化。
- 传感器同步是可选的且为自托管。
- 公开的错误报告不得包含令牌、私有 URL、设备 ID、个人数据或原始生产日志。

有关支持的版本和负责任的披露指南，请参阅 SECURITY.md；有关完整的威胁模型，请参阅 docs/THREAT_MODEL.md。

发布历史

Kallisti 目前通过 TestFlight 面向私有 Beta 测试者分发。GitHub 发布版本为从源代码构建的用户提供源代码说明，完整历史记录见 CHANGELOG.md。

许可证

MIT。请参阅 LICENSE。

致谢

Kallisti 可与 DeepSeek Harness 和 Hermes Agent 配合使用，并在本仓库的 MIT 许可证历史下纳入了 Herald 移动客户端的早期工作。

开发团队

- Curtis Freeman (@fireishott) - 创始人和首席开发者。负责架构、iOS 应用、连接器和网关集成。
- Mark Davis (@doc-holliday-1) - 负责 iPhone 和 iPad 开发以及插件引擎。iOS 和平板 UX、平台特定优化。