Caduceus

项目简介

Caduceus（取自希腊神话中赫尔墨斯手持的双蛇杖）是一款基于 Flutter 构建的跨平台原生客户端，专为驱动多 Agent 系统而设计。与传统的 Electron 方案不同，Caduceus 追求极致的性能与资源效率——一个代码库同时支持 macOS、iOS、Android 和 Windows 四大平台，用户在任何设备上打开，看到的都是同一套体验、同一份记忆账本。

Caduceus 后端同时接入 Hermes Agent（Nous Research 开源的自托管 AI Agent）与 OpenClaw（自主多模态 Agent 网关），界面上的 26+ 项能力会实时读取网关所支持的技能范围——网关能做什么，UI 就呈现什么。这种「能力发现」架构使得 Caduceus 具备高度的灵活性和可扩展性，不受单一后端绑定限制。

核心功能

多 Agent 统一管理：Caduceus 支持同时连接多个 AI Agent 实例，并提供统一的会话管理和记忆同步服务。用户可以在一个界面上调度不同的 Agent 完成任务，各 Agent 的上下文和记忆状态彼此贯通，避免了换端后上下文断裂的问题。

跨平台一致体验：macOS 端采用 Liquid Glass 三栏布局，支持 PanelRail 和 ⌘K 命令面板；iOS 端采用自适应手机布局，底部导航涵盖 Sessions / Panels / Connect / Settings 四个核心模块；Android 端实现边缘到边缘透明覆盖，与 iOS 端保持功能对等；Windows 端提供原生 Win32 桌面构建，包含响应式侧边栏和双 Ctrl/⌘ 快捷键支持。

流式渲染性能优化：这是 Caduceus 最具技术含量的特性之一。传统方案在渲染 Agent 流式输出时，每接收一个 token 就重新解析整个累计的 Markdown 缓冲文本，导致 O(N²) 的计算复杂度。Caduceus 实现了一套 IncrementalSplitter 算法，通过 Widget-Identity 块缓存将渲染负担降低到 O(N) 线性级别。在 60 token/s 的典型流速下，长会话（200 条消息）的 p99 帧耗时控制在 3.34ms 以内，Jank 率为 0%，包体仅 25–45MB，内存占用约为同功能 Electron 方案的一半。

统一技能与记忆同步：支持跨 Agent 的 Skill 同步安装，以及双向记忆同步（Bi-directional Memory Sync），自动检测记忆漂移并进行争议仲裁。此外，还实现了跨 Agent 的任务调度与子 Agent 委托（Fleet-wide Task Handoff），多个 Agent 可以协同完成复杂任务。

Universal MCP 支持：Caduceus 实现了 Universal MCP（Model Context Protocol）服务器共享与工具代理，连接至同一个网关的所有 Agent 都可以共享 MCP 工具资源，无需各自独立配置。

技术实现

Caduceus 的核心技术选型围绕「原生跨平台」与「高性能流式渲染」两大目标展开。

在跨平台层面，项目选用 Flutter 作为唯一代码库，通过平台通道（Platform Channels）调用各操作系统的原生能力，避免了 Electron 方案中因打包完整浏览器引擎而带来的体积膨胀和内存占用问题。Flutter 的自绘制引擎确保了各平台上 UI 的一致性和流畅度。

在流式渲染优化层面，项目实现了一套增量 Markdown 解析器（IncrementalSplitter）。与传统方案每 token 都重新解析全量文本不同，增量解析器只处理新到达的文本片段，并将已解析的块缓存于内存中。结合 RepaintBoundary 优化，渲染线程的工作量大幅降低。 benchmark 数据显示：在 3,491 tokens / 12,214 chars 的测试语料上，Naive 方案需处理 21,329,133 个字符，而 Caduceus 仅需处理 638,041 个字符，差距达 33.4 倍；在 60 token/s 的真实流速 profile 下，Naive 方案设备端处理量为 15,100,091 chars，而 Caduceus 仅为 357,507 chars，差距扩大到 42.2 倍。

在后端接入层面，Caduceus 通过 JSON-RPC over WebSocket 协议完整接入 Hermes Agent 的控制平面和数据平面，支持直接会话 Token 认证和 OAuth 2.0 用户名密码认证两种方式。对于 OpenClaw 网关，Caduceus 实现了基于 Ed25519 的身份握手与会话订阅机制，并支持实时推理流（Live Reasoning Streams）和工具调用（Tool Calls）的可视化呈现。

快速上手

第一步：获取 Caduceus

从 GitHub 仓库 releases 页面下载对应平台的安装包，或通过源码自行编译。支持的平台包括 macOS（Apple Silicon 优化版）、iOS（App Store 审核中，可先通过 TestFlight）、Android（APK 直装）以及 Windows（portable ZIP 分发）。

第二步：连接 Agent 网关

打开 Caduceus，进入 Connect 页面，选择要接入的网关类型（Hermes 或 OpenClaw），输入网关地址和认证凭据，完成设备配对。OpenClaw 用户需在 OpenClaw 端确认配对请求。

第三步：管理多 Agent 实例

配对成功后，在 Sessions 页面可以看到已连接的 Agent 列表，点击任意 Agent 即可开始对话。可以同时在多个 Panel 中打开不同的 Agent，通过侧边栏快速切换。

第四步：安装和使用技能

在 Skill 库页面浏览可用的 Agent 技能，一键安装到指定 Agent。已安装的技能会自动出现在 Agent 的能力面板中，用户通过自然语言即可调用。

第五步：跨端同步与舰队管理

在同一账号下登录不同设备，所有会话记录和 Agent 记忆会自动同步。Fleet 页面提供了多 Agent 调度视图，可以将任务委托给舰队中的其他 Agent，或查看各 Agent 的运行状态。

适用人群

Caduceus 适合以下用户群体：运行多个 AI Agent 的高级用户（尤其是 Hermes 和 OpenClaw 用户）、需要在移动端和桌面端无缝切换工作的技术从业者、关注 AI 工具性能与资源占用的效率派用户，以及对开源跨平台客户端有二次开发需求的开发者。普通用户如果只需要与单个 Agent 对话，官方提供的桌面端或网页端已足够使用；Caduceus 的价值在于为多 Agent 玩家提供统一的高性能控制台。

官方链接

GitHub 仓库：https://github.com/dont-see-big-shark/Caduceus

Hermes Agent 官网：https://hermes-agent.nousresearch.com/

OpenClaw 官网：https://openclaw.ai